@ninedeploy/sdk 0.10.5 → 0.16.0

package/dist/resources/system.d.ts

@@ -0,0 +1,240 @@
+import type { ActivityEntry, AlertRule, CreateAlertRuleInput, DoctorFixRequestInput, DoctorFixResponse, DoctorReport, DemoSeedResult, DockerResources, MetricSeries, StatsSnapshot, TopologyGraph, UpdateCheckResult, SelfUpdateStatus, AutoPruneConfigUpdateInput, AutoPruneStatus, AutoPruneRunResult, PanelBackupObject, PanelBackupRestore, PanelBackupSettingsPatch, PanelBackupStatus } from '@ninedeploy/schemas';
+import type { HealthStatus, ImageInfo, PruneImagesInput, PruneImagesResult } from '../types.js';
+import type { Transport } from '../transport.js';
+export interface SystemApi {
+    system: {
+        resources: () => Promise<DockerResources>;
+        pruneImages: () => Promise<{
+            ok: boolean;
+        }>;
+        exportUrl: () => string;
+        /** Latest-release check (admin). updateAvailable is null when offline/disabled. */
+        updateCheck: (force?: boolean) => Promise<UpdateCheckResult>;
+        /** State of a panel-initiated upgrade (idle/running/success/failed/unsupported). */
+        updateStatus: () => Promise<SelfUpdateStatus>;
+        /**
+         * Start upgrading the panel itself to an exact release tag; the updater survives the restart it performs.
+         * Refused with 409 `deploys_in_flight` while deployments are executing unless `force` is set (r572).
+         */
+        updateStart: (version: string, opts?: {
+            force?: boolean;
+        }) => Promise<{
+            ok: boolean;
+        }>;
+        /** Recent docker daemon events (single-shot, for the Docker dashboard feed). */
+        dockerEvents: (minutes?: number) => Promise<{
+            events: Array<{
+                time: string;
+                type: string;
+                action: string;
+                name: string;
+            }>;
+        }>;
+        /**
+         * Panel self-backup (0.12, operator-only): the `/system/export` archive sealed with a
+         * recovery passphrase and written to a backup destination on a schedule.
+         */
+        panelBackup: {
+            /** Settings, last run, next run (passphrase never returned — only `hasPassphrase`). */
+            get: () => Promise<PanelBackupStatus>;
+            /** Omitted fields keep their stored value; `passphrase` omitted = keep the stored one. */
+            update: (input: PanelBackupSettingsPatch) => Promise<PanelBackupStatus>;
+            /** "Back up now": starts a run in the background (409 while one is running); poll `get()`. */
+            run: () => Promise<{
+                ok: boolean;
+                started: boolean;
+            }>;
+            /** Panel backups in a destination (default: the configured one), newest first. */
+            list: (destinationId?: number) => Promise<{
+                destinationId: number;
+                items: PanelBackupObject[];
+            }>;
+            /**
+             * DESTRUCTIVE: replaces this panel's database, master key, .env and Traefik config with
+             * the backup's. `confirm` must repeat the object's file name. Restart the panel afterwards.
+             */
+            restore: (input: PanelBackupRestore) => Promise<{
+                ok: boolean;
+                message: string;
+                meta: unknown;
+                backupPath: string;
+            }>;
+        };
+    };
+    health: () => Promise<HealthStatus>;
+    about: {
+        get: () => Promise<{
+            name: string;
+            version: string;
+            description: string;
+            license: string;
+            repo: string;
+            docs: string;
+            techStack: Array<{
+                category: string;
+                items: string[];
+            }>;
+            changelog: Array<{
+                version: string;
+                date: string;
+                title: string;
+                changes: string[];
+            }>;
+            /** Instance counts are only returned for authenticated requests. */
+            stats?: {
+                services: number;
+                databases: number;
+                deployments: number;
+                users: number;
+            };
+        }>;
+    };
+    dashboard: {
+        get: () => Promise<{
+            stats: {
+                services: number;
+                databases: number;
+                deployments: number;
+                domains: number;
+                webhooks: number;
+                running: number;
+                stopped: number;
+                errored: number;
+                dbRunning: number; /** Whole-node count — operators only, null for members (r470). */
+                containers: number | null;
+            };
+            health: Array<{
+                serviceId: number;
+                name: string;
+                slug: string;
+                type: string;
+                status: string;
+                healthy: boolean | null;
+                responseMs: number | null;
+                port: number | null;
+                runtimeId: string | null;
+                commitSha: string | null;
+                lastDeploy: string | null;
+            }>;
+            recentDeploys: Array<{
+                id: number;
+                serviceId: number;
+                serviceName: string;
+                status: string;
+                commitSha: string | null;
+                message: string | null;
+                trigger: string;
+                finishedAt: string | null;
+                createdAt: string;
+            }>;
+        }>;
+    };
+    stats: {
+        snapshot: () => Promise<StatsSnapshot>;
+        metrics: (serviceId: number, opts?: {
+            kind?: 'cpu' | 'memory';
+            minutes?: number;
+        }) => Promise<MetricSeries>;
+    };
+    topology: {
+        get: () => Promise<TopologyGraph>;
+    };
+    activity: {
+        /**
+         * Filter + paginate the audit trail. Omitted filters return the newest page.
+         * `entity` matches the bare name and `<name> #<id>`; `serviceId` (with the
+         * service name as `entity`) narrows to one service's trail.
+         */
+        list: (query?: {
+            entity?: string;
+            serviceId?: number;
+            action?: string;
+            userId?: number;
+            before?: number;
+        }) => Promise<{
+            entries: ActivityEntry[];
+            nextCursor: number | null;
+        }>;
+    };
+    alerts: {
+        list: () => Promise<AlertRule[]>;
+        create: (input: CreateAlertRuleInput) => Promise<AlertRule>;
+        update: (id: number, input: Partial<CreateAlertRuleInput>) => Promise<AlertRule>;
+        remove: (id: number) => Promise<void>;
+    };
+    metricHistory: {
+        /** Current configuration snapshot (backend choice, enabled flag, retention, last-flush). */
+        get: () => Promise<{
+            enabled: boolean;
+            backend: 'builtin' | 'prometheus' | 'influxdb';
+            events: string[];
+            retentionDays: number;
+            lastFlush: {
+                ts: number;
+                backend: string;
+                count: number;
+            };
+        }>;
+        /** Run the built-in backend's retention sweep. Returns the row count trimmed. */
+        flush: () => Promise<{
+            ok: boolean;
+            backend: 'builtin';
+            deleted: number;
+        }>;
+    };
+    buildCache: {
+        /** Per-backend counters + merged totals. G-01 PR-A. */
+        stats: () => Promise<{
+            backends: Array<{
+                name: string;
+                entries: number;
+                totalBytes: number;
+                hits: number;
+                misses: number;
+                stores: number;
+                evictions: number;
+            }>;
+            totals: {
+                entries: number;
+                totalBytes: number;
+                hits: number;
+                misses: number;
+                stores: number;
+                evictions: number;
+            };
+        }>;
+    };
+    housekeeping: {
+        getAutoPrune: () => Promise<AutoPruneStatus>;
+        updateAutoPrune: (input: AutoPruneConfigUpdateInput) => Promise<AutoPruneStatus>;
+        runPrune: () => Promise<AutoPruneRunResult>;
+        /**
+         * List every image on the host with repo / tag / size /
+         * created / dangling / inUse metadata. The companion to
+         * the auto-prune cron: this is what the operator
+         * inspects before `pruneImages({ keepLast: 5 })`.
+         */
+        listImages: () => Promise<{
+            images: ImageInfo[];
+            totalCount: number;
+            totalBytes: number;
+        }>;
+        /**
+         * Prune images with operator-supplied filters. `dryRun`
+         * returns the candidate set without deleting. Refused
+         * when no filter is supplied (a naked prune would
+         * delete every unused image).
+         */
+        pruneImages: (input: PruneImagesInput) => Promise<PruneImagesResult>;
+    };
+    /** Host-wide analysis + guarded cleanup. */
+    doctor: {
+        scan: () => Promise<DoctorReport>;
+        fix: (input: DoctorFixRequestInput) => Promise<DoctorFixResponse>;
+    };
+    demo: {
+        seed: () => Promise<DemoSeedResult>;
+    };
+}
+export declare function systemApi(t: Transport): SystemApi;
+//# sourceMappingURL=system.d.ts.map

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

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

