@run402/sdk 3.5.5 → 3.5.6

package/README.md

@@ -10,7 +10,7 @@ npm install @run402/sdk
 
 | Import | Use when |
 |---|---|
-| `@run402/sdk/node` | Running in Node 22 with the local keystore + allowance. Auto-loads the configured API base, `~/.config/run402/projects.json`, and signs x402 payments from `~/.config/run402/allowance.json`. Includes `r.sites.deployDir(dir)`, `fileSetFromDir(dir)`, `loadDeployManifest(path)`, and `normalizeDeployManifest(input)`. |
+| `@run402/sdk/node` | Running in Node 22 with the local keystore + allowance. Auto-loads the configured API base, `~/.config/run402/projects.json`, and signs x402 payments from `~/.config/run402/allowance.json`. Includes `r.sites.deployDir(dir)`, `fileSetFromDir(dir)`, `loadDeployManifest(path)`, `normalizeDeployManifest(input)`, and `resolveRun402TargetProfile()`. |
 | `@run402/sdk` | Isomorphic — works in Node, Deno, Bun, V8 isolates. No filesystem access. Bring your own `CredentialsProvider` (a session-token shim, a remote vault, anything that resolves project keys + auth headers). |
 
 ## Quick start (Node)
@@ -27,6 +27,33 @@ That's it — credentials are read, x402 payments are signed, results are typed.
 
 For a self-hosted Run402 Core Gateway, run `run402 init --api-base=http://my-core:4020` once. The Node SDK then targets that API base by default; explicit `run402({ apiBase })` still wins.
 
+App build scripts should use the same target/profile store instead of parsing `target.json` or `projects.json`:
+
+```ts
+import { resolveRun402TargetProfile } from "@run402/sdk/node";
+
+const target = resolveRun402TargetProfile({
+  requiredTarget: "core",
+  requireProject: true,
+  requireAnonKey: true,
+});
+
+console.log(target.apiBase, target.projectId, target.anonKey);
+```
+
+For app-specific legacy env names, pass aliases:
+
+```ts
+import { resolveRun402TargetProfile } from "@run402/sdk/node";
+
+resolveRun402TargetProfile({
+  envAliases: {
+    projectId: ["MY_APP_PROJECT_ID"],
+    anonKey: ["MY_APP_ANON_KEY"],
+  },
+});
+```
+
 ### Project-scoped sub-client
 
 Most operations are project-scoped. Bind once and skip the id arg on every call:

package/core-dist/config.js

@@ -191,11 +191,28 @@ export function getApiTargetKind() {
     const cfg = readApiTargetConfig();
     return cfg?.target_kind ?? "unknown";
 }
+function stripTrailingSlashes(value) {
+    return value.replace(/\/+$/, "");
+}
+function isExplicitHttpCoreTarget(apiBase) {
+    if (stripTrailingSlashes(apiBase) === stripTrailingSlashes(DEFAULT_API_BASE))
+        return false;
+    try {
+        return new URL(apiBase).protocol === "http:";
+    }
+    catch {
+        return false;
+    }
+}
 export function isCoreApiTarget() {
+    const apiBase = getApiBase();
     const cfg = readApiTargetConfig();
-    if (cfg?.target_kind !== "core" || !cfg.api_base)
-        return false;
-    return getApiBase().replace(/\/+$/, "") === cfg.api_base.replace(/\/+$/, "");
+    if (cfg?.target_kind === "core" && cfg.api_base) {
+        return stripTrailingSlashes(apiBase) === stripTrailingSlashes(cfg.api_base);
+    }
+    if (process.env.RUN402_API_BASE !== undefined && isExplicitHttpCoreTarget(apiBase))
+        return true;
+    return false;
 }
 export function getAllowancePath() {
     if (process.env.RUN402_ALLOWANCE_PATH)

package/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/dist/namespaces/deploy.js

@@ -658,6 +658,16 @@ function contentRefToWire(ref) {
         ...(ref.integrity ? { integrity: ref.integrity } : {}),
     };
 }
