@beacon-build/sdk 2.17.1 → 3.0.0

package/dist/transport/http-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/transport/http-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/transport/http-client.ts"],"names":[],"mappings":"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"}

package/dist/transport/request-origin.d.ts

@@ -0,0 +1,44 @@
+import type { BillingOrigin } from '@beacon-build/core';
+/** Run `fn` with every transport request it starts synchronously marked `background`. */
+export declare function runWithBackgroundOrigin<T>(fn: () => T): T;
+/**
+ * The origin header(s) a transport attaches to the request it is about to send: an explicit
+ * per-request `origin` wins, otherwise the ambient `runWithBackgroundOrigin` scope decides.
+ * Returns `{}` for `interactive` — the header is simply omitted (the server default).
+ */
+export declare function requestOriginHeaders(origin?: BillingOrigin): Record<string, string>;
+/** The slice of react-query's `Query.state` the refetch decision reads. */
+interface QueryStateLike {
+    dataUpdatedAt: number;
+    fetchMeta?: unknown;
+}
+/** The slice of react-query's defaulted query options the wrapper reads. */
+interface PollingQueryOptionsLike {
+    queryFn?: unknown;
+    refetchInterval?: unknown;
+    queryHash?: string;
+}
+/** The slice of react-query's `QueryClient` `installBackgroundRefetchOrigin` needs. */
+interface QueryClientLike {
+    defaultQueryOptions: (options: never) => object;
+    getQueryCache(): {
+        get(queryHash: string): {
+            state: QueryStateLike;
+        } | undefined;
+    };
+}
+/**
+ * Wrap a polling query's `queryFn` so its background refetches run inside
+ * `runWithBackgroundOrigin`. Non-polling queries (no positive/function `refetchInterval`) and
+ * non-function `queryFn`s (e.g. `skipToken`) are returned unchanged.
+ */
+export declare function withBackgroundRefetchOrigin<O extends PollingQueryOptionsLike>(options: O, getQueryState: (queryHash: string) => QueryStateLike | undefined): O;
+/**
+ * C907/AC-8: make every polling query of `client` send its background refetches with
+ * `X-Beacon-Request-Origin: background`. Hooks into `QueryClient.defaultQueryOptions` — the one
+ * chokepoint every `useQuery`/`useInfiniteQuery` observer and `fetchQuery` resolves its options
+ * through — so no individual `refetchInterval` call site needs to know about billing.
+ */
+export declare function installBackgroundRefetchOrigin<C extends QueryClientLike>(client: C): C;
+export {};
+//# sourceMappingURL=request-origin.d.ts.map

package/dist/transport/request-origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-origin.d.ts","sourceRoot":"","sources":["../../src/transport/request-origin.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAKvD,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAOzD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGnF;AAED,2EAA2E;AAC3E,UAAU,cAAc;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,4EAA4E;AAC5E,UAAU,uBAAuB;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,uFAAuF;AACvF,UAAU,eAAe;IACrB,mBAAmB,EAAE,CAAC,OAAO,EAAE,KAAK,KAAK,MAAM,CAAA;IAC/C,aAAa,IAAI;QAAE,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG;YAAE,KAAK,EAAE,cAAc,CAAA;SAAE,GAAG,SAAS,CAAA;KAAE,CAAA;CACrF;AA6BD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,uBAAuB,EACzE,OAAO,EAAE,CAAC,EACV,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,GACjE,CAAC,CAiBH;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,SAAS,eAAe,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAStF"}

package/dist/transport/request-origin.js

