import {
  batchDeleteAppIndexDocumentsSchema,
  batchUpsertAppIndexDocumentsSchema,
  colineAppRegistrationPayloadSchema,
  createNotificationInputSchema,
  emitAmbientEventsInputSchema,
  appPermissionSchema,
  type AppPermission,
  type BatchDeleteAppIndexDocumentsInput,
  type BatchUpsertAppIndexDocumentsInput,
  type ColineAppRegistrationPayload,
  type ColineAppRegistrationPayloadInput,
  type CreateNotificationInputInput,
  type EmitAmbientEventsInputInput,
} from "./manifest";
import { ColineApiError } from "./errors";
import type { components as AppPlatformComponents } from "./generated/app-platform-v1";
import {
  createAppPlatformClient,
  type AppPlatformClient,
} from "./app-platform-client";

interface ApiErrorPayload {
  error?: {
    code?: string;
    message?: string;
  };
}

async function parseJsonResponse<T>(response: Response): Promise<T> {
  const payload = (await response.json().catch(() => null)) as T | null;

  if (!response.ok) {
    const errorMessage =
      payload &&
      typeof payload === "object" &&
      "error_description" in payload &&
      typeof (payload as Record<string, unknown>)["error_description"] === "string"
        ? ((payload as Record<string, unknown>)["error_description"] as string)
        : `Request failed (${response.status}).`;

    throw new ColineApiError({
      message: errorMessage,
      type: "oauth",
      status: response.status,
      code:
        payload &&
        typeof payload === "object" &&
        "error" in payload &&
        typeof (payload as Record<string, unknown>)["error"] === "string"
          ? ((payload as Record<string, unknown>)["error"] as string)
          : null,
    });
  }

  if (!payload) {
    throw new ColineApiError({
      message: "Invalid JSON response.",
      type: "oauth",
      status: response.status,
    });
  }

  return payload;
}

export interface ColineApiClientOptions {
  baseUrl: string;
  apiKey?: string;
  fetch?: typeof fetch;
  headers?: HeadersInit;
}

type Schemas = AppPlatformComponents["schemas"];
type UnwrapData<TKey extends keyof Schemas> =
  Schemas[TKey] extends { data: infer T } ? T : never;

export type RegisteredAppDetail = Schemas["RegisteredAppDetail"];
export type RegisteredAppRecord = Omit<
  RegisteredAppDetail,
  "latestPublishedVersionId"
>;
export type RegisteredAppVersionSummary = Schemas["RegisteredAppVersionSummary"];
export type WorkspaceInstalledApp = Schemas["InstalledAppSummary"];
export type WorkspaceAppCatalogItem = Schemas["AppCatalogItem"];
export type WorkspaceAppsResponse = UnwrapData<"WorkspaceAppsResponse">;

export interface InstallWorkspaceAppInput {
  appId: string;
  pinnedVersionId?: string;
  grantedPermissions?: AppPermission[];
}

export type InstallWorkspaceAppResponse = UnwrapData<"InstallWorkspaceAppResponse">;

export interface SubmitAppVersionForReviewInput {
  storeListed?: boolean;
}

export type SubmitAppVersionForReviewResponse = UnwrapData<
  "SubmitAppVersionForReviewResponse"
>;
export type WorkspaceAppPermissionsResponse = UnwrapData<
  "WorkspaceAppPermissionsResponse"
>;
export type WorkspaceInstalledAppResponse = UnwrapData<
  "WorkspaceInstalledAppResponse"
>;
export type WorkspaceAppSecretsResponse = UnwrapData<
  "WorkspaceAppSecretsResponse"
>;
export type WorkspaceAppSecretSummary = WorkspaceAppSecretsResponse["secrets"][number];
export type CreateWorkspaceAppSecretResponse = UnwrapData<
  "CreateWorkspaceAppSecretResponse"
>;
export type WorkspaceAppOauthConnectionsResponse = UnwrapData<
  "WorkspaceAppOauthConnectionsResponse"
>;
export type WorkspaceAppOauthConnectionSummary =
  WorkspaceAppOauthConnectionsResponse["connections"][number];
export type CreateWorkspaceAppOauthConnectionResponse = UnwrapData<
  "CreateWorkspaceAppOauthConnectionResponse"
>;
export type WorkspaceAppDeliveriesResponse = UnwrapData<
  "WorkspaceAppDeliveriesResponse"
>;
export type WorkspaceAppDeliverySummary =
  WorkspaceAppDeliveriesResponse["deliveries"][number];
export type SendWorkspaceAppTestDeliveryResponse = UnwrapData<
  "SendWorkspaceAppTestDeliveryResponse"
>;
export type AppFilesListResponse = UnwrapData<"AppFilesListResponse">;
export type AppFileDocumentResponse = UnwrapData<"AppFileDocumentResponse">;
export type AppFileDocumentUpdateResponse = UnwrapData<
  "AppFileDocumentUpdateResponse"
>;
export type CreateAppFileResponse = UnwrapData<"CreateAppFileResponse">;
export type ExecuteAppActionResponse = UnwrapData<"ExecuteAppActionResponse">;
export type OkResponse = UnwrapData<"OkResponse">;
export type TabModelRecord = Schemas["TabModelRecord"];
export type TabModelsResponse = UnwrapData<"TabModelsResponse">;
export type TabChatCompletionResponse = UnwrapData<
  "TabChatCompletionResponseEnvelope"
