@run402/sdk 3.5.4 → 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 `~/.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)
@@ -25,6 +25,35 @@ await (await r.project(project.project_id)).assets.put("hello.txt", { content: "
 
 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.d.ts

@@ -1,4 +1,14 @@
+export declare const DEFAULT_API_BASE = "https://api.run402.com";
+export type ApiTargetKind = "cloud" | "core" | "unknown";
+export interface ApiTargetConfig {
+    api_base?: string;
+    target_kind?: ApiTargetKind;
+    updated_at?: string;
+    health_status?: string;
+    health_error?: string;
+}
 export declare function getApiBase(): string;
+export declare function getApiBaseSource(): "env" | "profile" | "default";
 /**
  * API base for the deploy-v2 routes. Defaults to the same value as
  * `getApiBase()`. Set `RUN402_DEPLOY_API_BASE` to point only deploy traffic
@@ -35,5 +45,14 @@ export declare function getProfilesDir(): string;
  */
 export declare function getConfigDir(): string;
 export declare function getKeystorePath(): string;
+export declare function getApiTargetConfigPath(): string;
+export declare function readApiTargetConfig(path?: string): ApiTargetConfig | null;
+export declare function saveApiTargetConfig(config: ApiTargetConfig, path?: string): void;
+export declare function configureApiBase(apiBase: string, options?: Omit<ApiTargetConfig, "api_base" | "updated_at"> & {
+    updated_at?: string;
+}): ApiTargetConfig;
+export declare function getConfiguredApiBase(): string | null;
+export declare function getApiTargetKind(): ApiTargetKind;
+export declare function isCoreApiTarget(): boolean;
 export declare function getAllowancePath(): string;
 //# sourceMappingURL=config.d.ts.map

package/core-dist/config.js

@@ -1,7 +1,8 @@
 import { homedir } from "node:os";
-import { join } from "node:path";
-import { existsSync, renameSync, mkdirSync, chmodSync } from "node:fs";
-const DEFAULT_API_BASE = "https://api.run402.com";
+import { dirname, join } from "node:path";
+import { existsSync, renameSync, mkdirSync, chmodSync, readFileSync, writeFileSync } from "node:fs";
+import { randomBytes } from "node:crypto";
+export const DEFAULT_API_BASE = "https://api.run402.com";
 /**
  * Validate a user-supplied API base URL. Throws a clear error message that
  * names the env var when the URL is malformed or uses a scheme other than
@@ -33,7 +34,12 @@ function validateApiBase(envVar, raw, fallback) {
 }
 export function getApiBase() {
     const validated = validateApiBase("RUN402_API_BASE", process.env.RUN402_API_BASE, DEFAULT_API_BASE);
-    return validated ?? DEFAULT_API_BASE;
+    return validated ?? getConfiguredApiBase() ?? DEFAULT_API_BASE;
+}
+export function getApiBaseSource() {
+    if (process.env.RUN402_API_BASE !== undefined)
+        return "env";
+    return getConfiguredApiBase() ? "profile" : "default";
 }
 /**
  * API base for the deploy-v2 routes. Defaults to the same value as
@@ -115,6 +121,99 @@ export function getConfigDir() {
 export function getKeystorePath() {
     return join(getConfigDir(), "projects.json");
 }
+export function getApiTargetConfigPath() {
+    return join(getConfigDir(), "target.json");
+}
+export function readApiTargetConfig(path) {
+    const p = path ?? getApiTargetConfigPath();
+    try {
+        const parsed = JSON.parse(readFileSync(p, "utf-8"));
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            return null;
+        const cfg = parsed;
+        if (cfg.api_base !== undefined && typeof cfg.api_base !== "string")
+            return null;
+        if (cfg.target_kind !== undefined &&
+            cfg.target_kind !== "cloud" &&
+            cfg.target_kind !== "core" &&
+            cfg.target_kind !== "unknown") {
+            return null;
+        }
+        return cfg;
+    }
+    catch {
+        return null;
+    }
+}
+function atomicWrite(path, content, mode) {
+    const dir = dirname(path);
+    mkdirSync(dir, { recursive: true });
+    const tmp = join(dir, `.target.${randomBytes(4).toString("hex")}.tmp`);
+    writeFileSync(tmp, content, { mode });
+    renameSync(tmp, path);
+    try {
+        chmodSync(path, mode);
+    }
+    catch {
+        /* best-effort on non-POSIX */
+    }
+}
+export function saveApiTargetConfig(config, path) {
+    const p = path ?? getApiTargetConfigPath();
+    atomicWrite(p, JSON.stringify(config, null, 2), 0o600);
+}
+export function configureApiBase(apiBase, options = {}) {
+    if (apiBase === "") {
+        throw new Error("api_base must be a non-empty http(s) URL.");
+    }
+    const validated = validateApiBase("api_base", apiBase, DEFAULT_API_BASE);
+    if (!validated) {
+        throw new Error("api_base must be a non-empty http(s) URL.");
+    }
+    const config = {
+        api_base: validated.replace(/\/+$/, ""),
+        target_kind: options.target_kind ?? "unknown",
+        updated_at: options.updated_at ?? new Date().toISOString(),
+        ...(options.health_status ? { health_status: options.health_status } : {}),
+        ...(options.health_error ? { health_error: options.health_error } : {}),
+    };
+    saveApiTargetConfig(config);
+    return config;
+}
+export function getConfiguredApiBase() {
+    const cfg = readApiTargetConfig();
+    if (!cfg?.api_base)
+        return null;
+    const validated = validateApiBase("api_base", cfg.api_base, DEFAULT_API_BASE);
+    return validated ? validated.replace(/\/+$/, "") : null;
+}
+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 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)
         return 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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"}