@@ -0,0 +1,99 @@
+/**
+ * C907/AC-8 — client-side billing-origin marking.
+ *
+ * An automatically repeated call (a poll, a react-query `refetchInterval` refetch) sends
+ * `X-Beacon-Request-Origin: background` (the header contract lives in `@beacon-build/core`'s
+ * `metrics/request-origin.ts`) so the API counts it but never bills it. A client can only ever
+ * mark itself LESS billable — absent/unknown values are `interactive` server-side.
+ *
+ * Two ways to mark a request:
+ *   1. Explicitly, per request — `HttpClient.get(path, { origin: 'background' })`.
+ *   2. Ambiently — `runWithBackgroundOrigin(fn)`: every transport request STARTED synchronously
+ *      inside `fn` (before its first `await`) is marked. Browsers have no async context
+ *      propagation, so transports read the scope via `requestOriginHeaders()` as the FIRST
+ *      thing they do, before any `await`. A request started after an `await` inside `fn` falls
+ *      back to `interactive` — the conservative direction (counted billable), never the reverse.
+ *
+ * `installBackgroundRefetchOrigin` wires (2) into a react-query `QueryClient` for every polling
+ * query, without a dependency on react-query itself (structural types only).
+ */
+// From the pure `/ide` subpath (not `core/browser`): the beacon-ide portal bundles the SDK and
+// only `core/ide` alongside it — see packages/core/src/exports/ide.ts.
+import { BACKGROUND_REQUEST_ORIGIN_HEADERS } from '@beacon-build/core/ide';
+/** Nesting depth of active `runWithBackgroundOrigin` scopes (synchronous only — see header). */
+let backgroundScopeDepth = 0;
+/** Run `fn` with every transport request it starts synchronously marked `background`. */
+export function runWithBackgroundOrigin(fn) {
+    backgroundScopeDepth++;
+    try {
+        return fn();
+    }
+    finally {
+        backgroundScopeDepth--;
+    }
+}
+/**
+ * The origin header(s) a transport attaches to the request it is about to send: an explicit
+ * per-request `origin` wins, otherwise the ambient `runWithBackgroundOrigin` scope decides.
+ * Returns `{}` for `interactive` — the header is simply omitted (the server default).
+ */
+export function requestOriginHeaders(origin) {
+    const resolved = origin ?? (backgroundScopeDepth > 0 ? 'background' : 'interactive');
+    return resolved === 'background' ? { ...BACKGROUND_REQUEST_ORIGIN_HEADERS } : {};
+}
+/** Already-wrapped queryFns — `defaultQueryOptions` re-runs on already-defaulted options. */
+const wrappedQueryFns = new WeakSet();
+function isPollingQuery(refetchInterval) {
+    // A function interval decides per tick (e.g. visibility-gated) — still a polling query.
+    return (typeof refetchInterval === 'function' ||
+        (typeof refetchInterval === 'number' && refetchInterval > 0));
+}
+/**
+ * Background = a RE-fetch of data the query already holds. The initial load (no data yet) is the
+ * user opening the view — interactive. An infinite query's `fetchNextPage`/`fetchPreviousPage`
+ * (`fetchMeta.fetchMore`) is a user scroll/click — interactive too.
+ *
+ * Deliberate trade-off: react-query does not tell a `queryFn` WHY it runs, so interval ticks,
+ * window-focus/reconnect refetches, invalidations and a manual `refetch()` of an already-loaded
+ * POLLING query are indistinguishable here — all are treated as background. The user action
+ * that triggers an invalidation (a mutation) is itself a separate, interactive request.
+ */
+function isBackgroundRefetch(state) {
+    if (!state || state.dataUpdatedAt <= 0)
+        return false;
+    const fetchMeta = state.fetchMeta;
+    return !fetchMeta?.fetchMore;
+}
+/**
+ * Wrap a polling query's `queryFn` so its background refetches run inside
+ * `runWithBackgroundOrigin`. Non-polling queries (no positive/function `refetchInterval`) and
+ * non-function `queryFn`s (e.g. `skipToken`) are returned unchanged.
+ */
+export function withBackgroundRefetchOrigin(options, getQueryState) {
+    const { queryFn, refetchInterval, queryHash } = options;
+    if (typeof queryFn !== 'function' ||
+        wrappedQueryFns.has(queryFn) ||
+        !queryHash ||
+        !isPollingQuery(refetchInterval)) {
+        return options;
+    }
+    const run = queryFn;
+    const wrapped = (...args) => isBackgroundRefetch(getQueryState(queryHash))
+        ? runWithBackgroundOrigin(() => run(...args))
+        : run(...args);
+    wrappedQueryFns.add(wrapped);
+    return { ...options, queryFn: wrapped };
+}
+/**
+ * C907/AC-8: make every polling query of `client` send its background refetches with
+ * `X-Beacon-Request-Origin: background`. Hooks into `QueryClient.defaultQueryOptions` — the one
+ * chokepoint every `useQuery`/`useInfiniteQuery` observer and `fetchQuery` resolves its options
+ * through — so no individual `refetchInterval` call site needs to know about billing.
+ */
+export function installBackgroundRefetchOrigin(client) {
+    const base = client.defaultQueryOptions.bind(client);
+    const getQueryState = (queryHash) => client.getQueryCache().get(queryHash)?.state;
+    client.defaultQueryOptions = ((options) => withBackgroundRefetchOrigin(base(options), getQueryState));
+    return client;
+}
+//# sourceMappingURL=request-origin.js.map