package/dist/resources/system.js

@@ -0,0 +1,86 @@
+export function systemApi(t) {
+    const { get, send, request } = t;
+    return {
+        system: {
+            resources: () => get('/v1/system/resources'),
+            pruneImages: () => send('POST', '/v1/system/prune-images'),
+            updateCheck: (force) => get(`/v1/system/update-check${force ? '?force=1' : ''}`),
+            updateStatus: () => get('/v1/system/update-status'),
+            updateStart: (version, opts) => send('POST', '/v1/system/update-start', { version, ...opts }),
+            exportUrl: () => '/v1/system/export',
+            dockerEvents: (minutes) => get(`/v1/system/docker-events?minutes=${minutes ?? 60}`),
+            panelBackup: {
+                get: () => get('/v1/system/panel-backup'),
+                update: (input) => send('PUT', '/v1/system/panel-backup', input),
+                run: () => send('POST', '/v1/system/panel-backup/run'),
+                list: (destinationId) => get(`/v1/system/panel-backup/remote${destinationId != null ? `?destinationId=${destinationId}` : ''}`),
+                restore: (input) => send('POST', '/v1/system/panel-backup/restore', input),
+            },
+        },
+        health: () => get('/health'),
+        about: {
+            get: () => get('/v1/about'),
+        },
+        dashboard: {
+            get: () => get('/v1/dashboard'),
+        },
+        stats: {
+            snapshot: () => get('/v1/stats'),
+            metrics: (serviceId, opts) => get(`/v1/services/${serviceId}/metrics?kind=${opts?.kind ?? 'cpu'}&minutes=${opts?.minutes ?? 60}`),
+        },
+        topology: {
+            get: () => get('/v1/topology'),
+        },
+        activity: {
+            list: (query) => {
+                const parts = [];
+                if (query?.entity)
+                    parts.push(`entity=${encodeURIComponent(query.entity)}`);
+                if (query?.serviceId)
+                    parts.push(`serviceId=${query.serviceId}`);
+                if (query?.action)
+                    parts.push(`action=${encodeURIComponent(query.action)}`);
+                if (query?.userId)
+                    parts.push(`userId=${query.userId}`);
+                if (query?.before)
+                    parts.push(`before=${query.before}`);
+                const qs = parts.join('&');
+                return get(`/v1/activity${qs ? `?${qs}` : ''}`);
+            },
+        },
+        alerts: {
+            list: () => get('/v1/alerts'),
+            create: (input) => send('POST', '/v1/alerts', input),
+            update: (id, input) => send('PATCH', `/v1/alerts/${id}`, input),
+            remove: async (id) => {
+                await request(`/v1/alerts/${id}`, { method: 'DELETE' });
+            },
+        },
+        metricHistory: {
+            get: () => get('/v1/metric-history'),
+            flush: () => send('POST', '/v1/metric-history/flush'),
+        },
+        buildCache: {
+            stats: () => get('/v1/build-cache/stats'),
+        },
+        housekeeping: {
+            getAutoPrune: () => get('/v1/housekeeping/prune/config'),
+            updateAutoPrune: (input) => send('PATCH', '/v1/housekeeping/prune/config', input),
+            runPrune: () => send('POST', '/v1/housekeeping/prune'),
+            listImages: () => get('/v1/housekeeping/images'),
+            pruneImages: (input) => send('POST', '/v1/housekeeping/images/prune', input),
+        },
+        doctor: {
+            /** Full host scan: dead containers, orphan volumes/networks, row-vs-runtime
+             *  desyncs, dangling images, disk pressure — with guarded repair actions. */
+            scan: () => get('/v1/doctor'),
+            /** Execute one finding's repair. The server re-scans and re-locates the
+             *  finding first; a stale finding answers 409 instead of acting. */
+            fix: (input) => send('POST', '/v1/doctor/fix', input),
+        },
+        demo: {
+            seed: () => send('POST', '/v1/demo/seed'),
+        },
+    };
+}
+//# sourceMappingURL=system.js.map

