import { batchDeleteAppIndexDocumentsSchema, batchUpsertAppIndexDocumentsSchema, colineAppRegistrationPayloadSchema, createNotificationInputSchema, emitAmbientEventsInputSchema, appPermissionSchema, type AppPermission, type BatchDeleteAppIndexDocumentsInput, type BatchUpsertAppIndexDocumentsInput, type ColineAppRegistrationPayload, type CreateNotificationInputInput, type EmitAmbientEventsInputInput, } from "./manifest"; interface ApiErrorPayload { error?: { code?: string; message?: string; }; } async function parseApiResponse(response: Response): Promise { const payload = (await response.json().catch(() => null)) as | { data?: T; error?: ApiErrorPayload["error"] } | null; if (!response.ok) { throw new Error( payload?.error?.message ?? `Request failed (${response.status}).`, ); } if (!payload || !("data" in payload)) { throw new Error("Invalid API response."); } return payload.data as T; } export interface ColineApiClientOptions { baseUrl: string; apiKey?: string; fetch?: typeof fetch; } export interface RegisteredAppRecord { appId: string; appKey: string; name: string; description: string | null; iconUrl: string | null; status: "draft" | "active" | "disabled" | "archived"; ownerUserId: string | null; latestPublishedVersion: string | null; } export interface RegisteredAppDetail extends RegisteredAppRecord { latestPublishedVersionId: string | null; } export interface RegisteredAppVersionSummary { versionId: string; version: string; status: "draft" | "published" | "deprecated"; apiBaseUrl: string; permissions: string[]; fileTypes: Array<{ typeKey: string; name: string; description: string | null; }>; createdAt: string; updatedAt: string; } export interface WorkspaceInstalledApp { installId: string; appId: string; appKey: string; name: string; description: string | null; iconUrl: string | null; status: "active" | "suspended" | "revoked"; installScope: "workspace" | "user"; scopeSubjectId: string; version: string | null; } export interface WorkspaceAppCatalogItem { appId: string; appKey: string; name: string; description: string | null; iconUrl: string | null; status: "draft" | "active" | "disabled" | "archived"; latestPublishedVersion: string | null; latestPublishedVersionId: string | null; isInstalled: boolean; } export interface WorkspaceAppsResponse { installedApps: WorkspaceInstalledApp[]; catalog: WorkspaceAppCatalogItem[]; permissions: { canManageApps: boolean; }; } export interface InstallWorkspaceAppInput { appId: string; pinnedVersionId?: string; grantedPermissions?: AppPermission[]; } export interface InstallWorkspaceAppResponse { installId: string; appId: string; appKey: string; version: string; grantedPermissions: AppPermission[]; } export interface WorkspaceAppPermissionsResponse { install: WorkspaceInstalledApp; availablePermissions: string[]; grantedPermissions: string[]; permissions: { canManageApps: boolean; }; } export interface WorkspaceInstalledAppResponse { install: WorkspaceInstalledApp; permissions: { canManageApps: boolean; }; } export interface UpdateWorkspaceAppPermissionsInput { grantedPermissions: AppPermission[]; } function joinUrl(baseUrl: string, path: string): string { return `${baseUrl.replace(/\/+$/, "")}${path}`; } export class ColineApiClient { private readonly baseUrl: string; private readonly apiKey: string | undefined; private readonly fetchImpl: typeof fetch; constructor(options: ColineApiClientOptions) { this.baseUrl = options.baseUrl; this.apiKey = options.apiKey; this.fetchImpl = options.fetch ?? fetch; } private async request(path: string, init?: RequestInit): Promise { const headers = new Headers(init?.headers); if (!headers.has("Content-Type") && init?.body) { headers.set("Content-Type", "application/json"); } if (this.apiKey && !headers.has("Authorization")) { headers.set("Authorization", `Bearer ${this.apiKey}`); } const response = await this.fetchImpl(joinUrl(this.baseUrl, path), { ...init, headers, }); return parseApiResponse(response); } async listApps(): Promise<{ apps: RegisteredAppRecord[] }> { return this.request<{ apps: RegisteredAppRecord[] }>("/api/apps"); } async getApp(appKey: string): Promise<{ app: RegisteredAppDetail }> { return this.request<{ app: RegisteredAppDetail }>(`/api/apps/${appKey}`); } async listAppVersions( appKey: string, ): Promise<{ versions: RegisteredAppVersionSummary[] }> { return this.request<{ versions: RegisteredAppVersionSummary[] }>( `/api/apps/${appKey}/versions`, ); } async registerApp( payload: ColineAppRegistrationPayload, ): Promise<{ appId: string; appKey: string; versionId: string; version: string }> { const body = colineAppRegistrationPayloadSchema.parse(payload); return this.request<{ appId: string; appKey: string; versionId: string; version: string; }>("/api/apps", { method: "POST", body: JSON.stringify(body), }); } async listWorkspaceApps(workspaceSlug: string): Promise { return this.request( `/api/workspaces/${workspaceSlug}/apps`, ); } async installWorkspaceApp( workspaceSlug: string, input: InstallWorkspaceAppInput, ): Promise { const grantedPermissions = input.grantedPermissions ? input.grantedPermissions.map((permission) => appPermissionSchema.parse(permission), ) : undefined; return this.request( `/api/workspaces/${workspaceSlug}/apps`, { method: "POST", body: JSON.stringify({ appId: input.appId, ...(input.pinnedVersionId ? { pinnedVersionId: input.pinnedVersionId } : {}), ...(grantedPermissions ? { grantedPermissions } : {}), }), }, ); } async getWorkspaceAppPermissions( workspaceSlug: string, appKey: string, ): Promise { return this.request( `/api/workspaces/${workspaceSlug}/apps/${appKey}/permissions`, ); } async getWorkspaceInstalledApp( workspaceSlug: string, appKey: string, ): Promise { return this.request( `/api/workspaces/${workspaceSlug}/apps/${appKey}`, ); } async updateWorkspaceAppPermissions( workspaceSlug: string, appKey: string, input: UpdateWorkspaceAppPermissionsInput, ): Promise { return this.request( `/api/workspaces/${workspaceSlug}/apps/${appKey}/permissions`, { method: "PUT", body: JSON.stringify({ grantedPermissions: input.grantedPermissions.map((permission) => appPermissionSchema.parse(permission), ), }), }, ); } async uninstallWorkspaceApp( workspaceSlug: string, appKey: string, ): Promise<{ ok: true }> { return this.request<{ ok: true }>( `/api/workspaces/${workspaceSlug}/apps/${appKey}`, { method: "DELETE", }, ); } async emitAppAmbientEvents( workspaceSlug: string, appKey: string, input: EmitAmbientEventsInputInput, ): Promise<{ events: Array<{ id: string; dedupeKey: string }> }> { const body = emitAmbientEventsInputSchema.parse(input); return this.request<{ events: Array<{ id: string; dedupeKey: string }> }>( `/api/v1/workspaces/${workspaceSlug}/apps/${appKey}/ambient/events`, { method: "POST", body: JSON.stringify(body), }, ); } async createAppNotification( workspaceSlug: string, appKey: string, input: CreateNotificationInputInput, ): Promise<{ ok: true }> { const body = createNotificationInputSchema.parse(input); return this.request<{ ok: true }>( `/api/workspaces/${workspaceSlug}/apps/${appKey}/notifications`, { method: "POST", body: JSON.stringify(body), }, ); } async upsertAppIndexDocuments( workspaceSlug: string, appKey: string, input: BatchUpsertAppIndexDocumentsInput, ): Promise<{ documents: Array<{ id: string; documentKey: string; visibilityMode: string }> }> { const body = batchUpsertAppIndexDocumentsSchema.parse(input); return this.request<{ documents: Array<{ id: string; documentKey: string; visibilityMode: string }>; }>(`/api/workspaces/${workspaceSlug}/apps/${appKey}/index-documents`, { method: "POST", body: JSON.stringify(body), }); } async deleteAppIndexDocuments( workspaceSlug: string, appKey: string, input: BatchDeleteAppIndexDocumentsInput, ): Promise<{ deleted: Array<{ id: string; documentKey: string }> }> { const body = batchDeleteAppIndexDocumentsSchema.parse(input); return this.request<{ deleted: Array<{ id: string; documentKey: string }> }>( `/api/workspaces/${workspaceSlug}/apps/${appKey}/index-documents`, { method: "DELETE", body: JSON.stringify(body), }, ); } }