@keboola/api-client 25.0.0 → 29.0.0

package/dist/vault/types.d.ts

@@ -1,385 +1,2 @@
-import { O as OpenapiBodyType, A as ArrayElement, b as OpenapiReturnType, d as OpenapiPathType, c as OpenapiQueryType } from '../types-gcShAmmi.js';
-
-/**
- * This file was auto-generated by openapi-typescript.
- * Do not make direct changes to the file.
- */
-
-type paths = {
-  '/health-check': {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    get?: never;
-    put?: never;
-    /**
-     * Health-check endpoint
-     * @description Checks the service is up & running.
-     */
-    post: operations['healthCheck'];
-    delete?: never;
-    options?: never;
-    head?: never;
-    patch?: never;
-    trace?: never;
-  };
-  '/variables': {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    /**
-     * List variables
-     * @description Lists variables.
-     */
-    get: operations['listVariables'];
-    put?: never;
-    /**
-     * Create variable
-     * @description Creates a new variable.
-     */
-    post: operations['createVariable'];
-    delete?: never;
-    options?: never;
-    head?: never;
-    patch?: never;
-    trace?: never;
-  };
-  '/variables/{hash}': {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    get?: never;
-    put?: never;
-    post?: never;
-    /**
-     * Delete variable
-     * @description Deletes a variable.
-     */
-    delete: operations['deleteVariable'];
-    options?: never;
-    head?: never;
-    patch?: never;
-    trace?: never;
-  };
-  '/variables/merged/branch': {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    /**
-     * List variables variables available in scope of the branch
-     * @deprecated
-     * @description List variables variables available in scope of the branch.
-     */
-    get: {
-      parameters: {
-        query: {
-          /** @description Branch ID */
-          branchId: string;
-        };
-        header?: never;
-        path?: never;
-        cookie?: never;
-      };
-      requestBody?: never;
-      responses: {
-        /** @description OK */
-        200: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            'application/json': components['schemas']['VariableWithHash'][];
-          };
-        };
-        401: components['responses']['401_Unauthorized'];
-        403: components['responses']['403_Forbidden'];
-      };
-    };
-    put?: never;
-    post?: never;
-    delete?: never;
-    options?: never;
-    head?: never;
-    patch?: never;
-    trace?: never;
-  };
-  '/variables/scoped/branch/{branchId}': {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    /**
-     * List variables variables available in scope of the branch
-     * @description List variables variables available in scope of the branch.
-     */
-    get: operations['listBranchVariables'];
-    put?: never;
-    post?: never;
-    delete?: never;
-    options?: never;
-    head?: never;
-    patch?: never;
-    trace?: never;
-  };
-};
-type components = {
-  schemas: {
-    Variable: {
-      /** @example mysql_host */
-      key: string;
-      value: string;
-      /** @default [] */
-      flags: ('encrypted' | 'oauthCredentialsId')[];
-      /** @example MySQL Credentials */
-      group?: string;
-      /**
-       * @description Key-value map of additional attributes.
-       *
-       *     Attributes are part of the variable identity, so two variables with the same key but different attributes
-       *     are considered different.
-       * @default {}
-       */
-      attributes: {
-        branchId?: string;
-      } & {
-        [key: string]: string;
-      };
-    };
-    VariableWithHash: components['schemas']['Variable'] & {
-      /** @description SHA-256 hash of the variable key + attributes */
-      hash?: string;
-    };
-    Error: {
-      error: string;
-      code: number;
-      exceptionId: string;
-      /** @enum {unknown} */
-      status: 'error';
-      context?: Record<string, never>;
-    };
-  };
-  responses: {
-    /** @description Bad request */
-    '400_BadRequest': {
-      headers: {
-        [name: string]: unknown;
-      };
-      content: {
-        'application/json': components['schemas']['Error'];
-      };
-    };
-    /** @description Unauthorized */
-    '401_Unauthorized': {
-      headers: {
-        [name: string]: unknown;
-      };
-      content: {
-        'application/json': components['schemas']['Error'];
-      };
-    };
-    /** @description Forbidden */
-    '403_Forbidden': {
-      headers: {
-        [name: string]: unknown;
-      };
-      content: {
-        'application/json': components['schemas']['Error'];
-      };
-    };
-  };
-  parameters: never;
-  requestBodies: never;
-  headers: never;
-  pathItems: never;
-};
-type operations = {
-  healthCheck: {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    requestBody?: never;
-    responses: {
-      /** @description OK */
-      200: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          'application/json': {
-            api?: string;
-            /** Format: url */
-            documentation?: string;
-          };
-        };
-      };
-    };
-  };
-  listVariables: {
-    parameters: {
-      query?: {
-        /** @description Variable key */
-        key?: string;
-        /** @description Attributes to match */
-        attributes?: {
-          branchId?: string;
-        };
-        /** @description Pagination offset */
-        offset?: number;
-        /** @description Maximum number of items to return */
-        limit?: number;
-      };
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    requestBody?: never;
-    responses: {
-      /** @description OK */
-      200: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          'application/json': components['schemas']['VariableWithHash'][];
-        };
-      };
-      401: components['responses']['401_Unauthorized'];
-      403: components['responses']['403_Forbidden'];
-      /** @description Invalid request parameters */
-      404: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-    };
-  };
-  createVariable: {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    requestBody: {
-      content: {
-        'application/json': components['schemas']['Variable'];
-      };
-    };
-    responses: {
-      /** @description Variable created */
-      201: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          'application/json': components['schemas']['VariableWithHash'];
-        };
-      };
-      400: components['responses']['400_BadRequest'];
-      401: components['responses']['401_Unauthorized'];
-      403: components['responses']['403_Forbidden'];
-      /** @description Invalid request payload */
-      422: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-    };
-  };
-  deleteVariable: {
-    parameters: {
-      query?: never;
-      header?: never;
-      path: {
-        /** @description Variable hash */
-        hash: string;
-      };
-      cookie?: never;
-    };
-    requestBody?: never;
-    responses: {
-      /** @description Variable deleted */
-      200: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      401: components['responses']['401_Unauthorized'];
-      403: components['responses']['403_Forbidden'];
-      /** @description Variable not found */
-      404: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-    };
-  };
-  listBranchVariables: {
-    parameters: {
-      query?: {
-        /** @description Variable key. If set, only variables with given key are returned. */
-        key?: string;
-        /**
-         * @description Other attributes to match.
-         *     * if attribute is set with value, only variables with given attribute value are returned
-         *     * if attribute is set without value (empty string), only variables without the attribute are returned
-         *     * any attribute not set is not matched, variables are returned regardless if they have the attribute or not
-         */
-        attributes?: Record<string, never>;
-      };
-      header?: never;
-      path: {
-        /** @description ID of the branch */
-        branchId: string;
-      };
-      cookie?: never;
-    };
-    requestBody?: never;
-    responses: {
-      /** @description OK */
-      200: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          'application/json': components['schemas']['VariableWithHash'][];
-        };
-      };
-      401: components['responses']['401_Unauthorized'];
-      403: components['responses']['403_Forbidden'];
-    };
-  };
-};
-
-type GetVariablesQuery = OpenapiQueryType<paths['/variables']['get']>;
-type DeleteVariablePath = OpenapiPathType<paths['/variables/{hash}']['delete']>;
-type CreateVariableBody = OpenapiBodyType<paths['/variables']['post']>;
-type GetVariablesByBranchId = OpenapiPathType<paths['/variables/scoped/branch/{branchId}']['get']>;
-type VariableWithHashRaw = ArrayElement<OpenapiReturnType<paths['/variables']['get']>>;
-type VariableWithHash = Omit<VariableWithHashRaw, 'hash'> & {
-    hash: string;
-};
-type AnyVariable = VariableWithHash | CreateVariableBody;
-
-export type { AnyVariable, CreateVariableBody, DeleteVariablePath, GetVariablesByBranchId, GetVariablesQuery, VariableWithHash };
+import { a as GetVariablesQuery, i as GetVariablesByBranchId, n as CreateVariableBody, o as VariableWithHash, r as DeleteVariablePath, t as AnyVariable } from "../types-CjAia48k.js";
+export { AnyVariable, CreateVariableBody, DeleteVariablePath, GetVariablesByBranchId, GetVariablesQuery, VariableWithHash };

