@oxy-hq/sdk 2.1.0 → 2.3.0

package/dist/email.cjs

@@ -0,0 +1,14 @@
+// @oxy/sdk - TypeScript SDK for Oxy data platform
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let preact = require("preact");
+let preact_render_to_string = require("preact-render-to-string");
+
+//#region src/email.ts
+/** Render an email template component to an HTML string. */
+function render(Component, props) {
+	return (0, preact_render_to_string.render)((0, preact.h)(Component, props));
+}
+
+//#endregion
+exports.render = render;
+//# sourceMappingURL=email.cjs.map

package/dist/email.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.cjs","names":[],"sources":["../src/email.ts"],"sourcesContent":["// `@oxy-hq/sdk/email` — render an email template to an HTML string for use in\n// an Oxy Function's `ctx.email.send`.\n//\n// You write email templates as plain JSX components (point JSX at preact with\n// `jsxImportSource: \"preact\"` in the template's tsconfig — see the examples),\n// then:\n//\n// ```ts\n// import { render } from \"@oxy-hq/sdk/email\";\n// import { Welcome } from \"../emails/Welcome\";\n// await ctx.email.send({ to, subject, html: render(Welcome, { name }) });\n// ```\n//\n// Rendering uses preact-render-to-string — pure JS, no react-dom/server, no node\n// builtins, no Web Streams — so it bundles under esbuild `--platform=neutral`\n// and runs inside the Oxy Functions isolate (React Email / react-dom cannot).\n// Kept in a separate subpath entry so it never bloats the main SDK bundle.\n\nimport { type ComponentType, h } from \"preact\";\nimport { render as prerender } from \"preact-render-to-string\";\n\n/** Render an email template component to an HTML string. */\nexport function render<P extends Record<string, unknown>>(\n  Component: ComponentType<P>,\n  props: P\n): string {\n  return prerender(h(Component, props));\n}\n"],"mappings":";;;;;;;AAsBA,SAAgB,OACd,WACA,OACQ;CACR,yDAAmB,WAAW,KAAK,CAAC;AACtC"}

package/dist/email.d.cts

@@ -0,0 +1,8 @@
+
+import { ComponentType } from "preact";
+//#region src/email.d.ts
+/** Render an email template component to an HTML string. */
+declare function render<P extends Record<string, unknown>>(Component: ComponentType<P>, props: P): string;
+//#endregion
+export { render };
+//# sourceMappingURL=email.d.cts.map

package/dist/email.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.cts","names":[],"sources":["../src/email.ts"],"mappings":";;;;iBAsBgB,OAAO,UAAU,yBAC/B,WAAW,cAAc,IACzB,OAAO"}

package/dist/email.d.mts

@@ -0,0 +1,8 @@
+
+import { ComponentType } from "preact";
+//#region src/email.d.ts
+/** Render an email template component to an HTML string. */
+declare function render<P extends Record<string, unknown>>(Component: ComponentType<P>, props: P): string;
+//#endregion
+export { render };
+//# sourceMappingURL=email.d.mts.map

package/dist/email.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.mts","names":[],"sources":["../src/email.ts"],"mappings":";;;;iBAsBgB,OAAO,UAAU,yBAC/B,WAAW,cAAc,IACzB,OAAO"}

package/dist/email.mjs

@@ -0,0 +1,13 @@
+// @oxy/sdk - TypeScript SDK for Oxy data platform
+import { h } from "preact";
+import { render as render$1 } from "preact-render-to-string";
+
+//#region src/email.ts
+/** Render an email template component to an HTML string. */
+function render(Component, props) {
+	return render$1(h(Component, props));
+}
+
+//#endregion
+export { render };
+//# sourceMappingURL=email.mjs.map

package/dist/email.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.mjs","names":["prerender"],"sources":["../src/email.ts"],"sourcesContent":["// `@oxy-hq/sdk/email` — render an email template to an HTML string for use in\n// an Oxy Function's `ctx.email.send`.\n//\n// You write email templates as plain JSX components (point JSX at preact with\n// `jsxImportSource: \"preact\"` in the template's tsconfig — see the examples),\n// then:\n//\n// ```ts\n// import { render } from \"@oxy-hq/sdk/email\";\n// import { Welcome } from \"../emails/Welcome\";\n// await ctx.email.send({ to, subject, html: render(Welcome, { name }) });\n// ```\n//\n// Rendering uses preact-render-to-string — pure JS, no react-dom/server, no node\n// builtins, no Web Streams — so it bundles under esbuild `--platform=neutral`\n// and runs inside the Oxy Functions isolate (React Email / react-dom cannot).\n// Kept in a separate subpath entry so it never bloats the main SDK bundle.\n\nimport { type ComponentType, h } from \"preact\";\nimport { render as prerender } from \"preact-render-to-string\";\n\n/** Render an email template component to an HTML string. */\nexport function render<P extends Record<string, unknown>>(\n  Component: ComponentType<P>,\n  props: P\n): string {\n  return prerender(h(Component, props));\n}\n"],"mappings":";;;;;;AAsBA,SAAgB,OACd,WACA,OACQ;CACR,OAAOA,SAAU,EAAE,WAAW,KAAK,CAAC;AACtC"}

package/dist/index.cjs

@@ -176,6 +176,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) {
@@ -422,6 +468,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`);
@@ -435,7 +499,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
@@ -450,12 +514,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;
 }
 
@@ -580,6 +644,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) {
@@ -684,58 +792,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.
@@ -789,36 +845,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,
@@ -827,7 +882,6 @@ function useQuery(input, opts = {}) {
 		});
 		return () => {
 			cancelled = true;
-			ctrl.abort();
 		};
 	}, [
 		enabled,
@@ -968,7 +1022,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,
@@ -978,8 +1033,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,
@@ -2313,6 +2369,7 @@ exports.OxyApiError = OxyApiError;
 exports.OxyAppProvider = OxyAppProvider;
 exports.OxyChat = OxyChat;
 exports._resetCustomerAppManifestCacheForTest = _resetCustomerAppManifestCacheForTest;
+exports.apiErrorFromResponse = apiErrorFromResponse;
 exports.getCustomerAppDebug = getCustomerAppDebug;
 exports.getOxyAppLogger = getOxyAppLogger;
 exports.interpretCustomerAppError = interpretCustomerAppError;