@ninedeploy/sdk 0.10.5 → 0.16.0

package/dist/index.js

@@ -1,643 +1,11 @@
-import { NineDeployError } from './errors.js';
-export { NineDeployError };
+// @ninedeploy/sdk public entry. Every name below is part of the published API;
+// the implementation lives in the modules it re-exports from (resources/*.ts
+// hold one client surface each, client.ts composes them).
+export { NineDeployError } from './errors.js';
 export { detectProjectKind, formatManifestYaml, ManifestParseError, ManifestValidationError, parseManifestYaml, starterManifest, buildManifestFromTemplate, } from './manifest.js';
-const NO_FETCH = () => Promise.reject(new NineDeployError(0, 'no_fetch', 'No fetch implementation is available'));
-/**
- * Create a typed NineDeploy API client. Used by both the web dashboard and the CLI.
- *
- * @example
- * const client = createClient({ baseUrl: 'http://localhost:3000', getToken: () => token });
- * const services = await client.services.list();
- */
-export function createClient(opts) {
-    const baseUrl = opts.baseUrl.replace(/\/$/, '');
-    const fetchImpl = opts.fetch ?? (globalThis.fetch ?? NO_FETCH);
-    /** Default per-request budget when the caller does not configure one. */
-    const DEFAULT_TIMEOUT_MS = 30_000;
-    async function request(path, init = {}) {
-        const token = opts.getToken?.();
-        const headers = { ...(init.headers ?? {}) };
-        if (token)
-            headers['Authorization'] = `Bearer ${token}`;
-        if (init.body !== undefined && headers['Content-Type'] === undefined) {
-            headers['Content-Type'] = 'application/json';
-        }
-        const body = init.body === undefined ? undefined : JSON.stringify(init.body);
-        const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-        // AbortSignal.timeout exists everywhere the SDK runs (Node 17.3+, all
-        // modern browsers); it is resolved off globalThis and attached opaquely —
-        // FetchLike's shape stays untouched (widening it with `signal: unknown`
-        // breaks assigning a real `typeof fetch` at the call sites).
-        const out = {
-            method: init.method ?? 'GET',
-            headers,
-            body,
-        };
-        if (init.credentials !== undefined)
-            out.credentials = init.credentials;
-        if (timeoutMs > 0) {
-            const abort = globalThis.AbortSignal;
-            if (abort)
-                out.signal = abort.timeout(timeoutMs);
-        }
-        const res = await fetchImpl(`${baseUrl}${path}`, out);
-        const text = await res.text();
-        // Guard the parse: proxies (HTML 502 pages, empty bodies) must surface as a
-        // typed error, not an opaque SyntaxError.
-        let parsed;
-        try {
-            parsed = text ? JSON.parse(text) : undefined;
-        }
-        catch {
-            parsed = undefined;
-        }
-        if (!res.ok) {
-            if (parsed === undefined)
-                throw new NineDeployError(res.status, 'http_error', `Request failed (${res.status})`);
-            throw NineDeployError.fromBody(res.status, parsed);
-        }
-        // An ok response with an empty/unparseable body (204s, HTML pages from a
-        // misconfigured proxy) must never resolve to `undefined` — query functions
-        // built on this client would crash TanStack Query ("Query data cannot be
-        // undefined"). Empty 2xx bodies resolve to {}; non-JSON bodies surface as
-        // a typed error so callers see the real problem instead of a crash.
-        if (parsed === undefined) {
-            if (text === '')
-                return {};
-            throw new NineDeployError(res.status, 'invalid_response', `Expected JSON but received a non-JSON body (status ${res.status})`);
-        }
-        return parsed;
-    }
-    const get = (path) => request(path);
-    const send = (method, path, body) => request(path, { method, body });
-    return {
-        auth: {
-            status: () => get('/v1/auth/status'),
-            introspectToken: () => get('/v1/auth/token'),
-            setup: (input) => send('POST', '/v1/setup', input),
-            register: (input) => send('POST', '/v1/auth/register', input),
-            login: (input) => send('POST', '/v1/auth/login', input),
-            refresh: (input) => send('POST', '/v1/auth/refresh', input),
-            /** Revoke this user's outstanding JWTs server-side (tokenVersion bump). */
-            logout: () => send('POST', '/v1/auth/logout', {}),
-            changePassword: (input) => send('POST', '/v1/auth/password', input),
-            forgotPassword: (email) => send('POST', '/v1/auth/forgot-password', { email }),
-            resetPasswordWithToken: (input) => send('POST', '/v1/auth/reset-password', input),
-            twoFactor: {
-                setup: (input) => send('POST', '/v1/auth/2fa/setup', input ?? {}),
-                enable: (code) => send('POST', '/v1/auth/2fa/enable', { code }),
-                disable: (input) => send('POST', '/v1/auth/2fa/disable', input),
-            },
-            me: () => get('/v1/auth/me'),
-            tokens: {
-                create: (input) => send('POST', '/v1/auth/tokens', input ?? {}),
-                list: () => get('/v1/auth/tokens'),
-                remove: async (id) => {
-                    await request(`/v1/auth/tokens/${id}`, { method: 'DELETE' });
-                },
-            },
-            passkeys: {
-                registerOptions: () => send('POST', '/v1/auth/passkey/register/options'),
-                registerVerify: (input) => send('POST', '/v1/auth/passkey/register/verify', {
-                    name: input.name,
-                    response: input.response,
-                }),
-                list: () => get('/v1/auth/passkey'),
-                remove: async (id) => {
-                    await request(`/v1/auth/passkey/${id}`, { method: 'DELETE' });
-                },
-                loginOptions: () => send('POST', '/v1/auth/passkey/login/options'),
-                loginVerify: (response) => send('POST', '/v1/auth/passkey/login/verify', { response: response }),
-            },
-            sessions: {
-                list: () => get('/v1/auth/sessions'),
-                revoke: (id) => send('DELETE', `/v1/auth/sessions/${id}`),
-            },
-            oidc: {
-                publicProviders: () => get('/v1/auth/oidc/providers/public'),
-                link: (slug) => request(`/v1/auth/oidc/${encodeURIComponent(slug)}/link`, { method: 'POST', credentials: 'include' }),
-                listProviders: () => get('/v1/auth/oidc/providers'),
-                list: () => get('/v1/auth/oidc/providers'),
-                createProvider: (input) => send('POST', '/v1/auth/oidc/providers', input),
-                create: (input) => send('POST', '/v1/auth/oidc/providers', input),
-                updateProvider: (id, input) => send('PATCH', `/v1/auth/oidc/providers/${id}`, input),
-                update: (id, input) => send('PATCH', `/v1/auth/oidc/providers/${id}`, input),
-                deleteProvider: (id) => send('DELETE', `/v1/auth/oidc/providers/${id}`),
-                delete: (id) => send('DELETE', `/v1/auth/oidc/providers/${id}`),
-                callback: (slug, payload) => send('POST', `/v1/auth/oidc/${slug}/callback`, payload),
-            },
-        },
-        workspaces: {
-            list: () => get('/v1/workspaces'),
-            get: (id) => get(`/v1/workspaces/${id}`),
-            create: (input) => send('POST', '/v1/workspaces', input),
-            update: (id, input) => send('PATCH', `/v1/workspaces/${id}`, input),
-            delete: (id) => send('DELETE', `/v1/workspaces/${id}`),
-            addMember: (id, input) => send('POST', `/v1/workspaces/${id}/members`, input),
-            inviteMember: (id, input) => send('POST', `/v1/workspaces/${id}/invitations`, input),
-            listInvitations: (id) => get(`/v1/workspaces/${id}/invitations`),
-            revokeInvitation: (id, inviteId) => send('DELETE', `/v1/workspaces/${id}/invitations/${inviteId}`),
-            previewInvitation: (token) => get(`/v1/invitations/${token}`),
-            acceptInvitation: (token) => send('POST', `/v1/invitations/${token}/accept`),
-            updateMemberRole: (id, memberId, input) => send('PATCH', `/v1/workspaces/${id}/members/${memberId}`, input),
-            removeMember: (id, memberId) => send('DELETE', `/v1/workspaces/${id}/members/${memberId}`),
-        },
-        services: {
-            list: (query) => get(`/v1/services${query ?? ''}`),
-            get: (id) => get(`/v1/services/${id}`),
-            create: (input) => send('POST', '/v1/services', input),
-            update: (id, input) => send('PATCH', `/v1/services/${id}`, input),
-            composePreview: (input) => send('POST', '/v1/services/compose/preview', input),
-            remove: async (id) => {
-                await request(`/v1/services/${id}`, { method: 'DELETE' });
-            },
-            stop: (id) => send('POST', `/v1/services/${id}/stop`),
-            start: (id) => send('POST', `/v1/services/${id}/start`),
-            restart: (id) => send('POST', `/v1/services/${id}/restart`),
-            logs: (id) => get(`/v1/services/${id}/logs`),
-            clone: (id, input) => send('POST', `/v1/services/${id}/clone`, input ?? {}),
-            exportUrl: (id) => `/v1/services/${id}/export`,
-            importBundle: (bundle) => send('POST', '/v1/services/import', bundle),
-            manifest: {
-                apply: (serviceId, input) => send('POST', `/v1/services/${serviceId}/manifest/apply`, input),
-            },
-        },
-        labels: {
-            list: (query) => get(`/v1/labels${query ?? ''}`),
-            create: (input) => send('POST', '/v1/labels', input),
-            update: (id, input) => send('PATCH', `/v1/labels/${id}`, input),
-            remove: (id) => send('DELETE', `/v1/labels/${id}`),
-        },
-        environments: {
-            list: () => get('/v1/environments'),
-            create: (input) => send('POST', '/v1/environments', input),
-            rename: (id, name) => send('PATCH', `/v1/environments/${id}`, { name }),
-            remove: (id) => send('DELETE', `/v1/environments/${id}`),
-        },
-        ai: {
-            getConfig: () => get('/v1/ai/config'),
-            updateConfig: (input) => send('PUT', '/v1/ai/config', input),
-            diagnose: (serviceId, deploymentId) => send('POST', `/v1/ai/services/${serviceId}/deploys/${deploymentId}/diagnose`),
-            suggestManifest: (description) => send('POST', '/v1/ai/suggest-manifest', { description }),
-        },
-        serviceTags: {
-            get: (id) => get(`/v1/services/${id}/tags`),
-            set: (id, input) => send('PUT', `/v1/services/${id}/tags`, input),
-        },
-        deploys: {
-            trigger: (serviceId, input) => send('POST', `/v1/services/${serviceId}/deploys`, input ?? {}),
-            list: (serviceId) => get(`/v1/services/${serviceId}/deploys`),
-            queue: (query) => get(`/v1/services/queue${query ? (query.startsWith('?') ? query : `?${query}`) : ''}`),
-            rollback: (serviceId, deploymentId) => send('POST', `/v1/services/${serviceId}/deploys/${deploymentId}/rollback`),
-            cancel: (serviceId, deploymentId) => send('POST', `/v1/services/${serviceId}/deploys/${deploymentId}/cancel`),
-            remove: (serviceId, deploymentId) => send('DELETE', `/v1/services/${serviceId}/deploys/${deploymentId}`),
-            configDiff: (serviceId, deploymentId) => get(`/v1/services/${serviceId}/deploys/${deploymentId}/diff`),
-            promote: (serviceId, targetServiceId) => send('POST', `/v1/services/${serviceId}/promote`, { targetServiceId }),
-            logDownloadUrl: (serviceId, deploymentId) => `/v1/services/${serviceId}/deploys/${deploymentId}/logs/download`,
-        },
-        domains: {
-            list: (serviceId) => get(`/v1/services/${serviceId}/domains`),
-            create: (serviceId, input) => send('POST', `/v1/services/${serviceId}/domains`, input),
-            dnsCheck: (serviceId, domainId) => get(`/v1/services/${serviceId}/domains/${domainId}/dns`),
-            update: (serviceId, domainId, input) => send('PATCH', `/v1/services/${serviceId}/domains/${domainId}`, input),
-            remove: async (serviceId, domainId) => {
-                await request(`/v1/services/${serviceId}/domains/${domainId}`, { method: 'DELETE' });
-            },
-            all: () => get('/v1/domains'),
-            setSsl: (domainId, ssl) => send('PATCH', `/v1/domains/${domainId}`, { ssl }),
-            /** Toggle sticky-session routing (G-28) — sits under `/domains` for legacy compatibility. */
-            setStickySession: (serviceId, enabled) => send('POST', `/v1/services/${serviceId}/sticky-session`, { enabled }),
-            transfer: (domainId, input) => send('POST', `/v1/domains/${domainId}/transfer`, input),
-            previewTransfer: (token) => get(`/v1/domain-transfers/${token}`),
-            acceptTransfer: (token, input) => send('POST', `/v1/domain-transfers/${token}/accept`, input),
-            cancelTransfer: (token) => send('POST', `/v1/domain-transfers/${token}/cancel`, {}),
-        },
-        domainPresets: {
-            list: () => get('/v1/domain-presets'),
-            apply: (input) => send('POST', '/v1/domain-presets/apply', input),
-        },
-        configPresets: {
-            list: () => get('/v1/config-presets'),
-            get: (id) => get(`/v1/config-presets/${encodeURIComponent(id)}`),
-            register: (input) => send('POST', '/v1/config-presets', input),
-            apply: (id, opts) => send('PUT', `/v1/config-presets/${encodeURIComponent(id)}/apply`, opts ?? {}),
-            remove: (id) => send('DELETE', `/v1/config-presets/${encodeURIComponent(id)}`),
-        },
-        metricHistory: {
-            get: () => get('/v1/metric-history'),
-            flush: () => send('POST', '/v1/metric-history/flush'),
-        },
-        buildCache: {
-            stats: () => get('/v1/build-cache/stats'),
-        },
-        orchestrators: {
-            list: () => get('/v1/orchestrators'),
-            stacks: (orchestrator) => get(`/v1/orchestrators/${encodeURIComponent(orchestrator)}/stacks`),
-            stackStatus: (orchestrator, stack) => get(`/v1/orchestrators/${encodeURIComponent(orchestrator)}/stacks/${encodeURIComponent(stack)}`),
-        },
-        branding: {
-            get: () => get('/v1/branding'),
-            set: (input) => send('PATCH', '/v1/branding', input),
-        },
-        egress: {
-            list: () => get('/v1/egress'),
-            set: (input) => send('POST', '/v1/egress', input),
-            clear: (projectId, driver) => send('DELETE', `/v1/egress/${projectId}${driver ? `?driver=${encodeURIComponent(driver)}` : ''}`),
-        },
-        sso: {
-            listProviders: () => get('/v1/sso/providers'),
-            addProvider: (input) => send('POST', '/v1/sso/providers', input),
-            removeProvider: (id) => send('DELETE', `/v1/sso/providers/${id}`),
-        },
-        fanout: {
-            // 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.
-            get: async (serviceId) => (await get(`/v1/services/${serviceId}/targets`)).targets,
-            set: (serviceId, serverIds) => send('PATCH', `/v1/services/${serviceId}/targets`, { serverIds }),
-        },
-        scim: {
-            listTokens: () => get('/v1/scim/tokens'),
-            createToken: (input) => send('POST', '/v1/scim/tokens', input),
-            revokeToken: (id) => send('DELETE', `/v1/scim/tokens/${id}`),
-        },
-        volumes: {
-            list: () => get('/v1/volumes'),
-            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) => {
-                await request(`/v1/volumes/${encodeURIComponent(name)}`, { 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' });
-            },
-        },
-        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) => send('POST', '/v1/system/update-start', { version }),
-            exportUrl: () => '/v1/system/export',
-            dockerEvents: (minutes) => get(`/v1/system/docker-events?minutes=${minutes ?? 60}`),
-        },
-        networks: {
-            list: () => get('/v1/networks'),
-            create: (input) => send('POST', '/v1/networks', { driver: 'bridge', ...input }),
-            remove: (name, serverId) => send('DELETE', `/v1/networks/${encodeURIComponent(name)}${serverId != null ? `?serverId=${serverId}` : ''}`),
-            attach: (input) => send('POST', '/v1/networks/attach', input),
-            detach: (input) => send('POST', '/v1/networks/detach', input),
-        },
-        tunnels: {
-            list: () => get('/v1/tunnels'),
-            create: (input) => send('POST', '/v1/tunnels', input),
-            remove: async (id) => {
-                await request(`/v1/tunnels/${id}`, { method: 'DELETE' });
-            },
-        },
-        activity: {
-            list: (query) => {
-                const parts = [];
-                if (query?.entity)
-                    parts.push(`entity=${encodeURIComponent(query.entity)}`);
-                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' });
-            },
-        },
-        settings: {
-            get: () => get('/v1/settings'),
-            setPanelDomain: (domain) => send('PUT', '/v1/settings/panel-domain', { domain }),
-            setAllowRegistration: (enabled) => send('PUT', '/v1/settings/allow-registration', { enabled }),
-            setAcmeEmail: (email) => send('PUT', '/v1/settings/acme-email', { email }),
-            setTemplatesSource: (source) => send('PUT', '/v1/settings/templates-source', { source }),
-            setDns: (input) => send('PUT', '/v1/settings/dns', input),
-            vault: {
-                get: () => get('/v1/settings/vault'),
-                set: (input) => send('PUT', '/v1/settings/vault', input),
-                test: () => send('POST', '/v1/settings/vault/test'),
-            },
-            dnsRecords: {
-                get: () => get('/v1/settings/dns-records'),
-                set: (input) => send('PUT', '/v1/settings/dns-records', input),
-                test: () => send('POST', '/v1/settings/dns-records/test'),
-            },
-            namecheap: {
-                get: () => get('/v1/settings/dns-records/namecheap'),
-                set: (input) => send('PUT', '/v1/settings/dns-records/namecheap', input),
-            },
-            masterKey: {
-                get: () => get('/v1/settings/master-key'),
-                rotate: () => send('POST', '/v1/settings/master-key/rotate'),
-            },
-        },
-        firewall: {
-            status: () => get('/v1/firewall'),
-            toggle: (enabled) => send('POST', '/v1/firewall/toggle', { enabled }),
-            addRule: (input) => send('POST', '/v1/firewall/rules', input),
-            deleteRule: (id) => request(`/v1/firewall/rules/${id}`, { method: 'DELETE' }),
-            applyRecommended: () => send('POST', '/v1/firewall/recommended'),
-        },
-        users: {
-            list: () => get('/v1/users'),
-            create: (input) => send('POST', '/v1/users', input),
-            resetPassword: (id, input) => send('PATCH', `/v1/users/${id}/password`, input),
-            resetLink: (id) => send('POST', `/v1/users/${id}/reset-link`),
-            setOperator: (id, isOperator) => send('PATCH', `/v1/users/${id}/operator`, { isOperator }),
-            remove: async (id) => {
-                await request(`/v1/users/${id}`, { method: 'DELETE' });
-            },
-        },
-        projects: {
-            list: (query) => get(`/v1/projects${query ?? ''}`),
-            create: (input) => send('POST', '/v1/projects', input),
-            update: (id, input) => send('PATCH', `/v1/projects/${id}`, input),
-            remove: (id) => send('DELETE', `/v1/projects/${id}`),
-        },
-        about: {
-            get: () => get('/v1/about'),
-        },
-        notifications: {
-            listChannels: () => get('/v1/notifications/channels'),
-            createChannel: (input) => send('POST', '/v1/notifications/channels', input),
-            updateChannel: (id, input) => send('PATCH', `/v1/notifications/channels/${id}`, input),
-            removeChannel: async (id) => { await request(`/v1/notifications/channels/${id}`, { method: 'DELETE' }); },
-            testChannel: (id) => send('POST', `/v1/notifications/channels/${id}/test`),
-            log: () => get('/v1/notifications/log'),
-        },
-        sources: {
-            list: () => get('/v1/sources'),
-            create: (input) => send('POST', '/v1/sources', input),
-            update: (id, input) => send('PATCH', `/v1/sources/${id}`, input),
-            remove: async (id) => {
-                await request(`/v1/sources/${id}`, { method: 'DELETE' });
-            },
-            repos: (id) => get(`/v1/sources/${id}/repos`),
-            branches: (id, repo) => get(`/v1/sources/${id}/branches?repo=${encodeURIComponent(repo)}`),
-            test: (id) => get(`/v1/sources/${id}/test`),
-            generateDeployKey: (id) => send('POST', `/v1/sources/${id}/generate-deploy-key`),
-        },
-        insights: {
-            analyze: (input) => send('POST', '/v1/insights', input),
-            get: (serviceId) => get(`/v1/services/${serviceId}/insights`),
-            refresh: (serviceId) => send('POST', `/v1/services/${serviceId}/insights/refresh`),
-        },
-        webhooks: {
-            list: (serviceId) => get(`/v1/services/${serviceId}/webhooks`),
-            create: (serviceId, input) => send('POST', `/v1/services/${serviceId}/webhooks`, input ?? {}),
-            remove: async (serviceId, hookId) => {
-                await request(`/v1/services/${serviceId}/webhooks/${hookId}`, { method: 'DELETE' });
-            },
-        },
-        databases: {
-            list: (query) => get(`/v1/databases${query ?? ''}`),
-            create: (input) => send('POST', '/v1/databases', input),
-            get: (id) => get(`/v1/databases/${id}`),
-            remove: async (id, opts) => {
-                await request(`/v1/databases/${id}${opts?.force ? '?force=true' : ''}`, { method: 'DELETE' });
-            },
-            restart: async (id) => {
-                await request(`/v1/databases/${id}/restart`, { method: 'POST' });
-            },
-            stop: async (id) => {
-                await request(`/v1/databases/${id}/stop`, { method: 'POST' });
-            },
-            start: async (id) => {
-                await request(`/v1/databases/${id}/start`, { method: 'POST' });
-            },
-            logs: (id, lines) => get(`/v1/databases/${id}/logs${lines ? `?lines=${lines}` : ''}`),
-            credentials: (id) => get(`/v1/databases/${id}/credentials`),
-            setLimits: (id, input) => send('PATCH', `/v1/databases/${id}/limits`, input),
-            startStudio: (id, port) => send('POST', `/v1/databases/${id}/studio`, { port }),
-            stopStudio: async (id) => {
-                await request(`/v1/databases/${id}/studio`, { method: 'DELETE' });
-                return { ok: true };
-            },
-            drillBackup: (id, input) => send('POST', `/v1/databases/${id}/backups/drill`, input),
-            drills: (id) => get(`/v1/databases/${id}/drills`),
-            pgbouncerStatus: (id) => get(`/v1/databases/${id}/pgbouncer`),
-            enablePgbouncer: (id, input) => send('POST', `/v1/databases/${id}/pgbouncer/enable`, input ?? {}),
-            disablePgbouncer: (id) => send('POST', `/v1/databases/${id}/pgbouncer/disable`, {}),
-        },
-        attachments: {
-            list: (serviceId) => get(`/v1/services/${serviceId}/attachments`),
-            create: (serviceId, input) => send('POST', `/v1/services/${serviceId}/attachments`, input),
-            remove: async (serviceId, attachmentId) => {
-                await request(`/v1/services/${serviceId}/attachments/${attachmentId}`, { 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),
-        },
-        volumeBackups: {
-            // Path segments are user-visible names: encode them like the rest of
-            // the client does, or '?'/'#'/'%' in a volume name rewrite the URL.
-            list: (volumeName) => get(`/v1/volumes/${encodeURIComponent(volumeName)}/backups`),
-            create: (volumeName, input) => send('POST', `/v1/volumes/${encodeURIComponent(volumeName)}/backups`, input),
-            restore: (volumeName, backupId) => send('POST', `/v1/volumes/${encodeURIComponent(volumeName)}/backups/${backupId}/restore`),
-            downloadUrl: (volumeName, backupId) => `/v1/volumes/${encodeURIComponent(volumeName)}/backups/${backupId}/download`,
-        },
-        env: {
-            list: (serviceId) => get(`/v1/services/${serviceId}/env`),
-            create: (serviceId, input) => send('POST', `/v1/services/${serviceId}/env`, input),
-            update: (serviceId, varId, input) => send('PATCH', `/v1/services/${serviceId}/env/${varId}`, input),
-            remove: async (serviceId, varId) => {
-                await request(`/v1/services/${serviceId}/env/${varId}`, { method: 'DELETE' });
-            },
-            import: (serviceId, content) => send('POST', `/v1/services/${serviceId}/env/import`, { content }),
-            export: (serviceId) => get(`/v1/services/${serviceId}/env/export`),
-            search: (q) => get(`/v1/env/search?q=${encodeURIComponent(q)}`),
-        },
-        projectEnv: {
-            list: (projectId) => get(`/v1/projects/${projectId}/env`),
-            create: (projectId, input) => send('POST', `/v1/projects/${projectId}/env`, input),
-            update: (projectId, varId, input) => send('PATCH', `/v1/projects/${projectId}/env/${varId}`, input),
-            remove: async (projectId, varId) => {
-                await request(`/v1/projects/${projectId}/env/${varId}`, { method: 'DELETE' });
-            },
-        },
-        stats: {
-            snapshot: () => get('/v1/stats'),
-            metrics: (serviceId, opts) => get(`/v1/services/${serviceId}/metrics?kind=${opts?.kind ?? 'cpu'}&minutes=${opts?.minutes ?? 60}`),
-        },
-        dashboard: {
-            get: () => get('/v1/dashboard'),
-        },
-        topology: {
-            get: () => get('/v1/topology'),
-        },
-        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)}`),
-            },
-        },
-        backups: {
-            storage: (databaseId) => get(`/v1/databases/${databaseId}/storage`),
-            backupNow: (databaseId) => send('POST', `/v1/databases/${databaseId}/backups`),
-            listForDb: (databaseId) => get(`/v1/databases/${databaseId}/backups`),
-            restore: (databaseId, backupId) => send('POST', `/v1/databases/${databaseId}/backups/${backupId}/restore`),
-            list: () => get('/v1/backups'),
-            remove: async (backupId) => {
-                await request(`/v1/backups/${backupId}`, { method: 'DELETE' });
-            },
-            downloadUrl: (backupId) => `/v1/backups/${backupId}/download`,
-        },
-        backupDestinations: {
-            list: () => get('/v1/backup-destinations'),
-            create: (input) => send('POST', '/v1/backup-destinations', input),
-            update: (id, input) => send('PATCH', `/v1/backup-destinations/${id}`, input),
-            remove: (id) => send('DELETE', `/v1/backup-destinations/${id}`),
-            test: (id) => send('POST', `/v1/backup-destinations/${id}/test`),
-        },
-        jobs: {
-            list: (serviceId) => get(`/v1/services/${serviceId}/jobs`),
-            create: (serviceId, input) => send('POST', `/v1/services/${serviceId}/jobs`, input),
-            update: (serviceId, jobId, input) => send('PATCH', `/v1/services/${serviceId}/jobs/${jobId}`, input),
-            remove: (serviceId, jobId) => send('DELETE', `/v1/services/${serviceId}/jobs/${jobId}`),
-            run: (serviceId, jobId) => send('POST', `/v1/services/${serviceId}/jobs/${jobId}/run`),
-            runs: (serviceId, jobId) => get(`/v1/services/${serviceId}/jobs/${jobId}/runs`),
-        },
-        servers: {
-            list: () => get('/v1/servers'),
-            create: (input) => send('POST', '/v1/servers', input),
-            remove: (id, opts) => send('DELETE', `/v1/servers/${id}${opts?.force ? '?force=true' : ''}`),
-            test: (id) => send('POST', `/v1/servers/${id}/test`),
-            approve: (id) => send('POST', `/v1/servers/${id}/approve`),
-            reject: (id) => send('POST', `/v1/servers/${id}/reject`),
-            sshTest: (input) => send('POST', '/v1/servers/ssh-test', input),
-            sshBootstrap: (input) => send('POST', '/v1/servers/ssh-bootstrap', input),
-            bootstrapLogs: (id) => get(`/v1/servers/${id}/bootstrap-logs`),
-        },
-        limits: {
-            setService: (serviceId, input) => send('PATCH', `/v1/services/${serviceId}/limits`, input),
-            setDatabase: (databaseId, input) => send('PATCH', `/v1/databases/${databaseId}/limits`, input),
-        },
-        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: {
-            list: (query) => {
-                const parts = [];
-                if (query?.category)
-                    parts.push(`category=${encodeURIComponent(query.category)}`);
-                if (query?.pluginId)
-                    parts.push(`pluginId=${encodeURIComponent(query.pluginId)}`);
-                if (query?.reveal)
-                    parts.push('reveal=true');
-                const qs = parts.length ? `?${parts.join('&')}` : '';
-                return get(`/v1/config${qs}`);
-            },
-            get: (key) => get(`/v1/config/${encodeURIComponent(key)}`),
-            set: (key, input) => send('POST', `/v1/config/${encodeURIComponent(key)}`, input),
-            delete: (key) => send('DELETE', `/v1/config/${encodeURIComponent(key)}`),
-        },
-        plugins: {
-            list: () => get('/v1/plugins'),
-            marketplace: (opts) => get(`/v1/plugins/marketplace${opts?.refresh ? '?refresh=true' : ''}`),
-            install: (input) => send('POST', '/v1/plugins/install', input),
-            enable: (id) => send('POST', `/v1/plugins/${encodeURIComponent(id)}/enable`),
-            disable: (id) => send('POST', `/v1/plugins/${encodeURIComponent(id)}/disable`),
-            reload: (id) => send('POST', `/v1/plugins/${encodeURIComponent(id)}/reload`),
-            inspect: (id) => get(`/v1/plugins/${encodeURIComponent(id)}/inspect`),
-            uninstall: (id) => send('POST', `/v1/plugins/${encodeURIComponent(id)}/uninstall`),
-        },
-        menus: {
-            list: (query) => {
-                const qs = query?.slot ? `?slot=${encodeURIComponent(query.slot)}` : '';
-                return get(`/v1/menus${qs}`);
-            },
-        },
-        demo: {
-            seed: () => send('POST', '/v1/demo/seed'),
-        },
-        logDrains: {
-            list: (query) => {
-                const qs = query?.serviceId !== undefined ? `?serviceId=${encodeURIComponent(String(query.serviceId))}` : '';
-                return get(`/v1/log-drains${qs}`);
-            },
-            get: (id) => get(`/v1/log-drains/${id}`),
-            create: (input) => send('POST', '/v1/log-drains', input),
-            update: (id, input) => send('PATCH', `/v1/log-drains/${id}`, input),
-            remove: (id) => send('DELETE', `/v1/log-drains/${id}`),
-            test: (id) => send('POST', `/v1/log-drains/${id}/test`),
-            search: (input) => send('POST', '/v1/log-drains/search', input),
-        },
-        emailTemplates: {
-            list: (workspaceId) => get(`/v1/workspaces/${workspaceId}/email-templates`),
-            preview: (workspaceId, name, vars) => send('POST', `/v1/workspaces/${workspaceId}/email-templates/preview`, { name, vars: vars ?? {} }),
-            set: (workspaceId, name, subject, text) => send('PUT', `/v1/workspaces/${workspaceId}/email-templates/${name}`, { subject, text }),
-            reset: (workspaceId, name) => send('DELETE', `/v1/workspaces/${workspaceId}/email-templates/${name}`, {}),
-        },
-        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),
-        },
-        health: () => get('/health'),
-        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),
-        },
-    };
-}
+export { DATABASE_IMPORT_FINISHED_STATUSES, } from './databaseImport.js';
+export { apiGetUrl, } from './apiPath.js';
+export { AGENT_SWARM_MANAGER_VAR, } from './types.js';
+export { TERMINAL_SUBPROTOCOL, TERMINAL_TICKET_PREFIX, TERMINAL_INPUT_CHUNK_BYTES, TERMINAL_PENDING_INPUT_MAX, terminalAttachInfo, terminalCloseMessage, connectTerminal, } from './terminal.js';
+export { createClient } from './client.js';
 //# sourceMappingURL=index.js.map