@oxy-hq/sdk 2.12.0 → 2.16.0

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // @oxy/sdk - TypeScript SDK for Oxy data platform
-import { _ as interpretCustomAppError, a as useFunction, c as useQuery, d as useTrackEvent, f as _resetCustomAppManifestCacheForTest, g as apiErrorFromResponse, h as OxyApiError, i as useAgentRun, l as useResolvedManifest, m as readInjectedAppConfig, n as OxyAppProvider, o as useOxyApp, p as loadCustomAppManifest, r as OxyChat, s as useProcedureRun, t as OxyAnswer, u as useSemanticQuery, v as getOxyAppLogger, y as setOxyAppLogger } from "./react-BXGyzgz0.mjs";
+import { _ as asReportableError, a as useFunction, b as setOxyAppLogger, c as useQuery, d as useTrackEvent, f as _resetCustomAppManifestCacheForTest, g as apiErrorFromResponse, h as OxyApiError, i as useAgentRun, l as useResolvedManifest, m as readInjectedAppConfig, n as OxyAppProvider, o as useOxyApp, p as loadCustomAppManifest, r as OxyChat, s as useProcedureRun, t as OxyAnswer, u as useSemanticQuery, v as interpretCustomAppError, y as getOxyAppLogger } from "./react-OW1t_J0M.mjs";
 import * as React from "react";
 
 //#region src/anomalies.ts
