@stratasync/react 0.2.0

package/README.md

@@ -0,0 +1,91 @@
+# @stratasync/react
+
+React bindings and hooks for the Done.
+
+## Overview
+
+sync-react provides React hooks for data fetching, real-time updates, and collaborative editing:
+
+- **SyncProvider** — context provider for the sync client
+- **useModel / useQuery** — data fetching with Suspense or loading states
+- **useConnectionState** — monitor sync connection status
+- **useYjsDocument / useYjsPresence** — collaborative editing and presence
+
+## Installation
+
+```bash
+npm install @stratasync/react
+```
+
+Peer dependencies: `react` ^18.0.0 || ^19.0.0, `yjs` ^13.6.0 (for collaborative features)
+
+## Setup
+
+Wrap your app with `SyncProvider`:
+
+```tsx
+import { SyncProvider } from "@stratasync/react";
+
+function App() {
+  return (
+    <SyncProvider config={syncConfig}>
+      <YourApp />
+    </SyncProvider>
+  );
+}
+```
+
+## Hooks
+
+### Data Fetching
+
+```typescript
+// Single model with Suspense (throws promise while loading)
+const task = useModel("Task", taskId);
+
+// Single model with loading state (no Suspense)
+const { data: task, isLoading } = useQuery("Task", {
+  where: (i) => i.id === taskId,
+});
+
+// Filtered query
+const { data: tasks, isLoading } = useQuery("Task", {
+  where: (i) => i.workspaceId === workspaceId && !i.completedAt,
+  limit: 50,
+});
+
+// Skip query conditionally
+const { data } = useQuery("Task", { skip: !workspaceId });
+```
+
+### Connection State
+
+```typescript
+const { state, isReady, isSyncing, isOffline } = useConnectionState();
+// state: "idle" | "loading" | "syncing" | "error"
+```
+
+### Collaborative Editing (Yjs)
+
+```typescript
+const { doc, isConnected, participants, content } = useYjsDocument(
+  { entityType: "Task", entityId: taskId, fieldName: "description" },
+  { autoConnect: true }
+);
+```
+
+## Package Structure
+
+```
+src/
+├── hooks/
+│   ├── use-sync-client.ts       — Access SyncClient instance
+│   ├── use-model.ts             — Single model (Suspense)
+│   ├── use-query.ts             — Filtered queries
+│   ├── use-connection-state.ts  — Connection monitoring
+│   ├── use-yjs-document.ts      — Collaborative editing
+│   └── use-yjs-presence.ts      — Presence tracking
+├── provider.tsx                 — SyncProvider component
+├── context.ts                   — React context
+└── types.ts                     — Type definitions
+```

package/dist/context.d.ts

@@ -0,0 +1,21 @@
+import type { Context } from "react";
+import type { SyncContextValue, SyncStatusContextValue } from "./types.js";
+/**
+ * React context for the sync client
+ */
+export declare const SyncContext: Context<SyncContextValue | null>;
+/**
+ * React context for the sync client instance only.
+ * This stays stable across backlog/status updates.
+ */
+export declare const SyncClientContext: Context<SyncContextValue["client"] | null>;
+/**
+ * React context for sync lifecycle/status state.
+ * Backlog is split out to avoid frequent subscription churn.
+ */
+export declare const SyncStatusContext: Context<SyncStatusContextValue | null>;
+/**
+ * React context for pending backlog count.
+ */
+export declare const SyncBacklogContext: Context<number>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAErC,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,WAAW,kCAA+C,CAAC;AAOxE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,IAAI,CACjB,CAAC;AAGzD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,wCAE7B,CAAC;AAGF;;GAEG;AACH,eAAO,MAAM,kBAAkB,iBAA2B,CAAC"}

package/dist/context.js

@@ -0,0 +1,27 @@
+import { createContext } from "react";
+/**
+ * React context for the sync client
+ */
+export const SyncContext = createContext(null);
+/**
+ * Display name for React DevTools
+ */
+SyncContext.displayName = "SyncContext";
+/**
+ * React context for the sync client instance only.
+ * This stays stable across backlog/status updates.
+ */
+export const SyncClientContext = createContext(null);
+SyncClientContext.displayName = "SyncClientContext";
+/**
+ * React context for sync lifecycle/status state.
+ * Backlog is split out to avoid frequent subscription churn.
+ */
+export const SyncStatusContext = createContext(null);
+SyncStatusContext.displayName = "SyncStatusContext";
+/**
+ * React context for pending backlog count.
+ */
+export const SyncBacklogContext = createContext(0);
+SyncBacklogContext.displayName = "SyncBacklogContext";
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAKtC;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAA0B,IAAI,CAAC,CAAC;AAExE;;GAEG;AACH,WAAW,CAAC,WAAW,GAAG,aAAa,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC5B,aAAa,CAAoC,IAAI,CAAC,CAAC;AACzD,iBAAiB,CAAC,WAAW,GAAG,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAC5C,IAAI,CACL,CAAC;AACF,iBAAiB,CAAC,WAAW,GAAG,mBAAmB,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAS,CAAC,CAAC,CAAC;AAC3D,kBAAkB,CAAC,WAAW,GAAG,oBAAoB,CAAC"}

