spacetimedb 1.6.0 → 1.6.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/browser/react/index.mjs +2 -22
- package/dist/browser/react/index.mjs.map +1 -1
- package/dist/index.browser.mjs.map +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.mjs.map +1 -1
- package/dist/min/index.browser.mjs.map +1 -1
- package/dist/min/react/index.mjs +1 -1
- package/dist/min/react/index.mjs.map +1 -1
- package/dist/min/sdk/index.browser.mjs +1 -1
- package/dist/min/sdk/index.browser.mjs.map +1 -1
- package/dist/react/index.cjs +2 -22
- package/dist/react/index.cjs.map +1 -1
- package/dist/react/index.mjs +2 -22
- package/dist/react/index.mjs.map +1 -1
- package/dist/sdk/db_connection_impl.d.ts +1 -3
- package/dist/sdk/db_connection_impl.d.ts.map +1 -1
- package/dist/sdk/index.browser.mjs +1 -1
- package/dist/sdk/index.browser.mjs.map +1 -1
- package/dist/sdk/index.cjs +0 -2
- package/dist/sdk/index.cjs.map +1 -1
- package/dist/sdk/index.mjs +1 -1
- package/dist/sdk/index.mjs.map +1 -1
- package/dist/server/index.cjs +9 -12
- package/dist/server/index.cjs.map +1 -1
- package/dist/server/index.mjs +9 -12
- package/dist/server/index.mjs.map +1 -1
- package/dist/server/runtime.d.ts.map +1 -1
- package/package.json +1 -1
- package/src/react/useTable.ts +2 -23
- package/src/sdk/db_connection_impl.ts +1 -8
- package/src/server/runtime.ts +2 -1
|
@@ -97,7 +97,6 @@ function useTable(tableName, whereClauseOrCallbacks, callbacks) {
|
|
|
97
97
|
callbacks = whereClauseOrCallbacks;
|
|
98
98
|
}
|
|
99
99
|
const [subscribeApplied, setSubscribeApplied] = useState(false);
|
|
100
|
-
const [isActive, setIsActive] = useState(false);
|
|
101
100
|
let spacetime;
|
|
102
101
|
try {
|
|
103
102
|
spacetime = useSpacetimeDB();
|
|
@@ -120,26 +119,7 @@ function useTable(tableName, whereClauseOrCallbacks, callbacks) {
|
|
|
120
119
|
};
|
|
121
120
|
}, [client, tableName, whereKey, subscribeApplied]);
|
|
122
121
|
useEffect(() => {
|
|
123
|
-
|
|
124
|
-
setIsActive(client.isActive);
|
|
125
|
-
};
|
|
126
|
-
const onDisconnect = () => {
|
|
127
|
-
setIsActive(client.isActive);
|
|
128
|
-
};
|
|
129
|
-
const onConnectError = () => {
|
|
130
|
-
setIsActive(client.isActive);
|
|
131
|
-
};
|
|
132
|
-
client["on"]("connect", onConnect);
|
|
133
|
-
client["on"]("disconnect", onDisconnect);
|
|
134
|
-
client["on"]("connectError", onConnectError);
|
|
135
|
-
return () => {
|
|
136
|
-
client["off"]("connect", onConnect);
|
|
137
|
-
client["off"]("disconnect", onDisconnect);
|
|
138
|
-
client["off"]("connectError", onConnectError);
|
|
139
|
-
};
|
|
140
|
-
}, [client]);
|
|
141
|
-
useEffect(() => {
|
|
142
|
-
if (isActive) {
|
|
122
|
+
if (client.isActive) {
|
|
143
123
|
const cancel = client.subscriptionBuilder().onApplied(() => {
|
|
144
124
|
setSubscribeApplied(true);
|
|
145
125
|
}).subscribe(query);
|
|
@@ -147,7 +127,7 @@ function useTable(tableName, whereClauseOrCallbacks, callbacks) {
|
|
|
147
127
|
cancel.unsubscribe();
|
|
148
128
|
};
|
|
149
129
|
}
|
|
150
|
-
}, [query, isActive, client]);
|
|
130
|
+
}, [query, client.isActive, client]);
|
|
151
131
|
const subscribe = useCallback(
|
|
152
132
|
(onStoreChange) => {
|
|
153
133
|
const onInsert = (ctx, row) => {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../../src/react/useSpacetimeDB.ts","../../../src/react/SpacetimeDBProvider.ts","../../../src/react/useTable.ts"],"names":["where"],"mappings":"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","file":"index.mjs","sourcesContent":["import { createContext, useContext, type Context } from 'react';\nimport type { DbConnectionImpl } from '../sdk/db_connection_impl';\n\nexport const SpacetimeDBContext: Context<DbConnectionImpl | undefined> =\n createContext<DbConnectionImpl | undefined>(undefined);\n\n// Throws an error if used outside of a SpacetimeDBProvider\n// Error is caught by other hooks like useTable so they can provide better error messages\nexport function useSpacetimeDB<\n DbConnection extends DbConnectionImpl,\n>(): DbConnection {\n const context = useContext(SpacetimeDBContext) as DbConnection | undefined;\n if (!context) {\n throw new Error(\n 'useSpacetimeDB must be used within a SpacetimeDBProvider component. Did you forget to add a `SpacetimeDBProvider` to your component tree?'\n );\n }\n return context;\n}\n","import {\n DbConnectionBuilder,\n type DbConnectionImpl,\n} from '../sdk/db_connection_impl';\nimport * as React from 'react';\nimport { SpacetimeDBContext } from './useSpacetimeDB';\n\nexport interface SpacetimeDBProviderProps<\n DbConnection extends DbConnectionImpl,\n ErrorContext,\n SubscriptionEventContext,\n> {\n connectionBuilder: DbConnectionBuilder<\n DbConnection,\n ErrorContext,\n SubscriptionEventContext\n >;\n children?: React.ReactNode;\n}\n\nexport function SpacetimeDBProvider<\n DbConnection extends DbConnectionImpl,\n ErrorContext,\n SubscriptionEventContext,\n>({\n connectionBuilder,\n children,\n}: SpacetimeDBProviderProps<\n DbConnection,\n ErrorContext,\n SubscriptionEventContext\n>): React.JSX.Element {\n return React.createElement(\n SpacetimeDBContext.Provider,\n { value: connectionBuilder.build() }, // May need to modify this to do it lazily in server-side rendering\n children\n );\n}\n","import {\n useCallback,\n useEffect,\n useRef,\n useState,\n useSyncExternalStore,\n} from 'react';\nimport { useSpacetimeDB } from './useSpacetimeDB';\nimport { DbConnectionImpl, TableCache } from '../sdk/db_connection_impl';\nimport type { TableNamesFromDb } from '../sdk/table_handle';\n\nexport interface UseQueryCallbacks<RowType> {\n onInsert?: (row: RowType) => void;\n onDelete?: (row: RowType) => void;\n onUpdate?: (oldRow: RowType, newRow: RowType) => void;\n}\n\nexport type Value = string | number | boolean;\n\nexport type Expr<Column extends string> =\n | { type: 'eq'; key: Column; value: Value }\n | { type: 'and'; children: Expr<Column>[] }\n | { type: 'or'; children: Expr<Column>[] };\n\nexport const eq = <Column extends string>(\n key: Column,\n value: Value\n): Expr<Column> => ({ type: 'eq', key, value });\n\nexport const and = <Column extends string>(\n ...children: Expr<Column>[]\n): Expr<Column> => {\n const flat: Expr<Column>[] = [];\n for (const c of children) {\n if (!c) continue;\n if (c.type === 'and') flat.push(...c.children);\n else flat.push(c);\n }\n const pruned = flat.filter(Boolean);\n if (pruned.length === 0) return { type: 'and', children: [] };\n if (pruned.length === 1) return pruned[0];\n return { type: 'and', children: pruned };\n};\n\nexport const or = <Column extends string>(\n ...children: Expr<Column>[]\n): Expr<Column> => {\n const flat: Expr<Column>[] = [];\n for (const c of children) {\n if (!c) continue;\n if (c.type === 'or') flat.push(...c.children);\n else flat.push(c);\n }\n const pruned = flat.filter(Boolean);\n if (pruned.length === 0) return { type: 'or', children: [] };\n if (pruned.length === 1) return pruned[0];\n return { type: 'or', children: pruned };\n};\n\nexport const isEq = <Column extends string>(\n e: Expr<Column>\n): e is Extract<Expr<Column>, { type: 'eq' }> => e.type === 'eq';\nexport const isAnd = <Column extends string>(\n e: Expr<Column>\n): e is Extract<Expr<Column>, { type: 'and' }> => e.type === 'and';\nexport const isOr = <Column extends string>(\n e: Expr<Column>\n): e is Extract<Expr<Column>, { type: 'or' }> => e.type === 'or';\n\ntype RecordLike<Column extends string> = Record<Column, unknown>;\n\nexport function evaluate<Column extends string>(\n expr: Expr<Column>,\n row: RecordLike<Column>\n): boolean {\n switch (expr.type) {\n case 'eq': {\n const v = row[expr.key];\n if (\n typeof v === 'string' ||\n typeof v === 'number' ||\n typeof v === 'boolean'\n ) {\n return v === expr.value;\n }\n return false;\n }\n case 'and':\n return (\n expr.children.length === 0 || expr.children.every(c => evaluate(c, row))\n );\n case 'or':\n return (\n expr.children.length !== 0 && expr.children.some(c => evaluate(c, row))\n );\n }\n}\n\nfunction formatValue(v: Value): string {\n switch (typeof v) {\n case 'string':\n return `'${v.replace(/'/g, \"''\")}'`;\n case 'number':\n return Number.isFinite(v) ? String(v) : `'${String(v)}'`;\n case 'boolean':\n return v ? 'TRUE' : 'FALSE';\n }\n}\n\nfunction escapeIdent(id: string): string {\n if (/^[A-Za-z_][A-Za-z0-9_]*$/.test(id)) return id;\n return `\"${id.replace(/\"/g, '\"\"')}\"`;\n}\n\nfunction parenthesize(s: string): string {\n if (!s.includes(' AND ') && !s.includes(' OR ')) return s;\n return `(${s})`;\n}\n\nexport function toString<Column extends string>(expr: Expr<Column>): string {\n switch (expr.type) {\n case 'eq':\n return `${escapeIdent(expr.key)} = ${formatValue(expr.value)}`;\n case 'and':\n return parenthesize(expr.children.map(toString).join(' AND '));\n case 'or':\n return parenthesize(expr.children.map(toString).join(' OR '));\n }\n}\n\n/**\n * This is just the identity function to make things look like SQL.\n * @param expr\n * @returns\n */\nexport function where<Column extends string>(expr: Expr<Column>): Expr<Column> {\n return expr;\n}\n\ntype Snapshot<RowType> = {\n readonly rows: readonly RowType[];\n readonly state: 'loading' | 'ready';\n};\n\ntype MembershipChange = 'enter' | 'leave' | 'stayIn' | 'stayOut';\n\nfunction classifyMembership<\n Col extends string,\n R extends Record<string, unknown>,\n>(where: Expr<Col> | undefined, oldRow: R, newRow: R): MembershipChange {\n // No filter: everything is in, so updates are always \"stayIn\".\n if (!where) {\n return 'stayIn';\n }\n\n const oldIn = evaluate(where, oldRow);\n const newIn = evaluate(where, newRow);\n\n if (oldIn && !newIn) {\n return 'leave';\n }\n if (!oldIn && newIn) {\n return 'enter';\n }\n if (oldIn && newIn) {\n return 'stayIn';\n }\n return 'stayOut';\n}\n\n/**\n * Extracts the column names from a RowType whose values are of type Value.\n * Note that this will exclude columns that are of type object, array, etc.\n */\ntype ColumnsFromRow<R> = {\n [K in keyof R]-?: R[K] extends Value | undefined ? K : never;\n}[keyof R] &\n string;\n\n/**\n * React hook to subscribe to a table in SpacetimeDB and receive live updates as rows are inserted, updated, or deleted.\n *\n * This hook returns a snapshot of the table's rows, filtered by an optional `where` clause, and provides a loading state\n * until the initial subscription is applied. It also allows you to specify callbacks for row insertions, deletions, and updates.\n *\n * The hook must be used within a component tree wrapped by `SpacetimeDBProvider`.\n *\n * Overloads:\n * - `useTable(tableName, where, callbacks?)`: Subscribe to a table with a filter and optional callbacks.\n * - `useTable(tableName, callbacks?)`: Subscribe to a table without a filter, with optional callbacks.\n *\n * @template DbConnection The type of the SpacetimeDB connection.\n * @template RowType The type of the table row.\n * @template TableName The name of the table.\n *\n * @param tableName - The name of the table to subscribe to.\n * @param whereClauseOrCallbacks - (Optional) Either a filter expression (where clause) or the callbacks object.\n * @param callbacks - (Optional) Callbacks for row insert, delete, and update events.\n *\n * @returns A snapshot object containing the current rows and the subscription state (`'loading'` or `'ready'`).\n *\n * @throws Error if the hook is used outside of a `SpacetimeDBProvider`.\n *\n * @example\n * ```tsx\n * const { rows, state } = useTable('users', where(eq('isActive', true)), {\n * onInsert: (row) => console.log('Inserted:', row),\n * onDelete: (row) => console.log('Deleted:', row),\n * onUpdate: (oldRow, newRow) => console.log('Updated:', oldRow, newRow),\n * });\n * ```\n */\nexport function useTable<\n DbConnection extends DbConnectionImpl,\n RowType extends Record<string, any>,\n TableName extends TableNamesFromDb<DbConnection['db']> = TableNamesFromDb<\n DbConnection['db']\n >,\n>(\n tableName: TableName,\n where: Expr<ColumnsFromRow<RowType>>,\n callbacks?: UseQueryCallbacks<RowType>\n): Snapshot<RowType>;\n\n/**\n * React hook to subscribe to a table in SpacetimeDB and receive live updates as rows are inserted, updated, or deleted.\n *\n * This hook returns a snapshot of the table's rows, filtered by an optional `where` clause, and provides a loading state\n * until the initial subscription is applied. It also allows you to specify callbacks for row insertions, deletions, and updates.\n *\n * The hook must be used within a component tree wrapped by `SpacetimeDBProvider`.\n *\n * Overloads:\n * - `useTable(tableName, where, callbacks?)`: Subscribe to a table with a filter and optional callbacks.\n * - `useTable(tableName, callbacks?)`: Subscribe to a table without a filter, with optional callbacks.\n *\n * @template DbConnection The type of the SpacetimeDB connection.\n * @template RowType The type of the table row.\n * @template TableName The name of the table.\n *\n * @param tableName - The name of the table to subscribe to.\n * @param whereClauseOrCallbacks - (Optional) Either a filter expression (where clause) or the callbacks object.\n * @param callbacks - (Optional) Callbacks for row insert, delete, and update events.\n *\n * @returns A snapshot object containing the current rows and the subscription state (`'loading'` or `'ready'`).\n *\n * @throws Error if the hook is used outside of a `SpacetimeDBProvider`.\n *\n * @example\n * ```tsx\n * const { rows, state } = useTable('users', where(eq('isActive', true)), {\n * onInsert: (row) => console.log('Inserted:', row),\n * onDelete: (row) => console.log('Deleted:', row),\n * onUpdate: (oldRow, newRow) => console.log('Updated:', oldRow, newRow),\n * });\n * ```\n */\nexport function useTable<\n DbConnection extends DbConnectionImpl,\n RowType extends Record<string, any>,\n TableName extends TableNamesFromDb<DbConnection['db']> = TableNamesFromDb<\n DbConnection['db']\n >,\n>(\n tableName: TableName,\n callbacks?: UseQueryCallbacks<RowType>\n): Snapshot<RowType>;\n\nexport function useTable<\n DbConnection extends DbConnectionImpl,\n RowType extends Record<string, any>,\n TableName extends TableNamesFromDb<DbConnection['db']> = TableNamesFromDb<\n DbConnection['db']\n >,\n>(\n tableName: TableName,\n whereClauseOrCallbacks?:\n | Expr<ColumnsFromRow<RowType>>\n | UseQueryCallbacks<RowType>,\n callbacks?: UseQueryCallbacks<RowType>\n): Snapshot<RowType> {\n let whereClause: Expr<ColumnsFromRow<RowType>> | undefined;\n if (\n whereClauseOrCallbacks &&\n typeof whereClauseOrCallbacks === 'object' &&\n 'type' in whereClauseOrCallbacks\n ) {\n whereClause = whereClauseOrCallbacks as Expr<ColumnsFromRow<RowType>>;\n } else {\n callbacks = whereClauseOrCallbacks as\n | UseQueryCallbacks<RowType>\n | undefined;\n }\n const [subscribeApplied, setSubscribeApplied] = useState(false);\n const [isActive, setIsActive] = useState(false);\n let spacetime: DbConnection | undefined;\n try {\n spacetime = useSpacetimeDB<DbConnection>();\n } catch {\n throw new Error(\n 'Could not find SpacetimeDB client! Did you forget to add a ' +\n '`SpacetimeDBProvider`? `useTable` must be used in the React component tree ' +\n 'under a `SpacetimeDBProvider` component.'\n );\n }\n const client = spacetime;\n\n const query =\n `SELECT * FROM ${tableName}` +\n (whereClause ? ` WHERE ${toString(whereClause)}` : '');\n\n const latestTransactionEvent = useRef<any>(null);\n const lastSnapshotRef = useRef<Snapshot<RowType> | null>(null);\n\n const whereKey = whereClause ? toString(whereClause) : '';\n\n const computeSnapshot = useCallback((): Snapshot<RowType> => {\n const table = client.db[\n tableName as keyof typeof client.db\n ] as unknown as TableCache<RowType>;\n const result: readonly RowType[] = whereClause\n ? table.iter().filter(row => evaluate(whereClause, row))\n : table.iter();\n return {\n rows: result,\n state: subscribeApplied ? 'ready' : 'loading',\n };\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [client, tableName, whereKey, subscribeApplied]);\n\n useEffect(() => {\n const onConnect = () => {\n setIsActive(client.isActive);\n };\n const onDisconnect = () => {\n setIsActive(client.isActive);\n };\n const onConnectError = () => {\n setIsActive(client.isActive);\n };\n client['on']('connect', onConnect);\n client['on']('disconnect', onDisconnect);\n client['on']('connectError', onConnectError);\n return () => {\n client['off']('connect', onConnect);\n client['off']('disconnect', onDisconnect);\n client['off']('connectError', onConnectError);\n };\n }, [client]);\n\n useEffect(() => {\n if (isActive) {\n const cancel = client\n .subscriptionBuilder()\n .onApplied(() => {\n setSubscribeApplied(true);\n })\n .subscribe(query);\n return () => {\n cancel.unsubscribe();\n };\n }\n }, [query, isActive, client]);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n const onInsert = (ctx: any, row: RowType) => {\n if (whereClause && !evaluate(whereClause, row)) {\n return;\n }\n callbacks?.onInsert?.(row);\n if (\n ctx.event !== latestTransactionEvent.current ||\n !latestTransactionEvent.current\n ) {\n latestTransactionEvent.current = ctx.event;\n lastSnapshotRef.current = computeSnapshot();\n onStoreChange();\n }\n };\n\n const onDelete = (ctx: any, row: RowType) => {\n if (whereClause && !evaluate(whereClause, row)) {\n return;\n }\n callbacks?.onDelete?.(row);\n if (\n ctx.event !== latestTransactionEvent.current ||\n !latestTransactionEvent.current\n ) {\n latestTransactionEvent.current = ctx.event;\n lastSnapshotRef.current = computeSnapshot();\n onStoreChange();\n }\n };\n\n const onUpdate = (ctx: any, oldRow: RowType, newRow: RowType) => {\n const change = classifyMembership(whereClause, oldRow, newRow);\n\n switch (change) {\n case 'leave':\n callbacks?.onDelete?.(oldRow);\n break;\n case 'enter':\n callbacks?.onInsert?.(newRow);\n break;\n case 'stayIn':\n callbacks?.onUpdate?.(oldRow, newRow);\n break;\n case 'stayOut':\n return; // no-op\n }\n\n if (\n ctx.event !== latestTransactionEvent.current ||\n !latestTransactionEvent.current\n ) {\n latestTransactionEvent.current = ctx.event;\n lastSnapshotRef.current = computeSnapshot();\n onStoreChange();\n }\n };\n\n const table = client.db[\n tableName as keyof typeof client.db\n ] as unknown as TableCache<RowType>;\n table.onInsert(onInsert);\n table.onDelete(onDelete);\n table.onUpdate?.(onUpdate);\n\n return () => {\n table.removeOnInsert(onInsert);\n table.removeOnDelete(onDelete);\n table.removeOnUpdate?.(onUpdate);\n };\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [\n client,\n tableName,\n whereKey,\n callbacks?.onDelete,\n callbacks?.onInsert,\n callbacks?.onUpdate,\n ]\n );\n\n const getSnapshot = useCallback((): Snapshot<RowType> => {\n if (!lastSnapshotRef.current) {\n lastSnapshotRef.current = computeSnapshot();\n }\n return lastSnapshotRef.current;\n }, [computeSnapshot]);\n\n // SSR fallback can be the same getter\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../../../src/react/useSpacetimeDB.ts","../../../src/react/SpacetimeDBProvider.ts","../../../src/react/useTable.ts"],"names":["where"],"mappings":"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","file":"index.mjs","sourcesContent":["import { createContext, useContext, type Context } from 'react';\nimport type { DbConnectionImpl } from '../sdk/db_connection_impl';\n\nexport const SpacetimeDBContext: Context<DbConnectionImpl | undefined> =\n createContext<DbConnectionImpl | undefined>(undefined);\n\n// Throws an error if used outside of a SpacetimeDBProvider\n// Error is caught by other hooks like useTable so they can provide better error messages\nexport function useSpacetimeDB<\n DbConnection extends DbConnectionImpl,\n>(): DbConnection {\n const context = useContext(SpacetimeDBContext) as DbConnection | undefined;\n if (!context) {\n throw new Error(\n 'useSpacetimeDB must be used within a SpacetimeDBProvider component. Did you forget to add a `SpacetimeDBProvider` to your component tree?'\n );\n }\n return context;\n}\n","import {\n DbConnectionBuilder,\n type DbConnectionImpl,\n} from '../sdk/db_connection_impl';\nimport * as React from 'react';\nimport { SpacetimeDBContext } from './useSpacetimeDB';\n\nexport interface SpacetimeDBProviderProps<\n DbConnection extends DbConnectionImpl,\n ErrorContext,\n SubscriptionEventContext,\n> {\n connectionBuilder: DbConnectionBuilder<\n DbConnection,\n ErrorContext,\n SubscriptionEventContext\n >;\n children?: React.ReactNode;\n}\n\nexport function SpacetimeDBProvider<\n DbConnection extends DbConnectionImpl,\n ErrorContext,\n SubscriptionEventContext,\n>({\n connectionBuilder,\n children,\n}: SpacetimeDBProviderProps<\n DbConnection,\n ErrorContext,\n SubscriptionEventContext\n>): React.JSX.Element {\n return React.createElement(\n SpacetimeDBContext.Provider,\n { value: connectionBuilder.build() }, // May need to modify this to do it lazily in server-side rendering\n children\n );\n}\n","import {\n useCallback,\n useEffect,\n useRef,\n useState,\n useSyncExternalStore,\n} from 'react';\nimport { useSpacetimeDB } from './useSpacetimeDB';\nimport { DbConnectionImpl, TableCache } from '../sdk/db_connection_impl';\nimport type { TableNamesFromDb } from '../sdk/table_handle';\n\nexport interface UseQueryCallbacks<RowType> {\n onInsert?: (row: RowType) => void;\n onDelete?: (row: RowType) => void;\n onUpdate?: (oldRow: RowType, newRow: RowType) => void;\n}\n\nexport type Value = string | number | boolean;\n\nexport type Expr<Column extends string> =\n | { type: 'eq'; key: Column; value: Value }\n | { type: 'and'; children: Expr<Column>[] }\n | { type: 'or'; children: Expr<Column>[] };\n\nexport const eq = <Column extends string>(\n key: Column,\n value: Value\n): Expr<Column> => ({ type: 'eq', key, value });\n\nexport const and = <Column extends string>(\n ...children: Expr<Column>[]\n): Expr<Column> => {\n const flat: Expr<Column>[] = [];\n for (const c of children) {\n if (!c) continue;\n if (c.type === 'and') flat.push(...c.children);\n else flat.push(c);\n }\n const pruned = flat.filter(Boolean);\n if (pruned.length === 0) return { type: 'and', children: [] };\n if (pruned.length === 1) return pruned[0];\n return { type: 'and', children: pruned };\n};\n\nexport const or = <Column extends string>(\n ...children: Expr<Column>[]\n): Expr<Column> => {\n const flat: Expr<Column>[] = [];\n for (const c of children) {\n if (!c) continue;\n if (c.type === 'or') flat.push(...c.children);\n else flat.push(c);\n }\n const pruned = flat.filter(Boolean);\n if (pruned.length === 0) return { type: 'or', children: [] };\n if (pruned.length === 1) return pruned[0];\n return { type: 'or', children: pruned };\n};\n\nexport const isEq = <Column extends string>(\n e: Expr<Column>\n): e is Extract<Expr<Column>, { type: 'eq' }> => e.type === 'eq';\nexport const isAnd = <Column extends string>(\n e: Expr<Column>\n): e is Extract<Expr<Column>, { type: 'and' }> => e.type === 'and';\nexport const isOr = <Column extends string>(\n e: Expr<Column>\n): e is Extract<Expr<Column>, { type: 'or' }> => e.type === 'or';\n\ntype RecordLike<Column extends string> = Record<Column, unknown>;\n\nexport function evaluate<Column extends string>(\n expr: Expr<Column>,\n row: RecordLike<Column>\n): boolean {\n switch (expr.type) {\n case 'eq': {\n const v = row[expr.key];\n if (\n typeof v === 'string' ||\n typeof v === 'number' ||\n typeof v === 'boolean'\n ) {\n return v === expr.value;\n }\n return false;\n }\n case 'and':\n return (\n expr.children.length === 0 || expr.children.every(c => evaluate(c, row))\n );\n case 'or':\n return (\n expr.children.length !== 0 && expr.children.some(c => evaluate(c, row))\n );\n }\n}\n\nfunction formatValue(v: Value): string {\n switch (typeof v) {\n case 'string':\n return `'${v.replace(/'/g, \"''\")}'`;\n case 'number':\n return Number.isFinite(v) ? String(v) : `'${String(v)}'`;\n case 'boolean':\n return v ? 'TRUE' : 'FALSE';\n }\n}\n\nfunction escapeIdent(id: string): string {\n if (/^[A-Za-z_][A-Za-z0-9_]*$/.test(id)) return id;\n return `\"${id.replace(/\"/g, '\"\"')}\"`;\n}\n\nfunction parenthesize(s: string): string {\n if (!s.includes(' AND ') && !s.includes(' OR ')) return s;\n return `(${s})`;\n}\n\nexport function toString<Column extends string>(expr: Expr<Column>): string {\n switch (expr.type) {\n case 'eq':\n return `${escapeIdent(expr.key)} = ${formatValue(expr.value)}`;\n case 'and':\n return parenthesize(expr.children.map(toString).join(' AND '));\n case 'or':\n return parenthesize(expr.children.map(toString).join(' OR '));\n }\n}\n\n/**\n * This is just the identity function to make things look like SQL.\n * @param expr\n * @returns\n */\nexport function where<Column extends string>(expr: Expr<Column>): Expr<Column> {\n return expr;\n}\n\ntype Snapshot<RowType> = {\n readonly rows: readonly RowType[];\n readonly state: 'loading' | 'ready';\n};\n\ntype MembershipChange = 'enter' | 'leave' | 'stayIn' | 'stayOut';\n\nfunction classifyMembership<\n Col extends string,\n R extends Record<string, unknown>,\n>(where: Expr<Col> | undefined, oldRow: R, newRow: R): MembershipChange {\n // No filter: everything is in, so updates are always \"stayIn\".\n if (!where) {\n return 'stayIn';\n }\n\n const oldIn = evaluate(where, oldRow);\n const newIn = evaluate(where, newRow);\n\n if (oldIn && !newIn) {\n return 'leave';\n }\n if (!oldIn && newIn) {\n return 'enter';\n }\n if (oldIn && newIn) {\n return 'stayIn';\n }\n return 'stayOut';\n}\n\n/**\n * Extracts the column names from a RowType whose values are of type Value.\n * Note that this will exclude columns that are of type object, array, etc.\n */\ntype ColumnsFromRow<R> = {\n [K in keyof R]-?: R[K] extends Value | undefined ? K : never;\n}[keyof R] &\n string;\n\n/**\n * React hook to subscribe to a table in SpacetimeDB and receive live updates as rows are inserted, updated, or deleted.\n *\n * This hook returns a snapshot of the table's rows, filtered by an optional `where` clause, and provides a loading state\n * until the initial subscription is applied. It also allows you to specify callbacks for row insertions, deletions, and updates.\n *\n * The hook must be used within a component tree wrapped by `SpacetimeDBProvider`.\n *\n * Overloads:\n * - `useTable(tableName, where, callbacks?)`: Subscribe to a table with a filter and optional callbacks.\n * - `useTable(tableName, callbacks?)`: Subscribe to a table without a filter, with optional callbacks.\n *\n * @template DbConnection The type of the SpacetimeDB connection.\n * @template RowType The type of the table row.\n * @template TableName The name of the table.\n *\n * @param tableName - The name of the table to subscribe to.\n * @param whereClauseOrCallbacks - (Optional) Either a filter expression (where clause) or the callbacks object.\n * @param callbacks - (Optional) Callbacks for row insert, delete, and update events.\n *\n * @returns A snapshot object containing the current rows and the subscription state (`'loading'` or `'ready'`).\n *\n * @throws Error if the hook is used outside of a `SpacetimeDBProvider`.\n *\n * @example\n * ```tsx\n * const { rows, state } = useTable('users', where(eq('isActive', true)), {\n * onInsert: (row) => console.log('Inserted:', row),\n * onDelete: (row) => console.log('Deleted:', row),\n * onUpdate: (oldRow, newRow) => console.log('Updated:', oldRow, newRow),\n * });\n * ```\n */\nexport function useTable<\n DbConnection extends DbConnectionImpl,\n RowType extends Record<string, any>,\n TableName extends TableNamesFromDb<DbConnection['db']> = TableNamesFromDb<\n DbConnection['db']\n >,\n>(\n tableName: TableName,\n where: Expr<ColumnsFromRow<RowType>>,\n callbacks?: UseQueryCallbacks<RowType>\n): Snapshot<RowType>;\n\n/**\n * React hook to subscribe to a table in SpacetimeDB and receive live updates as rows are inserted, updated, or deleted.\n *\n * This hook returns a snapshot of the table's rows, filtered by an optional `where` clause, and provides a loading state\n * until the initial subscription is applied. It also allows you to specify callbacks for row insertions, deletions, and updates.\n *\n * The hook must be used within a component tree wrapped by `SpacetimeDBProvider`.\n *\n * Overloads:\n * - `useTable(tableName, where, callbacks?)`: Subscribe to a table with a filter and optional callbacks.\n * - `useTable(tableName, callbacks?)`: Subscribe to a table without a filter, with optional callbacks.\n *\n * @template DbConnection The type of the SpacetimeDB connection.\n * @template RowType The type of the table row.\n * @template TableName The name of the table.\n *\n * @param tableName - The name of the table to subscribe to.\n * @param whereClauseOrCallbacks - (Optional) Either a filter expression (where clause) or the callbacks object.\n * @param callbacks - (Optional) Callbacks for row insert, delete, and update events.\n *\n * @returns A snapshot object containing the current rows and the subscription state (`'loading'` or `'ready'`).\n *\n * @throws Error if the hook is used outside of a `SpacetimeDBProvider`.\n *\n * @example\n * ```tsx\n * const { rows, state } = useTable('users', where(eq('isActive', true)), {\n * onInsert: (row) => console.log('Inserted:', row),\n * onDelete: (row) => console.log('Deleted:', row),\n * onUpdate: (oldRow, newRow) => console.log('Updated:', oldRow, newRow),\n * });\n * ```\n */\nexport function useTable<\n DbConnection extends DbConnectionImpl,\n RowType extends Record<string, any>,\n TableName extends TableNamesFromDb<DbConnection['db']> = TableNamesFromDb<\n DbConnection['db']\n >,\n>(\n tableName: TableName,\n callbacks?: UseQueryCallbacks<RowType>\n): Snapshot<RowType>;\n\nexport function useTable<\n DbConnection extends DbConnectionImpl,\n RowType extends Record<string, any>,\n TableName extends TableNamesFromDb<DbConnection['db']> = TableNamesFromDb<\n DbConnection['db']\n >,\n>(\n tableName: TableName,\n whereClauseOrCallbacks?:\n | Expr<ColumnsFromRow<RowType>>\n | UseQueryCallbacks<RowType>,\n callbacks?: UseQueryCallbacks<RowType>\n): Snapshot<RowType> {\n let whereClause: Expr<ColumnsFromRow<RowType>> | undefined;\n if (\n whereClauseOrCallbacks &&\n typeof whereClauseOrCallbacks === 'object' &&\n 'type' in whereClauseOrCallbacks\n ) {\n whereClause = whereClauseOrCallbacks as Expr<ColumnsFromRow<RowType>>;\n } else {\n callbacks = whereClauseOrCallbacks as\n | UseQueryCallbacks<RowType>\n | undefined;\n }\n const [subscribeApplied, setSubscribeApplied] = useState(false);\n let spacetime: DbConnection | undefined;\n try {\n spacetime = useSpacetimeDB<DbConnection>();\n } catch {\n throw new Error(\n 'Could not find SpacetimeDB client! Did you forget to add a ' +\n '`SpacetimeDBProvider`? `useTable` must be used in the React component tree ' +\n 'under a `SpacetimeDBProvider` component.'\n );\n }\n const client = spacetime;\n\n const query =\n `SELECT * FROM ${tableName}` +\n (whereClause ? ` WHERE ${toString(whereClause)}` : '');\n\n const latestTransactionEvent = useRef<any>(null);\n const lastSnapshotRef = useRef<Snapshot<RowType> | null>(null);\n\n const whereKey = whereClause ? toString(whereClause) : '';\n\n const computeSnapshot = useCallback((): Snapshot<RowType> => {\n const table = client.db[\n tableName as keyof typeof client.db\n ] as unknown as TableCache<RowType>;\n const result: readonly RowType[] = whereClause\n ? table.iter().filter(row => evaluate(whereClause, row))\n : table.iter();\n return {\n rows: result,\n state: subscribeApplied ? 'ready' : 'loading',\n };\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [client, tableName, whereKey, subscribeApplied]);\n\n useEffect(() => {\n if (client.isActive) {\n const cancel = client\n .subscriptionBuilder()\n .onApplied(() => {\n setSubscribeApplied(true);\n })\n .subscribe(query);\n return () => {\n cancel.unsubscribe();\n };\n }\n }, [query, client.isActive, client]);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n const onInsert = (ctx: any, row: RowType) => {\n if (whereClause && !evaluate(whereClause, row)) {\n return;\n }\n callbacks?.onInsert?.(row);\n if (\n ctx.event !== latestTransactionEvent.current ||\n !latestTransactionEvent.current\n ) {\n latestTransactionEvent.current = ctx.event;\n lastSnapshotRef.current = computeSnapshot();\n onStoreChange();\n }\n };\n\n const onDelete = (ctx: any, row: RowType) => {\n if (whereClause && !evaluate(whereClause, row)) {\n return;\n }\n callbacks?.onDelete?.(row);\n if (\n ctx.event !== latestTransactionEvent.current ||\n !latestTransactionEvent.current\n ) {\n latestTransactionEvent.current = ctx.event;\n lastSnapshotRef.current = computeSnapshot();\n onStoreChange();\n }\n };\n\n const onUpdate = (ctx: any, oldRow: RowType, newRow: RowType) => {\n const change = classifyMembership(whereClause, oldRow, newRow);\n\n switch (change) {\n case 'leave':\n callbacks?.onDelete?.(oldRow);\n break;\n case 'enter':\n callbacks?.onInsert?.(newRow);\n break;\n case 'stayIn':\n callbacks?.onUpdate?.(oldRow, newRow);\n break;\n case 'stayOut':\n return; // no-op\n }\n\n if (\n ctx.event !== latestTransactionEvent.current ||\n !latestTransactionEvent.current\n ) {\n latestTransactionEvent.current = ctx.event;\n lastSnapshotRef.current = computeSnapshot();\n onStoreChange();\n }\n };\n\n const table = client.db[\n tableName as keyof typeof client.db\n ] as unknown as TableCache<RowType>;\n table.onInsert(onInsert);\n table.onDelete(onDelete);\n table.onUpdate?.(onUpdate);\n\n return () => {\n table.removeOnInsert(onInsert);\n table.removeOnDelete(onDelete);\n table.removeOnUpdate?.(onUpdate);\n };\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [\n client,\n tableName,\n whereKey,\n callbacks?.onDelete,\n callbacks?.onInsert,\n callbacks?.onUpdate,\n ]\n );\n\n const getSnapshot = useCallback((): Snapshot<RowType> => {\n if (!lastSnapshotRef.current) {\n lastSnapshotRef.current = computeSnapshot();\n }\n return lastSnapshotRef.current;\n }, [computeSnapshot]);\n\n // SSR fallback can be the same getter\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n"]}
|