@livestore/common 0.4.0-dev.7 → 0.4.0-dev.9

package/src/testing/event-factory.ts

@@ -0,0 +1,133 @@
+/**
+ * Helpers for synthesizing LiveStore events in tests while keeping track of
+ * sequence numbers, parent pointers, and authoring client identity. Inspired
+ * by the effect-based schema utilities, the factory exposes a namespaced API
+ * where each event definition maps to a helper with `next`, `advanceTo`, and
+ * `setParent` functions that share a single sequence stream.
+ *
+ * @example
+ * ```ts
+ * import { EventFactory } from '@livestore/common/testing'
+ * import { events } from './schema'
+ *
+ * const eventFactory = EventFactory.makeFactory(events)({
+ *   client: EventFactory.clientIdentity('test-client'),
+ *   startSeq: 1,
+ *   initialParent: 'root',
+ * })
+ *
+ * const bootstrap = eventFactory.todoCreated.next({
+ *   id: 'todo-1',
+ *   text: 'write tests',
+ *   completed: false,
+ * })
+ *
+ * eventFactory.todoCreated.advanceTo(42)
+ * const branched = eventFactory.todoUpdated.next({
+ *   id: 'todo-1',
+ *   text: 'ship feature',
+ *   completed: true,
+ * })
+ * ```
+ */
+
+import { Schema } from '@livestore/utils/effect'
+
+import type { EventDef } from '../schema/EventDef.ts'
+import * as EventSequenceNumber from '../schema/EventSequenceNumber.ts'
+import * as LiveStoreEvent from '../schema/LiveStoreEvent.ts'
+
+export interface ClientIdentity {
+  clientId: string
+  sessionId: string
+}
+
+export const clientIdentity = (label: string, session = `${label}-session`): ClientIdentity => ({
+  clientId: label,
+  sessionId: session,
+})
+
+export type SequenceValue = 'root' | number
+
+type EventFactoriesArgs<TDefs extends Record<string, EventDef.Any>> = {
+  [K in keyof TDefs]: Parameters<TDefs[K]>[0]
+}
+
+type EventFactories<TDefs extends Record<string, EventDef.Any>, TResult> = {
+  [K in keyof TDefs]: {
+    next: (args: EventFactoriesArgs<TDefs>[K]) => TResult
+    advanceTo: (seq: number, parent?: SequenceValue) => void
+    setParent: (parent: SequenceValue) => void
+    current: () => { seq: number; parent: SequenceValue }
+  }
+}
+
+export interface EventFactoriesConfig {
+  client: ClientIdentity
+  /**
+   * @default 1
+   */
+  startSeq?: number
+  /**
+   * @default 0 (root)
+   */
+  initialParent?: SequenceValue
+}
+
+export const makeFactory =
+  <TDefs extends Record<string, EventDef.Any>>(eventDefs: TDefs) =>
+  ({
+    client,
+    startSeq = 1,
+    initialParent = 'root',
+  }: EventFactoriesConfig): EventFactories<TDefs, LiveStoreEvent.AnyEncodedGlobal> => {
+    let nextSeq = startSeq
+    let parentRef: SequenceValue = initialParent
+
+    const advanceTo = (seq: number, parent: SequenceValue = 'root') => {
+      nextSeq = seq
+      parentRef = parent
+    }
+
+    const setParent = (parent: SequenceValue) => {
+      parentRef = parent
+    }
+
+    const current = () => ({ seq: nextSeq, parent: parentRef })
+
+    const factories: Partial<EventFactories<TDefs, LiveStoreEvent.AnyEncodedGlobal>> = {}
+
+    for (const [name, eventDef] of Object.entries(eventDefs) as [keyof TDefs, TDefs[keyof TDefs]][]) {
+      const next = (args: EventFactoriesArgs<TDefs>[typeof name]) => {
+        const decoded = eventDef(args)
+        const encodedArgs = Schema.encodeSync(eventDef.schema)(decoded.args)
+        const encoded = eventDef.encoded(encodedArgs)
+
+        const event = LiveStoreEvent.AnyEncodedGlobal.make({
+          name: encoded.name,
+          args: encoded.args,
+          seqNum: EventSequenceNumber.globalEventSequenceNumber(nextSeq),
+          parentSeqNum:
+            parentRef === 'root'
+              ? EventSequenceNumber.ROOT.global
+              : EventSequenceNumber.globalEventSequenceNumber(parentRef),
+          clientId: client.clientId,
+          sessionId: client.sessionId,
+        })
+
+        parentRef = nextSeq
+        nextSeq = nextSeq + 1
+
+        return event
+      }
+
+      factories[name] = {
+        next,
+        advanceTo,
+        setParent,
+        current,
+      } as EventFactories<TDefs, LiveStoreEvent.AnyEncodedGlobal>[typeof name]
+    }
+
+    return factories as EventFactories<TDefs, LiveStoreEvent.AnyEncodedGlobal>
+  }