package/dist/hooks/use-connection-state.d.ts

@@ -0,0 +1,55 @@
+import type { UseConnectionStateResult, UsePendingCountResult } from "../types.js";
+/**
+ * Hook to access the current connection state
+ *
+ * @example
+ * ```tsx
+ * function ConnectionStatus() {
+ *   const { status, lastSyncId, backlog, error } = useConnectionState();
+ *
+ *   if (error) return <Badge color="red">Error</Badge>;
+ *   if (status === 'bootstrapping') return <Badge>Bootstrapping...</Badge>;
+ *   return <Badge>Sync ID: {lastSyncId} ({backlog} pending)</Badge>;
+ * }
+ * ```
+ */
+export declare const useConnectionState: () => UseConnectionStateResult;
+/**
+ * Hook to get the count of pending (unsynced) transactions
+ *
+ * @example
+ * ```tsx
+ * function PendingIndicator() {
+ *   const { count, hasPending } = usePendingCount();
+ *
+ *   if (!hasPending) return null;
+ *   return <Badge>{count} changes pending sync</Badge>;
+ * }
+ * ```
+ */
+export declare const usePendingCount: () => UsePendingCountResult;
+/**
+ * Hook to check if the app is offline
+ */
+export declare const useIsOffline: () => boolean;
+/**
+ * Hook to manually trigger a sync
+ *
+ * @example
+ * ```tsx
+ * function SyncButton() {
+ *   const { sync, isSyncing } = useSync();
+ *
+ *   return (
+ *     <button onClick={sync} disabled={isSyncing}>
+ *       {isSyncing ? 'Syncing...' : 'Sync Now'}
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+export declare const useSync: () => {
+    sync: () => Promise<void>;
+    isSyncing: boolean;
+};
+//# sourceMappingURL=use-connection-state.d.ts.map

package/dist/hooks/use-connection-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-connection-state.d.ts","sourceRoot":"","sources":["../../src/hooks/use-connection-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAOrB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,QAAO,wBAUrC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,QAAO,qBAOlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,QAAO,OAG/B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,OAAO,QAAO;IACzB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;CAsBpB,CAAC"}

package/dist/hooks/use-connection-state.js

@@ -0,0 +1,90 @@
+import { useCallback, useRef, useState } from "react";
+import { useSyncBacklogValue, useSyncClientInstance, useSyncStatusValue, } from "./use-sync-client.js";
+/**
+ * Hook to access the current connection state
+ *
+ * @example
+ * ```tsx
+ * function ConnectionStatus() {
+ *   const { status, lastSyncId, backlog, error } = useConnectionState();
+ *
+ *   if (error) return <Badge color="red">Error</Badge>;
+ *   if (status === 'bootstrapping') return <Badge>Bootstrapping...</Badge>;
+ *   return <Badge>Sync ID: {lastSyncId} ({backlog} pending)</Badge>;
+ * }
+ * ```
+ */
+export const useConnectionState = () => {
+    const { state, lastSyncId, error } = useSyncStatusValue();
+    const backlog = useSyncBacklogValue();
+    return {
+        backlog,
+        error,
+        lastSyncId,
+        status: state,
+    };
+};
+/**
+ * Hook to get the count of pending (unsynced) transactions
+ *
+ * @example
+ * ```tsx
+ * function PendingIndicator() {
+ *   const { count, hasPending } = usePendingCount();
+ *
+ *   if (!hasPending) return null;
+ *   return <Badge>{count} changes pending sync</Badge>;
+ * }
+ * ```
+ */
+export const usePendingCount = () => {
+    const backlog = useSyncBacklogValue();
+    return {
+        count: backlog,
+        hasPending: backlog > 0,
+    };
+};
+/**
+ * Hook to check if the app is offline
+ */
+export const useIsOffline = () => {
+    const { isOffline } = useSyncStatusValue();
+    return isOffline;
+};
+/**
+ * Hook to manually trigger a sync
+ *
+ * @example
+ * ```tsx
+ * function SyncButton() {
+ *   const { sync, isSyncing } = useSync();
+ *
+ *   return (
+ *     <button onClick={sync} disabled={isSyncing}>
+ *       {isSyncing ? 'Syncing...' : 'Sync Now'}
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+export const useSync = () => {
+    const client = useSyncClientInstance();
+    const [isSyncing, setIsSyncing] = useState(false);
+    const isSyncingRef = useRef(false);
+    const sync = useCallback(async () => {
+        if (isSyncingRef.current) {
+            return;
+        }
+        isSyncingRef.current = true;
+        setIsSyncing(true);
+        try {
+            await client.syncNow();
+        }
+        finally {
+            isSyncingRef.current = false;
+            setIsSyncing(false);
+        }
+    }, [client]);
+    return { isSyncing, sync };
+};
+//# sourceMappingURL=use-connection-state.js.map

package/dist/hooks/use-connection-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-connection-state.js","sourceRoot":"","sources":["../../src/hooks/use-connection-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAMtD,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAA6B,EAAE;IAC/D,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,kBAAkB,EAAE,CAAC;IAC1D,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IAEtC,OAAO;QACL,OAAO;QACP,KAAK;QACL,UAAU;QACV,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAA0B,EAAE;IACzD,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IAEtC,OAAO;QACL,KAAK,EAAE,OAAO;QACd,UAAU,EAAE,OAAO,GAAG,CAAC;KACxB,CAAC;AACJ,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAY,EAAE;IACxC,MAAM,EAAE,SAAS,EAAE,GAAG,kBAAkB,EAAE,CAAC;IAC3C,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,GAGrB,EAAE;IACF,MAAM,MAAM,GAAG,qBAAqB,EAAE,CAAC;IACvC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEnC,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAClC,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QAED,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC;QAC5B,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACzB,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,GAAG,KAAK,CAAC;YAC7B,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC,CAAC"}

package/dist/hooks/use-model.d.ts

@@ -0,0 +1,22 @@
+import type { UseModelResult } from "../types.js";
+/**
+ * Hook to access a single model by ID
+ * Suspends while bootstrapping or lazy hydration is in progress
+ *
+ * @param modelName - Name of the model to fetch
+ * @param id - ID of the model instance
+ * @returns Model instance or null if not found
+ *
+ * @example
+ * ```tsx
+ * const user = useModel<User>('User', userId);
+ * if (!user) return <NotFound />;
+ * return <div>{user.name}</div>;
+ * ```
+ */
+export declare const useModel: <T>(modelName: string, id: string | null | undefined) => T | null;
+/**
+ * Non-suspense model hook with loading state
+ */
+export declare const useModelState: <T>(modelName: string, id: string | null | undefined) => UseModelResult<T>;
+//# sourceMappingURL=use-model.d.ts.map

