@emmett-community/emmett-google-firestore 0.1.0 → 0.2.0

package/dist/testing/index.js

@@ -1,296 +0,0 @@
-'use strict';
-
-var firestore = require('@google-cloud/firestore');
-var emmett = require('@event-driven-io/emmett');
-
-// src/testing/eventStoreSpec.ts
-var ExpectedVersionConflictError = class _ExpectedVersionConflictError extends Error {
-  constructor(streamName, expected, actual) {
-    super(
-      `Expected version conflict for stream '${streamName}': expected ${String(expected)}, actual ${String(actual)}`
-    );
-    this.streamName = streamName;
-    this.expected = expected;
-    this.actual = actual;
-    this.name = "ExpectedVersionConflictError";
-    Object.setPrototypeOf(this, _ExpectedVersionConflictError.prototype);
-  }
-};
-
-// src/eventStore/utils.ts
-function padVersion(version) {
-  return version.toString().padStart(10, "0");
-}
-function timestampToDate(timestamp) {
-  return timestamp.toDate();
-}
-function assertExpectedVersionMatchesCurrent(streamName, expectedVersion, currentVersion) {
-  if (expectedVersion === emmett.NO_CONCURRENCY_CHECK) {
-    return;
-  }
-  if (expectedVersion === emmett.STREAM_DOES_NOT_EXIST) {
-    if (currentVersion !== emmett.STREAM_DOES_NOT_EXIST) {
-      throw new ExpectedVersionConflictError(
-        streamName,
-        expectedVersion,
-        currentVersion
-      );
-    }
-    return;
-  }
-  if (expectedVersion === emmett.STREAM_EXISTS) {
-    if (currentVersion === emmett.STREAM_DOES_NOT_EXIST) {
-      throw new ExpectedVersionConflictError(
-        streamName,
-        expectedVersion,
-        currentVersion
-      );
-    }
-    return;
-  }
-  const expectedBigInt = BigInt(expectedVersion);
-  if (currentVersion === emmett.STREAM_DOES_NOT_EXIST || currentVersion !== expectedBigInt) {
-    throw new ExpectedVersionConflictError(
-      streamName,
-      expectedVersion,
-      currentVersion
-    );
-  }
-}
-function getCurrentStreamVersion(streamExists, version) {
-  if (!streamExists) {
-    return emmett.STREAM_DOES_NOT_EXIST;
-  }
-  return BigInt(version ?? -1);
-}
-
-// src/eventStore/firestoreEventStore.ts
-var DEFAULT_COLLECTIONS = {
-  streams: "streams",
-  counters: "_counters"
-};
-var FirestoreEventStoreImpl = class {
-  constructor(firestore, options = {}) {
-    this.firestore = firestore;
-    this.collections = {
-      ...DEFAULT_COLLECTIONS,
-      ...options.collections
-    };
-  }
-  collections;
-  /**
-   * Read events from a stream
-   */
-  async readStream(streamName, options = {}) {
-    const { from, to, maxCount } = options;
-    let query = this.firestore.collection(this.collections.streams).doc(streamName).collection("events").orderBy("streamVersion", "asc");
-    if (from !== void 0) {
-      query = query.where("streamVersion", ">=", Number(from));
-    }
-    if (to !== void 0) {
-      query = query.where("streamVersion", "<=", Number(to));
-    }
-    if (maxCount !== void 0 && maxCount > 0) {
-      query = query.limit(maxCount);
-    }
-    const snapshot = await query.get();
-    return snapshot.docs.map((doc) => {
-      const data = doc.data();
-      return {
-        type: data.type,
-        data: data.data,
-        metadata: {
-          ...data.metadata,
-          streamName,
-          streamVersion: BigInt(data.streamVersion),
-          streamPosition: BigInt(data.streamVersion),
-          globalPosition: BigInt(data.globalPosition),
-          timestamp: timestampToDate(data.timestamp)
-        }
-      };
-    });
-  }
-  /**
-   * Aggregate stream by applying events to state
-   */
-  async aggregateStream(streamName, options) {
-    const { evolve, initialState, read } = options;
-    const events = await this.readStream(streamName, read);
-    const streamExists = events.length > 0;
-    const state = events.reduce(evolve, initialState());
-    const currentStreamVersion = streamExists ? events[events.length - 1].metadata.streamVersion : BigInt(0);
-    return {
-      state,
-      currentStreamVersion,
-      streamExists
-    };
-  }
-  /**
-   * Append events to a stream with optimistic concurrency control
-   */
-  async appendToStream(streamName, events, options = {}) {
-    if (events.length === 0) {
-      throw new Error("Cannot append empty event array");
-    }
-    const { expectedStreamVersion = emmett.NO_CONCURRENCY_CHECK } = options;
-    return await this.firestore.runTransaction(async (transaction) => {
-      return await this.appendToStreamInTransaction(
-        transaction,
-        streamName,
-        events,
-        expectedStreamVersion
-      );
-    });
-  }
-  /**
-   * Internal method to append events within a transaction
-   */
-  async appendToStreamInTransaction(transaction, streamName, events, expectedStreamVersion) {
-    const streamRef = this.firestore.collection(this.collections.streams).doc(streamName);
-    const streamDoc = await transaction.get(streamRef);
-    const streamExists = streamDoc.exists;
-    const streamData = streamDoc.data();
-    const currentVersion = getCurrentStreamVersion(
-      streamExists,
-      streamData?.version
-    );
-    assertExpectedVersionMatchesCurrent(
-      streamName,
-      expectedStreamVersion,
-      currentVersion
-    );
-    const counterRef = this.firestore.collection(this.collections.counters).doc("global_position");
-    const counterDoc = await transaction.get(counterRef);
-    let globalPosition = counterDoc.exists ? counterDoc.data()?.value ?? 0 : 0;
-    const baseVersion = currentVersion === emmett.STREAM_DOES_NOT_EXIST ? -1 : Number(currentVersion);
-    const TimestampClass = this.firestore.constructor;
-    const now = TimestampClass.Timestamp.now();
-    events.forEach((event, index) => {
-      const eventVersion = baseVersion + 1 + index;
-      const eventRef = streamRef.collection("events").doc(padVersion(eventVersion));
-      const metadata = event.metadata;
-      const eventDocument = {
-        type: event.type,
-        data: event.data,
-        ...metadata && { metadata },
-        timestamp: now,
-        globalPosition: globalPosition++,
-        streamVersion: eventVersion
-      };
-      transaction.set(eventRef, eventDocument);
-    });
-    const newVersion = baseVersion + events.length;
-    const updatedMetadata = {
-      version: newVersion,
-      createdAt: streamData?.createdAt ?? now,
-      updatedAt: now
-    };
-    transaction.set(streamRef, updatedMetadata);
-    transaction.set(counterRef, {
-      value: globalPosition,
-      updatedAt: now
-    });
-    return {
-      nextExpectedStreamVersion: BigInt(newVersion),
-      createdNewStream: !streamExists
-    };
-  }
-};
-function getFirestoreEventStore(firestore, options) {
-  return new FirestoreEventStoreImpl(firestore, options);
-}
-
-// src/testing/eventStoreSpec.ts
-function getTestFirestore(config) {
-  const projectId = config?.projectId || process.env.FIRESTORE_PROJECT_ID || "test-project";
-  const host = config?.host || process.env.FIRESTORE_EMULATOR_HOST || "localhost:8080";
-  const ssl = config?.ssl ?? false;
-  return new firestore.Firestore({
-    projectId,
-    host,
-    ssl,
-    customHeaders: {
-      Authorization: "Bearer owner"
-    }
-  });
-}
-function getTestEventStore(config) {
-  const firestore = getTestFirestore(config);
-  return getFirestoreEventStore(firestore);
-}
-async function clearFirestore(firestore, batchSize = 100) {
-  const collections = await firestore.listCollections();
-  for (const collection of collections) {
-    await deleteCollection(firestore, collection.id, batchSize);
-  }
-}
-async function deleteCollection(firestore, collectionPath, batchSize = 100) {
-  const collectionRef = firestore.collection(collectionPath);
-  const query = collectionRef.limit(batchSize);
-  return new Promise((resolve, reject) => {
-    void deleteQueryBatch(firestore, query, resolve, reject);
-  });
-}
-async function deleteQueryBatch(firestore, query, resolve, reject) {
-  try {
-    const snapshot = await query.get();
-    if (snapshot.size === 0) {
-      resolve();
-      return;
-    }
-    const batch = firestore.batch();
-    snapshot.docs.forEach((doc) => {
-      batch.delete(doc.ref);
-    });
-    await batch.commit();
-    process.nextTick(() => {
-      void deleteQueryBatch(firestore, query, resolve, reject);
-    });
-  } catch (error) {
-    reject(error);
-  }
-}
-async function waitForEmulator(host = "localhost:8080", timeout = 3e4, interval = 100) {
-  const startTime = Date.now();
-  const firestore$1 = new firestore.Firestore({
-    projectId: "test",
-    host,
-    ssl: false
-  });
-  while (Date.now() - startTime < timeout) {
-    try {
-      await firestore$1.listCollections();
-      await firestore$1.terminate();
-      return;
-    } catch {
-      await new Promise((resolve) => setTimeout(resolve, interval));
-    }
-  }
-  await firestore$1.terminate();
-  throw new Error(`Firestore emulator not ready after ${timeout}ms`);
-}
-function setupFirestoreTests(config) {
-  const firestore = getTestFirestore(config);
-  const eventStore = getFirestoreEventStore(firestore);
-  const cleanup = async () => {
-    await firestore.terminate();
-  };
-  const clearData = async () => {
-    await clearFirestore(firestore);
-  };
-  return {
-    firestore,
-    eventStore,
-    cleanup,
-    clearData
-  };
-}
-
-exports.clearFirestore = clearFirestore;
-exports.deleteCollection = deleteCollection;
-exports.getTestEventStore = getTestEventStore;
-exports.getTestFirestore = getTestFirestore;
-exports.setupFirestoreTests = setupFirestoreTests;
-exports.waitForEmulator = waitForEmulator;
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/eventStore/types.ts","../../src/eventStore/utils.ts","../../src/eventStore/firestoreEventStore.ts","../../src/testing/eventStoreSpec.ts"],"names":["NO_CONCURRENCY_CHECK","STREAM_DOES_NOT_EXIST","STREAM_EXISTS","Firestore","firestore"],"mappings":"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","file":"index.js","sourcesContent":["import type { Firestore, Timestamp } from '@google-cloud/firestore';\nimport type { Event, ReadEvent, ReadEventMetadataWithGlobalPosition } from '@event-driven-io/emmett';\nimport {\n  STREAM_DOES_NOT_EXIST,\n  STREAM_EXISTS,\n  NO_CONCURRENCY_CHECK,\n  type ExpectedStreamVersion as EmmettExpectedStreamVersion,\n} from '@event-driven-io/emmett';\n\n/**\n * Expected version for stream operations\n * Uses Emmett's standard version constants for full compatibility\n * - number | bigint: Expect specific version\n * - STREAM_DOES_NOT_EXIST: Stream must not exist\n * - STREAM_EXISTS: Stream must exist (any version)\n * - NO_CONCURRENCY_CHECK: No version check\n */\nexport type ExpectedStreamVersion = EmmettExpectedStreamVersion<bigint>;\n\n// Re-export Emmett constants for convenience\nexport { STREAM_DOES_NOT_EXIST, STREAM_EXISTS, NO_CONCURRENCY_CHECK };\n\n/**\n * Options for appending events to a stream\n */\nexport interface AppendToStreamOptions {\n  expectedStreamVersion?: ExpectedStreamVersion;\n}\n\n/**\n * Result of appending events to a stream\n */\nexport interface AppendToStreamResult {\n  nextExpectedStreamVersion: bigint;\n  createdNewStream: boolean;\n}\n\n/**\n * Options for reading events from a stream\n */\nexport interface ReadStreamOptions {\n  from?: bigint;\n  to?: bigint;\n  maxCount?: number;\n}\n\n/**\n * Metadata stored in Firestore stream document\n */\nexport interface StreamMetadata {\n  version: number;\n  createdAt: Timestamp;\n  updatedAt: Timestamp;\n}\n\n/**\n * Event document structure in Firestore\n */\nexport interface EventDocument {\n  type: string;\n  data: Record<string, unknown>;\n  metadata?: Record<string, unknown>;\n  timestamp: Timestamp;\n  globalPosition: number;\n  streamVersion: number;\n}\n\n/**\n * Firestore-specific read event metadata\n */\nexport interface FirestoreReadEventMetadata extends ReadEventMetadataWithGlobalPosition {\n  streamName: string;\n  streamVersion: bigint;\n  timestamp: Date;\n}\n\n/**\n * Firestore read event\n */\nexport type FirestoreReadEvent<EventType extends Event = Event> = ReadEvent<\n  EventType,\n  FirestoreReadEventMetadata\n>;\n\n/**\n * Collection configuration for Firestore event store\n */\nexport interface CollectionConfig {\n  streams: string;\n  counters: string;\n}\n\n/**\n * Firestore event store options\n */\nexport interface FirestoreEventStoreOptions {\n  collections?: Partial<CollectionConfig>;\n}\n\n/**\n * Firestore event store interface\n */\nexport interface FirestoreEventStore {\n  /**\n   * The underlying Firestore instance\n   */\n  readonly firestore: Firestore;\n\n  /**\n   * Collection names configuration\n   */\n  readonly collections: CollectionConfig;\n\n  /**\n   * Read events from a stream\n   */\n  readStream<EventType extends Event>(\n    streamName: string,\n    options?: ReadStreamOptions,\n  ): Promise<FirestoreReadEvent<EventType>[]>;\n\n  /**\n   * Aggregate stream by applying events to state\n   */\n  aggregateStream<State, EventType extends Event>(\n    streamName: string,\n    options: {\n      evolve: (state: State, event: FirestoreReadEvent<EventType>) => State;\n      initialState: () => State;\n      read?: ReadStreamOptions;\n    },\n  ): Promise<{\n    state: State;\n    currentStreamVersion: bigint;\n    streamExists: boolean;\n  }>;\n\n  /**\n   * Append events to a stream\n   */\n  appendToStream<EventType extends Event>(\n    streamName: string,\n    events: EventType[],\n    options?: AppendToStreamOptions,\n  ): Promise<AppendToStreamResult>;\n}\n\n/**\n * Error thrown when expected version doesn't match current version\n */\nexport class ExpectedVersionConflictError extends Error {\n  constructor(\n    public readonly streamName: string,\n    public readonly expected: ExpectedStreamVersion,\n    public readonly actual: bigint | typeof STREAM_DOES_NOT_EXIST,\n  ) {\n    super(\n      `Expected version conflict for stream '${streamName}': expected ${String(expected)}, actual ${String(actual)}`,\n    );\n    this.name = 'ExpectedVersionConflictError';\n    Object.setPrototypeOf(this, ExpectedVersionConflictError.prototype);\n  }\n}\n","import type { Timestamp } from '@google-cloud/firestore';\nimport type { ExpectedStreamVersion } from './types';\nimport {\n  STREAM_DOES_NOT_EXIST,\n  STREAM_EXISTS,\n  NO_CONCURRENCY_CHECK,\n  ExpectedVersionConflictError,\n} from './types';\n\n/**\n * Pad version number with leading zeros for Firestore document IDs\n * This ensures automatic ordering by version in Firestore\n *\n * @param version - The version number to pad\n * @returns Zero-padded string of length 10\n *\n * @example\n * padVersion(0) // \"0000000000\"\n * padVersion(42) // \"0000000042\"\n * padVersion(12345) // \"0000012345\"\n */\nexport function padVersion(version: number | bigint): string {\n  return version.toString().padStart(10, '0');\n}\n\n/**\n * Parse a stream name into type and ID components\n *\n * @param streamName - Stream name in format \"Type-id\" or \"Type-with-dashes-id\"\n * @returns Object with streamType and streamId\n *\n * @example\n * parseStreamName(\"User-123\") // { streamType: \"User\", streamId: \"123\" }\n * parseStreamName(\"ShoppingCart-abc-def-123\") // { streamType: \"ShoppingCart\", streamId: \"abc-def-123\" }\n */\nexport function parseStreamName(streamName: string): {\n  streamType: string;\n  streamId: string;\n} {\n  const firstDashIndex = streamName.indexOf('-');\n\n  if (firstDashIndex === -1) {\n    return {\n      streamType: streamName,\n      streamId: '',\n    };\n  }\n\n  return {\n    streamType: streamName.substring(0, firstDashIndex),\n    streamId: streamName.substring(firstDashIndex + 1),\n  };\n}\n\n/**\n * Convert Firestore Timestamp to JavaScript Date\n *\n * @param timestamp - Firestore Timestamp\n * @returns JavaScript Date object\n */\nexport function timestampToDate(timestamp: Timestamp): Date {\n  return timestamp.toDate();\n}\n\n/**\n * Validate expected version against current version\n *\n * @param streamName - Stream name for error messages\n * @param expectedVersion - Expected version constraint\n * @param currentVersion - Current stream version (or STREAM_DOES_NOT_EXIST if stream doesn't exist)\n * @throws ExpectedVersionConflictError if versions don't match\n */\nexport function assertExpectedVersionMatchesCurrent(\n  streamName: string,\n  expectedVersion: ExpectedStreamVersion,\n  currentVersion: bigint | typeof STREAM_DOES_NOT_EXIST,\n): void {\n  // NO_CONCURRENCY_CHECK - no validation needed\n  if (expectedVersion === NO_CONCURRENCY_CHECK) {\n    return;\n  }\n\n  // STREAM_DOES_NOT_EXIST - stream must not exist\n  if (expectedVersion === STREAM_DOES_NOT_EXIST) {\n    if (currentVersion !== STREAM_DOES_NOT_EXIST) {\n      throw new ExpectedVersionConflictError(\n        streamName,\n        expectedVersion,\n        currentVersion,\n      );\n    }\n    return;\n  }\n\n  // STREAM_EXISTS - stream must exist\n  if (expectedVersion === STREAM_EXISTS) {\n    if (currentVersion === STREAM_DOES_NOT_EXIST) {\n      throw new ExpectedVersionConflictError(\n        streamName,\n        expectedVersion,\n        currentVersion,\n      );\n    }\n    return;\n  }\n\n  // Specific version number\n  const expectedBigInt = BigInt(expectedVersion);\n  if (currentVersion === STREAM_DOES_NOT_EXIST || currentVersion !== expectedBigInt) {\n    throw new ExpectedVersionConflictError(\n      streamName,\n      expectedVersion,\n      currentVersion,\n    );\n  }\n}\n\n/**\n * Get the current stream version from metadata\n *\n * @param streamExists - Whether the stream document exists\n * @param version - Version number from Firestore (if stream exists)\n * @returns Current version as bigint or STREAM_DOES_NOT_EXIST\n */\nexport function getCurrentStreamVersion(\n  streamExists: boolean,\n  version?: number,\n): bigint | typeof STREAM_DOES_NOT_EXIST {\n  if (!streamExists) {\n    return STREAM_DOES_NOT_EXIST;\n  }\n  return BigInt(version ?? -1);\n}\n\n/**\n * Calculate the next expected stream version after appending events\n *\n * @param currentVersion - Current stream version\n * @param eventCount - Number of events being appended\n * @returns Next expected version as bigint\n */\nexport function calculateNextVersion(\n  currentVersion: bigint | typeof STREAM_DOES_NOT_EXIST,\n  eventCount: number,\n): bigint {\n  if (currentVersion === STREAM_DOES_NOT_EXIST) {\n    return BigInt(eventCount - 1);\n  }\n  // Type assertion needed because TypeScript doesn't narrow ExpectedStreamVersionGeneral properly\n  return (currentVersion as bigint) + BigInt(eventCount);\n}\n","import type { Firestore, Transaction, Timestamp } from '@google-cloud/firestore';\nimport type { Event } from '@event-driven-io/emmett';\nimport type {\n  AppendToStreamOptions,\n  AppendToStreamResult,\n  CollectionConfig,\n  EventDocument,\n  ExpectedStreamVersion,\n  FirestoreEventStore,\n  FirestoreEventStoreOptions,\n  FirestoreReadEvent,\n  ReadStreamOptions,\n  StreamMetadata,\n} from './types';\nimport { NO_CONCURRENCY_CHECK, STREAM_DOES_NOT_EXIST } from './types';\nimport {\n  assertExpectedVersionMatchesCurrent,\n  getCurrentStreamVersion,\n  padVersion,\n  timestampToDate,\n} from './utils';\n\nconst DEFAULT_COLLECTIONS: CollectionConfig = {\n  streams: 'streams',\n  counters: '_counters',\n};\n\n/**\n * Firestore Event Store Implementation\n *\n * Stores events in Firestore using a subcollection pattern:\n * - /streams/{streamName} - Stream metadata (version, timestamps)\n * - /streams/{streamName}/events/{version} - Individual events\n * - /_counters/global_position - Global event counter\n */\nexport class FirestoreEventStoreImpl implements FirestoreEventStore {\n  public readonly collections: CollectionConfig;\n\n  constructor(\n    public readonly firestore: Firestore,\n    options: FirestoreEventStoreOptions = {},\n  ) {\n    this.collections = {\n      ...DEFAULT_COLLECTIONS,\n      ...options.collections,\n    };\n  }\n\n  /**\n   * Read events from a stream\n   */\n  async readStream<EventType extends Event>(\n    streamName: string,\n    options: ReadStreamOptions = {},\n  ): Promise<FirestoreReadEvent<EventType>[]> {\n    const { from, to, maxCount } = options;\n\n    // Reference to events subcollection\n    let query = this.firestore\n      .collection(this.collections.streams)\n      .doc(streamName)\n      .collection('events')\n      .orderBy('streamVersion', 'asc');\n\n    // Apply range filters\n    if (from !== undefined) {\n      query = query.where('streamVersion', '>=', Number(from));\n    }\n    if (to !== undefined) {\n      query = query.where('streamVersion', '<=', Number(to));\n    }\n    if (maxCount !== undefined && maxCount > 0) {\n      query = query.limit(maxCount);\n    }\n\n    // Execute query\n    const snapshot = await query.get();\n\n    // Transform Firestore documents to events\n    return snapshot.docs.map((doc) => {\n      const data = doc.data() as EventDocument;\n      return {\n        type: data.type,\n        data: data.data,\n        metadata: {\n          ...data.metadata,\n          streamName,\n          streamVersion: BigInt(data.streamVersion),\n          streamPosition: BigInt(data.streamVersion),\n          globalPosition: BigInt(data.globalPosition),\n          timestamp: timestampToDate(data.timestamp),\n        },\n      } as FirestoreReadEvent<EventType>;\n    });\n  }\n\n  /**\n   * Aggregate stream by applying events to state\n   */\n  async aggregateStream<State, EventType extends Event>(\n    streamName: string,\n    options: {\n      evolve: (state: State, event: FirestoreReadEvent<EventType>) => State;\n      initialState: () => State;\n      read?: ReadStreamOptions;\n    },\n  ): Promise<{\n    state: State;\n    currentStreamVersion: bigint;\n    streamExists: boolean;\n  }> {\n    const { evolve, initialState, read } = options;\n    const events = await this.readStream<EventType>(streamName, read);\n\n    const streamExists = events.length > 0;\n    const state = events.reduce(evolve, initialState());\n    const currentStreamVersion = streamExists\n      ? events[events.length - 1].metadata.streamVersion\n      : BigInt(0);\n\n    return {\n      state,\n      currentStreamVersion,\n      streamExists,\n    };\n  }\n\n  /**\n   * Append events to a stream with optimistic concurrency control\n   */\n  async appendToStream<EventType extends Event>(\n    streamName: string,\n    events: EventType[],\n    options: AppendToStreamOptions = {},\n  ): Promise<AppendToStreamResult> {\n    if (events.length === 0) {\n      throw new Error('Cannot append empty event array');\n    }\n\n    const { expectedStreamVersion = NO_CONCURRENCY_CHECK } = options;\n\n    // Execute in transaction for atomicity\n    return await this.firestore.runTransaction(async (transaction) => {\n      return await this.appendToStreamInTransaction(\n        transaction,\n        streamName,\n        events,\n        expectedStreamVersion,\n      );\n    });\n  }\n\n  /**\n   * Internal method to append events within a transaction\n   */\n  private async appendToStreamInTransaction<EventType extends Event>(\n    transaction: Transaction,\n    streamName: string,\n    events: EventType[],\n    expectedStreamVersion: ExpectedStreamVersion,\n  ): Promise<AppendToStreamResult> {\n    // 1. Get stream metadata reference\n    const streamRef = this.firestore\n      .collection(this.collections.streams)\n      .doc(streamName);\n\n    const streamDoc = await transaction.get(streamRef);\n    const streamExists = streamDoc.exists;\n    const streamData = streamDoc.data() as StreamMetadata | undefined;\n\n    // 2. Get current version and validate expected version\n    const currentVersion = getCurrentStreamVersion(\n      streamExists,\n      streamData?.version,\n    );\n\n    assertExpectedVersionMatchesCurrent(\n      streamName,\n      expectedStreamVersion,\n      currentVersion,\n    );\n\n    // 3. Get and increment global position counter\n    const counterRef = this.firestore\n      .collection(this.collections.counters)\n      .doc('global_position');\n\n    const counterDoc = await transaction.get(counterRef);\n    let globalPosition = counterDoc.exists\n      ? (counterDoc.data()?.value as number) ?? 0\n      : 0;\n\n    // 4. Calculate starting version for new events\n    const baseVersion =\n      currentVersion === STREAM_DOES_NOT_EXIST ? -1 : Number(currentVersion);\n\n    // 5. Append events to subcollection\n    const TimestampClass = this.firestore.constructor as unknown as { Timestamp: typeof Timestamp };\n    const now = TimestampClass.Timestamp.now();\n\n    events.forEach((event, index) => {\n      const eventVersion = baseVersion + 1 + index;\n      const eventRef = streamRef\n        .collection('events')\n        .doc(padVersion(eventVersion));\n\n      const metadata = (event as { metadata?: Record<string, unknown> }).metadata;\n      const eventDocument: EventDocument = {\n        type: event.type,\n        data: event.data,\n        ...(metadata && { metadata }),\n        timestamp: now,\n        globalPosition: globalPosition++,\n        streamVersion: eventVersion,\n      };\n\n      transaction.set(eventRef, eventDocument);\n    });\n\n    // 6. Update stream metadata\n    const newVersion = baseVersion + events.length;\n    const updatedMetadata: StreamMetadata = {\n      version: newVersion,\n      createdAt: streamData?.createdAt ?? now,\n      updatedAt: now,\n    };\n\n    transaction.set(streamRef, updatedMetadata);\n\n    // 7. Update global position counter\n    transaction.set(counterRef, {\n      value: globalPosition,\n      updatedAt: now,\n    });\n\n    // 8. Return result\n    return {\n      nextExpectedStreamVersion: BigInt(newVersion),\n      createdNewStream: !streamExists,\n    };\n  }\n}\n\n/**\n * Factory function to create a Firestore event store\n *\n * @param firestore - Firestore instance\n * @param options - Optional configuration\n * @returns Firestore event store instance\n *\n * @example\n * ```typescript\n * import { Firestore } from '@google-cloud/firestore';\n * import { getFirestoreEventStore } from '@emmett-community/emmett-google-firestore';\n *\n * const firestore = new Firestore({ projectId: 'my-project' });\n * const eventStore = getFirestoreEventStore(firestore);\n * ```\n */\nexport function getFirestoreEventStore(\n  firestore: Firestore,\n  options?: FirestoreEventStoreOptions,\n): FirestoreEventStore {\n  return new FirestoreEventStoreImpl(firestore, options);\n}\n","/**\n * Testing utilities for Firestore Event Store\n *\n * These utilities help set up and manage the Firestore Emulator\n * for testing purposes.\n */\n\nimport { Firestore } from '@google-cloud/firestore';\nimport type { FirestoreEventStore } from '../eventStore/types';\nimport { getFirestoreEventStore } from '../eventStore/firestoreEventStore';\n\n/**\n * Configuration for Firestore test environment\n */\nexport interface FirestoreTestConfig {\n  projectId?: string;\n  host?: string;\n  ssl?: boolean;\n}\n\n/**\n * Get a Firestore instance configured for the emulator\n *\n * @param config - Optional configuration override\n * @returns Configured Firestore instance\n *\n * @example\n * ```typescript\n * const firestore = getTestFirestore();\n * // Use firestore for testing\n * await firestore.terminate();\n * ```\n */\nexport function getTestFirestore(config?: FirestoreTestConfig): Firestore {\n  const projectId = config?.projectId || process.env.FIRESTORE_PROJECT_ID || 'test-project';\n  const host = config?.host || process.env.FIRESTORE_EMULATOR_HOST || 'localhost:8080';\n  const ssl = config?.ssl ?? false;\n\n  return new Firestore({\n    projectId,\n    host,\n    ssl,\n    customHeaders: {\n      Authorization: 'Bearer owner',\n    },\n  });\n}\n\n/**\n * Get a test event store instance connected to the emulator\n *\n * @param config - Optional configuration override\n * @returns FirestoreEventStore instance for testing\n *\n * @example\n * ```typescript\n * const eventStore = getTestEventStore();\n * // Use eventStore for testing\n * ```\n */\nexport function getTestEventStore(config?: FirestoreTestConfig): FirestoreEventStore {\n  const firestore = getTestFirestore(config);\n  return getFirestoreEventStore(firestore);\n}\n\n/**\n * Clear all data from a Firestore instance\n * Useful for cleaning up between tests\n *\n * @param firestore - Firestore instance to clear\n * @param batchSize - Number of documents to delete per batch\n *\n * @example\n * ```typescript\n * beforeEach(async () => {\n *   await clearFirestore(firestore);\n * });\n * ```\n */\nexport async function clearFirestore(\n  firestore: Firestore,\n  batchSize = 100,\n): Promise<void> {\n  const collections = await firestore.listCollections();\n\n  for (const collection of collections) {\n    await deleteCollection(firestore, collection.id, batchSize);\n  }\n}\n\n/**\n * Delete a specific collection from Firestore\n *\n * @param firestore - Firestore instance\n * @param collectionPath - Path to the collection to delete\n * @param batchSize - Number of documents to delete per batch\n */\nexport async function deleteCollection(\n  firestore: Firestore,\n  collectionPath: string,\n  batchSize = 100,\n): Promise<void> {\n  const collectionRef = firestore.collection(collectionPath);\n  const query = collectionRef.limit(batchSize);\n\n  return new Promise((resolve, reject) => {\n    void deleteQueryBatch(firestore, query, resolve, reject);\n  });\n}\n\nasync function deleteQueryBatch(\n  firestore: Firestore,\n  query: FirebaseFirestore.Query,\n  resolve: () => void,\n  reject: (error: Error) => void,\n): Promise<void> {\n  try {\n    const snapshot = await query.get();\n\n    if (snapshot.size === 0) {\n      resolve();\n      return;\n    }\n\n    const batch = firestore.batch();\n    snapshot.docs.forEach((doc) => {\n      batch.delete(doc.ref);\n    });\n    await batch.commit();\n\n    process.nextTick(() => {\n      void deleteQueryBatch(firestore, query, resolve, reject);\n    });\n  } catch (error) {\n    reject(error as Error);\n  }\n}\n\n/**\n * Wait for the Firestore emulator to be ready\n *\n * @param host - Emulator host (default: localhost:8080)\n * @param timeout - Maximum time to wait in milliseconds (default: 30000)\n * @param interval - Check interval in milliseconds (default: 100)\n * @returns Promise that resolves when emulator is ready\n *\n * @example\n * ```typescript\n * await waitForEmulator();\n * // Emulator is ready\n * ```\n */\nexport async function waitForEmulator(\n  host = 'localhost:8080',\n  timeout = 30000,\n  interval = 100,\n): Promise<void> {\n  const startTime = Date.now();\n  const firestore = new Firestore({\n    projectId: 'test',\n    host,\n    ssl: false,\n  });\n\n  while (Date.now() - startTime < timeout) {\n    try {\n      await firestore.listCollections();\n      await firestore.terminate();\n      return;\n    } catch {\n      await new Promise((resolve) => setTimeout(resolve, interval));\n    }\n  }\n\n  await firestore.terminate();\n  throw new Error(`Firestore emulator not ready after ${timeout}ms`);\n}\n\n/**\n * Setup function for Jest/Vitest tests with Firestore emulator\n *\n * @returns Object with firestore instance and cleanup function\n *\n * @example\n * ```typescript\n * describe('My Tests', () => {\n *   const { firestore, cleanup } = setupFirestoreTests();\n *\n *   afterAll(cleanup);\n *\n *   beforeEach(async () => {\n *     await clearFirestore(firestore);\n *   });\n *\n *   it('should work', async () => {\n *     const eventStore = getFirestoreEventStore(firestore);\n *     // ... test code\n *   });\n * });\n * ```\n */\nexport function setupFirestoreTests(config?: FirestoreTestConfig): {\n  firestore: Firestore;\n  eventStore: FirestoreEventStore;\n  cleanup: () => Promise<void>;\n  clearData: () => Promise<void>;\n} {\n  const firestore = getTestFirestore(config);\n  const eventStore = getFirestoreEventStore(firestore);\n\n  const cleanup = async () => {\n    await firestore.terminate();\n  };\n\n  const clearData = async () => {\n    await clearFirestore(firestore);\n  };\n\n  return {\n    firestore,\n    eventStore,\n    cleanup,\n    clearData,\n  };\n}\n"]}

