dify/cli/src/api/apps.ts

import type {
  AppDescribeResponse,
  AppListResponse,
  SupportedAppType,
} from '@dify/contracts/api/openapi/types.gen'
import type { AppReader } from './app-reader'
import type { OpenApiClient } from '@/http/orpc'
import type { HttpClient } from '@/http/types'
import { createOpenApiClient } from '@/http/orpc'

export type ListQuery = {
  readonly workspaceId: string
  readonly page?: number
  readonly limit?: number
  readonly mode?: SupportedAppType | ''
  readonly name?: string
}

// An absent or empty mode filter means "any mode" — collapse both to undefined for the query.
export function normalizeMode(
  mode: SupportedAppType | '' | undefined,
): SupportedAppType | undefined {
  return mode !== undefined && mode !== '' ? mode : undefined
}

export class AppsClient implements AppReader {
  private readonly orpc: OpenApiClient

  constructor(http: HttpClient) {
    this.orpc = createOpenApiClient(http)
  }

  async list(q: ListQuery): Promise<AppListResponse> {
    return this.orpc.apps.get({
      query: {
        workspace_id: q.workspaceId,
        page: q.page ?? 1,
        limit: q.limit ?? 20,
        mode: normalizeMode(q.mode),
        name: q.name !== undefined && q.name !== '' ? q.name : undefined,
      },
    })
  }

  async describe(appId: string, fields?: readonly string[]): Promise<AppDescribeResponse> {
    return this.orpc.apps.byAppId.get({
      params: { app_id: appId },
      query: {
        fields: fields !== undefined && fields.length > 0 ? fields.join(',') : undefined,
      },
    })
  }
}