package/dist/hooks/use-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-model.d.ts","sourceRoot":"","sources":["../../src/hooks/use-model.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAOlD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,WAAW,MAAM,EACjB,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,KAC5B,CAAC,GAAG,IAmGN,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAC7B,WAAW,MAAM,EACjB,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,KAC5B,cAAc,CAAC,CAAC,CAmElB,CAAC"}

package/dist/hooks/use-model.js

@@ -0,0 +1,162 @@
+import { useCallback, useEffect, useRef, useState, useSyncExternalStore, } from "react";
+import { useSyncClientInstance, useSyncError, useSyncReady, } from "./use-sync-client.js";
+/**
+ * Hook to access a single model by ID
+ * Suspends while bootstrapping or lazy hydration is in progress
+ *
+ * @param modelName - Name of the model to fetch
+ * @param id - ID of the model instance
+ * @returns Model instance or null if not found
+ *
+ * @example
+ * ```tsx
+ * const user = useModel<User>('User', userId);
+ * if (!user) return <NotFound />;
+ * return <div>{user.name}</div>;
+ * ```
+ */
+export const useModel = (modelName, id) => {
+    const client = useSyncClientInstance();
+    const isReady = useSyncReady();
+    const error = useSyncError();
+    const readyPromiseRef = useRef(null);
+    const readyPromiseKeyRef = useRef({
+        client,
+        error,
+        id,
+        modelName,
+    });
+    const readyPromiseKey = readyPromiseKeyRef.current;
+    if (readyPromiseKey.client !== client ||
+        readyPromiseKey.error !== error ||
+        readyPromiseKey.id !== id ||
+        readyPromiseKey.modelName !== modelName ||
+        isReady) {
+        readyPromiseRef.current = null;
+        readyPromiseKeyRef.current = {
+            client,
+            error,
+            id,
+            modelName,
+        };
+    }
+    const subscribe = useCallback((onStoreChange) => {
+        if (!id) {
+            return () => {
+                /* noop */
+            };
+        }
+        return client.onEvent((event) => {
+            if (event.type === "modelChange" &&
+                event.modelName === modelName &&
+                event.modelId === id) {
+                onStoreChange();
+            }
+        });
+    }, [client, modelName, id]);
+    const getSnapshot = useCallback(() => {
+        if (!id) {
+            return null;
+        }
+        return client.getCached(modelName, id);
+    }, [client, modelName, id]);
+    const model = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    if (error) {
+        throw error;
+    }
+    if (!id) {
+        return null;
+    }
+    if (!isReady) {
+        if (!readyPromiseRef.current) {
+            // oxlint-disable-next-line avoid-new -- wrapping callback API in promise
+            readyPromiseRef.current = new Promise((resolve, reject) => {
+                const unsubscribe = client.onEvent((event) => {
+                    if (event.type === "syncError") {
+                        unsubscribe();
+                        readyPromiseRef.current = null;
+                        reject(event.error);
+                    }
+                    if (event.type === "stateChange" && event.state === "syncing") {
+                        unsubscribe();
+                        readyPromiseRef.current = null;
+                        resolve();
+                    }
+                });
+            });
+        }
+        throw readyPromiseRef.current;
+    }
+    if (model) {
+        return model;
+    }
+    if (client.isModelMissing(modelName, id)) {
+        return null;
+    }
+    // Suspense requires throwing a promise; discard the model result
+    const suspensePromise = client.ensureModel(modelName, id);
+    throw suspensePromise;
+};
+/**
+ * Non-suspense model hook with loading state
+ */
+export const useModelState = (modelName, id) => {
+    const client = useSyncClientInstance();
+    const isReady = useSyncReady();
+    const [data, setData] = useState(null);
+    const [isLoading, setIsLoading] = useState(Boolean(id));
+    const [error, setError] = useState(null);
+    const loadModel = useCallback(async () => {
+        if (!id) {
+            setData(null);
+            setIsLoading(false);
+            return;
+        }
+        if (!isReady) {
+            setIsLoading(true);
+            return;
+        }
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await client.ensureModel(modelName, id);
+            setData(result);
+        }
+        catch (loadError) {
+            setError(loadError instanceof Error ? loadError : new Error(String(loadError)));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client, modelName, id, isReady]);
+    useEffect(() => {
+        // oxlint-disable-next-line prefer-await-to-then -- fire-and-forget pattern
+        loadModel().catch(() => {
+            /* noop */
+        });
+    }, [loadModel]);
+    useEffect(() => {
+        if (!id) {
+            return;
+        }
+        const unsubscribe = client.onEvent((event) => {
+            if (event.type === "modelChange" &&
+                event.modelName === modelName &&
+                event.modelId === id) {
+                // oxlint-disable-next-line prefer-await-to-then -- fire-and-forget pattern
+                loadModel().catch(() => {
+                    /* noop */
+                });
+            }
+        });
+        return unsubscribe;
+    }, [client, modelName, id, loadModel]);
+    return {
+        data,
+        error,
+        isFound: data !== null,
+        isLoading,
+        refresh: loadModel,
+    };
+};
+//# sourceMappingURL=use-model.js.map