package/dist/testing/index.mjs

@@ -1,289 +0,0 @@
-import { Firestore } from '@google-cloud/firestore';
-import { NO_CONCURRENCY_CHECK, STREAM_DOES_NOT_EXIST, STREAM_EXISTS } from '@event-driven-io/emmett';
-
-// src/testing/eventStoreSpec.ts
-var ExpectedVersionConflictError = class _ExpectedVersionConflictError extends Error {
-  constructor(streamName, expected, actual) {
-    super(
-      `Expected version conflict for stream '${streamName}': expected ${String(expected)}, actual ${String(actual)}`
-    );
-    this.streamName = streamName;
-    this.expected = expected;
-    this.actual = actual;
-    this.name = "ExpectedVersionConflictError";
-    Object.setPrototypeOf(this, _ExpectedVersionConflictError.prototype);
-  }
-};
-
-// src/eventStore/utils.ts
-function padVersion(version) {
-  return version.toString().padStart(10, "0");
-}
-function timestampToDate(timestamp) {
-  return timestamp.toDate();
-}
-function assertExpectedVersionMatchesCurrent(streamName, expectedVersion, currentVersion) {
-  if (expectedVersion === NO_CONCURRENCY_CHECK) {
-    return;
-  }
-  if (expectedVersion === STREAM_DOES_NOT_EXIST) {
-    if (currentVersion !== STREAM_DOES_NOT_EXIST) {
-      throw new ExpectedVersionConflictError(
-        streamName,
-        expectedVersion,
-        currentVersion
-      );
-    }
-    return;
-  }
-  if (expectedVersion === STREAM_EXISTS) {
-    if (currentVersion === STREAM_DOES_NOT_EXIST) {
-      throw new ExpectedVersionConflictError(
-        streamName,
-        expectedVersion,
-        currentVersion
-      );
-    }
-    return;
-  }
-  const expectedBigInt = BigInt(expectedVersion);
-  if (currentVersion === STREAM_DOES_NOT_EXIST || currentVersion !== expectedBigInt) {
-    throw new ExpectedVersionConflictError(
-      streamName,
-      expectedVersion,
-      currentVersion
-    );
-  }
-}
-function getCurrentStreamVersion(streamExists, version) {
-  if (!streamExists) {
-    return STREAM_DOES_NOT_EXIST;
-  }
-  return BigInt(version ?? -1);
-}
-
-// src/eventStore/firestoreEventStore.ts
-var DEFAULT_COLLECTIONS = {
-  streams: "streams",
-  counters: "_counters"
-};
-var FirestoreEventStoreImpl = class {
-  constructor(firestore, options = {}) {
-    this.firestore = firestore;
-    this.collections = {
-      ...DEFAULT_COLLECTIONS,
-      ...options.collections
-    };
-  }
-  collections;
-  /**
-   * Read events from a stream
-   */
-  async readStream(streamName, options = {}) {
-    const { from, to, maxCount } = options;
-    let query = this.firestore.collection(this.collections.streams).doc(streamName).collection("events").orderBy("streamVersion", "asc");
-    if (from !== void 0) {
-      query = query.where("streamVersion", ">=", Number(from));
-    }
-    if (to !== void 0) {
-      query = query.where("streamVersion", "<=", Number(to));
-    }
-    if (maxCount !== void 0 && maxCount > 0) {
-      query = query.limit(maxCount);
-    }
-    const snapshot = await query.get();
-    return snapshot.docs.map((doc) => {
-      const data = doc.data();
-      return {
-        type: data.type,
-        data: data.data,
-        metadata: {
-          ...data.metadata,
-          streamName,
-          streamVersion: BigInt(data.streamVersion),
-          streamPosition: BigInt(data.streamVersion),
-          globalPosition: BigInt(data.globalPosition),
-          timestamp: timestampToDate(data.timestamp)
-        }
-      };
-    });
-  }
-  /**
-   * Aggregate stream by applying events to state
-   */
-  async aggregateStream(streamName, options) {
-    const { evolve, initialState, read } = options;
-    const events = await this.readStream(streamName, read);
-    const streamExists = events.length > 0;
-    const state = events.reduce(evolve, initialState());
-    const currentStreamVersion = streamExists ? events[events.length - 1].metadata.streamVersion : BigInt(0);
-    return {
-      state,
-      currentStreamVersion,
-      streamExists
-    };
-  }
-  /**
-   * Append events to a stream with optimistic concurrency control
-   */
-  async appendToStream(streamName, events, options = {}) {
-    if (events.length === 0) {
-      throw new Error("Cannot append empty event array");
-    }
-    const { expectedStreamVersion = NO_CONCURRENCY_CHECK } = options;
-    return await this.firestore.runTransaction(async (transaction) => {
-      return await this.appendToStreamInTransaction(
-        transaction,
-        streamName,
-        events,
-        expectedStreamVersion
-      );
-    });
-  }
-  /**
-   * Internal method to append events within a transaction
-   */
-  async appendToStreamInTransaction(transaction, streamName, events, expectedStreamVersion) {
-    const streamRef = this.firestore.collection(this.collections.streams).doc(streamName);
-    const streamDoc = await transaction.get(streamRef);
-    const streamExists = streamDoc.exists;
-    const streamData = streamDoc.data();
-    const currentVersion = getCurrentStreamVersion(
-      streamExists,
-      streamData?.version
-    );
-    assertExpectedVersionMatchesCurrent(
-      streamName,
-      expectedStreamVersion,
-      currentVersion
-    );
-    const counterRef = this.firestore.collection(this.collections.counters).doc("global_position");
-    const counterDoc = await transaction.get(counterRef);
-    let globalPosition = counterDoc.exists ? counterDoc.data()?.value ?? 0 : 0;
-    const baseVersion = currentVersion === STREAM_DOES_NOT_EXIST ? -1 : Number(currentVersion);
-    const TimestampClass = this.firestore.constructor;
-    const now = TimestampClass.Timestamp.now();
-    events.forEach((event, index) => {
-      const eventVersion = baseVersion + 1 + index;
-      const eventRef = streamRef.collection("events").doc(padVersion(eventVersion));
-      const metadata = event.metadata;
-      const eventDocument = {
-        type: event.type,
-        data: event.data,
-        ...metadata && { metadata },
-        timestamp: now,
-        globalPosition: globalPosition++,
-        streamVersion: eventVersion
-      };
-      transaction.set(eventRef, eventDocument);
-    });
-    const newVersion = baseVersion + events.length;
-    const updatedMetadata = {
-      version: newVersion,
-      createdAt: streamData?.createdAt ?? now,
-      updatedAt: now
-    };
-    transaction.set(streamRef, updatedMetadata);
-    transaction.set(counterRef, {
-      value: globalPosition,
-      updatedAt: now
-    });
-    return {
-      nextExpectedStreamVersion: BigInt(newVersion),
-      createdNewStream: !streamExists
-    };
-  }
-};
-function getFirestoreEventStore(firestore, options) {
-  return new FirestoreEventStoreImpl(firestore, options);
-}
-
-// src/testing/eventStoreSpec.ts
-function getTestFirestore(config) {
-  const projectId = config?.projectId || process.env.FIRESTORE_PROJECT_ID || "test-project";
-  const host = config?.host || process.env.FIRESTORE_EMULATOR_HOST || "localhost:8080";
-  const ssl = config?.ssl ?? false;
-  return new Firestore({
-    projectId,
-    host,
-    ssl,
-    customHeaders: {
-      Authorization: "Bearer owner"
-    }
-  });
-}
-function getTestEventStore(config) {
-  const firestore = getTestFirestore(config);
-  return getFirestoreEventStore(firestore);
-}
-async function clearFirestore(firestore, batchSize = 100) {
-  const collections = await firestore.listCollections();
-  for (const collection of collections) {
-    await deleteCollection(firestore, collection.id, batchSize);
-  }
-}
-async function deleteCollection(firestore, collectionPath, batchSize = 100) {
-  const collectionRef = firestore.collection(collectionPath);
-  const query = collectionRef.limit(batchSize);
-  return new Promise((resolve, reject) => {
-    void deleteQueryBatch(firestore, query, resolve, reject);
-  });
-}
-async function deleteQueryBatch(firestore, query, resolve, reject) {
-  try {
-    const snapshot = await query.get();
-    if (snapshot.size === 0) {
-      resolve();
-      return;
-    }
-    const batch = firestore.batch();
-    snapshot.docs.forEach((doc) => {
-      batch.delete(doc.ref);
-    });
-    await batch.commit();
-    process.nextTick(() => {
-      void deleteQueryBatch(firestore, query, resolve, reject);
-    });
-  } catch (error) {
-    reject(error);
-  }
-}
-async function waitForEmulator(host = "localhost:8080", timeout = 3e4, interval = 100) {
-  const startTime = Date.now();
-  const firestore = new Firestore({
-    projectId: "test",
-    host,
-    ssl: false
-  });
-  while (Date.now() - startTime < timeout) {
-    try {
-      await firestore.listCollections();
-      await firestore.terminate();
-      return;
-    } catch {
-      await new Promise((resolve) => setTimeout(resolve, interval));
-    }
-  }
-  await firestore.terminate();
-  throw new Error(`Firestore emulator not ready after ${timeout}ms`);
-}
-function setupFirestoreTests(config) {
-  const firestore = getTestFirestore(config);
-  const eventStore = getFirestoreEventStore(firestore);
-  const cleanup = async () => {
-    await firestore.terminate();
-  };
-  const clearData = async () => {
-    await clearFirestore(firestore);
-  };
-  return {
-    firestore,
-    eventStore,
-    cleanup,
-    clearData
-  };
-}
-
-export { clearFirestore, deleteCollection, getTestEventStore, getTestFirestore, setupFirestoreTests, waitForEmulator };
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map