@kronos-ts/kysely 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { kyselyTransactionManager, type KyselyDatabaseLike, type KyselyTransaction, } from "./kysely-transaction-manager.js";
+export { kyselyTokenStore, type KyselyDbLike, } from "./kysely-token-store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,gBAAgB,EAChB,KAAK,YAAY,GAClB,MAAM,yBAAyB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { kyselyTransactionManager, } from "./kysely-transaction-manager.js";
+export { kyselyTokenStore, } from "./kysely-token-store.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,GAGzB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,gBAAgB,GAEjB,MAAM,yBAAyB,CAAA"}

package/dist/kysely-token-store.d.ts

@@ -0,0 +1,30 @@
+import type { TokenStore } from "@kronos-ts/messaging";
+/**
+ * A Kysely database instance (or transaction) with query methods.
+ */
+export interface KyselyDbLike {
+    selectFrom(table: string): any;
+    insertInto(table: string): any;
+    updateTable(table: string): any;
+    deleteFrom(table: string): any;
+}
+/**
+ * Creates a TokenStore backed by Kysely.
+ *
+ * Participates in the active transaction via `getActiveTransaction()`.
+ * Uses the `kronos_token_entries` table with snake_case column names.
+ *
+ * ```typescript
+ * import { kyselyTokenStore } from "@kronos-ts/kysely"
+ *
+ * // tokenStore wiring to a kronos() App is pending a typed `tokenStore` slot
+ * // (Phase 9). For now, construct the store and pass it directly to the
+ * // tracking processor that owns it:
+ * const tokenStore = kyselyTokenStore(db)
+ * ```
+ */
+export declare function kyselyTokenStore(db: KyselyDbLike, options?: {
+    claimTimeoutMs?: number;
+    tableName?: string;
+}): TokenStore;
+//# sourceMappingURL=kysely-token-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-token-store.d.ts","sourceRoot":"","sources":["../src/kysely-token-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,sBAAsB,CAAA;AAwCrE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAA;IAC9B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAA;IAC9B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAA;IAC/B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAA;CAC/B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,YAAY,EAChB,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,UAAU,CA2HZ"}

package/dist/kysely-token-store.js

