@ninedeploy/sdk 0.10.5 → 0.16.0

package/dist/resources/traefik.js

@@ -0,0 +1,35 @@
+export function traefikApi(t) {
+    const { get, send, request } = t;
+    return {
+        traefik: {
+            get: () => get('/v1/traefik'),
+            status: () => get('/v1/traefik/status'),
+            certificates: () => get('/v1/traefik/certificates'),
+            certificateInventory: (opts) => get(
+            // `!= null` (not truthiness): 0 ("only already-expired") is a real
+            // threshold and must reach the server, not silently become the
+            // server-side default of 30.
+            `/v1/traefik/certificates/inventory${opts?.threshold != null ? `?threshold=${opts.threshold}` : ''}`),
+            expiringCertificates: (opts) => get(`/v1/traefik/certificates/expiring${opts?.days != null ? `?days=${opts.days}` : ''}`),
+            logs: (lines = 50) => get(`/v1/traefik/logs?lines=${lines}`),
+            restart: () => send('POST', '/v1/traefik/restart'),
+            backupCerts: () => send('POST', '/v1/traefik/backup-certs'),
+            config: () => get('/v1/traefik/config'),
+            version: () => get('/v1/traefik/version'),
+            update: () => request('/v1/traefik/update', { method: 'POST' }, 10 * 60_000),
+            customConfig: {
+                get: () => get('/v1/traefik/custom-config'),
+                validate: (content) => send('POST', '/v1/traefik/custom-config/validate', { content }),
+                set: (content) => request('/v1/traefik/custom-config', { method: 'PUT', body: { content }, findings: true }),
+                clear: () => send('DELETE', '/v1/traefik/custom-config'),
+            },
+            customCertificates: {
+                list: () => get('/v1/traefik/certificates/custom'),
+                upload: (input) => send('POST', '/v1/traefik/certificates/custom', input),
+                replace: (id, input) => send('PUT', `/v1/traefik/certificates/custom/${id}`, input),
+                delete: (id) => send('DELETE', `/v1/traefik/certificates/custom/${id}`),
+            },
+        },
+    };
+}
+//# sourceMappingURL=traefik.js.map

package/dist/resources/traefik.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traefik.js","sourceRoot":"","sources":["../../src/resources/traefik.ts"],"names":[],"mappings":"AA4EA,MAAM,UAAU,UAAU,CAAC,CAAY;IACrC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IACjC,OAAO;QACL,OAAO,EAAE;YACP,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAc,aAAa,CAAC;YAC1C,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAgB,oBAAoB,CAAC;YACtD,YAAY,EAAE,GAAG,EAAE,CAAC,GAAG,CAAuB,0BAA0B,CAAC;YACzE,oBAAoB,EAAE,CAAC,IAAI,EAAE,EAAE,CAC7B,GAAG;YACD,mEAAmE;YACnE,+DAA+D;YAC/D,6BAA6B;YAC7B,qCAAqC,IAAI,EAAE,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACrG;YACH,oBAAoB,EAAE,CAAC,IAAI,EAAE,EAAE,CAC7B,GAAG,CACD,oCAAoC,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACrF;YACH,IAAI,EAAE,CAAC,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAqB,0BAA0B,KAAK,EAAE,CAAC;YAChF,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAmC,MAAM,EAAE,qBAAqB,CAAC;YACpF,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAsC,MAAM,EAAE,0BAA0B,CAAC;YAChG,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAuB,oBAAoB,CAAC;YAC7D,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAqB,qBAAqB,CAAC;YAC7D,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAA6C,oBAAoB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;YACxH,YAAY,EAAE;gBACZ,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAsB,2BAA2B,CAAC;gBAChE,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAgC,MAAM,EAAE,oCAAoC,EAAE,EAAE,OAAO,EAAE,CAAC;gBACrH,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CACf,OAAO,CAA6B,2BAA2B,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;gBACxH,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAoC,QAAQ,EAAE,2BAA2B,CAAC;aAC5F;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAsB,iCAAiC,CAAC;gBACvE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAyB,MAAM,EAAE,iCAAiC,EAAE,KAAK,CAAC;gBACjG,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAyB,KAAK,EAAE,mCAAmC,EAAE,EAAE,EAAE,KAAK,CAAC;gBAC3G,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAkB,QAAQ,EAAE,mCAAmC,EAAE,EAAE,CAAC;aACzF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/resources/volumes.d.ts