package/dist/vault/types.js

@@ -1,3 +1 @@
-
-//# sourceMappingURL=types.js.map
-//# sourceMappingURL=types.js.map
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keboola/api-client",
-  "version": "25.0.0",
+  "version": "29.0.0",
   "description": "TypeScript SDK for Keboola APIs",
   "license": "MIT",
   "type": "module",
@@ -10,6 +10,7 @@
   "files": [
     "dist",
     "README.md",
+    "AGENTS.md",
     "API-SURFACE.md",
     "surface"
   ],
@@ -21,6 +22,12 @@
       "ai/types": [
         "./dist/ai/types.d.ts"
       ],
+      "apps": [
+        "./dist/apps/index.d.ts"
+      ],
+      "apps/types": [
+        "./dist/apps/types.d.ts"
+      ],
       "assets": [
         "./dist/assets/index.d.ts"
       ],
@@ -48,6 +55,12 @@
       "dataScience/types": [
         "./dist/dataScience/types.d.ts"
       ],
+      "developerPortal": [
+        "./dist/developerPortal/index.d.ts"
+      ],
+      "developerPortal/types": [
+        "./dist/developerPortal/types.d.ts"
+      ],
       "editor": [
         "./dist/editor/index.d.ts"
       ],
@@ -87,6 +100,12 @@
       "oauth/types": [
         "./dist/oauth/types.d.ts"
       ],
