totalum-sdk 0.1.0-dev.7 → 0.1.0-dev.9

package/dist/index.d.ts

@@ -29,11 +29,11 @@ export { TotalumWeb } from './web/index.js';
 import { totalumWebhooks } from './webhooks/index.js';
 export { TotalumWebhookError, TotalumWebhooks, verifyWebhook } from './webhooks/index.js';
 export { D1Database, D1DatabaseSession, D1ExecResult, D1PreparedStatement, D1Result, READ_YOUR_WRITES_COOKIE, TotalumD1ClientCode, TotalumD1Error, TotalumD1ErrorCode, TotalumD1Options, isTotalumD1Error, totalumD1, withTotalumSession } from './d1/index.js';
-export { T as TotalumClientOptions, a as TotalumError, b as TotalumErrorCode, i as isTotalumError } from './_types/errors.d-yrue1e9O.js';
-export { C as CheckoutInput, a as CheckoutOutput, b as CronJob, c as CronJobInput, d as CronJobPatch, e as CronRun, f as CronRunsPage, g as CustomerPortalLinkInput, h as CustomerPortalLinkOutput, E as EmailSendInput, i as EmailSendOutput, j as EmailView, F as FileDescriptor, k as FileUploadUrlInput, l as FileUploadUrlOutput, m as FilesListQuery, n as FilesPage, J as JobCreated, O as OnboardingLinkInput, o as OnboardingLinkOutput, P as PaymentsStatus, p as PdfFromHtmlInput, q as PdfFromUrlInput, r as PdfOutput, S as ScanDocumentInput, s as ScanOcrInput, t as ScanOcrOutput, u as ScreenshotInput, v as ScreenshotOutput, w as SeoIndexNowKey, x as SeoNotifyOutput, y as SpeakInput, z as StoredMedia, T as TranscribeInput, A as TranscribeOutput, W as WebJob, B as WebScrapeOutput, D as WebSearchOutput } from './_types/integrations.d-BKPWost0.js';
-export { L as LogsPage, S as SiteAnalyticsOutput, a as SiteDimension, b as SiteMetric } from './_types/ops.d-BOMT9yln.js';
-export { W as WebhookConfig, a as WebhookEvent, b as WebhookSecretOutput } from './_types/billing.d-C1exPLN6.js';
-import './_types/coerce.d-RtY2zQyw.js';
+export { T as TotalumClientOptions, a as TotalumError, b as TotalumErrorCode, i as isTotalumError } from './_types/errors.d-Cu3q_E_r.js';
+export { C as CheckoutInput, a as CheckoutOutput, b as CronJob, c as CronJobInput, d as CronJobPatch, e as CronRun, f as CronRunsPage, g as CustomerPortalLinkInput, h as CustomerPortalLinkOutput, E as EmailSendInput, i as EmailSendOutput, j as EmailView, F as FileDescriptor, k as FileUploadUrlInput, l as FileUploadUrlOutput, m as FilesListQuery, n as FilesPage, J as JobCreated, O as OnboardingLinkInput, o as OnboardingLinkOutput, P as PaymentsStatus, p as PdfFromHtmlInput, q as PdfFromUrlInput, r as PdfOutput, S as ScanDocumentInput, s as ScanOcrInput, t as ScanOcrOutput, u as ScreenshotInput, v as ScreenshotOutput, w as SeoIndexNowKey, x as SeoNotifyOutput, y as SpeakInput, z as StoredMedia, T as TranscribeInput, A as TranscribeOutput, W as WebJob, B as WebScrapeOutput, D as WebSearchOutput } from './_types/integrations.d-BNGV70e3.js';
+export { L as LogsPage, S as SiteAnalyticsOutput, a as SiteDimension, b as SiteMetric } from './_types/ops.d-C9375KIG.js';
+export { W as WebhookConfig, a as WebhookEvent, b as WebhookSecretOutput } from './_types/billing.d-BbSZh1wY.js';
+import './_types/coerce.d-C0KIW76L.js';
 
 /** The options of `createTotalum()`: every namespace's options in one object (each falls back to its env var). */
 type TotalumOptions = TotalumAiOptions & TotalumFilesOptions;

package/dist/logs/index.d.ts

