@keboola/api-client 25.0.0 → 29.0.0

package/dist/apps/index.cjs

@@ -0,0 +1,231 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_createOpenapiFetchClient = require("../createOpenapiFetchClient-Cr90VXY4.cjs");
+const require_auth = require("../auth-5HCvCsZO.cjs");
+const require_appLogs = require("../appLogs-CNG3yby-.cjs");
+//#region src/clients/apps/appsClient.ts
+/**
+* `/v2` App Deployments — data apps plus the immutable deployment history behind them. Sibling of
+* the `dataScience` client, which wraps the same service's `/v1` surface.
+*
+* `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.
+*/
+const createAppsClient = ({ baseUrl, middlewares, auth }) => {
+	const client = require_createOpenapiFetchClient.createOpenapiFetchClient({
+		baseUrl,
+		middlewares,
+		headers: require_auth.createAuthHeaders(auth)
+	});
+	const writeOptions = ({ signal }) => ({ signal });
+	/** Service metadata (`appName`, `appVersion`, `apiDocs`) — the `/v2` surface has no `/health-check`. */
+	const healthCheck = async (signal) => {
+		const { data } = await client.get("/", {}, { signal });
+		return data;
+	};
+	const getApps = async (query = {}, signal) => {
+		const { data } = await client.get("/apps", { query }, { signal });
+		return data;
+	};
+	const getApp = async (appId, signal) => {
+		const { data } = await client.get("/apps/{appId}", { path: { appId } }, { signal });
+		return data;
+	};
+	/**
+	* Reserves the app and its Storage configuration only. Content (`parameters`) and auth
+	* (`authorization.app_proxy`) are written afterwards through the Storage API, on the config named
+	* by the response's `componentId`/`branchId`/`configId`.
+	*/
+	const createApp = async (body, options = {}) => {
+		const { data } = await client.post("/apps", { body }, writeOptions(options));
+		return data;
+	};
+	const deleteApp = async (appId, signal) => {
+		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`.
+	*/
+	const unpublishApp = async (appId, signal) => {
+		const { data } = await client.post("/apps/{appId}/unpublish", { path: { appId } }, { signal });
+		return data;
+	};
+	/**
+	* 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`).
+	*/
+	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.
+	*/
+	const resumeApp = async (appId, signal) => {
+		const { data } = await client.post("/apps/{appId}/resume", { path: { appId } }, { signal });
+		return data;
+	};
+	/** `password` is `null` until one is minted — by the app's first deployment or {@link resetAppPassword}. */
+	const getAppPassword = async (appId, signal) => {
+		const { data } = await client.get("/apps/{appId}/password", { path: { appId } }, { signal });
+		return data;
+	};
+	/** 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 });
+		return data;
+	};
+	/**
+	* Runs of the app, newest first — app-wide, so this is where a failed deployment's cause lives
+	* (`failureReason`, `startupLogs`). Narrow to one deployment with `query.deploymentId`.
+	*/
+	const getAppRuns = async (appId, query = {}, signal) => {
+		const { data } = await client.get("/apps/{appId}/runs", {
+			path: { appId },
+			query
+		}, { signal });
+		return data;
+	};
+	const getAppRun = async (appId, runId, signal) => {
+		const { data } = await client.get("/apps/{appId}/runs/{runId}", { path: {
+			appId,
+			runId
+		} }, { signal });
+		return data;
+	};
+	/**
+	* 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.
+	*/
+	const createDeployment = async (appId, body, options = {}) => {
+		const { data } = await client.post("/apps/{appId}/deployments", {
+			path: { appId },
+			body
+		}, 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 });
+		return data;
+	};
+	const getDeployment = async (appId, deploymentId, signal) => {
+		const { data } = await client.get("/apps/{appId}/deployments/{deploymentId}", { path: {
+			appId,
+			deploymentId
+		} }, { signal });
+		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.
+	*/
+	const deleteDeployment = async (appId, deploymentId, signal) => {
+		await client.delete("/apps/{appId}/deployments/{deploymentId}", { path: {
+			appId,
+			deploymentId
+		} }, { signal });
+	};
+	/**
+	* 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`).
+	*/
+	const promoteDeployment = async (appId, deploymentId, signal) => {
+		const { data } = await client.post("/apps/{appId}/deployments/{deploymentId}/promote", { path: {
+			appId,
+			deploymentId
+		} }, { signal });
+		return data;
+	};
+	/**
+	* Container output of the app's currently serving member. `query.since` and `query.lines` are
+	* mutually exclusive; passing neither returns the log from its start.
+	*/
+	const getAppLogsTail = (appId, { query, signal } = {}) => require_appLogs.readAppLogsTail(() => client.get("/apps/{appId}/logs/tail", {
+		path: { appId },
+		query
+	}, { signal }));
+	const getAppLogsDownload = (appId, signal) => require_appLogs.readAppLogsDownload(() => client.get("/apps/{appId}/logs/download", { path: { appId } }, { signal }));
+	const getDeploymentLogsTail = (appId, deploymentId, { query, signal } = {}) => require_appLogs.readAppLogsTail(() => client.get("/apps/{appId}/deployments/{deploymentId}/logs/tail", {
+		path: {
+			appId,
+			deploymentId
+		},
+		query
+	}, { signal }));
+	const getDeploymentLogsDownload = (appId, deploymentId, signal) => require_appLogs.readAppLogsDownload(() => client.get("/apps/{appId}/deployments/{deploymentId}/logs/download", { path: {
+		appId,
+		deploymentId
+	} }, { signal }));
+	/** The app's Git repository — managed or external. `409` when it has none configured. */
+	const getAppGitRepo = async (appId, signal) => {
+		const { data } = await client.get("/apps/{appId}/git-repo", { path: { appId } }, { signal });
+		return data;
+	};
+	/** Credentials of the app's managed repository, per app rather than per deployment. */
+	const getAppGitRepoCredentials = async (appId, signal) => {
+		const { data } = await client.get("/apps/{appId}/git-repo/credentials", { path: { appId } }, { signal });
+		return data;
+	};
+	const getAppGitRepoCredential = async (appId, credentialId, signal) => {
+		const { data } = await client.get("/apps/{appId}/git-repo/credentials/{credentialId}", { path: {
+			appId,
+			credentialId
+		} }, { signal });
+		return data;
+	};
+	/** An `http_token` credential returns its `secret` here and nowhere else — store it now or lose it. */
+	const createAppGitRepoCredential = async (appId, body, options = {}) => {
+		const { data } = await client.post("/apps/{appId}/git-repo/credentials", {
+			path: { appId },
+			body
+		}, writeOptions(options));
+		return data;
+	};
+	const deleteAppGitRepoCredential = async (appId, credentialId, signal) => {
+		await client.delete("/apps/{appId}/git-repo/credentials/{credentialId}", { path: {
+			appId,
+			credentialId
+		} }, { signal });
+	};
+	return {
+		healthCheck,
+		getApps,
+		getApp,
+		createApp,
+		deleteApp,
+		unpublishApp,
+		suspendApp,
+		resumeApp,
+		getAppPassword,
+		resetAppPassword,
+		getAppRuns,
+		getAppRun,
+		createDeployment,
+		getDeployments,
+		getDeployment,
+		deleteDeployment,
+		promoteDeployment,
+		getAppLogsTail,
+		getAppLogsDownload,
+		getDeploymentLogsTail,
+		getDeploymentLogsDownload,
+		getAppGitRepo,
+		getAppGitRepoCredentials,
+		getAppGitRepoCredential,
+		createAppGitRepoCredential,
+		deleteAppGitRepoCredential
+	};
+};
+//#endregion
+exports.createAppsClient = createAppsClient;
+
+//# sourceMappingURL=index.cjs.map