+      "omnisearch": [
+        "./dist/omnisearch/index.d.ts"
+      ],
+      "omnisearch/types": [
+        "./dist/omnisearch/types.d.ts"
+      ],
       "scheduler": [
         "./dist/scheduler/index.d.ts"
       ],
@@ -141,6 +160,9 @@
       "vault/types": [
         "./dist/vault/types.d.ts"
       ],
+      "sdk/developerPortal": [
+        "./dist/sdk/developerPortal/index.d.ts"
+      ],
       "sdk/tag": [
         "./dist/sdk/tag/index.d.ts"
       ],
@@ -156,6 +178,9 @@
       "sdk/storage": [
         "./dist/sdk/storage/index.d.ts"
       ],
+      "sdk/queryService": [
+        "./dist/sdk/queryService/index.d.ts"
+      ],
       "sdk/vault": [
         "./dist/sdk/vault/index.d.ts"
       ],
@@ -228,6 +253,26 @@
         "default": "./dist/ai/types.cjs"
       }
     },
+    "./apps": {
+      "import": {
+        "types": "./dist/apps/index.d.ts",
+        "default": "./dist/apps/index.js"
+      },
+      "require": {
+        "types": "./dist/apps/index.d.cts",
+        "default": "./dist/apps/index.cjs"
+      }
+    },
+    "./apps/types": {
+      "import": {
+        "types": "./dist/apps/types.d.ts",
+        "default": "./dist/apps/types.js"
+      },
+      "require": {
+        "types": "./dist/apps/types.d.cts",
+        "default": "./dist/apps/types.cjs"
+      }
+    },
     "./assets": {
       "import": {
         "types": "./dist/assets/index.d.ts",
@@ -308,6 +353,26 @@
         "default": "./dist/dataScience/types.cjs"
       }
     },
+    "./developerPortal": {
+      "import": {
+        "types": "./dist/developerPortal/index.d.ts",
+        "default": "./dist/developerPortal/index.js"
+      },
+      "require": {
+        "types": "./dist/developerPortal/index.d.cts",
+        "default": "./dist/developerPortal/index.cjs"
+      }
+    },
+    "./developerPortal/types": {
+      "import": {
+        "types": "./dist/developerPortal/types.d.ts",
+        "default": "./dist/developerPortal/types.js"
+      },
+      "require": {
+        "types": "./dist/developerPortal/types.d.cts",
+        "default": "./dist/developerPortal/types.cjs"
+      }
+    },
     "./editor": {
       "import": {
         "types": "./dist/editor/index.d.ts",
@@ -458,6 +523,26 @@
         "default": "./dist/oauth/types.cjs"
       }
     },