>;
export type UpsertAppIndexDocumentsResponse = UnwrapData<
  "UpsertAppIndexDocumentsResponse"
>;
export type DeleteAppIndexDocumentsResponse = UnwrapData<
  "DeleteAppIndexDocumentsResponse"
>;
export type EmitAppAmbientEventsResponse = UnwrapData<
  "EmitAppAmbientEventsResponse"
>;

export interface OAuthTokenResponse {
  access_token: string;
  token_type: "Bearer";
  expires_in: number;
  refresh_token: string;
  scope: string;
}

export interface OAuthUserInfoResponse {
  sub: string;
  email: string;
  email_verified: boolean;
  name: string;
  given_name: string | null;
  family_name: string | null;
  picture: string | null;
  preferred_username: string | null;
  scope: string;
}

export interface UpdateWorkspaceAppPermissionsInput {
  grantedPermissions: AppPermission[];
}

export interface CreateAppFileInput {
  name: string;
  typeKey?: string;
  driveId?: string;
  parentId?: string | null;
  document?: Record<string, unknown>;
}

export interface ExecuteAppActionInput {
  action: {
    type: string;
    payload?: Record<string, unknown>;
  };
  fileId?: string | null;
}

// ---------------------------------------------------------------------------
// Core Platform API — Types
// ---------------------------------------------------------------------------

export interface WorkspaceMember {
  id: string;
  workspaceMemberId: string;
  email: string;
  firstName: string | null;
  lastName: string | null;
  avatarUrl: string | null;
  joinedAt: string;
  roles: string[];
}

export interface WorkspaceMembersResponse {
  members: WorkspaceMember[];
}

export interface WorkspaceNoteSummary {
  id: string;
  driveId: string;
  parentId: string | null;
  title: string;
  body: string;
  color: string | null;
  createdByUserId: string | null;
  createdAt: string;
  updatedAt: string;
}

export interface WorkspaceNoteDetail extends WorkspaceNoteSummary {
  blocks: unknown[];
}

export interface WorkspaceNotesListResponse {
  notes: WorkspaceNoteSummary[];
  page: { limit: number; hasMore: boolean; nextCursor: string | null };
}

export interface WorkspaceNoteResponse {
  note: WorkspaceNoteSummary;
}

export interface WorkspaceNoteDetailResponse {
  note: WorkspaceNoteDetail;
}

export interface ListWorkspaceNotesQuery {
  q?: string;
  limit?: number;
  cursor?: string;
}

export interface CreateWorkspaceNoteInput {
  title?: string;
  body?: string;
  blocks?: unknown[];
  driveId?: string;
  parentId?: string | null;
}

export interface UpdateWorkspaceNoteInput {
  title?: string;
  body?: string;
  blocks?: unknown[];
}

export interface CalendarEventLinkInput {
  linkType: "file" | "channel" | "url";
  fileId?: string;
  channelId?: string;
  url?: string;
  label?: string | null;
}

export interface CalendarRecurrenceRule {
  frequency: "daily" | "weekly" | "monthly" | "yearly";
  interval: number;
  byDay?: Array<"MO" | "TU" | "WE" | "TH" | "FR" | "SA" | "SU">;
  count?: number;
  until?: string;
}

export interface CreateCalendarEventInput {
  title: string;
  description?: string | null;
  location?: string | null;
  startsAt: string;
  endsAt: string;
  timeZone: string;
  isAllDay?: boolean;
  visibility?: "private" | "invitees" | "workspace";
  attendeeUserIds?: string[];
  linkInputs?: CalendarEventLinkInput[];
  recurrenceRule?: CalendarRecurrenceRule | null;
}

export interface UpdateCalendarEventInput {
  title?: string;
  description?: string | null;
  location?: string | null;
  startsAt?: string;
  endsAt?: string;
  timeZone?: string;
  isAllDay?: boolean;
  visibility?: "private" | "invitees" | "workspace";
  status?: "active" | "canceled";
  attendeeUserIds?: string[];
  linkInputs?: CalendarEventLinkInput[];
  recurrenceRule?: CalendarRecurrenceRule | null;
}

/**
 * Calendar events list response — shape matches the server's `listCalendarEvents` output.
 */
export type CalendarEventsListResponse = Record<string, unknown>;

/**
 * Calendar event detail response — shape matches the server's `getCalendarEventDetail` output.
 */
export type CalendarEventDetailResponse = Record<string, unknown>;

export interface WorkspaceSearchInput {
  query: string;
  sourceKinds?: Array<
    "file" | "task" | "container_message" | "kairo_message" | "app_document"
  >;
  limit?: number;
  cursor?: string;
}

export interface WorkspaceSearchResult {
  id: string;
  title: string | null;
  snippet: string | null;
  sourceKind: string;
  sourceId: string;
  url: string | null;
  score: number;
}

export interface WorkspaceSearchResponse {
  results: WorkspaceSearchResult[];
  nextCursor: string | null;
}

export interface TaskboardStatusSummary {
  id: string;
  key: string;
  name: string;
  color: string;
  isDefault: boolean;
  isCompleted: boolean;
  sortOrder: number;
}