@@ -0,0 +1,114 @@
+import type { CreateServiceVolumeAttachmentInput, ServiceVolumeAttachment, UpdateServiceVolumeAttachmentInput, VolumeFileEntry, VolumeFileWriteInput, VolumePathCreateInput, VolumeCreateInput } from '@ninedeploy/schemas';
+import type { VolumeListEntry, VolumeCreateResult, ContainerInspectData, ContainerComposeData } from '../types.js';
+import type { Transport } from '../transport.js';
+export interface VolumesApi {
+    volumes: {
+        /**
+         * Managed volumes on the panel host or (0.16 T8) with `serverId` on a
+         * node, through its agent; node entries carry `serverId`. An older agent
+         * answers 422 `node_agent_outdated`.
+         */
+        list: (options?: {
+            serverId?: number;
+        }) => Promise<VolumeListEntry[]>;
+        /** Delete a retained volume; with `serverId` (r466) on that node. */
+        remove: (name: string, options?: {
+            serverId?: number;
+        }) => Promise<void>;
+        /**
+         * 0.16 T8: create a managed volume (`nd-svc-*` / `nd-db-*`) on the panel
+         * host or, with `serverId`, on a node. An existing volume answers 409
+         * `node_volume_exists`.
+         */
+        create: (input: VolumeCreateInput) => Promise<VolumeCreateResult>;
+        prune: () => Promise<{
+            ok: boolean;
+            deleted: number;
+            freedBytes: number;
+        }>;
+        /** File manager: list a directory inside the volume. */
+        listFiles: (name: string, path?: string) => Promise<{
+            path: string;
+            entries: VolumeFileEntry[];
+        }>;
+        /** File manager: read a file (base64 content). */
+        readFile: (name: string, path: string) => Promise<{
+            content: string;
+            encoding: 'utf8' | 'base64';
+        }>;
+        /** File manager: write/overwrite a file (base64 content). */
+        writeFile: (name: string, input: VolumeFileWriteInput) => Promise<{
+            ok: boolean;
+        }>;
+        /** File manager: create a directory. */
+        mkdir: (name: string, input: VolumePathCreateInput) => Promise<{
+            ok: boolean;
+        }>;
+        /** File manager: delete a file or directory (recursive). */
+        deleteFile: (name: string, path: string) => Promise<void>;
+    };
+    containers: {
+        inspect: (container: string) => Promise<ContainerInspectData>;
+        compose: (container: string) => Promise<ContainerComposeData>;
+        /** File manager: list a directory inside the container. */
+        listFiles: (container: string, path?: string) => Promise<{
+            path: string;
+            entries: VolumeFileEntry[];
+        }>;
+        /** File manager: read a file (base64 content). */
+        readFile: (container: string, path: string) => Promise<{
+            content: string;
+            encoding: 'utf8' | 'base64';
+        }>;
+        /** File manager: write/overwrite a file (base64 content). */
+        writeFile: (container: string, input: VolumeFileWriteInput) => Promise<{
+            ok: boolean;
+        }>;
+        /** File manager: create a directory. */
+        mkdir: (container: string, input: VolumePathCreateInput) => Promise<{
+            ok: boolean;
+        }>;
+        makeDir: (container: string, input: VolumePathCreateInput) => 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>;
+    };
+    /** Per-service additional volume attachments. Distinct from the instance-wide
+     * `volumes` namespace (which lists every Docker volume on the host). The
+     * list endpoint returns runtime-computed metadata (size, in-use, sharing);
+     * the create/update endpoints return the database row only. */
+    serviceVolumes: {
+        list: (serviceId: number) => Promise<Array<ServiceVolumeAttachment & {
+            sizeBytes: number;
+            inUse: boolean;
+            sharedWith: number;
+        }>>;
+        /** Attach an existing managed volume or create a new one and attach it. */
+        create: (serviceId: number, input: CreateServiceVolumeAttachmentInput) => Promise<{
+            attachment: ServiceVolumeAttachment;
+            deploymentId: number;
+        }>;
+        update: (serviceId: number, attachmentId: number, input: UpdateServiceVolumeAttachmentInput) => Promise<{
+            attachment: ServiceVolumeAttachment;
+            deploymentId: number;
+        }>;
+        /** Detach. The underlying Docker volume is NOT deleted (data persists). */
+        remove: (serviceId: number, attachmentId: number) => Promise<void>;
+        /** Delete a first-boot-baked config file from the volume and queue a
+         *  redeploy so the app regenerates it from the current environment
+         *  (WordPress wp-config.php et al.). Exactly one of `attachmentId` /
+         *  `volumeName` must be set; `filePath` is a single path segment. */
+        repairConfig: (serviceId: number, input: {
+            filePath: string;
+            attachmentId?: number;
+            volumeName?: string;
+        }) => Promise<{
+            ok: boolean;
+            deploymentId: number;
+        }>;
+    };
+}
+export declare function volumesApi(t: Transport): VolumesApi;
+//# sourceMappingURL=volumes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"volumes.d.ts","sourceRoot":"","sources":["../../src/resources/volumes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kCAAkC,EAClC,uBAAuB,EACvB,kCAAkC,EAClC,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE;QACP;;;;WAIG;QACH,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;QACtE,qEAAqE;QACrE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACzE;;;;WAIG;QACH,MAAM,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAClE,KAAK,EAAE,MAAM,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC3E,wDAAwD;QACxD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,eAAe,EAAE,CAAA;SAAE,CAAC,CAAC;QAClG,kDAAkD;QAClD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAA;SAAE,CAAC,CAAC;QACpG,6DAA6D;QAC7D,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACnF,wCAAwC;QACxC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAChF,4DAA4D;QAC5D,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC3D,CAAC;IACF,UAAU,EAAE;QACV,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAC9D,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAC9D,2DAA2D;QAC3D,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,eAAe,EAAE,CAAA;SAAE,CAAC,CAAC;QACvG,kDAAkD;QAClD,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAA;SAAE,CAAC,CAAC;QACzG,6DAA6D;QAC7D,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACxF,wCAAwC;QACxC,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACrF,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACvF,4DAA4D;QAC5D,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/D,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAChE,CAAC;IACF;;;mEAG+D;IAC/D,cAAc,EAAE;QACd,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,uBAAuB,GAAG;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,OAAO,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC,CAAC;QACjI,2EAA2E;QAC3E,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,kCAAkC,KAAK,OAAO,CAAC;YAAE,UAAU,EAAE,uBAAuB,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACjJ,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,kCAAkC,KAAK,OAAO,CAAC;YAAE,UAAU,EAAE,uBAAuB,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACvK,2EAA2E;QAC3E,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACnE;;;6EAGqE;QACrE,YAAY,EAAE,CACZ,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,YAAY,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,KACpE,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrD,CAAC;CACH;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,SAAS,GAAG,UAAU,CAuDnD"}

