@ninedeploy/sdk 0.17.1 → 0.18.4

package/dist/resources/volumes.d.ts

@@ -27,53 +27,81 @@ export interface VolumesApi {
             freedBytes: number;
         }>;
         /** File manager: list a directory inside the volume. */
-        listFiles: (name: string, path?: string) => Promise<{
+        listFiles: (name: string, path?: string, options?: {
+            serverId?: number;
+        }) => Promise<{
             path: string;
             entries: VolumeFileEntry[];
         }>;
         /** File manager: read a file (base64 content). */
-        readFile: (name: string, path: string) => Promise<{
+        readFile: (name: string, path: string, options?: {
+            serverId?: number;
+        }) => Promise<{
             content: string;
             encoding: 'utf8' | 'base64';
         }>;
         /** File manager: write/overwrite a file (base64 content). */
-        writeFile: (name: string, input: VolumeFileWriteInput) => Promise<{
+        writeFile: (name: string, input: VolumeFileWriteInput, options?: {
+            serverId?: number;
+        }) => Promise<{
             ok: boolean;
         }>;
         /** File manager: create a directory. */
-        mkdir: (name: string, input: VolumePathCreateInput) => Promise<{
+        mkdir: (name: string, input: VolumePathCreateInput, options?: {
+            serverId?: number;
+        }) => Promise<{
             ok: boolean;
         }>;
         /** File manager: delete a file or directory (recursive). */
-        deleteFile: (name: string, path: string) => Promise<void>;
+        deleteFile: (name: string, path: string, options?: {
+            serverId?: number;
+        }) => Promise<void>;
     };
     containers: {
-        inspect: (container: string) => Promise<ContainerInspectData>;
-        compose: (container: string) => Promise<ContainerComposeData>;
+        inspect: (container: string, options?: {
+            serverId?: number;
+        }) => Promise<ContainerInspectData>;
+        compose: (container: string, options?: {
+            serverId?: number;
+        }) => Promise<ContainerComposeData>;
         /** File manager: list a directory inside the container. */
-        listFiles: (container: string, path?: string) => Promise<{
+        listFiles: (container: string, path?: string, options?: {
+            serverId?: number;
+        }) => Promise<{
             path: string;
             entries: VolumeFileEntry[];
         }>;
         /** File manager: read a file (base64 content). */
-        readFile: (container: string, path: string) => Promise<{
+        readFile: (container: string, path: string, options?: {
+            serverId?: number;
+        }) => Promise<{
             content: string;
             encoding: 'utf8' | 'base64';
         }>;
         /** File manager: write/overwrite a file (base64 content). */
-        writeFile: (container: string, input: VolumeFileWriteInput) => Promise<{
+        writeFile: (container: string, input: VolumeFileWriteInput, options?: {
+            serverId?: number;
+        }) => Promise<{
             ok: boolean;
         }>;
         /** File manager: create a directory. */
-        mkdir: (container: string, input: VolumePathCreateInput) => Promise<{
+        mkdir: (container: string, input: VolumePathCreateInput, options?: {
+            serverId?: number;
+        }) => Promise<{
             ok: boolean;
         }>;
-        makeDir: (container: string, input: VolumePathCreateInput) => Promise<{
+        makeDir: (container: string, input: VolumePathCreateInput, options?: {
+            serverId?: number;
+        }) => Promise<{
             ok: boolean;
         }>;
         /** File manager: delete a file or directory (recursive). */
-        deleteFile: (container: string, path: string) => Promise<void>;
-        deletePath: (container: string, path: string) => Promise<void>;
+        deleteFile: (container: string, path: string, options?: {
+            serverId?: number;
+        }) => Promise<void>;
+        deletePath: (container: string, path: string, options?: {
+            serverId?: number;
+        }) => Promise<void>;
     };
     /** Per-service additional volume attachments. Distinct from the instance-wide
      * `volumes` namespace (which lists every Docker volume on the host). The

package/dist/resources/volumes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"volumes.d.ts","sourceRoot":"","sources":["../../src/resources/volumes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"volumes.d.ts","sourceRoot":"","sources":["../../src/resources/volumes.ts"],"names":[],"mappings":"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"}

package/dist/resources/volumes.js

@@ -1,16 +1,32 @@
 import { apiGetUrl } from '../apiPath.js';
 export function volumesApi(t) {
     const { get, send, request } = t;
+    const volumePath = (name, suffix, options) => {
+        const id = options?.serverId;
+        if (id != null && (!Number.isSafeInteger(id) || id < 1))
+            throw new TypeError('Invalid volume node id');
+        const prefix = id == null ? '/v1/volumes' : `/v1/servers/${id}/volumes`;
+        return `${prefix}/${encodeURIComponent(name)}${suffix}`;
+    };
+    const containerPath = (container, suffix, options) => {
+        const id = options?.serverId;
+        if (id != null && (!Number.isSafeInteger(id) || id < 1))
+            throw new TypeError('Invalid container node id');
+        // An older panel returns 404 for this namespace instead of ignoring a host
+        // query and accidentally editing a same-named local container.
+        const prefix = id == null ? '/v1/containers' : `/v1/servers/${id}/containers`;
+        return `${prefix}/${encodeURIComponent(container)}${suffix}`;
+    };
     return {
         volumes: {
             list: (options) => get(apiGetUrl('/v1/volumes', { serverId: options?.serverId })),
             create: (input) => send('POST', '/v1/volumes', input),
-            listFiles: (name, path = '') => get(`/v1/volumes/${encodeURIComponent(name)}/files?path=${encodeURIComponent(path)}`),
-            readFile: (name, path) => get(`/v1/volumes/${encodeURIComponent(name)}/files/content?path=${encodeURIComponent(path)}`),
-            writeFile: (name, input) => send('PUT', `/v1/volumes/${encodeURIComponent(name)}/files`, input),
-            mkdir: (name, input) => send('POST', `/v1/volumes/${encodeURIComponent(name)}/files/dir`, input),
-            deleteFile: async (name, path) => {
-                await request(`/v1/volumes/${encodeURIComponent(name)}/files?path=${encodeURIComponent(path)}`, { method: 'DELETE' });
+            listFiles: (name, path = '', options) => request(`${volumePath(name, '/files', options)}?path=${encodeURIComponent(path)}`, {}, 150_000),
+            readFile: (name, path, options) => request(`${volumePath(name, '/files/content', options)}?path=${encodeURIComponent(path)}`, {}, 150_000),
+            writeFile: (name, input, options) => request(volumePath(name, '/files', options), { method: 'PUT', body: input }, 150_000),
+            mkdir: (name, input, options) => request(volumePath(name, '/files/dir', options), { method: 'POST', body: input }, 150_000),
+            deleteFile: async (name, path, options) => {
+                await request(`${volumePath(name, '/files', options)}?path=${encodeURIComponent(path)}`, { method: 'DELETE' }, 150_000);
             },
             remove: async (name, options) => {
                 const node = options?.serverId === undefined ? '' : `?serverId=${options.serverId}`;
@@ -19,18 +35,18 @@ export function volumesApi(t) {
             prune: () => send('POST', '/v1/volumes/prune'),
         },
         containers: {
-            inspect: (container) => get(`/v1/containers/${encodeURIComponent(container)}/inspect`),
-            compose: (container) => get(`/v1/containers/${encodeURIComponent(container)}/compose`),
-            listFiles: (container, path = '/') => get(`/v1/containers/${encodeURIComponent(container)}/files?path=${encodeURIComponent(path)}`),
-            readFile: (container, path) => get(`/v1/containers/${encodeURIComponent(container)}/files/content?path=${encodeURIComponent(path)}`),
-            writeFile: (container, input) => send('PUT', `/v1/containers/${encodeURIComponent(container)}/files`, input),
-            mkdir: (container, input) => send('POST', `/v1/containers/${encodeURIComponent(container)}/files/dir`, input),
-            makeDir: (container, input) => send('POST', `/v1/containers/${encodeURIComponent(container)}/files/dir`, input),
-            deleteFile: async (container, path) => {
-                await request(`/v1/containers/${encodeURIComponent(container)}/files?path=${encodeURIComponent(path)}`, { method: 'DELETE' });
+            inspect: (container, options) => get(containerPath(container, '/inspect', options)),
+            compose: (container, options) => get(containerPath(container, '/compose', options)),
+            listFiles: (container, path = '/', options) => get(`${containerPath(container, '/files', options)}?path=${encodeURIComponent(path)}`),
+            readFile: (container, path, options) => get(`${containerPath(container, '/files/content', options)}?path=${encodeURIComponent(path)}`),
+            writeFile: (container, input, options) => send('PUT', containerPath(container, '/files', options), input),
+            mkdir: (container, input, options) => send('POST', containerPath(container, '/files/dir', options), input),
+            makeDir: (container, input, options) => send('POST', containerPath(container, '/files/dir', options), input),
+            deleteFile: async (container, path, options) => {
+                await request(`${containerPath(container, '/files', options)}?path=${encodeURIComponent(path)}`, { method: 'DELETE' });
             },
-            deletePath: async (container, path) => {
-                await request(`/v1/containers/${encodeURIComponent(container)}/files?path=${encodeURIComponent(path)}`, { method: 'DELETE' });
+            deletePath: async (container, path, options) => {
+                await request(`${containerPath(container, '/files', options)}?path=${encodeURIComponent(path)}`, { method: 'DELETE' });
             },
         },
         serviceVolumes: {

package/dist/resources/volumes.js.map

@@ -1 +1 @@
-{"version":3,"file":"volumes.js","sourceRoot":"","sources":["../../src/resources/volumes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"volumes.js","sourceRoot":"","sources":["../../src/resources/volumes.ts"],"names":[],"mappings":"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"}

package/dist/terminal.d.ts

@@ -51,7 +51,7 @@ export interface TerminalReady {
     };
 }
 export interface TerminalHandlers {
-    /** The shell runs; input typed before this was held and is flushed now. */
+    /** The terminal transport is ready; buffered input is flushed now. Scripted interactive clients must also wait for their CLI prompt and each command's response. */
     onReady?: (ready: TerminalReady) => void;
     /** Shell output. */
     onData?: (bytes: Uint8Array) => void;

package/dist/terminal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ninedeploy/sdk",
-  "version": "0.17.1",
+  "version": "0.18.4",
   "description": "Official TypeScript SDK for NineDeploy PaaS",
   "license": "MIT",
   "repository": {
@@ -25,7 +25,7 @@
     }
   },
   "dependencies": {
-    "@ninedeploy/schemas": "0.17.1",
+    "@ninedeploy/schemas": "0.18.4",
     "js-yaml": "^4.3.1"
   },
   "devDependencies": {

package/src/resources/databases.ts

@@ -35,7 +35,7 @@ export interface DatabasesApi {
     logs: (id: number, lines?: number) => Promise<{ logs: string[] }>;
     credentials: (id: number) => Promise<DatabaseCredentialsWithPublic>;
     setLimits: (id: number, input: SetLimitsInput) => Promise<{ cpuShares: number | null; memLimitMb: number | null }>;
-    startStudio: (id: number, port?: number) => Promise<{ ok: boolean; port: number; url: string }>;
+    startStudio: (id: number, port?: number) => Promise<{ ok: boolean; port: number | null; url: string; serverId?: number }>;
     stopStudio: (id: number) => Promise<{ ok: boolean }>;
     /**
      * PgBouncer sidecar (G-32). Returns the current sidecar
@@ -159,9 +159,10 @@ export function databasesApi(t: Transport): DatabasesApi {
       logs: (id, lines) => get<{ logs: string[] }>(`/v1/databases/${id}/logs${lines ? `?lines=${lines}` : ''}`),
       credentials: (id) => get<DatabaseCredentialsWithPublic>(`/v1/databases/${id}/credentials`),
       setLimits: (id, input) => send<{ cpuShares: number | null; cpuLimitMilli: number | null; memLimitMb: number | null }>('PATCH', `/v1/databases/${id}/limits`, input),
-      startStudio: (id, port) => send<{ ok: boolean; port: number; url: string }>('POST', `/v1/databases/${id}/studio`, { port }),
+      // Allow bounded image preparation and keep the path-scoped browser cookie.
+      startStudio: (id, port) => request<{ ok: boolean; port: number | null; url: string; serverId?: number }>(`/v1/databases/${id}/studio`, { method: 'POST', body: { port }, credentials: 'include' }, 240_000),
       stopStudio: async (id) => {
-        await request(`/v1/databases/${id}/studio`, { method: 'DELETE' });
+        await request(`/v1/databases/${id}/studio`, { method: 'DELETE', credentials: 'include' }, 270_000);
         return { ok: true };
       },
       drillBackup: (id, input) =>

package/src/resources/deploys.ts

@@ -48,7 +48,16 @@ export interface DeploysApi {
      * Refused for an in-flight deployment (cancel it first) and for the one
      * currently serving traffic. Requires the `admin` role on the service.
      */
-    remove: (serviceId: number, deploymentId: number) => Promise<{ ok: boolean; id: number }>;
+    remove: (serviceId: number, deploymentId: number) => Promise<{ ok: boolean; id: number; removedContainers?: string[] }>;
+    /**
+     * Remove many finished deployments at once: `ids`, or every one in
+     * `statuses` (e.g. `['failed', 'cancelled']`). In-flight, waiting and live
+     * deployments are never removed. Requires the `admin` role.
+     */
+    removeMany: (
+      serviceId: number,
+      input: { ids?: number[]; statuses?: Array<'failed' | 'cancelled' | 'superseded'> },
+    ) => Promise<{ ok: true; removed: number[]; skipped: number; removedContainers: string[] }>;
     /** Build-config + env-key diff against the previous deployment. */
     configDiff: (serviceId: number, deploymentId: number) => Promise<{ deploymentId: number; previousDeploymentId: number | null; changed: boolean; diff: string }>;
     /** Build log download URL (serves the raw log file as an attachment). */
@@ -70,7 +79,9 @@ export interface DeploysApi {
      */
     canary: (serviceId: number) => Promise<CanaryStatusView>;
     /**
-     * Send all traffic to the canary release now and finish the deploy.
+     * Request canary promotion. A node first finishes and passes its current
+     * measured step, then skips the remaining steps; panel-host promotion is early.
+     * Resolves when accepted; poll canary/deployment status for completion.
      * Fails with `400 no_canary` when that deployment has no canary in
      * progress. To stop a canary instead, `cancel` the deployment.
      */
@@ -152,7 +163,9 @@ export function deploysApi(t: Transport): DeploysApi {
       cancel: (serviceId, deploymentId) =>
         send<{ ok: boolean; status: string }>('POST', `/v1/services/${serviceId}/deploys/${deploymentId}/cancel`),
       remove: (serviceId, deploymentId) =>
-        send<{ ok: boolean; id: number }>('DELETE', `/v1/services/${serviceId}/deploys/${deploymentId}`),
+        send<{ ok: boolean; id: number; removedContainers?: string[] }>('DELETE', `/v1/services/${serviceId}/deploys/${deploymentId}`),
+      removeMany: (serviceId, input) =>
+        send<{ ok: true; removed: number[]; skipped: number; removedContainers: string[] }>('POST', `/v1/services/${serviceId}/deploys/bulk-delete`, input),
       configDiff: (serviceId, deploymentId) =>
         get<{ deploymentId: number; previousDeploymentId: number | null; changed: boolean; diff: string }>(
           `/v1/services/${serviceId}/deploys/${deploymentId}/diff`,

package/src/resources/logs.ts

@@ -6,12 +6,16 @@ import type {
   LogDrainCreateInput,
   LogDrainUpdateInput,
   LogDrainTestResult,
+  LogQueueStatus,
 } from '@ninedeploy/schemas';
 import type { LogSearchInput, LogSearchResult } from '../types.js';
 import type { Transport } from '../transport.js';
 
 export interface LogsApi {
   logDrains: {
+    queue: (id: number) => Promise<LogQueueStatus>;
+    retryQueue: (id: number) => Promise<LogQueueStatus>;
+    discardQueue: (id: number) => Promise<{ discardedBatches: number }>;
     list: (query?: { serviceId?: number }) => Promise<LogDrain[]>;
     get: (id: number) => Promise<LogDrain>;
     create: (input: LogDrainCreateInput) => Promise<LogDrain>;
@@ -33,6 +37,9 @@ export function logsApi(t: Transport): LogsApi {
   const { get, send } = t;
   return {
     logDrains: {
+      queue: (id) => get<LogQueueStatus>('/v1/log-drains/' + id + '/queue'),
+      retryQueue: (id) => send<LogQueueStatus>('POST', '/v1/log-drains/' + id + '/queue/retry'),
+      discardQueue: (id) => send<{ discardedBatches: number }>('DELETE', '/v1/log-drains/' + id + '/queue'),
       list: (query) => {
         const qs = query?.serviceId !== undefined ? `?serviceId=${encodeURIComponent(String(query.serviceId))}` : '';
         return get<LogDrain[]>(`/v1/log-drains${qs}`);

package/src/resources/services.ts

@@ -14,6 +14,13 @@ import type {
   Environment,
   EnvironmentCreateInput,
   EnvironmentPatchInput,
+  PrimaryRecoveryEntry,
+  ServiceRoutingView,
+  PrimaryRecoveryResult,
+  SwarmRecoveryEntry,
+  SwarmRecoveryResult,
+  FanoutRecoveryEntry,
+  FanoutRecoveryResult,
   ProjectEntry,
   ProjectPatchInput,
   Service,
@@ -32,6 +39,9 @@ import type {
   ServiceFile,
   ServiceFileEntry,
   ServiceFilePut,
+  ServiceLifecycleResult,
+  ServiceLifecycleView,
+  ServiceLifecycleRetry,
 } from '@ninedeploy/schemas';
 import { apiGetUrl } from '../apiPath.js';
 import type { ApplyManifestResult, ApplyManifestInput, ServiceDetail } from '../types.js';
@@ -65,9 +75,11 @@ export interface ServicesApi {
      */
     composePreview: (input: ComposePreviewRequestInput) => Promise<ComposePreviewResponse>;
     remove: (id: number) => Promise<void>;
-    stop: (id: number) => Promise<{ ok: boolean; status: string }>;
-    start: (id: number) => Promise<{ ok: boolean; status: string }>;
-    restart: (id: number) => Promise<{ ok: boolean; status: string }>;
+    stop: (id: number) => Promise<ServiceLifecycleResult>;
+    start: (id: number) => Promise<ServiceLifecycleResult>;
+    restart: (id: number) => Promise<ServiceLifecycleResult>;
+    lifecycle: (id: number) => Promise<ServiceLifecycleView>;
+    retryLifecycle: (id: number) => Promise<ServiceLifecycleRetry>;
     /** The last `tail` runtime-log lines (default 300, at most 5000; 0.16.3). */
     logs: (id: number, opts?: { tail?: number }) => Promise<{ lines: string }>;
     clone: (id: number, input?: { name?: string; slug?: string }) => Promise<Service>;
@@ -175,6 +187,12 @@ export interface ServicesApi {
      * scaling event. The configuration itself is `autoscale` on the service
      * and is set with `update(id, { autoscale })` (`null` turns it off).
      */
+    /** Where the service's traffic goes now: domains through Traefik, host ports through Docker. */
+    routing: (id: number) => Promise<ServiceRoutingView>;
+    runtimeRecovery: (id: number) => Promise<PrimaryRecoveryEntry | null>;
+    retryRuntimeRecovery: (id: number) => Promise<PrimaryRecoveryResult>;
+    swarmRecovery: (id: number) => Promise<SwarmRecoveryEntry | null>;
+    retrySwarmRecovery: (id: number) => Promise<SwarmRecoveryResult>;
     autoscale: (id: number) => Promise<AutoscaleStatusView>;
     // ── 0.16.11 scale to zero ──
     /**
@@ -228,6 +246,8 @@ export interface ServicesApi {
     remove: (id: number) => Promise<{ ok: boolean }>;
   };
   fanout: {
+    recovery: (serviceId: number) => Promise<FanoutRecoveryEntry[]>;
+    retryRecovery: (serviceId: number) => Promise<FanoutRecoveryResult>;
     /** The extra nodes an image/Dockerfile release is pushed to. */
     get: (serviceId: number) =>
       Promise<Array<{ serverId: number; runtimeId: string | null; status: string }>>;
@@ -258,9 +278,11 @@ export function servicesApi(t: Transport): ServicesApi {
       remove: async (id) => {
         await request(`/v1/services/${id}`, { method: 'DELETE' });
       },
-      stop: (id) => send<{ ok: boolean; status: string }>('POST', `/v1/services/${id}/stop`),
-      start: (id) => send<{ ok: boolean; status: string }>('POST', `/v1/services/${id}/start`),
-      restart: (id) => send<{ ok: boolean; status: string }>('POST', `/v1/services/${id}/restart`),
+      stop: (id) => send<ServiceLifecycleResult>('POST', `/v1/services/${id}/stop`),
+      start: (id) => send<ServiceLifecycleResult>('POST', `/v1/services/${id}/start`),
+      restart: (id) => send<ServiceLifecycleResult>('POST', `/v1/services/${id}/restart`),
+      lifecycle: id => get<ServiceLifecycleView>(`/v1/services/${id}/lifecycle`),
+      retryLifecycle: id => send<ServiceLifecycleRetry>('POST', `/v1/services/${id}/lifecycle/retry`),
       logs: (id, opts) => get<{ lines: string }>(`/v1/services/${id}/logs${opts?.tail ? `?tail=${opts.tail}` : ''}`),
       clone: (id, input) => send<Service>('POST', `/v1/services/${id}/clone`, input ?? {}),
       exportUrl: (id) => `/v1/services/${id}/export`,
@@ -309,6 +331,11 @@ export function servicesApi(t: Transport): ServicesApi {
       },
       imageTransfers: (id, query) => get<ImageTransfer[]>(apiGetUrl(`/v1/services/${id}/image-transfers`, { ...query })),
       swarm: (id) => get<ServiceSwarmStatus>(`/v1/services/${id}/swarm`),
+      routing: (id) => get<ServiceRoutingView>(`/v1/services/${id}/routing`),
+      runtimeRecovery: async id => (await get<{ entry: PrimaryRecoveryEntry | null }>(`/v1/services/${id}/runtime-recovery`)).entry,
+      retryRuntimeRecovery: id => request<PrimaryRecoveryResult>(`/v1/services/${id}/runtime-recovery`, { method: 'POST' }, 600_000),
+      swarmRecovery: async id => (await get<{ entry: SwarmRecoveryEntry | null }>(`/v1/services/${id}/swarm/recovery`)).entry,
+      retrySwarmRecovery: id => request<SwarmRecoveryResult>(`/v1/services/${id}/swarm/recovery`, { method: 'POST' }, 600_000),
       autoscale: (id) => get<AutoscaleStatusView>(`/v1/services/${id}/autoscale`),
       sleep: (id) => send<{ ok: boolean; asleep: boolean }>('POST', `/v1/services/${id}/sleep`),
       wake: (id) => send<{ ok: boolean; status: string }>('POST', `/v1/services/${id}/wake`),
@@ -338,6 +365,8 @@ export function servicesApi(t: Transport): ServicesApi {
       remove: (id) => send<{ ok: boolean }>('DELETE', `/v1/projects/${id}`),
     },
     fanout: {
+      recovery: async serviceId => (await get<{ entries: FanoutRecoveryEntry[] }>(`/v1/services/${serviceId}/targets/recovery`)).entries,
+      retryRecovery: serviceId => request<FanoutRecoveryResult>(`/v1/services/${serviceId}/targets/recovery`, { method: 'POST' }, 600_000),
       // r201: the route answers `{ targets: [...] }` (like PATCH); the SDK
       // typed and returned it as a bare array, so the panel's fan-out card
       // called `.map` on an object and crashed whenever it rendered.

package/src/resources/system.ts

@@ -11,6 +11,9 @@ import type {
   DemoSeedResult,
   DockerResources,
   MetricSeries,
+  ObservabilityResponse,
+  ObservabilityPatch,
+  ObservabilityExportResult,
   StatsSnapshot,
   TopologyGraph,
   UpdateCheckResult,
@@ -80,7 +83,13 @@ export interface SystemApi {
     }>;
   };
   stats: {
-    snapshot: () => Promise<StatsSnapshot>;
+    observability: {
+      get: () => Promise<ObservabilityResponse>;
+      update: (input: ObservabilityPatch) => Promise<ObservabilityResponse>;
+      test: () => Promise<ObservabilityExportResult>;
+    };
+    /** Omit the filter for local-host monitoring; databaseId returns only that authorized database on its recorded host. */
+    snapshot: (opts?: { databaseId?: number }) => Promise<StatsSnapshot>;
     metrics: (serviceId: number, opts?: { kind?: 'cpu' | 'memory'; minutes?: number }) => Promise<MetricSeries>;
   };
   topology: {
@@ -197,7 +206,19 @@ export function systemApi(t: Transport): SystemApi {
       get: () => get('/v1/dashboard'),
     },
     stats: {
-      snapshot: () => get<StatsSnapshot>('/v1/stats'),
+      observability: {
+        get: () => get<ObservabilityResponse>('/v1/stats/observability'),
+        update: (input) => send<ObservabilityResponse>('PATCH', '/v1/stats/observability', input),
+        test: () => send<ObservabilityExportResult>('POST', '/v1/stats/observability/test'),
+      },
+      snapshot: async (opts) => {
+        const result = await get<StatsSnapshot>('/v1/stats' + (opts?.databaseId === undefined ? '' : `?databaseId=${encodeURIComponent(opts.databaseId)}`));
+        if (opts?.databaseId !== undefined && (result?.resource?.kind !== 'database' || result.resource.id !== opts.databaseId || result.host !== null
+          || !Array.isArray(result.containers) || result.containers.some(entry => entry.kind !== 'database' || entry.refId !== opts.databaseId))) {
+          throw new Error('Database-scoped metrics were not confirmed by this panel; upgrade the panel to 0.18.0 or newer and retry');
+        }
+        return result;
+      },
       metrics: (serviceId, opts) =>
         get<MetricSeries>(
           `/v1/services/${serviceId}/metrics?kind=${opts?.kind ?? 'cpu'}&minutes=${opts?.minutes ?? 60}`,

package/src/resources/terminals.ts

@@ -82,7 +82,9 @@ export function terminalsApi(t: Transport): TerminalsApi {
     // ── end 0.15 T4 ──
     // ── 0.15 T6 surfaces ──
     terminals: {
-      create: (input) => send<TerminalSessionCreated>('POST', '/v1/terminals', input),
+      create: (input) => input.target.kind === 'database' && input.target.mode === 'client'
+        ? t.request<TerminalSessionCreated>('/v1/terminals', {method:'POST',body:input},60_000)
+        : send<TerminalSessionCreated>('POST', '/v1/terminals', input),
       list: (query) => get<TerminalSessionList>(apiGetUrl('/v1/terminals', { ...query })),
       get: (id) => get<TerminalSession>(`/v1/terminals/${id}`),
       terminate: (id) => send<TerminalTerminateResult>('DELETE', `/v1/terminals/${id}`),