+    "./omnisearch": {
+      "import": {
+        "types": "./dist/omnisearch/index.d.ts",
+        "default": "./dist/omnisearch/index.js"
+      },
+      "require": {
+        "types": "./dist/omnisearch/index.d.cts",
+        "default": "./dist/omnisearch/index.cjs"
+      }
+    },
+    "./omnisearch/types": {
+      "import": {
+        "types": "./dist/omnisearch/types.d.ts",
+        "default": "./dist/omnisearch/types.js"
+      },
+      "require": {
+        "types": "./dist/omnisearch/types.d.cts",
+        "default": "./dist/omnisearch/types.cjs"
+      }
+    },
     "./queryService": {
       "import": {
         "types": "./dist/queryService/index.d.ts",
@@ -628,6 +713,16 @@
         "default": "./dist/vault/types.cjs"
       }
     },
+    "./sdk/developerPortal": {
+      "import": {
+        "types": "./dist/sdk/developerPortal/index.d.ts",
+        "default": "./dist/sdk/developerPortal/index.js"
+      },
+      "require": {
+        "types": "./dist/sdk/developerPortal/index.d.cts",
+        "default": "./dist/sdk/developerPortal/index.cjs"
+      }
+    },
     "./sdk/tag": {
       "import": {
         "types": "./dist/sdk/tag/index.d.ts",
@@ -678,6 +773,16 @@
         "default": "./dist/sdk/storage/index.cjs"
       }
     },