package/dist/apps/index.cjs.map

@@ -0,0 +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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"}

package/dist/apps/index.d.cts

@@ -0,0 +1,248 @@
+import { n as ClientInitOptions } from "../types-C8XiTXxi.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-B06L4-WE.cjs";
+import { t as LogEntry } from "../appLogs-Dl5BcCSD.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.
+ *
+ * Every create here is therefore a genuine create, and a caller that retries one is responsible
+ * for the duplicate it may produce.
+ */
+type WriteOptions = {
+  signal?: AbortSignal;
+};
+type LogsTailOptions = {
+  query?: GetLogsTailQuery;
+  signal?: AbortSignal;
+};
+/**
+ * `/v2` App Deployments — data apps plus the immutable deployment history behind them. Sibling of
+ * the `dataScience` client, which wraps the same service's `/v1` surface.
+ *
+ * `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.
+ */
+declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptions) => {
+  healthCheck: (signal?: AbortSignal) => Promise<{
+    appName?: string;
+    appVersion?: string;
+    apiDocs?: string;
+  }>;
+  getApps: (query?: GetAppsQuery, 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';
+  }[]>;
+  getApp: (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';
+  }>;
+  createApp: (body: CreateAppBody, options?: WriteOptions) => 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';
+  }>;
+  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>;
+  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';
+  }>;
+  getAppRuns: (appId: AppId, query?: GetAppRunsQuery, signal?: AbortSignal) => Promise<{
+    id: string;
+    appId: string;
+    deploymentId: string | null;
+    state?: 'starting' | 'running' | 'failed' | 'finished' | null;
+    createdAt?: string | null;
+    startedAt?: string | null;
+    stoppedAt?: string | null;
+    startupLogs?: string | null;
+    runtimeSize?: string | null;
+    runtimeBackendType?: string | null;
+    configVersion?: string | null;
+    imageVersion?: string | null;
+    failureReason?: {
+      reason?: string | null;
+      message?: string | null;
+    } | null;
+    mode?: string;
+  }[]>;
+  getAppRun: (appId: AppId, runId: RunId, signal?: AbortSignal) => Promise<{
+    id: string;
+    appId: string;
+    deploymentId: string | null;
+    state?: 'starting' | 'running' | 'failed' | 'finished' | null;
+    createdAt?: string | null;
+    startedAt?: string | null;
+    stoppedAt?: string | null;
+    startupLogs?: string | null;
+    runtimeSize?: string | null;
+    runtimeBackendType?: string | null;
+    configVersion?: string | null;
+    imageVersion?: string | null;
+    failureReason?: {
+      reason?: string | null;
+      message?: string | null;
+    } | null;
+    mode?: string;
+  }>;
+  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';
+    archived: boolean;
+    archivedAt: string | null;
+    createdAt: string;
+  }>;
+  getDeployments: (appId: AppId, 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';
+    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';
+    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>;
+  getAppLogsTail: (appId: AppId, { query, signal }?: LogsTailOptions) => Promise<{
+    entries: LogEntry[];
+    nextLogTimestamp: string | null;
+  }>;
+  getAppLogsDownload: (appId: AppId, signal?: AbortSignal) => Promise<{
+    logs: string;
+    fileName: string;
+  }>;
+  getDeploymentLogsTail: (appId: AppId, deploymentId: DeploymentId, { query, signal }?: LogsTailOptions) => Promise<{
+    entries: LogEntry[];
+    nextLogTimestamp: string | null;
+  }>;
+  getDeploymentLogsDownload: (appId: AppId, deploymentId: DeploymentId, signal?: AbortSignal) => Promise<{
+    logs: string;
+    fileName: string;
+  }>;
+  getAppGitRepo: (appId: AppId, signal?: AbortSignal) => Promise<{
+    sshUrl: string | null;
+    httpsUrl: string | null;
+    isManagedGitRepo: boolean;
+  }>;
+  getAppGitRepoCredentials: (appId: AppId, signal?: AbortSignal) => Promise<{
+    credentials: components['schemas']['Credential'][];
+  }>;
+  getAppGitRepoCredential: (appId: AppId, credentialId: CredentialId, signal?: AbortSignal) => Promise<{
+    id: string;
+    type: 'ssh_key' | 'http_token';
+    name: string;
+    permissions: 'readOnly' | 'readWrite';
+    ownerAdminId: string;
+    createdAt: string;
+  }>;
+  createAppGitRepoCredential: (appId: AppId, body: CreateCredentialBody, options?: WriteOptions) => Promise<{
+    id: string;
+    type: 'ssh_key' | 'http_token';
+    name: string;
+    permissions: 'readOnly' | 'readWrite';
+    ownerAdminId: string;
+    createdAt: string;
+  } & {
+    secret?: string;
+  }>;
+  deleteAppGitRepoCredential: (appId: AppId, credentialId: CredentialId, signal?: AbortSignal) => Promise<void>;
+};
+//#endregion
+export { createAppsClient };
+//# sourceMappingURL=index.d.cts.map