export interface TaskboardSummary {
  id: string;
  name: string;
  driveId: string;
  color: string | null;
  identifierPrefix: string | null;
  description: string | null;
  defaultView: string | null;
  statuses: TaskboardStatusSummary[];
  createdAt: string;
  updatedAt: string;
}

export interface WorkspaceTaskboardsResponse {
  taskboards: TaskboardSummary[];
}

export interface TaskAssignee {
  id: string;
  firstName: string | null;
  lastName: string | null;
  avatarUrl: string | null;
  email: string;
}

export interface TaskSummary {
  id: string;
  taskboardId: string;
  taskNumber: number;
  identifier: string | null;
  title: string;
  description: string | null;
  status: {
    id: string;
    key: string;
    name: string;
    color: string;
    isCompleted: boolean;
  } | null;
  priority: string;
  labels: string[];
  dueDate: string | null;
  assignees: TaskAssignee[];
  isCompleted: boolean;
  completedAt: string | null;
  createdByUserId: string | null;
  createdAt: string;
  updatedAt: string;
}

export interface TaskboardTasksResponse {
  tasks: TaskSummary[];
}

export interface ListTaskboardTasksQuery {
  q?: string;
  statusId?: string;
  assigneeUserId?: string;
  limit?: number;
}

export interface CreateTaskInput {
  title: string;
  description?: string;
  statusId?: string;
  priority?: "none" | "low" | "medium" | "high" | "urgent";
  dueDate?: string | null;
  labels?: string[];
  assigneeUserIds?: string[];
}

export interface CreateTaskResponse {
  task: {
    id: string;
    taskboardId: string;
    title: string;
    description: string;
    statusId: string;
    priority: string;
    labels: string[];
    dueDate: string | null;
    assigneeUserIds: string[];
    createdByUserId: string;
    createdAt: string;
    updatedAt: string;
  };
}

export interface UpdateTaskInput {
  title?: string;
  description?: string;
  statusId?: string;
  priority?: "none" | "low" | "medium" | "high" | "urgent";
  dueDate?: string | null;
  labels?: string[];
  assigneeUserIds?: string[];
}

function joinUrl(baseUrl: string, path: string): string {
  return `${baseUrl.replace(/\/+$/, "")}${path}`;
}

function toRegisterAppInput(payload: ColineAppRegistrationPayload) {
  const notificationChannels = payload.manifest.notificationChannels.map((channel) => ({
    key: channel.key,
    name: channel.name,
    defaultDeliveries: [...channel.defaultDeliveries],
    defaultPriority: channel.defaultPriority,
    ...(channel.description ? { description: channel.description } : {}),
  }));

  const ui =
    payload.manifest.ui.mode || payload.manifest.ui.homePath || payload.manifest.ui.filePath
      ? {
          ...(payload.manifest.ui.mode
            ? { mode: payload.manifest.ui.mode }
            : {}),
          ...(payload.manifest.ui.homePath
            ? { homePath: payload.manifest.ui.homePath }
            : {}),
          ...(payload.manifest.ui.filePath
            ? { filePath: payload.manifest.ui.filePath }
            : {}),
        }
      : undefined;

  const manifest = {
    key: payload.manifest.key,
    name: payload.manifest.name,
    permissions: payload.manifest.permissions,
    notificationChannels,
    hosting: {
      mode: payload.manifest.hosting.mode,
      baseUrl: payload.manifest.hosting.baseUrl,
    },
    ...(ui ? { ui } : {}),
    ...(payload.manifest.description
      ? { description: payload.manifest.description }
      : {}),
    ...(payload.manifest.iconUrl ? { iconUrl: payload.manifest.iconUrl } : {}),
    ...(payload.manifest.kairo
      ? {
          kairo: JSON.parse(JSON.stringify(payload.manifest.kairo)) as Record<
            string,
            unknown
          >,
        }
      : {}),
  };

  const fileTypes = payload.fileTypes.map((fileType) => ({
    typeKey: fileType.typeKey,
    name: fileType.name,
    storage: fileType.storage,
    indexable: fileType.indexable,
    homeRenderMode: fileType.homeRenderMode,
    ...(fileType.description ? { description: fileType.description } : {}),
  }));

  return {
    version: payload.version,
    manifest,
    fileTypes,
  };
}

export class ColineApiClient {
  private readonly baseUrl: string;
  private readonly apiKey: string | undefined;
  private readonly fetchImpl: typeof fetch;
  private readonly defaultHeaders: HeadersInit | undefined;
  private readonly appPlatformClient: AppPlatformClient;

  constructor(options: ColineApiClientOptions) {
    this.baseUrl = options.baseUrl;
    this.apiKey = options.apiKey;
    this.fetchImpl = options.fetch ?? fetch;
    this.defaultHeaders = options.headers;
    this.appPlatformClient = createAppPlatformClient(options);
  }

  private async unwrapGeneratedResponse<T>(
    promise: Promise<{
      data?: { data: T };
      error?: ApiErrorPayload;
      response: Response;
    }>,
  ): Promise<T> {
    const { data, error, response } = await promise;

    if (error) {
      throw new ColineApiError({
        message: error.error?.message ?? `Request failed (${response.status}).`,
        type: "api",
        status: response.status,
        code: error.error?.code ?? null,
      });
    }

    if (data === undefined) {
      throw new ColineApiError({
        message: "Invalid API response.",
        type: "api",
        status: response.status,
      });
    }

    return data.data;
  }

