@run402/sdk 4.93.2 → 4.95.0

package/dist/namespaces/deploy.js

@@ -246,7 +246,7 @@ export class Deploy {
     /**
      * Promote an existing release to be the project's current live release —
      * a pointer swap on `internal.projects.live_release_id` without re-running
-     * the apply pipeline. Designed for operator recovery from a destructive
+     * the apply pipeline. Designed for recovery from a destructive
      * apply ("oops on a real project ID"). The prior release's bytes,
      * functions, and migrations remain persisted; this just routes traffic
      * back to them.
@@ -301,7 +301,7 @@ export class Deploy {
                 context: "promoting release",
                 headers: { "content-type": "application/json" },
                 body: {
-                    project,
+                    project_id: project,
                     allow_warning_codes: allowCodes,
                 },
             });
@@ -688,7 +688,7 @@ async function applyOnce(client, spec, opts, emit) {
         // event and resolve before we hit upload.
     }
     if (target === "core") {
-        await uploadCoreContent(client, spec.project, byteReaders, emit);
+        await uploadCoreContent(client, spec.project_id, byteReaders, emit);
         emit({
             type: "commit.phase",
             phase: "validate",
@@ -696,13 +696,13 @@ async function applyOnce(client, spec, opts, emit) {
             ...(sliceKinds.length > 0 ? { slice_kinds: sliceKinds } : {}),
         });
         const planId = requirePlanId(plan, "applying deploy to Core");
-        const commit = await commitInternal(client, planId, opts.idempotencyKey, spec.project, opts.requiredPlan);
+        const commit = await commitInternal(client, planId, opts.idempotencyKey, spec.project_id, opts.requiredPlan);
         if (!isCoreCommitResponse(commit)) {
-            return await pollUntilReady(client, commit, plan.diff, plan.warnings, emit, spec.project, sliceKinds);
+            return await pollUntilReady(client, commit, plan.diff, plan.warnings, emit, spec.project_id, sliceKinds);
         }
-        return await coreDeployResult(client, commit, plan.diff, plan.warnings, emit, spec.project, sliceKinds);
+        return await coreDeployResult(client, commit, plan.diff, plan.warnings, emit, spec.project_id, sliceKinds);
     }
-    await uploadMissing(client, spec.project, plan.missing_content, byteReaders, emit);
+    await uploadMissing(client, spec.project_id, plan.missing_content, byteReaders, emit);
     emit({
         type: "commit.phase",
         phase: "validate",
@@ -717,7 +717,7 @@ async function applyOnce(client, spec, opts, emit) {
     // protect and commits directly. A passed rehearsal binds the commit to the
     // report's `required_plan` — unbound commits of rehearsed plans are
     // refused by the gateway.
-    const rehearsal = await rehearseBeforeCommit(client, plan, planId, spec.project, opts, emit);
+    const rehearsal = await rehearseBeforeCommit(client, plan, planId, spec.project_id, opts, emit);
     const requiredPlan = rehearsal.requiredPlan ?? opts.requiredPlan;
     // gitvault §6.5 — the handshake. Content is uploaded, so the artifacts this
     // release ships are fixed; `authorize` verifies snapshot correspondence,
@@ -731,8 +731,8 @@ async function applyOnce(client, spec, opts, emit) {
             apply_plan_sha256: plan.gitvault?.apply_plan_sha256 ?? null,
         })
         : undefined;
-    const commit = requireCloudCommitResponse(await commitInternal(client, planId, opts.idempotencyKey, spec.project, requiredPlan, gitvaultCommit), "applying deploy");
-    const result = await pollUntilReady(client, commit, plan.diff, plan.warnings, emit, spec.project, sliceKinds);
+    const commit = requireCloudCommitResponse(await commitInternal(client, planId, opts.idempotencyKey, spec.project_id, requiredPlan, gitvaultCommit), "applying deploy");
+    const result = await pollUntilReady(client, commit, plan.diff, plan.warnings, emit, spec.project_id, sliceKinds);
     result.rehearsal = rehearsal.block;
     // v1.48 unified-apply: thread the plan response's `asset_entries[]` back
     // into DeployResult.assets so callers reading `result.assets.byKey[key]`
@@ -1110,7 +1110,7 @@ function i18nToWire(i18n) {
 }
 function releaseSpecToCoreSpec(spec) {
     return {
-        project: spec.project,
+        project: spec.project_id,
         ...(spec.base !== undefined ? { base: spec.base } : {}),
         ...(spec.database !== undefined ? { database: databaseToCoreSpec(spec.database) } : {}),
         ...(spec.secrets !== undefined ? { secrets: spec.secrets } : {}),
@@ -1125,7 +1125,7 @@ function releaseSpecToCoreSpec(spec) {
 }
 function releaseSpecToWire(spec) {
     return {
-        project_id: spec.project,
+        project_id: spec.project_id,
         ...(spec.base !== undefined ? { base: spec.base } : {}),
         ...(spec.database !== undefined ? { database: databaseToWire(spec.database) } : {}),
         ...(spec.secrets !== undefined ? { secrets: spec.secrets } : {}),
@@ -1208,8 +1208,8 @@ async function planInternal(client, spec, idempotencyKey, opts = {}) {
         // can pick it up via `manifest_ref`. The body still carries a minimal
         // `spec` so the gateway has the project for auth + plan persistence.
         const manifestBytes = new TextEncoder().encode(JSON.stringify(wireSpec));
-        const ref = await uploadInlineCas(client, spec.project, manifestBytes, MANIFEST_CONTENT_TYPE);
-        body = { spec: { project_id: spec.project }, manifest_ref: contentRefToWire(ref) };
+        const ref = await uploadInlineCas(client, spec.project_id, manifestBytes, MANIFEST_CONTENT_TYPE);
+        body = { spec: { project_id: spec.project_id }, manifest_ref: contentRefToWire(ref) };
         if (idempotencyKey)
             body.idempotency_key = idempotencyKey;
         if (opts.gitvault)
@@ -1220,8 +1220,8 @@ async function planInternal(client, spec, idempotencyKey, opts = {}) {
         plan = withClientPlanWarnings(normalized, normalizePlanResponse(await client.request(dryRun ? "/apply/v1/plans?dry_run=true" : "/apply/v1/plans", {
             method: "POST",
             body,
-            // Operator-approval scope: deploying a release is `project.deploy` on this project.
-            authMeta: { method: "deploy.plan", capability: "project.deploy", target: { project_id: spec.project } },
+            // Write-approval scope: deploying a release is `project.deploy` on this project.
+            authMeta: { method: "deploy.plan", capability: "project.deploy", target: { project_id: spec.project_id } },
             context: "planning deploy",
         })));
     }
@@ -1402,7 +1402,7 @@ async function computeDesiredScheduledFunctionCount(client, spec) {
     }
     if (!functions.patch)
         return null;
-    const activeScheduled = await readActiveScheduledFunctionNames(client, spec.project);
+    const activeScheduled = await readActiveScheduledFunctionNames(client, spec.project_id);
     if (!activeScheduled)
         return null;
     applyScheduledFunctionPatch(activeScheduled, functions.patch);
@@ -1603,7 +1603,7 @@ async function commitInternal(client, planId, idempotencyKey, project, requiredP
         return await client.request(`/apply/v1/plans/${encodeURIComponent(planId)}/commit`, {
             method: "POST",
             body,
-            // Operator-approval scope: committing a deploy is `project.deploy` on this project.
+            // Write-approval scope: committing a deploy is `project.deploy` on this project.
             ...(project
                 ? {
                     authMeta: {
@@ -1862,7 +1862,7 @@ async function pollUntilReady(client, commit, diff, warnings, emit, projectId, s
             ...(commit.subdomain_bindings ? { subdomain_bindings: commit.subdomain_bindings } : {}),
             ...(commit.static_continuity ? { static_continuity: commit.static_continuity } : {}),
             ...(commit.edge ? { edge: commit.edge } : {}),
-            // The gateway's riders (poll / watch_errors / hand_to_operator) ride the
+            // The gateway's riders (poll / watch_errors / hand_to_member) ride the
             // synchronous ready response and nowhere else — dropping them here is
             // how an agent never learns the offer existed (builder-promotion).
             ...(Array.isArray(commit.next_actions) && commit.next_actions.length > 0
@@ -1971,7 +1971,7 @@ async function pollSnapshotUntilReady(client, initial, diff, warnings, emit, pro
                 ...(snapshot.edge ? { edge: snapshot.edge } : {}),
                 // The gateway now attaches the same riders to a ready operation
                 // snapshot as to a synchronous ready commit (poll / watch_errors /
-                // hand_to_operator) — pass them through exactly as the fast path does.
+                // hand_to_member) — pass them through exactly as the fast path does.
                 ...(Array.isArray(snapshot.next_actions) && snapshot.next_actions.length > 0
                     ? { next_actions: snapshot.next_actions }
                     : {}),
@@ -2093,7 +2093,7 @@ async function startInternal(client, spec, opts) {
     }
     const sliceKinds = deriveSliceKinds(spec);
     const resultPromise = (async () => {
-        await uploadMissing(client, spec.project, plan.missing_content, byteReaders, emit);
+        await uploadMissing(client, spec.project_id, plan.missing_content, byteReaders, emit);
         emit({
             type: "commit.phase",
             phase: "validate",
@@ -2101,15 +2101,15 @@ async function startInternal(client, spec, opts) {
             ...(sliceKinds.length > 0 ? { slice_kinds: sliceKinds } : {}),
         });
         const { planId } = requirePersistedPlan(plan, "starting deploy");
-        const commit = requireCloudCommitResponse(await commitInternal(client, planId, opts.idempotencyKey, spec.project, opts.requiredPlan), "starting deploy");
-        return await pollUntilReady(client, commit, plan.diff, plan.warnings, emit, spec.project, sliceKinds);
+        const commit = requireCloudCommitResponse(await commitInternal(client, planId, opts.idempotencyKey, spec.project_id, opts.requiredPlan), "starting deploy");
+        return await pollUntilReady(client, commit, plan.diff, plan.warnings, emit, spec.project_id, sliceKinds);
     })();
     // Avoid an unhandled-rejection at construction time. Consumers must call
     // .result() to actually observe the error.
     resultPromise.catch(() => { });
     let snapshot = null;
     const { operationId } = requirePersistedPlan(plan, "starting deploy");
-    const startHeaders = await apikeyHeaders(client, spec.project);
+    const startHeaders = await apikeyHeaders(client, spec.project_id);
     const fetchSnapshot = async () => {
         if (snapshot && TERMINAL_STATUSES.includes(snapshot.status))
             return snapshot;
@@ -2200,7 +2200,7 @@ async function startInternal(client, spec, opts) {
 }
 const RELEASE_SPEC_FIELDS = new Set([
     "$schema",
-    "project",
+    "project_id",
     "base",
     "database",
     "secrets",
@@ -2282,16 +2282,15 @@ function validateSpec(spec) {
     }
     const raw = spec;
     validateKnownFields(raw, "spec", RELEASE_SPEC_FIELDS, {
-        project_id: "Use `project` in ReleaseSpec, or call `loadDeployManifest()` / `normalizeDeployManifest()` for MCP/CLI-style manifests.",
         subdomain: "Use `subdomains: { set: [name] }`.",
     });
-    if (!spec.project || typeof spec.project !== "string") {
-        throw new Run402DeployError("ReleaseSpec.project is required", {
+    if (!spec.project_id || typeof spec.project_id !== "string") {
+        throw new Run402DeployError("ReleaseSpec.project_id is required", {
             code: "INVALID_SPEC",
             phase: "validate",
-            resource: "spec.project",
+            resource: "spec.project_id",
             retryable: false,
-            fix: { action: "set_field", path: "project" },
+            fix: { action: "set_field", path: "project_id" },
             context: "validating spec",
         });
     }
@@ -3357,7 +3356,7 @@ async function normalizeReleaseSpec(client, spec, opts = {}) {
     };
     const rememberRelease = makeRemember("release");
     const rememberAsset = makeRemember("asset");
-    const normalized = { project: spec.project };
+    const normalized = { project_id: spec.project_id };
     if (spec.base)
         normalized.base = spec.base;
     if (spec.subdomains)
@@ -3380,7 +3379,7 @@ async function normalizeReleaseSpec(client, spec, opts = {}) {
             db.zero_downtime = spec.database.zero_downtime;
         }
         if (spec.database.migrations && spec.database.migrations.length > 0) {
-            db.migrations = await Promise.all(spec.database.migrations.map(async (m) => normalizeMigration(client, spec.project, m, rememberRelease, opts)));
+            db.migrations = await Promise.all(spec.database.migrations.map(async (m) => normalizeMigration(client, spec.project_id, m, rememberRelease, opts)));
             assertUniqueMigrationIds(db.migrations);
         }
         normalized.database = db;