package/dist/resources/volumes.js

@@ -0,0 +1,47 @@
+import { apiGetUrl } from '../apiPath.js';
+export function volumesApi(t) {
+    const { get, send, request } = t;
+    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' });
+            },
+            remove: async (name, options) => {
+                const node = options?.serverId === undefined ? '' : `?serverId=${options.serverId}`;
+                await request(`/v1/volumes/${encodeURIComponent(name)}${node}`, { method: 'DELETE' });
+            },
+            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' });
+            },
+            deletePath: async (container, path) => {
+                await request(`/v1/containers/${encodeURIComponent(container)}/files?path=${encodeURIComponent(path)}`, { method: 'DELETE' });
+            },
+        },
+        serviceVolumes: {
+            list: (serviceId) => get(`/v1/services/${serviceId}/volumes`),
+            create: (serviceId, input) => send('POST', `/v1/services/${serviceId}/volumes`, input),
+            update: (serviceId, attachmentId, input) => send('PATCH', `/v1/services/${serviceId}/volumes/${attachmentId}`, input),
+            remove: async (serviceId, attachmentId) => {
+                await request(`/v1/services/${serviceId}/volumes/${attachmentId}`, { method: 'DELETE' });
+            },
+            repairConfig: (serviceId, input) => send('POST', `/v1/services/${serviceId}/volumes/config-repair`, input),
+        },
+    };
+}
+//# sourceMappingURL=volumes.js.map