  withApiKey(apiKey: string): ColineApiClient {
    const options: ColineApiClientOptions = {
      baseUrl: this.baseUrl,
      apiKey,
      fetch: this.fetchImpl,
    };

    if (this.defaultHeaders !== undefined) {
      options.headers = this.defaultHeaders;
    }

    return new ColineApiClient(options);
  }

  withHeaders(headers: HeadersInit): ColineApiClient {
    const mergedHeaders = new Headers(this.defaultHeaders);
    new Headers(headers).forEach((value, key) => mergedHeaders.set(key, value));

    const options: ColineApiClientOptions = {
      baseUrl: this.baseUrl,
      fetch: this.fetchImpl,
      headers: mergedHeaders,
    };

    if (this.apiKey !== undefined) {
      options.apiKey = this.apiKey;
    }

    return new ColineApiClient(options);
  }

  buildLoginWithColineAuthorizeUrl(input: {
    clientId: string;
    redirectUri: string;
    scope?: string;
    state?: string;
    codeChallenge?: string;
    codeChallengeMethod?: "S256" | "plain";
  }): string {
    const url = new URL("/api/v1/oauth/authorize", this.baseUrl);
    url.searchParams.set("response_type", "code");
    url.searchParams.set("client_id", input.clientId);
    url.searchParams.set("redirect_uri", input.redirectUri);
    if (input.scope) {
      url.searchParams.set("scope", input.scope);
    }
    if (input.state) {
      url.searchParams.set("state", input.state);
    }
    if (input.codeChallenge) {
      url.searchParams.set("code_challenge", input.codeChallenge);
    }
    if (input.codeChallengeMethod) {
      url.searchParams.set("code_challenge_method", input.codeChallengeMethod);
    }
    return url.toString();
  }

