@keboola/api-client 35.0.0 → 39.0.0

package/dist/apps/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["createOpenapiFetchClient","createAuthHeaders","readAppLogsTail","readAppLogsDownload"],"sources":["../../src/clients/apps/appsClient.ts"],"sourcesContent":["import { readAppLogsDownload, readAppLogsTail } from '../../domain/appLogs';\nimport { createOpenapiFetchClient } from '../../fetchClient';\nimport { createAuthHeaders } from '../auth';\nimport type { ClientInitOptions } from '../types';\n\nimport type { paths } from './__generated__/schema';\nimport type {\n  App,\n  AppId,\n  CreateAppBody,\n  CreateCredentialBody,\n  CreateDeploymentBody,\n  CredentialId,\n  DeploymentId,\n  GetAppRunsQuery,\n  GetAppsQuery,\n  GetLogsTailQuery,\n  RunId,\n} from './types';\n\n/**\n * No `idempotencyKey`. The service accepted an `Idempotency-Key` that turned a replayed create\n * into a no-op, and support for it was **dropped on 17 Aug 2026** — the spec still documents the\n * header and has yet to catch up. It was\n * unusable from a browser in any case — the service's `Access-Control-Allow-Headers` never listed\n * the header, so sending it failed the preflight and the request never left the page.\n *\n * Every create here is therefore a genuine create, and a caller that retries one is responsible\n * for the duplicate it may produce.\n */\ntype WriteOptions = {\n  signal?: AbortSignal;\n};\n\ntype LogsTailOptions = {\n  query?: GetLogsTailQuery;\n  signal?: AbortSignal;\n};\n\n/**\n * `/v2` App Deployments — data apps plus the immutable deployment history behind them. Sibling of\n * the `dataScience` client, which wraps the same service's `/v1` surface.\n *\n * `baseUrl` must already point past the `/v2` prefix (`https://<data-science-host>/v2`); the\n * registry composes it — see `createServiceClients`.\n *\n * Two documented endpoints are deliberately absent: `PATCH /apps/{appId}` has no patchable field\n * yet (`name`/`description` are create-only, so `{}` is the only accepted body), and\n * `POST /apps/{appId}/activity` is apps-proxy's heartbeat, authenticated by a Manage API token with\n * the `apps:proxy` scope that this storage-token client cannot supply.\n */\nexport const createAppsClient = ({ baseUrl, middlewares, auth }: ClientInitOptions) => {\n  const client = createOpenapiFetchClient<paths>({\n    baseUrl,\n    middlewares,\n    headers: createAuthHeaders(auth),\n  });\n\n  const writeOptions = ({ signal }: WriteOptions) => ({ signal });\n\n  /** Service metadata (`appName`, `appVersion`, `apiDocs`) — the `/v2` surface has no `/health-check`. */\n  const healthCheck = async (signal?: AbortSignal) => {\n    const { data } = await client.get('/', {}, { signal });\n\n    return data;\n  };\n\n  const getApps = async (query: GetAppsQuery = {}, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps', { query }, { signal });\n\n    return data;\n  };\n\n  const getApp = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /**\n   * Reserves the app and its Storage configuration only. Content (`parameters`) and auth\n   * (`authorization.app_proxy`) are written afterwards through the Storage API, on the config named\n   * by the response's `componentId`/`branchId`/`configId`.\n   */\n  const createApp = async (body: CreateAppBody, options: WriteOptions = {}) => {\n    const { data } = await client.post('/apps', { body }, writeOptions(options));\n\n    return data;\n  };\n\n  const deleteApp = async (appId: AppId, signal?: AbortSignal) => {\n    await client.delete('/apps/{appId}', { path: { appId } }, { signal });\n  };\n\n  /**\n   * Drops production routing — the app's URL 404s afterwards. `null` when there was nothing to\n   * unpublish (already unpublished, or never deployed via `/v2`): the service answers `204`.\n   */\n  const unpublishApp = async (appId: AppId, signal?: AbortSignal): Promise<App | null> => {\n    const { data } = await client.post('/apps/{appId}/unpublish', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /**\n   * Sleeps the app now instead of waiting for the idle timer, and disarms wake-on-request: a\n   * visitor gets a `503` until an explicit {@link resumeApp}. `null` when already suspended (`204`).\n   */\n  const suspendApp = async (appId: AppId, signal?: AbortSignal): Promise<App | null> => {\n    const { data } = await client.post('/apps/{appId}/suspend', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /**\n   * Wakes the app now and re-arms wake-on-request. `null` when it was already running (`204`).\n   * The returned app reports `STARTING` — the operator has not confirmed it serving yet.\n   */\n  const resumeApp = async (appId: AppId, signal?: AbortSignal): Promise<App | null> => {\n    const { data } = await client.post('/apps/{appId}/resume', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** `password` is `null` until one is minted — by the app's first deployment or {@link resetAppPassword}. */\n  const getAppPassword = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/password', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** Mints a fresh password, replacing any existing one. Read it back with {@link getAppPassword}. */\n  const resetAppPassword = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.post(\n      '/apps/{appId}/reset-password',\n      { path: { appId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /**\n   * Runs of the app, newest first — app-wide, so this is where a failed deployment's cause lives\n   * (`failureReason`, `startupLogs`). Narrow to one deployment with `query.deploymentId`.\n   */\n  const getAppRuns = async (appId: AppId, query: GetAppRunsQuery = {}, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/runs', { path: { appId }, query }, { signal });\n\n    return data;\n  };\n\n  const getAppRun = async (appId: AppId, runId: RunId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/runs/{runId}',\n      { path: { appId, runId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /**\n   * Deploys the app's current config version as a new immutable deployment, promoting it unless\n   * `body.promote` is `false` (a staged release never runs until promoted). The id and `number` come\n   * back synchronously; readiness does not.\n   */\n  const createDeployment = async (\n    appId: AppId,\n    body?: CreateDeploymentBody,\n    options: WriteOptions = {},\n  ) => {\n    const { data } = await client.post(\n      '/apps/{appId}/deployments',\n      { path: { appId }, body },\n      writeOptions(options),\n    );\n\n    return data;\n  };\n\n  /** Full history, retired (`archived: true`) deployments included — rows outlive their workloads. */\n  const getDeployments = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/deployments', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  const getDeployment = async (appId: AppId, deploymentId: DeploymentId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/deployments/{deploymentId}',\n      { path: { appId, deploymentId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /**\n   * Retires the deployment: the workload and its rendered-config secret go, the row stays in\n   * history as `archived`. Rejected with a `409` while the app's `production` still names it.\n   */\n  const deleteDeployment = async (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    signal?: AbortSignal,\n  ) => {\n    await client.delete(\n      '/apps/{appId}/deployments/{deploymentId}',\n      { path: { appId, deploymentId } },\n      { signal },\n    );\n  };\n\n  /**\n   * Makes this deployment production — the same call rolls back, applied to an older one. The route\n   * switches only once the target serves, so the returned app's `production.desiredId` and\n   * `.actualId` differ until it converges. `null` when it was already production (`204`).\n   */\n  const promoteDeployment = async (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    signal?: AbortSignal,\n  ): Promise<App | null> => {\n    const { data } = await client.post(\n      '/apps/{appId}/deployments/{deploymentId}/promote',\n      { path: { appId, deploymentId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /**\n   * Container output of the app's currently serving member. `query.since` and `query.lines` are\n   * mutually exclusive; passing neither returns the log from its start.\n   */\n  const getAppLogsTail = (appId: AppId, { query, signal }: LogsTailOptions = {}) =>\n    readAppLogsTail(() =>\n      client.get('/apps/{appId}/logs/tail', { path: { appId }, query }, { signal }),\n    );\n\n  const getAppLogsDownload = (appId: AppId, signal?: AbortSignal) =>\n    readAppLogsDownload(() =>\n      client.get('/apps/{appId}/logs/download', { path: { appId } }, { signal }),\n    );\n\n  const getDeploymentLogsTail = (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    { query, signal }: LogsTailOptions = {},\n  ) =>\n    readAppLogsTail(() =>\n      client.get(\n        '/apps/{appId}/deployments/{deploymentId}/logs/tail',\n        { path: { appId, deploymentId }, query },\n        { signal },\n      ),\n    );\n\n  const getDeploymentLogsDownload = (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    signal?: AbortSignal,\n  ) =>\n    readAppLogsDownload(() =>\n      client.get(\n        '/apps/{appId}/deployments/{deploymentId}/logs/download',\n        { path: { appId, deploymentId } },\n        { signal },\n      ),\n    );\n\n  /** The app's Git repository — managed or external. `409` when it has none configured. */\n  const getAppGitRepo = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/git-repo', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** Credentials of the app's managed repository, per app rather than per deployment. */\n  const getAppGitRepoCredentials = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/git-repo/credentials',\n      { path: { appId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  const getAppGitRepoCredential = async (\n    appId: AppId,\n    credentialId: CredentialId,\n    signal?: AbortSignal,\n  ) => {\n    const { data } = await client.get(\n      '/apps/{appId}/git-repo/credentials/{credentialId}',\n      { path: { appId, credentialId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /** An `http_token` credential returns its `secret` here and nowhere else — store it now or lose it. */\n  const createAppGitRepoCredential = async (\n    appId: AppId,\n    body: CreateCredentialBody,\n    options: WriteOptions = {},\n  ) => {\n    const { data } = await client.post(\n      '/apps/{appId}/git-repo/credentials',\n      { path: { appId }, body },\n      writeOptions(options),\n    );\n\n    return data;\n  };\n\n  const deleteAppGitRepoCredential = async (\n    appId: AppId,\n    credentialId: CredentialId,\n    signal?: AbortSignal,\n  ) => {\n    await client.delete(\n      '/apps/{appId}/git-repo/credentials/{credentialId}',\n      { path: { appId, credentialId } },\n      { signal },\n    );\n  };\n\n  return {\n    healthCheck,\n    getApps,\n    getApp,\n    createApp,\n    deleteApp,\n    unpublishApp,\n    suspendApp,\n    resumeApp,\n    getAppPassword,\n    resetAppPassword,\n    getAppRuns,\n    getAppRun,\n    createDeployment,\n    getDeployments,\n    getDeployment,\n    deleteDeployment,\n    promoteDeployment,\n    getAppLogsTail,\n    getAppLogsDownload,\n    getDeploymentLogsTail,\n    getDeploymentLogsDownload,\n    getAppGitRepo,\n    getAppGitRepoCredentials,\n    getAppGitRepoCredential,\n    createAppGitRepoCredential,\n    deleteAppGitRepoCredential,\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["createOpenapiFetchClient","createAuthHeaders","readAppLogsTail","readAppLogsDownload"],"sources":["../../src/clients/apps/appsClient.ts"],"sourcesContent":["import { readAppLogsDownload, readAppLogsTail } from '../../domain/appLogs';\nimport { createOpenapiFetchClient } from '../../fetchClient';\nimport { createAuthHeaders } from '../auth';\nimport type { ClientInitOptions } from '../types';\n\nimport type { paths } from './__generated__/schema';\nimport type {\n  App,\n  AppId,\n  CreateAppBody,\n  CreateCredentialBody,\n  CreateDeploymentBody,\n  CredentialId,\n  DeploymentId,\n  GetAppRunsQuery,\n  GetAppsQuery,\n  GetDeploymentsQuery,\n  GetLogsTailQuery,\n  RunId,\n} from './types';\n\n/**\n * Options every write takes.\n *\n * - No `idempotencyKey`: the service accepts no `Idempotency-Key`, so every create here is a\n *   genuine create and a caller that retries one owns the duplicate it may produce.\n */\ntype WriteOptions = {\n  signal?: AbortSignal;\n};\n\ntype LogsTailOptions = {\n  query?: GetLogsTailQuery;\n  signal?: AbortSignal;\n};\n\n/**\n * `/v2` App Deployments — data apps plus the immutable deployment history behind them. Sibling of\n * the `dataScience` client, which wraps the same service's `/v1` surface.\n *\n * `baseUrl` must already point past the `/v2` prefix (`https://<data-science-host>/v2`); the\n * registry composes it — see `createServiceClients`.\n *\n * One documented endpoint is deliberately absent: `POST /apps/{appId}/activity` is apps-proxy's\n * heartbeat, authenticated by a Manage API token with the `apps:proxy` scope that this\n * storage-token client cannot supply.\n */\nexport const createAppsClient = ({ baseUrl, middlewares, auth }: ClientInitOptions) => {\n  const client = createOpenapiFetchClient<paths>({\n    baseUrl,\n    middlewares,\n    headers: createAuthHeaders(auth),\n  });\n\n  const writeOptions = ({ signal }: WriteOptions) => ({ signal });\n\n  /** Service metadata (`appName`, `appVersion`, `apiDocs`) — the `/v2` surface has no `/health-check`. */\n  const healthCheck = async (signal?: AbortSignal) => {\n    const { data } = await client.get('/', {}, { signal });\n\n    return data;\n  };\n\n  const getApps = async (query: GetAppsQuery = {}, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps', { query }, { signal });\n\n    return data;\n  };\n\n  const getApp = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /**\n   * Reserves the app and its Storage configuration only. Content (`parameters`) and auth\n   * (`authorization.app_proxy`) are written afterwards through the Storage API, on the config named\n   * by the response's `componentId`/`branchId`/`configId`.\n   */\n  const createApp = async (body: CreateAppBody, options: WriteOptions = {}) => {\n    const { data } = await client.post('/apps', { body }, writeOptions(options));\n\n    return data;\n  };\n\n  const deleteApp = async (appId: AppId, signal?: AbortSignal) => {\n    await client.delete('/apps/{appId}', { path: { appId } }, { signal });\n  };\n\n  /**\n   * Drops production routing — the app's URL 404s afterwards. A no-op (already unpublished, or\n   * never deployed) returns the app unchanged rather than failing.\n   */\n  const unpublishApp = async (appId: AppId, signal?: AbortSignal): Promise<App> => {\n    const { data } = await client.post('/apps/{appId}/unpublish', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /**\n   * Sleeps the app now instead of waiting for the idle timer, and disarms wake-on-request: a\n   * visitor gets a `503` until an explicit {@link resumeApp}. A no-op on an already suspended app.\n   */\n  const suspendApp = async (appId: AppId, signal?: AbortSignal): Promise<App> => {\n    const { data } = await client.post('/apps/{appId}/suspend', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /**\n   * Wakes the app now and re-arms wake-on-request. A no-op on an already running app.\n   * The returned app reports `starting` — the operator has not confirmed it serving yet.\n   */\n  const resumeApp = async (appId: AppId, signal?: AbortSignal): Promise<App> => {\n    const { data } = await client.post('/apps/{appId}/resume', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** `password` is `null` until one is minted — by the app's first deployment or {@link resetAppPassword}. */\n  const getAppPassword = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/password', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** Mints a fresh password, replacing any existing one. Read it back with {@link getAppPassword}. */\n  const resetAppPassword = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.post(\n      '/apps/{appId}/password/reset',\n      { path: { appId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /**\n   * Runs of the app, newest first — app-wide, so this is where a failed deployment's cause lives\n   * (`failureReason`, `startupLogs`). Narrow to one deployment with `query.deploymentId`.\n   */\n  const getAppRuns = async (appId: AppId, query: GetAppRunsQuery = {}, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/runs', { path: { appId }, query }, { signal });\n\n    return data;\n  };\n\n  const getAppRun = async (appId: AppId, runId: RunId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/runs/{runId}',\n      { path: { appId, runId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /**\n   * Deploys the app's current config version as a new immutable deployment, promoting it unless\n   * `body.promote` is `false` (a staged release never runs until promoted). Pin an older config\n   * version with `body.configVersion`. The deployment comes back synchronously; readiness does not.\n   */\n  const createDeployment = async (\n    appId: AppId,\n    body?: CreateDeploymentBody,\n    options: WriteOptions = {},\n  ) => {\n    const { data } = await client.post(\n      '/apps/{appId}/deployments',\n      { path: { appId }, body },\n      writeOptions(options),\n    );\n\n    return data;\n  };\n\n  /**\n   * Deployment history, newest page first.\n   *\n   * - `query.archived` filters on whether the deployment was deleted; omitting it returns both.\n   * - A deleted deployment keeps its row — history outlives the workload.\n   */\n  const getDeployments = async (\n    appId: AppId,\n    query: GetDeploymentsQuery = {},\n    signal?: AbortSignal,\n  ) => {\n    const { data } = await client.get(\n      '/apps/{appId}/deployments',\n      { path: { appId }, query },\n      { signal },\n    );\n\n    return data;\n  };\n\n  const getDeployment = async (appId: AppId, deploymentId: DeploymentId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/deployments/{deploymentId}',\n      { path: { appId, deploymentId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /**\n   * Deletes the deployment: its running resources and credentials go, the row stays in history as\n   * `archived`. Rejected with a `409` while the app's `production` still names it.\n   */\n  const deleteDeployment = async (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    signal?: AbortSignal,\n  ) => {\n    await client.delete(\n      '/apps/{appId}/deployments/{deploymentId}',\n      { path: { appId, deploymentId } },\n      { signal },\n    );\n  };\n\n  /**\n   * Makes this deployment production — the same call rolls back, applied to an older one. The route\n   * switches only once the target serves, so the returned app's `production.desiredDeploymentId`\n   * and `.actualDeploymentId` differ until it converges.\n   */\n  const promoteDeployment = async (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    signal?: AbortSignal,\n  ): Promise<App> => {\n    const { data } = await client.post(\n      '/apps/{appId}/deployments/{deploymentId}/promote',\n      { path: { appId, deploymentId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /**\n   * Container output of the app's currently serving member. `query.since` and `query.lines` are\n   * mutually exclusive; passing neither returns the log from its start.\n   */\n  const getAppLogsTail = (appId: AppId, { query, signal }: LogsTailOptions = {}) =>\n    readAppLogsTail(() =>\n      client.get('/apps/{appId}/logs/tail', { path: { appId }, query }, { signal }),\n    );\n\n  const getAppLogsDownload = (appId: AppId, signal?: AbortSignal) =>\n    readAppLogsDownload(() =>\n      client.get('/apps/{appId}/logs/download', { path: { appId } }, { signal }),\n    );\n\n  const getDeploymentLogsTail = (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    { query, signal }: LogsTailOptions = {},\n  ) =>\n    readAppLogsTail(() =>\n      client.get(\n        '/apps/{appId}/deployments/{deploymentId}/logs/tail',\n        { path: { appId, deploymentId }, query },\n        { signal },\n      ),\n    );\n\n  const getDeploymentLogsDownload = (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    signal?: AbortSignal,\n  ) =>\n    readAppLogsDownload(() =>\n      client.get(\n        '/apps/{appId}/deployments/{deploymentId}/logs/download',\n        { path: { appId, deploymentId } },\n        { signal },\n      ),\n    );\n\n  /** The app's Git repository — managed or external. `409` when it has none configured. */\n  const getAppGitRepo = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/git-repo', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** Credentials of the app's managed repository, per app rather than per deployment. */\n  const getAppGitRepoCredentials = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/git-repo/credentials',\n      { path: { appId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  const getAppGitRepoCredential = async (\n    appId: AppId,\n    credentialId: CredentialId,\n    signal?: AbortSignal,\n  ) => {\n    const { data } = await client.get(\n      '/apps/{appId}/git-repo/credentials/{credentialId}',\n      { path: { appId, credentialId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /** An `http_token` credential returns its `secret` here and nowhere else — store it now or lose it. */\n  const createAppGitRepoCredential = async (\n    appId: AppId,\n    body: CreateCredentialBody,\n    options: WriteOptions = {},\n  ) => {\n    const { data } = await client.post(\n      '/apps/{appId}/git-repo/credentials',\n      { path: { appId }, body },\n      writeOptions(options),\n    );\n\n    return data;\n  };\n\n  const deleteAppGitRepoCredential = async (\n    appId: AppId,\n    credentialId: CredentialId,\n    signal?: AbortSignal,\n  ) => {\n    await client.delete(\n      '/apps/{appId}/git-repo/credentials/{credentialId}',\n      { path: { appId, credentialId } },\n      { signal },\n    );\n  };\n\n  return {\n    healthCheck,\n    getApps,\n    getApp,\n    createApp,\n    deleteApp,\n    unpublishApp,\n    suspendApp,\n    resumeApp,\n    getAppPassword,\n    resetAppPassword,\n    getAppRuns,\n    getAppRun,\n    createDeployment,\n    getDeployments,\n    getDeployment,\n    deleteDeployment,\n    promoteDeployment,\n    getAppLogsTail,\n    getAppLogsDownload,\n    getDeploymentLogsTail,\n    getDeploymentLogsDownload,\n    getAppGitRepo,\n    getAppGitRepoCredentials,\n    getAppGitRepoCredential,\n    createAppGitRepoCredential,\n    deleteAppGitRepoCredential,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;AA+CA,MAAa,oBAAoB,EAAE,SAAS,aAAa,WAA8B;CACrF,MAAM,SAASA,iCAAAA,yBAAgC;EAC7C;EACA;EACA,SAASC,aAAAA,kBAAkB,IAAI;CACjC,CAAC;CAED,MAAM,gBAAgB,EAAE,cAA4B,EAAE,OAAO;;CAG7D,MAAM,cAAc,OAAO,WAAyB;EAClD,MAAM,EAAE,SAAS,MAAM,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC;EAErD,OAAO;CACT;CAEA,MAAM,UAAU,OAAO,QAAsB,CAAC,GAAG,WAAyB;EACxE,MAAM,EAAE,SAAS,MAAM,OAAO,IAAI,SAAS,EAAE,MAAM,GAAG,EAAE,OAAO,CAAC;EAEhE,OAAO;CACT;CAEA,MAAM,SAAS,OAAO,OAAc,WAAyB;EAC3D,MAAM,EAAE,SAAS,MAAM,OAAO,IAAI,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC;EAElF,OAAO;CACT;;;;;;CAOA,MAAM,YAAY,OAAO,MAAqB,UAAwB,CAAC,MAAM;EAC3E,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,SAAS,EAAE,KAAK,GAAG,aAAa,OAAO,CAAC;EAE3E,OAAO;CACT;CAEA,MAAM,YAAY,OAAO,OAAc,WAAyB;EAC9D,MAAM,OAAO,OAAO,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC;CACtE;;;;;CAMA,MAAM,eAAe,OAAO,OAAc,WAAuC;EAC/E,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,2BAA2B,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC;EAE7F,OAAO;CACT;;;;;CAMA,MAAM,aAAa,OAAO,OAAc,WAAuC;EAC7E,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,yBAAyB,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC;EAE3F,OAAO;CACT;;;;;CAMA,MAAM,YAAY,OAAO,OAAc,WAAuC;EAC5E,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,wBAAwB,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC;EAE1F,OAAO;CACT;;CAGA,MAAM,iBAAiB,OAAO,OAAc,WAAyB;EACnE,MAAM,EAAE,SAAS,MAAM,OAAO,IAAI,0BAA0B,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC;EAE3F,OAAO;CACT;;CAGA,MAAM,mBAAmB,OAAO,OAAc,WAAyB;EACrE,MAAM,EAAE,SAAS,MAAM,OAAO,KAC5B,gCACA,EAAE,MAAM,EAAE,MAAM,EAAE,GAClB,EAAE,OAAO,CACX;EAEA,OAAO;CACT;;;;;CAMA,MAAM,aAAa,OAAO,OAAc,QAAyB,CAAC,GAAG,WAAyB;EAC5F,MAAM,EAAE,SAAS,MAAM,OAAO,IAAI,sBAAsB;GAAE,MAAM,EAAE,MAAM;GAAG;EAAM,GAAG,EAAE,OAAO,CAAC;EAE9F,OAAO;CACT;CAEA,MAAM,YAAY,OAAO,OAAc,OAAc,WAAyB;EAC5E,MAAM,EAAE,SAAS,MAAM,OAAO,IAC5B,8BACA,EAAE,MAAM;GAAE;GAAO;EAAM,EAAE,GACzB,EAAE,OAAO,CACX;EAEA,OAAO;CACT;;;;;;CAOA,MAAM,mBAAmB,OACvB,OACA,MACA,UAAwB,CAAC,MACtB;EACH,MAAM,EAAE,SAAS,MAAM,OAAO,KAC5B,6BACA;GAAE,MAAM,EAAE,MAAM;GAAG;EAAK,GACxB,aAAa,OAAO,CACtB;EAEA,OAAO;CACT;;;;;;;CAQA,MAAM,iBAAiB,OACrB,OACA,QAA6B,CAAC,GAC9B,WACG;EACH,MAAM,EAAE,SAAS,MAAM,OAAO,IAC5B,6BACA;GAAE,MAAM,EAAE,MAAM;GAAG;EAAM,GACzB,EAAE,OAAO,CACX;EAEA,OAAO;CACT;CAEA,MAAM,gBAAgB,OAAO,OAAc,cAA4B,WAAyB;EAC9F,MAAM,EAAE,SAAS,MAAM,OAAO,IAC5B,4CACA,EAAE,MAAM;GAAE;GAAO;EAAa,EAAE,GAChC,EAAE,OAAO,CACX;EAEA,OAAO;CACT;;;;;CAMA,MAAM,mBAAmB,OACvB,OACA,cACA,WACG;EACH,MAAM,OAAO,OACX,4CACA,EAAE,MAAM;GAAE;GAAO;EAAa,EAAE,GAChC,EAAE,OAAO,CACX;CACF;;;;;;CAOA,MAAM,oBAAoB,OACxB,OACA,cACA,WACiB;EACjB,MAAM,EAAE,SAAS,MAAM,OAAO,KAC5B,oDACA,EAAE,MAAM;GAAE;GAAO;EAAa,EAAE,GAChC,EAAE,OAAO,CACX;EAEA,OAAO;CACT;;;;;CAMA,MAAM,kBAAkB,OAAc,EAAE,OAAO,WAA4B,CAAC,MAC1EC,gBAAAA,sBACE,OAAO,IAAI,2BAA2B;EAAE,MAAM,EAAE,MAAM;EAAG;CAAM,GAAG,EAAE,OAAO,CAAC,CAC9E;CAEF,MAAM,sBAAsB,OAAc,WACxCC,gBAAAA,0BACE,OAAO,IAAI,+BAA+B,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAC3E;CAEF,MAAM,yBACJ,OACA,cACA,EAAE,OAAO,WAA4B,CAAC,MAEtCD,gBAAAA,sBACE,OAAO,IACL,sDACA;EAAE,MAAM;GAAE;GAAO;EAAa;EAAG;CAAM,GACvC,EAAE,OAAO,CACX,CACF;CAEF,MAAM,6BACJ,OACA,cACA,WAEAC,gBAAAA,0BACE,OAAO,IACL,0DACA,EAAE,MAAM;EAAE;EAAO;CAAa,EAAE,GAChC,EAAE,OAAO,CACX,CACF;;CAGF,MAAM,gBAAgB,OAAO,OAAc,WAAyB;EAClE,MAAM,EAAE,SAAS,MAAM,OAAO,IAAI,0BAA0B,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC;EAE3F,OAAO;CACT;;CAGA,MAAM,2BAA2B,OAAO,OAAc,WAAyB;EAC7E,MAAM,EAAE,SAAS,MAAM,OAAO,IAC5B,sCACA,EAAE,MAAM,EAAE,MAAM,EAAE,GAClB,EAAE,OAAO,CACX;EAEA,OAAO;CACT;CAEA,MAAM,0BAA0B,OAC9B,OACA,cACA,WACG;EACH,MAAM,EAAE,SAAS,MAAM,OAAO,IAC5B,qDACA,EAAE,MAAM;GAAE;GAAO;EAAa,EAAE,GAChC,EAAE,OAAO,CACX;EAEA,OAAO;CACT;;CAGA,MAAM,6BAA6B,OACjC,OACA,MACA,UAAwB,CAAC,MACtB;EACH,MAAM,EAAE,SAAS,MAAM,OAAO,KAC5B,sCACA;GAAE,MAAM,EAAE,MAAM;GAAG;EAAK,GACxB,aAAa,OAAO,CACtB;EAEA,OAAO;CACT;CAEA,MAAM,6BAA6B,OACjC,OACA,cACA,WACG;EACH,MAAM,OAAO,OACX,qDACA,EAAE,MAAM;GAAE;GAAO;EAAa,EAAE,GAChC,EAAE,OAAO,CACX;CACF;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}

package/dist/apps/index.d.cts

@@ -1,16 +1,12 @@
 import { n as ClientInitOptions } from "../types-_RhBCj4_.cjs";
-import { S as components, b as GetLogsTailQuery, c as CreateCredentialBody, f as CredentialId, g as DeploymentId, l as CreateDeploymentBody, r as AppId, s as CreateAppBody, t as App, v as GetAppRunsQuery, x as RunId, y as GetAppsQuery } from "../types-DARv_P6O.cjs";
+import { C as components, S as RunId, b as GetDeploymentsQuery, c as CreateCredentialBody, f as CredentialId, g as DeploymentId, l as CreateDeploymentBody, r as AppId, s as CreateAppBody, t as App, v as GetAppRunsQuery, x as GetLogsTailQuery, y as GetAppsQuery } from "../types-DXskkNp8.cjs";
 import { t as LogEntry } from "../appLogs-D5A13Y0y.cjs";
 //#region src/clients/apps/appsClient.d.ts
 /**
- * No `idempotencyKey`. The service accepted an `Idempotency-Key` that turned a replayed create
- * into a no-op, and support for it was **dropped on 17 Aug 2026** — the spec still documents the
- * header and has yet to catch up. It was
- * unusable from a browser in any case — the service's `Access-Control-Allow-Headers` never listed
- * the header, so sending it failed the preflight and the request never left the page.
+ * Options every write takes.
  *
- * Every create here is therefore a genuine create, and a caller that retries one is responsible
- * for the duplicate it may produce.
+ * - No `idempotencyKey`: the service accepts no `Idempotency-Key`, so every create here is a
+ *   genuine create and a caller that retries one owns the duplicate it may produce.
  */
 type WriteOptions = {
   signal?: AbortSignal;
@@ -26,10 +22,9 @@ type LogsTailOptions = {
  * `baseUrl` must already point past the `/v2` prefix (`https://<data-science-host>/v2`); the
  * registry composes it — see `createServiceClients`.
  *
- * Two documented endpoints are deliberately absent: `PATCH /apps/{appId}` has no patchable field
- * yet (`name`/`description` are create-only, so `{}` is the only accepted body), and
- * `POST /apps/{appId}/activity` is apps-proxy's heartbeat, authenticated by a Manage API token with
- * the `apps:proxy` scope that this storage-token client cannot supply.
+ * One documented endpoint is deliberately absent: `POST /apps/{appId}/activity` is apps-proxy's
+ * heartbeat, authenticated by a Manage API token with the `apps:proxy` scope that this
+ * storage-token client cannot supply.
  */
 declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptions) => {
   healthCheck: (signal?: AbortSignal) => Promise<{
@@ -43,18 +38,13 @@ declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptio
     componentId: string;
     branchId: string | null;
     configId: string;
-    configVersion: string;
     type?: 'streamlit' | 'python-js' | null;
-    mode?: 'prod' | 'dev';
     url: string | null;
     production: {
-      desiredNumber?: number | null;
-      desiredId?: string | null;
-      actualNumber?: number | null;
-      actualId?: string | null;
+      desiredDeploymentId?: string | null;
+      actualDeploymentId?: string | null;
     };
-    undeployedChanges?: boolean;
-    state: 'NOT_DEPLOYED' | 'STARTING' | 'RUNNING' | 'SLEEPING' | 'SUSPENDED';
+    state: 'notDeployed' | 'starting' | 'running' | 'suspended' | 'disabled';
   }[]>;
   getApp: (appId: AppId, signal?: AbortSignal) => Promise<{
     id: string;
@@ -62,18 +52,13 @@ declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptio
     componentId: string;
     branchId: string | null;
     configId: string;
-    configVersion: string;
     type?: 'streamlit' | 'python-js' | null;
-    mode?: 'prod' | 'dev';
     url: string | null;
     production: {
-      desiredNumber?: number | null;
-      desiredId?: string | null;
-      actualNumber?: number | null;
-      actualId?: string | null;
+      desiredDeploymentId?: string | null;
+      actualDeploymentId?: string | null;
     };
-    undeployedChanges?: boolean;
-    state: 'NOT_DEPLOYED' | 'STARTING' | 'RUNNING' | 'SLEEPING' | 'SUSPENDED';
+    state: 'notDeployed' | 'starting' | 'running' | 'suspended' | 'disabled';
   }>;
   createApp: (body: CreateAppBody, options?: WriteOptions) => Promise<{
     id: string;
@@ -81,44 +66,23 @@ declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptio
     componentId: string;
     branchId: string | null;
     configId: string;
-    configVersion: string;
     type?: 'streamlit' | 'python-js' | null;
-    mode?: 'prod' | 'dev';
     url: string | null;
     production: {
-      desiredNumber?: number | null;
-      desiredId?: string | null;
-      actualNumber?: number | null;
-      actualId?: string | null;
+      desiredDeploymentId?: string | null;
+      actualDeploymentId?: string | null;
     };
-    undeployedChanges?: boolean;
-    state: 'NOT_DEPLOYED' | 'STARTING' | 'RUNNING' | 'SLEEPING' | 'SUSPENDED';
+    state: 'notDeployed' | 'starting' | 'running' | 'suspended' | 'disabled';
   }>;
   deleteApp: (appId: AppId, signal?: AbortSignal) => Promise<void>;
-  unpublishApp: (appId: AppId, signal?: AbortSignal) => Promise<App | null>;
-  suspendApp: (appId: AppId, signal?: AbortSignal) => Promise<App | null>;
-  resumeApp: (appId: AppId, signal?: AbortSignal) => Promise<App | null>;
+  unpublishApp: (appId: AppId, signal?: AbortSignal) => Promise<App>;
+  suspendApp: (appId: AppId, signal?: AbortSignal) => Promise<App>;
+  resumeApp: (appId: AppId, signal?: AbortSignal) => Promise<App>;
   getAppPassword: (appId: AppId, signal?: AbortSignal) => Promise<{
     password?: string | null;
   }>;
   resetAppPassword: (appId: AppId, signal?: AbortSignal) => Promise<{
-    id: string;
-    projectId: string;
-    componentId: string;
-    branchId: string | null;
-    configId: string;
-    configVersion: string;
-    type?: 'streamlit' | 'python-js' | null;
-    mode?: 'prod' | 'dev';
-    url: string | null;
-    production: {
-      desiredNumber?: number | null;
-      desiredId?: string | null;
-      actualNumber?: number | null;
-      actualId?: string | null;
-    };
-    undeployedChanges?: boolean;
-    state: 'NOT_DEPLOYED' | 'STARTING' | 'RUNNING' | 'SLEEPING' | 'SUSPENDED';
+    password: string;
   }>;
   getAppRuns: (appId: AppId, query?: GetAppRunsQuery, signal?: AbortSignal) => Promise<{
     id: string;
@@ -160,45 +124,39 @@ declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptio
   }>;
   createDeployment: (appId: AppId, body?: CreateDeploymentBody, options?: WriteOptions) => Promise<{
     id: string;
-    number: number;
-    configId: string;
     configVersion: string;
     gitCommitSha: string | null;
-    size?: 'micro' | 'tiny' | 'small' | 'medium' | 'large' | 'external' | null;
-    buildState: 'PREBUILT' | 'PENDING' | 'BUILDING' | 'BUILT' | 'FAILED';
-    runState: 'NEVER_RUN' | 'PENDING' | 'STARTING' | 'RUNNING' | 'STOPPING' | 'STOPPED' | 'FAILED';
+    runtimeSize?: 'micro' | 'tiny' | 'small' | 'medium' | 'large' | 'external' | null;
+    buildState: 'pending' | 'building' | 'ready' | 'failed';
+    runState: 'neverRun' | 'pending' | 'starting' | 'running' | 'stopping' | 'stopped' | 'failed';
     archived: boolean;
     archivedAt: string | null;
     createdAt: string;
   }>;
-  getDeployments: (appId: AppId, signal?: AbortSignal) => Promise<{
+  getDeployments: (appId: AppId, query?: GetDeploymentsQuery, signal?: AbortSignal) => Promise<{
     id: string;
-    number: number;
-    configId: string;
     configVersion: string;
     gitCommitSha: string | null;
-    size?: 'micro' | 'tiny' | 'small' | 'medium' | 'large' | 'external' | null;
-    buildState: 'PREBUILT' | 'PENDING' | 'BUILDING' | 'BUILT' | 'FAILED';
-    runState: 'NEVER_RUN' | 'PENDING' | 'STARTING' | 'RUNNING' | 'STOPPING' | 'STOPPED' | 'FAILED';
+    runtimeSize?: 'micro' | 'tiny' | 'small' | 'medium' | 'large' | 'external' | null;
+    buildState: 'pending' | 'building' | 'ready' | 'failed';
+    runState: 'neverRun' | 'pending' | 'starting' | 'running' | 'stopping' | 'stopped' | 'failed';
     archived: boolean;
     archivedAt: string | null;
     createdAt: string;
   }[]>;
   getDeployment: (appId: AppId, deploymentId: DeploymentId, signal?: AbortSignal) => Promise<{
     id: string;
-    number: number;
-    configId: string;
     configVersion: string;
     gitCommitSha: string | null;
-    size?: 'micro' | 'tiny' | 'small' | 'medium' | 'large' | 'external' | null;
-    buildState: 'PREBUILT' | 'PENDING' | 'BUILDING' | 'BUILT' | 'FAILED';
-    runState: 'NEVER_RUN' | 'PENDING' | 'STARTING' | 'RUNNING' | 'STOPPING' | 'STOPPED' | 'FAILED';
+    runtimeSize?: 'micro' | 'tiny' | 'small' | 'medium' | 'large' | 'external' | null;
+    buildState: 'pending' | 'building' | 'ready' | 'failed';
+    runState: 'neverRun' | 'pending' | 'starting' | 'running' | 'stopping' | 'stopped' | 'failed';
     archived: boolean;
     archivedAt: string | null;
     createdAt: string;
   }>;
   deleteDeployment: (appId: AppId, deploymentId: DeploymentId, signal?: AbortSignal) => Promise<void>;
-  promoteDeployment: (appId: AppId, deploymentId: DeploymentId, signal?: AbortSignal) => Promise<App | null>;
+  promoteDeployment: (appId: AppId, deploymentId: DeploymentId, signal?: AbortSignal) => Promise<App>;
   getAppLogsTail: (appId: AppId, { query, signal }?: LogsTailOptions) => Promise<{
     entries: LogEntry[];
     nextLogTimestamp: string | null;

package/dist/apps/index.d.ts

@@ -1,16 +1,12 @@
 import { n as ClientInitOptions } from "../types-Ct0YPy2w.js";
-import { S as components, b as GetLogsTailQuery, c as CreateCredentialBody, f as CredentialId, g as DeploymentId, l as CreateDeploymentBody, r as AppId, s as CreateAppBody, t as App, v as GetAppRunsQuery, x as RunId, y as GetAppsQuery } from "../types-CBgLCkYe.js";
+import { C as components, S as RunId, b as GetDeploymentsQuery, c as CreateCredentialBody, f as CredentialId, g as DeploymentId, l as CreateDeploymentBody, r as AppId, s as CreateAppBody, t as App, v as GetAppRunsQuery, x as GetLogsTailQuery, y as GetAppsQuery } from "../types-D6UmMa6E.js";
 import { t as LogEntry } from "../appLogs-Ch7DYpzx.js";
 //#region src/clients/apps/appsClient.d.ts
 /**
- * No `idempotencyKey`. The service accepted an `Idempotency-Key` that turned a replayed create
- * into a no-op, and support for it was **dropped on 17 Aug 2026** — the spec still documents the
- * header and has yet to catch up. It was
- * unusable from a browser in any case — the service's `Access-Control-Allow-Headers` never listed
- * the header, so sending it failed the preflight and the request never left the page.
+ * Options every write takes.
  *
- * Every create here is therefore a genuine create, and a caller that retries one is responsible
- * for the duplicate it may produce.
+ * - No `idempotencyKey`: the service accepts no `Idempotency-Key`, so every create here is a
+ *   genuine create and a caller that retries one owns the duplicate it may produce.
  */
 type WriteOptions = {
   signal?: AbortSignal;
@@ -26,10 +22,9 @@ type LogsTailOptions = {
  * `baseUrl` must already point past the `/v2` prefix (`https://<data-science-host>/v2`); the
  * registry composes it — see `createServiceClients`.
  *
- * Two documented endpoints are deliberately absent: `PATCH /apps/{appId}` has no patchable field
- * yet (`name`/`description` are create-only, so `{}` is the only accepted body), and
- * `POST /apps/{appId}/activity` is apps-proxy's heartbeat, authenticated by a Manage API token with
- * the `apps:proxy` scope that this storage-token client cannot supply.
+ * One documented endpoint is deliberately absent: `POST /apps/{appId}/activity` is apps-proxy's
+ * heartbeat, authenticated by a Manage API token with the `apps:proxy` scope that this
+ * storage-token client cannot supply.
  */
 declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptions) => {
   healthCheck: (signal?: AbortSignal) => Promise<{
@@ -43,18 +38,13 @@ declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptio
     componentId: string;
     branchId: string | null;
     configId: string;
-    configVersion: string;
     type?: 'streamlit' | 'python-js' | null;
-    mode?: 'prod' | 'dev';
     url: string | null;
     production: {
-      desiredNumber?: number | null;
-      desiredId?: string | null;
-      actualNumber?: number | null;
-      actualId?: string | null;
+      desiredDeploymentId?: string | null;
+      actualDeploymentId?: string | null;
     };
-    undeployedChanges?: boolean;
-    state: 'NOT_DEPLOYED' | 'STARTING' | 'RUNNING' | 'SLEEPING' | 'SUSPENDED';
+    state: 'notDeployed' | 'starting' | 'running' | 'suspended' | 'disabled';
   }[]>;
   getApp: (appId: AppId, signal?: AbortSignal) => Promise<{
     id: string;
@@ -62,18 +52,13 @@ declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptio
     componentId: string;
     branchId: string | null;
     configId: string;
-    configVersion: string;
     type?: 'streamlit' | 'python-js' | null;
-    mode?: 'prod' | 'dev';
     url: string | null;
     production: {
-      desiredNumber?: number | null;
-      desiredId?: string | null;
-      actualNumber?: number | null;
-      actualId?: string | null;
+      desiredDeploymentId?: string | null;
+      actualDeploymentId?: string | null;
     };
-    undeployedChanges?: boolean;
-    state: 'NOT_DEPLOYED' | 'STARTING' | 'RUNNING' | 'SLEEPING' | 'SUSPENDED';
+    state: 'notDeployed' | 'starting' | 'running' | 'suspended' | 'disabled';
   }>;
   createApp: (body: CreateAppBody, options?: WriteOptions) => Promise<{
     id: string;
@@ -81,44 +66,23 @@ declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptio
     componentId: string;
     branchId: string | null;
     configId: string;
-    configVersion: string;
     type?: 'streamlit' | 'python-js' | null;
-    mode?: 'prod' | 'dev';
     url: string | null;
     production: {
-      desiredNumber?: number | null;
-      desiredId?: string | null;
-      actualNumber?: number | null;
-      actualId?: string | null;
+      desiredDeploymentId?: string | null;
+      actualDeploymentId?: string | null;
     };
-    undeployedChanges?: boolean;
-    state: 'NOT_DEPLOYED' | 'STARTING' | 'RUNNING' | 'SLEEPING' | 'SUSPENDED';
+    state: 'notDeployed' | 'starting' | 'running' | 'suspended' | 'disabled';
   }>;
   deleteApp: (appId: AppId, signal?: AbortSignal) => Promise<void>;
-  unpublishApp: (appId: AppId, signal?: AbortSignal) => Promise<App | null>;
-  suspendApp: (appId: AppId, signal?: AbortSignal) => Promise<App | null>;
-  resumeApp: (appId: AppId, signal?: AbortSignal) => Promise<App | null>;
+  unpublishApp: (appId: AppId, signal?: AbortSignal) => Promise<App>;
+  suspendApp: (appId: AppId, signal?: AbortSignal) => Promise<App>;
+  resumeApp: (appId: AppId, signal?: AbortSignal) => Promise<App>;
   getAppPassword: (appId: AppId, signal?: AbortSignal) => Promise<{
     password?: string | null;
   }>;
   resetAppPassword: (appId: AppId, signal?: AbortSignal) => Promise<{
-    id: string;
-    projectId: string;
-    componentId: string;
-    branchId: string | null;
-    configId: string;
-    configVersion: string;
-    type?: 'streamlit' | 'python-js' | null;
-    mode?: 'prod' | 'dev';
-    url: string | null;
-    production: {
-      desiredNumber?: number | null;
-      desiredId?: string | null;
-      actualNumber?: number | null;
-      actualId?: string | null;
-    };
-    undeployedChanges?: boolean;
-    state: 'NOT_DEPLOYED' | 'STARTING' | 'RUNNING' | 'SLEEPING' | 'SUSPENDED';
+    password: string;
   }>;
   getAppRuns: (appId: AppId, query?: GetAppRunsQuery, signal?: AbortSignal) => Promise<{
     id: string;
@@ -160,45 +124,39 @@ declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptio
   }>;
   createDeployment: (appId: AppId, body?: CreateDeploymentBody, options?: WriteOptions) => Promise<{
     id: string;
-    number: number;
-    configId: string;
     configVersion: string;
     gitCommitSha: string | null;
-    size?: 'micro' | 'tiny' | 'small' | 'medium' | 'large' | 'external' | null;
-    buildState: 'PREBUILT' | 'PENDING' | 'BUILDING' | 'BUILT' | 'FAILED';
-    runState: 'NEVER_RUN' | 'PENDING' | 'STARTING' | 'RUNNING' | 'STOPPING' | 'STOPPED' | 'FAILED';
+    runtimeSize?: 'micro' | 'tiny' | 'small' | 'medium' | 'large' | 'external' | null;
+    buildState: 'pending' | 'building' | 'ready' | 'failed';
+    runState: 'neverRun' | 'pending' | 'starting' | 'running' | 'stopping' | 'stopped' | 'failed';
     archived: boolean;
     archivedAt: string | null;
     createdAt: string;
   }>;
-  getDeployments: (appId: AppId, signal?: AbortSignal) => Promise<{
+  getDeployments: (appId: AppId, query?: GetDeploymentsQuery, signal?: AbortSignal) => Promise<{
     id: string;
-    number: number;
-    configId: string;
     configVersion: string;
     gitCommitSha: string | null;
-    size?: 'micro' | 'tiny' | 'small' | 'medium' | 'large' | 'external' | null;
-    buildState: 'PREBUILT' | 'PENDING' | 'BUILDING' | 'BUILT' | 'FAILED';
-    runState: 'NEVER_RUN' | 'PENDING' | 'STARTING' | 'RUNNING' | 'STOPPING' | 'STOPPED' | 'FAILED';
+    runtimeSize?: 'micro' | 'tiny' | 'small' | 'medium' | 'large' | 'external' | null;
+    buildState: 'pending' | 'building' | 'ready' | 'failed';
+    runState: 'neverRun' | 'pending' | 'starting' | 'running' | 'stopping' | 'stopped' | 'failed';
     archived: boolean;
     archivedAt: string | null;
     createdAt: string;
   }[]>;
   getDeployment: (appId: AppId, deploymentId: DeploymentId, signal?: AbortSignal) => Promise<{
     id: string;
-    number: number;
-    configId: string;
     configVersion: string;
     gitCommitSha: string | null;
-    size?: 'micro' | 'tiny' | 'small' | 'medium' | 'large' | 'external' | null;
-    buildState: 'PREBUILT' | 'PENDING' | 'BUILDING' | 'BUILT' | 'FAILED';
-    runState: 'NEVER_RUN' | 'PENDING' | 'STARTING' | 'RUNNING' | 'STOPPING' | 'STOPPED' | 'FAILED';
+    runtimeSize?: 'micro' | 'tiny' | 'small' | 'medium' | 'large' | 'external' | null;
+    buildState: 'pending' | 'building' | 'ready' | 'failed';
+    runState: 'neverRun' | 'pending' | 'starting' | 'running' | 'stopping' | 'stopped' | 'failed';
     archived: boolean;
     archivedAt: string | null;
     createdAt: string;
   }>;
   deleteDeployment: (appId: AppId, deploymentId: DeploymentId, signal?: AbortSignal) => Promise<void>;
-  promoteDeployment: (appId: AppId, deploymentId: DeploymentId, signal?: AbortSignal) => Promise<App | null>;
+  promoteDeployment: (appId: AppId, deploymentId: DeploymentId, signal?: AbortSignal) => Promise<App>;
   getAppLogsTail: (appId: AppId, { query, signal }?: LogsTailOptions) => Promise<{
     entries: LogEntry[];
     nextLogTimestamp: string | null;

package/dist/apps/index.js

@@ -1,6 +1,6 @@
-import { t as createOpenapiFetchClient } from "../createOpenapiFetchClient-BVSc9ibR.js";
-import { t as createAuthHeaders } from "../auth-aItmDu45.js";
-import { n as readAppLogsDownload, r as readAppLogsTail } from "../appLogs-xsVkTriU.js";
+import { t as createOpenapiFetchClient } from "../createOpenapiFetchClient-COaPeeQ0.js";
+import { t as createAuthHeaders } from "../auth-BjmkFOgd.js";
+import { n as readAppLogsDownload, r as readAppLogsTail } from "../appLogs-Cl7Q_MR9.js";
 //#region src/clients/apps/appsClient.ts
 /**
 * `/v2` App Deployments — data apps plus the immutable deployment history behind them. Sibling of
@@ -9,10 +9,9 @@ import { n as readAppLogsDownload, r as readAppLogsTail } from "../appLogs-xsVkT
 * `baseUrl` must already point past the `/v2` prefix (`https://<data-science-host>/v2`); the
 * registry composes it — see `createServiceClients`.
 *
-* Two documented endpoints are deliberately absent: `PATCH /apps/{appId}` has no patchable field
-* yet (`name`/`description` are create-only, so `{}` is the only accepted body), and
-* `POST /apps/{appId}/activity` is apps-proxy's heartbeat, authenticated by a Manage API token with
-* the `apps:proxy` scope that this storage-token client cannot supply.
+* One documented endpoint is deliberately absent: `POST /apps/{appId}/activity` is apps-proxy's
+* heartbeat, authenticated by a Manage API token with the `apps:proxy` scope that this
+* storage-token client cannot supply.
 */
 const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 	const client = createOpenapiFetchClient({
@@ -47,8 +46,8 @@ const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 		await client.delete("/apps/{appId}", { path: { appId } }, { signal });
 	};
 	/**
-	* Drops production routing — the app's URL 404s afterwards. `null` when there was nothing to
-	* unpublish (already unpublished, or never deployed via `/v2`): the service answers `204`.
+	* Drops production routing — the app's URL 404s afterwards. A no-op (already unpublished, or
+	* never deployed) returns the app unchanged rather than failing.
 	*/
 	const unpublishApp = async (appId, signal) => {
 		const { data } = await client.post("/apps/{appId}/unpublish", { path: { appId } }, { signal });
@@ -56,15 +55,15 @@ const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 	};
 	/**
 	* Sleeps the app now instead of waiting for the idle timer, and disarms wake-on-request: a
-	* visitor gets a `503` until an explicit {@link resumeApp}. `null` when already suspended (`204`).
+	* visitor gets a `503` until an explicit {@link resumeApp}. A no-op on an already suspended app.
 	*/
 	const suspendApp = async (appId, signal) => {
 		const { data } = await client.post("/apps/{appId}/suspend", { path: { appId } }, { signal });
 		return data;
 	};
 	/**
-	* Wakes the app now and re-arms wake-on-request. `null` when it was already running (`204`).
-	* The returned app reports `STARTING` — the operator has not confirmed it serving yet.
+	* Wakes the app now and re-arms wake-on-request. A no-op on an already running app.
+	* The returned app reports `starting` — the operator has not confirmed it serving yet.
 	*/
 	const resumeApp = async (appId, signal) => {
 		const { data } = await client.post("/apps/{appId}/resume", { path: { appId } }, { signal });
@@ -77,7 +76,7 @@ const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 	};
 	/** Mints a fresh password, replacing any existing one. Read it back with {@link getAppPassword}. */
 	const resetAppPassword = async (appId, signal) => {
-		const { data } = await client.post("/apps/{appId}/reset-password", { path: { appId } }, { signal });
+		const { data } = await client.post("/apps/{appId}/password/reset", { path: { appId } }, { signal });
 		return data;
 	};
 	/**
@@ -100,8 +99,8 @@ const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 	};
 	/**
 	* Deploys the app's current config version as a new immutable deployment, promoting it unless
-	* `body.promote` is `false` (a staged release never runs until promoted). The id and `number` come
-	* back synchronously; readiness does not.
+	* `body.promote` is `false` (a staged release never runs until promoted). Pin an older config
+	* version with `body.configVersion`. The deployment comes back synchronously; readiness does not.
 	*/
 	const createDeployment = async (appId, body, options = {}) => {
 		const { data } = await client.post("/apps/{appId}/deployments", {
@@ -110,9 +109,17 @@ const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 		}, writeOptions(options));
 		return data;
 	};
-	/** Full history, retired (`archived: true`) deployments included — rows outlive their workloads. */
-	const getDeployments = async (appId, signal) => {
-		const { data } = await client.get("/apps/{appId}/deployments", { path: { appId } }, { signal });
+	/**
+	* Deployment history, newest page first.
+	*
+	* - `query.archived` filters on whether the deployment was deleted; omitting it returns both.
+	* - A deleted deployment keeps its row — history outlives the workload.
+	*/
+	const getDeployments = async (appId, query = {}, signal) => {
+		const { data } = await client.get("/apps/{appId}/deployments", {
+			path: { appId },
+			query
+		}, { signal });
 		return data;
 	};
 	const getDeployment = async (appId, deploymentId, signal) => {
@@ -123,8 +130,8 @@ const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 		return data;
 	};
 	/**
-	* Retires the deployment: the workload and its rendered-config secret go, the row stays in
-	* history as `archived`. Rejected with a `409` while the app's `production` still names it.
+	* Deletes the deployment: its running resources and credentials go, the row stays in history as
+	* `archived`. Rejected with a `409` while the app's `production` still names it.
 	*/
 	const deleteDeployment = async (appId, deploymentId, signal) => {
 		await client.delete("/apps/{appId}/deployments/{deploymentId}", { path: {
@@ -134,8 +141,8 @@ const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 	};
 	/**
 	* Makes this deployment production — the same call rolls back, applied to an older one. The route
-	* switches only once the target serves, so the returned app's `production.desiredId` and
-	* `.actualId` differ until it converges. `null` when it was already production (`204`).
+	* switches only once the target serves, so the returned app's `production.desiredDeploymentId`
+	* and `.actualDeploymentId` differ until it converges.
 	*/
 	const promoteDeployment = async (appId, deploymentId, signal) => {
 		const { data } = await client.post("/apps/{appId}/deployments/{deploymentId}/promote", { path: {