package/dist/transport/request-origin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-origin.js","sourceRoot":"","sources":["../../src/transport/request-origin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,+FAA+F;AAC/F,uEAAuE;AACvE,OAAO,EAAE,iCAAiC,EAAE,MAAM,wBAAwB,CAAA;AAG1E,gGAAgG;AAChG,IAAI,oBAAoB,GAAG,CAAC,CAAA;AAE5B,yFAAyF;AACzF,MAAM,UAAU,uBAAuB,CAAI,EAAW;IAClD,oBAAoB,EAAE,CAAA;IACtB,IAAI,CAAC;QACD,OAAO,EAAE,EAAE,CAAA;IACf,CAAC;YAAS,CAAC;QACP,oBAAoB,EAAE,CAAA;IAC1B,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAsB;IACvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,oBAAoB,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAA;IACpF,OAAO,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,iCAAiC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AACpF,CAAC;AAqBD,6FAA6F;AAC7F,MAAM,eAAe,GAAG,IAAI,OAAO,EAAU,CAAA;AAE7C,SAAS,cAAc,CAAC,eAAwB;IAC5C,wFAAwF;IACxF,OAAO,CACH,OAAO,eAAe,KAAK,UAAU;QACrC,CAAC,OAAO,eAAe,KAAK,QAAQ,IAAI,eAAe,GAAG,CAAC,CAAC,CAC/D,CAAA;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,mBAAmB,CAAC,KAAiC;IAC1D,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC;QAAE,OAAO,KAAK,CAAA;IACpD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAuD,CAAA;IAC/E,OAAO,CAAC,SAAS,EAAE,SAAS,CAAA;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACvC,OAAU,EACV,aAAgE;IAEhE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,GAAG,OAAO,CAAA;IACvD,IACI,OAAO,OAAO,KAAK,UAAU;QAC7B,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC;QAC5B,CAAC,SAAS;QACV,CAAC,cAAc,CAAC,eAAe,CAAC,EAClC,CAAC;QACC,OAAO,OAAO,CAAA;IAClB,CAAC;IACD,MAAM,GAAG,GAAG,OAA0C,CAAA;IACtD,MAAM,OAAO,GAAG,CAAC,GAAG,IAAe,EAAW,EAAE,CAC5C,mBAAmB,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC,CAAC,uBAAuB,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7C,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAA;IACtB,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAC5B,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAA4B,MAAS;IAC/E,MAAM,IAAI,GAAG,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAiC,CAAA;IACpF,MAAM,aAAa,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,CAAA;IACzF,MAAM,CAAC,mBAAmB,GAAG,CAAC,CAAC,OAAgB,EAAE,EAAE,CAC/C,2BAA2B,CACvB,IAAI,CAAC,OAAO,CAA4B,EACxC,aAAa,CAChB,CAA6B,CAAA;IAClC,OAAO,MAAM,CAAA;AACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beacon-build/sdk",
-  "version": "2.17.1",
+  "version": "3.0.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -26,7 +26,7 @@
     "@types/react": "^19.2.0",
     "@types/react-dom": "^19.2.0",
     "event-source-polyfill": "^1.0.31",
-    "@beacon-build/core": "2.17.1"
+    "@beacon-build/core": "3.0.0"
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.2",