@sylphx/management 0.2.3 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @sylphx/management
 
+## 0.4.0
+
+### Minor Changes
+
+- [#586](https://github.com/SylphxAI/platform/pull/586) [`2e55a61`](https://github.com/SylphxAI/platform/commit/2e55a6194628c5ca3ca78290cbf62610231ccee6) Thanks [@shtse8](https://github.com/shtse8)! - Expose authenticated build detail through the deployments contract, Management SDK, and `sylphx deployments build` so failed builds return structured, redacted diagnostics.
+
+### Patch Changes
+
+- Updated dependencies [[`2e55a61`](https://github.com/SylphxAI/platform/commit/2e55a6194628c5ca3ca78290cbf62610231ccee6)]:
+  - @sylphx/contract@0.5.0
+
+## 0.3.0
+
+### Minor Changes
+
+- [#531](https://github.com/SylphxAI/platform/pull/531) [`2ff1de4`](https://github.com/SylphxAI/platform/commit/2ff1de40fd1e2a785a7daa764ddad4a56d7b48c8) Thanks [@shtse8](https://github.com/shtse8)! - Restore dogfooded deployment operations by allowing `sylphx deploy`, `sylphx status`, `sylphx logs`, `sylphx tail`, `sylphx open`, `sylphx env`, `sylphx config`, `sylphx secrets`, `sylphx storage`, `sylphx volumes`, `sylphx resources`, `sylphx domains`, `sylphx tasks`, `sylphx sandbox`, `sylphx plan`, `sylphx run-cmd`, `sylphx promote`, `sylphx releases`, `sylphx bisect`, and `sylphx rollback` to target explicit projects from unlinked directories, carrying org scoping through Management SDK calls and SSE log streams, and exposing scoped project/log/environment/service helpers in the Management SDK.
+
+  Prune scaffold-only surfaces from the published CLI/Management SDK surface (`restart`, task `run`, direct `scale`, `functions`, `edge`, `regions`, and the no-op `deploy --region` flag) until their Management API or infra paths are real.
+
 ## 0.2.3
 
 ### Patch Changes
@@ -33,7 +52,7 @@ Management SDK now covers every public `apps/api/src/server/platform/routes/`
 namespace (35/35 non-excluded, 6 internal-only exclusions with written
 rationale).
 
-### New namespaces (14)
+### New namespaces (13)
 
 - `admin` — operator org / user / credit / audit administration
 - `auth` (alias of `authSettings`) — OAuth providers + project auth policy + stats
@@ -41,7 +60,6 @@ rationale).
 - `billingSettings` — business info, spending caps, invoice prefs
 - `branchDatabases` — per-branch Neon/CNPG database bindings (ADR-070)
 - `ciSettings` — org + repo CI configuration (runners, secrets, policy)
-- `edgeDeployments` — Vercel-edge / Workers-style function releases
 - `github` — GitHub App installation + repo discovery
 - `kv` — KV admin (operator dashboard; distinct from BaaS `kv` in `@sylphx/sdk`)
 - `management` — self-hosted runtime database backups / PITR restore (ADR-070)
@@ -76,9 +94,9 @@ rationale).
 ### Changes
 
 - **Beta API surface.** Per [ADR-077](https://github.com/SylphxAI/platform/blob/main/docs/adr/ADR-077-trio-completeness.md), the Promise-based pure-functional interface is the target public contract. No classes, no `this`, no hidden state — `createClient` returns a frozen value, and every capability is a free function that takes `client` as its first argument. Shape is NOT yet frozen; still iterating in 0.x.
-- **46 capability namespaces** (in-flight; count may change before stable) covering the full Management plane: `projects`, `deployments`, `environments`, `envVars`, `domains`, `databases`, `services`, `volumes`, `storage`, `secrets`, `tasks`, `resourceBindings`, `organizations`, `users`, `sandboxes`, `functions`, `logs`, `email` (admin), `notifications` (admin/inbox), `monitoring`, `analytics`, `flags`, `experiments`, `remoteConfig`, `ai`, `webhooks`, `runners`, `backups`, `billing`, `certs`, `consent`, `engagement`, `newsletter`, `oidc`, `privacy`, `realtime`, `referrals`, `saml`, `search`, `serviceTokens`, `sessionReplay`.
+- **Capability namespaces** (in-flight; count may change before stable) covering the Management plane: `projects`, `deployments`, `environments`, `envVars`, `domains`, `databases`, `services`, `volumes`, `storage`, `secrets`, `tasks`, `resourceBindings`, `organizations`, `users`, `sandboxes`, `logs`, `email` (admin), `notifications` (admin/inbox), `monitoring`, `analytics`, `flags`, `experiments`, `remoteConfig`, `ai`, `webhooks`, `runners`, `backups`, `billing`, `certs`, `consent`, `engagement`, `newsletter`, `oidc`, `privacy`, `realtime`, `referrals`, `saml`, `search`, `serviceTokens`, `sessionReplay`. Function lifecycle is withheld until the Management API owns `/projects/:projectId/functions/*`.
 - **Contract-first types** ([ADR-084](https://github.com/SylphxAI/platform/blob/main/docs/adr/ADR-084-effect-schema-contract.md)). Wire types and endpoint metadata (method + path) are imported from [`@sylphx/contract`](https://www.npmjs.com/package/@sylphx/contract) — the Effect Schema SSOT. Hand-written type shims were removed; the contract package is the only place wire shape is defined.
-- **Bearer-token auth.** `createClient({ token })` accepts both user session tokens (`slx_...`) and service tokens (`sk_...`). The same SDK works for CLI / CI / backend integrations on the Management plane (`api.sylphx.com/v1`).
+- **Bearer-token auth.** `createClient({ token })` accepts service tokens (`svc_...`) and OAuth access JWTs. The same SDK works for CLI / CI / backend integrations on the Management plane (`api.sylphx.com/v1`).
 - **Tree-shakable subpath exports.** Every namespace is also reachable as `@sylphx/management/projects`, `@sylphx/management/deployments`, etc. `sideEffects: false` for bundler-friendly dead-code elimination.
 - **ESM-only.** `"type": "module"`, Node ≥ 20, uses the built-in `fetch`. No classes, no polyfills, no peer framework required.
 

package/README.md

@@ -4,8 +4,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)
 
 Pure-FP Promise client for the [Sylphx Platform](https://sylphx.com)
-Management API — **46 capability namespaces, contract-first types, zero
-classes**.
+Management API — **contract-first capability namespaces, zero classes**.
 
 The SDK is a thin, stateless transport over `api.sylphx.com/v1`. No classes,
 no mutable state, no business logic — consumers create an immutable `Client`
@@ -17,8 +16,8 @@ Effect Schema single source of truth (ADR-084).
 > **Scope: Management plane only** (ADR-083). This SDK covers platform-owner
 > operations (project / deployment / environment / secret / domain / audit
 > / billing / SAML / OIDC / webhooks / privacy / analytics admin, …) on
-> `api.sylphx.com/v1` with Bearer tokens (`slx_...` user / `sk_...`
-> service). For app-runtime data-plane operations (auth, KV, transactional
+> `api.sylphx.com/v1` with Bearer tokens (`svc_...` service tokens or
+> OAuth access JWTs). For app-runtime data-plane operations (auth, KV, transactional
 > email, push, realtime, `flags.evaluate`, search, analytics.track, AI,
 > storage uploads, end-user session replay) use
 > [`@sylphx/sdk`](https://www.npmjs.com/package/@sylphx/sdk) — one package,
@@ -30,8 +29,8 @@ Effect Schema single source of truth (ADR-084).
 
 - Node.js `>= 20` (uses built-in `fetch`) — or Bun `>= 1.3`
 - A Sylphx API token:
-  - **User session token** (`slx_...`) — sign in at `sylphx.com` and run `sylphx auth token`
-  - **Service token** (`sk_...`) — for CI / server-side automation, created under project → Tokens
+  - **OAuth access token** (`eyJ...`) — minted by the OAuth/device flow and suitable for user-scoped automation
+  - **Service token** (`svc_...`) — for CI / server-side automation, created through the Management API / CLI token flow
 
 ## Installation
 
@@ -78,8 +77,8 @@ await projects.list(client)
 
 ## Capabilities
 
-46 namespaces. Every module exports free functions that take `client` as
-the first argument. Key namespaces:
+Every module exports free functions that take `client` as the first
+argument. Key namespaces:
 
 | Namespace            | Representative functions                                                                   |
 | -------------------- | ------------------------------------------------------------------------------------------ |
@@ -99,7 +98,6 @@ the first argument. Key namespaces:
 | `resourceBindings`   | `list`, `create`, `delete`                                                                 |
 | `organizations`      | `current`, `listMembers`, `inviteMember`, `removeMember`                                   |
 | `sandboxes`          | `create`, `list`, `get`, `terminate`                                                       |
-| `functions`          | `list`, `get`, `deploy`, `delete`, `invoke`, `logs`                                        |
 | `logs`               | `stream` (returns `{ url, token }` for SSE)                                                |
 | `email`              | `listLogs`, `getSettings`, `updateSettings` (admin only — `send` lives in `@sylphx/sdk`)   |
 | `notifications`      | `listInbox` (admin only — `send` lives in `@sylphx/sdk`)                                   |
@@ -124,6 +122,10 @@ the first argument. Key namespaces:
 Full, IDE-autocompleted surface is available on the re-exported
 namespaces from the root `@sylphx/management` entry point.
 
+Serverless function lifecycle is intentionally absent from the Management SDK
+until the Management API owns `/projects/:projectId/functions/*`. Runtime
+function execution remains on `@sylphx/sdk`.
+
 > **Plane discipline (ADR-083).** Runtime BaaS verbs — `kv.*`, `email.send`,
 > `notifications.send`, MFA `challenge.*`, `flags.evaluate`,
 > `analytics.track` — are **not** part of `@sylphx/management`. Deployed

package/dist/adminBranchDatabases.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `@sylphx/management/adminBranchDatabases` — operator branch DB recovery.
+ *
+ * Mirrors `/operator/branch-databases/*`. These functions are for scoped
+ * service tokens and incident automation; customer/user branch DB CRUD remains
+ * in `branchDatabases.ts`.
+ */
+import type { AdminBranchDatabaseCreateInput, AdminBranchDatabaseDestroyInput, AdminBranchDatabaseMutationResult } from '@sylphx/contract';
+import type { Client } from './client.js';
+export type { AdminBranchDatabaseCreateInput, AdminBranchDatabaseDestroyInput, AdminBranchDatabaseMutationResult, };
+export declare const create: (client: Client, input: AdminBranchDatabaseCreateInput) => Promise<AdminBranchDatabaseMutationResult>;
+export declare const destroy: (client: Client, input: AdminBranchDatabaseDestroyInput) => Promise<AdminBranchDatabaseMutationResult>;
+//# sourceMappingURL=adminBranchDatabases.d.ts.map

package/dist/adminBranchDatabases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adminBranchDatabases.d.ts","sourceRoot":"","sources":["../src/adminBranchDatabases.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACX,8BAA8B,EAC9B,+BAA+B,EAC/B,iCAAiC,EACjC,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,YAAY,EACX,8BAA8B,EAC9B,+BAA+B,EAC/B,iCAAiC,GACjC,CAAA;AAED,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,OAAO,8BAA8B,KACnC,OAAO,CAAC,iCAAiC,CAG3C,CAAA;AAED,eAAO,MAAM,OAAO,GACnB,QAAQ,MAAM,EACd,OAAO,+BAA+B,KACpC,OAAO,CAAC,iCAAiC,CAG3C,CAAA"}

package/dist/adminBranchDatabases.js

@@ -0,0 +1,17 @@
+/**
+ * `@sylphx/management/adminBranchDatabases` — operator branch DB recovery.
+ *
+ * Mirrors `/operator/branch-databases/*`. These functions are for scoped
+ * service tokens and incident automation; customer/user branch DB CRUD remains
+ * in `branchDatabases.ts`.
+ */
+import { adminBranchDatabasesEndpoints } from '@sylphx/contract';
+import { request } from './http.js';
+export const create = (client, input) => {
+    const { method, path } = adminBranchDatabasesEndpoints.create;
+    return request(client, method, path, { body: input });
+};
+export const destroy = (client, input) => {
+    const { method, path } = adminBranchDatabasesEndpoints.destroy;
+    return request(client, method, path, { body: input });
+};

package/dist/adminProjectCredentials.d.ts

@@ -2,8 +2,9 @@
  * `@sylphx/management/adminProjectCredentials` — operator BaaS credential rotation.
  *
  * Rotates an environment's `sk_*` / `pk_*` pair and optionally syncs the new
- * `sk_*` into the environment-level `SYLPHX_SECRET_KEY` app secret so the
- * reconciler updates deployed workloads through the normal desired-state path.
+ * server connection URL into the environment-level `SYLPHX_SECRET_URL` app
+ * secret so the reconciler updates deployed workloads through the normal
+ * desired-state path.
  */
 import type { Client } from './client.js';
 export interface RotateEnvironmentCredentialsInput {
@@ -11,7 +12,7 @@ export interface RotateEnvironmentCredentialsInput {
     readonly environmentId: string;
     /** Audit narrative. Min 3 chars. */
     readonly reason: string;
-    /** When true, upsert shared env var `SYLPHX_SECRET_KEY` and queue reconciliation. */
+    /** When true, upsert shared env var `SYLPHX_SECRET_URL` and queue reconciliation. */
     readonly syncDeploymentSecret?: boolean;
 }
 export interface RotateEnvironmentCredentialsBySlugInput {
@@ -21,12 +22,12 @@ export interface RotateEnvironmentCredentialsBySlugInput {
     readonly environmentName: string;
     /** Audit narrative. Min 3 chars. */
     readonly reason: string;
-    /** When true, upsert shared env var `SYLPHX_SECRET_KEY` and queue reconciliation. */
+    /** When true, upsert shared env var `SYLPHX_SECRET_URL` and queue reconciliation. */
     readonly syncDeploymentSecret?: boolean;
 }
 export interface RotateEnvironmentCredentialsResult {
     readonly environmentId: string;
-    readonly envType: 'development' | 'staging' | 'production';
+    readonly envType: 'development' | 'staging' | 'production' | 'preview';
     /** Raw secret key, returned once. Do not log. */
     readonly secretKey: string;
     readonly publicKey: string;

package/dist/adminProjectCredentials.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adminProjectCredentials.d.ts","sourceRoot":"","sources":["../src/adminProjectCredentials.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,WAAW,iCAAiC;IACjD,kDAAkD;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,qFAAqF;IACrF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;CACvC;AAED,MAAM,WAAW,uCAAuC;IACvD,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,qFAAqF;IACrF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;CACvC;AAED,MAAM,WAAW,kCAAkC;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,CAAA;IAC1D,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAA;IACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC3B;AAED,eAAO,MAAM,4BAA4B,GACxC,QAAQ,MAAM,EACd,OAAO,iCAAiC,KACtC,OAAO,CAAC,kCAAkC,CAa5C,CAAA;AAED,eAAO,MAAM,kCAAkC,GAC9C,QAAQ,MAAM,EACd,OAAO,uCAAuC,KAC5C,OAAO,CAAC,kCAAkC,CAe5C,CAAA"}
+{"version":3,"file":"adminProjectCredentials.d.ts","sourceRoot":"","sources":["../src/adminProjectCredentials.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,WAAW,iCAAiC;IACjD,kDAAkD;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,qFAAqF;IACrF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;CACvC;AAED,MAAM,WAAW,uCAAuC;IACvD,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,qFAAqF;IACrF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;CACvC;AAED,MAAM,WAAW,kCAAkC;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAA;IACtE,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAA;IACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC3B;AAED,eAAO,MAAM,4BAA4B,GACxC,QAAQ,MAAM,EACd,OAAO,iCAAiC,KACtC,OAAO,CAAC,kCAAkC,CAa5C,CAAA;AAED,eAAO,MAAM,kCAAkC,GAC9C,QAAQ,MAAM,EACd,OAAO,uCAAuC,KAC5C,OAAO,CAAC,kCAAkC,CAe5C,CAAA"}

package/dist/adminProjectCredentials.js

@@ -2,8 +2,9 @@
  * `@sylphx/management/adminProjectCredentials` — operator BaaS credential rotation.
  *
  * Rotates an environment's `sk_*` / `pk_*` pair and optionally syncs the new
- * `sk_*` into the environment-level `SYLPHX_SECRET_KEY` app secret so the
- * reconciler updates deployed workloads through the normal desired-state path.
+ * server connection URL into the environment-level `SYLPHX_SECRET_URL` app
+ * secret so the reconciler updates deployed workloads through the normal
+ * desired-state path.
  */
 import { adminProjectsEndpoints } from '@sylphx/contract';
 import { request } from './http.js';

package/dist/billing.d.ts

@@ -9,6 +9,9 @@
  * Stripe has accepted the update, so callers see the new tier immediately.
  */
 import type { Client } from './client.js';
+export interface OrgScopedRequestOptions {
+    readonly orgId?: string;
+}
 export interface CurrentPlan {
     readonly id: string;
     readonly planSlug: string;
@@ -18,7 +21,7 @@ export interface CurrentPlan {
     readonly currentPeriodEnd: string | null;
     readonly cancelAtPeriodEnd?: boolean;
 }
-export declare const getCurrentPlan: (client: Client, projectId: string) => Promise<CurrentPlan | null>;
+export declare const getCurrentPlan: (client: Client, projectId: string, options?: OrgScopedRequestOptions) => Promise<CurrentPlan | null>;
 export interface PlanListing {
     readonly id: string;
     readonly slug: string;
@@ -29,7 +32,7 @@ export interface PlanListing {
     readonly priceAnnual: number | null;
     readonly priceLifetime: number | null;
 }
-export declare const listPlans: (client: Client, projectId: string) => Promise<{
+export declare const listPlans: (client: Client, projectId: string, options?: OrgScopedRequestOptions) => Promise<{
     plans: readonly PlanListing[];
 }>;
 export type PlanInterval = 'monthly' | 'annual' | 'lifetime';
@@ -42,7 +45,7 @@ export interface UpgradeResult {
         readonly currentPeriodEnd: string;
     };
 }
-export declare const upgrade: (client: Client, projectId: string, userId: string, newPlanSlug: string, newInterval?: PlanInterval) => Promise<UpgradeResult>;
+export declare const upgrade: (client: Client, projectId: string, userId: string, newPlanSlug: string, newInterval?: PlanInterval, options?: OrgScopedRequestOptions) => Promise<UpgradeResult>;
 export interface UsageMetric {
     readonly used: number;
     readonly unit: string;
@@ -60,7 +63,7 @@ export interface UsageSummary {
 }
 export declare const usageSummary: (client: Client, projectId: string, options?: {
     month?: string;
-}) => Promise<UsageSummary>;
+}, requestOptions?: OrgScopedRequestOptions) => Promise<UsageSummary>;
 export interface Balance {
     readonly balanceFormatted?: string;
     readonly balanceMicrodollars?: number;
@@ -70,7 +73,7 @@ export interface Balance {
         readonly totalFormatted?: string;
     } | null;
 }
-export declare const balance: (client: Client, projectId: string) => Promise<Balance>;
+export declare const balance: (client: Client, projectId: string, options?: OrgScopedRequestOptions) => Promise<Balance>;
 export interface CreditPackage {
     readonly id: string;
     readonly label: string;
@@ -92,7 +95,7 @@ export interface Invoice {
 }
 export declare const listInvoices: (client: Client, projectId: string, options?: {
     limit?: number;
-}) => Promise<{
+}, requestOptions?: OrgScopedRequestOptions) => Promise<{
     invoices: readonly Invoice[];
 }>;
 /**
@@ -101,5 +104,5 @@ export declare const listInvoices: (client: Client, projectId: string, options?:
  * pipeline lands. Callers that persist this to disk should remain
  * type-agnostic (`unknown`) rather than latching onto the current shape.
  */
-export declare const invoiceDetail: (client: Client, projectId: string, invoiceId: string) => Promise<unknown>;
+export declare const invoiceDetail: (client: Client, projectId: string, invoiceId: string, options?: OrgScopedRequestOptions) => Promise<unknown>;
 //# sourceMappingURL=billing.d.ts.map

package/dist/billing.d.ts.map

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

package/dist/billing.js

@@ -9,9 +9,18 @@
  * Stripe has accepted the update, so callers see the new tier immediately.
  */
 import { request } from './http.js';
-export const getCurrentPlan = (client, projectId) => request(client, 'GET', '/billing/subscription/me', { query: { projectId } });
-export const listPlans = (client, projectId) => request(client, 'GET', '/billing/plans', { query: { projectId } });
-export const upgrade = (client, projectId, userId, newPlanSlug, newInterval) => request(client, 'POST', '/billing/subscription/update', {
+const orgHeaders = (options = {}) => ({
+    ...(options.orgId ? { 'x-preferred-org-id': options.orgId } : {}),
+});
+export const getCurrentPlan = (client, projectId, options = {}) => request(client, 'GET', '/billing/subscription/me', {
+    query: { projectId },
+    headers: orgHeaders(options),
+});
+export const listPlans = (client, projectId, options = {}) => request(client, 'GET', '/billing/plans', {
+    query: { projectId },
+    headers: orgHeaders(options),
+});
+export const upgrade = (client, projectId, userId, newPlanSlug, newInterval, options = {}) => request(client, 'POST', '/billing/subscription/update', {
     body: {
         projectId,
         userId,
@@ -19,17 +28,23 @@ export const upgrade = (client, projectId, userId, newPlanSlug, newInterval) =>
         ...(newInterval ? { newInterval } : {}),
         prorationBehavior: 'create_prorations',
     },
+    headers: orgHeaders(options),
 });
-export const usageSummary = (client, projectId, options) => request(client, 'GET', '/billing/usage/summary', {
+export const usageSummary = (client, projectId, options, requestOptions = {}) => request(client, 'GET', '/billing/usage/summary', {
     query: { projectId, month: options?.month },
+    headers: orgHeaders(requestOptions),
+});
+export const balance = (client, projectId, options = {}) => request(client, 'GET', '/billing/balance', {
+    query: { projectId },
+    headers: orgHeaders(options),
 });
-export const balance = (client, projectId) => request(client, 'GET', '/billing/balance', { query: { projectId } });
 export const creditPackages = (client) => request(client, 'GET', '/billing/credits/packages');
-export const listInvoices = (client, projectId, options) => request(client, 'GET', '/billing/invoices', {
+export const listInvoices = (client, projectId, options, requestOptions = {}) => request(client, 'GET', '/billing/invoices', {
     query: {
         projectId,
         limit: options?.limit !== undefined ? String(options.limit) : undefined,
     },
+    headers: orgHeaders(requestOptions),
 });
 /**
  * Fetch structured invoice detail. Returns the raw server document —
@@ -37,6 +52,7 @@ export const listInvoices = (client, projectId, options) => request(client, 'GET
  * pipeline lands. Callers that persist this to disk should remain
  * type-agnostic (`unknown`) rather than latching onto the current shape.
  */
-export const invoiceDetail = (client, projectId, invoiceId) => request(client, 'GET', '/billing/invoices/detail', {
+export const invoiceDetail = (client, projectId, invoiceId, options = {}) => request(client, 'GET', '/billing/invoices/detail', {
     query: { projectId, invoiceId },
+    headers: orgHeaders(options),
 });

package/dist/databases.js

@@ -4,25 +4,25 @@
  *
  * Wire shape sourced from `@sylphx/contract` (ADR-084).
  */
-import { databasesEndpoints } from '@sylphx/contract';
+import { databasesEndpoints, resourcesEndpoints } from '@sylphx/contract';
 import { interpolatePath, request } from './http.js';
 export const list = async (client) => {
-    const { method, path } = databasesEndpoints.list;
+    const { method, path } = resourcesEndpoints.list;
     const res = await request(client, method, path, {
         query: { kind: 'database' },
     });
     return Array.isArray(res) ? res : (res.data ?? []);
 };
 export const create = (client, input) => {
-    const { method, path } = databasesEndpoints.create;
+    const { method, path } = resourcesEndpoints.create;
     return request(client, method, path, { body: { ...input, kind: 'database' } });
 };
 export const get = (client, id) => {
-    const { method, path } = databasesEndpoints.get;
+    const { method, path } = resourcesEndpoints.get;
     return request(client, method, interpolatePath(path, { id }));
 };
 const _delete = (client, id) => {
-    const { method, path } = databasesEndpoints.delete;
+    const { method, path } = resourcesEndpoints.delete;
     return request(client, method, interpolatePath(path, { id }));
 };
 export { _delete as delete };

package/dist/deployments.d.ts

@@ -3,20 +3,26 @@
  *
  * Wire shape sourced from `@sylphx/contract` (ADR-084).
  */
-import type { DeploymentDetail, DeploymentStatus, DeployResult, RollbackDeploymentInput } from '@sylphx/contract';
+import type { BuildDetail, CancelBuildResult, DeploymentDetail, DeploymentHistoryItem, DeploymentStatus, DeployResult, RollbackDeploymentInput, RollbackResult } from '@sylphx/contract';
 import type { Client } from './client.js';
-export declare const status: (client: Client, projectId: string) => Promise<DeploymentStatus>;
-export declare const get: (client: Client, deploymentId: string) => Promise<DeploymentDetail>;
-export declare const trigger: (client: Client, projectId: string, envType: string) => Promise<DeployResult>;
-export declare const history: (client: Client, projectId: string, envType: string) => Promise<DeployResult[]>;
+export type DeploymentHistoryRow = DeploymentHistoryItem & {
+    readonly deploymentId: DeploymentHistoryItem['id'];
+    readonly environment?: string;
+};
+export interface OrgScopedRequestOptions {
+    readonly orgId?: string;
+}
+export declare const status: (client: Client, projectId: string, options?: OrgScopedRequestOptions) => Promise<DeploymentStatus>;
+export declare const get: (client: Client, deploymentId: string, options?: OrgScopedRequestOptions) => Promise<DeploymentDetail>;
+export declare const getBuild: (client: Client, buildId: string, options?: OrgScopedRequestOptions) => Promise<BuildDetail>;
+export declare const trigger: (client: Client, projectId: string, envType: string, options?: OrgScopedRequestOptions) => Promise<DeployResult>;
+export declare const history: (client: Client, projectId: string, envType: string, options?: OrgScopedRequestOptions) => Promise<DeploymentHistoryRow[]>;
 export type RollbackBody = RollbackDeploymentInput;
-export declare const rollback: (client: Client, projectId: string, body: RollbackBody) => Promise<DeployResult>;
+export declare const rollback: (client: Client, projectId: string, body: RollbackBody, options?: OrgScopedRequestOptions) => Promise<RollbackResult>;
 /**
  * Cancel an in-flight build. Terminal builds (`ready` / `error` /
  * `cancelled`) return 409. Phase 4b closure for ADR-089 Matrix 2.
  */
-export declare const cancel: (client: Client, buildId: string) => Promise<{
-    success: boolean;
-}>;
-export type { DeploymentDetail } from '@sylphx/contract';
+export declare const cancel: (client: Client, buildId: string) => Promise<CancelBuildResult>;
+export type { BuildDetail, DeploymentDetail, DeploymentHistoryItem, DeploymentHistoryResult, RollbackResult, } from '@sylphx/contract';
 //# sourceMappingURL=deployments.d.ts.map

package/dist/deployments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../src/deployments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACvB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,WAAW,MAAM,KAAG,OAAO,CAAC,gBAAgB,CAGlF,CAAA;AAED,eAAO,MAAM,GAAG,GAAI,QAAQ,MAAM,EAAE,cAAc,MAAM,KAAG,OAAO,CAAC,gBAAgB,CAGlF,CAAA;AAED,eAAO,MAAM,OAAO,GACnB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,SAAS,MAAM,KACb,OAAO,CAAC,YAAY,CAKtB,CAAA;AAED,eAAO,MAAM,OAAO,GACnB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,SAAS,MAAM,KACb,OAAO,CAAC,YAAY,EAAE,CAKxB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,uBAAuB,CAAA;AAElD,eAAO,MAAM,QAAQ,GACpB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,MAAM,YAAY,KAChB,OAAO,CAAC,YAAY,CAGtB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,SAAS,MAAM,KAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAGpF,CAAA;AAID,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../src/deployments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EAErB,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACvB,cAAc,EACd,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,GAAG;IAC1D,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC,IAAI,CAAC,CAAA;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAOD,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAS,uBAA4B,KACnC,OAAO,CAAC,gBAAgB,CAK1B,CAAA;AAED,eAAO,MAAM,GAAG,GACf,QAAQ,MAAM,EACd,cAAc,MAAM,EACpB,UAAS,uBAA4B,KACnC,OAAO,CAAC,gBAAgB,CAK1B,CAAA;AAED,eAAO,MAAM,QAAQ,GACpB,QAAQ,MAAM,EACd,SAAS,MAAM,EACf,UAAS,uBAA4B,KACnC,OAAO,CAAC,WAAW,CAKrB,CAAA;AAED,eAAO,MAAM,OAAO,GACnB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,UAAS,uBAA4B,KACnC,OAAO,CAAC,YAAY,CAMtB,CAAA;AAED,eAAO,MAAM,OAAO,GACnB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,UAAS,uBAA4B,KACnC,OAAO,CAAC,oBAAoB,EAAE,CAShC,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,uBAAuB,CAAA;AAElD,eAAO,MAAM,QAAQ,GACpB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,MAAM,YAAY,EAClB,UAAS,uBAA4B,KACnC,OAAO,CAAC,cAAc,CAMxB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,SAAS,MAAM,KAAG,OAAO,CAAC,iBAAiB,CAGjF,CAAA;AAID,YAAY,EACX,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,GACd,MAAM,kBAAkB,CAAA"}

package/dist/deployments.js

@@ -5,29 +5,47 @@
  */
 import { deploymentsEndpoints } from '@sylphx/contract';
 import { interpolatePath, request } from './http.js';
-export const status = (client, projectId) => {
+export const status = (client, projectId, options = {}) => {
     const { method, path } = deploymentsEndpoints.status;
-    return request(client, method, interpolatePath(path, { id: projectId }));
+    return request(client, method, interpolatePath(path, { id: projectId }), {
+        headers: { 'x-preferred-org-id': options.orgId },
+    });
 };
-export const get = (client, deploymentId) => {
+export const get = (client, deploymentId, options = {}) => {
     const { method, path } = deploymentsEndpoints.get;
-    return request(client, method, interpolatePath(path, { id: deploymentId }));
+    return request(client, method, interpolatePath(path, { id: deploymentId }), {
+        headers: { 'x-preferred-org-id': options.orgId },
+    });
 };
-export const trigger = (client, projectId, envType) => {
+export const getBuild = (client, buildId, options = {}) => {
+    const { method, path } = deploymentsEndpoints.envScopedBuildDetail;
+    return request(client, method, interpolatePath(path, { buildId }), {
+        headers: { 'x-preferred-org-id': options.orgId },
+    });
+};
+export const trigger = (client, projectId, envType, options = {}) => {
     const { method, path } = deploymentsEndpoints.trigger;
     return request(client, method, interpolatePath(path, { id: projectId }), {
         body: { envType },
+        headers: { 'x-preferred-org-id': options.orgId },
     });
 };
-export const history = (client, projectId, envType) => {
+export const history = (client, projectId, envType, options = {}) => {
     const { method, path } = deploymentsEndpoints.history;
     return request(client, method, interpolatePath(path, { id: projectId }), {
         query: { envType },
+        headers: { 'x-preferred-org-id': options.orgId },
+    }).then((response) => {
+        const rows = isHistoryEnvelope(response) ? response.data : response;
+        return rows.map(normalizeHistoryRow);
     });
 };
-export const rollback = (client, projectId, body) => {
+export const rollback = (client, projectId, body, options = {}) => {
     const { method, path } = deploymentsEndpoints.rollback;
-    return request(client, method, interpolatePath(path, { id: projectId }), { body });
+    return request(client, method, interpolatePath(path, { id: projectId }), {
+        body,
+        headers: { 'x-preferred-org-id': options.orgId },
+    });
 };
 /**
  * Cancel an in-flight build. Terminal builds (`ready` / `error` /
@@ -37,3 +55,26 @@ export const cancel = (client, buildId) => {
     const { method, path } = deploymentsEndpoints.envScopedCancelBuild;
     return request(client, method, interpolatePath(path, { buildId }));
 };
+function normalizeHistoryRow(row) {
+    const record = row;
+    const id = typeof record.id === 'string'
+        ? record.id
+        : typeof record.deploymentId === 'string'
+            ? record.deploymentId
+            : '';
+    const envType = typeof record.envType === 'string' ? record.envType : null;
+    const environment = typeof record.environment === 'string'
+        ? record.environment
+        : envType === null
+            ? undefined
+            : envType;
+    const normalized = {
+        ...row,
+        id: id,
+        deploymentId: id,
+    };
+    return environment === undefined ? normalized : { ...normalized, environment };
+}
+function isHistoryEnvelope(response) {
+    return !Array.isArray(response);
+}

package/dist/domains.d.ts

@@ -8,19 +8,22 @@
  */
 import type { AddHostnameInput, DomainEmailBinding, DomainHostname, Domain as DomainResult } from '@sylphx/contract';
 import type { Client } from './client.js';
-export declare const list: (client: Client, projectId: string, envType?: string) => Promise<DomainResult[]>;
-export declare const create: (client: Client, projectId: string, apexDomain: string, envType?: string) => Promise<DomainResult>;
+export interface OrgScopedRequestOptions {
+    readonly orgId?: string;
+}
+export declare const list: (client: Client, projectId: string, envType?: string, options?: OrgScopedRequestOptions) => Promise<DomainResult[]>;
+export declare const create: (client: Client, projectId: string, apexDomain: string, envType?: string, options?: OrgScopedRequestOptions) => Promise<DomainResult>;
 export interface AddHostnameOpts extends Omit<AddHostnameInput, 'hostname'> {
     readonly envType?: string;
 }
-export declare const addHostname: (client: Client, projectId: string, domainId: string, hostname: string, opts?: AddHostnameOpts) => Promise<DomainHostname>;
-export declare const removeHostname: (client: Client, projectId: string, domainId: string, hostnameId: string) => Promise<void>;
-export declare const checkHostname: (client: Client, projectId: string, domainId: string, hostnameId: string) => Promise<DomainHostname>;
+export declare const addHostname: (client: Client, projectId: string, domainId: string, hostname: string, opts?: AddHostnameOpts, options?: OrgScopedRequestOptions) => Promise<DomainHostname>;
+export declare const removeHostname: (client: Client, projectId: string, domainId: string, hostnameId: string, options?: OrgScopedRequestOptions) => Promise<void>;
+export declare const checkHostname: (client: Client, projectId: string, domainId: string, hostnameId: string, options?: OrgScopedRequestOptions) => Promise<DomainHostname>;
 export interface EnableEmailOpts {
     readonly defaultFromEmail?: string;
     readonly defaultFromName?: string;
 }
-export declare const enableEmail: (client: Client, projectId: string, domainId: string, opts?: EnableEmailOpts) => Promise<DomainEmailBinding>;
-export declare const checkEmail: (client: Client, projectId: string, domainId: string) => Promise<DomainEmailBinding>;
-export declare const disableEmail: (client: Client, projectId: string, domainId: string) => Promise<void>;
+export declare const enableEmail: (client: Client, projectId: string, domainId: string, opts?: EnableEmailOpts, options?: OrgScopedRequestOptions) => Promise<DomainEmailBinding>;
+export declare const checkEmail: (client: Client, projectId: string, domainId: string, options?: OrgScopedRequestOptions) => Promise<DomainEmailBinding>;
+export declare const disableEmail: (client: Client, projectId: string, domainId: string, options?: OrgScopedRequestOptions) => Promise<void>;
 //# sourceMappingURL=domains.d.ts.map

package/dist/domains.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../src/domains.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACX,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,MAAM,IAAI,YAAY,EACtB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,eAAO,MAAM,IAAI,GAChB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,gBAAsB,KACpB,OAAO,CAAC,YAAY,EAAE,CAKxB,CAAA;AAED,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,YAAY,MAAM,EAClB,gBAAsB,KACpB,OAAO,CAAC,YAAY,CAKtB,CAAA;AAED,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,eAAO,MAAM,WAAW,GACvB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,UAAU,MAAM,EAChB,OAAO,eAAe,KACpB,OAAO,CAAC,cAAc,CAOxB,CAAA;AAED,eAAO,MAAM,cAAc,GAC1B,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,YAAY,MAAM,KAChB,OAAO,CAAC,IAAI,CAGd,CAAA;AAID,eAAO,MAAM,aAAa,GACzB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,YAAY,MAAM,KAChB,OAAO,CAAC,cAAc,CAKvB,CAAA;AAEF,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,eAAO,MAAM,WAAW,GACvB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,OAAO,eAAe,KACpB,OAAO,CAAC,kBAAkB,CAM3B,CAAA;AAEF,eAAO,MAAM,UAAU,GACtB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,KACd,OAAO,CAAC,kBAAkB,CAK3B,CAAA;AAEF,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,EAAE,WAAW,MAAM,EAAE,UAAU,MAAM,KAAG,OAAO,CAAC,IAAI,CAK7F,CAAA"}
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../src/domains.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACX,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,MAAM,IAAI,YAAY,EACtB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAQD,eAAO,MAAM,IAAI,GAChB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,gBAAsB,EACtB,UAAS,uBAA4B,KACnC,OAAO,CAAC,YAAY,EAAE,CAMxB,CAAA;AAED,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,YAAY,MAAM,EAClB,gBAAsB,EACtB,UAAS,uBAA4B,KACnC,OAAO,CAAC,YAAY,CAMtB,CAAA;AAED,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,eAAO,MAAM,WAAW,GACvB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,UAAU,MAAM,EAChB,OAAO,eAAe,EACtB,UAAS,uBAA4B,KACnC,OAAO,CAAC,cAAc,CAQxB,CAAA;AAED,eAAO,MAAM,cAAc,GAC1B,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,YAAY,MAAM,EAClB,UAAS,uBAA4B,KACnC,OAAO,CAAC,IAAI,CAKd,CAAA;AAID,eAAO,MAAM,aAAa,GACzB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,YAAY,MAAM,EAClB,UAAS,uBAA4B,KACnC,OAAO,CAAC,cAAc,CAMvB,CAAA;AAEF,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,eAAO,MAAM,WAAW,GACvB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,OAAO,eAAe,EACtB,UAAS,uBAA4B,KACnC,OAAO,CAAC,kBAAkB,CAM3B,CAAA;AAEF,eAAO,MAAM,UAAU,GACtB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,UAAS,uBAA4B,KACnC,OAAO,CAAC,kBAAkB,CAM3B,CAAA;AAEF,eAAO,MAAM,YAAY,GACxB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,UAAS,uBAA4B,KACnC,OAAO,CAAC,IAAI,CAMb,CAAA"}

package/dist/domains.js

@@ -8,32 +8,40 @@
  */
 import { domainsEndpoints } from '@sylphx/contract';
 import { interpolatePath, request } from './http.js';
-export const list = (client, projectId, envType = 'production') => {
+const orgHeaders = (options = {}) => ({
+    ...(options.orgId ? { 'x-preferred-org-id': options.orgId } : {}),
+});
+export const list = (client, projectId, envType = 'production', options = {}) => {
     const { method, path } = domainsEndpoints.list;
     return request(client, method, interpolatePath(path, { projectId }), {
         query: { envType },
+        headers: orgHeaders(options),
     });
 };
-export const create = (client, projectId, apexDomain, envType = 'production') => {
+export const create = (client, projectId, apexDomain, envType = 'production', options = {}) => {
     const { method, path } = domainsEndpoints.create;
     return request(client, method, interpolatePath(path, { projectId }), {
         body: { apexDomain, envType },
+        headers: orgHeaders(options),
     });
 };
-export const addHostname = (client, projectId, domainId, hostname, opts) => {
+export const addHostname = (client, projectId, domainId, hostname, opts, options = {}) => {
     const { method, path } = domainsEndpoints.addHostname;
     const { envType = 'production', ...body } = opts ?? {};
     return request(client, method, interpolatePath(path, { projectId, domainId }), {
         query: { envType },
         body: { hostname, ...body },
+        headers: orgHeaders(options),
     });
 };
-export const removeHostname = (client, projectId, domainId, hostnameId) => {
+export const removeHostname = (client, projectId, domainId, hostnameId, options = {}) => {
     const { method, path } = domainsEndpoints.removeHostname;
-    return request(client, method, interpolatePath(path, { projectId, domainId, hostnameId }));
+    return request(client, method, interpolatePath(path, { projectId, domainId, hostnameId }), {
+        headers: orgHeaders(options),
+    });
 };
 // ---- Not yet in @sylphx/contract (future wave) ---------------------------
-export const checkHostname = (client, projectId, domainId, hostnameId) => request(client, 'POST', `/projects/${encodeURIComponent(projectId)}/domains/${encodeURIComponent(domainId)}/hostnames/${encodeURIComponent(hostnameId)}/check`);
-export const enableEmail = (client, projectId, domainId, opts) => request(client, 'POST', `/projects/${encodeURIComponent(projectId)}/domains/${encodeURIComponent(domainId)}/email`, { body: opts ?? {} });
-export const checkEmail = (client, projectId, domainId) => request(client, 'POST', `/projects/${encodeURIComponent(projectId)}/domains/${encodeURIComponent(domainId)}/email/check`);
-export const disableEmail = (client, projectId, domainId) => request(client, 'DELETE', `/projects/${encodeURIComponent(projectId)}/domains/${encodeURIComponent(domainId)}/email`);
+export const checkHostname = (client, projectId, domainId, hostnameId, options = {}) => request(client, 'POST', `/projects/${encodeURIComponent(projectId)}/domains/${encodeURIComponent(domainId)}/hostnames/${encodeURIComponent(hostnameId)}/check`, { headers: orgHeaders(options) });
+export const enableEmail = (client, projectId, domainId, opts, options = {}) => request(client, 'POST', `/projects/${encodeURIComponent(projectId)}/domains/${encodeURIComponent(domainId)}/email`, { body: opts ?? {}, headers: orgHeaders(options) });
+export const checkEmail = (client, projectId, domainId, options = {}) => request(client, 'POST', `/projects/${encodeURIComponent(projectId)}/domains/${encodeURIComponent(domainId)}/email/check`, { headers: orgHeaders(options) });
+export const disableEmail = (client, projectId, domainId, options = {}) => request(client, 'DELETE', `/projects/${encodeURIComponent(projectId)}/domains/${encodeURIComponent(domainId)}/email`, { headers: orgHeaders(options) });