package/dist/resources/system.js.map

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

package/dist/resources/templates.d.ts

@@ -0,0 +1,36 @@
+import type { DeployTemplateInput, Template, TemplateSummary, CommunityTemplateListResult } from '@ninedeploy/schemas';
+import type { TemplateDeployResult, TemplatePrepareResult } from '../types.js';
+import type { Transport } from '../transport.js';
+export interface TemplatesApi {
+    templates: {
+        list: () => Promise<TemplateSummary[]>;
+        get: (id: string) => Promise<Template>;
+        prepare: (id: string, input?: DeployTemplateInput) => Promise<TemplatePrepareResult>;
+        deploy: (id: string, input?: DeployTemplateInput) => Promise<TemplateDeployResult>;
+        /**
+         * Community contributions (G-13). The `list` call
+         * already merges community entries with the curated
+         * catalog; the dedicated `community` namespace lets
+         * the panel surface errors and the operator import
+         * a new template from a PR comment or a file.
+         */
+        community: {
+            list: () => Promise<CommunityTemplateListResult>;
+            import: (content: string, opts?: {
+                replace?: boolean;
+            }) => Promise<{
+                ok: boolean;
+                id: string;
+                file: string;
+                bytes: number;
+            }>;
+            remove: (id: string) => Promise<{
+                ok: boolean;
+                id: string;
+                removed: boolean;
+            }>;
+        };
+    };
+}
+export declare function templatesApi(t: Transport): TemplatesApi;
+//# sourceMappingURL=templates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/resources/templates.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,QAAQ,EACR,eAAe,EACf,2BAA2B,EAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;QACvC,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;QACrF,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACnF;;;;;;WAMG;QACH,SAAS,EAAE;YACT,IAAI,EAAE,MAAM,OAAO,CAAC,2BAA2B,CAAC,CAAC;YACjD,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;gBAAE,OAAO,CAAC,EAAE,OAAO,CAAA;aAAE,KAAK,OAAO,CAAC;gBAAE,EAAE,EAAE,OAAO,CAAC;gBAAC,EAAE,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YAC7H,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;gBAAE,EAAE,EAAE,OAAO,CAAC;gBAAC,EAAE,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,OAAO,CAAA;aAAE,CAAC,CAAC;SAChF,CAAC;KACH,CAAC;CACH;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,GAAG,YAAY,CAqBvD"}

