@dvina/sdk 3.3.124

package/dist/adapters/react/index.js

@@ -0,0 +1,49 @@
+import '../../chunk-5WRI5ZAA.js';
+import { useMemo, useState, useRef, useEffect } from 'react';
+
+function useLiveQuery(factory, deps) {
+  const ref = useMemo(factory, deps);
+  const [value, setValue] = useState(ref.current);
+  if (process.env.NODE_ENV !== "production") {
+    const changeCount = useRef(0);
+    const lastChangeTime = useRef(Date.now());
+    const now = Date.now();
+    if (ref !== void 0) {
+      const elapsed = now - lastChangeTime.current;
+      if (elapsed < 1e3) {
+        changeCount.current++;
+      } else {
+        changeCount.current = 1;
+      }
+      lastChangeTime.current = now;
+      if (changeCount.current > 10) {
+        console.warn(
+          "useLiveQuery: query ref was recreated more than 10 times within 1 second. This usually means the dependency array is unstable (e.g. a new object/array created every render). Ensure deps contain only primitive values or stable references."
+        );
+        changeCount.current = 0;
+      }
+    }
+  }
+  useEffect(() => {
+    let active = true;
+    setValue(ref.current);
+    (async () => {
+      try {
+        for await (const v of ref) {
+          if (!active) break;
+          setValue(v);
+        }
+      } catch {
+      }
+    })();
+    return () => {
+      active = false;
+      ref.dispose();
+    };
+  }, [ref]);
+  return value;
+}
+
+export { useLiveQuery };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/adapters/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/react/index.ts"],"names":[],"mappings":";;;AA2DO,SAAS,YAAA,CAAgB,SAAiC,IAAA,EAAyC;AAEzG,EAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,OAAA,EAAS,IAAI,CAAA;AAEjC,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,QAAA,CAAwB,IAAI,OAAO,CAAA;AAG7D,EAAA,IAAI,OAAA,CAAQ,GAAA,CAAI,QAAA,KAAa,YAAA,EAAc;AAE1C,IAAA,MAAM,WAAA,GAAc,OAAO,CAAC,CAAA;AAE5B,IAAA,MAAM,cAAA,GAAiB,MAAA,CAAO,IAAA,CAAK,GAAA,EAAK,CAAA;AAExC,IAAA,MAAM,GAAA,GAAM,KAAK,GAAA,EAAI;AACrB,IAAA,IAAI,QAAQ,MAAA,EAAW;AACtB,MAAA,MAAM,OAAA,GAAU,MAAM,cAAA,CAAe,OAAA;AACrC,MAAA,IAAI,UAAU,GAAA,EAAM;AACnB,QAAA,WAAA,CAAY,OAAA,EAAA;AAAA,MACb,CAAA,MAAO;AACN,QAAA,WAAA,CAAY,OAAA,GAAU,CAAA;AAAA,MACvB;AACA,MAAA,cAAA,CAAe,OAAA,GAAU,GAAA;AAEzB,MAAA,IAAI,WAAA,CAAY,UAAU,EAAA,EAAI;AAC7B,QAAA,OAAA,CAAQ,IAAA;AAAA,UACP;AAAA,SAGD;AACA,QAAA,WAAA,CAAY,OAAA,GAAU,CAAA;AAAA,MACvB;AAAA,IACD;AAAA,EACD;AAEA,EAAA,SAAA,CAAU,MAAM;AACf,IAAA,IAAI,MAAA,GAAS,IAAA;AAGb,IAAA,QAAA,CAAS,IAAI,OAAO,CAAA;AAEpB,IAAA,CAAC,YAAY;AACZ,MAAA,IAAI;AACH,QAAA,WAAA,MAAiB,KAAK,GAAA,EAAK;AAC1B,UAAA,IAAI,CAAC,MAAA,EAAQ;AACb,UAAA,QAAA,CAAS,CAAC,CAAA;AAAA,QACX;AAAA,MACD,CAAA,CAAA,MAAQ;AAAA,MAER;AAAA,IACD,CAAA,GAAG;AAEH,IAAA,OAAO,MAAM;AACZ,MAAA,MAAA,GAAS,KAAA;AACT,MAAA,GAAA,CAAI,OAAA,EAAQ;AAAA,IACb,CAAA;AAAA,EACD,CAAA,EAAG,CAAC,GAAG,CAAC,CAAA;AAER,EAAA,OAAO,KAAA;AACR","file":"index.js","sourcesContent":["/**\n * React adapter for @dvina/sdk.\n *\n * Converts DvinaQueryRef (AsyncIterable) into React state via hooks.\n *\n * @example\n * ```tsx\n * import { useLiveQuery } from '@dvina/sdk/react';\n *\n * function ReportsPage() {\n *   const reports = useLiveQuery(() => sdk.reports({ first: 20 }).watch(), []);\n *   return (\n *     <ul>\n *       {reports?.nodes.map(r => <li key={r.id}>{r.name}</li>)}\n *     </ul>\n *   );\n * }\n * ```\n *\n * @packageDocumentation\n */\n\nimport { useState, useEffect, useMemo, useRef } from 'react';\nimport type { DvinaQueryRef } from '../../types.js';\n\n/**\n * React hook that subscribes to a `DvinaQueryRef` (AsyncIterable) and\n * returns its latest value as React state.\n *\n * Accepts a **factory function** that creates the query ref, along with a\n * dependency array. The factory is memoized internally — the ref is only\n * recreated when the dependencies change, preventing infinite\n * dispose-subscribe loops that would occur with inline `.watch()` calls.\n *\n * The component re-renders whenever the query ref emits a new value.\n * Cleanup (disposal of the subscription) happens automatically when the\n * component unmounts or when dependencies change.\n *\n * @param factory - A function that returns a DvinaQueryRef (e.g. `() => sdk.reports().watch()`)\n * @param deps - Dependency array controlling when the ref is recreated (same semantics as `useMemo`)\n * @returns The latest value from the query ref, or `undefined` if not yet loaded\n *\n * @example\n * ```tsx\n * // Static query — ref created once\n * function ReportsPage() {\n *   const reports = useLiveQuery(() => sdk.reports({ first: 20 }).watch(), []);\n *   if (!reports) return <div>Loading...</div>;\n *   return <ul>{reports.nodes.map(r => <li key={r.id}>{r.name}</li>)}</ul>;\n * }\n *\n * // Reactive query — ref recreated when `id` changes\n * function ReportDetail({ id }: { id: string }) {\n *   const report = useLiveQuery(() => sdk.report({ id }).watch(), [id]);\n *   if (!report) return <div>Loading...</div>;\n *   return <h1>{report.name}</h1>;\n * }\n * ```\n */\nexport function useLiveQuery<T>(factory: () => DvinaQueryRef<T>, deps: readonly unknown[]): T | undefined {\n\t// eslint-disable-next-line react-hooks/exhaustive-deps -- deps are forwarded from the caller\n\tconst ref = useMemo(factory, deps);\n\n\tconst [value, setValue] = useState<T | undefined>(ref.current);\n\n\t// Track rapid ref changes in dev mode to warn about missing deps\n\tif (process.env.NODE_ENV !== 'production') {\n\t\t// eslint-disable-next-line react-hooks/rules-of-hooks -- dev-only, always runs in dev\n\t\tconst changeCount = useRef(0);\n\t\t// eslint-disable-next-line react-hooks/rules-of-hooks\n\t\tconst lastChangeTime = useRef(Date.now());\n\n\t\tconst now = Date.now();\n\t\tif (ref !== undefined) {\n\t\t\tconst elapsed = now - lastChangeTime.current;\n\t\t\tif (elapsed < 1000) {\n\t\t\t\tchangeCount.current++;\n\t\t\t} else {\n\t\t\t\tchangeCount.current = 1;\n\t\t\t}\n\t\t\tlastChangeTime.current = now;\n\n\t\t\tif (changeCount.current > 10) {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t'useLiveQuery: query ref was recreated more than 10 times within 1 second. ' +\n\t\t\t\t\t\t'This usually means the dependency array is unstable (e.g. a new object/array ' +\n\t\t\t\t\t\t'created every render). Ensure deps contain only primitive values or stable references.',\n\t\t\t\t);\n\t\t\t\tchangeCount.current = 0;\n\t\t\t}\n\t\t}\n\t}\n\n\tuseEffect(() => {\n\t\tlet active = true;\n\n\t\t// Sync initial value in case it changed between render and effect\n\t\tsetValue(ref.current);\n\n\t\t(async () => {\n\t\t\ttry {\n\t\t\t\tfor await (const v of ref) {\n\t\t\t\t\tif (!active) break;\n\t\t\t\t\tsetValue(v);\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Query ref was disposed or errored — state keeps its last value\n\t\t\t}\n\t\t})();\n\n\t\treturn () => {\n\t\t\tactive = false;\n\t\t\tref.dispose();\n\t\t};\n\t}, [ref]);\n\n\treturn value;\n}\n"]}

package/dist/billing/index.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+var chunkGDK2HJTF_cjs = require('../chunk-GDK2HJTF.cjs');
+require('../chunk-KV5SP7RP.cjs');
+require('../chunk-DZUJEN5N.cjs');
+
+
+
+Object.defineProperty(exports, "BillingClient", {
+  enumerable: true,
+  get: function () { return chunkGDK2HJTF_cjs.BillingClient; }
+});
+Object.defineProperty(exports, "EntitlementTier", {
+  enumerable: true,
+  get: function () { return chunkGDK2HJTF_cjs.EntitlementTier; }
+});
+Object.defineProperty(exports, "SubscriptionCycle", {
+  enumerable: true,
+  get: function () { return chunkGDK2HJTF_cjs.SubscriptionCycle; }
+});
+Object.defineProperty(exports, "SubscriptionProvider", {
+  enumerable: true,
+  get: function () { return chunkGDK2HJTF_cjs.SubscriptionProvider; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/billing/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/billing/index.d.cts

@@ -0,0 +1,338 @@
+import { D as DvinaError } from '../error-CsVoUTY8.cjs';
+
+type Maybe<T> = T | null;
+type Exact<T extends {
+    [key: string]: unknown;
+}> = {
+    [K in keyof T]: T[K];
+};
+/** All built-in and custom scalars, mapped to their actual values */
+type Scalars = {
+    ID: string;
+    String: string;
+    Boolean: boolean;
+    Int: number;
+    Float: number;
+    /** A date-time string at UTC, such as 2019-12-03T09:54:33Z, compliant with the date-time format. */
+    DateTime: any;
+    /** The `JSONObject` scalar type represents JSON objects as specified by [ECMA-404](http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf). */
+    JSONObject: any;
+};
+type EntitlementDetail = {
+    canAddReport: Scalars['Boolean'];
+    canAddUser: Scalars['Boolean'];
+    canUseApi: Scalars['Boolean'];
+    capacity?: Maybe<Scalars['Int']>;
+    deepAnalysisCharacterLimit?: Maybe<Scalars['Float']>;
+    deepAnalysisTokenLimit?: Maybe<Scalars['Float']>;
+    hardTokenUsageLimit?: Maybe<Scalars['Float']>;
+    maxStructuredSize?: Maybe<Scalars['Int']>;
+    maxUnstructuredSize?: Maybe<Scalars['Int']>;
+    minUsers?: Maybe<Scalars['Int']>;
+    softTokenUsageLimit?: Maybe<Scalars['Float']>;
+    sourceTypes?: Maybe<Array<Scalars['String']>>;
+    team: Scalars['Boolean'];
+};
+declare enum EntitlementTier {
+    Enterprise = "enterprise",
+    Free = "free",
+    Max = "max",
+    Plus = "plus",
+    Pro = "pro"
+}
+type Plan = {
+    entitlements: EntitlementDetail;
+    features?: Maybe<Array<Scalars['JSONObject']>>;
+    id: Scalars['String'];
+    name: Scalars['String'];
+    prices: Array<Price>;
+    tier?: Maybe<EntitlementTier>;
+};
+type Price = {
+    amount?: Maybe<Scalars['Float']>;
+    currency: Scalars['String'];
+    id: Scalars['String'];
+    interval?: Maybe<SubscriptionCycle>;
+};
+type ScheduledChange = {
+    effectiveDate?: Maybe<Scalars['DateTime']>;
+    newCycle?: Maybe<SubscriptionCycle>;
+    newSeats?: Maybe<Scalars['Int']>;
+    newTier?: Maybe<EntitlementTier>;
+};
+declare enum SubscriptionCycle {
+    Daily = "DAILY",
+    Monthly = "MONTHLY",
+    Weekly = "WEEKLY",
+    Yearly = "YEARLY"
+}
+declare enum SubscriptionProvider {
+    Revcat = "REVCAT",
+    Stripe = "STRIPE"
+}
+type WorkspaceSubscription = {
+    cancelAtPeriodEnd?: Maybe<Scalars['Boolean']>;
+    currentPeriodEnd?: Maybe<Scalars['DateTime']>;
+    currentPeriodStart?: Maybe<Scalars['DateTime']>;
+    cycle?: Maybe<SubscriptionCycle>;
+    provider?: Maybe<SubscriptionProvider>;
+    scheduledChange?: Maybe<ScheduledChange>;
+    seats: Scalars['Int'];
+    tier: EntitlementTier;
+};
+type PlanQueryVariables = Exact<{
+    id: Scalars['String'];
+}>;
+type PlanFragmentFragment = {
+    id: string;
+    name: string;
+    tier?: EntitlementTier | null;
+    features?: Array<any> | null;
+    prices: Array<{
+        id: string;
+        currency: string;
+        amount?: number | null;
+        interval?: SubscriptionCycle | null;
+    }>;
+    entitlements: {
+        canAddUser: boolean;
+        minUsers?: number | null;
+        team: boolean;
+        capacity?: number | null;
+        sourceTypes?: Array<string> | null;
+        softTokenUsageLimit?: number | null;
+        hardTokenUsageLimit?: number | null;
+        canAddReport: boolean;
+        canUseApi: boolean;
+        maxStructuredSize?: number | null;
+        maxUnstructuredSize?: number | null;
+        deepAnalysisTokenLimit?: number | null;
+        deepAnalysisCharacterLimit?: number | null;
+    };
+};
+type SubscriptionForManagerQueryVariables = Exact<{
+    workspaceId: Scalars['String'];
+}>;
+type SubscriptionEntitlementsForManagerQueryVariables = Exact<{
+    workspaceId: Scalars['String'];
+}>;
+type UpgradePlanMutationVariables = Exact<{
+    targetPriceId: Scalars['String'];
+}>;
+type DowngradePlanMutationVariables = Exact<{
+    targetPriceId: Scalars['String'];
+}>;
+type AddSeatsMutationVariables = Exact<{
+    additionalSeats: Scalars['Int'];
+}>;
+type ChangeBillingCycleMutationVariables = Exact<{
+    targetPriceId: Scalars['String'];
+}>;
+type RemoveSeatsMutationVariables = Exact<{
+    seatsToRemove: Scalars['Int'];
+}>;
+type CancelSubscriptionForManagerMutationVariables = Exact<{
+    workspaceId: Scalars['String'];
+}>;
+type ReactivateSubscriptionForManagerMutationVariables = Exact<{
+    workspaceId: Scalars['String'];
+}>;
+type CreateCustomerMutationVariables = Exact<{
+    name: Scalars['String'];
+    email: Scalars['String'];
+    workspaceId: Scalars['String'];
+    userId: Scalars['String'];
+}>;
+type CreateCheckoutSessionMutationVariables = Exact<{
+    priceId: Scalars['String'];
+    successUrl: Scalars['String'];
+    cancelUrl: Scalars['String'];
+}>;
+type CreateCustomerPortalSessionMutationVariables = Exact<{
+    returnUrl: Scalars['String'];
+}>;
+
+interface BillingClientOptions {
+    /** Full billing GraphQL HTTP URL (e.g. 'https://billing.dvina.ai/graphql') */
+    billingHttpUrl: string;
+    /** Full billing SSE URL (e.g. 'https://billing.dvina.ai/subscriptions/stream') */
+    billingSseUrl: string;
+    /** Token callback — shared with the main SDK */
+    getToken: (options?: {
+        forceRefresh?: boolean;
+    }) => Promise<string>;
+    /** Global error callback — threaded from DvinaSdkOptions */
+    onError?: (error: DvinaError) => void;
+}
+declare class BillingClient {
+    private readonly http;
+    private readonly options;
+    private readonly activeAbortControllers;
+    constructor(options: BillingClientOptions);
+    /**
+     * Terminate all active SSE streams.
+     * Call this on logout or SDK teardown to prevent lingering connections.
+     */
+    destroy(): void;
+    get plans(): {
+        list: () => Promise<{
+            id: string;
+            name: string;
+            tier?: EntitlementTier | null;
+            features?: Array<any> | null;
+            prices: Array<{
+                id: string;
+                currency: string;
+                amount?: number | null;
+                interval?: SubscriptionCycle | null;
+            }>;
+            entitlements: {
+                canAddUser: boolean;
+                minUsers?: number | null;
+                team: boolean;
+                capacity?: number | null;
+                sourceTypes?: Array<string> | null;
+                softTokenUsageLimit?: number | null;
+                hardTokenUsageLimit?: number | null;
+                canAddReport: boolean;
+                canUseApi: boolean;
+                maxStructuredSize?: number | null;
+                maxUnstructuredSize?: number | null;
+                deepAnalysisTokenLimit?: number | null;
+                deepAnalysisCharacterLimit?: number | null;
+            };
+        }[]>;
+        get: (variables: PlanQueryVariables) => Promise<{
+            id: string;
+            name: string;
+            tier?: EntitlementTier | null;
+            features?: Array<any> | null;
+            prices: Array<{
+                id: string;
+                currency: string;
+                amount?: number | null;
+                interval?: SubscriptionCycle | null;
+            }>;
+            entitlements: {
+                canAddUser: boolean;
+                minUsers?: number | null;
+                team: boolean;
+                capacity?: number | null;
+                sourceTypes?: Array<string> | null;
+                softTokenUsageLimit?: number | null;
+                hardTokenUsageLimit?: number | null;
+                canAddReport: boolean;
+                canUseApi: boolean;
+                maxStructuredSize?: number | null;
+                maxUnstructuredSize?: number | null;
+                deepAnalysisTokenLimit?: number | null;
+                deepAnalysisCharacterLimit?: number | null;
+            };
+        } | null | undefined>;
+        entitlements: () => Promise<Record<EntitlementTier, EntitlementDetail>>;
+        tierOrders: () => Promise<any>;
+    };
+    get subscription(): {
+        get: () => Promise<{
+            tier: EntitlementTier;
+            provider?: SubscriptionProvider | null;
+            cycle?: SubscriptionCycle | null;
+            seats: number;
+            cancelAtPeriodEnd?: boolean | null;
+            currentPeriodStart?: any | null;
+            currentPeriodEnd?: any | null;
+            scheduledChange?: {
+                effectiveDate?: any | null;
+                newTier?: EntitlementTier | null;
+                newSeats?: number | null;
+                newCycle?: SubscriptionCycle | null;
+            } | null;
+        }>;
+        entitlements: () => Promise<{
+            canAddUser: boolean;
+            minUsers?: number | null;
+            team: boolean;
+            capacity?: number | null;
+            sourceTypes?: Array<string> | null;
+            softTokenUsageLimit?: number | null;
+            hardTokenUsageLimit?: number | null;
+            canAddReport: boolean;
+            canUseApi: boolean;
+            maxStructuredSize?: number | null;
+            maxUnstructuredSize?: number | null;
+            deepAnalysisTokenLimit?: number | null;
+            deepAnalysisCharacterLimit?: number | null;
+        }>;
+        upgrade: (variables: UpgradePlanMutationVariables) => Promise<boolean>;
+        prorationAmount: (variables: {
+            targetPriceId: string;
+        }) => Promise<number>;
+        downgrade: (variables: DowngradePlanMutationVariables) => Promise<boolean>;
+        changeBillingCycle: (variables: ChangeBillingCycleMutationVariables) => Promise<boolean>;
+        cancel: () => Promise<boolean>;
+        reactivate: () => Promise<boolean>;
+        releaseSchedule: () => Promise<boolean>;
+        /**
+         * Subscribe to real-time subscription updates via SSE.
+         * Returns an AsyncIterable that yields WorkspaceSubscription snapshots.
+         * Automatically reconnects with exponential backoff and token refresh on auth errors.
+         */
+        updates: () => AsyncIterable<WorkspaceSubscription>;
+    };
+    get seats(): {
+        add: (variables: AddSeatsMutationVariables) => Promise<boolean>;
+        remove: (variables: RemoveSeatsMutationVariables) => Promise<boolean>;
+    };
+    get session(): {
+        createSession: (variables: CreateCheckoutSessionMutationVariables) => Promise<{
+            url: string;
+        }>;
+        createCustomerPortalSession: (variables: CreateCustomerPortalSessionMutationVariables) => Promise<{
+            url: string;
+        }>;
+    };
+    get management(): {
+        subscription: (variables: SubscriptionForManagerQueryVariables) => Promise<{
+            tier: EntitlementTier;
+            provider?: SubscriptionProvider | null;
+            cycle?: SubscriptionCycle | null;
+            seats: number;
+            cancelAtPeriodEnd?: boolean | null;
+            currentPeriodStart?: any | null;
+            currentPeriodEnd?: any | null;
+            scheduledChange?: {
+                effectiveDate?: any | null;
+                newTier?: EntitlementTier | null;
+                newSeats?: number | null;
+                newCycle?: SubscriptionCycle | null;
+            } | null;
+        }>;
+        entitlements: (variables: SubscriptionEntitlementsForManagerQueryVariables) => Promise<{
+            canAddUser: boolean;
+            minUsers?: number | null;
+            team: boolean;
+            capacity?: number | null;
+            sourceTypes?: Array<string> | null;
+            softTokenUsageLimit?: number | null;
+            hardTokenUsageLimit?: number | null;
+            canAddReport: boolean;
+            canUseApi: boolean;
+            maxStructuredSize?: number | null;
+            maxUnstructuredSize?: number | null;
+            deepAnalysisTokenLimit?: number | null;
+            deepAnalysisCharacterLimit?: number | null;
+        }>;
+        cancel: (variables: CancelSubscriptionForManagerMutationVariables) => Promise<boolean>;
+        reactivate: (variables: ReactivateSubscriptionForManagerMutationVariables) => Promise<boolean>;
+        createCustomer: (variables: CreateCustomerMutationVariables) => Promise<string>;
+    };
+    private request;
+    /**
+     * Create an SSE stream that connects to the billing SSE endpoint.
+     * Reconnects automatically with exponential backoff.
+     * On 401/403, refreshes the token and retries with a short delay.
+     */
+    private createSseStream;
+}
+
+export { BillingClient, type BillingClientOptions, type EntitlementDetail, EntitlementTier, type Plan, type PlanFragmentFragment as PlanFragment, type Price, type ScheduledChange, SubscriptionCycle, SubscriptionProvider, type WorkspaceSubscription };