@keboola/api-client 56.0.0 → 57.0.0

package/README.md

@@ -14,133 +14,28 @@ npm install @keboola/api-client
 
 ## Quick Start
 
-The SDK exposes two flow-specific factories — pick the one that matches how you authenticate.
-**Both return `{ api, session }`** and work the same in browser and Node:
-
-- `createLegacyKeboola()` — legacy **Storage API token** (SAPI) flow.
-- `createKeboola()` — **bearer / OAuth** flow.
-
-`session` is the lifecycle — you drive it to _ready_. `api` is the product surface, gated by state:
-
-| Tier                                          | Live once…                              | Example                            |
-| --------------------------------------------- | --------------------------------------- | ---------------------------------- |
-| `api.auth.*`                                  | a `baseUrl` is configured               | `api.auth.login.withPassword(...)` |
-| `api.management.*`                            | the management realm authenticates      | `api.management.projects.*`        |
-| `api.storage` / `api.queue` / `api.stack` / … | the async storage build reaches `ready` | `api.storage.getStackInfo()`       |
-
-Touching a product namespace before _ready_ throws a `KeboolaError`. `session.isStorageReady()` and
-`session.subscribe(cb)` observe the transition; the `…Async` verbs below await it for you.
-
-> Options are identical for both factories: `{ baseUrl?, middlewares?, clientServiceUrls? }`. There is
-> **no built-in token persistence** — a browser app that must survive a reload re-authenticates on boot;
-> a Node process keeps the credential wherever it already stores secrets.
-
-### Legacy (SAPI token) — Node
-
-You already hold a Storage API token (env var, secret store). One step to _ready_:
-
-```typescript
-import { createLegacyKeboola } from '@keboola/api-client';
-
-const { api, session } = createLegacyKeboola({ baseUrl: process.env.KEBOOLA_STACK_URL! });
-await session.authenticateStorageAsync(process.env.KEBOOLA_STORAGE_TOKEN!);
-
-const stack = api.stack; // synchronous once ready
-const token = await api.storage.tokens.verify();
-```
-
-Optionally add the management realm with `session.authenticateManagement(manageToken)` → `api.management.*`.
-
-### Legacy (SAPI token) — Browser
-
-Identical calls; the token is whatever the host hands the app (e.g. kbc-ui's boot payload). Use the
-fire-and-forget `authenticateStorage` and observe readiness instead of awaiting:
-
-```typescript
-import { createLegacyKeboola } from '@keboola/api-client';
-
-const { api, session } = createLegacyKeboola({ baseUrl });
-session.authenticateStorage(sapiToken);
-session.subscribe((snapshot) => {
-  if (snapshot.storage === 'ready') {
-    /* render the app — api.storage.* is now live */
-  }
-});
-```
-
-> **React:** don't wire this by hand — `LegacyAuthProvider` + `useProjectApi()` from
-> [`@keboola/api-client-react`](../api-client-react) drive the singleton session to ready and hand you `api`.
-
-### Bearer (OAuth) — Browser
-
-Interactive login, then a project:
-
 ```typescript
 import { createKeboola } from '@keboola/api-client';
 
-const { session, getStackApi, getProjectApi } = createKeboola({ defaultBaseUrl: baseUrl });
-
-// `auth` is live from construction: a stack is always active
-const result = await getStackApi().auth.login.withPassword({ email, password });
-if (result.mfaRequired) {
-  // result is an MFA challenge — verify via getStackApi().auth.mfa.* to obtain the LoginSuccess
-}
-
-session.auth.authenticate({ type: 'token', ...result }); // → `management` is now live
-const api = getProjectApi(projectId); // projectId from your project picker
+const { session, stackApi, projectApi } = createKeboola({ defaultBaseUrl: baseUrl });
+const result = await stackApi.auth.login.withPassword({ email, password });
+if (!result.mfaRequired) session.auth.authenticate({ type: 'token', ...result });
 
-const buckets = await api.storage.buckets.getBuckets({ branchId: 'default' });
-const other = getProjectApi(otherProjectId); // another project, the same sign-in
+const buckets = await projectApi(projectId).storage.buckets.getBuckets({ branchId: 'default' });
 ```
 
-> **React:** `StackApiProvider` + `useStackApi()` serve the sign-in; `ProjectApiProvider` +
-> `useProjectApi()` the project the app is in.
-
-### Bearer (OAuth) — Node
-
-Same shape. Either run `api.auth.login.withPassword(...)` headlessly, or, if you already hold a
-credential, hand a `LoginSuccess`-shaped object straight to `session.authenticate`:
-
-```typescript
-import { createKeboola } from '@keboola/api-client';
-
-const { api, session } = createKeboola({ defaultBaseUrl: process.env.KEBOOLA_STACK_URL! });
-
-session.authenticate({
-  mfaRequired: false,
-  accessToken: process.env.KBC_ACCESS_TOKEN!,
-  refreshToken: process.env.KBC_REFRESH_TOKEN!,
-  tokenType: 'Bearer',
-  expiresIn: 3600,
-  sessionId: '',
-  user: { id: 0, email: '', name: '' },
-});
-await session.setProjectAsync(Number(process.env.KBC_PROJECT_ID));
-
-const stackInfo = await api.storage.getStackInfo();
-```
-
-> The SDK refreshes the access token in-band; persisting the rotated refresh token across process
-> restarts is the caller's responsibility (there is no storage adapter).
-
-### Single-service client (when you only need one service)
-
-For a single service — including a **browser SPA that only talks to Storage** — use the per-service
-factory. It needs only `baseUrl` + `auth` and skips the stack-info round-trip. Reach for a full client
-above only when you need multiple stack services.
+Holding only a Storage API token, use the per-service clients:
 
 ```typescript
 import { createStorageClient } from '@keboola/api-client/storage';
 
-const storage = createStorageClient({
-  baseUrl: 'https://connection.keboola.com',
-  auth: { type: 'sapi-token', token: 'your-storage-token' },
-});
-
-const stackInfo = await storage.getStackInfo();
-const token = await storage.tokens.verify();
+const storage = createStorageClient({ baseUrl, auth: { type: 'sapi-token', token } });
+const tables = await storage.tables.getTables();
 ```
 
+Sessions, expiry, persistence, and a token's other services:
+[`AGENTS.md` → Getting a client](./AGENTS.md#getting-a-client).
+
 ### Type imports
 
 ```typescript
@@ -156,10 +51,9 @@ import type { VariableWithHash } from '@keboola/api-client/vault/types';
 src/
   index.ts                      # package entry — re-exports keboola/ factories, errors, utils
   keboola/
-    bearer/keboola.ts           # createKeboola() — bearer/OAuth flow → { session, getStackApi, getProjectApi }
-    bearer/context.ts           # per-stack index, fetched once (pending→ready|errored)
-    legacy/keboola.ts           # createLegacyKeboola() — SAPI-token flow → { api, session }
-    createApi.ts                # flow-agnostic, state-gating `api` proxy
+    keboola.ts                  # createKeboola() — bearer/OAuth flow → { session, stackApi, projectApi }
+    context.ts                  # per-stack index, fetched once (pending→ready|errored)
+    types.ts                    # options, and the `StackApi` / `ProjectApi` types
   internal.ts                   # HTTP headers, prefixes
   fetchClient/
     createFetchClient/          # Core fetch wrapper, middleware composition
@@ -210,7 +104,7 @@ src/
 
 ## Service Clients
 
-On the `api` object returned by `createKeboola()` / `createLegacyKeboola()` — once the session reaches `ready` — the following clients are available.
+On a `ProjectApi` from `createKeboola(...).projectApi(projectId)`, the following clients are available.
 Clients backed by OpenAPI specs are marked with (OpenAPI); the rest use the generic fetch client.
 
 | Accessor            | Service                  | Key methods                                                                                                                                                                                                         |
@@ -234,24 +128,17 @@ Clients backed by OpenAPI specs are marked with (OpenAPI); the rest use the gene
 
 Additional accessors on the ready client:
 
-| Accessor          | Purpose                                                                                                                                            |
-| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `api.stack`       | Stack info: `hasFeature()`, `hasService()`, `getServiceUrl()`, `hasComponent()`, `getComponent()`, `services`, `features`, `components`            |
-| `api.baseUrl`     | Canonical stack URL every request is built on                                                                                                      |
-| `api.serviceMeta` | Service availability metadata from the registry                                                                                                    |
-| `api.sdk.tag`     | Tag SDK: `getTags()`, `getTagsByObjectId()`, `createTag()`, `updateTag()`, `deleteTag()`, `assignTags()`, `unassignTags()`, `createAndAssignTag()` |
+| Accessor      | Purpose                                                                                                                                            |
+| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `api.stack`   | Stack info: `hasFeature()`, `hasService()`, `getServiceUrl()`, `hasComponent()`, `getComponent()`, `services`, `features`, `components`            |
+| `api.baseUrl` | Canonical stack URL every request is built on                                                                                                      |
+| `api.sdk.tag` | Tag SDK: `getTags()`, `getTagsByObjectId()`, `createTag()`, `updateTag()`, `deleteTag()`, `assignTags()`, `unassignTags()`, `createAndAssignTag()` |
 
 ## Entry Points
 
 ```typescript
 // Main entry — SDK factories + all exports
-import {
-  createKeboola,
-  createLegacyKeboola,
-  isApiError,
-  concurrent,
-  poll,
-} from '@keboola/api-client';
+import { createKeboola, isApiError, concurrent, poll } from '@keboola/api-client';
 
 // Per-client imports — individual client factories
 import { createStorageClient } from '@keboola/api-client/storage';

package/dist/{ManagementSessionMintError-Bc9bc7Ai.cjs → ManagementSessionMintError-BCOLLaJi.cjs}

@@ -15,7 +15,8 @@ var ManagementClientAuthError = class extends require_createFetchClient.ApiError
 * The Manage client has no credential of its own and could not mint a session token from the
 * login cookie.
 *
-* - Only the legacy (SAPI) entry point mints; a bearer client never raises it.
+* - Only a `management-token` client with `mintSessionToken` (control-ui) mints; a bearer client
+*   never raises it.
 * - The login page in place of the token: the session expired, or there is no cookie (off the
 *   stack host).
 */
@@ -42,4 +43,4 @@ Object.defineProperty(exports, "ManagementSessionMintError", {
 	}
 });
 
-//# sourceMappingURL=ManagementSessionMintError-Bc9bc7Ai.cjs.map
+//# sourceMappingURL=ManagementSessionMintError-BCOLLaJi.cjs.map

package/dist/ManagementSessionMintError-BCOLLaJi.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManagementSessionMintError-BCOLLaJi.cjs","names":["ApiError"],"sources":["../src/errors/ManagementClientAuthError.ts","../src/errors/ManagementSessionMintError.ts"],"sourcesContent":["import type { ApiResponse } from '../fetchClient/createFetchClient/types';\n\nimport { ApiError } from './ApiError';\n\nexport class ManagementClientAuthError extends ApiError {\n  title: string;\n  message: string;\n  constructor(title: string, message: string, res: ApiResponse) {\n    super(res);\n    this.name = 'ManagementClientAuthError';\n    this.title = title;\n    this.message = message;\n  }\n}\n","import { ManagementClientAuthError } from './ManagementClientAuthError';\n\n/**\n * The Manage client has no credential of its own and could not mint a session token from the\n * login cookie.\n *\n * - Only a `management-token` client with `mintSessionToken` (control-ui) mints; a bearer client\n *   never raises it.\n * - The login page in place of the token: the session expired, or there is no cookie (off the\n *   stack host).\n */\nexport class ManagementSessionMintError extends ManagementClientAuthError {\n  constructor({ title, message, response, request, data }: ManagementClientAuthError) {\n    super(title, message, { response, request, data });\n    this.name = 'ManagementSessionMintError';\n  }\n}\n"],"mappings":";;AAIA,IAAa,4BAAb,cAA+CA,0BAAAA,SAAS;CACtD;CACA;CACA,YAAY,OAAe,SAAiB,KAAkB;EAC5D,MAAM,GAAG;EACT,KAAK,OAAO;EACZ,KAAK,QAAQ;EACb,KAAK,UAAU;CACjB;AACF;;;;;;;;;;;ACFA,IAAa,6BAAb,cAAgD,0BAA0B;CACxE,YAAY,EAAE,OAAO,SAAS,UAAU,SAAS,QAAmC;EAClF,MAAM,OAAO,SAAS;GAAE;GAAU;GAAS;EAAK,CAAC;EACjD,KAAK,OAAO;CACd;AACF"}

package/dist/{ManagementSessionMintError-BMHDcEqV.js → ManagementSessionMintError-KUX3utTV.js}

@@ -15,7 +15,8 @@ var ManagementClientAuthError = class extends ApiError {
 * The Manage client has no credential of its own and could not mint a session token from the
 * login cookie.
 *
-* - Only the legacy (SAPI) entry point mints; a bearer client never raises it.
+* - Only a `management-token` client with `mintSessionToken` (control-ui) mints; a bearer client
+*   never raises it.
 * - The login page in place of the token: the session expired, or there is no cookie (off the
 *   stack host).
 */
@@ -31,4 +32,4 @@ var ManagementSessionMintError = class extends ManagementClientAuthError {
 };
 export { ManagementClientAuthError as n, ManagementSessionMintError as t };
 
-//# sourceMappingURL=ManagementSessionMintError-BMHDcEqV.js.map
+//# sourceMappingURL=ManagementSessionMintError-KUX3utTV.js.map

package/dist/ManagementSessionMintError-KUX3utTV.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManagementSessionMintError-KUX3utTV.js","names":[],"sources":["../src/errors/ManagementClientAuthError.ts","../src/errors/ManagementSessionMintError.ts"],"sourcesContent":["import type { ApiResponse } from '../fetchClient/createFetchClient/types';\n\nimport { ApiError } from './ApiError';\n\nexport class ManagementClientAuthError extends ApiError {\n  title: string;\n  message: string;\n  constructor(title: string, message: string, res: ApiResponse) {\n    super(res);\n    this.name = 'ManagementClientAuthError';\n    this.title = title;\n    this.message = message;\n  }\n}\n","import { ManagementClientAuthError } from './ManagementClientAuthError';\n\n/**\n * The Manage client has no credential of its own and could not mint a session token from the\n * login cookie.\n *\n * - Only a `management-token` client with `mintSessionToken` (control-ui) mints; a bearer client\n *   never raises it.\n * - The login page in place of the token: the session expired, or there is no cookie (off the\n *   stack host).\n */\nexport class ManagementSessionMintError extends ManagementClientAuthError {\n  constructor({ title, message, response, request, data }: ManagementClientAuthError) {\n    super(title, message, { response, request, data });\n    this.name = 'ManagementSessionMintError';\n  }\n}\n"],"mappings":";;AAIA,IAAa,4BAAb,cAA+C,SAAS;CACtD;CACA;CACA,YAAY,OAAe,SAAiB,KAAkB;EAC5D,MAAM,GAAG;EACT,KAAK,OAAO;EACZ,KAAK,QAAQ;EACb,KAAK,UAAU;CACjB;AACF;;;;;;;;;;;ACFA,IAAa,6BAAb,cAAgD,0BAA0B;CACxE,YAAY,EAAE,OAAO,SAAS,UAAU,SAAS,QAAmC;EAClF,MAAM,OAAO,SAAS;GAAE;GAAU;GAAS;EAAK,CAAC;EACjD,KAAK,OAAO;CACd;AACF"}

package/dist/{adminRoles-CUB0JddB.d.ts → adminRoles-CnfGDvjN.d.ts}

@@ -1,4 +1,4 @@
-import { Rr as paths, l as OpenapiReturnType } from "./index-DcKc3_Y1.js";
+import { Rr as paths, l as OpenapiReturnType } from "./index-9p4O-clX.js";
 type SpecAdminRole = NonNullable<NonNullable<OpenapiReturnType<paths['/v2/storage/tokens/verify']['get']>['admin']>['role']>;
 declare const AdminRole: {
   readonly Admin: 'admin';
@@ -11,4 +11,4 @@ declare const AdminRole: {
 };
 type AdminRole = SpecAdminRole;
 export { AdminRole as t };
-//# sourceMappingURL=adminRoles-CUB0JddB.d.ts.map
+//# sourceMappingURL=adminRoles-CnfGDvjN.d.ts.map

package/dist/{adminRoles-BFOPSedO.d.cts → adminRoles-D6AS9Bzx.d.cts}

@@ -1,4 +1,4 @@
-import { Rr as paths, l as OpenapiReturnType } from "./index-DcKc3_Y1.cjs";
+import { Rr as paths, l as OpenapiReturnType } from "./index-9p4O-clX.cjs";
 type SpecAdminRole = NonNullable<NonNullable<OpenapiReturnType<paths['/v2/storage/tokens/verify']['get']>['admin']>['role']>;
 declare const AdminRole: {
   readonly Admin: 'admin';
@@ -11,4 +11,4 @@ declare const AdminRole: {
 };
 type AdminRole = SpecAdminRole;
 export { AdminRole as t };
-//# sourceMappingURL=adminRoles-BFOPSedO.d.cts.map
+//# sourceMappingURL=adminRoles-D6AS9Bzx.d.cts.map

package/dist/ai/index.d.cts

@@ -1,5 +1,5 @@
-import { a as DescribeConfigurationVersionBody, d as SuggestComponentBody, f as components, i as DescribeConfigurationMergeBody, l as ExplainErrorBody, r as DescribeConfigurationBody, s as DocsQuestionBody } from "../types-D0BOES7q.cjs";
-import { n as ClientInitOptions } from "../types-BqJycQNM.cjs";
+import { a as DescribeConfigurationVersionBody, d as SuggestComponentBody, f as components, i as DescribeConfigurationMergeBody, l as ExplainErrorBody, r as DescribeConfigurationBody, s as DocsQuestionBody } from "../types-CH1uguug.cjs";
+import { n as ClientInitOptions } from "../types-CbM2MApW.cjs";
 declare const createAiClient: ({ baseUrl, middlewares, auth }: ClientInitOptions) => {
   healthCheck: (signal?: AbortSignal) => Promise<{
     status: 'ok';

package/dist/ai/index.d.ts

@@ -1,5 +1,5 @@
-import { a as DescribeConfigurationVersionBody, d as SuggestComponentBody, f as components, i as DescribeConfigurationMergeBody, l as ExplainErrorBody, r as DescribeConfigurationBody, s as DocsQuestionBody } from "../types-B_yv00AL.js";
-import { n as ClientInitOptions } from "../types-DMEl2iet.js";
+import { a as DescribeConfigurationVersionBody, d as SuggestComponentBody, f as components, i as DescribeConfigurationMergeBody, l as ExplainErrorBody, r as DescribeConfigurationBody, s as DocsQuestionBody } from "../types-Vw-tduOH.js";
+import { n as ClientInitOptions } from "../types-CP8-CssY.js";
 declare const createAiClient: ({ baseUrl, middlewares, auth }: ClientInitOptions) => {
   healthCheck: (signal?: AbortSignal) => Promise<{
     status: 'ok';

package/dist/ai/types.d.cts

@@ -1,2 +1,2 @@
-import { a as DescribeConfigurationVersionBody, c as ErrorExplanation, d as SuggestComponentBody, i as DescribeConfigurationMergeBody, l as ExplainErrorBody, n as ComponentSuggestion, o as DocsAnswer, r as DescribeConfigurationBody, s as DocsQuestionBody, t as ComponentDocsDetail, u as ObjectDescription } from "../types-D0BOES7q.cjs";
+import { a as DescribeConfigurationVersionBody, c as ErrorExplanation, d as SuggestComponentBody, i as DescribeConfigurationMergeBody, l as ExplainErrorBody, n as ComponentSuggestion, o as DocsAnswer, r as DescribeConfigurationBody, s as DocsQuestionBody, t as ComponentDocsDetail, u as ObjectDescription } from "../types-CH1uguug.cjs";
 export { ComponentDocsDetail, ComponentSuggestion, DescribeConfigurationBody, DescribeConfigurationMergeBody, DescribeConfigurationVersionBody, DocsAnswer, DocsQuestionBody, ErrorExplanation, ExplainErrorBody, ObjectDescription, SuggestComponentBody };

package/dist/ai/types.d.ts

@@ -1,2 +1,2 @@
-import { a as DescribeConfigurationVersionBody, c as ErrorExplanation, d as SuggestComponentBody, i as DescribeConfigurationMergeBody, l as ExplainErrorBody, n as ComponentSuggestion, o as DocsAnswer, r as DescribeConfigurationBody, s as DocsQuestionBody, t as ComponentDocsDetail, u as ObjectDescription } from "../types-B_yv00AL.js";
+import { a as DescribeConfigurationVersionBody, c as ErrorExplanation, d as SuggestComponentBody, i as DescribeConfigurationMergeBody, l as ExplainErrorBody, n as ComponentSuggestion, o as DocsAnswer, r as DescribeConfigurationBody, s as DocsQuestionBody, t as ComponentDocsDetail, u as ObjectDescription } from "../types-Vw-tduOH.js";
 export { ComponentDocsDetail, ComponentSuggestion, DescribeConfigurationBody, DescribeConfigurationMergeBody, DescribeConfigurationVersionBody, DocsAnswer, DocsQuestionBody, ErrorExplanation, ExplainErrorBody, ObjectDescription, SuggestComponentBody };

package/dist/apps/index.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_apps = require("../apps-C1x5IKNQ.cjs");
+const require_apps = require("../apps-BA9JRLAZ.cjs");
 exports.createAppsClient = require_apps.createAppsClient;
 exports.parseLogLines = require_apps.parseLogLines;

package/dist/apps/index.d.cts

@@ -1,3 +1,3 @@
-import { T as parseLogLines } from "../types-3ZE32k8V.cjs";
-import { t as createAppsClient } from "../index-DAb1g6je.cjs";
+import { j as parseLogLines } from "../types-K-JISUUI.cjs";
+import { t as createAppsClient } from "../index-CGUPsu_R.cjs";
 export { createAppsClient, parseLogLines };

package/dist/apps/index.d.ts

@@ -1,3 +1,3 @@
-import { T as parseLogLines } from "../types-BhGr9OQ4.js";
-import { t as createAppsClient } from "../index-C_A0JS9s.js";
+import { j as parseLogLines } from "../types-Dteot3tT.js";
+import { t as createAppsClient } from "../index-Btft3BFn.js";
 export { createAppsClient, parseLogLines };

package/dist/apps/index.js

@@ -1 +1 @@
-export { t as createAppsClient, n as parseLogLines } from "../apps-BN7fWtSm.js";
+export { t as createAppsClient, n as parseLogLines } from "../apps-DDcguJ1i.js";

package/dist/apps/types.d.cts

@@ -1,2 +1,2 @@
-import { C as RunId, S as GetLogsTailQuery, _ as DeploymentRunState, a as AppRun, b as GetAppsQuery, c as CreateCredentialBody, d as Credential, f as CredentialId, g as DeploymentId, h as DeploymentBuildState, i as AppPassword, l as CreateDeploymentBody, m as Deployment, n as AppGitRepo, o as AppState, p as CredentialList, r as AppId, s as CreateAppBody, t as App, u as CreatedCredential, v as GetAppGitEntrypointsQuery, w as LogEntry, x as GetDeploymentsQuery, y as GetAppRunsQuery } from "../types-3ZE32k8V.cjs";
-export { App, AppGitRepo, AppId, AppPassword, AppRun, AppState, CreateAppBody, CreateCredentialBody, CreateDeploymentBody, CreatedCredential, Credential, CredentialId, CredentialList, Deployment, DeploymentBuildState, DeploymentId, DeploymentRunState, GetAppGitEntrypointsQuery, GetAppRunsQuery, GetAppsQuery, GetDeploymentsQuery, GetLogsTailQuery, type LogEntry, RunId };
+import { A as LogEntry, C as GetAppGitEntrypointsQuery, D as GetDraftsQuery, E as GetDeploymentsQuery, O as GetLogsTailQuery, S as DraftRunState, T as GetAppsQuery, _ as DeploymentId, a as AppRun, b as DraftId, c as CreateCredentialBody, d as CreatedCredential, f as Credential, g as DeploymentBuildState, h as Deployment, i as AppPassword, k as RunId, l as CreateDeploymentBody, m as CredentialList, n as AppGitRepo, o as AppState, p as CredentialId, r as AppId, s as CreateAppBody, t as App, u as CreateDraftBody, v as DeploymentRunState, w as GetAppRunsQuery, x as DraftPreviewLink, y as Draft } from "../types-K-JISUUI.cjs";
+export { App, AppGitRepo, AppId, AppPassword, AppRun, AppState, CreateAppBody, CreateCredentialBody, CreateDeploymentBody, CreateDraftBody, CreatedCredential, Credential, CredentialId, CredentialList, Deployment, DeploymentBuildState, DeploymentId, DeploymentRunState, Draft, DraftId, DraftPreviewLink, DraftRunState, GetAppGitEntrypointsQuery, GetAppRunsQuery, GetAppsQuery, GetDeploymentsQuery, GetDraftsQuery, GetLogsTailQuery, type LogEntry, RunId };

package/dist/apps/types.d.ts

@@ -1,2 +1,2 @@
-import { C as RunId, S as GetLogsTailQuery, _ as DeploymentRunState, a as AppRun, b as GetAppsQuery, c as CreateCredentialBody, d as Credential, f as CredentialId, g as DeploymentId, h as DeploymentBuildState, i as AppPassword, l as CreateDeploymentBody, m as Deployment, n as AppGitRepo, o as AppState, p as CredentialList, r as AppId, s as CreateAppBody, t as App, u as CreatedCredential, v as GetAppGitEntrypointsQuery, w as LogEntry, x as GetDeploymentsQuery, y as GetAppRunsQuery } from "../types-BhGr9OQ4.js";
-export { App, AppGitRepo, AppId, AppPassword, AppRun, AppState, CreateAppBody, CreateCredentialBody, CreateDeploymentBody, CreatedCredential, Credential, CredentialId, CredentialList, Deployment, DeploymentBuildState, DeploymentId, DeploymentRunState, GetAppGitEntrypointsQuery, GetAppRunsQuery, GetAppsQuery, GetDeploymentsQuery, GetLogsTailQuery, type LogEntry, RunId };
+import { A as LogEntry, C as GetAppGitEntrypointsQuery, D as GetDraftsQuery, E as GetDeploymentsQuery, O as GetLogsTailQuery, S as DraftRunState, T as GetAppsQuery, _ as DeploymentId, a as AppRun, b as DraftId, c as CreateCredentialBody, d as CreatedCredential, f as Credential, g as DeploymentBuildState, h as Deployment, i as AppPassword, k as RunId, l as CreateDeploymentBody, m as CredentialList, n as AppGitRepo, o as AppState, p as CredentialId, r as AppId, s as CreateAppBody, t as App, u as CreateDraftBody, v as DeploymentRunState, w as GetAppRunsQuery, x as DraftPreviewLink, y as Draft } from "../types-Dteot3tT.js";
+export { App, AppGitRepo, AppId, AppPassword, AppRun, AppState, CreateAppBody, CreateCredentialBody, CreateDeploymentBody, CreateDraftBody, CreatedCredential, Credential, CredentialId, CredentialList, Deployment, DeploymentBuildState, DeploymentId, DeploymentRunState, Draft, DraftId, DraftPreviewLink, DraftRunState, GetAppGitEntrypointsQuery, GetAppRunsQuery, GetAppsQuery, GetDeploymentsQuery, GetDraftsQuery, GetLogsTailQuery, type LogEntry, RunId };

package/dist/{apps-C1x5IKNQ.cjs → apps-BA9JRLAZ.cjs}

@@ -259,6 +259,55 @@ const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 		} }, { signal });
 		return data;
 	};
+	/**
+	* Starts a draft that live-syncs an existing branch of the app's Git repository on its own host.
+	*
+	* - `400` when `body.gitBranch` does not exist; a draft never creates a branch.
+	* - `409` until the app has been deployed once.
+	* - Not idempotent: a retried request starts a second draft.
+	*/
+	const createDraft = async (appId, body, options = {}) => {
+		const { data } = await client.post("/apps/{appId}/drafts", {
+			path: { appId },
+			body
+		}, writeOptions(options));
+		return data;
+	};
+	/** Live drafts, newest first. */
+	const getDrafts = async (appId, query = {}, signal) => {
+		const { data } = await client.get("/apps/{appId}/drafts", {
+			path: { appId },
+			query
+		}, { signal });
+		return data;
+	};
+	const getDraft = async (appId, draftId, signal) => {
+		const { data } = await client.get("/apps/{appId}/drafts/{draftId}", { path: {
+			appId,
+			draftId
+		} }, { signal });
+		return data;
+	};
+	/** Stops and removes the draft; its Git branch is untouched. */
+	const deleteDraft = async (appId, draftId, signal) => {
+		await client.delete("/apps/{appId}/drafts/{draftId}", { path: {
+			appId,
+			draftId
+		} }, { signal });
+	};
+	/**
+	* A 60-second link that opens the draft's own `url` without the app's authentication.
+	*
+	* - `400` while the draft has no `url` yet; retry once it reports one.
+	* - `503` on a stack without preview links.
+	*/
+	const createDraftPreviewLink = async (appId, draftId, signal) => {
+		const { data } = await client.post("/apps/{appId}/drafts/{draftId}/preview-link", { path: {
+			appId,
+			draftId
+		} }, { signal });
+		return data;
+	};
 	/** Serving container's log. `query.since` and `query.lines` are mutually exclusive. */
 	const getAppLogsTail = (appId, { query, signal } = {}) => readAppLogsTail(() => client.get("/apps/{appId}/logs/tail", {
 		path: { appId },
@@ -347,6 +396,11 @@ const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 		getDeployment,
 		deleteDeployment,
 		promoteDeployment,
+		createDraft,
+		getDrafts,
+		getDraft,
+		deleteDraft,
+		createDraftPreviewLink,
 		getAppLogsTail,
 		getAppLogsDownload,
 		getDeploymentLogsTail,
@@ -373,4 +427,4 @@ Object.defineProperty(exports, "parseLogLines", {
 	}
 });
 
-//# sourceMappingURL=apps-C1x5IKNQ.cjs.map
+//# sourceMappingURL=apps-BA9JRLAZ.cjs.map

package/dist/apps-BA9JRLAZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps-BA9JRLAZ.cjs","names":["utc","z","record","isPlainObject","isApiError","HttpStatus","parseContentDispositionHeader","HttpHeader","createOpenapiFetchClient","createAuthHeaders"],"sources":["../src/domain/appLogs.ts","../src/clients/apps/appsClient.ts"],"sourcesContent":["import dayjs from 'dayjs';\nimport utc from 'dayjs/plugin/utc.js';\nimport * as z from 'zod';\n\nimport {\n  type ApiResponse,\n  HttpHeader,\n  isApiError,\n  parseContentDispositionHeader,\n} from '../fetchClient';\nimport { HttpStatus } from '../internal';\nimport { isPlainObject } from '../utils/isPlainObject';\n\n/**\n * Reading a data app's container output, as the `apps` client serves it.\n *\n * - The tail contract lives here: how a line is parsed, where the next poll resumes, and that an\n *   idle app is not an error.\n */\n\ndayjs.extend(utc);\n\nexport type LogEntry = {\n  timestamp: string | null;\n  message: string;\n};\n\nconst DEFAULT_LOGS_FILE_NAME = 'logs.txt';\n\nconst ISO_TIMESTAMP_REGEX = /\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z/;\nconst LEADING_ISO_TIMESTAMP_REGEX = /^(\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z)\\s?/;\n\n/** The error envelope sandboxes-service returns; the tail branches on its `code`. */\nconst TailError = z.object({\n  context: z.object({\n    code: z.string(),\n  }),\n});\n\n/**\n * There is nothing to read right now, reported per scope: an app whose serving member is asleep\n * answers `apps.appNotRunning`, a deployment that isn't running answers `apps.deploymentNotRunning` —\n * the normal state of a staged or retired one, since a deployment only runs while it is production.\n */\nconst NOTHING_RUNNING_CODES = new Set(['apps.appNotRunning', 'apps.deploymentNotRunning']);\n\nconst tryParseJsonl = (line: string): LogEntry | null => {\n  if (!line.startsWith('{')) return null;\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(line);\n  } catch {\n    return null;\n  }\n\n  if (typeof parsed !== 'object' || parsed === null) return null;\n\n  const record = parsed as Record<string, unknown>;\n  const { timestamp, message } = record;\n\n  if (typeof timestamp !== 'string' || typeof message !== 'string') return null;\n\n  return {\n    timestamp,\n    message,\n  };\n};\n\nconst parsePlainTextLine = (line: string): LogEntry => {\n  const match = line.match(LEADING_ISO_TIMESTAMP_REGEX);\n  if (match) {\n    return { timestamp: match[1]!, message: line.slice(match[0].length) };\n  }\n  return { timestamp: null, message: line };\n};\n\nexport const parseLogLine = (line: string): LogEntry =>\n  tryParseJsonl(line) ?? parsePlainTextLine(line);\n\nconst toLogEntryFromObject = (raw: Record<string, unknown>): LogEntry | null => {\n  if (typeof raw.message !== 'string') return null;\n  return {\n    timestamp: typeof raw.timestamp === 'string' ? raw.timestamp : null,\n    message: raw.message,\n  };\n};\n\nexport const parseLogLines = (raw: unknown): LogEntry[] => {\n  if (raw === null || raw === undefined || raw === '') return [];\n\n  if (Array.isArray(raw)) {\n    return raw.flatMap((item) => {\n      if (typeof item === 'string') return item === '' ? [] : [parseLogLine(item)];\n      if (isPlainObject(item)) {\n        const entry = toLogEntryFromObject(item);\n        return entry ? [entry] : [];\n      }\n      return [];\n    });\n  }\n\n  if (isPlainObject(raw)) {\n    const entry = toLogEntryFromObject(raw);\n    return entry ? [entry] : [];\n  }\n\n  if (typeof raw !== 'string') return [];\n\n  const lines = raw.split('\\n');\n  const entries: LogEntry[] = [];\n  for (const line of lines) {\n    if (line === '') continue;\n    entries.push(parseLogLine(line));\n  }\n  return entries;\n};\n\nexport const lastLogTimestamp = (entries: LogEntry[]) => {\n  for (let i = entries.length - 1; i >= 0; i--) {\n    const entry = entries[i];\n    if (!entry) continue;\n    if (entry.timestamp) return entry.timestamp;\n\n    // A plain-text line may carry a timestamp embedded mid-line (legacy format).\n    const match = entry.message.match(ISO_TIMESTAMP_REGEX);\n    if (match) return match[0];\n  }\n  return null;\n};\n\nconst calculateNextLogTimestamp = (timestamp: string | null) => {\n  if (timestamp === null) return null;\n  return dayjs(timestamp).utc().add(1, 'second').utc().format();\n};\n\n/**\n * The tail plus the timestamp a follow-up poll resumes from. A {@link NOTHING_RUNNING_CODES} `400`\n * reads as an empty tail rather than an error — an idle app between visits, or a deployment that is\n * not the one currently serving, has no logs to stream and that is its normal condition.\n */\nexport const readAppLogsTail = async (fetchTail: () => Promise<ApiResponse<string>>) => {\n  try {\n    const { data } = await fetchTail();\n    const entries = parseLogLines(data);\n\n    return {\n      entries,\n      nextLogTimestamp: calculateNextLogTimestamp(lastLogTimestamp(entries)),\n    };\n  } catch (error) {\n    if (isApiError(error) && error.response.status === HttpStatus.BAD_REQUEST) {\n      const code = TailError.safeParse(error.data).data?.context?.code;\n      if (code !== undefined && NOTHING_RUNNING_CODES.has(code)) {\n        return { entries: [], nextLogTimestamp: null };\n      }\n    }\n    throw error;\n  }\n};\n\n/** The whole log as a file download, named by the service's `Content-Disposition` where it sets one. */\nexport const readAppLogsDownload = async (fetchLogs: () => Promise<ApiResponse<string>>) => {\n  const { data, response } = await fetchLogs();\n  const contentDisposition = parseContentDispositionHeader(\n    response.headers.get(HttpHeader.CONTENT_DISPOSITION),\n  );\n\n  return {\n    logs: data,\n    fileName: contentDisposition.filename ?? DEFAULT_LOGS_FILE_NAME,\n  };\n};\n","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  CreateDraftBody,\n  CredentialId,\n  DeploymentId,\n  DraftId,\n  GetAppGitEntrypointsQuery,\n  GetAppRunsQuery,\n  GetAppsQuery,\n  GetDeploymentsQuery,\n  GetDraftsQuery,\n  GetLogsTailQuery,\n  RunId,\n} from './types';\n\n/**\n * Options every write takes.\n *\n * - No `idempotencyKey`: the service ignores it, so a retried create may duplicate.\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 and their immutable deployment history.\n *\n * - `/v1` of the same service is the `dataScience` client.\n * - `baseUrl` must already end in `/v2`; `createServiceClients` composes it.\n * - `POST /apps/{appId}/activity` is absent: it needs a Manage token with `apps:proxy` scope.\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 — 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.\n   *\n   * - `parameters` and `authorization.app_proxy` are written afterwards via the Storage API.\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  /** Drops production routing (URL 404s). A no-op returns the app unchanged, not an error. */\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  /** Sleeps the app now; the next visitor wakes it, as after an idle auto-suspend. */\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  /** Wakes the app now and clears a failure stop (`disabled`). A stopped app comes back `starting`. */\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  /** `null` until the first deployment or {@link resetAppPassword} mints one. */\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  /** Replaces any existing password. 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  /** App-wide runs, newest first — where a failed deployment's `failureReason` lives. */\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 current config version as a new immutable deployment.\n   *\n   * - Promotes it unless `body.promote` is `false`; a staged release never runs until promoted.\n   * - Returns 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  /** Live deployment history, newest first; `query.archived: true` lists the deleted ones instead. */\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  /** Deletes the deployment, keeping its row as `archived`. `409` while it is production. */\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; also the rollback.\n   *\n   * - Routing switches once it serves; `desired`/`actualDeploymentId` differ until then.\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   * Starts a draft that live-syncs an existing branch of the app's Git repository on its own host.\n   *\n   * - `400` when `body.gitBranch` does not exist; a draft never creates a branch.\n   * - `409` until the app has been deployed once.\n   * - Not idempotent: a retried request starts a second draft.\n   */\n  const createDraft = async (appId: AppId, body: CreateDraftBody, options: WriteOptions = {}) => {\n    const { data } = await client.post(\n      '/apps/{appId}/drafts',\n      { path: { appId }, body },\n      writeOptions(options),\n    );\n\n    return data;\n  };\n\n  /** Live drafts, newest first. */\n  const getDrafts = async (appId: AppId, query: GetDraftsQuery = {}, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/drafts',\n      { path: { appId }, query },\n      { signal },\n    );\n\n    return data;\n  };\n\n  const getDraft = async (appId: AppId, draftId: DraftId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/drafts/{draftId}',\n      { path: { appId, draftId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /** Stops and removes the draft; its Git branch is untouched. */\n  const deleteDraft = async (appId: AppId, draftId: DraftId, signal?: AbortSignal) => {\n    await client.delete('/apps/{appId}/drafts/{draftId}', { path: { appId, draftId } }, { signal });\n  };\n\n  /**\n   * A 60-second link that opens the draft's own `url` without the app's authentication.\n   *\n   * - `400` while the draft has no `url` yet; retry once it reports one.\n   * - `503` on a stack without preview links.\n   */\n  const createDraftPreviewLink = async (appId: AppId, draftId: DraftId, signal?: AbortSignal) => {\n    const { data } = await client.post(\n      '/apps/{appId}/drafts/{draftId}/preview-link',\n      { path: { appId, draftId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /** Serving container's log. `query.since` and `query.lines` are mutually exclusive. */\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  /** `409` when the app has no Git repository 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  /**\n   * The branches of the app's repository, read with the credentials in its saved configuration.\n   *\n   * - The request carries no credentials: changes to the Git settings count only once saved.\n   * - `409` when the app has no Git repository, or the saved credentials cannot read it.\n   */\n  const getAppGitRepoBranches = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/git-repo/branches',\n      { path: { appId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /**\n   * The Streamlit entrypoint candidates in the repository root, read like `getAppGitRepoBranches`.\n   *\n   * - `query.ref` omitted means the saved branch, then the repository default.\n   */\n  const getAppGitRepoEntrypoints = async (\n    appId: AppId,\n    query: GetAppGitEntrypointsQuery = {},\n    signal?: AbortSignal,\n  ) => {\n    const { data } = await client.get(\n      '/apps/{appId}/git-repo/entrypoints',\n      { path: { appId }, query },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /** Per app, not 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's `secret` is returned only here. */\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    createDraft,\n    getDrafts,\n    getDraft,\n    deleteDraft,\n    createDraftPreviewLink,\n    getAppLogsTail,\n    getAppLogsDownload,\n    getDeploymentLogsTail,\n    getDeploymentLogsDownload,\n    getAppGitRepo,\n    getAppGitRepoBranches,\n    getAppGitRepoEntrypoints,\n    getAppGitRepoCredentials,\n    getAppGitRepoCredential,\n    createAppGitRepoCredential,\n    deleteAppGitRepoCredential,\n  };\n};\n"],"mappings":"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"}

package/dist/{apps-BN7fWtSm.js → apps-DDcguJ1i.js}

@@ -255,6 +255,55 @@ const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 		} }, { signal });
 		return data;
 	};
+	/**
+	* Starts a draft that live-syncs an existing branch of the app's Git repository on its own host.
+	*
+	* - `400` when `body.gitBranch` does not exist; a draft never creates a branch.
+	* - `409` until the app has been deployed once.
+	* - Not idempotent: a retried request starts a second draft.
+	*/
+	const createDraft = async (appId, body, options = {}) => {
+		const { data } = await client.post("/apps/{appId}/drafts", {
+			path: { appId },
+			body
+		}, writeOptions(options));
+		return data;
+	};
+	/** Live drafts, newest first. */
+	const getDrafts = async (appId, query = {}, signal) => {
+		const { data } = await client.get("/apps/{appId}/drafts", {
+			path: { appId },
+			query
+		}, { signal });
+		return data;
+	};
+	const getDraft = async (appId, draftId, signal) => {
+		const { data } = await client.get("/apps/{appId}/drafts/{draftId}", { path: {
+			appId,
+			draftId
+		} }, { signal });
+		return data;
+	};
+	/** Stops and removes the draft; its Git branch is untouched. */
+	const deleteDraft = async (appId, draftId, signal) => {
+		await client.delete("/apps/{appId}/drafts/{draftId}", { path: {
+			appId,
+			draftId
+		} }, { signal });
+	};
+	/**
+	* A 60-second link that opens the draft's own `url` without the app's authentication.
+	*
+	* - `400` while the draft has no `url` yet; retry once it reports one.
+	* - `503` on a stack without preview links.
+	*/
+	const createDraftPreviewLink = async (appId, draftId, signal) => {
+		const { data } = await client.post("/apps/{appId}/drafts/{draftId}/preview-link", { path: {
+			appId,
+			draftId
+		} }, { signal });
+		return data;
+	};
 	/** Serving container's log. `query.since` and `query.lines` are mutually exclusive. */
 	const getAppLogsTail = (appId, { query, signal } = {}) => readAppLogsTail(() => client.get("/apps/{appId}/logs/tail", {
 		path: { appId },
@@ -343,6 +392,11 @@ const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 		getDeployment,
 		deleteDeployment,
 		promoteDeployment,
+		createDraft,
+		getDrafts,
+		getDraft,
+		deleteDraft,
+		createDraftPreviewLink,
 		getAppLogsTail,
 		getAppLogsDownload,
 		getDeploymentLogsTail,
@@ -358,4 +412,4 @@ const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 };
 export { parseLogLines as n, createAppsClient as t };
 
-//# sourceMappingURL=apps-BN7fWtSm.js.map
+//# sourceMappingURL=apps-DDcguJ1i.js.map