@sylphx/management 0.1.0

package/README.md

@@ -0,0 +1,138 @@
+# @sylphx/management
+
+Programmatic access to the [Sylphx Platform](https://sylphx.com) Management API.
+
+## Installation
+
+```bash
+bun add @sylphx/management
+# or
+npm install @sylphx/management
+```
+
+## Quick Start
+
+```typescript
+import { SylphxManagement } from '@sylphx/management'
+
+const mgmt = new SylphxManagement({
+  token: process.env.SYLPHX_TOKEN!,
+  // baseUrl: 'https://api.sylphx.com' (default)
+})
+
+// List projects
+const projects = await mgmt.projects.list()
+
+// Trigger a deployment
+await mgmt.deployments.trigger('my-project-id', 'production')
+
+// List env vars
+const vars = await mgmt.envVars.list('my-project-id', 'production')
+```
+
+## API
+
+All methods are namespaced under the `SylphxManagement` instance:
+
+### `mgmt.user`
+- `whoami()` — Get current user and orgs
+
+### `mgmt.projects`
+- `list()` — List all projects
+- `create(data)` — Create a new project
+- `delete(id)` — Delete a project
+
+### `mgmt.deployments`
+- `status(projectId)` — Get deployment status
+- `trigger(projectId, envType)` — Trigger a deploy
+- `history(projectId, envType)` — Get deployment history
+- `rollback(projectId, body)` — Rollback to a previous deploy
+
+### `mgmt.environments`
+- `list(projectId)` — List environments
+- `resolveId(projectId, envType)` — Resolve envType → envId
+- `promote(projectId, targetEnvId, sourceEnvId)` — Promote an environment
+
+### `mgmt.envVars`
+- `list(projectId, envType)` — List env vars
+- `set(projectId, key, value, envType, secret?)` — Set a single env var
+- `setMany(projectId, vars, envType)` — Batch-set env vars
+- `delete(projectId, key, envType)` — Delete an env var
+
+### `mgmt.domains`
+- `list(projectId, envType?)` — List apex domains
+- `create(projectId, apexDomain, envType?)` — Register a domain
+- `addHostname(projectId, domainId, hostname, opts?)` — Add a hostname
+- `removeHostname(projectId, domainId, hostnameId)` — Remove a hostname
+- `checkHostname(projectId, domainId, hostnameId)` — Check DNS for hostname
+- `enableEmail(projectId, domainId, opts?)` — Enable email sending
+- `checkEmail(projectId, domainId)` — Check email DNS propagation
+- `disableEmail(projectId, domainId)` — Disable email sending
+
+### `mgmt.databases`
+- `list()` — List all databases
+- `create(data)` — Provision a database
+- `get(id)` — Get database details
+- `delete(id)` — Delete a database
+- `branch(id, data)` — Branch a database
+
+### `mgmt.services`
+- `list(projectId)` — List services
+- `get(projectId, name)` — Get a service
+- `deploy(projectId, name, envType)` — Deploy a service
+- `delete(projectId, name)` — Delete a service
+
+### `mgmt.volumes`
+- `list(projectId)` — List volumes
+- `create(projectId, data)` — Create a volume
+- `delete(projectId, volId)` — Delete a volume
+
+### `mgmt.storage`
+- `list(projectId, envType?)` — List storage resources
+- `create(projectId, data)` — Provision storage
+- `delete(projectId, storageId)` — Delete storage
+
+### `mgmt.config`
+- `list(projectId, envType?)` — List config keys
+- `get(projectId, key, envType?)` — Get a config key
+- `set(projectId, key, value, envType?)` — Set a config key
+- `delete(projectId, key, envType?)` — Delete a config key
+
+### `mgmt.tasks`
+- `list(projectId, envType?)` — List task definitions
+- `create(projectId, data)` — Create/update a task
+- `get(projectId, taskId)` — Get a task
+- `update(projectId, taskId, data)` — Update a task
+- `delete(projectId, taskId)` — Delete a task
+
+### `mgmt.resources`
+- `listBindings(resourceId)` — List resource bindings
+- `bind(resourceId, data)` — Bind a resource to a project env
+- `unbind(resourceId, bindingId)` — Unbind a resource
+
+### `mgmt.org`
+- `current()` — Get current org
+- `listMembers(orgId)` — List org members
+- `inviteMember(orgId, email, role)` — Invite a member
+- `removeMember(orgId, userId)` — Remove a member
+
+### `mgmt.logs`
+- `stream(projectId, envType)` — Get `{ url, token }` for SSE log streaming
+
+## Error Handling
+
+```typescript
+import { ManagementApiError } from '@sylphx/management'
+
+try {
+  await mgmt.projects.delete('non-existent')
+} catch (err) {
+  if (err instanceof ManagementApiError) {
+    console.error(`API Error ${err.status}: ${err.message}`)
+  }
+}
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,41 @@
+import { ConfigResource } from './resources/config.js';
+import { DatabasesResource } from './resources/databases.js';
+import { DeploymentsResource } from './resources/deployments.js';
+import { DomainsResource } from './resources/domains.js';
+import { EnvVarsResource } from './resources/env-vars.js';
+import { EnvironmentsResource } from './resources/environments.js';
+import { LogsResource } from './resources/logs.js';
+import { OrgResource } from './resources/org.js';
+import { ProjectsResource } from './resources/projects.js';
+import { ResourceBindingsResource } from './resources/resources.js';
+import { ServicesResource } from './resources/services.js';
+import { StoragesResource } from './resources/storage.js';
+import { TasksResource } from './resources/tasks.js';
+import { UserResource } from './resources/user.js';
+import { VolumesResource } from './resources/volumes.js';
+export interface SylphxManagementOptions {
+    token: string;
+    /** Base URL for the API. Default: 'https://api.sylphx.com' */
+    baseUrl?: string;
+    /** User-Agent header value. Default: '@sylphx/management/1.0.0' */
+    userAgent?: string;
+}
+export declare class SylphxManagement {
+    readonly user: UserResource;
+    readonly projects: ProjectsResource;
+    readonly deployments: DeploymentsResource;
+    readonly environments: EnvironmentsResource;
+    readonly envVars: EnvVarsResource;
+    readonly domains: DomainsResource;
+    readonly databases: DatabasesResource;
+    readonly services: ServicesResource;
+    readonly volumes: VolumesResource;
+    readonly storage: StoragesResource;
+    readonly config: ConfigResource;
+    readonly tasks: TasksResource;
+    readonly resources: ResourceBindingsResource;
+    readonly org: OrgResource;
+    readonly logs: LogsResource;
+    constructor(options: SylphxManagementOptions);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,qBAAa,gBAAgB;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAA;IACzC,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAA;IAC3C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,QAAQ,CAAC,SAAS,EAAE,wBAAwB,CAAA;IAC5C,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;gBAEf,OAAO,EAAE,uBAAuB;CAwE5C"}

package/dist/client.js

@@ -0,0 +1,91 @@
+import { ApiError } from './errors.js';
+import { ConfigResource } from './resources/config.js';
+import { DatabasesResource } from './resources/databases.js';
+import { DeploymentsResource } from './resources/deployments.js';
+import { DomainsResource } from './resources/domains.js';
+import { EnvVarsResource } from './resources/env-vars.js';
+import { EnvironmentsResource } from './resources/environments.js';
+import { LogsResource } from './resources/logs.js';
+import { OrgResource } from './resources/org.js';
+import { ProjectsResource } from './resources/projects.js';
+import { ResourceBindingsResource } from './resources/resources.js';
+import { ServicesResource } from './resources/services.js';
+import { StoragesResource } from './resources/storage.js';
+import { TasksResource } from './resources/tasks.js';
+import { UserResource } from './resources/user.js';
+import { VolumesResource } from './resources/volumes.js';
+export class SylphxManagement {
+    user;
+    projects;
+    deployments;
+    environments;
+    envVars;
+    domains;
+    databases;
+    services;
+    volumes;
+    storage;
+    config;
+    tasks;
+    resources;
+    org;
+    logs;
+    constructor(options) {
+        const baseUrl = options.baseUrl ?? 'https://api.sylphx.com';
+        const userAgent = options.userAgent ?? '@sylphx/management/1.0.0';
+        const apiBase = `${baseUrl}/v1`;
+        const request = async (method, path, opts) => {
+            let url = `${apiBase}${path}`;
+            if (opts?.query) {
+                const params = new URLSearchParams(opts.query);
+                url += `?${params.toString()}`;
+            }
+            const headers = {
+                Authorization: `Bearer ${options.token}`,
+                'Content-Type': 'application/json',
+                'User-Agent': userAgent,
+            };
+            const res = await fetch(url, {
+                method,
+                headers,
+                body: opts?.body ? JSON.stringify(opts.body) : undefined,
+            });
+            if (!res.ok) {
+                let body;
+                const text = await res.text();
+                try {
+                    body = JSON.parse(text);
+                }
+                catch {
+                    body = text;
+                }
+                const message = typeof body === 'object' && body !== null && 'message' in body
+                    ? String(body['message'])
+                    : `HTTP ${res.status}`;
+                throw new ApiError(res.status, message, body);
+            }
+            if (res.status === 204) {
+                return undefined;
+            }
+            return res.json();
+        };
+        // Build resource instances — environments first since others depend on it
+        this.environments = new EnvironmentsResource(request);
+        this.user = new UserResource(request);
+        this.projects = new ProjectsResource(request);
+        this.deployments = new DeploymentsResource(request);
+        this.envVars = new EnvVarsResource(request);
+        this.domains = new DomainsResource(request);
+        this.databases = new DatabasesResource(request);
+        this.volumes = new VolumesResource(request);
+        this.storage = new StoragesResource(request);
+        this.org = new OrgResource(request);
+        // Resources that depend on environments for envType → envId resolution
+        this.services = new ServicesResource(request, this.environments);
+        this.config = new ConfigResource(request, this.environments);
+        this.tasks = new TasksResource(request, this.environments);
+        this.resources = new ResourceBindingsResource(request, this.environments);
+        // Logs resource gets baseUrl + token directly (SSE URL generation)
+        this.logs = new LogsResource(baseUrl, options.token);
+    }
+}

package/dist/errors.d.ts

@@ -0,0 +1,9 @@
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly body?: unknown | undefined;
+    constructor(status: number, message: string, body?: unknown | undefined);
+}
+/** @deprecated Use ApiError */
+export declare const ManagementApiError: typeof ApiError;
+export type ManagementApiError = ApiError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;aAEjB,MAAM,EAAE,MAAM;aAEd,IAAI,CAAC,EAAE,OAAO;gBAFd,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,OAAO,YAAA;CAK/B;AAED,+BAA+B;AAC/B,eAAO,MAAM,kBAAkB,iBAAW,CAAA;AAC1C,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAA"}

package/dist/errors.js

@@ -0,0 +1,12 @@
+export class ApiError extends Error {
+    status;
+    body;
+    constructor(status, message, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = 'ApiError';
+    }
+}
+/** @deprecated Use ApiError */
+export const ManagementApiError = ApiError;

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export type { SylphxManagementOptions } from './client.js';
+export { SylphxManagement } from './client.js';
+export { ApiError, ManagementApiError } from './errors.js';
+export type { RequestFn } from './request.js';
+export { ConfigResource } from './resources/config.js';
+export { DatabasesResource } from './resources/databases.js';
+export { DeploymentsResource } from './resources/deployments.js';
+export { DomainsResource } from './resources/domains.js';
+export { EnvVarsResource } from './resources/env-vars.js';
+export { EnvironmentsResource } from './resources/environments.js';
+export { LogsResource } from './resources/logs.js';
+export { OrgResource } from './resources/org.js';
+export { ProjectsResource } from './resources/projects.js';
+export { ResourceBindingsResource } from './resources/resources.js';
+export { ServicesResource } from './resources/services.js';
+export { StoragesResource } from './resources/storage.js';
+export { TasksResource } from './resources/tasks.js';
+export { UserResource } from './resources/user.js';
+export { VolumesResource } from './resources/volumes.js';
+export type { App, ConfigEntry, Database, DeploymentStatus, DeploymentStatusEnv, DeployResult, DnsRecord, Domain, DomainEmailBinding, DomainHostname, DomainResult, Environment, EnvVar, HostnameInstruction, LogEntry, LogStream, Org, OrgMember, Project, PromoteResult, ResourceBinding, Service, StorageResource, Task, Volume, WhoAmI, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9C,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAG1D,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,YAAY,EACX,GAAG,EACH,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,MAAM,EACN,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,MAAM,EACN,mBAAmB,EACnB,QAAQ,EACR,SAAS,EACT,GAAG,EACH,SAAS,EACT,OAAO,EACP,aAAa,EACb,eAAe,EACf,OAAO,EACP,eAAe,EACf,IAAI,EACJ,MAAM,EACN,MAAM,GACN,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,20 @@
+// Main client
+export { SylphxManagement } from './client.js';
+// Error class
+export { ApiError, ManagementApiError } from './errors.js';
+// Resource classes (for extensibility / type augmentation)
+export { ConfigResource } from './resources/config.js';
+export { DatabasesResource } from './resources/databases.js';
+export { DeploymentsResource } from './resources/deployments.js';
+export { DomainsResource } from './resources/domains.js';
+export { EnvVarsResource } from './resources/env-vars.js';
+export { EnvironmentsResource } from './resources/environments.js';
+export { LogsResource } from './resources/logs.js';
+export { OrgResource } from './resources/org.js';
+export { ProjectsResource } from './resources/projects.js';
+export { ResourceBindingsResource } from './resources/resources.js';
+export { ServicesResource } from './resources/services.js';
+export { StoragesResource } from './resources/storage.js';
+export { TasksResource } from './resources/tasks.js';
+export { UserResource } from './resources/user.js';
+export { VolumesResource } from './resources/volumes.js';

package/dist/request.d.ts

@@ -0,0 +1,5 @@
+export type RequestFn = <T>(method: string, path: string, options?: {
+    body?: unknown;
+    query?: Record<string, string>;
+}) => Promise<T>;
+//# sourceMappingURL=request.d.ts.map

package/dist/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,EACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACT,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9B,KACG,OAAO,CAAC,CAAC,CAAC,CAAA"}

package/dist/request.js

@@ -0,0 +1 @@
+export {};

package/dist/resources/config.d.ts

@@ -0,0 +1,30 @@
+import type { RequestFn } from '../request.js';
+import type { ConfigEntry } from '../types.js';
+import type { EnvironmentsResource } from './environments.js';
+export declare class ConfigResource {
+    private readonly request;
+    private readonly environments;
+    constructor(request: RequestFn, environments: EnvironmentsResource);
+    /**
+     * List all config keys for a project.
+     * Backend uses ?env=<envId> (not ?envType). Resolves envType → envId automatically.
+     */
+    list(projectId: string, envType?: string): Promise<ConfigEntry[]>;
+    /**
+     * Get a single config key.
+     * Backend uses ?env=<envId> (not ?envType). Resolves envType → envId automatically.
+     */
+    get(projectId: string, key: string, envType?: string): Promise<ConfigEntry>;
+    /**
+     * Set a config key.
+     * Backend expects { key, value, environmentId } (not envType).
+     * Resolves envType → environmentId automatically when envType is provided.
+     */
+    set(projectId: string, key: string, value: string, envType?: string): Promise<ConfigEntry>;
+    /**
+     * Delete a config key.
+     * Backend uses ?env=<envId> (not ?envType). Resolves envType → envId automatically.
+     */
+    delete(projectId: string, key: string, envType?: string): Promise<void>;
+}
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/resources/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAE7D,qBAAa,cAAc;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,OAAO,EAAE,SAAS,EAClB,YAAY,EAAE,oBAAoB;IAGpD;;;OAGG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAcvE;;;OAGG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAajF;;;;OAIG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAUhG;;;OAGG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAY7E"}

package/dist/resources/config.js

@@ -0,0 +1,62 @@
+export class ConfigResource {
+    request;
+    environments;
+    constructor(request, environments) {
+        this.request = request;
+        this.environments = environments;
+    }
+    /**
+     * List all config keys for a project.
+     * Backend uses ?env=<envId> (not ?envType). Resolves envType → envId automatically.
+     */
+    async list(projectId, envType) {
+        const query = {};
+        if (envType) {
+            const envId = await this.environments.resolveId(projectId, envType);
+            if (envId)
+                query['env'] = envId;
+        }
+        const res = await this.request('GET', `/projects/${encodeURIComponent(projectId)}/config`, { query });
+        return Array.isArray(res) ? res : (res.data ?? []);
+    }
+    /**
+     * Get a single config key.
+     * Backend uses ?env=<envId> (not ?envType). Resolves envType → envId automatically.
+     */
+    async get(projectId, key, envType) {
+        const query = {};
+        if (envType) {
+            const envId = await this.environments.resolveId(projectId, envType);
+            if (envId)
+                query['env'] = envId;
+        }
+        return this.request('GET', `/projects/${encodeURIComponent(projectId)}/config/${encodeURIComponent(key)}`, { query });
+    }
+    /**
+     * Set a config key.
+     * Backend expects { key, value, environmentId } (not envType).
+     * Resolves envType → environmentId automatically when envType is provided.
+     */
+    async set(projectId, key, value, envType) {
+        let environmentId = null;
+        if (envType) {
+            environmentId = await this.environments.resolveId(projectId, envType);
+        }
+        return this.request('POST', `/projects/${encodeURIComponent(projectId)}/config`, {
+            body: { key, value, environmentId },
+        });
+    }
+    /**
+     * Delete a config key.
+     * Backend uses ?env=<envId> (not ?envType). Resolves envType → envId automatically.
+     */
+    async delete(projectId, key, envType) {
+        const query = {};
+        if (envType) {
+            const envId = await this.environments.resolveId(projectId, envType);
+            if (envId)
+                query['env'] = envId;
+        }
+        return this.request('DELETE', `/projects/${encodeURIComponent(projectId)}/config/${encodeURIComponent(key)}`, { query });
+    }
+}

package/dist/resources/databases.d.ts

@@ -0,0 +1,26 @@
+import type { RequestFn } from '../request.js';
+import type { Database } from '../types.js';
+export declare class DatabasesResource {
+    private readonly request;
+    constructor(request: RequestFn);
+    /** List all databases (via unified Resources API) */
+    list(): Promise<Database[]>;
+    /** Provision a new database (via unified Resources API) */
+    create(data: {
+        name: string;
+        env: string;
+        tier: string;
+        storageGb: number;
+    }): Promise<Database>;
+    /** Get database details (via unified Resources API) */
+    get(id: string): Promise<Database>;
+    /** Delete a database (via unified Resources API) */
+    delete(id: string): Promise<void>;
+    /** Branch a database for staging/preview (via unified Resources API) */
+    branch(id: string, data: {
+        name: string;
+        env: string;
+        fast?: boolean;
+    }): Promise<Database>;
+}
+//# sourceMappingURL=databases.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"databases.d.ts","sourceRoot":"","sources":["../../src/resources/databases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,qBAAa,iBAAiB;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,SAAS;IAE/C,qDAAqD;IAC/C,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IASjC,2DAA2D;IACrD,MAAM,CAAC,IAAI,EAAE;QAClB,IAAI,EAAE,MAAM,CAAA;QACZ,GAAG,EAAE,MAAM,CAAA;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,SAAS,EAAE,MAAM,CAAA;KACjB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIrB,uDAAuD;IACjD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIxC,oDAAoD;IAC9C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,wEAAwE;IAClE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;CAKhG"}

package/dist/resources/databases.js

@@ -0,0 +1,29 @@
+export class DatabasesResource {
+    request;
+    constructor(request) {
+        this.request = request;
+    }
+    /** List all databases (via unified Resources API) */
+    async list() {
+        const res = await this.request('GET', '/resources', { query: { kind: 'database' } });
+        return Array.isArray(res) ? res : (res.data ?? []);
+    }
+    /** Provision a new database (via unified Resources API) */
+    async create(data) {
+        return this.request('POST', '/resources', { body: { ...data, kind: 'database' } });
+    }
+    /** Get database details (via unified Resources API) */
+    async get(id) {
+        return this.request('GET', `/resources/${encodeURIComponent(id)}`);
+    }
+    /** Delete a database (via unified Resources API) */
+    async delete(id) {
+        return this.request('DELETE', `/resources/${encodeURIComponent(id)}`);
+    }
+    /** Branch a database for staging/preview (via unified Resources API) */
+    async branch(id, data) {
+        return this.request('POST', `/resources/${encodeURIComponent(id)}/branch`, {
+            body: data,
+        });
+    }
+}

package/dist/resources/deployments.d.ts

@@ -0,0 +1,24 @@
+import type { RequestFn } from '../request.js';
+import type { DeploymentStatus, DeployResult } from '../types.js';
+export declare class DeploymentsResource {
+    private readonly request;
+    constructor(request: RequestFn);
+    /** Get deployment status for a project */
+    status(projectId: string): Promise<DeploymentStatus>;
+    /** Trigger a deploy for a project environment */
+    trigger(projectId: string, envType: string): Promise<DeployResult>;
+    /** Get deployment history for a project environment */
+    history(projectId: string, envType: string): Promise<DeployResult[]>;
+    /**
+     * Rollback to a previous deployment.
+     * Accepts envId (rollback env to previous deploy), deploymentRecordId, or buildRecordId.
+     * One of these is required.
+     */
+    rollback(projectId: string, body: {
+        envId?: string;
+        deploymentRecordId?: string;
+        buildRecordId?: string;
+        serviceId?: string;
+    }): Promise<DeployResult>;
+}
+//# sourceMappingURL=deployments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../../src/resources/deployments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAEjE,qBAAa,mBAAmB;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,SAAS;IAE/C,0CAA0C;IACpC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI1D,iDAAiD;IAC3C,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAMxE,uDAAuD;IACjD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAM1E;;;;OAIG;IACG,QAAQ,CACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,kBAAkB,CAAC,EAAE,MAAM,CAAA;QAC3B,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,SAAS,CAAC,EAAE,MAAM,CAAA;KAClB,GACC,OAAO,CAAC,YAAY,CAAC;CAGxB"}

package/dist/resources/deployments.js

@@ -0,0 +1,30 @@
+export class DeploymentsResource {
+    request;
+    constructor(request) {
+        this.request = request;
+    }
+    /** Get deployment status for a project */
+    async status(projectId) {
+        return this.request('GET', `/projects/${projectId}/status`);
+    }
+    /** Trigger a deploy for a project environment */
+    async trigger(projectId, envType) {
+        return this.request('POST', `/projects/${projectId}/deploy`, {
+            body: { envType },
+        });
+    }
+    /** Get deployment history for a project environment */
+    async history(projectId, envType) {
+        return this.request('GET', `/projects/${projectId}/deployments`, {
+            query: { envType },
+        });
+    }
+    /**
+     * Rollback to a previous deployment.
+     * Accepts envId (rollback env to previous deploy), deploymentRecordId, or buildRecordId.
+     * One of these is required.
+     */
+    async rollback(projectId, body) {
+        return this.request('POST', `/projects/${projectId}/rollback`, { body });
+    }
+}

package/dist/resources/domains.d.ts

@@ -0,0 +1,30 @@
+import type { RequestFn } from '../request.js';
+import type { DomainEmailBinding, DomainHostname, DomainResult } from '../types.js';
+export declare class DomainsResource {
+    private readonly request;
+    constructor(request: RequestFn);
+    /** List all apex domains for a project environment */
+    list(projectId: string, envType?: string): Promise<DomainResult[]>;
+    /** Register an apex domain for a project (full domain object with DNS records) */
+    create(projectId: string, apexDomain: string, envType?: string): Promise<DomainResult>;
+    /** Add a hostname binding to an existing domain */
+    addHostname(projectId: string, domainId: string, hostname: string, opts?: {
+        isPrimary?: boolean;
+        redirectTo?: string;
+        envType?: string;
+    }): Promise<DomainHostname>;
+    /** Remove a hostname binding */
+    removeHostname(projectId: string, domainId: string, hostnameId: string): Promise<void>;
+    /** Trigger DNS check for a hostname */
+    checkHostname(projectId: string, domainId: string, hostnameId: string): Promise<DomainHostname>;
+    /** Enable email sending for a domain (generates DKIM keypair) */
+    enableEmail(projectId: string, domainId: string, opts?: {
+        defaultFromEmail?: string;
+        defaultFromName?: string;
+    }): Promise<DomainEmailBinding>;
+    /** Check DKIM DNS propagation and load into Stalwart */
+    checkEmail(projectId: string, domainId: string): Promise<DomainEmailBinding>;
+    /** Disable email sending for a domain */
+    disableEmail(projectId: string, domainId: string): Promise<void>;
+}
+//# sourceMappingURL=domains.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../src/resources/domains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAEnF,qBAAa,eAAe;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,SAAS;IAE/C,sDAAsD;IAChD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,SAAe,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAM9E,kFAAkF;IAC5E,MAAM,CACX,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,SAAe,GACpB,OAAO,CAAC,YAAY,CAAC;IAMxB,mDAAmD;IAC7C,WAAW,CAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GACnE,OAAO,CAAC,cAAc,CAAC;IAY1B,gCAAgC;IAC1B,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5F,uCAAuC;IACjC,aAAa,CAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,CAAC;IAO1B,iEAAiE;IAC3D,WAAW,CAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5D,OAAO,CAAC,kBAAkB,CAAC;IAQ9B,wDAAwD;IAClD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAOlF,yCAAyC;IACnC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGtE"}