@kyneta/leveldb-store 1.2.0 → 1.3.1

package/dist/server.d.ts

@@ -1,5 +1,4 @@
-import { Store, StoreEntry } from '@kyneta/exchange/src/store/store.js';
-import { DocId } from '@kyneta/exchange/src/types.js';
+import { Store, DocId, StoreEntry } from '@kyneta/exchange';
 import { DocMetadata } from '@kyneta/schema';
 
 declare function encodeStoreEntry(entry: StoreEntry): Uint8Array;

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.ts"],"sourcesContent":["// server — LevelDB storage backend for @kyneta/exchange.\n//\n// Implements the Store interface using classic-level.\n//\n// Key-space design (FoundationDB convention — \\x00 null-byte separator):\n//   meta\\x00{docId}                    → JSON-encoded DocMetadata\n//   entry\\x00{docId}\\x00{seqNo}       → binary-encoded StoreEntry\n//\n// The \\x00 separator cannot appear in valid UTF-8 strings, so no docId\n// validation is needed — the key-space imposes zero constraints on callers.\n//\n// SeqNo is a zero-padded 10-digit monotonic counter per doc, tracked in\n// memory. On reboot, the max seqNo for a doc is lazily discovered via a\n// single reverse-iterator seek on first append.\n\nimport type { Store, StoreEntry } from \"@kyneta/exchange/src/store/store.js\"\nimport type { DocId } from \"@kyneta/exchange/src/types.js\"\nimport type { DocMetadata } from \"@kyneta/schema\"\nimport { ClassicLevel } from \"classic-level\"\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst SEP = \"\\x00\"\nconst META_PREFIX = `meta${SEP}`\nconst ENTRY_PREFIX = `entry${SEP}`\nconst SEQ_PAD = 10\n\n// ---------------------------------------------------------------------------\n// Binary envelope — pure encode/decode for StoreEntry\n// ---------------------------------------------------------------------------\n\n// Flags byte layout:\n//   bit 0: kind        (0 = entirety, 1 = since)\n//   bit 1: encoding    (0 = json, 1 = binary)\n//   bit 2: data type   (0 = string, 1 = Uint8Array)\n//\n// Layout: [1 byte flags] [4 bytes version length BE] [N bytes version UTF-8] [remaining: payload data]\n\nconst encoder = new TextEncoder()\nconst decoder = new TextDecoder()\n\nexport function encodeStoreEntry(entry: StoreEntry): Uint8Array {\n  const { payload, version } = entry\n\n  let flags = 0\n  if (payload.kind === \"since\") flags |= 0x01\n  if (payload.encoding === \"binary\") flags |= 0x02\n\n  const isDataBinary = payload.data instanceof Uint8Array\n  if (isDataBinary) flags |= 0x04\n\n  const versionBytes = encoder.encode(version)\n  const dataBytes = isDataBinary\n    ? (payload.data as Uint8Array)\n    : encoder.encode(payload.data as string)\n\n  const buf = new Uint8Array(1 + 4 + versionBytes.length + dataBytes.length)\n  const view = new DataView(buf.buffer)\n\n  buf[0] = flags\n  view.setUint32(1, versionBytes.length, false) // big-endian\n  buf.set(versionBytes, 5)\n  buf.set(dataBytes, 5 + versionBytes.length)\n\n  return buf\n}\n\nexport function decodeStoreEntry(bytes: Uint8Array): StoreEntry {\n  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength)\n\n  const flagByte = bytes[0]\n  if (flagByte === undefined) throw new Error(\"empty store entry bytes\")\n  const flags = flagByte\n  const kind = (flags & 0x01) !== 0 ? \"since\" : \"entirety\"\n  const encoding = (flags & 0x02) !== 0 ? \"binary\" : \"json\"\n  const isDataBinary = (flags & 0x04) !== 0\n\n  const versionLen = view.getUint32(1, false)\n  const version = decoder.decode(bytes.subarray(5, 5 + versionLen))\n\n  const dataStart = 5 + versionLen\n  const rawData = bytes.subarray(dataStart)\n\n  const data: string | Uint8Array = isDataBinary\n    ? new Uint8Array(rawData)\n    : decoder.decode(rawData)\n\n  return {\n    payload: { kind, encoding, data },\n    version,\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Key helpers\n// ---------------------------------------------------------------------------\n\nfunction metaKey(docId: DocId): string {\n  return `${META_PREFIX}${docId}`\n}\n\nfunction entryPrefix(docId: DocId): string {\n  return `${ENTRY_PREFIX}${docId}${SEP}`\n}\n\nfunction entryKey(docId: DocId, seqNo: number): string {\n  return `${entryPrefix(docId)}${String(seqNo).padStart(SEQ_PAD, \"0\")}`\n}\n\nfunction parseDocIdFromMetaKey(key: string): DocId {\n  return key.slice(META_PREFIX.length)\n}\n\nfunction parseSeqNoFromEntryKey(key: string, docId: DocId): number {\n  const prefix = entryPrefix(docId)\n  return Number.parseInt(key.slice(prefix.length), 10)\n}\n\n// ---------------------------------------------------------------------------\n// LevelDBStore\n// ---------------------------------------------------------------------------\n\nexport class LevelDBStore implements Store {\n  readonly #db: ClassicLevel<string, Uint8Array>\n  readonly #seqNos: Map<DocId, number> = new Map()\n\n  constructor(dbPath: string) {\n    this.#db = new ClassicLevel(dbPath, {\n      valueEncoding: \"binary\",\n    })\n  }\n\n  // -------------------------------------------------------------------------\n  // Private — seqNo management\n  // -------------------------------------------------------------------------\n\n  /**\n   * Get the next seqNo for a doc. On first call after reboot, discovers\n   * the max existing seqNo via a single reverse-iterator seek.\n   */\n  async #nextSeqNo(docId: DocId): Promise<number> {\n    const cached = this.#seqNos.get(docId)\n    if (cached !== undefined) {\n      const next = cached + 1\n      this.#seqNos.set(docId, next)\n      return next\n    }\n\n    // Lazy discovery: reverse iterate to find the highest existing seqNo\n    const prefix = entryPrefix(docId)\n    let maxSeq = -1\n    for await (const key of this.#db.keys({\n      gte: prefix,\n      lt: `${prefix}\\xff`,\n      reverse: true,\n      limit: 1,\n    })) {\n      maxSeq = parseSeqNoFromEntryKey(key, docId)\n    }\n\n    const next = maxSeq + 1\n    this.#seqNos.set(docId, next)\n    return next\n  }\n\n  // -------------------------------------------------------------------------\n  // Store interface\n  // -------------------------------------------------------------------------\n\n  async lookup(docId: DocId): Promise<DocMetadata | null> {\n    try {\n      const raw = await this.#db.get(metaKey(docId))\n      return JSON.parse(decoder.decode(raw)) as DocMetadata\n    } catch (error: any) {\n      if (error.code === \"LEVEL_NOT_FOUND\") return null\n      throw error\n    }\n  }\n\n  async ensureDoc(docId: DocId, metadata: DocMetadata): Promise<void> {\n    try {\n      await this.#db.get(metaKey(docId))\n      // Already exists — no-op (first call wins)\n    } catch (error: any) {\n      if (error.code === \"LEVEL_NOT_FOUND\") {\n        await this.#db.put(\n          metaKey(docId),\n          encoder.encode(JSON.stringify(metadata)),\n        )\n        return\n      }\n      throw error\n    }\n  }\n\n  async append(docId: DocId, entry: StoreEntry): Promise<void> {\n    const seq = await this.#nextSeqNo(docId)\n    await this.#db.put(entryKey(docId, seq), encodeStoreEntry(entry))\n  }\n\n  async *loadAll(docId: DocId): AsyncIterable<StoreEntry> {\n    const prefix = entryPrefix(docId)\n    for await (const value of this.#db.values({\n      gte: prefix,\n      lt: `${prefix}\\xff`,\n    })) {\n      yield decodeStoreEntry(value)\n    }\n  }\n\n  async replace(docId: DocId, entry: StoreEntry): Promise<void> {\n    const prefix = entryPrefix(docId)\n\n    // Collect keys to delete\n    const keysToDelete: string[] = []\n    for await (const key of this.#db.keys({\n      gte: prefix,\n      lt: `${prefix}\\xff`,\n    })) {\n      keysToDelete.push(key)\n    }\n\n    // Atomic batch: delete all existing entries + write the single replacement\n    const ops: Array<\n      | { type: \"del\"; key: string }\n      | { type: \"put\"; key: string; value: Uint8Array }\n    > = keysToDelete.map(key => ({ type: \"del\" as const, key }))\n    ops.push({\n      type: \"put\",\n      key: entryKey(docId, 0),\n      value: encodeStoreEntry(entry),\n    })\n    await this.#db.batch(ops)\n\n    // Reset seqNo counter\n    this.#seqNos.set(docId, 0)\n  }\n\n  async delete(docId: DocId): Promise<void> {\n    const prefix = entryPrefix(docId)\n\n    // Collect entry keys to delete\n    const keysToDelete: string[] = [metaKey(docId)]\n    for await (const key of this.#db.keys({\n      gte: prefix,\n      lt: `${prefix}\\xff`,\n    })) {\n      keysToDelete.push(key)\n    }\n\n    await this.#db.batch(\n      keysToDelete.map(key => ({ type: \"del\" as const, key })),\n    )\n\n    // Remove from in-memory seqNo tracker\n    this.#seqNos.delete(docId)\n  }\n\n  async *listDocIds(): AsyncIterable<DocId> {\n    for await (const key of this.#db.keys({\n      gte: META_PREFIX,\n      lt: `${META_PREFIX}\\xff`,\n    })) {\n      yield parseDocIdFromMetaKey(key)\n    }\n  }\n\n  async close(): Promise<void> {\n    await this.#db.close()\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory function\n// ---------------------------------------------------------------------------\n\n/**\n * Create a LevelDB storage backend for server-side persistence.\n *\n * Returns a `Store` — pass directly to `Exchange({ stores: [...] })`.\n *\n * @param dbPath - Directory path where LevelDB stores its files\n *\n * @example\n * ```typescript\n * import { createLevelDBStore } from \"@kyneta/leveldb-store/server\"\n *\n * const exchange = new Exchange({\n *   stores: [createLevelDBStore(\"./data/exchange-db\")],\n * })\n * ```\n */\nexport function createLevelDBStore(dbPath: string): Store {\n  return new LevelDBStore(dbPath)\n}\n"],"mappings":"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","names":["next"]}
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["// server — LevelDB storage backend for @kyneta/exchange.\n//\n// Implements the Store interface using classic-level.\n//\n// Key-space design (FoundationDB convention — \\x00 null-byte separator):\n//   meta\\x00{docId}                    → JSON-encoded DocMetadata\n//   entry\\x00{docId}\\x00{seqNo}       → binary-encoded StoreEntry\n//\n// The \\x00 separator cannot appear in valid UTF-8 strings, so no docId\n// validation is needed — the key-space imposes zero constraints on callers.\n//\n// SeqNo is a zero-padded 10-digit monotonic counter per doc, tracked in\n// memory. On reboot, the max seqNo for a doc is lazily discovered via a\n// single reverse-iterator seek on first append.\n\nimport type { DocId, Store, StoreEntry } from \"@kyneta/exchange\"\nimport type { DocMetadata } from \"@kyneta/schema\"\nimport { ClassicLevel } from \"classic-level\"\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst SEP = \"\\x00\"\nconst META_PREFIX = `meta${SEP}`\nconst ENTRY_PREFIX = `entry${SEP}`\nconst SEQ_PAD = 10\n\n// ---------------------------------------------------------------------------\n// Binary envelope — pure encode/decode for StoreEntry\n// ---------------------------------------------------------------------------\n\n// Flags byte layout:\n//   bit 0: kind        (0 = entirety, 1 = since)\n//   bit 1: encoding    (0 = json, 1 = binary)\n//   bit 2: data type   (0 = string, 1 = Uint8Array)\n//\n// Layout: [1 byte flags] [4 bytes version length BE] [N bytes version UTF-8] [remaining: payload data]\n\nconst encoder = new TextEncoder()\nconst decoder = new TextDecoder()\n\nexport function encodeStoreEntry(entry: StoreEntry): Uint8Array {\n  const { payload, version } = entry\n\n  let flags = 0\n  if (payload.kind === \"since\") flags |= 0x01\n  if (payload.encoding === \"binary\") flags |= 0x02\n\n  const isDataBinary = payload.data instanceof Uint8Array\n  if (isDataBinary) flags |= 0x04\n\n  const versionBytes = encoder.encode(version)\n  const dataBytes = isDataBinary\n    ? (payload.data as Uint8Array)\n    : encoder.encode(payload.data as string)\n\n  const buf = new Uint8Array(1 + 4 + versionBytes.length + dataBytes.length)\n  const view = new DataView(buf.buffer)\n\n  buf[0] = flags\n  view.setUint32(1, versionBytes.length, false) // big-endian\n  buf.set(versionBytes, 5)\n  buf.set(dataBytes, 5 + versionBytes.length)\n\n  return buf\n}\n\nexport function decodeStoreEntry(bytes: Uint8Array): StoreEntry {\n  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength)\n\n  const flagByte = bytes[0]\n  if (flagByte === undefined) throw new Error(\"empty store entry bytes\")\n  const flags = flagByte\n  const kind = (flags & 0x01) !== 0 ? \"since\" : \"entirety\"\n  const encoding = (flags & 0x02) !== 0 ? \"binary\" : \"json\"\n  const isDataBinary = (flags & 0x04) !== 0\n\n  const versionLen = view.getUint32(1, false)\n  const version = decoder.decode(bytes.subarray(5, 5 + versionLen))\n\n  const dataStart = 5 + versionLen\n  const rawData = bytes.subarray(dataStart)\n\n  const data: string | Uint8Array = isDataBinary\n    ? new Uint8Array(rawData)\n    : decoder.decode(rawData)\n\n  return {\n    payload: { kind, encoding, data },\n    version,\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Key helpers\n// ---------------------------------------------------------------------------\n\nfunction metaKey(docId: DocId): string {\n  return `${META_PREFIX}${docId}`\n}\n\nfunction entryPrefix(docId: DocId): string {\n  return `${ENTRY_PREFIX}${docId}${SEP}`\n}\n\nfunction entryKey(docId: DocId, seqNo: number): string {\n  return `${entryPrefix(docId)}${String(seqNo).padStart(SEQ_PAD, \"0\")}`\n}\n\nfunction parseDocIdFromMetaKey(key: string): DocId {\n  return key.slice(META_PREFIX.length)\n}\n\nfunction parseSeqNoFromEntryKey(key: string, docId: DocId): number {\n  const prefix = entryPrefix(docId)\n  return Number.parseInt(key.slice(prefix.length), 10)\n}\n\n// ---------------------------------------------------------------------------\n// LevelDBStore\n// ---------------------------------------------------------------------------\n\nexport class LevelDBStore implements Store {\n  readonly #db: ClassicLevel<string, Uint8Array>\n  readonly #seqNos: Map<DocId, number> = new Map()\n\n  constructor(dbPath: string) {\n    this.#db = new ClassicLevel(dbPath, {\n      valueEncoding: \"binary\",\n    })\n  }\n\n  // -------------------------------------------------------------------------\n  // Private — seqNo management\n  // -------------------------------------------------------------------------\n\n  /**\n   * Get the next seqNo for a doc. On first call after reboot, discovers\n   * the max existing seqNo via a single reverse-iterator seek.\n   */\n  async #nextSeqNo(docId: DocId): Promise<number> {\n    const cached = this.#seqNos.get(docId)\n    if (cached !== undefined) {\n      const next = cached + 1\n      this.#seqNos.set(docId, next)\n      return next\n    }\n\n    // Lazy discovery: reverse iterate to find the highest existing seqNo\n    const prefix = entryPrefix(docId)\n    let maxSeq = -1\n    for await (const key of this.#db.keys({\n      gte: prefix,\n      lt: `${prefix}\\xff`,\n      reverse: true,\n      limit: 1,\n    })) {\n      maxSeq = parseSeqNoFromEntryKey(key, docId)\n    }\n\n    const next = maxSeq + 1\n    this.#seqNos.set(docId, next)\n    return next\n  }\n\n  // -------------------------------------------------------------------------\n  // Store interface\n  // -------------------------------------------------------------------------\n\n  async lookup(docId: DocId): Promise<DocMetadata | null> {\n    try {\n      const raw = await this.#db.get(metaKey(docId))\n      return JSON.parse(decoder.decode(raw)) as DocMetadata\n    } catch (error: any) {\n      if (error.code === \"LEVEL_NOT_FOUND\") return null\n      throw error\n    }\n  }\n\n  async ensureDoc(docId: DocId, metadata: DocMetadata): Promise<void> {\n    try {\n      await this.#db.get(metaKey(docId))\n      // Already exists — no-op (first call wins)\n    } catch (error: any) {\n      if (error.code === \"LEVEL_NOT_FOUND\") {\n        await this.#db.put(\n          metaKey(docId),\n          encoder.encode(JSON.stringify(metadata)),\n        )\n        return\n      }\n      throw error\n    }\n  }\n\n  async append(docId: DocId, entry: StoreEntry): Promise<void> {\n    const seq = await this.#nextSeqNo(docId)\n    await this.#db.put(entryKey(docId, seq), encodeStoreEntry(entry))\n  }\n\n  async *loadAll(docId: DocId): AsyncIterable<StoreEntry> {\n    const prefix = entryPrefix(docId)\n    for await (const value of this.#db.values({\n      gte: prefix,\n      lt: `${prefix}\\xff`,\n    })) {\n      yield decodeStoreEntry(value)\n    }\n  }\n\n  async replace(docId: DocId, entry: StoreEntry): Promise<void> {\n    const prefix = entryPrefix(docId)\n\n    // Collect keys to delete\n    const keysToDelete: string[] = []\n    for await (const key of this.#db.keys({\n      gte: prefix,\n      lt: `${prefix}\\xff`,\n    })) {\n      keysToDelete.push(key)\n    }\n\n    // Atomic batch: delete all existing entries + write the single replacement\n    const ops: Array<\n      | { type: \"del\"; key: string }\n      | { type: \"put\"; key: string; value: Uint8Array }\n    > = keysToDelete.map(key => ({ type: \"del\" as const, key }))\n    ops.push({\n      type: \"put\",\n      key: entryKey(docId, 0),\n      value: encodeStoreEntry(entry),\n    })\n    await this.#db.batch(ops)\n\n    // Reset seqNo counter\n    this.#seqNos.set(docId, 0)\n  }\n\n  async delete(docId: DocId): Promise<void> {\n    const prefix = entryPrefix(docId)\n\n    // Collect entry keys to delete\n    const keysToDelete: string[] = [metaKey(docId)]\n    for await (const key of this.#db.keys({\n      gte: prefix,\n      lt: `${prefix}\\xff`,\n    })) {\n      keysToDelete.push(key)\n    }\n\n    await this.#db.batch(\n      keysToDelete.map(key => ({ type: \"del\" as const, key })),\n    )\n\n    // Remove from in-memory seqNo tracker\n    this.#seqNos.delete(docId)\n  }\n\n  async *listDocIds(): AsyncIterable<DocId> {\n    for await (const key of this.#db.keys({\n      gte: META_PREFIX,\n      lt: `${META_PREFIX}\\xff`,\n    })) {\n      yield parseDocIdFromMetaKey(key)\n    }\n  }\n\n  async close(): Promise<void> {\n    await this.#db.close()\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory function\n// ---------------------------------------------------------------------------\n\n/**\n * Create a LevelDB storage backend for server-side persistence.\n *\n * Returns a `Store` — pass directly to `Exchange({ stores: [...] })`.\n *\n * @param dbPath - Directory path where LevelDB stores its files\n *\n * @example\n * ```typescript\n * import { createLevelDBStore } from \"@kyneta/leveldb-store/server\"\n *\n * const exchange = new Exchange({\n *   stores: [createLevelDBStore(\"./data/exchange-db\")],\n * })\n * ```\n */\nexport function createLevelDBStore(dbPath: string): Store {\n  return new LevelDBStore(dbPath)\n}\n"],"mappings":"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","names":["next"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kyneta/leveldb-store",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "LevelDB storage backend for @kyneta/exchange — server-side persistent storage",
   "author": "Duane Johnson",
   "license": "MIT",
@@ -25,8 +25,8 @@
     "./src/*": "./src/*"
   },
   "peerDependencies": {
-    "@kyneta/exchange": "^1.2.0",
-    "@kyneta/schema": "^1.2.0"
+    "@kyneta/exchange": "^1.3.1",
+    "@kyneta/schema": "^1.3.1"
   },
   "dependencies": {
     "classic-level": "^1.4.1"
@@ -36,8 +36,8 @@
     "tsup": "^8.5.0",
     "typescript": "^5.9.2",
     "vitest": "^4.0.17",
-    "@kyneta/schema": "^1.2.0",
-    "@kyneta/exchange": "^1.2.0"
+    "@kyneta/exchange": "^1.3.1",
+    "@kyneta/schema": "^1.3.1"
   },
   "scripts": {
     "build": "tsup",

package/src/__tests__/leveldb-storage.test.ts

@@ -7,13 +7,13 @@
 import * as fs from "node:fs"
 import * as os from "node:os"
 import * as path from "node:path"
-import type { StoreEntry } from "@kyneta/exchange/src/store/store.js"
+import type { StoreEntry } from "@kyneta/exchange"
 import {
   collectAll,
   describeStore,
   makeEntry,
   plainMetadata,
-} from "@kyneta/exchange/src/testing/store-conformance.js"
+} from "@kyneta/exchange/testing"
 import { afterAll, describe, expect, it } from "vitest"
 import { decodeStoreEntry, encodeStoreEntry, LevelDBStore } from "../server.js"
 

package/src/server.ts

@@ -13,8 +13,7 @@
 // memory. On reboot, the max seqNo for a doc is lazily discovered via a
 // single reverse-iterator seek on first append.
 
-import type { Store, StoreEntry } from "@kyneta/exchange/src/store/store.js"
-import type { DocId } from "@kyneta/exchange/src/types.js"
+import type { DocId, Store, StoreEntry } from "@kyneta/exchange"
 import type { DocMetadata } from "@kyneta/schema"
 import { ClassicLevel } from "classic-level"