package/dist/resources/volumes.js.map

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

package/dist/terminal.d.ts

@@ -0,0 +1,98 @@
+import type { TerminalSessionCreated, TerminalTargetKind } from '@ninedeploy/schemas';
+/** Attach subprotocol (protocol v1) and the ticket's subprotocol prefix; mirror `@ninedeploy/schemas`. */
+export declare const TERMINAL_SUBPROTOCOL = "ninedeploy.terminal.v1";
+export declare const TERMINAL_TICKET_PREFIX = "ninedeploy.ticket.";
+/** The server closes a socket whose frame exceeds 64 KiB (1009); input is sent in smaller pieces. */
+export declare const TERMINAL_INPUT_CHUNK_BYTES: number;
+/** Input typed before the shell is `ready` is held, up to this many bytes. */
+export declare const TERMINAL_PENDING_INPUT_MAX: number;
+/** What `attachInfo` needs from `terminals.create`'s answer. */
+export type TerminalAttachSource = Pick<TerminalSessionCreated, 'ticket' | 'attachPath'>;
+/** A page location, for a client whose `baseUrl` is relative (the dashboard). */
+export interface WebSocketLocation {
+    protocol: string;
+    host: string;
+}
+export interface TerminalAttachInfo {
+    url: string;
+    /** `['ninedeploy.terminal.v1', 'ninedeploy.ticket.<ticket>']`: the server selects the first, so the ticket is never echoed. */
+    protocols: string[];
+}
+/**
+ * The attach WebSocket URL for `baseUrl` (absolute, or relative to
+ * `location` / `globalThis.location`) and the v1 subprotocols.
+ */
+export declare function terminalAttachInfo(baseUrl: string, created: TerminalAttachSource, location?: WebSocketLocation): TerminalAttachInfo;
+/** A human sentence for an attach socket's close code. */
+export declare function terminalCloseMessage(code: number): string;
+/** The structural WebSocket the connection drives (browser `WebSocket`, Node's global one, or `ws`). */
+export interface TerminalSocketLike {
+    binaryType: string;
+    readyState: number;
+    send(data: string | Uint8Array): void;
+    close(code?: number, reason?: string): void;
+    onopen: ((event: unknown) => void) | null;
+    onmessage: ((event: {
+        data: unknown;
+    }) => void) | null;
+    onclose: ((event: {
+        code: number;
+        reason: string;
+    }) => void) | null;
+    onerror: ((event: unknown) => void) | null;
+}
+export type TerminalSocketFactory = (url: string, protocols: string[]) => TerminalSocketLike;
+export interface TerminalReady {
+    sessionId: number;
+    target: {
+        kind: TerminalTargetKind;
+        label: string;
+        serverId: number | null;
+    };
+}
+export interface TerminalHandlers {
+    /** The shell runs; input typed before this was held and is flushed now. */
+    onReady?: (ready: TerminalReady) => void;
+    /** Shell output. */
+    onData?: (bytes: Uint8Array) => void;
+    /** A server notice (why a session failed, an ignored control message). */
+    onNotice?: (message: string) => void;
+    /** The server's `exit` message: the shell's exit code (null when unknown) and the end reason. */
+    onExit?: (exit: {
+        code: number | null;
+        reason: string;
+    }) => void;
+    /** The socket closed; `message` explains the close code. */
+    onClose?: (close: {
+        code: number;
+        reason: string;
+        message: string;
+    }) => void;
+}
+export interface TerminalConnectOptions {
+    /** Defaults to `globalThis.WebSocket`. */
+    socketFactory?: TerminalSocketFactory;
+    /** For a relative `baseUrl` outside a browser page. */
+    location?: WebSocketLocation;
+    /** Keep-alive ping interval (ms); pings do not reset the idle timeout. 0 disables. Default 30s. */
+    pingIntervalMs?: number;
+}
+export interface TerminalConnection {
+    /** True once the server sent `ready`. */
+    readonly ready: boolean;
+    /** Send input (held until `ready`, then sent in frames below the server's cap). */
+    write: (data: string | Uint8Array) => void;
+    /** Resize the terminal (clamped to 10–500 × 5–200; the last size before `ready` is sent on `ready`). */
+    resize: (cols: number, rows: number) => void;
+    close: () => void;
+}
+/**
+ * Attach to a terminal session over protocol v1 (`ninedeploy.terminal.v1`).
+ *
+ * Binary frames carry input and output; text frames carry the JSON control
+ * messages. Input written before the server's `ready` is held (up to 64 KiB)
+ * and flushed on `ready`, because the server may drop input that arrives
+ * while it is still starting the shell.
+ */
+export declare function connectTerminal(info: TerminalAttachInfo, handlers?: TerminalHandlers, options?: TerminalConnectOptions): TerminalConnection;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/terminal.d.ts.map

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

