@wataruoguchi/emmett-event-store-kysely 2.0.2 → 2.2.0

package/README.md

@@ -2,6 +2,10 @@
 
 A Kysely-based event store implementation for [Emmett](https://github.com/event-driven-io/emmett), providing event sourcing capabilities with PostgreSQL.
 
+## 📚 Documentation
+
+**👉 [View Complete Documentation →](https://wataruoguchi.github.io/emmett-libs/emmett-event-store-kysely)**
+
 ## Features
 
 - **Event Store** - Full event sourcing with Kysely and PostgreSQL
@@ -20,13 +24,12 @@ npm install @wataruoguchi/emmett-event-store-kysely @event-driven-io/emmett kyse
 
 ### 1. Database Setup
 
-Set up the required PostgreSQL tables using [our migration example](https://github.com/wataruoguchi/emmett-event-store-kysely/blob/main/package/database/migrations/1758758113676_event_sourcing_migration_example.ts):
+Set up the required PostgreSQL tables using [our migration example](https://github.com/wataruoguchi/emmett-libs/blob/main/packages/emmett-event-store-kysely/database/migrations/1758758113676_event_sourcing_migration_example.ts):
 
 ```typescript
 import { Kysely } from "kysely";
 
 // Required tables: messages, streams, subscriptions
-// See https://github.com/wataruoguchi/emmett-event-store-kysely/blob/main/package/docs/database-setup.md for details
 ```
 
 A read model table expects to have the following columns:
@@ -110,24 +113,10 @@ await runner.projectEvents("subscription-id", "cart-123", {
 });
 ```
 
-See [Snapshot Projections documentation](https://github.com/wataruoguchi/emmett-event-store-kysely/blob/main/package/docs/snapshot-projections.md) for details.
-
-## Documentation
-
-📚 **[Complete Documentation](https://github.com/wataruoguchi/emmett-event-store-kysely/blob/main/package/docs/README.md)**
-
-### Core Guides
-
-- [Database Setup](https://github.com/wataruoguchi/emmett-event-store-kysely/blob/main/package/docs/database-setup.md) - PostgreSQL schema and requirements
-- [Event Store](https://github.com/wataruoguchi/emmett-event-store-kysely/blob/main/package/docs/event-store.md) - Core event store API
-- [Snapshot Projections](https://github.com/wataruoguchi/emmett-event-store-kysely/blob/main/package/docs/snapshot-projections.md) - Build read models (recommended) ⭐
-- [Event Consumer](https://github.com/wataruoguchi/emmett-event-store-kysely/blob/main/package/docs/consumer.md) - Continuous background processing
-- [Projection Runner](https://github.com/wataruoguchi/emmett-event-store-kysely/blob/main/package/docs/projection-runner.md) - On-demand processing for tests
-
-### Examples
+## Examples
 
-- [Working Example](https://github.com/wataruoguchi/emmett-event-store-kysely/tree/main/example/) - Complete application with carts and generators
-- [Migration Example](https://github.com/wataruoguchi/emmett-event-store-kysely/blob/main/package/database/migrations/1758758113676_event_sourcing_migration_example.ts) - Database setup
+- [Working Example](https://github.com/wataruoguchi/emmett-libs/tree/main/example/) - Complete application with carts and generators
+- [Migration Example](https://github.com/wataruoguchi/emmett-libs/blob/main/packages/emmett-event-store-kysely/database/migrations/1758758113676_event_sourcing_migration_example.ts) - Database setup
 
 ## License
 
@@ -135,4 +124,4 @@ MIT
 
 ## Contributing
 
-Contributions are welcome! Please see our [GitHub repository](https://github.com/wataruoguchi/emmett-event-store-kysely) for issues and PRs.
+Contributions are welcome! Please see our [GitHub repository](https://github.com/wataruoguchi/emmett-libs) for issues and PRs.

package/dist/event-store/kysely-event-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kysely-event-store.d.ts","sourceRoot":"","sources":["../../src/event-store/kysely-event-store.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,qBAAqB,EAC1B,KAAK,sCAAsC,EAC3C,KAAK,KAAK,EACV,KAAK,UAAU,EAEf,KAAK,wBAAwB,EAE7B,KAAK,mCAAmC,EACxC,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,KAAK,uBAAuB,GAAG,mCAAmC,CAAC;AACnE,KAAK,6BAA6B,GAAG,qBAAqB,GAAG,eAAe,CAAC;AAI7E,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,gBACf,SAAQ,UAAU,CAAC,uBAAuB,CAAC,EACzC,wBAAwB,CAAC,gBAAgB,CAAC;IAE5C,UAAU,CAAC,SAAS,SAAS,KAAK,EAChC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,2BAA2B,GAChE,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC,CAAC;IACjE,cAAc,CAAC,SAAS,SAAS,KAAK,EACpC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,EAAE,EACnB,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,sCAAsC,CAAC,CAAC;IACnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,EAAE;QACN,GAAG,IAAI,MAAM,CAAC;QACd,KAAK,IAAI,IAAI,CAAC;QACd,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,kCAAkC;IAClC,iBAAiB,CAAC,EAAE;QAClB,iDAAiD;QACjD,EAAE,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;KACtB,CAAC;IACF,gCAAgC;IAChC,MAAM,CAAC,EAAE;QACP,8BAA8B;QAC9B,aAAa,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;KAC3C,CAAC;IACF,iCAAiC;IACjC,KAAK,CAAC,EAAE;QACN,qCAAqC;QACrC,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;KACnD,CAAC;CACH,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,uBAIlC,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,MAAM,YAAY,KAAG,gBAiKxD,CAAC"}
+{"version":3,"file":"kysely-event-store.d.ts","sourceRoot":"","sources":["../../src/event-store/kysely-event-store.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,qBAAqB,EAC1B,KAAK,sCAAsC,EAC3C,KAAK,KAAK,EACV,KAAK,UAAU,EAEf,KAAK,wBAAwB,EAE7B,KAAK,mCAAmC,EACxC,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,KAAK,uBAAuB,GAAG,mCAAmC,CAAC;AACnE,KAAK,6BAA6B,GAAG,qBAAqB,GAAG,eAAe,CAAC;AAI7E,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,gBACf,SAAQ,UAAU,CAAC,uBAAuB,CAAC,EACzC,wBAAwB,CAAC,gBAAgB,CAAC;IAE5C,UAAU,CAAC,SAAS,SAAS,KAAK,EAChC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,2BAA2B,GAChE,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC,CAAC;IACjE,cAAc,CAAC,SAAS,SAAS,KAAK,EACpC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,EAAE,EACnB,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,sCAAsC,CAAC,CAAC;IACnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,EAAE;QACN,GAAG,IAAI,MAAM,CAAC;QACd,KAAK,IAAI,IAAI,CAAC;QACd,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,kCAAkC;IAClC,iBAAiB,CAAC,EAAE;QAClB,iDAAiD;QACjD,EAAE,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;KACtB,CAAC;IACF,gCAAgC;IAChC,MAAM,CAAC,EAAE;QACP,8BAA8B;QAC9B,aAAa,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;KAC3C,CAAC;IACF,iCAAiC;IACjC,KAAK,CAAC,EAAE;QACN,qCAAqC;QACrC,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;KACnD,CAAC;CACH,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,uBAIlC,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,MAAM,YAAY,KAAG,gBAkLxD,CAAC"}

package/dist/event-store/kysely-event-store.js

@@ -7,7 +7,7 @@ export const defaultKyselyOptions = {
     },
 };
 export const getKyselyEventStore = (deps) => {
-    const { db, logger } = deps;
+    const { db, logger, inTransaction = false } = deps;
     const eventStore = {
         /**
          * @description We do not use schema management in this package.
@@ -18,17 +18,25 @@ export const getKyselyEventStore = (deps) => {
             migrate: async () => Promise.resolve(),
         },
         /**
-         * @description We do not use session management in this package.
+         * Provide a session-bound event store using a Kysely transaction.
+         * All operations within the callback will share the same DB transaction.
          */
         async withSession(callback) {
-            return await callback({
-                eventStore,
-                close: () => Promise.resolve(),
+            return await db.transaction().execute(async (trx) => {
+                const sessionEventStore = getKyselyEventStore({
+                    db: trx,
+                    logger,
+                    inTransaction: true,
+                });
+                return await callback({
+                    eventStore: sessionEventStore,
+                    close: () => Promise.resolve(),
+                });
             });
         },
         async aggregateStream(streamName, options) {
             const { evolve, initialState, read } = options;
-            logger.info({ streamName, options }, "aggregateStream");
+            logger.debug?.({ streamName, options }, "aggregateStream");
             const expectedStreamVersion = read?.expectedStreamVersion;
             const result = await eventStore.readStream(streamName, read);
             assertExpectedVersionMatchesCurrent(result.currentStreamVersion, expectedStreamVersion, PostgreSQLEventStoreDefaultStreamVersion);
@@ -41,7 +49,7 @@ export const getKyselyEventStore = (deps) => {
         },
         async readStream(streamName, options) {
             const partition = getPartition(options);
-            logger.info({ streamName, options, partition }, "readStream");
+            logger.debug?.({ streamName, options, partition }, "readStream");
             const { currentStreamVersion, streamExists } = await fetchStreamInfo(db, streamName, partition);
             const range = parseRangeOptions(options);
             const rows = await buildEventsQuery({ db, logger }, streamName, partition, range).execute();
@@ -56,25 +64,29 @@ export const getKyselyEventStore = (deps) => {
             const streamType = getStreamType(options);
             const partition = getPartition(options);
             const expected = options?.expectedStreamVersion;
-            logger.info({ streamName, events, options, partition }, "appendToStream");
+            logger.debug?.({ streamName, events, options, partition }, "appendToStream");
             ensureEventsNotEmpty(events, expected);
-            const result = await db
-                .transaction()
-                .execute(async (trx) => {
-                const { currentStreamVersion, streamExists } = await fetchStreamInfo(trx, streamName, partition);
+            // It may be called within a transaction via withSession.
+            const executeOn = async (executor) => {
+                const { currentStreamVersion, streamExists } = await fetchStreamInfo(executor, streamName, partition);
                 assertExpectedVersion(expected, currentStreamVersion, streamExists);
                 const basePos = currentStreamVersion;
                 const nextStreamPosition = computeNextStreamPosition(basePos, events.length);
-                await upsertStreamRow(trx, streamName, partition, streamType, basePos, nextStreamPosition, expected, streamExists);
+                await upsertStreamRow(executor, streamName, partition, streamType, basePos, nextStreamPosition, expected, streamExists);
                 const messagesToInsert = buildMessagesToInsert(events, basePos, streamName, partition);
-                const lastEventGlobalPosition = await insertMessagesAndGetLastGlobalPosition(trx, messagesToInsert);
+                const lastEventGlobalPosition = await insertMessagesAndGetLastGlobalPosition(executor, messagesToInsert);
                 return {
                     nextExpectedStreamVersion: nextStreamPosition,
                     lastEventGlobalPosition,
                     createdNewStream: !streamExists,
                 };
-            });
-            return result;
+            };
+            if (inTransaction) {
+                return executeOn(db);
+            }
+            return db
+                .transaction()
+                .execute(async (trx) => executeOn(trx));
         },
         close: async () => {
             // Kysely doesn't require explicit closing for most cases
@@ -155,7 +167,6 @@ function buildMessagesToInsert(events, basePos, streamId, partition) {
         const rawMeta = "metadata" in e ? e.metadata : undefined;
         const eventMeta = rawMeta && typeof rawMeta === "object" ? rawMeta : {};
         const messageMetadata = {
-            messageId,
             ...eventMeta,
         };
         return {

package/dist/index.cjs

@@ -184,7 +184,7 @@ function createProjectionRegistry(...registries) {
 
 // src/event-store/kysely-event-store.ts
 var getKyselyEventStore = (deps) => {
-  const { db, logger } = deps;
+  const { db, logger, inTransaction = false } = deps;
   const eventStore = {
     /**
      * @description We do not use schema management in this package.
@@ -195,17 +195,25 @@ var getKyselyEventStore = (deps) => {
       migrate: async () => Promise.resolve()
     },
     /**
-     * @description We do not use session management in this package.
+     * Provide a session-bound event store using a Kysely transaction.
+     * All operations within the callback will share the same DB transaction.
      */
     async withSession(callback) {
-      return await callback({
-        eventStore,
-        close: () => Promise.resolve()
+      return await db.transaction().execute(async (trx) => {
+        const sessionEventStore = getKyselyEventStore({
+          db: trx,
+          logger,
+          inTransaction: true
+        });
+        return await callback({
+          eventStore: sessionEventStore,
+          close: () => Promise.resolve()
+        });
       });
     },
     async aggregateStream(streamName, options) {
       const { evolve, initialState, read } = options;
-      logger.info({ streamName, options }, "aggregateStream");
+      logger.debug?.({ streamName, options }, "aggregateStream");
       const expectedStreamVersion = read?.expectedStreamVersion;
       const result = await eventStore.readStream(streamName, read);
       (0, import_emmett.assertExpectedVersionMatchesCurrent)(
@@ -225,7 +233,7 @@ var getKyselyEventStore = (deps) => {
     },
     async readStream(streamName, options) {
       const partition = getPartition(options);
-      logger.info({ streamName, options, partition }, "readStream");
+      logger.debug?.({ streamName, options, partition }, "readStream");
       const { currentStreamVersion, streamExists } = await fetchStreamInfo(
         db,
         streamName,
@@ -251,11 +259,14 @@ var getKyselyEventStore = (deps) => {
       const streamType = getStreamType(options);
       const partition = getPartition(options);
       const expected = options?.expectedStreamVersion;
-      logger.info({ streamName, events, options, partition }, "appendToStream");
+      logger.debug?.(
+        { streamName, events, options, partition },
+        "appendToStream"
+      );
       ensureEventsNotEmpty(events, expected);
-      const result = await db.transaction().execute(async (trx) => {
+      const executeOn = async (executor) => {
         const { currentStreamVersion, streamExists } = await fetchStreamInfo(
-          trx,
+          executor,
           streamName,
           partition
         );
@@ -266,7 +277,7 @@ var getKyselyEventStore = (deps) => {
           events.length
         );
         await upsertStreamRow(
-          trx,
+          executor,
           streamName,
           partition,
           streamType,
@@ -281,14 +292,20 @@ var getKyselyEventStore = (deps) => {
           streamName,
           partition
         );
-        const lastEventGlobalPosition = await insertMessagesAndGetLastGlobalPosition(trx, messagesToInsert);
+        const lastEventGlobalPosition = await insertMessagesAndGetLastGlobalPosition(
+          executor,
+          messagesToInsert
+        );
         return {
           nextExpectedStreamVersion: nextStreamPosition,
           lastEventGlobalPosition,
           createdNewStream: !streamExists
         };
-      });
-      return result;
+      };
+      if (inTransaction) {
+        return executeOn(db);
+      }
+      return db.transaction().execute(async (trx) => executeOn(trx));
     },
     close: async () => {
       await Promise.resolve();
@@ -351,7 +368,6 @@ function buildMessagesToInsert(events, basePos, streamId, partition) {
     const rawMeta = "metadata" in e ? e.metadata : void 0;
     const eventMeta = rawMeta && typeof rawMeta === "object" ? rawMeta : {};
     const messageMetadata = {
-      messageId,
       ...eventMeta
     };
     return {
@@ -430,7 +446,11 @@ async function fetchStreamInfo(executor, streamId, partition) {
 }
 
 // src/projections/runner.ts
-function createProjectionRunner({ db, readStream, registry }) {
+function createProjectionRunner({
+  db,
+  readStream,
+  registry
+}) {
   async function getOrCreateCheckpoint(subscriptionId, partition) {
     const existing = await db.selectFrom("subscriptions").select([
       "subscription_id as subscriptionId",

package/dist/projections/runner.d.ts

@@ -1,16 +1,21 @@
+import type { Kysely } from "kysely";
 import type { KyselyEventStore } from "../event-store/kysely-event-store.js";
-import type { DatabaseExecutor, ProjectionRegistry } from "../types.js";
+import type { ProjectionRegistry } from "../types.js";
 export type SubscriptionCheckpoint = {
     subscriptionId: string;
     partition: string;
     lastProcessedPosition: bigint;
 };
-export type ProjectionRunnerDeps<T extends DatabaseExecutor = DatabaseExecutor> = {
-    db: T;
+/**
+ * Flexible database type for projection runner.
+ * Uses `Kysely<any> | any` to work around Kysely's private field variance issue.
+ */
+export type ProjectionRunnerDeps = {
+    db: Kysely<any> | any;
     readStream: KyselyEventStore["readStream"];
-    registry: ProjectionRegistry<T>;
+    registry: ProjectionRegistry;
 };
-export declare function createProjectionRunner<T extends DatabaseExecutor = DatabaseExecutor>({ db, readStream, registry }: ProjectionRunnerDeps<T>): {
+export declare function createProjectionRunner({ db, readStream, registry, }: ProjectionRunnerDeps): {
     projectEvents: (subscriptionId: string, streamId: string, opts?: {
         partition?: string;
         batchSize?: number;

package/dist/projections/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/projections/runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EACV,gBAAgB,EAEhB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,sBAAsB,GAAG;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAC9B,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IAC3C;IACF,EAAE,EAAE,CAAC,CAAC;IACN,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC3C,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CACjC,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,EAC7C,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;oCA4EnC,MAAM,YACZ,MAAM,SACT;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;;;;EAiDpD"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/projections/runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAqB,MAAM,QAAQ,CAAC;AAExD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EAAmB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEvE,MAAM,MAAM,sBAAsB,GAAG;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACtB,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC3C,QAAQ,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,EACrC,EAAE,EACF,UAAU,EACV,QAAQ,GACT,EAAE,oBAAoB;oCA4EH,MAAM,YACZ,MAAM,SACT;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;;;;EAiDpD"}

package/dist/projections/runner.js

@@ -1,4 +1,4 @@
-export function createProjectionRunner({ db, readStream, registry }) {
+export function createProjectionRunner({ db, readStream, registry, }) {
     async function getOrCreateCheckpoint(subscriptionId, partition) {
         const existing = await db
             .selectFrom("subscriptions")

package/dist/projections/snapshot-projection.d.ts

@@ -116,5 +116,5 @@ export declare function createSnapshotProjectionRegistry<TState, TTable extends
 } = {
     type: string;
     data: unknown;
-}>(eventTypes: E["type"][], config: SnapshotProjectionConfig<TState, TTable, E>): ProjectionRegistry<DatabaseExecutor>;
+}>(eventTypes: E["type"][], config: SnapshotProjectionConfig<TState, TTable, E>): ProjectionRegistry;
 //# sourceMappingURL=snapshot-projection.d.ts.map

package/dist/projections/snapshot-projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot-projection.d.ts","sourceRoot":"","sources":["../../src/projections/snapshot-projection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAErB;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,CAClC,MAAM,EACN,MAAM,SAAS,MAAM,EACrB,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,IACzE;IACF;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB;;OAEG;IACH,WAAW,EAAE,CACX,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,EACzB,SAAS,EAAE,MAAM,KACd,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5B;;;OAGG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;IAE7D;;OAEG;IACH,YAAY,EAAE,MAAM,MAAM,CAAC;IAE3B;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EACN,MAAM,SAAS,MAAM,EACrB,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,EAE3E,MAAM,EAAE,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,GAClD,iBAAiB,CAAC,gBAAgB,EAAE,CAAC,CAAC,CA2FxC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EACN,MAAM,SAAS,MAAM,EACrB,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,EAE3E,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EACvB,MAAM,EAAE,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,GAClD,kBAAkB,CAAC,gBAAgB,CAAC,CAStC"}
+{"version":3,"file":"snapshot-projection.d.ts","sourceRoot":"","sources":["../../src/projections/snapshot-projection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAErB;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,CAClC,MAAM,EACN,MAAM,SAAS,MAAM,EACrB,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,IACzE;IACF;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB;;OAEG;IACH,WAAW,EAAE,CACX,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,EACzB,SAAS,EAAE,MAAM,KACd,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5B;;;OAGG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;IAE7D;;OAEG;IACH,YAAY,EAAE,MAAM,MAAM,CAAC;IAE3B;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EACN,MAAM,SAAS,MAAM,EACrB,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,EAE3E,MAAM,EAAE,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,GAClD,iBAAiB,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAkGxC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EACN,MAAM,SAAS,MAAM,EACrB,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,EAE3E,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EACvB,MAAM,EAAE,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,GAClD,kBAAkB,CAYpB"}

package/dist/projections/snapshot-projection.js

@@ -34,10 +34,14 @@ export function createSnapshotProjection(config) {
     return async ({ db, partition }, event) => {
         const keys = extractKeys(event, partition);
         // Check if event is newer than what we've already processed
-        // Note: Casting to any is necessary because Kysely cannot infer types for dynamic table names
+        // Note: Casting to `any` is necessary because Kysely cannot infer types for dynamic table names.
+        // The table name is provided at runtime, so TypeScript cannot verify the table structure at compile time.
+        // This is a known limitation when working with dynamic table names in Kysely.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const existing = await db
             .selectFrom(tableName)
             .select(["last_stream_position", "snapshot"])
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             .where((eb) => {
             const conditions = Object.entries(keys).map(([key, value]) => eb(key, "=", value));
             return eb.and(conditions);
@@ -86,6 +90,9 @@ export function createSnapshotProjection(config) {
             }
         }
         await insertQuery
+            // Note: `any` is used here because the conflict builder needs to work with any table schema.
+            // The actual schema is validated at runtime through Kysely's query builder.
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             .onConflict((oc) => {
             const conflictBuilder = oc.columns(primaryKeys);
             return conflictBuilder.doUpdateSet(updateSet);
@@ -119,6 +126,9 @@ export function createSnapshotProjectionRegistry(eventTypes, config) {
     const handler = createSnapshotProjection(config);
     const registry = {};
     for (const eventType of eventTypes) {
+        // Type cast is safe here because ProjectionHandler is contravariant in its event type parameter.
+        // A handler for a specific event type E can safely handle any event that matches E's structure.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         registry[eventType] = [handler];
     }
     return registry;

package/dist/types.d.ts

@@ -1,14 +1,22 @@
 import type { Kysely } from "kysely";
 export type DatabaseExecutor<T = any> = Kysely<T>;
+/**
+ * Flexible database type that accepts any Kysely instance.
+ * The `Kysely<any> | any` union type is intentional to work around Kysely's private field variance
+ * issue in TypeScript, allowing DatabaseExecutor from different modules to be passed.
+ */
+export type FlexibleDatabase = Kysely<any> | any;
 export type Logger = {
     info: (obj: unknown, msg?: string) => void;
     error: (obj: unknown, msg?: string) => void;
     warn?: (obj: unknown, msg?: string) => void;
     debug?: (obj: unknown, msg?: string) => void;
 };
-export type Dependencies<T = any> = {
-    db: DatabaseExecutor<T>;
+export type Dependencies = {
+    db: FlexibleDatabase;
     logger: Logger;
+    /** If true, the provided db is already a transaction executor. */
+    inTransaction?: boolean;
 };
 export type ExtendedOptions = {
     partition?: string;
@@ -50,17 +58,27 @@ export type ProjectionEvent<E extends {
 }> = E & {
     metadata: ProjectionEventMetadata;
 };
-export type ProjectionContext<T = DatabaseExecutor<any>> = {
+export type ProjectionContext<T = FlexibleDatabase> = {
     db: T;
     partition: string;
 };
-export type ProjectionHandler<T = DatabaseExecutor<any>, E extends {
+export type ProjectionHandler<T = FlexibleDatabase, E extends {
     type: string;
     data: unknown;
 } = {
     type: string;
     data: unknown;
 }> = (ctx: ProjectionContext<T>, event: ProjectionEvent<E>) => void | Promise<void>;
-export type ProjectionRegistry<T = DatabaseExecutor<any>> = Record<string, ProjectionHandler<T, any>[]>;
-export declare function createProjectionRegistry<T = DatabaseExecutor<any>>(...registries: ProjectionRegistry<T>[]): ProjectionRegistry<T>;
+/**
+ * ProjectionRegistry maps event types to their handlers.
+ * The `any` in `ProjectionHandler<T, any>[]` is intentional - it allows handlers
+ * for different event types to be registered together, with type safety enforced
+ * at the handler level through the ProjectionHandler generic parameter.
+ * Uses FlexibleDatabase by default to work around Kysely's private field variance issue.
+ */
+export type ProjectionRegistry<T = FlexibleDatabase> = Record<string, ProjectionHandler<T, {
+    type: string;
+    data: unknown;
+}>[]>;
+export declare function createProjectionRegistry<T = FlexibleDatabase>(...registries: ProjectionRegistry<T>[]): ProjectionRegistry<T>;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGrC,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;AAElD,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI;IAClC,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,wCAAwC,KAAK,CAAC;AAC3D,eAAO,MAAM,iBAAiB,EAAG,mBAA4B,CAAC;AAG9D,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,IAAI,CAAC,GAAG;IAC3E,QAAQ,EAAE,uBAAuB,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI;IACzD,EAAE,EAAE,CAAC,CAAC;IACN,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAC3B,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,EACzB,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,IACzE,CACF,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACzB,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KACtB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,MAAM,CAChE,MAAM,EACN,iBAAiB,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC5B,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,EAChE,GAAG,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,GACrC,kBAAkB,CAAC,CAAC,CAAC,CAYvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGrC,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AAEjD,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,gBAAgB,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,wCAAwC,KAAK,CAAC;AAC3D,eAAO,MAAM,iBAAiB,EAAG,mBAA4B,CAAC;AAG9D,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,IAAI,CAAC,GAAG;IAC3E,QAAQ,EAAE,uBAAuB,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,CAAC,GAAG,gBAAgB,IAAI;IACpD,EAAE,EAAE,CAAC,CAAC;IACN,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAC3B,CAAC,GAAG,gBAAgB,EACpB,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,IACzE,CACF,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACzB,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KACtB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,gBAAgB,IAAI,MAAM,CAC3D,MAAM,EACN,iBAAiB,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,EAAE,CACxD,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,gBAAgB,EAC3D,GAAG,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,GACrC,kBAAkB,CAAC,CAAC,CAAC,CAYvB"}

package/package.json

@@ -3,16 +3,16 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "2.0.2",
+  "version": "2.2.0",
   "description": "Emmett Event Store with Kysely",
   "author": "Wataru Oguchi",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/wataruoguchi/emmett-event-store-kysely.git"
+    "url": "https://github.com/wataruoguchi/emmett-libs.git"
   },
-  "homepage": "https://github.com/wataruoguchi/emmett-event-store-kysely",
-  "bugs": "https://github.com/wataruoguchi/emmett-event-store-kysely/issues",
+  "homepage": "https://github.com/wataruoguchi/emmett-libs",
+  "bugs": "https://github.com/wataruoguchi/emmett-libs/issues",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -30,17 +30,13 @@
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.build.json && tsup src/index.ts src/projections/index.ts",
     "type-check": "tsc --noEmit",
+    "tc": "npm run type-check",
     "test": "npm run type-check && vitest run",
-    "release": "semantic-release",
-    "release:dry-run": "semantic-release --dry-run"
+    "test:coverage": "vitest run --coverage"
   },
   "devDependencies": {
-    "@semantic-release/commit-analyzer": "^13.0.1",
-    "@semantic-release/github": "^11.0.6",
-    "@semantic-release/npm": "^12.0.2",
-    "@semantic-release/release-notes-generator": "^14.1.0",
+    "@types/node": "^24.9.2",
     "@vitest/coverage-v8": "^3.2.4",
-    "semantic-release": "^24.2.9",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4"