package/dist/resources/templates.js

@@ -0,0 +1,17 @@
+export function templatesApi(t) {
+    const { get, send } = t;
+    return {
+        templates: {
+            list: () => get('/v1/templates'),
+            get: (id) => get(`/v1/templates/${encodeURIComponent(id)}`),
+            prepare: (id, input) => send('POST', `/v1/templates/${encodeURIComponent(id)}/prepare`, input ?? {}),
+            deploy: (id, input) => send('POST', `/v1/templates/${encodeURIComponent(id)}/deploy`, input ?? {}),
+            community: {
+                list: () => get('/v1/templates/community'),
+                import: (content, opts) => send('POST', '/v1/templates/community/import', { content, ...(opts ?? {}) }),
+                remove: (id) => send('DELETE', `/v1/templates/community/${encodeURIComponent(id)}`),
+            },
+        },
+    };
+}
+//# sourceMappingURL=templates.js.map

package/dist/resources/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/resources/templates.ts"],"names":[],"mappings":"AAiCA,MAAM,UAAU,YAAY,CAAC,CAAY;IACvC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IACxB,OAAO;QACL,SAAS,EAAE;YACT,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAoB,eAAe,CAAC;YACnD,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAW,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;YACrE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAwB,MAAM,EAAE,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC;YAC3H,MAAM,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAuB,MAAM,EAAE,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC;YACxH,SAAS,EAAE;gBACT,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAA8B,yBAAyB,CAAC;gBACvE,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CACxB,IAAI,CACF,MAAM,EACN,gCAAgC,EAChC,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAC7B;gBACH,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CACb,IAAI,CAAgD,QAAQ,EAAE,2BAA2B,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;aACrH;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/resources/terminals.d.ts