@@ -316,7 +316,7 @@ function useMetricTreeEndpoint(key, run, enabled) {
 	const [data, setData] = React.useState(null);
 	const [loading, setLoading] = React.useState(enabled && key !== null);
 	const [error, setError] = React.useState(null);
-	const [_nonce, setNonce] = React.useState(0);
+	const [nonce, setNonce] = React.useState(0);
 	const runRef = React.useRef(run);
 	runRef.current = run;
 	React.useEffect(() => {
@@ -334,15 +334,18 @@ function useMetricTreeEndpoint(key, run, enabled) {
 			setLoading(false);
 		}).catch((err) => {
 			if (cancelled) return;
-			if (err instanceof DOMException && err.name === "AbortError") return;
-			setError(err instanceof Error ? err : new Error(String(err)));
+			setError(asReportableError(err));
 			setLoading(false);
 		});
 		return () => {
 			cancelled = true;
 			ctrl.abort();
 		};
-	}, [key, enabled]);
+	}, [
+		key,
+		enabled,
+		nonce
+	]);
 	return {
 		data,
 		loading,
@@ -561,7 +564,7 @@ function useWorldModelGraph(opts = {}) {
 	const [data, setData] = React.useState(null);
 	const [loading, setLoading] = React.useState(enabled && !!projectId);
 	const [error, setError] = React.useState(null);
-	const [_nonce, setNonce] = React.useState(0);
+	const [nonce, setNonce] = React.useState(0);
 	React.useEffect(() => {
 		if (!enabled || !projectId) {
 			setLoading(false);
@@ -583,8 +586,7 @@ function useWorldModelGraph(opts = {}) {
 			setLoading(false);
 		}).catch((err) => {
 			if (cancelled) return;
-			if (err instanceof DOMException && err.name === "AbortError") return;
-			setError(err instanceof Error ? err : new Error(String(err)));
+			setError(asReportableError(err));
 			setLoading(false);
 		});
 		return () => {
@@ -594,7 +596,8 @@ function useWorldModelGraph(opts = {}) {
 	}, [
 		enabled,
 		projectId,
-		fetcher
+		fetcher,
+		nonce
 	]);
 	return {
 		data,
@@ -615,7 +618,7 @@ function useWorldModelInstances(entityId, opts = {}) {
 	const [data, setData] = React.useState(null);
 	const [loading, setLoading] = React.useState(enabled && !!projectId && !!entityId);
 	const [error, setError] = React.useState(null);
-	const [_nonce, setNonce] = React.useState(0);
+	const [nonce, setNonce] = React.useState(0);
 	React.useEffect(() => {
 		if (!enabled || !projectId || !entityId) {
 			setLoading(false);
@@ -644,8 +647,7 @@ function useWorldModelInstances(entityId, opts = {}) {
 			setLoading(false);
 		}).catch((err) => {
 			if (cancelled) return;
-			if (err instanceof DOMException && err.name === "AbortError") return;
-			setError(err instanceof Error ? err : new Error(String(err)));
+			setError(asReportableError(err));
 			setLoading(false);
 		});
 		return () => {
@@ -660,7 +662,8 @@ function useWorldModelInstances(entityId, opts = {}) {
 		limit,
 		fetcher,
 		scope,
-		appId
+		appId,
+		nonce
 	]);
 	return {
 		data,
@@ -738,8 +741,7 @@ function useMeasureBreakdown(entityId, keyValue, measure) {
 			if (!cancelled) setLoading(false);
 		}).catch((err) => {
 			if (cancelled) return;
-			if (err instanceof DOMException && err.name === "AbortError") return;
-			setError(err instanceof Error ? err : new Error(String(err)));
+			setError(asReportableError(err));
 			setLoading(false);
 		});
 		return () => {
@@ -1085,5 +1087,65 @@ var MetricTreeClient = class {
 };
 
 //#endregion
-export { AnomaliesClient, MetricTreeClient, OxyAnswer, OxyApiError, OxyAppProvider, OxyChat, WorldModelScopeUnsupportedError, _resetCustomAppManifestCacheForTest, apiErrorFromResponse, base64ToBytes, bytesToBase64, createWorldModel, getCustomAppDebug, getOxyAppLogger, interpretCustomAppError, loadCustomAppManifest, readInjectedAppConfig, readJsonSseStream, setOxyAppLogger, useAgentRun, useBaseline, useDistribution, useExplain, useFunction, useMeasureBreakdown, useMetricTree, useOpportunity, useOxyApp, usePredict, useProcedureRun, useProjection, useQuery, useResolvedManifest, useSemanticQuery, useSensitivity, useTimeDimensions, useTrackEvent, useWorldModel, useWorldModelGraph, useWorldModelInstances };
+//#region src/peerCohort.ts
+/**
+* Client for the `/semantic/cohort` endpoint. Surfaces airlayer's peer-cohort
+* benchmarking — comparing an entity's subjects against their declared peers
+* on a measure, with exclusions explained rather than silently dropped.
+*
+* Construction is internal to {@link OxyClient} — call `client.peerCohort`
+* to access an instance rather than building one yourself.
+*
+* @example
+* ```typescript
+* const client = await OxyClient.create({ projectId: "...", apiKey: "..." });
+* const result = await client.peerCohort.resolve({
+*   entity: "restaurant_id",
+*   measure: "orders.net_revenue",
+*   time_dimension: "orders.order_date",
+*   period: ["2025-09-01", "2025-09-30"],
+* });
+* for (const excluded of result.excluded) {
+*   console.warn(excluded.key, excluded.reason);
+* }
+* ```
+*/
+var PeerCohortClient = class {
+	constructor(config, request) {
+		this.config = config;
+		this.request = request;
+	}
+	path(suffix) {
+		return `/${this.config.projectId}${suffix}`;
+	}
+	buildQuery(extra = {}) {
+		const params = { ...extra };
+		if (this.config.branch) params.branch = this.config.branch;
+		const qs = new URLSearchParams(params).toString();
+		return qs ? `?${qs}` : "";
+	}
+	/**
+	* Resolve a subject's peer cohort and every peer's comparison against it.
+	*
+	* @example
+	* ```typescript
+	* const result = await client.peerCohort.resolve({
+	*   entity: "restaurant_id",
+	*   measure: "orders.net_revenue",
+	*   time_dimension: "orders.order_date",
+	*   period: ["2025-09-01", "2025-09-30"],
+	* });
+	* ```
+	*/
+	async resolve(request) {
+		const query = this.buildQuery();
+		return this.request(this.path(`/semantic/cohort${query}`), {
+			method: "POST",
+			body: JSON.stringify(request)
+		});
+	}
+};
+
+//#endregion
+export { AnomaliesClient, MetricTreeClient, OxyAnswer, OxyApiError, OxyAppProvider, OxyChat, PeerCohortClient, WorldModelScopeUnsupportedError, _resetCustomAppManifestCacheForTest, apiErrorFromResponse, base64ToBytes, bytesToBase64, createWorldModel, getCustomAppDebug, getOxyAppLogger, interpretCustomAppError, loadCustomAppManifest, readInjectedAppConfig, readJsonSseStream, setOxyAppLogger, useAgentRun, useBaseline, useDistribution, useExplain, useFunction, useMeasureBreakdown, useMetricTree, useOpportunity, useOxyApp, usePredict, useProcedureRun, useProjection, useQuery, useResolvedManifest, useSemanticQuery, useSensitivity, useTimeDimensions, useTrackEvent, useWorldModel, useWorldModelGraph, useWorldModelInstances };
 //# sourceMappingURL=index.mjs.map