+    "./sdk/queryService": {
+      "import": {
+        "types": "./dist/sdk/queryService/index.d.ts",
+        "default": "./dist/sdk/queryService/index.js"
+      },
+      "require": {
+        "types": "./dist/sdk/queryService/index.d.cts",
+        "default": "./dist/sdk/queryService/index.cjs"
+      }
+    },
     "./sdk/vault": {
       "import": {
         "types": "./dist/sdk/vault/index.d.ts",
@@ -739,18 +844,19 @@
     "@types/node": "24.12.0",
     "@types/qs": "^6",
     "@typescript/native": "npm:typescript@^7.0.2",
-    "esbuild": "^0.28.1",
+    "@vitest/coverage-v8": "^4.1.10",
     "msw": "^2.14.6",
     "openapi-typescript": "7.10.1",
     "oxfmt": "^0.57.0",
     "oxlint": "^1.72.0",
-    "tsup": "^8.5.1",
+    "tsdown": "^0.22.14",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
     "vite": "^8.1.5",
     "vitest": "^4.1.10",
     "yaml": "^2.8.3",
-    "@keboola/oxlint-config": "^8.1.0",
-    "@keboola/tsconfig": "^0.2.0"
+    "@keboola/oxlint-config": "^10.0.1",
+    "@keboola/tsconfig": "^0.2.0",
+    "@keboola/vitest-config": "^1.0.0"
   },
   "scripts": {
     "gen:types": "openapi-typescript --export-type",
@@ -764,8 +870,8 @@
     "surface": "node scripts/gen-surface.mjs",
     "surface:check": "node scripts/gen-surface.mjs && git diff --exit-code -- API-SURFACE.md surface",
     "transit": "pnpm build",
-    "build": "NODE_OPTIONS=--max-old-space-size=8192 tsup",
-    "build:check": "attw --pack .",
+    "build": "tsdown",
+    "build:check": "node ../../tooling/check-dist-exports.mjs && attw --pack .",
     "test": "vitest run --passWithNoTests --reporter=dot",
     "test:integration": "vitest run --config vitest.integration.config.ts"
   }

package/surface/ai.md

@@ -11,4 +11,5 @@ Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
 - `api.ai.explainError(body: { error?: string | undefined; jobId: string; }): Promise<{ answer: string; correlationId: string; }>`
 - `api.ai.feedback(body: { value: "good" | "bad" | "cancel"; correlationId?: string | undefined; comment?: string | undefined; subject?: { type: "failed-job"; jobId: string; } | { type: "configuration"; branchId: string; componentId: string; configId: string; rowId?: string | undefined; } | { type: "component-suggestions"; searchTerm: string; } | undefined; }): Promise<never>`
 - `api.ai.getComponentDetail(componentId: string): Promise<{ componentId: string; componentType: string; componentName: string; componentCategories: string[]; description: string; longDescription: string; documentationUrl: string | null; documentation: string | null; configurationSchema: Record<string, never> | null; configurationRowSchema: Record<string, never> | null; configurationDescription: string | null; rootConfigurationExamples: Record<string, never>[] | null; rowConfigurationExamples: Record<string, never>[] | null; componentFlags: string[] | null; synchronousActions?: string[] | null | undefined; }>`
+- `api.ai.healthCheck(signal?: AbortSignal | undefined): Promise<{ status: "ok"; }>`
 - `api.ai.suggestComponent(body: { prompt: string; }): Promise<{ components: { componentId: string; score: number; }[]; correlationId: string; }>`

package/surface/apps.md

@@ -0,0 +1,32 @@
+# `api.apps` — `@keboola/api-client` surface
+
+<!-- GENERATED FILE — do not edit by hand. Run `pnpm --filter @keboola/api-client surface` to regenerate. -->
+
+Part of the [`@keboola/api-client` surface index](../API-SURFACE.md).
+
+- `api.apps.createApp(body: { name: string; type: "streamlit" | "python-js"; description?: string | null | undefined; }, options?: WriteOptions): Promise<{ id: string; projectId: string; componentId: string; branchId: string | null; configId: string; configVersion: string; type?: "streamlit" | "python-js" | null | undefined; mode?: "dev" | "prod" | undefined; url: string | null; production: { desiredNumber?: number | null | undefined; desiredId?: string | null | undefined; actualNumber?: number | null | undefined; actualId?: string | null | undefined; }; undeployedChanges?: boolean | undefined; state: "NOT_DEPLOYED" | "STARTING" | "RUNNING" | "SLEEPING" | "SUSPENDED"; }>`
+- `api.apps.createAppGitRepoCredential(appId: string, body: { type: "ssh_key" | "http_token"; publicKey?: string | undefined; name: string; permissions: "readOnly" | "readWrite"; }, options?: WriteOptions): Promise<{ id: string; type: "ssh_key" | "http_token"; name: string; permissions: "readOnly" | "readWrite"; ownerAdminId: string; createdAt: string; } & { secret?: string | undefined; }>`
+- `api.apps.createDeployment(appId: string, body?: { promote: boolean; } | undefined, options?: WriteOptions): Promise<{ id: string; number: number; configId: string; configVersion: string; gitCommitSha: string | null; size?: "small" | "external" | "micro" | "tiny" | "medium" | "large" | null | undefined; buildState: "PREBUILT" | "PENDING" | "BUILDING" | "BUILT" | "FAILED"; runState: "STARTING" | "RUNNING" | "PENDING" | "FAILED" | "NEVER_RUN" | "STOPPING" | "STOPPED"; archived: boolean; archivedAt: string | null; createdAt: string; }>`
+- `api.apps.deleteApp(appId: string, signal?: AbortSignal | undefined): Promise<void>`
+- `api.apps.deleteAppGitRepoCredential(appId: string, credentialId: string, signal?: AbortSignal | undefined): Promise<void>`
+- `api.apps.deleteDeployment(appId: string, deploymentId: string, signal?: AbortSignal | undefined): Promise<void>`
+- `api.apps.getApp(appId: string, signal?: AbortSignal | undefined): Promise<{ id: string; projectId: string; componentId: string; branchId: string | null; configId: string; configVersion: string; type?: "streamlit" | "python-js" | null | undefined; mode?: "dev" | "prod" | undefined; url: string | null; production: { desiredNumber?: number | null | undefined; desiredId?: string | null | undefined; actualNumber?: number | null | undefined; actualId?: string | null | undefined; }; undeployedChanges?: boolean | undefined; state: "NOT_DEPLOYED" | "STARTING" | "RUNNING" | "SLEEPING" | "SUSPENDED"; }>`
+- `api.apps.getAppGitRepo(appId: string, signal?: AbortSignal | undefined): Promise<{ sshUrl: string | null; httpsUrl: string | null; isManagedGitRepo: boolean; }>`
+- `api.apps.getAppGitRepoCredential(appId: string, credentialId: string, signal?: AbortSignal | undefined): Promise<{ id: string; type: "ssh_key" | "http_token"; name: string; permissions: "readOnly" | "readWrite"; ownerAdminId: string; createdAt: string; }>`
+- `api.apps.getAppGitRepoCredentials(appId: string, signal?: AbortSignal | undefined): Promise<{ credentials: { id: string; type: "ssh_key" | "http_token"; name: string; permissions: "readOnly" | "readWrite"; ownerAdminId: string; createdAt: string; }[]; }>`
+- `api.apps.getAppLogsDownload(appId: string, signal?: AbortSignal | undefined): Promise<{ logs: string; fileName: string; }>`
+- `api.apps.getAppLogsTail(appId: string, { query, signal }?: LogsTailOptions): Promise<{ entries: LogEntry[]; nextLogTimestamp: string | null; }>`
+- `api.apps.getAppPassword(appId: string, signal?: AbortSignal | undefined): Promise<{ password?: string | null | undefined; }>`
+- `api.apps.getAppRun(appId: string, runId: string, signal?: AbortSignal | undefined): Promise<{ id: string; appId: string; deploymentId: string | null; state?: "failed" | "starting" | "running" | "finished" | null | undefined; createdAt?: string | null | undefined; startedAt?: string | null | undefined; stoppedAt?: string | null | undefined; startupLogs?: string | null | undefined; runtimeSize?: string | null | undefined; runtimeBackendType?: string | null | undefined; configVersion?: string | null | undefined; imageVersion?: string | null | undefined; failureReason?: { reason?: string | null | undefined; message?: string | null | undefined; } | null | undefined; mode?: string | undefined; }>`
+- `api.apps.getAppRuns(appId: string, query?: { deploymentId?: string | undefined; since?: string | undefined; until?: string | undefined; offset?: number | undefined; limit?: number | undefined; }, signal?: AbortSignal | undefined): Promise<{ id: string; appId: string; deploymentId: string | null; state?: "failed" | "starting" | "running" | "finished" | null | undefined; createdAt?: string | null | undefined; startedAt?: string | null | undefined; stoppedAt?: string | null | undefined; startupLogs?: string | null | undefined; runtimeSize?: string | null | undefined; runtimeBackendType?: string | null | undefined; configVersion?: string | null | undefined; imageVersion?: string | null | undefined; failureReason?: { reason?: string | null | undefined; message?: string | null | undefined; } | null | undefined; mode?: string | undefined; }[]>`
+- `api.apps.getApps(query?: { offset?: number | undefined; limit?: number | undefined; }, signal?: AbortSignal | undefined): Promise<{ id: string; projectId: string; componentId: string; branchId: string | null; configId: string; configVersion: string; type?: "streamlit" | "python-js" | null | undefined; mode?: "dev" | "prod" | undefined; url: string | null; production: { desiredNumber?: number | null | undefined; desiredId?: string | null | undefined; actualNumber?: number | null | undefined; actualId?: string | null | undefined; }; undeployedChanges?: boolean | undefined; state: "NOT_DEPLOYED" | "STARTING" | "RUNNING" | "SLEEPING" | "SUSPENDED"; }[]>`
+- `api.apps.getDeployment(appId: string, deploymentId: string, signal?: AbortSignal | undefined): Promise<{ id: string; number: number; configId: string; configVersion: string; gitCommitSha: string | null; size?: "small" | "external" | "micro" | "tiny" | "medium" | "large" | null | undefined; buildState: "PREBUILT" | "PENDING" | "BUILDING" | "BUILT" | "FAILED"; runState: "STARTING" | "RUNNING" | "PENDING" | "FAILED" | "NEVER_RUN" | "STOPPING" | "STOPPED"; archived: boolean; archivedAt: string | null; createdAt: string; }>`
+- `api.apps.getDeploymentLogsDownload(appId: string, deploymentId: string, signal?: AbortSignal | undefined): Promise<{ logs: string; fileName: string; }>`
+- `api.apps.getDeploymentLogsTail(appId: string, deploymentId: string, { query, signal }?: LogsTailOptions): Promise<{ entries: LogEntry[]; nextLogTimestamp: string | null; }>`
+- `api.apps.getDeployments(appId: string, signal?: AbortSignal | undefined): Promise<{ id: string; number: number; configId: string; configVersion: string; gitCommitSha: string | null; size?: "small" | "external" | "micro" | "tiny" | "medium" | "large" | null | undefined; buildState: "PREBUILT" | "PENDING" | "BUILDING" | "BUILT" | "FAILED"; runState: "STARTING" | "RUNNING" | "PENDING" | "FAILED" | "NEVER_RUN" | "STOPPING" | "STOPPED"; archived: boolean; archivedAt: string | null; createdAt: string; }[]>`
+- `api.apps.healthCheck(signal?: AbortSignal | undefined): Promise<{ appName?: string | undefined; appVersion?: string | undefined; apiDocs?: string | undefined; }>`
+- `api.apps.promoteDeployment(appId: string, deploymentId: string, signal?: AbortSignal | undefined): Promise<{ id: string; projectId: string; componentId: string; branchId: string | null; configId: string; configVersion: string; type?: "streamlit" | "python-js" | null | undefined; mode?: "dev" | "prod" | undefined; url: string | null; production: { desiredNumber?: number | null | undefined; desiredId?: string | null | undefined; actualNumber?: number | null | undefined; actualId?: string | null | undefined; }; undeployedChanges?: boolean | undefined; state: "NOT_DEPLOYED" | "STARTING" | "RUNNING" | "SLEEPING" | "SUSPENDED"; } | null>`
+- `api.apps.resetAppPassword(appId: string, signal?: AbortSignal | undefined): Promise<{ id: string; projectId: string; componentId: string; branchId: string | null; configId: string; configVersion: string; type?: "streamlit" | "python-js" | null | undefined; mode?: "dev" | "prod" | undefined; url: string | null; production: { desiredNumber?: number | null | undefined; desiredId?: string | null | undefined; actualNumber?: number | null | undefined; actualId?: string | null | undefined; }; undeployedChanges?: boolean | undefined; state: "NOT_DEPLOYED" | "STARTING" | "RUNNING" | "SLEEPING" | "SUSPENDED"; }>`
+- `api.apps.resumeApp(appId: string, signal?: AbortSignal | undefined): Promise<{ id: string; projectId: string; componentId: string; branchId: string | null; configId: string; configVersion: string; type?: "streamlit" | "python-js" | null | undefined; mode?: "dev" | "prod" | undefined; url: string | null; production: { desiredNumber?: number | null | undefined; desiredId?: string | null | undefined; actualNumber?: number | null | undefined; actualId?: string | null | undefined; }; undeployedChanges?: boolean | undefined; state: "NOT_DEPLOYED" | "STARTING" | "RUNNING" | "SLEEPING" | "SUSPENDED"; } | null>`
+- `api.apps.suspendApp(appId: string, signal?: AbortSignal | undefined): Promise<{ id: string; projectId: string; componentId: string; branchId: string | null; configId: string; configVersion: string; type?: "streamlit" | "python-js" | null | undefined; mode?: "dev" | "prod" | undefined; url: string | null; production: { desiredNumber?: number | null | undefined; desiredId?: string | null | undefined; actualNumber?: number | null | undefined; actualId?: string | null | undefined; }; undeployedChanges?: boolean | undefined; state: "NOT_DEPLOYED" | "STARTING" | "RUNNING" | "SLEEPING" | "SUSPENDED"; } | null>`
+- `api.apps.unpublishApp(appId: string, signal?: AbortSignal | undefined): Promise<{ id: string; projectId: string; componentId: string; branchId: string | null; configId: string; configVersion: string; type?: "streamlit" | "python-js" | null | undefined; mode?: "dev" | "prod" | undefined; url: string | null; production: { desiredNumber?: number | null | undefined; desiredId?: string | null | undefined; actualNumber?: number | null | undefined; actualId?: string | null | undefined; }; undeployedChanges?: boolean | undefined; state: "NOT_DEPLOYED" | "STARTING" | "RUNNING" | "SLEEPING" | "SUSPENDED"; } | null>`