run402-mcp 4.0.2 → 4.1.0

package/sdk/dist/namespaces/branches.js

@@ -0,0 +1,92 @@
+import { LocalError } from "../errors.js";
+export class Branches {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async create(projectId, opts = {}) {
+        assertProjectId(projectId, "creating project branch");
+        const body = {};
+        if (opts.fromSnapshotId !== undefined)
+            body.from_snapshot_id = opts.fromSnapshotId;
+        if (opts.name !== undefined)
+            body.name = opts.name;
+        if (opts.emailMode !== undefined)
+            body.email_mode = opts.emailMode;
+        if (opts.enableCron !== undefined)
+            body.enable_cron = opts.enableCron;
+        if (opts.ttlDays !== undefined)
+            body.ttl_days = opts.ttlDays;
+        const result = await this.client.request(branchCollectionPath(projectId), {
+            method: "POST",
+            body,
+            authMeta: {
+                method: "branches.create",
+                capability: "project.branches.manage",
+                target: { project_id: projectId },
+            },
+            context: "creating project branch",
+        });
+        if (this.client.credentials.saveProject) {
+            await this.client.credentials.saveProject(result.branch_project_id, {
+                anon_key: result.anon_key,
+                service_key: result.service_key,
+                ...(result.branch_url ? { site_url: result.branch_url } : {}),
+            });
+        }
+        return result;
+    }
+    async list(projectId) {
+        assertProjectId(projectId, "listing project branches");
+        return this.client.request(branchCollectionPath(projectId), {
+            authMeta: {
+                method: "branches.list",
+                capability: "project.branches.manage",
+                target: { project_id: projectId },
+            },
+            context: "listing project branches",
+        });
+    }
+    async renew(projectId, branchProjectId, opts = {}) {
+        assertProjectId(projectId, "renewing project branch");
+        assertProjectId(branchProjectId, "renewing project branch");
+        const body = {};
+        if (opts.ttlDays !== undefined)
+            body.ttl_days = opts.ttlDays;
+        return this.client.request(`${branchPath(projectId, branchProjectId)}/renew`, {
+            method: "POST",
+            body,
+            authMeta: {
+                method: "branches.renew",
+                capability: "project.branches.manage",
+                target: { project_id: projectId },
+            },
+            context: "renewing project branch",
+        });
+    }
+    async delete(projectId, branchProjectId) {
+        assertProjectId(projectId, "deleting project branch");
+        assertProjectId(branchProjectId, "deleting project branch");
+        await this.client.request(branchPath(projectId, branchProjectId), {
+            method: "DELETE",
+            authMeta: {
+                method: "branches.delete",
+                capability: "project.branches.manage",
+                target: { project_id: projectId },
+            },
+            context: "deleting project branch",
+        });
+    }
+}
+function branchCollectionPath(projectId) {
+    return `/projects/v1/${encodeURIComponent(projectId)}/branches`;
+}
+function branchPath(projectId, branchProjectId) {
+    return `${branchCollectionPath(projectId)}/${encodeURIComponent(branchProjectId)}`;
+}
+function assertProjectId(value, context) {
+    if (!value || typeof value !== "string") {
+        throw new LocalError("branches helper requires a projectId", context);
+    }
+}
+//# sourceMappingURL=branches.js.map

package/sdk/dist/namespaces/branches.js.map

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

package/sdk/dist/namespaces/branches.types.d.ts

@@ -0,0 +1,48 @@
+export type ProjectBranchEmailMode = "sandbox" | "off";
+export interface ProjectBranchNextAction {
+    type: string;
+    command?: string;
+    message: string;
+    [key: string]: unknown;
+}
+export interface ProjectBranchDto {
+    branch_project_id: string;
+    parent_project_id: string;
+    name: string;
+    branch_url: string | null;
+    subdomain: string | null;
+    status: "active" | (string & {});
+    email_mode: ProjectBranchEmailMode | (string & {});
+    enable_cron: boolean;
+    data_from: {
+        snapshot_id: string | null;
+        captured_at: string | null;
+    };
+    release: {
+        parent_release_id: string | null;
+        branch_release_id: string | null;
+    };
+    expires_at: string;
+    created_at: string;
+    next_actions: ProjectBranchNextAction[];
+}
+export interface ProjectBranchCreateOptions {
+    fromSnapshotId?: string;
+    name?: string;
+    emailMode?: ProjectBranchEmailMode;
+    enableCron?: boolean;
+    ttlDays?: number;
+}
+export interface ProjectBranchCreateResult extends ProjectBranchDto {
+    operation_id: string;
+    materialization_id: string;
+    anon_key: string;
+    service_key: string;
+}
+export interface ProjectBranchesListResult {
+    branches: ProjectBranchDto[];
+}
+export interface ProjectBranchRenewOptions {
+    ttlDays?: number;
+}
+//# sourceMappingURL=branches.types.d.ts.map