@@ -1,8 +1,8 @@
-import { c as LogsQueryInput } from '../_types/ops.d-BOMT9yln.js';
-export { L as LogsPage } from '../_types/ops.d-BOMT9yln.js';
-import { T as TotalumClientOptions } from '../_types/errors.d-yrue1e9O.js';
-export { a as TotalumError, i as isTotalumError } from '../_types/errors.d-yrue1e9O.js';
-import '../_types/coerce.d-RtY2zQyw.js';
+import { c as LogsQueryInput } from '../_types/ops.d-C9375KIG.js';
+export { L as LogsPage } from '../_types/ops.d-C9375KIG.js';
+import { T as TotalumClientOptions } from '../_types/errors.d-Cu3q_E_r.js';
+export { a as TotalumError, i as isTotalumError } from '../_types/errors.d-Cu3q_E_r.js';
+import '../_types/coerce.d-C0KIW76L.js';
 
 /** A `logs.query` filter: the window (default the last hour), level, substring, status class, path, request id, env. */
 type LogsQuery = Omit<LogsQueryInput, 'caller' | 'runId'>;

package/dist/payments/index.d.ts

@@ -1,8 +1,8 @@
-import { O as OnboardingLinkInput, C as CheckoutInput, g as CustomerPortalLinkInput } from '../_types/integrations.d-BKPWost0.js';
-export { a as CheckoutOutput, h as CustomerPortalLinkOutput, o as OnboardingLinkOutput, P as PaymentsStatus } from '../_types/integrations.d-BKPWost0.js';
-import { T as TotalumClientOptions } from '../_types/errors.d-yrue1e9O.js';
-export { a as TotalumError, i as isTotalumError } from '../_types/errors.d-yrue1e9O.js';
-import '../_types/coerce.d-RtY2zQyw.js';
+import { O as OnboardingLinkInput, C as CheckoutInput, g as CustomerPortalLinkInput } from '../_types/integrations.d-BNGV70e3.js';
+export { a as CheckoutOutput, h as CustomerPortalLinkOutput, o as OnboardingLinkOutput, P as PaymentsStatus } from '../_types/integrations.d-BNGV70e3.js';
+import { T as TotalumClientOptions } from '../_types/errors.d-Cu3q_E_r.js';
+export { a as TotalumError, i as isTotalumError } from '../_types/errors.d-Cu3q_E_r.js';
+import '../_types/coerce.d-C0KIW76L.js';
 
 /**
  * `totalum.payments` (plan 05, plan 11 §9.5) over SDK-API `/v1/payments/*` with a project key (scope `payments`): Stripe

package/dist/pdf/index.d.ts

@@ -1,8 +1,8 @@
-import { p as PdfFromHtmlInput, q as PdfFromUrlInput } from '../_types/integrations.d-BKPWost0.js';
-export { r as PdfOutput } from '../_types/integrations.d-BKPWost0.js';
-import { T as TotalumClientOptions } from '../_types/errors.d-yrue1e9O.js';
-export { a as TotalumError, i as isTotalumError } from '../_types/errors.d-yrue1e9O.js';
-import '../_types/coerce.d-RtY2zQyw.js';
+import { p as PdfFromHtmlInput, q as PdfFromUrlInput } from '../_types/integrations.d-BNGV70e3.js';
+export { r as PdfOutput } from '../_types/integrations.d-BNGV70e3.js';
+import { T as TotalumClientOptions } from '../_types/errors.d-Cu3q_E_r.js';
+export { a as TotalumError, i as isTotalumError } from '../_types/errors.d-Cu3q_E_r.js';
+import '../_types/coerce.d-C0KIW76L.js';
 
 /** `totalum.pdf` (plan 04 §5.5) over `/v1/pdf/*` (scope `files:write`): a new file in the project's storage each time. */
 declare function totalumPdf(options?: TotalumClientOptions): {

package/dist/react/index.d.ts

@@ -0,0 +1,91 @@
+/**
+ * `totalum-sdk/react` (plan 06 §12.5, A6.33): the browser side of `totalum.realtime`. The page never holds a key: it
+ * asks the app's own server for a ticket (`POST ticketUrl {room}`, default `/api/realtime/ticket`), opens the room's
+ * socket, and on every drop — a Totalum deploy drops them all — re-tickets and reconnects with backoff. Presence is
+ * built on the same socket: `presence:*` messages plus a 30 s heartbeat (a room with present users stays awake).
+ */
+type RealtimeStatus = 'connecting' | 'open' | 'reconnecting' | 'closed';
+interface RealtimeMessage<T = unknown> {
+    id: string;
+    event: string;
+    identity: {
+        id: string;
+        name?: string;
+    };
+    data: T;
+    ts: string;
+}
+interface RealtimePeer<M = Record<string, unknown>> {
+    /** One per open socket: the same user in two tabs is two peers with the same `identity`. */
+    connectionId: string;
+    identity: {
+        id: string;
+        name?: string;
+    };
+    meta: M;
+}
+interface RealtimeChannelOptions<M = Record<string, unknown>> {
+    /** The app's route that mints the ticket; it receives `{ room }` and answers `{ url }` or `{ data: { url } }`. */
+    ticketUrl?: string;
+    /** Or mint the ticket yourself. */
+    getTicket?: (room: string) => Promise<{
+        url: string;
+    }>;
+    /** Announce this connection's presence with this metadata (name, colour…); `others` lists everyone else's. */
+    presence?: M;
+    /** Messages kept in memory, newest last (default 100). */
+    keep?: number;
+    /** Tests only. */
+    WebSocket?: typeof WebSocket;
+}
+interface RealtimeSnapshot<M = Record<string, unknown>> {
+    status: RealtimeStatus;
+    messages: RealtimeMessage[];
+    others: RealtimePeer<M>[];
+}
+/** One room, one socket; framework-free (the hook below is a thin wrapper). */
+declare class RealtimeChannel<M = Record<string, unknown>> {
+    readonly room: string;
+    private readonly options;
+    private ws;
+    private stopped;
+    private attempt;
+    private timer;
+    private heartbeat;
+    private readonly peers;
+    private readonly listeners;
+    private readonly connectionId;
+    private snapshot;
+    constructor(room: string, options?: RealtimeChannelOptions<M>);
+    subscribe: (listener: () => void) => (() => void);
+    getSnapshot: () => RealtimeSnapshot<M>;
+    connect(): void;
+    /** Sends `data` to everyone in the room (you included); `false` when the socket is not open. */
+    publish: (data: unknown, event?: string) => boolean;
+    close(): void;
+    private open;
+    private ticket;
+    /** A drop is normal (every deploy drops every socket): re-ticket and reconnect, 0.5 s … 30 s apart. */
+    private retry;
+    private send;
+    private receive;
+    /** Peers whose socket dropped without a goodbye disappear after 75 s of silence. */
+    private expire;
+    private set;
+}
+/**
+ * A room in a client component: `status`, the `messages` received since it opened, `others` (with `presence`), and
+ * `publish(data, event?)`. Render `status === 'reconnecting'` as an ordinary state, not an error.
+ *
+ * @example
+ * const { messages, others, publish, status } = useRealtimeChannel(`chat:${roomId}`, { presence: { name } });
+ */
+declare function useRealtimeChannel<M = Record<string, unknown>>(room: string, options?: RealtimeChannelOptions<M>): {
+    publish: (data: unknown, event?: string) => boolean;
+    status: RealtimeStatus;
+    messages: RealtimeMessage[];
+    others: RealtimePeer<M>[];
+};
+
+export { RealtimeChannel, useRealtimeChannel };
+export type { RealtimeChannelOptions, RealtimeMessage, RealtimePeer, RealtimeSnapshot, RealtimeStatus };

package/dist/react/index.js

@@ -0,0 +1,178 @@
+import { useEffect, useMemo, useSyncExternalStore } from 'react';
+const HEARTBEAT_MS = 30_000;
+const STALE_MS = 75_000;
+const PRESENCE = 'presence:';
+/** One room, one socket; framework-free (the hook below is a thin wrapper). */
+export class RealtimeChannel {
+    room;
+    options;
+    ws;
+    stopped = true;
+    attempt = 0;
+    timer;
+    heartbeat;
+    peers = new Map();
+    listeners = new Set();
+    connectionId = crypto.randomUUID();
+    snapshot = { status: 'closed', messages: [], others: [] };
+    constructor(room, options = {}) {
+        this.room = room;
+        this.options = options;
+    }
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    };
+    getSnapshot = () => this.snapshot;
+    connect() {
+        if (!this.stopped)
+            return;
+        this.stopped = false;
+        this.set({ status: 'connecting' });
+        void this.open();
+        if (this.options.presence)
+            this.heartbeat = setInterval(() => {
+                this.send(`${PRESENCE}here`, this.options.presence);
+                this.expire();
+            }, HEARTBEAT_MS);
+    }
+    /** Sends `data` to everyone in the room (you included); `false` when the socket is not open. */
+    publish = (data, event = 'message') => this.send(event, data);
+    close() {
+        if (this.options.presence)
+            this.send(`${PRESENCE}leave`, null);
+        this.stopped = true;
+        clearTimeout(this.timer);
+        clearInterval(this.heartbeat);
+        this.ws?.close(1000, 'closed');
+        this.ws = undefined;
+        this.peers.clear();
+        this.set({ status: 'closed', others: [] });
+    }
+    async open() {
+        try {
+            const { url } = await this.ticket();
+            if (this.stopped)
+                return;
+            const ws = new (this.options.WebSocket ?? WebSocket)(url);
+            this.ws = ws;
+            ws.addEventListener('open', () => {
+                this.attempt = 0;
+                this.set({ status: 'open' });
+                if (this.options.presence)
+                    this.send(`${PRESENCE}join`, this.options.presence);
+            });
+            ws.addEventListener('message', (e) => {
+                this.receive(String(e.data));
+            });
+            ws.addEventListener('close', () => {
+                if (this.ws === ws)
+                    this.retry();
+            });
+        }
+        catch {
+            this.retry();
+        }
+    }
+    async ticket() {
+        if (this.options.getTicket)
+            return this.options.getTicket(this.room);
+        const res = await fetch(this.options.ticketUrl ?? '/api/realtime/ticket', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ room: this.room }),
+        });
+        if (!res.ok)
+            throw new Error(`ticket ${String(res.status)}`);
+        const body = await res.json();
+        const { url, data } = body;
+        return { url: url ?? data?.url ?? '' };
+    }
+    /** A drop is normal (every deploy drops every socket): re-ticket and reconnect, 0.5 s … 30 s apart. */
+    retry() {
+        this.ws = undefined;
+        if (this.stopped)
+            return;
+        this.peers.clear();
+        this.set({ status: 'reconnecting', others: [] });
+        const delay = Math.min(30_000, 500 * 2 ** this.attempt++) * (0.75 + Math.random() / 2);
+        this.timer = setTimeout(() => void this.open(), delay);
+    }
+    send(event, data) {
+        if (this.ws?.readyState !== 1)
+            return false;
+        const payload = event.startsWith(PRESENCE) ? { connectionId: this.connectionId, meta: data } : data;
+        this.ws.send(JSON.stringify({ type: 'publish', event, data: payload }));
+        return true;
+    }
+    receive(raw) {
+        let frame;
+        try {
+            frame = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        if (frame.type !== 'message' || !frame.event || !frame.identity)
+            return;
+        if (!frame.event.startsWith(PRESENCE)) {
+            const keep = this.options.keep ?? 100;
+            this.set({ messages: [...this.snapshot.messages, frame].slice(-keep) });
+            return;
+        }
+        const { connectionId, meta } = (frame.data ?? {});
+        if (!this.options.presence || !connectionId || connectionId === this.connectionId)
+            return;
+        if (frame.event === `${PRESENCE}leave`)
+            this.peers.delete(connectionId);
+        else {
+            // a newcomer learns who is already here
+            if (frame.event === `${PRESENCE}join`)
+                this.send(`${PRESENCE}here`, this.options.presence);
+            this.peers.set(connectionId, {
+                connectionId,
+                identity: frame.identity,
+                meta: meta,
+                seen: Date.now(),
+            });
+        }
+        this.expire();
+    }
+    /** Peers whose socket dropped without a goodbye disappear after 75 s of silence. */
+    expire() {
+        for (const [id, peer] of this.peers)
+            if (Date.now() - peer.seen > STALE_MS)
+                this.peers.delete(id);
+        const others = [...this.peers.values()].map(({ connectionId, identity, meta }) => ({
+            connectionId,
+            identity,
+            meta,
+        }));
+        this.set({ others });
+    }
+    set(patch) {
+        this.snapshot = { ...this.snapshot, ...patch };
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+const SERVER = { status: 'connecting', messages: [], others: [] };
+/**
+ * A room in a client component: `status`, the `messages` received since it opened, `others` (with `presence`), and
+ * `publish(data, event?)`. Render `status === 'reconnecting'` as an ordinary state, not an error.
+ *
+ * @example
+ * const { messages, others, publish, status } = useRealtimeChannel(`chat:${roomId}`, { presence: { name } });
+ */
+export function useRealtimeChannel(room, options = {}) {
+    // one channel per room; the options of its first render are the ones it keeps
+    const channel = useMemo(() => new RealtimeChannel(room, options), [room]);
+    useEffect(() => {
+        channel.connect();
+        return () => {
+            channel.close();
+        };
+    }, [channel]);
+    const snapshot = useSyncExternalStore(channel.subscribe, channel.getSnapshot, () => SERVER);
+    return { ...snapshot, publish: channel.publish };
+}

package/dist/realtime/index.d.ts

@@ -1,5 +1,5 @@
-import { Z as ZodObject, c as ZodOptional, d as ZodString, g as ZodUnknown, m as $strip, o as output, t as ZodISODateTime, l as ZodInt, h as ZodRecord, j as ZodBoolean, T as TotalumClientOptions } from '../_types/errors.d-yrue1e9O.js';
-export { a as TotalumError, i as isTotalumError } from '../_types/errors.d-yrue1e9O.js';
+import { Z as ZodObject, c as ZodOptional, d as ZodString, g as ZodUnknown, m as $strip, o as output, t as ZodISODateTime, l as ZodInt, h as ZodRecord, j as ZodBoolean, T as TotalumClientOptions } from '../_types/errors.d-Cu3q_E_r.js';
+export { a as TotalumError, i as isTotalumError } from '../_types/errors.d-Cu3q_E_r.js';
 
 /** `POST /v1/realtime/tickets` (scope `realtime`). `ttl` is the join window in seconds, not the session length. */
 declare const RealtimeTicketInput: ZodObject<{

package/dist/scan/index.d.ts

@@ -1,8 +1,8 @@
-import { S as ScanDocumentInput, s as ScanOcrInput } from '../_types/integrations.d-BKPWost0.js';
-export { t as ScanOcrOutput } from '../_types/integrations.d-BKPWost0.js';
-import { T as TotalumClientOptions } from '../_types/errors.d-yrue1e9O.js';
-export { a as TotalumError, i as isTotalumError } from '../_types/errors.d-yrue1e9O.js';
-import '../_types/coerce.d-RtY2zQyw.js';
+import { S as ScanDocumentInput, s as ScanOcrInput } from '../_types/integrations.d-BNGV70e3.js';
+export { t as ScanOcrOutput } from '../_types/integrations.d-BNGV70e3.js';
+import { T as TotalumClientOptions } from '../_types/errors.d-Cu3q_E_r.js';
+export { a as TotalumError, i as isTotalumError } from '../_types/errors.d-Cu3q_E_r.js';
+import '../_types/coerce.d-C0KIW76L.js';
 
 /** The v1 scan result: the extracted fields (one set per page with `processEveryPdfPageAsDifferentScan`) + `metadata`. */
 interface ScanDocumentResult {

package/dist/seo/index.d.ts

@@ -1,7 +1,7 @@
-export { w as SeoIndexNowKey, x as SeoNotifyOutput } from '../_types/integrations.d-BKPWost0.js';
-import { T as TotalumClientOptions } from '../_types/errors.d-yrue1e9O.js';
-export { a as TotalumError, i as isTotalumError } from '../_types/errors.d-yrue1e9O.js';
-import '../_types/coerce.d-RtY2zQyw.js';
+export { w as SeoIndexNowKey, x as SeoNotifyOutput } from '../_types/integrations.d-BNGV70e3.js';
+import { T as TotalumClientOptions } from '../_types/errors.d-Cu3q_E_r.js';
+export { a as TotalumError, i as isTotalumError } from '../_types/errors.d-Cu3q_E_r.js';
+import '../_types/coerce.d-C0KIW76L.js';
 
 /** `totalum.seo` (plan 05 §6.10) over SDK-API `/v1/seo/*` (scope `seo`): IndexNow for verified custom domains, free. */
 declare function totalumSeo(options?: TotalumClientOptions): {

package/dist/speech/index.d.ts

@@ -1,8 +1,8 @@
-import { T as TranscribeInput, y as SpeakInput, z as StoredMedia } from '../_types/integrations.d-BKPWost0.js';
-export { A as TranscribeOutput } from '../_types/integrations.d-BKPWost0.js';
-import { T as TotalumClientOptions } from '../_types/errors.d-yrue1e9O.js';
-export { a as TotalumError, i as isTotalumError } from '../_types/errors.d-yrue1e9O.js';
-import '../_types/coerce.d-RtY2zQyw.js';
+import { T as TranscribeInput, y as SpeakInput, z as StoredMedia } from '../_types/integrations.d-BNGV70e3.js';
+export { A as TranscribeOutput } from '../_types/integrations.d-BNGV70e3.js';
+import { T as TotalumClientOptions } from '../_types/errors.d-Cu3q_E_r.js';
+export { a as TotalumError, i as isTotalumError } from '../_types/errors.d-Cu3q_E_r.js';
+import '../_types/coerce.d-C0KIW76L.js';
 
 /** `totalum.speech` (plan 05 §6.8) over `/v1/speech/*` (scope `speech`): OpenRouter speech through Totalum. */
 declare function totalumSpeech(options?: TotalumClientOptions): {

package/dist/web/index.d.ts

@@ -1,8 +1,8 @@
-import { G as WebScrapeInput, H as WebSearchInput, I as WebMapInput, K as WebCrawlInput, u as ScreenshotInput } from '../_types/integrations.d-BKPWost0.js';
-export { J as JobCreated, v as ScreenshotOutput, W as WebJob, B as WebScrapeOutput, D as WebSearchOutput } from '../_types/integrations.d-BKPWost0.js';
-import { T as TotalumClientOptions } from '../_types/errors.d-yrue1e9O.js';
-export { a as TotalumError, i as isTotalumError } from '../_types/errors.d-yrue1e9O.js';
-import '../_types/coerce.d-RtY2zQyw.js';
+import { G as WebScrapeInput, H as WebSearchInput, I as WebMapInput, K as WebCrawlInput, u as ScreenshotInput } from '../_types/integrations.d-BNGV70e3.js';
+export { J as JobCreated, v as ScreenshotOutput, W as WebJob, B as WebScrapeOutput, D as WebSearchOutput } from '../_types/integrations.d-BNGV70e3.js';
+import { T as TotalumClientOptions } from '../_types/errors.d-Cu3q_E_r.js';
+export { a as TotalumError, i as isTotalumError } from '../_types/errors.d-Cu3q_E_r.js';
+import '../_types/coerce.d-C0KIW76L.js';
 
 /**
  * `totalum.web` (plan 05 §6.2) over SDK-API `/v1/web/*` (scope `web`): Firecrawl scrape/search/map/crawl and Browser

package/dist/webhooks/index.d.ts

@@ -1,7 +1,7 @@
-import { a as WebhookEvent } from '../_types/billing.d-C1exPLN6.js';
-export { W as WebhookConfig, b as WebhookSecretOutput } from '../_types/billing.d-C1exPLN6.js';
-import { T as TotalumClientOptions, a as TotalumError } from '../_types/errors.d-yrue1e9O.js';
-export { i as isTotalumError } from '../_types/errors.d-yrue1e9O.js';
+import { a as WebhookEvent } from '../_types/billing.d-BbSZh1wY.js';
+export { W as WebhookConfig, b as WebhookSecretOutput } from '../_types/billing.d-BbSZh1wY.js';
+import { T as TotalumClientOptions, a as TotalumError } from '../_types/errors.d-Cu3q_E_r.js';
+export { i as isTotalumError } from '../_types/errors.d-Cu3q_E_r.js';
 
 /** A webhook refusal (plan 05 §7.2): the codes never travel, the app answers 400. */
 declare class TotalumWebhookError extends TotalumError {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "totalum-sdk",
-  "version": "0.1.0-dev.7",
+  "version": "0.1.0-dev.9",
   "description": "The SDK generated Totalum apps import: every integration namespace over SDK-API (totalum-sdk, or one subpath each: /files, /ai, /web, …) and totalum-sdk/d1, the D1 driver",
   "license": "UNLICENSED",
   "type": "module",
@@ -80,6 +80,10 @@
     "./analytics": {
       "types": "./dist/analytics/index.d.ts",
       "default": "./dist/analytics/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "default": "./dist/react/index.js"
     }
   },
   "sideEffects": false,
@@ -100,11 +104,15 @@
     "types:check": "node scripts/check-types.mjs"
   },
   "peerDependencies": {
-    "@libsql/client": "0.18.0"
+    "@libsql/client": "0.18.0",
+    "react": ">=18"
   },
   "peerDependenciesMeta": {
     "@libsql/client": {
       "optional": true
+    },
+    "react": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -116,6 +124,7 @@
     "@libsql/client": "0.18.0",
     "@speed-paradigm/totalum-contracts": "link:../totalum-contracts",
     "@types/node": "22.20.4",
+    "@types/react": "19.3.0",
     "drizzle-orm": "0.45.3",
     "esbuild": "0.28.1",
     "eslint": "9.39.5",
@@ -124,6 +133,7 @@
     "lefthook": "2.1.14",
     "miniflare": "5.20260921.0-alpha",
     "prettier": "3.9.8",
+    "react": "19.3.0",
     "rollup": "4.63.4",
     "rollup-plugin-dts": "6.5.1",
     "totalum-sdk-api": "link:../totalum-sdk-api",