@@ -0,0 +1,60 @@
+import type { CreateTerminalSessionInput, ServiceTrafficSummary, TerminalSession, TerminalSessionCreated, TerminalSessionList, TerminalSettingsInput, TerminalSettingsView, TerminalTerminateResult, TrafficSettingsUpdate, TrafficSettingsView, TrafficSummary } from '@ninedeploy/schemas';
+import { type ApiQuery } from '../apiPath.js';
+import { type TerminalAttachSource, type WebSocketLocation, type TerminalAttachInfo, type TerminalHandlers, type TerminalConnectOptions, type TerminalConnection } from '../terminal.js';
+import type { TerminalListQuery, TrafficQuery } from '../types.js';
+import type { Transport } from '../transport.js';
+export interface TerminalsApi {
+    /**
+     * Interactive terminals (0.15, operator only). A session is created over
+     * HTTP and attached over a WebSocket with its single-use ticket (valid 30s).
+     * Host shells (`target.kind: 'host'`) are off by default and need an
+     * interactive session plus the account password in `password`.
+     */
+    terminals: {
+        create: (input: CreateTerminalSessionInput) => Promise<TerminalSessionCreated>;
+        /** History, newest first; page back with `before: list.nextBefore`. */
+        list: (query?: TerminalListQuery) => Promise<TerminalSessionList>;
+        get: (id: number) => Promise<TerminalSession>;
+        /** Close a live session (close 4410) or revoke a pending ticket. */
+        terminate: (id: number) => Promise<TerminalTerminateResult>;
+        settings: {
+            get: () => Promise<TerminalSettingsView>;
+            /** Partial. Turning host shells on needs `password` (step-up). */
+            set: (input: TerminalSettingsInput) => Promise<TerminalSettingsView>;
+        };
+        /** The WebSocket URL and subprotocols that attach a created session. */
+        attachInfo: (created: TerminalAttachSource, location?: WebSocketLocation) => TerminalAttachInfo;
+        /** Attach a created session over protocol v1 (see `connectTerminal`). */
+        connect: (created: TerminalAttachSource, handlers?: TerminalHandlers, options?: TerminalConnectOptions) => TerminalConnection;
+    };
+    /** Traffic analytics (0.15, opt-in). Settings and the summary are operator only. */
+    traffic: {
+        settings: {
+            get: () => Promise<TrafficSettingsView>;
+            /**
+             * Enabling or disabling recreates Traefik once (about 1–2s of refused
+             * connections). A browser behind Traefik may lose this response; read
+             * `settings.get()` again on a network error.
+             */
+            set: (input: TrafficSettingsUpdate) => Promise<TrafficSettingsView>;
+        };
+        summary: (query?: TrafficQuery) => Promise<TrafficSummary>;
+        /** One service's series (any seat on the service). Empty series, never 404, without data. */
+        service: (serviceId: number, query?: TrafficQuery) => Promise<ServiceTrafficSummary>;
+    };
+    /**
+     * Raw access to the documented API (0.15, see `GET /v1/openapi.json`).
+     * Read-only on purpose: there is no generic write method. The generated MCP
+     * read tools call through here.
+     */
+    api: {
+        /**
+         * GET any `/v1/…` route. The path must match `^/v1/[A-Za-z0-9/_.-]+$` and
+         * may not contain a `..` segment; query values are URL-encoded and
+         * `undefined` values are dropped.
+         */
+        get: <T = unknown>(path: `/v1/${string}`, query?: ApiQuery) => Promise<T>;
+    };
+}
+export declare function terminalsApi(t: Transport): TerminalsApi;
+//# sourceMappingURL=terminals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminals.d.ts","sourceRoot":"","sources":["../../src/resources/terminals.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,0BAA0B,EAC1B,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAuC,KAAK,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC9N,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,WAAW,YAAY;IAG3B;;;;;OAKG;IACH,SAAS,EAAE;QACT,MAAM,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;QAC/E,uEAAuE;QACvE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAClE,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;QAC9C,oEAAoE;QACpE,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;QAC5D,QAAQ,EAAE;YACR,GAAG,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAC;YACzC,kEAAkE;YAClE,GAAG,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;SACtE,CAAC;QACF,wEAAwE;QACxE,UAAU,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,QAAQ,CAAC,EAAE,iBAAiB,KAAK,kBAAkB,CAAC;QAChG,yEAAyE;QACzE,OAAO,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,QAAQ,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,sBAAsB,KAAK,kBAAkB,CAAC;KAC/H,CAAC;IACF,oFAAoF;IACpF,OAAO,EAAE;QACP,QAAQ,EAAE;YACR,GAAG,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;YACxC;;;;eAIG;YACH,GAAG,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;SACrE,CAAC;QACF,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;QAC3D,6FAA6F;QAC7F,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;KACtF,CAAC;IAEF;;;;OAIG;IACH,GAAG,EAAE;QACH;;;;WAIG;QACH,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;KAC3E,CAAC;CACH;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,GAAG,YAAY,CAiCvD"}