package/dist/terminal.js

@@ -0,0 +1,180 @@
+import { NineDeployError } from './errors.js';
+/** Attach subprotocol (protocol v1) and the ticket's subprotocol prefix; mirror `@ninedeploy/schemas`. */
+export const TERMINAL_SUBPROTOCOL = 'ninedeploy.terminal.v1';
+export const TERMINAL_TICKET_PREFIX = 'ninedeploy.ticket.';
+/** The server closes a socket whose frame exceeds 64 KiB (1009); input is sent in smaller pieces. */
+export const TERMINAL_INPUT_CHUNK_BYTES = 32 * 1024;
+/** Input typed before the shell is `ready` is held, up to this many bytes. */
+export const TERMINAL_PENDING_INPUT_MAX = 64 * 1024;
+/**
+ * The attach WebSocket URL for `baseUrl` (absolute, or relative to
+ * `location` / `globalThis.location`) and the v1 subprotocols.
+ */
+export function terminalAttachInfo(baseUrl, created, location) {
+    if (!/^\/v1\/terminals\/\d+\/attach$/.test(created.attachPath)) {
+        throw new NineDeployError(0, 'invalid_path', `Not a terminal attach path: ${created.attachPath}`);
+    }
+    if (!/^[A-Za-z0-9_-]{16,128}$/.test(created.ticket)) {
+        throw new NineDeployError(0, 'invalid_ticket', 'The terminal ticket is malformed');
+    }
+    const base = baseUrl.replace(/\/+$/, '');
+    let url;
+    if (/^https?:\/\//i.test(base)) {
+        url = `${base.replace(/^http/i, 'ws')}${created.attachPath}`;
+    }
+    else {
+        const loc = location ?? globalThis.location;
+        if (!loc)
+            throw new NineDeployError(0, 'no_base_url', 'A relative baseUrl needs a page location to build a WebSocket URL');
+        const proto = loc.protocol === 'https:' ? 'wss' : 'ws';
+        url = `${proto}://${loc.host}${base}${created.attachPath}`;
+    }
+    return { url, protocols: [TERMINAL_SUBPROTOCOL, `${TERMINAL_TICKET_PREFIX}${created.ticket}`] };
+}
+/** A human sentence for an attach socket's close code. */
+export function terminalCloseMessage(code) {
+    switch (code) {
+        case 1000:
+            return 'The shell exited.';
+        case 1009:
+            return 'A message was too large (over 64 KiB), so the session was closed.';
+        case 4401:
+            return 'The session ticket was invalid or expired. Open a new terminal.';
+        case 4403:
+            return 'Access was refused: the session was revoked, or this page is not a panel origin.';
+        case 4408:
+            return 'The session was closed after being idle too long.';
+        case 4409:
+            return 'The session reached its maximum length.';
+        case 4410:
+            return 'An operator terminated this session.';
+        case 4429:
+            return 'Too many terminals are open. Close one and try again.';
+        case 4502:
+            return 'The target could not be reached.';
+        default:
+            return `The connection was lost (code ${code}).`;
+    }
+}
+const clamp = (n, min, max) => Math.min(max, Math.max(min, Math.round(n)));
+/** Timers and TextEncoder exist wherever the SDK runs; typed structurally (no DOM or Node lib types). */
+const runtime = globalThis;
+function defaultSocketFactory() {
+    const Ctor = globalThis.WebSocket;
+    if (!Ctor)
+        throw new NineDeployError(0, 'no_websocket', 'No WebSocket implementation is available; pass socketFactory');
+    return (url, protocols) => new Ctor(url, protocols);
+}
+function toBytes(data) {
+    if (data instanceof Uint8Array)
+        return data;
+    if (data instanceof ArrayBuffer)
+        return new Uint8Array(data);
+    const view = data;
+    return new Uint8Array(view.buffer, view.byteOffset, view.byteLength);
+}
+/**
+ * Attach to a terminal session over protocol v1 (`ninedeploy.terminal.v1`).
+ *
+ * Binary frames carry input and output; text frames carry the JSON control
+ * messages. Input written before the server's `ready` is held (up to 64 KiB)
+ * and flushed on `ready`, because the server may drop input that arrives
+ * while it is still starting the shell.
+ */
+export function connectTerminal(info, handlers = {}, options = {}) {
+    const factory = options.socketFactory ?? defaultSocketFactory();
+    const socket = factory(info.url, info.protocols);
+    socket.binaryType = 'arraybuffer';
+    const encoder = new runtime.TextEncoder();
+    let ready = false;
+    let closed = false;
+    let pending = [];
+    let pendingBytes = 0;
+    let size = null;
+    let ping;
+    const sendInput = (bytes) => {
+        for (let at = 0; at < bytes.length; at += TERMINAL_INPUT_CHUNK_BYTES) {
+            socket.send(bytes.subarray(at, at + TERMINAL_INPUT_CHUNK_BYTES));
+        }
+    };
+    const sendResize = (cols, rows) => socket.send(JSON.stringify({ t: 'resize', cols, rows }));
+    socket.onmessage = (event) => {
+        if (typeof event.data !== 'string') {
+            handlers.onData?.(toBytes(event.data));
+            return;
+        }
+        let msg;
+        try {
+            msg = JSON.parse(event.data);
+        }
+        catch {
+            return;
+        }
+        if (msg.t === 'ready') {
+            ready = true;
+            if (size)
+                sendResize(size.cols, size.rows);
+            const held = pending;
+            pending = [];
+            pendingBytes = 0;
+            for (const bytes of held)
+                sendInput(bytes);
+            handlers.onReady?.({ sessionId: msg.sessionId, target: msg.target });
+            const every = options.pingIntervalMs ?? 30_000;
+            if (every > 0) {
+                ping = runtime.setInterval(() => {
+                    if (!closed)
+                        socket.send(JSON.stringify({ t: 'ping' }));
+                }, every);
+            }
+        }
+        else if (msg.t === 'notice') {
+            handlers.onNotice?.(String(msg.message));
+        }
+        else if (msg.t === 'exit') {
+            handlers.onExit?.({ code: typeof msg.code === 'number' ? msg.code : null, reason: String(msg.reason) });
+        }
+    };
+    socket.onclose = (event) => {
+        closed = true;
+        ready = false;
+        runtime.clearInterval(ping);
+        handlers.onClose?.({ code: event.code, reason: event.reason, message: terminalCloseMessage(event.code) });
+    };
+    socket.onerror = () => {
+        /* the close event follows and carries the code */
+    };
+    return {
+        get ready() {
+            return ready;
+        },
+        write: (data) => {
+            if (closed)
+                return;
+            const bytes = typeof data === 'string' ? encoder.encode(data) : data;
+            if (bytes.length === 0)
+                return;
+            if (ready) {
+                sendInput(bytes);
+                return;
+            }
+            if (pendingBytes + bytes.length > TERMINAL_PENDING_INPUT_MAX)
+                return;
+            pending.push(bytes);
+            pendingBytes += bytes.length;
+        },
+        resize: (cols, rows) => {
+            size = { cols: clamp(cols, 10, 500), rows: clamp(rows, 5, 200) };
+            if (ready && !closed)
+                sendResize(size.cols, size.rows);
+        },
+        close: () => {
+            if (closed)
+                return;
+            closed = true;
+            runtime.clearInterval(ping);
+            socket.close(1000, 'client closed');
+        },
+    };
+}
+//# sourceMappingURL=terminal.js.map

