@oxy-hq/sdk 2.1.0 → 2.3.0

package/dist/index.mjs

@@ -147,6 +147,52 @@ async function getCustomerAppDebug(resolved) {
 
 //#endregion
 //#region src/customer-app/errors.ts
+/**
+* Error thrown by all customer-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... }".
+*/
+var OxyApiError = class extends Error {
+	constructor(opts) {
+		const base = opts.message || `HTTP ${opts.status}`;
+		const code = opts.code ? ` [${opts.code}]` : "";
+		const hint = opts.hint ? `\n\n${opts.hint}` : "";
+		super(`${base}${code}${hint}`);
+		this.name = "OxyApiError";
+		this.status = opts.status;
+		this.code = opts.code ?? null;
+		this.hint = opts.hint ?? null;
+	}
+};
+/**
+* Read a non-2xx response from oxy and return an `OxyApiError`.
+* Parses the JSON envelope when present; falls back to raw text
+* (truncated to 240 chars so a runaway HTML error page doesn't
+* dominate the bundle UI).
+*/
+async function apiErrorFromResponse(resp) {
+	let body;
+	let raw = "";
+	try {
+		raw = await resp.text();
+		body = raw ? JSON.parse(raw) : void 0;
+	} catch {}
+	if (body && typeof body === "object") {
+		const b = body;
+		return new OxyApiError({
+			status: resp.status,
+			message: typeof b.message === "string" ? b.message : `HTTP ${resp.status}`,
+			code: typeof b.code === "string" ? b.code : null,
+			hint: typeof b.hint === "string" ? b.hint : null
+		});
+	}
+	const snippet = raw.length > 240 ? `${raw.slice(0, 237)}…` : raw;
+	return new OxyApiError({
+		status: resp.status,
+		message: snippet || `HTTP ${resp.status}`
+	});
+}
 const ARCH_DOC = "internal-docs/customer-apps.md";
 /** Interpret a thrown error as a structured report for UI display. */
 function interpretCustomerAppError(err) {
@@ -393,6 +439,24 @@ function validateFunctions(raw) {
 				fn.cache = { ttlSeconds: ttl };
 			}
 		}
+		if (value.retries !== void 0) {
+			const r = value.retries;
+			if (!isRecord(r)) throw new Error(`oxy-app.json: function "${fnName}" \`retries\` must be an object`);
+			const retries = {};
+			for (const key of [
+				"maxAttempts",
+				"minTimeoutMs",
+				"maxTimeoutMs"
+			]) {
+				const n = r[key];
+				if (n !== void 0) {
+					if (typeof n !== "number" || !Number.isInteger(n) || n < 1) throw new Error(`oxy-app.json: function "${fnName}" \`retries.${key}\` must be a positive integer`);
+					retries[key] = n;
+				}
+			}
+			fn.retries = retries;
+		}
+		if (value.inputExample !== void 0) fn.inputExample = value.inputExample;
 		const hasSchedule = fn.schedule !== void 0;
 		const hasAirway = fn.airwayStep !== void 0;
 		if (!(fn.route ?? !(hasSchedule || hasAirway)) && !hasSchedule && !hasAirway) throw new Error(`oxy-app.json: function "${fnName}" must enable at least one of route/schedule/airwayStep`);
@@ -406,7 +470,7 @@ function isRecord(v) {
 
 //#endregion
 //#region src/customer-app/function-invoke.ts
-const inflight = /* @__PURE__ */ new Map();
+const inflight$1 = /* @__PURE__ */ new Map();
 /**
 * Dedup key for an invocation: function name + its (stable-serialized) body,
 * joined by a newline. Function names are `[a-z][a-z0-9-]*` (no newline), so
@@ -421,12 +485,12 @@ function functionInvokeKey(name, body) {
 * this dedups concurrency only, it does NOT memoize the result.
 */
 function sharedFunctionInvoke(key, run) {
-	const existing = inflight.get(key);
+	const existing = inflight$1.get(key);
 	if (existing) return existing;
 	const p = run().finally(() => {
-		inflight.delete(key);
+		inflight$1.delete(key);
 	});
-	inflight.set(key, p);
+	inflight$1.set(key, p);
 	return p;
 }
 
@@ -551,6 +615,50 @@ function isSafeLinkHref(raw) {
 	return lower.startsWith("http://") || lower.startsWith("https://") || lower.startsWith("mailto:");
 }
 
+//#endregion
+//#region src/customer-app/query-cache.ts
+const SWR_TTL_MS = 3e4;
+const inflight = /* @__PURE__ */ new Map();
+const cache = /* @__PURE__ */ new Map();
+function queryKey(projectId, db, sql) {
+	return `${projectId} ${db ?? ""} ${sql}`;
+}
+function getCached(projectId, sql, db) {
+	const e = cache.get(queryKey(projectId, db, sql));
+	return e && Date.now() - e.at < SWR_TTL_MS ? e.data : void 0;
+}
+/** Fetch with in-flight dedup + cache. `force` bypasses the fresh-cache
+*  short-circuit (used by refetch) but still dedupes a concurrent in-flight. */
+async function sharedQuery(fetcher, projectId, sql, db, opts = {}) {
+	const key = queryKey(projectId, db, sql);
+	if (!opts.force) {
+		const fresh = getCached(projectId, sql, db);
+		if (fresh) return fresh;
+	}
+	const existing = inflight.get(key);
+	if (existing) return existing;
+	const body = JSON.stringify({
+		sql,
+		...db ? { database: db } : {}
+	});
+	const p = (async () => {
+		const resp = await fetcher(`/api/projects/${projectId}/query`, {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body
+		});
+		if (!resp.ok) throw await apiErrorFromResponse(resp);
+		const data = await resp.json();
+		cache.set(key, {
+			at: Date.now(),
+			data
+		});
+		return data;
+	})().finally(() => inflight.delete(key));
+	inflight.set(key, p);
+	return p;
+}
+
 //#endregion
 //#region src/customer-app/react.tsx
 function defaultFetcher(input, init) {
@@ -655,58 +763,6 @@ function warnBetaOnce(name) {
 	if (typeof console !== "undefined" && typeof console.warn === "function") console.warn(`[@oxy-hq/sdk] \`${name}\` is in beta — interface and behavior may change. See https://github.com/oxy-hq/customer-apps for caveats and the migration guide.`);
 }
 /**
-* Error thrown by all customer-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... }".
-*
-* The server contract is documented in
-* `crates/app/src/server/api/projects/agent_ask.rs` and
-* `procedure_run.rs` — both emit `{ message, code?, hint? }` as JSON.
-* Hooks that previously wrapped the raw text in `new Error()` now
-* throw this type instead.
-*/
-var OxyApiError = class extends Error {
-	constructor(opts) {
-		const base = opts.message || `HTTP ${opts.status}`;
-		const code = opts.code ? ` [${opts.code}]` : "";
-		const hint = opts.hint ? `\n\n${opts.hint}` : "";
-		super(`${base}${code}${hint}`);
-		this.name = "OxyApiError";
-		this.status = opts.status;
-		this.code = opts.code ?? null;
-		this.hint = opts.hint ?? null;
-	}
-};
-/**
-* Read a non-2xx response from oxy and return an `OxyApiError`.
-* Parses the JSON envelope when present; falls back to raw text
-* (truncated to 240 chars so a runaway HTML error page doesn't
-* dominate the bundle UI).
-*/
-async function apiErrorFromResponse(resp) {
-	let body;
-	let raw = "";
-	try {
-		raw = await resp.text();
-		body = raw ? JSON.parse(raw) : void 0;
-	} catch {}
-	if (body && typeof body === "object") {
-		const b = body;
-		return new OxyApiError({
-			status: resp.status,
-			message: typeof b.message === "string" ? b.message : `HTTP ${resp.status}`,
-			code: typeof b.code === "string" ? b.code : null,
-			hint: typeof b.hint === "string" ? b.hint : null
-		});
-	}
-	const snippet = raw.length > 240 ? `${raw.slice(0, 237)}…` : raw;
-	return new OxyApiError({
-		status: resp.status,
-		message: snippet || `HTTP ${resp.status}`
-	});
-}
-/**
 * Read the resolved manifest from context. Throws if called outside
 * `<OxyAppProvider>` — that's a programmer error worth surfacing
 * loudly, not silently swallowing.
@@ -760,36 +816,35 @@ function useQuery(input, opts = {}) {
 			} : s);
 			return;
 		}
-		const ctrl = new AbortController();
 		let cancelled = false;
+		const cached = getCached(projectId, sqlWithParams, input.database);
+		if (cached && nonce === 0) {
+			const { columns, rows } = cached;
+			const objects = rows.map((r) => Object.fromEntries(columns.map((c, i) => [c, r[i]])));
+			setState({
+				rows: objects,
+				columns,
+				loading: false,
+				error: null
+			});
+			return;
+		}
 		setState((s) => ({
 			...s,
 			loading: true,
 			error: null
 		}));
-		const body = JSON.stringify({
-			sql: sqlWithParams,
-			...input.database ? { database: input.database } : {}
-		});
-		fetcher(`/api/projects/${projectId}/query`, {
-			method: "POST",
-			headers: { "content-type": "application/json" },
-			body,
-			signal: ctrl.signal
-		}).then(async (resp) => {
-			if (!resp.ok) throw await apiErrorFromResponse(resp);
-			return resp.json();
-		}).then(({ columns, rows }) => {
+		sharedQuery(fetcher, projectId, sqlWithParams, input.database, { force: nonce > 0 }).then(({ columns, rows }) => {
 			if (cancelled) return;
+			const objects = rows.map((r) => Object.fromEntries(columns.map((c, i) => [c, r[i]])));
 			setState({
-				rows: rows.map((r) => Object.fromEntries(columns.map((c, i) => [c, r[i]]))),
+				rows: objects,
 				columns,
 				loading: false,
 				error: null
 			});
 		}).catch((err) => {
 			if (cancelled) return;
-			if (err instanceof DOMException && err.name === "AbortError") return;
 			setState((s) => ({
 				...s,
 				loading: false,
@@ -798,7 +853,6 @@ function useQuery(input, opts = {}) {
 		});
 		return () => {
 			cancelled = true;
-			ctrl.abort();
 		};
 	}, [
 		enabled,
@@ -939,7 +993,8 @@ function useSemanticQuery(input, opts = {}) {
 			filters: input.filters ?? [],
 			...input.limit != null ? { limit: input.limit } : {}
 		});
-		fetcher(`/api/projects/${projectId}/semantic-query${debug ? "?debug=1" : ""}`, {
+		const url = `/api/projects/${projectId}/semantic-query${debug ? "?debug=1" : ""}`;
+		fetcher(url, {
 			method: "POST",
 			headers: { "content-type": "application/json" },
 			body,
@@ -949,8 +1004,9 @@ function useSemanticQuery(input, opts = {}) {
 			return resp.json();
 		}).then(({ columns, rows, truncated, sql }) => {
 			if (cancelled) return;
+			const objects = rows.map((r) => Object.fromEntries(columns.map((c, i) => [c, r[i]])));
 			setState({
-				rows: rows.map((r) => Object.fromEntries(columns.map((c, i) => [c, r[i]]))),
+				rows: objects,
 				columns,
 				truncated,
 				sql: sql ?? null,
@@ -2277,5 +2333,5 @@ var MetricTreeClient = class {
 };
 
 //#endregion
-export { AnomaliesClient, MetricTreeClient, OxyAnswer, OxyApiError, OxyAppProvider, OxyChat, _resetCustomerAppManifestCacheForTest, getCustomerAppDebug, getOxyAppLogger, interpretCustomerAppError, loadCustomerAppManifest, readInjectedAppConfig, setOxyAppLogger, useAgentRun, useFunction, useProcedureRun, useQuery, useResolvedManifest, useSemanticQuery, useTrackEvent };
+export { AnomaliesClient, MetricTreeClient, OxyAnswer, OxyApiError, OxyAppProvider, OxyChat, _resetCustomerAppManifestCacheForTest, apiErrorFromResponse, getCustomerAppDebug, getOxyAppLogger, interpretCustomerAppError, loadCustomerAppManifest, readInjectedAppConfig, setOxyAppLogger, useAgentRun, useFunction, useProcedureRun, useQuery, useResolvedManifest, useSemanticQuery, useTrackEvent };
 //# sourceMappingURL=index.mjs.map