@@ -0,0 +1,161 @@
+import { getActiveTransaction, UnableToClaimTokenError, globalSequenceToken } from "@kronos-ts/messaging";
+/**
+ * Token table interface for Kysely. Users must define this table in their
+ * Kysely database interface:
+ *
+ * ```typescript
+ * interface Database {
+ *   kronos_token_entries: {
+ *     processor_name: string
+ *     segment: number
+ *     mask: number
+ *     token_type: string | null
+ *     token: string | null
+ *     timestamp: string | null
+ *     owner: string | null
+ *   }
+ * }
+ * ```
+ */
+function serializeToken(token) {
+    return {
+        token_type: "GlobalSequenceToken",
+        token: JSON.stringify({ position: token.position().toString() }),
+    };
+}
+function deserializeToken(tokenType, token) {
+    if (!token || !tokenType)
+        return undefined;
+    const data = JSON.parse(token);
+    return globalSequenceToken(BigInt(data.position));
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+/**
+ * Creates a TokenStore backed by Kysely.
+ *
+ * Participates in the active transaction via `getActiveTransaction()`.
+ * Uses the `kronos_token_entries` table with snake_case column names.
+ *
+ * ```typescript
+ * import { kyselyTokenStore } from "@kronos-ts/kysely"
+ *
+ * // tokenStore wiring to a kronos() App is pending a typed `tokenStore` slot
+ * // (Phase 9). For now, construct the store and pass it directly to the
+ * // tracking processor that owns it:
+ * const tokenStore = kyselyTokenStore(db)
+ * ```
+ */
+export function kyselyTokenStore(db, options) {
+    const claimTimeoutMs = options?.claimTimeoutMs ?? 10000;
+    const table = options?.tableName ?? "kronos_token_entries";
+    function getDb() {
+        return getActiveTransaction() ?? db;
+    }
+    return {
+        async store(processorName, segment, token) {
+            const d = getDb();
+            const { token_type, token: tokenData } = serializeToken(token);
+            // Upsert via onConflict
+            await d.insertInto(table)
+                .values({ processor_name: processorName, segment, mask: 0, token_type, token: tokenData, timestamp: nowIso(), owner: null })
+                .onConflict((oc) => oc.columns(["processor_name", "segment"]).doUpdateSet({ token_type, token: tokenData, timestamp: nowIso() }))
+                .execute();
+        },
+        async get(processorName, segment) {
+            const d = getDb();
+            const row = await d.selectFrom(table)
+                .selectAll()
+                .where("processor_name", "=", processorName)
+                .where("segment", "=", segment)
+                .executeTakeFirst();
+            if (!row)
+                return undefined;
+            return deserializeToken(row.token_type, row.token);
+        },
+        async initializeSegments(processorName, segmentCount) {
+            const d = getDb();
+            for (let i = 0; i < segmentCount; i++) {
+                await d.insertInto(table)
+                    .values({ processor_name: processorName, segment: i, mask: 0, token_type: null, token: null, timestamp: null, owner: null })
+                    .onConflict((oc) => oc.columns(["processor_name", "segment"]).doNothing())
+                    .execute();
+            }
+        },
+        async claimToken(processorName, segment, ownerId) {
+            const d = getDb();
+            const row = await d.selectFrom(table)
+                .selectAll()
+                .where("processor_name", "=", processorName)
+                .where("segment", "=", segment)
+                .executeTakeFirst();
+            if (!row) {
+                await d.insertInto(table)
+                    .values({ processor_name: processorName, segment, mask: 0, token_type: null, token: null, timestamp: nowIso(), owner: ownerId })
+                    .execute();
+                return undefined;
+            }
+            const isExpired = !row.owner || !row.timestamp ||
+                (Date.now() - new Date(row.timestamp).getTime() > claimTimeoutMs);
+            if (row.owner === ownerId || isExpired) {
+                await d.updateTable(table)
+                    .set({ owner: ownerId, timestamp: nowIso() })
+                    .where("processor_name", "=", processorName)
+                    .where("segment", "=", segment)
+                    .execute();
+                return deserializeToken(row.token_type, row.token);
+            }
+            throw new UnableToClaimTokenError(processorName, segment);
+        },
+        async extendClaim(processorName, segment, ownerId) {
+            const d = getDb();
+            await d.updateTable(table)
+                .set({ timestamp: nowIso() })
+                .where("processor_name", "=", processorName)
+                .where("segment", "=", segment)
+                .where("owner", "=", ownerId)
+                .execute();
+        },
+        async releaseClaim(processorName, segment, ownerId) {
+            const d = getDb();
+            await d.updateTable(table)
+                .set({ owner: null, timestamp: null })
+                .where("processor_name", "=", processorName)
+                .where("segment", "=", segment)
+                .where("owner", "=", ownerId)
+                .execute();
+        },
+        async fetchSegments(processorName) {
+            const d = getDb();
+            const rows = await d.selectFrom(table)
+                .select("segment")
+                .where("processor_name", "=", processorName)
+                .orderBy("segment", "asc")
+                .execute();
+            return rows.map((r) => r.segment);
+        },
+        async fetchAvailableSegments(processorName) {
+            const d = getDb();
+            const cutoff = new Date(Date.now() - claimTimeoutMs).toISOString();
+            const rows = await d.selectFrom(table)
+                .select("segment")
+                .where("processor_name", "=", processorName)
+                .where((eb) => eb.or([
+                eb("owner", "is", null),
+                eb("timestamp", "<", cutoff),
+            ]))
+                .orderBy("segment", "asc")
+                .execute();
+            return rows.map((r) => r.segment);
+        },
+        async deleteToken(processorName, segment) {
+            const d = getDb();
+            await d.deleteFrom(table)
+                .where("processor_name", "=", processorName)
+                .where("segment", "=", segment)
+                .execute();
+        },
+    };
+}
+//# sourceMappingURL=kysely-token-store.js.map

package/dist/kysely-token-store.js.map

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

package/dist/kysely-transaction-manager.d.ts

@@ -0,0 +1,31 @@
+import type { TransactionManager } from "@kronos-ts/messaging";
+/**
+ * A Kysely database instance that supports transactions.
+ */
+export interface KyselyDatabaseLike {
+    transaction(): {
+        execute<T>(fn: (trx: any) => Promise<T>): Promise<T>;
+    };
+}
+/**
+ * The Kysely transaction object.
+ */
+export type KyselyTransaction = any;
+/**
+ * Creates a TransactionManager for Kysely.
+ *
+ * Bridges Kysely's `db.transaction().execute(fn)` callback pattern
+ * to the framework's `begin/commit/rollback` lifecycle.
+ *
+ * ```typescript
+ * import { Kysely } from "kysely"
+ * import { kyselyTransactionManager } from "@kronos-ts/kysely"
+ *
+ * // transactionManager wiring to a kronos() App is pending a typed
+ * // `transactionManager` slot (Phase 9). For now, construct the manager
+ * // and pass it directly into the unitOfWorkFactory composition:
+ * const txManager = kyselyTransactionManager(db)
+ * ```
+ */
+export declare function kyselyTransactionManager(db: KyselyDatabaseLike): TransactionManager<KyselyTransaction>;
+//# sourceMappingURL=kysely-transaction-manager.d.ts.map

package/dist/kysely-transaction-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-transaction-manager.d.ts","sourceRoot":"","sources":["../src/kysely-transaction-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,IAAI;QAAE,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,CAAA;CACxE;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAEnC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,kBAAkB,GACrB,kBAAkB,CAAC,iBAAiB,CAAC,CA2CvC"}

package/dist/kysely-transaction-manager.js

@@ -0,0 +1,57 @@
+/**
+ * Creates a TransactionManager for Kysely.
+ *
+ * Bridges Kysely's `db.transaction().execute(fn)` callback pattern
+ * to the framework's `begin/commit/rollback` lifecycle.
+ *
+ * ```typescript
+ * import { Kysely } from "kysely"
+ * import { kyselyTransactionManager } from "@kronos-ts/kysely"
+ *
+ * // transactionManager wiring to a kronos() App is pending a typed
+ * // `transactionManager` slot (Phase 9). For now, construct the manager
+ * // and pass it directly into the unitOfWorkFactory composition:
+ * const txManager = kyselyTransactionManager(db)
+ * ```
+ */
+export function kyselyTransactionManager(db) {
+    return {
+        async begin() {
+            let resolveTx;
+            let resolveCompletion;
+            let rejectCompletion;
+            const txReady = new Promise((resolve) => {
+                resolveTx = resolve;
+            });
+            const completionSignal = new Promise((resolve, reject) => {
+                resolveCompletion = resolve;
+                rejectCompletion = reject;
+            });
+            const txPromise = db.transaction().execute(async (trx) => {
+                resolveTx(trx);
+                await completionSignal;
+            });
+            const tx = await txReady;
+            tx.__kronos_commit = resolveCompletion;
+            tx.__kronos_rollback = rejectCompletion;
+            tx.__kronos_txPromise = txPromise;
+            return tx;
+        },
+        async commit(tx) {
+            const commit = tx.__kronos_commit;
+            const txPromise = tx.__kronos_txPromise;
+            commit();
+            await txPromise;
+        },
+        async rollback(tx) {
+            const rollback = tx.__kronos_rollback;
+            const txPromise = tx.__kronos_txPromise;
+            rollback(new Error("Transaction rolled back"));
+            try {
+                await txPromise;
+            }
+            catch { /* expected */ }
+        },
+    };
+}
+//# sourceMappingURL=kysely-transaction-manager.js.map

package/dist/kysely-transaction-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-transaction-manager.js","sourceRoot":"","sources":["../src/kysely-transaction-manager.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,wBAAwB,CACtC,EAAsB;IAEtB,OAAO;QACL,KAAK,CAAC,KAAK;YACT,IAAI,SAA2C,CAAA;YAC/C,IAAI,iBAA8B,CAAA;YAClC,IAAI,gBAA2C,CAAA;YAE/C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAoB,CAAC,OAAO,EAAE,EAAE;gBACzD,SAAS,GAAG,OAAO,CAAA;YACrB,CAAC,CAAC,CAAA;YAEF,MAAM,gBAAgB,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC7D,iBAAiB,GAAG,OAAO,CAAA;gBAC3B,gBAAgB,GAAG,MAAM,CAAA;YAC3B,CAAC,CAAC,CAAA;YAEF,MAAM,SAAS,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACvD,SAAS,CAAC,GAAG,CAAC,CAAA;gBACd,MAAM,gBAAgB,CAAA;YACxB,CAAC,CAAC,CAAA;YAEF,MAAM,EAAE,GAAG,MAAM,OAAO,CACvB;YAAC,EAAU,CAAC,eAAe,GAAG,iBAAiB,CAC/C;YAAC,EAAU,CAAC,iBAAiB,GAAG,gBAAgB,CAChD;YAAC,EAAU,CAAC,kBAAkB,GAAG,SAAS,CAAA;YAE3C,OAAO,EAAE,CAAA;QACX,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAqB;YAChC,MAAM,MAAM,GAAI,EAAU,CAAC,eAA6B,CAAA;YACxD,MAAM,SAAS,GAAI,EAAU,CAAC,kBAAmC,CAAA;YACjE,MAAM,EAAE,CAAA;YACR,MAAM,SAAS,CAAA;QACjB,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,EAAqB;YAClC,MAAM,QAAQ,GAAI,EAAU,CAAC,iBAA6C,CAAA;YAC1E,MAAM,SAAS,GAAI,EAAU,CAAC,kBAAmC,CAAA;YACjE,QAAQ,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAA;YAC9C,IAAI,CAAC;gBAAC,MAAM,SAAS,CAAA;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;QAClD,CAAC;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@kronos-ts/kysely",
+  "version": "0.1.0",
+  "description": "Kysely extension for Kronos.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "author": "Theo Emanuelsson",
+  "homepage": "https://github.com/KronosDB/kronos-ts/tree/main/packages/extensions/kysely#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KronosDB/kronos-ts.git",
+    "directory": "packages/extensions/kysely"
+  },
+  "bugs": {
+    "url": "https://github.com/KronosDB/kronos-ts/issues"
+  },
+  "keywords": [
+    "kronos",
+    "event-sourcing",
+    "cqrs",
+    "dcb",
+    "typescript",
+    "kysely"
+  ],
+  "sideEffects": false,
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "files": [
+    "dist",
+    "src",
+    "!src/**/__tests__",
+    "!src/**/*.test.ts",
+    "!src/**/*.bench.ts"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "publishConfig": {
+    "access": "public",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "dependencies": {
+    "@kronos-ts/common": "workspace:*",
+    "@kronos-ts/messaging": "workspace:*"
+  },
+  "peerDependencies": {
+    "kysely": ">=0.27.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,10 @@
+export {
+  kyselyTransactionManager,
+  type KyselyDatabaseLike,
+  type KyselyTransaction,
+} from "./kysely-transaction-manager.js"
+
+export {
+  kyselyTokenStore,
+  type KyselyDbLike,
+} from "./kysely-token-store.js"

package/src/kysely-token-store.ts

@@ -0,0 +1,192 @@
+import type { TokenStore, TrackingToken } from "@kronos-ts/messaging"
+import { getActiveTransaction, UnableToClaimTokenError, globalSequenceToken } from "@kronos-ts/messaging"
+import type { KyselyTransaction } from "./kysely-transaction-manager.js"
+
+/**
+ * Token table interface for Kysely. Users must define this table in their
+ * Kysely database interface:
+ *
+ * ```typescript
+ * interface Database {
+ *   kronos_token_entries: {
+ *     processor_name: string
+ *     segment: number
+ *     mask: number
+ *     token_type: string | null
+ *     token: string | null
+ *     timestamp: string | null
+ *     owner: string | null
+ *   }
+ * }
+ * ```
+ */
+
+function serializeToken(token: TrackingToken): { token_type: string; token: string } {
+  return {
+    token_type: "GlobalSequenceToken",
+    token: JSON.stringify({ position: token.position().toString() }),
+  }
+}
+
+function deserializeToken(tokenType: string | null, token: string | null): TrackingToken | undefined {
+  if (!token || !tokenType) return undefined
+  const data = JSON.parse(token)
+  return globalSequenceToken(BigInt(data.position))
+}
+
+function nowIso(): string {
+  return new Date().toISOString()
+}
+
+/**
+ * A Kysely database instance (or transaction) with query methods.
+ */
+export interface KyselyDbLike {
+  selectFrom(table: string): any
+  insertInto(table: string): any
+  updateTable(table: string): any
+  deleteFrom(table: string): any
+}
+
+/**
+ * Creates a TokenStore backed by Kysely.
+ *
+ * Participates in the active transaction via `getActiveTransaction()`.
+ * Uses the `kronos_token_entries` table with snake_case column names.
+ *
+ * ```typescript
+ * import { kyselyTokenStore } from "@kronos-ts/kysely"
+ *
+ * // tokenStore wiring to a kronos() App is pending a typed `tokenStore` slot
+ * // (Phase 9). For now, construct the store and pass it directly to the
+ * // tracking processor that owns it:
+ * const tokenStore = kyselyTokenStore(db)
+ * ```
+ */
+export function kyselyTokenStore(
+  db: KyselyDbLike,
+  options?: { claimTimeoutMs?: number; tableName?: string },
+): TokenStore {
+  const claimTimeoutMs = options?.claimTimeoutMs ?? 10000
+  const table = options?.tableName ?? "kronos_token_entries"
+
+  function getDb(): KyselyDbLike {
+    return getActiveTransaction<KyselyTransaction>() ?? db
+  }
+
+  return {
+    async store(processorName, segment, token) {
+      const d = getDb()
+      const { token_type, token: tokenData } = serializeToken(token)
+      // Upsert via onConflict
+      await d.insertInto(table)
+        .values({ processor_name: processorName, segment, mask: 0, token_type, token: tokenData, timestamp: nowIso(), owner: null })
+        .onConflict((oc: any) => oc.columns(["processor_name", "segment"]).doUpdateSet({ token_type, token: tokenData, timestamp: nowIso() }))
+        .execute()
+    },
+
+    async get(processorName, segment) {
+      const d = getDb()
+      const row = await d.selectFrom(table)
+        .selectAll()
+        .where("processor_name", "=", processorName)
+        .where("segment", "=", segment)
+        .executeTakeFirst()
+      if (!row) return undefined
+      return deserializeToken(row.token_type, row.token)
+    },
+
+    async initializeSegments(processorName, segmentCount) {
+      const d = getDb()
+      for (let i = 0; i < segmentCount; i++) {
+        await d.insertInto(table)
+          .values({ processor_name: processorName, segment: i, mask: 0, token_type: null, token: null, timestamp: null, owner: null })
+          .onConflict((oc: any) => oc.columns(["processor_name", "segment"]).doNothing())
+          .execute()
+      }
+    },
+
+    async claimToken(processorName, segment, ownerId) {
+      const d = getDb()
+      const row = await d.selectFrom(table)
+        .selectAll()
+        .where("processor_name", "=", processorName)
+        .where("segment", "=", segment)
+        .executeTakeFirst()
+
+      if (!row) {
+        await d.insertInto(table)
+          .values({ processor_name: processorName, segment, mask: 0, token_type: null, token: null, timestamp: nowIso(), owner: ownerId })
+          .execute()
+        return undefined
+      }
+
+      const isExpired = !row.owner || !row.timestamp ||
+        (Date.now() - new Date(row.timestamp).getTime() > claimTimeoutMs)
+
+      if (row.owner === ownerId || isExpired) {
+        await d.updateTable(table)
+          .set({ owner: ownerId, timestamp: nowIso() })
+          .where("processor_name", "=", processorName)
+          .where("segment", "=", segment)
+          .execute()
+        return deserializeToken(row.token_type, row.token)
+      }
+
+      throw new UnableToClaimTokenError(processorName, segment)
+    },
+
+    async extendClaim(processorName, segment, ownerId) {
+      const d = getDb()
+      await d.updateTable(table)
+        .set({ timestamp: nowIso() })
+        .where("processor_name", "=", processorName)
+        .where("segment", "=", segment)
+        .where("owner", "=", ownerId)
+        .execute()
+    },
+
+    async releaseClaim(processorName, segment, ownerId) {
+      const d = getDb()
+      await d.updateTable(table)
+        .set({ owner: null, timestamp: null })
+        .where("processor_name", "=", processorName)
+        .where("segment", "=", segment)
+        .where("owner", "=", ownerId)
+        .execute()
+    },
+
+    async fetchSegments(processorName) {
+      const d = getDb()
+      const rows = await d.selectFrom(table)
+        .select("segment")
+        .where("processor_name", "=", processorName)
+        .orderBy("segment", "asc")
+        .execute()
+      return rows.map((r: any) => r.segment)
+    },
+
+    async fetchAvailableSegments(processorName) {
+      const d = getDb()
+      const cutoff = new Date(Date.now() - claimTimeoutMs).toISOString()
+      const rows = await d.selectFrom(table)
+        .select("segment")
+        .where("processor_name", "=", processorName)
+        .where((eb: any) => eb.or([
+          eb("owner", "is", null),
+          eb("timestamp", "<", cutoff),
+        ]))
+        .orderBy("segment", "asc")
+        .execute()
+      return rows.map((r: any) => r.segment)
+    },
+
+    async deleteToken(processorName, segment) {
+      const d = getDb()
+      await d.deleteFrom(table)
+        .where("processor_name", "=", processorName)
+        .where("segment", "=", segment)
+        .execute()
+    },
+  }
+}

package/src/kysely-transaction-manager.ts

@@ -0,0 +1,76 @@
+import type { TransactionManager } from "@kronos-ts/messaging"
+
+/**
+ * A Kysely database instance that supports transactions.
+ */
+export interface KyselyDatabaseLike {
+  transaction(): { execute<T>(fn: (trx: any) => Promise<T>): Promise<T> }
+}
+
+/**
+ * The Kysely transaction object.
+ */
+export type KyselyTransaction = any
+
+/**
+ * Creates a TransactionManager for Kysely.
+ *
+ * Bridges Kysely's `db.transaction().execute(fn)` callback pattern
+ * to the framework's `begin/commit/rollback` lifecycle.
+ *
+ * ```typescript
+ * import { Kysely } from "kysely"
+ * import { kyselyTransactionManager } from "@kronos-ts/kysely"
+ *
+ * // transactionManager wiring to a kronos() App is pending a typed
+ * // `transactionManager` slot (Phase 9). For now, construct the manager
+ * // and pass it directly into the unitOfWorkFactory composition:
+ * const txManager = kyselyTransactionManager(db)
+ * ```
+ */
+export function kyselyTransactionManager(
+  db: KyselyDatabaseLike,
+): TransactionManager<KyselyTransaction> {
+  return {
+    async begin(): Promise<KyselyTransaction> {
+      let resolveTx!: (tx: KyselyTransaction) => void
+      let resolveCompletion!: () => void
+      let rejectCompletion!: (error: unknown) => void
+
+      const txReady = new Promise<KyselyTransaction>((resolve) => {
+        resolveTx = resolve
+      })
+
+      const completionSignal = new Promise<void>((resolve, reject) => {
+        resolveCompletion = resolve
+        rejectCompletion = reject
+      })
+
+      const txPromise = db.transaction().execute(async (trx) => {
+        resolveTx(trx)
+        await completionSignal
+      })
+
+      const tx = await txReady
+      ;(tx as any).__kronos_commit = resolveCompletion
+      ;(tx as any).__kronos_rollback = rejectCompletion
+      ;(tx as any).__kronos_txPromise = txPromise
+
+      return tx
+    },
+
+    async commit(tx: KyselyTransaction): Promise<void> {
+      const commit = (tx as any).__kronos_commit as () => void
+      const txPromise = (tx as any).__kronos_txPromise as Promise<void>
+      commit()
+      await txPromise
+    },
+
+    async rollback(tx: KyselyTransaction): Promise<void> {
+      const rollback = (tx as any).__kronos_rollback as (error: unknown) => void
+      const txPromise = (tx as any).__kronos_txPromise as Promise<void>
+      rollback(new Error("Transaction rolled back"))
+      try { await txPromise } catch { /* expected */ }
+    },
+  }
+}