@oxy-hq/sdk 2.4.0 → 2.6.0

package/dist/{react-B7Blpmt7.cjs → react-BAiiXftp.cjs}

@@ -30,7 +30,7 @@ let react = require("react");
 react = __toESM(react, 1);
 let react_jsx_runtime = require("react/jsx-runtime");
 
-//#region src/customer-app/logger.ts
+//#region src/custom-app/logger.ts
 let activeLogger = createConsoleLogger();
 /** Replace the global logger. Pass `null` to silence everything. */
 function setOxyAppLogger(logger) {
@@ -70,9 +70,9 @@ function silentLogger() {
 }
 
 //#endregion
-//#region src/customer-app/errors.ts
+//#region src/custom-app/errors.ts
 /**
-* Error thrown by all customer-app hooks when an API call returns a
+* Error thrown by all custom-app hooks when an API call returns a
 * non-2xx response. Carries the structured `code` + `hint` the server
 * emits so bundle UIs can render an actionable message instead of
 * "404: { ...json... }".
@@ -119,12 +119,12 @@ async function apiErrorFromResponse(resp) {
 }
 const ARCH_DOC = "internal-docs/customer-apps.md";
 /** Interpret a thrown error as a structured report for UI display. */
-function interpretCustomerAppError(err) {
+function interpretCustomAppError(err) {
 	const message = err instanceof Error ? err.message : String(err);
 	if (/Failed to load oxy-app\.json.*HTTP 404/.test(message)) return {
 		title: "Manifest not found",
 		message,
-		hint: "The bundle is being served, but oxy-app.json was not. Check that public/oxy-app.json is committed in the customer-app repo and that the build copied it into the static output. If you're using Next.js, anything under public/ is auto-copied to out/.",
+		hint: "The bundle is being served, but oxy-app.json was not. Check that public/oxy-app.json is committed in the custom-app repo and that the build copied it into the static output. If you're using Next.js, anything under public/ is auto-copied to out/.",
 		docs: ARCH_DOC
 	};
 	if (/Failed to load oxy-app\.json/.test(message)) return {
@@ -160,7 +160,7 @@ function interpretCustomerAppError(err) {
 	if (/^403:.*SELECT.*WITH/im.test(message)) return {
 		title: "Query rejected — read-only endpoint",
 		message,
-		hint: "This proxy only runs SELECT or WITH queries. Mutations (INSERT/UPDATE/DELETE/DROP) are not allowed from customer-app bundles.",
+		hint: "This proxy only runs SELECT or WITH queries. Mutations (INSERT/UPDATE/DELETE/DROP) are not allowed from custom-app bundles.",
 		docs: ARCH_DOC
 	};
 	if (/^403:/m.test(message)) return {
@@ -196,7 +196,7 @@ function interpretCustomerAppError(err) {
 	if (/Unexpected token '<'|<!doctype/i.test(message)) return {
 		title: "Fetched HTML where JSON was expected",
 		message,
-		hint: "Most likely the built bundle is stale — built against an old SDK whose endpoints no longer exist on the server. Rebuild the bundle (vite build) with @oxy-hq/sdk@^2.0.0 and reload. If the bundle is current, check that OXY_APP_BASE_PATH matches the path the customer-app row is served at.",
+		hint: "Most likely the built bundle is stale — built against an old SDK whose endpoints no longer exist on the server. Rebuild the bundle (vite build) with @oxy-hq/sdk@^2.0.0 and reload. If the bundle is current, check that OXY_APP_BASE_PATH matches the path the custom-app row is served at.",
 		docs: ARCH_DOC
 	};
 	return {
@@ -208,7 +208,7 @@ function interpretCustomerAppError(err) {
 }
 
 //#endregion
-//#region src/customer-app/inject.ts
+//#region src/custom-app/inject.ts
 /**
 * Read the runtime app-config oxy injected at serve time. Returns
 * `undefined` outside the browser or when the global isn't set
@@ -221,18 +221,18 @@ function readInjectedAppConfig() {
 }
 
 //#endregion
-//#region src/customer-app/manifest.ts
+//#region src/custom-app/manifest.ts
 let cached = null;
 /**
 * Load + validate the manifest. Cached after the first call so callers
 * can invoke this from every component without coordinating.
 */
-function loadCustomerAppManifest(options = {}) {
+function loadCustomAppManifest(options = {}) {
 	if (!cached) cached = fetchAndValidate(options);
 	return cached;
 }
 /** For tests: reset the cache between runs. */
-function _resetCustomerAppManifestCacheForTest() {
+function _resetCustomAppManifestCacheForTest() {
 	cached = null;
 }
 async function fetchAndValidate(options) {
@@ -254,7 +254,7 @@ async function fetchAndValidate(options) {
 			status: res.status,
 			statusText: res.statusText
 		});
-		throw new Error(`Failed to load oxy-app.json from ${manifestUrl} (HTTP ${res.status}). The customer-app repo must commit this file alongside the bundle.`);
+		throw new Error(`Failed to load oxy-app.json from ${manifestUrl} (HTTP ${res.status}). The custom-app repo must commit this file alongside the bundle.`);
 	}
 	const manifest = validateManifest(await res.json(), manifestUrl);
 	const resolved = {
@@ -319,7 +319,7 @@ const FUNCTION_NAME_RE = /^[a-z][a-z0-9-]{0,63}$/;
 /**
 * Validate the optional `functions` map. Each key is a function name;
 * each value declares how the function is invoked. Mirrors the
-* server-side validation in `customer_apps_publish.rs` so a bad
+* server-side validation in `custom_apps_publish.rs` so a bad
 * manifest fails at build, not at publish.
 */
 function validateFunctions(raw) {
@@ -397,7 +397,7 @@ function isRecord(v) {
 }
 
 //#endregion
-//#region src/customer-app/function-invoke.ts
+//#region src/custom-app/function-invoke.ts
 const inflight$1 = /* @__PURE__ */ new Map();
 /**
 * Dedup key for an invocation: function name + its (stable-serialized) body,
@@ -423,7 +423,7 @@ function sharedFunctionInvoke(key, run) {
 }
 
 //#endregion
-//#region src/customer-app/function-sse.ts
+//#region src/custom-app/function-sse.ts
 /**
 * Read a `text/event-stream` function response to completion. Resolves with the
 * decoded result + captured logs, or rejects (with `.logs` attached) on an
@@ -480,7 +480,7 @@ async function readFunctionSseStream(resp) {
 }
 
 //#endregion
-//#region src/customer-app/interpolate.ts
+//#region src/custom-app/interpolate.ts
 /**
 * Interpolate `{{ params.X }}` and `{{ params.X | sqlquote }}` placeholders
 * in a SQL template.
@@ -509,7 +509,7 @@ function interpolateSqlParams(sql, params) {
 }
 
 //#endregion
-//#region src/customer-app/markdown.ts
+//#region src/custom-app/markdown.ts
 /**
 * Allowlist for `[text](url)` href values in agent-emitted markdown.
 * Markdown comes from an LLM, which sits across an external trust
@@ -585,7 +585,7 @@ function isTableStart(lines, idx) {
 }
 
 //#endregion
-//#region src/customer-app/query-cache.ts
+//#region src/custom-app/query-cache.ts
 const SWR_TTL_MS = 3e4;
 const inflight = /* @__PURE__ */ new Map();
 const cache = /* @__PURE__ */ new Map();
@@ -629,28 +629,48 @@ async function sharedQuery(fetcher, projectId, sql, db, opts = {}) {
 }
 
 //#endregion
-//#region src/customer-app/react.tsx
+//#region src/custom-app/react.tsx
 function defaultFetcher(input, init) {
 	return fetch(input, {
 		credentials: "include",
 		...init
 	});
 }
+/**
+* Resolve relative ("/…") request paths against `backendUrl` so the SDK's API
+* calls reach a cross-origin oxy backend instead of the app's own origin.
+*
+* This is what lets a standalone dev app (e.g. served on `localhost:3005`)
+* drive the wired shell — `shell-context`, Ask Oxygen agent asks, events —
+* against oxy on another origin (`localhost:3000`) WITHOUT a same-origin dev
+* proxy. The target origin must permit the app's origin (oxy's main `/api`
+* allows configured dev origins + `credentials`); the external data API is a
+* separate, wildcard-CORS surface.
+*
+* Opt-in: when `backendUrl` is unset the base fetcher is returned unchanged, so
+* apps served same-origin by oxy keep their existing relative-URL behaviour.
+* Absolute URLs and non-string inputs pass through untouched (no double-prefix).
+*/
+function withBackendBase(base, backendUrl) {
+	if (!backendUrl) return base;
+	const origin = backendUrl.replace(/\/+$/, "");
+	return (input, init) => base(typeof input === "string" && input.startsWith("/") ? origin + input : input, init);
+}
 const OxyAppContext = react.createContext(void 0);
 /**
 * Top-level provider. Loads the manifest once on mount; children only
 * render after the manifest is ready (or the error fallback fires).
 */
 function OxyAppProvider(props) {
-	const { manifestOptions, fallback, errorFallback, fetcher: fetcherProp, children } = props;
-	const fetcher = fetcherProp ?? defaultFetcher;
+	const { manifestOptions, fallback, errorFallback, fetcher: fetcherProp, backendUrl, children } = props;
+	const fetcher = react.useMemo(() => withBackendBase(fetcherProp ?? defaultFetcher, backendUrl), [fetcherProp, backendUrl]);
 	const [state, setState] = react.useState({
 		status: "loading",
 		fetcher
 	});
 	react.useEffect(() => {
 		let cancelled = false;
-		loadCustomerAppManifest(manifestOptions).then((resolved) => {
+		loadCustomAppManifest(manifestOptions).then((resolved) => {
 			if (!cancelled) setState({
 				status: "ready",
 				resolved,
@@ -659,7 +679,7 @@ function OxyAppProvider(props) {
 		}).catch((e) => {
 			if (!cancelled) setState({
 				status: "error",
-				error: interpretCustomerAppError(e),
+				error: interpretCustomAppError(e),
 				fetcher
 			});
 		});
@@ -761,7 +781,7 @@ function useOxyApp() {
 }
 /**
 * Execute an ad-hoc SQL query against the project linked to this
-* customer app. The query is specified inline by the caller; no
+* custom app. The query is specified inline by the caller; no
 * manifest declaration is involved.
 *
 * Re-runs whenever `input` or enabled `params` change. Use the
@@ -2292,10 +2312,10 @@ Object.defineProperty(exports, '__toESM', {
     return __toESM;
   }
 });
-Object.defineProperty(exports, '_resetCustomerAppManifestCacheForTest', {
+Object.defineProperty(exports, '_resetCustomAppManifestCacheForTest', {
   enumerable: true,
   get: function () {
-    return _resetCustomerAppManifestCacheForTest;
+    return _resetCustomAppManifestCacheForTest;
   }
 });
 Object.defineProperty(exports, 'apiErrorFromResponse', {
@@ -2310,16 +2330,16 @@ Object.defineProperty(exports, 'getOxyAppLogger', {
     return getOxyAppLogger;
   }
 });
-Object.defineProperty(exports, 'interpretCustomerAppError', {
+Object.defineProperty(exports, 'interpretCustomAppError', {
   enumerable: true,
   get: function () {
-    return interpretCustomerAppError;
+    return interpretCustomAppError;
   }
 });
-Object.defineProperty(exports, 'loadCustomerAppManifest', {
+Object.defineProperty(exports, 'loadCustomAppManifest', {
   enumerable: true,
   get: function () {
-    return loadCustomerAppManifest;
+    return loadCustomAppManifest;
   }
 });
 Object.defineProperty(exports, 'readInjectedAppConfig', {
@@ -2382,4 +2402,4 @@ Object.defineProperty(exports, 'useTrackEvent', {
     return useTrackEvent;
   }
 });
-//# sourceMappingURL=react-B7Blpmt7.cjs.map
+//# sourceMappingURL=react-BAiiXftp.cjs.map