package/dist/hooks/use-model.js.map

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

package/dist/hooks/use-query.d.ts

@@ -0,0 +1,35 @@
+import type { UseQueryOptions, UseQueryResult } from "../types.js";
+/**
+ * Hook to query models with filtering, sorting, and pagination
+ *
+ * @param modelName - Name of the model to query
+ * @param options - Query options including filters, sorting, and pagination
+ * @returns UseQueryResult with data array, loading state, and metadata
+ *
+ * @example
+ * ```tsx
+ * function TaskList({ projectId }: { projectId: string }) {
+ *   const { data: tasks, isLoading, hasMore } = useQuery<Task>('Task', {
+ *     where: (task) => task.projectId === projectId,
+ *     orderBy: (a, b) => a.createdAt - b.createdAt,
+ *     limit: 20,
+ *   });
+ *
+ *   if (isLoading) return <Spinner />;
+ *
+ *   return (
+ *     <ul>
+ *       {tasks.map((task) => (
+ *         <li key={task.id}>{task.title}</li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */
+export declare const useQuery: <T>(modelName: string, options?: UseQueryOptions<T>) => UseQueryResult<T>;
+/**
+ * Hook to query all models of a type
+ */
+export declare const useQueryAll: <T>(modelName: string, options?: Omit<UseQueryOptions<T>, "limit" | "offset">) => UseQueryResult<T>;
+//# sourceMappingURL=use-query.d.ts.map

package/dist/hooks/use-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-query.d.ts","sourceRoot":"","sources":["../../src/hooks/use-query.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkHnE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,WAAW,MAAM,EACjB,UAAS,eAAe,CAAC,CAAC,CAAM,KAC/B,cAAc,CAAC,CAAC,CA8OlB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAC3B,WAAW,MAAM,EACjB,UAAS,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAM,KACzD,cAAc,CAAC,CAAC,CAAoC,CAAC"}