package/sdk/dist/namespaces/branches.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branches.types.d.ts","sourceRoot":"","sources":["../../src/namespaces/branches.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,KAAK,CAAC;AAEvD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACjC,UAAU,EAAE,sBAAsB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACnD,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE;QACT,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC;IACF,OAAO,EAAE;QACP,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;KAClC,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,uBAAuB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,0BAA0B;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/sdk/dist/namespaces/branches.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=branches.types.js.map

package/sdk/dist/namespaces/branches.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branches.types.js","sourceRoot":"","sources":["../../src/namespaces/branches.types.ts"],"names":[],"mappings":""}

package/sdk/dist/namespaces/deploy.d.ts

@@ -19,7 +19,7 @@
  * behavior; this file is the implementation.
  */
 import type { Client } from "../kernel.js";
-import type { ApplyOptions, ActiveReleaseInventory, DeployEvent, DeployEventsResponse, DeployListOptions, DeployListResponse, DeployOperation, DeployResult, DeployResolveOptions, DeployResolveResponse, OperationSnapshot, PlanResponse, PromoteOptions, PromoteResult, ReleaseDiffOptions, ReleaseInventory, ReleaseInventoryByIdOptions, ReleaseInventoryOptions, ReleaseSpec, ReleaseToReleaseDiff, StartOptions } from "./deploy.types.js";
+import type { ApplyOptions, ActiveReleaseInventory, DeployEvent, DeployEventsResponse, DeployListOptions, DeployListResponse, DeployOperation, DeployResult, DeployResolveOptions, DeployResolveResponse, EdgeCoherenceReport, EdgeCoherenceWaitOptions, EdgeCoherenceWaitResult, OperationSnapshot, PlanResponse, PromoteOptions, PromoteResult, ReleaseDiffOptions, ReleaseInventory, ReleaseInventoryByIdOptions, ReleaseInventoryOptions, ReleaseSpec, ReleaseToReleaseDiff, RehearsePlanOptions, RehearsePlanResult, StartOptions } from "./deploy.types.js";
 export declare class Deploy {
     private readonly client;
     constructor(client: Client);
@@ -77,6 +77,7 @@ export declare class Deploy {
             planFingerprint?: string;
         };
     }): Promise<DeployResult>;