package/src/testing/mod.ts

@@ -0,0 +1 @@
+export * as EventFactory from './event-factory.ts'

package/src/version.ts

@@ -2,7 +2,7 @@
 // import packageJson from '../package.json' with { type: 'json' }
 // export const liveStoreVersion = packageJson.version
 
-export const liveStoreVersion = '0.4.0-dev.7' as const
+export const liveStoreVersion = '0.4.0-dev.9' as const
 
 /**
  * This version number is incremented whenever the internal storage format changes in a breaking way.

package/dist/schema-management/migrations.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=migrations.test.d.ts.map

package/dist/schema-management/migrations.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"migrations.test.d.ts","sourceRoot":"","sources":["../../src/schema-management/migrations.test.ts"],"names":[],"mappings":""}

package/dist/schema-management/migrations.test.js

@@ -1,52 +0,0 @@
-import { Option, Schema } from '@livestore/utils/effect';
-import { describe, expect, it } from 'vitest';
-import { makeColumnSpec } from './migrations.js';
-const createColumn = (name, type, options = {}) => ({
-    _tag: 'column',
-    name,
-    type: { _tag: type },
-    nullable: options.nullable ?? true,
-    primaryKey: options.primaryKey ?? false,
-    default: Option.none(),
-    schema: type === 'text' ? Schema.String : Schema.Number,
-});
-describe('makeColumnSpec', () => {
-    it('should quote column names properly for reserved keywords', () => {
-        const table = {
-            _tag: 'table',
-            name: 'blocks',
-            columns: [createColumn('order', 'integer', { nullable: false }), createColumn('group', 'text')],
-            indexes: [],
-        };
-        const result = makeColumnSpec(table);
-        expect(result).toMatchInlineSnapshot(`"'order' integer not null , 'group' text  "`);
-        expect(result).toContain("'order'");
-        expect(result).toContain("'group'");
-    });
-    it('should handle basic columns with primary keys', () => {
-        const table = {
-            _tag: 'table',
-            name: 'users',
-            columns: [createColumn('id', 'text', { nullable: false, primaryKey: true }), createColumn('name', 'text')],
-            indexes: [],
-        };
-        const result = makeColumnSpec(table);
-        expect(result).toMatchInlineSnapshot(`"'id' text not null , 'name' text  , PRIMARY KEY ('id')"`);
-        expect(result).toContain("PRIMARY KEY ('id')");
-    });
-    it('should handle multi-column primary keys', () => {
-        const table = {
-            _tag: 'table',
-            name: 'composite',
-            columns: [
-                createColumn('tenant_id', 'text', { nullable: false, primaryKey: true }),
-                createColumn('user_id', 'text', { nullable: false, primaryKey: true }),
-            ],
-            indexes: [],
-        };
-        const result = makeColumnSpec(table);
-        expect(result).toMatchInlineSnapshot(`"'tenant_id' text not null , 'user_id' text not null , PRIMARY KEY ('tenant_id', 'user_id')"`);
-        expect(result).toContain("PRIMARY KEY ('tenant_id', 'user_id')");
-    });
-});
-//# sourceMappingURL=migrations.test.js.map

package/dist/schema-management/migrations.test.js.map

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