@oxy-hq/sdk 2.4.0 → 2.6.0

package/dist/{react-DArzs6_l.mjs → react-5HGW_0oy.mjs}

@@ -2,7 +2,7 @@
 import * as React from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "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) {
@@ -42,9 +42,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... }".
@@ -91,12 +91,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 {
@@ -132,7 +132,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 {
@@ -168,7 +168,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 {
@@ -180,7 +180,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
@@ -193,18 +193,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) {
@@ -226,7 +226,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 = {
@@ -291,7 +291,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) {
@@ -369,7 +369,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,
@@ -395,7 +395,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
@@ -452,7 +452,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.
@@ -481,7 +481,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
@@ -557,7 +557,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();
@@ -601,28 +601,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,
@@ -631,7 +651,7 @@ function OxyAppProvider(props) {
 		}).catch((e) => {
 			if (!cancelled) setState({
 				status: "error",
-				error: interpretCustomerAppError(e),
+				error: interpretCustomAppError(e),
 				fetcher
 			});
 		});
@@ -733,7 +753,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
@@ -2234,5 +2254,5 @@ const styles = {
 };
 
 //#endregion
-export { interpretCustomerAppError as _, useFunction as a, useQuery as c, useTrackEvent as d, _resetCustomerAppManifestCacheForTest as f, apiErrorFromResponse as g, OxyApiError as h, useAgentRun as i, useResolvedManifest as l, readInjectedAppConfig as m, OxyAppProvider as n, useOxyApp as o, loadCustomerAppManifest as p, OxyChat as r, useProcedureRun as s, OxyAnswer as t, useSemanticQuery as u, getOxyAppLogger as v, setOxyAppLogger as y };
-//# sourceMappingURL=react-DArzs6_l.mjs.map
+export { interpretCustomAppError as _, useFunction as a, useQuery as c, useTrackEvent as d, _resetCustomAppManifestCacheForTest as f, apiErrorFromResponse as g, OxyApiError as h, useAgentRun as i, useResolvedManifest as l, readInjectedAppConfig as m, OxyAppProvider as n, useOxyApp as o, loadCustomAppManifest as p, OxyChat as r, useProcedureRun as s, OxyAnswer as t, useSemanticQuery as u, getOxyAppLogger as v, setOxyAppLogger as y };
+//# sourceMappingURL=react-5HGW_0oy.mjs.map