package/dist/resources/terminals.js

@@ -0,0 +1,35 @@
+import { apiGetUrl } from '../apiPath.js';
+import { terminalAttachInfo, connectTerminal } from '../terminal.js';
+export function terminalsApi(t) {
+    const { get, send, baseUrl } = t;
+    return {
+        // ── end 0.15 T4 ──
+        // ── 0.15 T6 surfaces ──
+        terminals: {
+            create: (input) => send('POST', '/v1/terminals', input),
+            list: (query) => get(apiGetUrl('/v1/terminals', { ...query })),
+            get: (id) => get(`/v1/terminals/${id}`),
+            terminate: (id) => send('DELETE', `/v1/terminals/${id}`),
+            settings: {
+                get: () => get('/v1/terminals/settings'),
+                set: (input) => send('PUT', '/v1/terminals/settings', input),
+            },
+            attachInfo: (created, location) => terminalAttachInfo(baseUrl, created, location),
+            connect: (created, handlers, options) => connectTerminal(terminalAttachInfo(baseUrl, created, options?.location), handlers, options),
+        },
+        traffic: {
+            settings: {
+                get: () => get('/v1/traffic/settings'),
+                set: (input) => send('PUT', '/v1/traffic/settings', input),
+            },
+            summary: (query) => get(apiGetUrl('/v1/traffic/summary', { ...query })),
+            service: (serviceId, query) => get(apiGetUrl(`/v1/services/${serviceId}/traffic`, { ...query })),
+        },
+        // ── 0.15 T4 api ──
+        api: {
+            // async: a refused path rejects like any other failed call, never throws synchronously.
+            get: async (path, query) => get(apiGetUrl(path, query)),
+        },
+    };
+}
+//# sourceMappingURL=terminals.js.map

package/dist/resources/terminals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminals.js","sourceRoot":"","sources":["../../src/resources/terminals.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,SAAS,EAAiB,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAA2J,MAAM,gBAAgB,CAAC;AA6D9N,MAAM,UAAU,YAAY,CAAC,CAAY;IACvC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IACjC,OAAO;QACL,oBAAoB;QACpB,yBAAyB;QACzB,SAAS,EAAE;YACT,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAyB,MAAM,EAAE,eAAe,EAAE,KAAK,CAAC;YAC/E,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAsB,SAAS,CAAC,eAAe,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;YACnF,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAkB,iBAAiB,EAAE,EAAE,CAAC;YACxD,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAA0B,QAAQ,EAAE,iBAAiB,EAAE,EAAE,CAAC;YACjF,QAAQ,EAAE;gBACR,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAuB,wBAAwB,CAAC;gBAC9D,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAuB,KAAK,EAAE,wBAAwB,EAAE,KAAK,CAAC;aACnF;YACD,UAAU,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC;YACjF,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CACtC,eAAe,CAAC,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC;SAC9F;QACD,OAAO,EAAE;YACP,QAAQ,EAAE;gBACR,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAsB,sBAAsB,CAAC;gBAC3D,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAsB,KAAK,EAAE,sBAAsB,EAAE,KAAK,CAAC;aAChF;YACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAiB,SAAS,CAAC,qBAAqB,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;YACvF,OAAO,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAC5B,GAAG,CAAwB,SAAS,CAAC,gBAAgB,SAAS,UAAU,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;SAC3F;QACD,oBAAoB;QACpB,GAAG,EAAE;YACH,wFAAwF;YACxF,GAAG,EAAE,KAAK,EAAe,IAAqB,EAAE,KAAgB,EAAE,EAAE,CAAC,GAAG,CAAI,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;SACpG;KACF,CAAC;AACJ,CAAC"}

