@oxy-hq/sdk 2.10.0 → 2.12.0

package/dist/{react-BGUzRMxq.d.cts → react-DW7Z96sD.d.mts}

@@ -64,6 +64,25 @@ interface OxyAppFunctionManifest {
   email?: {
     send?: boolean;
   };
+  /**
+   * Capability for `ctx.org.people()` — the org's people directory, READ-ONLY
+   * (fail-closed: omit → the call is rejected before any query).
+   *
+   * Declare it for a function that has to name a person: an assignee, a roster
+   * entry, who submitted something. It answers with a display name and a role.
+   *
+   * Three things it deliberately is not, so nobody plans around them:
+   * it returns **no email and no phone** — naming a colleague is a different
+   * need from contacting them off-platform; it returns **no location**, which
+   * the platform does not hold for a member; and it does **not include
+   * frontline workers**, who hold no org-membership row by design.
+   *
+   * One flag, not `read`/`write`: there is no write. Editing the directory
+   * would put tenant membership behind an app's manifest.
+   */
+  org?: {
+    read?: boolean;
+  };
   /**
    * Capability for `ctx.oltp` — read/write the app's OWN per-org OLTP schema on
    * the managed Postgres tenant (fail-closed: omit → every `ctx.oltp` call
@@ -139,6 +158,25 @@ interface OxyAppManifest {
    * static bundle (today's default). See the functions design doc.
    */
   functions?: Record<string, OxyAppFunctionManifest>;
+  /**
+   * Schema migrations that ship WITH this bundle and run on promote.
+   *
+   * `dir` is a directory inside the built bundle holding numbered `.sql` files.
+   * The platform runs them in lexical order, **once each, ever**, inside a
+   * transaction, as the app's own writer role, and records each one.
+   *
+   * What changes for the author: you no longer write defensive
+   * `IF NOT EXISTS` / idempotent upserts, because re-running is a no-op by
+   * construction rather than by your care. And you **may not edit, rename or
+   * copy a migration that has already run** — all three fail the promote by
+   * name, and the fix is always a new file.
+   *
+   * The `.sql` files are ordinary bundle files, fetchable over the app's own
+   * host: put no secrets in them.
+   */
+  migrations?: {
+    dir: string;
+  };
   /**
    * Optional Ask Oxygen binding (agent ref + composer chips). The
    * platform's registered copy is authoritative (surfaced by
@@ -420,6 +458,12 @@ declare function useResolvedManifest(): ResolvedCustomAppManifest;
  */
 declare function useOxyApp(): {
   projectId: string | undefined;
+  /**
+   * The `apps.id` this bundle was served as — from `window.__OXY_APP__`, so
+   * it is the platform's word and not the manifest's. Undefined under `pnpm
+   * dev` against a manifest with no injected identity.
+   */
+  appId: string | undefined;
   appSlug: string | undefined;
   orgSlug: string | undefined;
   fetcher: AppFetcher;
@@ -525,6 +569,13 @@ interface UseSemanticQueryInput {
   time_dimensions?: SemanticTimeDimension[];
   filters?: SemanticFilter[];
   limit?: number;
+  /**
+   * `"reach"` — pin the query server-side to the viewer's places: one `in`
+   * filter per view it names whose primary entity is bound to the org's
+   * locations registry. The bundle's own app is sent along so app-admin
+   * standing counts. A query naming no bound view is refused.
+   */
+  scope?: "reach";
 }
 interface UseSemanticQueryOpts {
   /** Set false to skip the request (e.g., waiting on user input). */
@@ -785,4 +836,4 @@ interface OxyChatProps {
 declare function OxyChat(props: OxyChatProps): React.JSX.Element;
 //#endregion
 export { loadCustomAppManifest as $, UseSemanticQueryOpts as A, FunctionError as B, UseProcedureRunInput as C, UseQueryOpts as D, UseQueryInput as E, useProcedureRun as F, apiErrorFromResponse as G, FunctionResult as H, useQuery as I, OxyAppFunctionManifest as J, interpretCustomAppError as K, useResolvedManifest as L, useAgentRun as M, useFunction as N, UseQueryResult as O, useOxyApp as P, _resetCustomAppManifestCacheForTest as Q, useSemanticQuery as R, UseFunctionResult as S, UseProcedureRunResult as T, CustomAppErrorReport as U, FunctionLog as V, OxyApiError as W, OxyAppPerformanceManifest as X, OxyAppManifest as Y, ResolvedCustomAppManifest as Z, SemanticFilter as _, AppFetcher as a, UseAgentRunInput as b, OxyAppProvider as c, OxyChatProps as d, ProcedureProgress as f, SemanticDateRangeOp as g, SemanticArrayOp as h, AgentSqlArtifact as i, UseSemanticQueryResult as j, UseSemanticQueryInput as k, OxyAppProviderProps as l, ProcedureRunState as m, AgentRunEvent as n, OxyAnswer as o, ProcedureResult as p, LoadManifestOptions as q, AgentRunState as r, OxyAnswerProps as s, AgentArtifact as t, OxyChat as u, SemanticScalarOp as v, UseProcedureRunOpts as w, UseAgentRunResult as x, SemanticTimeDimension as y, useTrackEvent as z };
-//# sourceMappingURL=react-BGUzRMxq.d.cts.map
+//# sourceMappingURL=react-DW7Z96sD.d.mts.map

package/dist/react-DW7Z96sD.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-DW7Z96sD.d.mts","names":[],"sources":["../src/custom-app/manifest.ts","../src/custom-app/errors.ts","../src/custom-app/function-sse.ts","../src/custom-app/react.tsx"],"mappings":"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"}

package/dist/{react-Cas_DVKe.cjs → react-DcT-mUPj.cjs}

@@ -800,6 +800,7 @@ function useOxyApp() {
 	if (!ctx) throw new Error("useOxyApp must be called inside <OxyAppProvider>");
 	return {
 		projectId: ctx.resolved?.projectId,
+		appId: ctx.resolved?.appId,
 		appSlug: ctx.resolved?.appSlug,
 		orgSlug: ctx.resolved?.orgSlug,
 		fetcher: ctx.fetcher
@@ -974,7 +975,7 @@ function useFunction(name) {
 * inputs (e.g. a user-picked filter value) are available.
 */
 function useSemanticQuery(input, opts = {}) {
-	const { projectId, fetcher } = useOxyApp();
+	const { projectId, appId, fetcher } = useOxyApp();
 	const enabled = opts.enabled !== false;
 	const debug = opts.debug === true;
 	const inputKey = react.useMemo(() => JSON.stringify(input), [input]);
@@ -1009,7 +1010,11 @@ function useSemanticQuery(input, opts = {}) {
 			measures: input.measures ?? [],
 			time_dimensions: input.time_dimensions ?? [],
 			filters: input.filters ?? [],
-			...input.limit != null ? { limit: input.limit } : {}
+			...input.limit != null ? { limit: input.limit } : {},
+			...input.scope ? {
+				scope: input.scope,
+				...appId ? { app: appId } : {}
+			} : {}
 		});
 		const url = `/api/projects/${projectId}/semantic-query${debug ? "?debug=1" : ""}`;
 		fetcher(url, {
@@ -1047,6 +1052,7 @@ function useSemanticQuery(input, opts = {}) {
 	}, [
 		enabled,
 		projectId,
+		appId,
 		inputKey,
 		debug,
 		nonce,
@@ -1586,7 +1592,7 @@ function sleep(ms, signal) {
 * within-limit events are unaffected.
 */
 function useTrackEvent() {
-	const { projectId, fetcher } = useOxyApp();
+	const { projectId, appId, fetcher } = useOxyApp();
 	const queueRef = react.useRef([]);
 	const flushTimerRef = react.useRef(null);
 	const flush = react.useCallback(() => {
@@ -1597,7 +1603,10 @@ function useTrackEvent() {
 		queueRef.current = [];
 		for (const evt of batch) {
 			const url = `/api/customer-apps/${projectId}/events`;
-			const body = JSON.stringify(evt);
+			const body = JSON.stringify(appId ? {
+				...evt,
+				app_id: appId
+			} : evt);
 			try {
 				if (typeof navigator !== "undefined" && typeof navigator.sendBeacon === "function" && document.visibilityState === "hidden") navigator.sendBeacon(url, new Blob([body], { type: "application/json" }));
 				else fetcher(url, {
@@ -1611,7 +1620,11 @@ function useTrackEvent() {
 				console.warn("[oxy] useTrackEvent enqueue failed:", e);
 			}
 		}
-	}, [projectId, fetcher]);
+	}, [
+		projectId,
+		fetcher,
+		appId
+	]);
 	react.useEffect(() => {
 		if (typeof window === "undefined") return;
 		const onHide = () => flush();
@@ -2431,4 +2444,4 @@ Object.defineProperty(exports, 'useTrackEvent', {
     return useTrackEvent;
   }
 });
-//# sourceMappingURL=react-Cas_DVKe.cjs.map
+//# sourceMappingURL=react-DcT-mUPj.cjs.map