+function contentRefToCoreSpec(ref) {
+    const maybeWire = ref;
+    const contentType = ref.contentType ?? maybeWire.content_type;
+    return {
+        sha256: ref.sha256,
+        size: ref.size,
+        ...(contentType ? { contentType } : {}),
+        ...(ref.integrity ? { integrity: ref.integrity } : {}),
+    };
+}
 function requireContentRef(ref, resource) {
     if (ref)
         return ref;
@@ -675,6 +685,12 @@ function fileSetToWire(map) {
         out[path] = contentRefToWire(ref);
     return out;
 }
+function fileSetToCoreSpec(map) {
+    const out = {};
+    for (const [path, ref] of Object.entries(map))
+        out[path] = contentRefToCoreSpec(ref);
+    return out;
+}
 function requireRoleToWire(gate) {
     return {
         table: gate.table,
@@ -686,6 +702,21 @@ function requireRoleToWire(gate) {
         ...(gate.signInPath !== undefined ? { sign_in_path: gate.signInPath } : {}),
     };
 }
+function functionToCoreSpec(fn) {
+    return {
+        ...(fn.runtime !== undefined ? { runtime: fn.runtime } : {}),
+        ...(fn.source !== undefined ? { source: contentRefToCoreSpec(fn.source) } : {}),
+        ...(fn.files !== undefined ? { files: fileSetToCoreSpec(fn.files) } : {}),
+        ...(fn.entrypoint !== undefined ? { entrypoint: fn.entrypoint } : {}),
+        ...(fn.config !== undefined ? { config: fn.config } : {}),
+        ...(fn.deps !== undefined ? { deps: fn.deps } : {}),
+        ...(fn.schedule !== undefined ? { schedule: fn.schedule } : {}),
+        ...(fn.requireAuth !== undefined ? { requireAuth: fn.requireAuth } : {}),
+        ...(fn.requireRole !== undefined ? { requireRole: fn.requireRole } : {}),
+        ...(fn.class !== undefined ? { class: fn.class } : {}),
+        ...(fn.capabilities !== undefined ? { capabilities: fn.capabilities } : {}),
+    };
+}
 function functionToWire(fn) {
     return {
         ...(fn.runtime !== undefined ? { runtime: fn.runtime } : {}),
@@ -716,6 +747,25 @@ function functionMapToWire(map) {
         out[name] = functionToWire(fn);
     return out;
 }
+function functionMapToCoreSpec(map) {
+    const out = {};
+    for (const [name, fn] of Object.entries(map))
+        out[name] = functionToCoreSpec(fn);
+    return out;
+}
+function functionsToCoreSpec(functions) {
+    return {
+        ...(functions.replace !== undefined ? { replace: functionMapToCoreSpec(functions.replace) } : {}),
+        ...(functions.patch !== undefined
+            ? {
+                patch: {
+                    ...(functions.patch.set !== undefined ? { set: functionMapToCoreSpec(functions.patch.set) } : {}),
+                    ...(functions.patch.delete !== undefined ? { delete: functions.patch.delete } : {}),
+                },
+            }
+            : {}),
+    };
+}
 function databaseToWire(database) {
     return {
         ...(database.expose !== undefined ? { expose: database.expose } : {}),
@@ -734,6 +784,24 @@ function databaseToWire(database) {
             : {}),
     };
 }
+function databaseToCoreSpec(database) {
+    return {
+        ...(database.expose !== undefined ? { expose: database.expose } : {}),
+        ...(database.zero_downtime !== undefined ? { zero_downtime: database.zero_downtime } : {}),
+        ...(database.migrations !== undefined
+            ? {
+                migrations: database.migrations.map((m) => ({
+                    id: m.id,
+                    checksum: m.checksum,
+                    ...(m.sql !== undefined
+                        ? { sql: m.sql }
+                        : { sql_ref: contentRefToCoreSpec(requireContentRef(m.sql_ref, `database.migrations.${m.id}.sql_ref`)) }),
+                    ...(m.transaction !== undefined ? { transaction: m.transaction } : {}),
+                })),
+            }
+            : {}),
+    };
+}
 function functionsToWire(functions) {
     return {
         ...(functions.replace !== undefined ? { replace: functionMapToWire(functions.replace) } : {}),
@@ -747,6 +815,24 @@ function functionsToWire(functions) {
             : {}),
     };
 }
+function siteToCoreSpec(site) {
+    if ("replace" in site && site.replace) {
+        return {
+            replace: fileSetToCoreSpec(site.replace),
+            ...(site.public_paths ? { public_paths: site.public_paths } : {}),
+        };
+    }
+    if ("patch" in site && site.patch) {
+        return {
+            patch: {
+                ...(site.patch.put ? { put: fileSetToCoreSpec(site.patch.put) } : {}),
+                ...(site.patch.delete ? { delete: site.patch.delete } : {}),
+            },
+            ...(site.public_paths ? { public_paths: site.public_paths } : {}),
+        };
+    }
+    return { public_paths: site.public_paths };
+}
 function siteToWire(site) {
     if ("replace" in site && site.replace) {
         return {
@@ -773,6 +859,21 @@ function i18nToWire(i18n) {
         ...(i18n.unknownLocalePolicy !== undefined ? { unknown_locale_policy: i18n.unknownLocalePolicy } : {}),
     };
 }
+function releaseSpecToCoreSpec(spec) {
+    return {
+        project: spec.project,
+        ...(spec.base !== undefined ? { base: spec.base } : {}),
+        ...(spec.database !== undefined ? { database: databaseToCoreSpec(spec.database) } : {}),
+        ...(spec.secrets !== undefined ? { secrets: spec.secrets } : {}),
+        ...(spec.functions !== undefined ? { functions: functionsToCoreSpec(spec.functions) } : {}),
+        ...(spec.site !== undefined ? { site: siteToCoreSpec(spec.site) } : {}),
+        ...(spec.subdomains !== undefined ? { subdomains: spec.subdomains } : {}),
+        ...(spec.routes !== undefined ? { routes: spec.routes } : {}),
+        ...(spec.checks !== undefined ? { checks: spec.checks } : {}),
+        ...(spec.assets !== undefined ? { assets: spec.assets } : {}),
+        ...(spec.i18n !== undefined ? { i18n: spec.i18n } : {}),
+    };
+}
 function releaseSpecToWire(spec) {
     return {
         project_id: spec.project,
@@ -799,12 +900,13 @@ async function planInternal(client, spec, idempotencyKey, dryRun = false, target
     });
     if (!isCore)
         await preflightTierFunctionLimits(client, normalized, ciCredentials);
-    const wireSpec = releaseSpecToWire(normalized);
-    // The gateway expects { spec, manifest_ref?, idempotency_key? } with
-    // snake_case ReleaseSpec wire JSON. For oversized specs the SDK uploads
-    // the manifest JSON to CAS first and references it; the gateway still
-    // needs `spec` in the body (with at least the project), so we keep a
-    // minimal stub there.
+    const wireSpec = isCore ? releaseSpecToCoreSpec(normalized) : releaseSpecToWire(normalized);
+    // The gateway expects { spec, manifest_ref?, idempotency_key? }. Cloud
+    // receives the legacy snake_case apply wire shape; Core receives the
+    // open ReleaseSpec shape from @run402/release. For oversized Cloud specs
+    // the SDK uploads the manifest JSON to CAS first and references it; the
+    // gateway still needs `spec` in the body (with at least the project), so
+    // we keep a minimal stub there.
     const inlineBody = { spec: wireSpec };
     if (idempotencyKey && !dryRun)
         inlineBody.idempotency_key = idempotencyKey;