package/dist/terminal.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Minimal structural fetch type so the SDK is isomorphic (browser + Node)
+ * without pulling in DOM lib types. Both `globalThis.fetch` implementations
+ * satisfy this shape.
+ */
+export type FetchLike = (input: string, init: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    credentials?: 'omit' | 'same-origin' | 'include';
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+    /** Optional so minimal fetch stand-ins stay assignable; a real fetch has it (F1010). */
+    headers?: {
+        get(name: string): string | null;
+    };
+}>;
+export interface NineDeployClientOptions {
+    /** Base URL of the NineDeploy API, e.g. http://localhost:3000. */
+    baseUrl: string;
+    /** Returns the current access token (or bearer credential). */
+    getToken?: () => string | undefined | null;
+    /**
+     * Per-request timeout in milliseconds. A stalled backend must not hang
+     * callers forever (worst in CI, where nothing is interactive to Ctrl-C).
+     * Defaults to 30_000; pass `0` to disable entirely.
+     */
+    timeoutMs?: number;
+    /** Custom fetch implementation (defaults to globalThis.fetch). */
+    fetch?: FetchLike;
+}
+export interface RequestInit {
+    method?: string;
+    credentials?: 'omit' | 'same-origin' | 'include';
+    headers?: Record<string, string>;
+    body?: unknown;
+    /**
+     * Propagated to fetch as-is. Typed structurally: the SDK compiles without
+     * DOM lib types, and only `AbortSignal.timeout()` ever produces one here.
+     */
+    signal?: unknown;
+    /** 0.14: a binary body, sent as-is (`application/octet-stream`). */
+    raw?: Uint8Array;
+    /** 0.14: keep a refusal's top-level `errors` / `warnings` as the error's `details`. */
+    findings?: boolean;
+}
+/** The request core every resource module calls through. */
+export interface Transport {
+    baseUrl: string;
+    requestWithHeaders<T>(path: string, init?: RequestInit, minTimeoutMs?: number): Promise<{
+        data: T;
+        header: (name: string) => string | null;
+    }>;
+    request<T>(path: string, init?: RequestInit, minTimeoutMs?: number): Promise<T>;
+    get<T>(path: string): Promise<T>;
+    send<T>(method: string, path: string, body?: unknown): Promise<T>;
+}
+export declare function createTransport(opts: NineDeployClientOptions): Transport;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;CAClD,KAAK,OAAO,CAAC;IACZ,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,wFAAwF;IACxF,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAChD,CAAC,CAAA;AAEJ,MAAM,WAAW,uBAAuB;IACtC,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC3C;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAKD,4DAA4D;AAC5D,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC9I,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChF,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACnE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,uBAAuB,GAAG,SAAS,CAuFxE"}