  async listApps(): Promise<{ apps: RegisteredAppRecord[] }> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.GET("/api/v1/apps"),
    );
  }

  async getApp(appKey: string): Promise<{ app: RegisteredAppDetail }> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.GET("/api/v1/apps/{appKey}", {
        params: { path: { appKey } },
      }),
    );
  }

  async listAppVersions(
    appKey: string,
  ): Promise<{ versions: RegisteredAppVersionSummary[] }> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.GET("/api/v1/apps/{appKey}/versions", {
        params: { path: { appKey } },
      }),
    );
  }

  async registerApp(
    payload: ColineAppRegistrationPayloadInput,
  ): Promise<{ appId: string; appKey: string; versionId: string; version: string }> {
    const body = toRegisterAppInput(colineAppRegistrationPayloadSchema.parse(payload));

    return this.unwrapGeneratedResponse(
      this.appPlatformClient.POST("/api/v1/apps", {
        body,
      }),
    );
  }

  async createAppVersion(
    appKey: string,
    payload: ColineAppRegistrationPayloadInput,
  ): Promise<{ appId: string; appKey: string; versionId: string; version: string }> {
    const body = toRegisterAppInput(colineAppRegistrationPayloadSchema.parse(payload));

    return this.unwrapGeneratedResponse(
      this.appPlatformClient.POST("/api/v1/apps/{appKey}/versions", {
        params: { path: { appKey } },
        body,
      }),
    );
  }

  async submitAppVersionForReview(
    appKey: string,
    versionId: string,
    input: SubmitAppVersionForReviewInput = {},
  ): Promise<SubmitAppVersionForReviewResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.POST(
        "/api/v1/apps/{appKey}/versions/{versionId}/submit",
        {
          params: { path: { appKey, versionId } },
          body: {
            ...(input.storeListed !== undefined
              ? { storeListed: input.storeListed }
              : {}),
          },
        },
      ),
    );
  }

  async listWorkspaceApps(workspaceSlug: string): Promise<WorkspaceAppsResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.GET("/api/v1/workspaces/{workspaceSlug}/apps", {
        params: { path: { workspaceSlug } },
      }),
    );
  }

  async installWorkspaceApp(
    workspaceSlug: string,
    input: InstallWorkspaceAppInput,
  ): Promise<InstallWorkspaceAppResponse> {
    const grantedPermissions = input.grantedPermissions
      ? input.grantedPermissions.map((permission) =>
          appPermissionSchema.parse(permission),
        )
      : undefined;

    return this.unwrapGeneratedResponse(
      this.appPlatformClient.POST("/api/v1/workspaces/{workspaceSlug}/apps", {
        params: { path: { workspaceSlug } },
        body: {
          appId: input.appId,
          ...(input.pinnedVersionId
            ? { pinnedVersionId: input.pinnedVersionId }
            : {}),
          ...(grantedPermissions ? { grantedPermissions } : {}),
        },
      }),
    );
  }

  async getWorkspaceAppPermissions(
    workspaceSlug: string,
    appKey: string,
  ): Promise<WorkspaceAppPermissionsResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.GET(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/permissions",
        {
          params: { path: { workspaceSlug, appKey } },
        },
      ),
    );
  }

  async getWorkspaceInstalledApp(
    workspaceSlug: string,
    appKey: string,
  ): Promise<WorkspaceInstalledAppResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.GET("/api/v1/workspaces/{workspaceSlug}/apps/{appKey}", {
        params: { path: { workspaceSlug, appKey } },
      }),
    );
  }

  async updateWorkspaceAppPermissions(
    workspaceSlug: string,
    appKey: string,
    input: UpdateWorkspaceAppPermissionsInput,
  ): Promise<WorkspaceAppPermissionsResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.PUT(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/permissions",
        {
          params: { path: { workspaceSlug, appKey } },
          body: {
            grantedPermissions: input.grantedPermissions.map((permission) =>
              appPermissionSchema.parse(permission),
            ),
          },
        },
      ),
    );
  }

  async uninstallWorkspaceApp(
    workspaceSlug: string,
    appKey: string,
  ): Promise<{ ok: true }> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.DELETE(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}",
        {
          params: { path: { workspaceSlug, appKey } },
        },
      ),
    );
  }

  async listWorkspaceAppSecrets(
    workspaceSlug: string,
    appKey: string,
  ): Promise<WorkspaceAppSecretsResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.GET(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/secrets",
        {
          params: { path: { workspaceSlug, appKey } },
        },
      ),
    );
  }

  async createWorkspaceAppSecret(
    workspaceSlug: string,
    appKey: string,
    input: { key: string; value: string },
  ): Promise<CreateWorkspaceAppSecretResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.POST(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/secrets",
        {
          params: { path: { workspaceSlug, appKey } },
          body: input,
        },
      ),
    );
  }

  async deleteWorkspaceAppSecret(
    workspaceSlug: string,
    appKey: string,
    secretId: string,
  ): Promise<{ ok: true }> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.DELETE(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/secrets/{secretId}",
        {
          params: { path: { workspaceSlug, appKey, secretId } },
        },
      ),
    );
  }

  async listWorkspaceAppOauthConnections(
    workspaceSlug: string,
    appKey: string,
  ): Promise<WorkspaceAppOauthConnectionsResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.GET(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/oauth-connections",
        {
          params: { path: { workspaceSlug, appKey } },
        },
      ),
    );
  }

  async createWorkspaceAppOauthConnection(
    workspaceSlug: string,
    appKey: string,
    input: {
      providerKey: string;
      externalAccountId?: string | null;
      accessToken: string;
      refreshToken?: string | null;
      scopes: string[];
      tokenExpiresAt?: string | null;
      metadata?: Record<string, unknown>;
    },
  ): Promise<CreateWorkspaceAppOauthConnectionResponse> {
    const body: {
      providerKey: string;
      accessToken: string;
      scopes: string[];
      externalAccountId?: string;
      refreshToken?: string;
      tokenExpiresAt?: string;
      metadata?: Record<string, unknown>;
    } = {
      providerKey: input.providerKey,
      accessToken: input.accessToken,
      scopes: input.scopes,
    };

    if (input.externalAccountId) {
      body.externalAccountId = input.externalAccountId;
    }
    if (input.refreshToken) {
      body.refreshToken = input.refreshToken;
    }
    if (input.tokenExpiresAt) {
      body.tokenExpiresAt = input.tokenExpiresAt;
    }
    if (input.metadata) {
      body.metadata = input.metadata;
    }

    return this.unwrapGeneratedResponse(
      this.appPlatformClient.POST(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/oauth-connections",
        {
          params: { path: { workspaceSlug, appKey } },
          body,
        },
      ),
    );
  }

  async deleteWorkspaceAppOauthConnection(
    workspaceSlug: string,
    appKey: string,
    connectionId: string,
  ): Promise<{ ok: true }> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.DELETE(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/oauth-connections/{connectionId}",
        {
          params: { path: { workspaceSlug, appKey, connectionId } },
        },
      ),
    );
  }

  async listWorkspaceAppDeliveries(
    workspaceSlug: string,
    appKey: string,
  ): Promise<WorkspaceAppDeliveriesResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.GET(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/deliveries",
        {
          params: { path: { workspaceSlug, appKey } },
        },
      ),
    );
  }

  async sendWorkspaceAppTestDelivery(
    workspaceSlug: string,
    appKey: string,
    input: {
      eventType: string;
      targetUrl?: string;
      payload: Record<string, unknown>;
    },
  ): Promise<SendWorkspaceAppTestDeliveryResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.POST(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/deliveries",
        {
          params: { path: { workspaceSlug, appKey } },
          body: input,
        },
      ),
    );
  }

  async replayWorkspaceAppDelivery(
    workspaceSlug: string,
    appKey: string,
    deliveryId: string,
  ): Promise<SendWorkspaceAppTestDeliveryResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.POST(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/deliveries/{deliveryId}/replay",
        {
          params: { path: { workspaceSlug, appKey, deliveryId } },
        },
      ),
    );
  }

  async emitAppAmbientEvents(
    workspaceSlug: string,
    appKey: string,
    input: EmitAmbientEventsInputInput,
  ): Promise<EmitAppAmbientEventsResponse> {
    const parsed = emitAmbientEventsInputSchema.parse(input);
    const body = {
      events: parsed.events.map((event) => ({
        sourceKind: event.sourceKind,
        action: event.action,
        entityType: event.entityType,
        entityId: event.entityId,
        dedupeKey: event.dedupeKey,
        payload: event.payload,
        metadata: event.metadata,
        schemaVersion: event.schemaVersion,
        ...(event.actorUserId ? { actorUserId: event.actorUserId } : {}),
        ...(event.containerType ? { containerType: event.containerType } : {}),
        ...(event.containerId ? { containerId: event.containerId } : {}),
        ...(event.occurredAt
          ? { occurredAt: event.occurredAt.toISOString() }
          : {}),
      })),
    };

    return this.unwrapGeneratedResponse(
      this.appPlatformClient.POST(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/ambient/events",
        {
          params: { path: { workspaceSlug, appKey } },
          body,
        },
      ),
    );
  }

  async createAppNotification(
    workspaceSlug: string,
    appKey: string,
    input: CreateNotificationInputInput,
  ): Promise<OkResponse> {
    const parsed = createNotificationInputSchema.parse(input);
    const body = {
      channelKey: parsed.channelKey,
      typeKey: parsed.typeKey,
      recipients: parsed.recipients.map((recipient) => ({
        userId: recipient.userId,
      })),
      title: parsed.title,
      priority: parsed.priority,
      metadata: parsed.metadata,
      ...(parsed.body ? { body: parsed.body } : {}),
      ...(parsed.targetUrl ? { targetUrl: parsed.targetUrl } : {}),
      ...(parsed.icon ? { icon: parsed.icon } : {}),
      ...(parsed.dedupeKey ? { dedupeKey: parsed.dedupeKey } : {}),
    };

    return this.unwrapGeneratedResponse(
      this.appPlatformClient.POST(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/notifications",
        {
          params: { path: { workspaceSlug, appKey } },
          body,
        },
      ),
    );
  }

  async upsertAppIndexDocuments(
    workspaceSlug: string,
    appKey: string,
    input: BatchUpsertAppIndexDocumentsInput,
  ): Promise<UpsertAppIndexDocumentsResponse> {
    const parsed = batchUpsertAppIndexDocumentsSchema.parse(input);
    const body = {
      documents: parsed.documents.map((document) => ({
        documentKey: document.documentKey,
        documentType: document.documentType,
        title: document.title,
        body: document.body,
        metadata: document.metadata,
        visibilityMode: document.visibilityMode,
        visibility: document.visibility.map((grant) => ({
          subjectType: grant.subjectType,
          subjectId: grant.subjectId,
        })),
        ...(document.fileId ? { fileId: document.fileId } : {}),
        ...(document.url ? { url: document.url } : {}),
      })),
    };

    return this.unwrapGeneratedResponse(
      this.appPlatformClient.POST(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/index-documents",
        {
          params: { path: { workspaceSlug, appKey } },
          body,
        },
      ),
    );
  }

  async deleteAppIndexDocuments(
    workspaceSlug: string,
    appKey: string,
    input: BatchDeleteAppIndexDocumentsInput,
  ): Promise<DeleteAppIndexDocumentsResponse> {
    const body = batchDeleteAppIndexDocumentsSchema.parse(input);

    return this.unwrapGeneratedResponse(
      this.appPlatformClient.DELETE(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/index-documents",
        {
          params: { path: { workspaceSlug, appKey } },
          body,
        },
      ),
    );
  }

  async listAppFiles(
    workspaceSlug: string,
    appKey: string,
    query?: {
      driveId?: string;
      typeKey?: string;
      limit?: number;
    },
  ): Promise<AppFilesListResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.GET(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/files",
        {
          params: {
            path: { workspaceSlug, appKey },
            ...(query
              ? {
                  query: {
                    ...(query.driveId ? { driveId: query.driveId } : {}),
                    ...(query.typeKey ? { typeKey: query.typeKey } : {}),
                    ...(query.limit !== undefined ? { limit: query.limit } : {}),
                  },
                }
              : {}),
          },
        },
      ),
    );
  }

  async createAppFile(
    workspaceSlug: string,
    appKey: string,
    input: CreateAppFileInput,
  ): Promise<CreateAppFileResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.POST(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/files",
        {
          params: { path: { workspaceSlug, appKey } },
          body: {
            name: input.name,
            ...(input.typeKey ? { typeKey: input.typeKey } : {}),
            ...(input.driveId ? { driveId: input.driveId } : {}),
            ...(input.parentId !== undefined ? { parentId: input.parentId } : {}),
            ...(input.document ? { document: input.document } : {}),
          },
        },
      ),
    );
  }

  async executeAppAction(
    workspaceSlug: string,
    appKey: string,
    input: ExecuteAppActionInput,
  ): Promise<ExecuteAppActionResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.POST(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/actions",
        {
          params: { path: { workspaceSlug, appKey } },
          body: {
            action: {
              type: input.action.type,
              ...(input.action.payload ? { payload: input.action.payload } : {}),
            },
            ...(input.fileId !== undefined ? { fileId: input.fileId } : {}),
          },
        },
      ),
    );
  }

  async getAppFileDocument(
    workspaceSlug: string,
    appKey: string,
    fileId: string,
  ): Promise<AppFileDocumentResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.GET(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/files/{fileId}",
        {
          params: { path: { workspaceSlug, appKey, fileId } },
        },
      ),
    );
  }

  async updateAppFileDocument(
    workspaceSlug: string,
    appKey: string,
    fileId: string,
    document: Record<string, unknown>,
  ): Promise<AppFileDocumentUpdateResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.PATCH(
        "/api/v1/workspaces/{workspaceSlug}/apps/{appKey}/files/{fileId}",
        {
          params: { path: { workspaceSlug, appKey, fileId } },
          body: { document },
        },
      ),
    );
  }

  async listTabModels(): Promise<TabModelsResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.GET("/api/v1/tab/models"),
    );
  }

  async createTabChatCompletion(input: {
    model: string;
    stream?: boolean;
    tab_context: Record<string, unknown>;
    messages?: Array<{ role?: string; content?: string }>;
  }): Promise<TabChatCompletionResponse> {
    return this.unwrapGeneratedResponse(
      this.appPlatformClient.POST("/api/v1/tab/chat/completions", {
        body: input,
      }),
    );
  }

  async exchangeOAuthCode(input: {
    clientId: string;
    clientSecret: string;
    code: string;
    redirectUri: string;
    codeVerifier?: string;
  }): Promise<OAuthTokenResponse> {
    const response = await this.fetchImpl(joinUrl(this.baseUrl, "/api/v1/oauth/token"), {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        grant_type: "authorization_code",
        client_id: input.clientId,
        client_secret: input.clientSecret,
        code: input.code,
        redirect_uri: input.redirectUri,
        ...(input.codeVerifier ? { code_verifier: input.codeVerifier } : {}),
      }),
    });

    return parseJsonResponse<OAuthTokenResponse>(response);
  }

  async getOAuthUserInfo(accessToken: string): Promise<OAuthUserInfoResponse> {
    const response = await this.fetchImpl(joinUrl(this.baseUrl, "/api/v1/oauth/userinfo"), {
      method: "GET",
      headers: {
        Authorization: `Bearer ${accessToken}`,
      },
    });

    return parseJsonResponse<OAuthUserInfoResponse>(response);
  }

  // ---------------------------------------------------------------------------
  // Core Platform API — internal fetch helper
  // ---------------------------------------------------------------------------

  private async coreRequest<T>(
    method: string,
    path: string,
    body?: unknown,
  ): Promise<T> {
    const headers: Record<string, string> = {};
    if (this.apiKey) {
      headers["Authorization"] = `Bearer ${this.apiKey}`;
    }
    if (body !== undefined) {
      headers["Content-Type"] = "application/json";
    }
    if (this.defaultHeaders) {
      new Headers(this.defaultHeaders).forEach((v, k) => {
        headers[k] = v;
      });
    }

    const response = await this.fetchImpl(joinUrl(this.baseUrl, path), {
      method,
      headers,
      ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
    });

    if (!response.ok) {
      const payload = (await response.json().catch(() => null)) as ApiErrorPayload | null;
      throw new ColineApiError({
        message:
          payload?.error?.message ?? `Request failed (${response.status}).`,
        type: "api",
        status: response.status,
        code: payload?.error?.code ?? null,
      });
    }

    const json = (await response.json().catch(() => null)) as {
      data: T;
    } | null;

    if (!json || !("data" in json)) {
      throw new ColineApiError({
        message: "Invalid API response.",
        type: "api",
        status: response.status,
      });
    }

    return json.data;
  }

  // ---------------------------------------------------------------------------
  // Core Platform API — Workspace Members
  // ---------------------------------------------------------------------------

  async listWorkspaceMembers(
    workspaceId: string,
  ): Promise<WorkspaceMembersResponse> {
    return this.coreRequest<WorkspaceMembersResponse>(
      "GET",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/members`,
    );
  }

  // ---------------------------------------------------------------------------
  // Core Platform API — Notes
  // ---------------------------------------------------------------------------

  async listWorkspaceNotes(
    workspaceId: string,
    query?: ListWorkspaceNotesQuery,
  ): Promise<WorkspaceNotesListResponse> {
    const params = new URLSearchParams();
    if (query?.q) params.set("q", query.q);
    if (query?.limit !== undefined) params.set("limit", String(query.limit));
    if (query?.cursor) params.set("cursor", query.cursor);
    const qs = params.toString();
    return this.coreRequest<WorkspaceNotesListResponse>(
      "GET",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/notes${qs ? `?${qs}` : ""}`,
    );
  }

  async createWorkspaceNote(
    workspaceId: string,
    input: CreateWorkspaceNoteInput,
  ): Promise<WorkspaceNoteResponse> {
    return this.coreRequest<WorkspaceNoteResponse>(
      "POST",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/notes`,
      {
        ...(input.title !== undefined ? { title: input.title } : {}),
        ...(input.body !== undefined ? { body: input.body } : {}),
        ...(input.blocks !== undefined ? { blocks: input.blocks } : {}),
        ...(input.driveId !== undefined ? { driveId: input.driveId } : {}),
        ...(input.parentId !== undefined ? { parentId: input.parentId } : {}),
      },
    );
  }

  async getWorkspaceNote(
    workspaceId: string,
    noteId: string,
  ): Promise<WorkspaceNoteDetailResponse> {
    return this.coreRequest<WorkspaceNoteDetailResponse>(
      "GET",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/notes/${encodeURIComponent(noteId)}`,
    );
  }

  async updateWorkspaceNote(
    workspaceId: string,
    noteId: string,
    input: UpdateWorkspaceNoteInput,
  ): Promise<WorkspaceNoteResponse> {
    return this.coreRequest<WorkspaceNoteResponse>(
      "PUT",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/notes/${encodeURIComponent(noteId)}`,
      input,
    );
  }

  async deleteWorkspaceNote(
    workspaceId: string,
    noteId: string,
  ): Promise<{ ok: true }> {
    return this.coreRequest<{ ok: true }>(
      "DELETE",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/notes/${encodeURIComponent(noteId)}`,
    );
  }

  // ---------------------------------------------------------------------------
  // Core Platform API — Calendar Events
  // ---------------------------------------------------------------------------

  async listCalendarEvents(
    workspaceId: string,
    range: { start: string; end: string },
  ): Promise<CalendarEventsListResponse> {
    const params = new URLSearchParams({
      start: range.start,
      end: range.end,
    });
    return this.coreRequest<CalendarEventsListResponse>(
      "GET",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/calendar/events?${params}`,
    );
  }

  async createCalendarEvent(
    workspaceId: string,
    input: CreateCalendarEventInput,
  ): Promise<CalendarEventDetailResponse> {
    return this.coreRequest<CalendarEventDetailResponse>(
      "POST",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/calendar/events`,
      input,
    );
  }

  async getCalendarEvent(
    workspaceId: string,
    eventId: string,
  ): Promise<CalendarEventDetailResponse> {
    return this.coreRequest<CalendarEventDetailResponse>(
      "GET",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/calendar/events/${encodeURIComponent(eventId)}`,
    );
  }

  async updateCalendarEvent(
    workspaceId: string,
    eventId: string,
    input: UpdateCalendarEventInput,
  ): Promise<CalendarEventDetailResponse> {
    return this.coreRequest<CalendarEventDetailResponse>(
      "PATCH",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/calendar/events/${encodeURIComponent(eventId)}`,
      input,
    );
  }

  async deleteCalendarEvent(
    workspaceId: string,
    eventId: string,
  ): Promise<{ ok: true }> {
    return this.coreRequest<{ ok: true }>(
      "DELETE",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/calendar/events/${encodeURIComponent(eventId)}`,
    );
  }

  // ---------------------------------------------------------------------------
  // Core Platform API — Search
  // ---------------------------------------------------------------------------

  async searchWorkspace(
    workspaceId: string,
    input: WorkspaceSearchInput,
  ): Promise<WorkspaceSearchResponse> {
    return this.coreRequest<WorkspaceSearchResponse>(
      "POST",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/search`,
      input,
    );
  }

  // ---------------------------------------------------------------------------
  // Core Platform API — Taskboards
  // ---------------------------------------------------------------------------

  async listWorkspaceTaskboards(
    workspaceId: string,
  ): Promise<WorkspaceTaskboardsResponse> {
    return this.coreRequest<WorkspaceTaskboardsResponse>(
      "GET",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/taskboards`,
    );
  }

  // ---------------------------------------------------------------------------
  // Core Platform API — Tasks
  // ---------------------------------------------------------------------------

  async listTaskboardTasks(
    workspaceId: string,
    taskboardId: string,
    query?: ListTaskboardTasksQuery,
  ): Promise<TaskboardTasksResponse> {
    const params = new URLSearchParams();
    if (query?.q) params.set("q", query.q);
    if (query?.statusId) params.set("statusId", query.statusId);
    if (query?.assigneeUserId) params.set("assigneeUserId", query.assigneeUserId);
    if (query?.limit !== undefined) params.set("limit", String(query.limit));
    const qs = params.toString();
    return this.coreRequest<TaskboardTasksResponse>(
      "GET",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/taskboards/${encodeURIComponent(taskboardId)}/tasks${qs ? `?${qs}` : ""}`,
    );
  }

  async createTaskboardTask(
    workspaceId: string,
    taskboardId: string,
    input: CreateTaskInput,
  ): Promise<CreateTaskResponse> {
    return this.coreRequest<CreateTaskResponse>(
      "POST",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/taskboards/${encodeURIComponent(taskboardId)}/tasks`,
      input,
    );
  }

  async updateTaskboardTask(
    workspaceId: string,
    taskboardId: string,
    taskId: string,
    input: UpdateTaskInput,
  ): Promise<{ ok: true }> {
    return this.coreRequest<{ ok: true }>(
      "PATCH",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/taskboards/${encodeURIComponent(taskboardId)}/tasks/${encodeURIComponent(taskId)}`,
      input,
    );
  }

  async deleteTaskboardTask(
    workspaceId: string,
    taskboardId: string,
    taskId: string,
  ): Promise<{ ok: true }> {
    return this.coreRequest<{ ok: true }>(
      "DELETE",
      `/api/v1/workspaces/${encodeURIComponent(workspaceId)}/taskboards/${encodeURIComponent(taskboardId)}/tasks/${encodeURIComponent(taskId)}`,
    );
  }
}