package/dist/resources/traefik.d.ts

@@ -0,0 +1,84 @@
+import type { TraefikCertificate, CertificateInventoryEntry, CertificateInventoryReport, TraefikInfo, TraefikStatus, TraefikCustomConfig, TraefikCustomConfigApplied, TraefikCustomConfigValidation, CustomCertificate, CustomCertificateReplace, CustomCertificateSaved, CustomCertificateUpload } from '@ninedeploy/schemas';
+import type { TraefikVersionInfo, TraefikRoutingConfig } from '../types.js';
+import type { Transport } from '../transport.js';
+export interface TraefikApi {
+    traefik: {
+        get: () => Promise<TraefikInfo>;
+        status: () => Promise<TraefikStatus>;
+        certificates: () => Promise<TraefikCertificate[]>;
+        /**
+         * Richer certificate inventory (G-15). Same
+         * underlying data as `certificates()` but adds a
+         * `status` classification (valid / expiring-soon /
+         * expired), a `summary` block, and the full set of
+         * fields the Certificates page renders.
+         * `threshold` is the days-out cutoff for the
+         * `expiring-soon` bucket; default 30.
+         */
+        certificateInventory: (opts?: {
+            threshold?: number;
+        }) => Promise<CertificateInventoryReport>;
+        /**
+         * Focused "expiring within N days" filter. Default
+         * 30. Used by the alert engine and by the panel's
+         * "About to expire" widget.
+         */
+        expiringCertificates: (opts?: {
+            days?: number;
+        }) => Promise<{
+            threshold: number;
+            count: number;
+            certificates: CertificateInventoryEntry[];
+        }>;
+        logs: (lines?: number) => Promise<{
+            logs: string[];
+        }>;
+        restart: () => Promise<{
+            ok: boolean;
+            message?: string;
+        }>;
+        /** r334: the server answers the host path of the copied acme.json. */
+        backupCerts: () => Promise<{
+            ok: boolean;
+            backupPath: string;
+        }>;
+        /** r557: routers / services / middlewares from the dynamic config (operator-only). */
+        config: () => Promise<TraefikRoutingConfig>;
+        /** r557: running vs latest Traefik version (operator-only). */
+        version: () => Promise<TraefikVersionInfo>;
+        /**
+         * r557: pull the pinned Traefik image and recreate the proxy container
+         * (operator-only). An image pull outlasts the default request budget, so
+         * this call allows up to 10 minutes unless the client disabled timeouts.
+         */
+        update: () => Promise<{
+            ok: boolean;
+            newVersion: string | null;
+        }>;
+        /**
+         * 0.14: the operator's custom dynamic config (`custom.yml`). `set` throws
+         * a NineDeployError whose `details` is `{ errors, warnings }` on a refusal.
+         */
+        customConfig: {
+            get: () => Promise<TraefikCustomConfig>;
+            /** No state change. */
+            validate: (content: string) => Promise<TraefikCustomConfigValidation>;
+            set: (content: string) => Promise<TraefikCustomConfigApplied>;
+            clear: () => Promise<{
+                ok: boolean;
+                cleared: boolean;
+            }>;
+        };
+        /** 0.14: uploaded TLS certificates (operator-only). No response carries a private key. */
+        customCertificates: {
+            list: () => Promise<CustomCertificate[]>;
+            upload: (input: CustomCertificateUpload) => Promise<CustomCertificateSaved>;
+            replace: (id: number, input: CustomCertificateReplace) => Promise<CustomCertificateSaved>;
+            delete: (id: number) => Promise<{
+                ok: boolean;
+            }>;
+        };
+    };
+}
+export declare function traefikApi(t: Transport): TraefikApi;
+//# sourceMappingURL=traefik.d.ts.map

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

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