+    rehearse(planId: string, opts?: RehearsePlanOptions): Promise<RehearsePlanResult>;
     /**
      * Resume an operation in `schema_settling` or `activation_pending`. The
      * gateway re-runs only the failed phase forward — never replays SQL.
@@ -148,6 +149,20 @@ export declare class Deploy {
     events(operationId: string, opts: {
         project: string;
     }): Promise<DeployEventsResponse>;
+    /**
+     * Probe whether the gateway and edge pointers agree on the active release
+     * for an operation. The endpoint requires `apikey` auth, so `project` is
+     * required. Use `waitEdgeCoherent` when you want bounded polling.
+     */
+    edgeCoherence(operationId: string, opts: {
+        project: string;
+    }): Promise<EdgeCoherenceReport>;
+    /**
+     * Poll `edgeCoherence` until the report is coherent or the timeout elapses.
+     * Returns the last report either way so automation can explain stale paths
+     * without issuing a second request.
+     */
+    waitEdgeCoherent(operationId: string, opts: EdgeCoherenceWaitOptions): Promise<EdgeCoherenceWaitResult>;
     /**
      * Fetch a release inventory by id. The endpoint requires `apikey` auth, so
      * pass the owning project id. `siteLimit` controls how many site paths the

package/sdk/dist/namespaces/deploy.d.ts.map

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

package/sdk/dist/namespaces/deploy.js

@@ -174,6 +174,38 @@ export class Deploy {
         const commit = requireCloudCommitResponse(await commitInternal(this.client, planId, opts.idempotencyKey, opts.project, opts.requiredPlan), "committing deploy");
         return await pollUntilReady(this.client, commit, {}, [], emit, opts.project);
     }
+    async rehearse(planId, opts = {}) {
+        if (!planId || typeof planId !== "string") {
+            throw new Run402DeployError(`Invalid plan id: "${String(planId)}"`, {
+                code: "BAD_REQUEST",
+                phase: "rehearsal",
+                retryable: false,
+                context: "rehearsing deploy plan",
+            });
+        }
+        const body = {};
+        if (opts.teardown !== undefined)
+            body.teardown = opts.teardown;
+        try {
+            return await this.client.request(`/apply/v1/plans/${encodeURIComponent(planId)}/rehearse`, {
+                method: "POST",
+                body,
+                ...(opts.project
+                    ? {
+                        authMeta: {
+                            method: "deploy.rehearse",
+                            capability: "project.deploy",
+                            target: { project_id: opts.project },
+                        },
+                    }
+                    : {}),
+                context: "rehearsing deploy plan",
+            });
+        }
+        catch (err) {
+            throw translateDeployError(err, "rehearsal", planId, null);
+        }
+    }
     /**
      * Resume an operation in `schema_settling` or `activation_pending`. The
      * gateway re-runs only the failed phase forward — never replays SQL.
@@ -344,6 +376,57 @@ export class Deploy {
             throw translateDeployError(err, "events", null, operationId);
         }
     }
+    /**
+     * Probe whether the gateway and edge pointers agree on the active release
+     * for an operation. The endpoint requires `apikey` auth, so `project` is
+     * required. Use `waitEdgeCoherent` when you want bounded polling.
+     */
+    async edgeCoherence(operationId, opts) {
+        if (!operationId || !operationId.startsWith("op_")) {
+            throw new Run402DeployError(`Invalid operation id: "${operationId}"`, {
+                code: "OPERATION_NOT_FOUND",
+                retryable: false,
+                context: "verifying deploy edge coherence",
+            });
+        }
+        if (!opts?.project) {
+            throw new LocalError("apply.edgeCoherence requires a project id ({ project: 'prj_...' })", "verifying deploy edge coherence");
+        }
+        const headers = await apikeyHeaders(this.client, opts.project);
+        try {
+            return await this.client.request(`/apply/v1/operations/${encodeURIComponent(operationId)}/edge-coherence`, { headers, context: "verifying deploy edge coherence" });
+        }
+        catch (err) {
+            throw translateDeployError(err, "edge-coherence", null, operationId);
+        }
+    }
+    /**
+     * Poll `edgeCoherence` until the report is coherent or the timeout elapses.
+     * Returns the last report either way so automation can explain stale paths
+     * without issuing a second request.
+     */
+    async waitEdgeCoherent(operationId, opts) {
+        const timeoutMs = normalizePositiveSafeIntegerQueryOption(opts?.timeoutMs ?? 60_000, "apply.waitEdgeCoherent timeoutMs", "waiting for deploy edge coherence") ?? 60_000;
+        const intervalMs = normalizePositiveSafeIntegerQueryOption(opts?.intervalMs ?? 1_000, "apply.waitEdgeCoherent intervalMs", "waiting for deploy edge coherence") ?? 1_000;
+        if (!opts?.project) {
+            throw new LocalError("apply.waitEdgeCoherent requires a project id ({ project: 'prj_...' })", "waiting for deploy edge coherence");
+        }
+        const start = Date.now();
+        let attempts = 0;
+        while (true) {
+            attempts += 1;
+            const report = await this.edgeCoherence(operationId, { project: opts.project });
+            const elapsedMs = Date.now() - start;
+            opts.onPoll?.({ attempts, elapsedMs, report });
+            if (report.coherent) {
+                return { coherent: true, attempts, elapsedMs, report };
+            }
+            if (elapsedMs >= timeoutMs) {
+                return { coherent: false, attempts, elapsedMs, report };
+            }
+            await sleep(Math.min(intervalMs, Math.max(timeoutMs - elapsedMs, 0)));
+        }
+    }
     /**
      * Fetch a release inventory by id. The endpoint requires `apikey` auth, so
      * pass the owning project id. `siteLimit` controls how many site paths the
@@ -1613,6 +1696,7 @@ async function pollUntilReady(client, commit, diff, warnings, emit, projectId, s
             diff,
             warnings,
             ...(commit.subdomain_bindings ? { subdomain_bindings: commit.subdomain_bindings } : {}),
+            ...(commit.edge ? { edge: commit.edge } : {}),
         };
     }
     const opHeaders = projectId ? await apikeyHeaders(client, projectId) : {};
@@ -1712,6 +1796,7 @@ async function pollSnapshotUntilReady(client, initial, diff, warnings, emit, pro
                 diff,
                 warnings,
                 ...(snapshot.subdomain_bindings ? { subdomain_bindings: snapshot.subdomain_bindings } : {}),
+                ...(snapshot.edge ? { edge: snapshot.edge } : {}),
             };
         }
         if (TERMINAL_STATUSES.includes(snapshot.status)) {