@graphrefly/ts 0.0.0

package/dist/storage/node.js

@@ -0,0 +1,402 @@
+import {
+  appendLogStorage
+} from "../chunk-6PHB5CJS.js";
+import {
+  kvStorage
+} from "../chunk-DKP56CSW.js";
+import "../chunk-4VLAQHZI.js";
+
+// src/storage/node.ts
+import { randomBytes } from "crypto";
+import {
+  closeSync,
+  mkdirSync,
+  openSync,
+  readdirSync,
+  readFileSync,
+  renameSync,
+  unlinkSync,
+  writeFileSync
+} from "fs";
+import { createRequire } from "module";
+import { basename, dirname, join } from "path";
+var FILE_STEM_PREFIX = "k-";
+var NAMESPACE_SEPARATOR = "\0";
+var SQLITE_GENERATION = /* @__PURE__ */ Symbol("graphrefly.sqliteBackend.generation");
+var encoder = new TextEncoder();
+var decoder = new TextDecoder("utf-8", { fatal: true });
+var require2 = createRequire("/graphrefly-storage-node.js");
+function isErrno(error, code) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === code;
+}
+function keyToStem(key) {
+  let out = "";
+  for (const ch of key) {
+    if (/^[a-zA-Z0-9_-]$/.test(ch)) {
+      out += ch;
+      continue;
+    }
+    for (const byte of encoder.encode(ch)) out += `%${byte.toString(16).padStart(2, "0")}`;
+  }
+  return out;
+}
+function stemToKey(stem) {
+  const bytes = [];
+  let i = 0;
+  while (i < stem.length) {
+    const ch = stem[i];
+    if (ch === "%" && i + 2 < stem.length) {
+      const hex = stem.slice(i + 1, i + 3);
+      if (/^[0-9a-f]{2}$/i.test(hex)) {
+        bytes.push(Number.parseInt(hex, 16));
+        i += 3;
+        continue;
+      }
+    }
+    const code = ch.charCodeAt(0);
+    if (code > 127) return null;
+    bytes.push(code);
+    i += 1;
+  }
+  try {
+    return decoder.decode(new Uint8Array(bytes));
+  } catch {
+    return null;
+  }
+}
+function validateExtension(extension) {
+  if (extension.length < 2 || !extension.startsWith(".") || extension.includes("..") || /[/\\\0]/.test(extension) || !/^[.A-Za-z0-9_-]+$/.test(extension)) {
+    throw new TypeError("fileBackend: extension must be a simple suffix such as .bin");
+  }
+  return extension;
+}
+function validateNamespace(label, namespace) {
+  if (typeof namespace !== "string") {
+    throw new TypeError(`${label}: namespace must be a string`);
+  }
+  if (namespace.includes(NAMESPACE_SEPARATOR)) {
+    throw new TypeError(`${label}: namespace must not contain U+0000`);
+  }
+  return namespace;
+}
+function validateLogicalKey(label, key) {
+  if (typeof key !== "string") {
+    throw new TypeError(`${label}: key must be a string`);
+  }
+  if (key.includes(NAMESPACE_SEPARATOR)) {
+    throw new TypeError(`${label}: key must not contain U+0000`);
+  }
+  return key;
+}
+function validateListPrefix(label, prefix) {
+  if (typeof prefix !== "string") {
+    throw new TypeError(`${label}: list prefix must be a string`);
+  }
+  if (prefix.includes(NAMESPACE_SEPARATOR)) {
+    throw new TypeError(`${label}: list prefix must not contain U+0000`);
+  }
+  return prefix;
+}
+function validateSqliteTableName(tableName) {
+  if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(tableName)) {
+    throw new TypeError("sqliteBackend: tableName must be a simple SQLite identifier");
+  }
+  return tableName;
+}
+function sqliteGeneration(storageId, key, rowGeneration, epoch) {
+  return Object.freeze({
+    [SQLITE_GENERATION]: Object.freeze([storageId, key, rowGeneration, epoch])
+  });
+}
+function readSqliteGeneration(generation) {
+  if (typeof generation !== "object" || generation === null) return void 0;
+  const maybe = generation;
+  const token = maybe[SQLITE_GENERATION];
+  if (Array.isArray(token) && token.length === 4 && typeof token[0] === "object" && token[0] !== null && typeof token[1] === "string" && (token[2] === null || typeof token[2] === "number") && typeof token[3] === "number") {
+    return token;
+  }
+  return void 0;
+}
+function sqliteChanges(result) {
+  return typeof result === "object" && result !== null && "changes" in result && typeof result.changes === "number" ? result.changes : 0;
+}
+function sqliteBytes(value) {
+  return Uint8Array.from(value instanceof Uint8Array ? value : new Uint8Array(value));
+}
+function loadSqliteDatabaseSync() {
+  try {
+    const DatabaseSync = require2("node:sqlite").DatabaseSync;
+    if (typeof DatabaseSync !== "function") {
+      throw new TypeError("DatabaseSync export is missing");
+    }
+    return DatabaseSync;
+  } catch (error) {
+    throw new Error("sqliteBackend: node:sqlite is not available in this Node runtime", {
+      cause: error
+    });
+  }
+}
+function fileBackend(dir, opts = {}) {
+  const extension = validateExtension(opts.extension ?? ".bin");
+  const namespace = opts.namespace === void 0 ? "" : validateNamespace("fileBackend", opts.namespace);
+  const namespacePrefix = namespace.length > 0 ? `${namespace}${NAMESPACE_SEPARATOR}` : "";
+  const storageKey = (key) => `${namespacePrefix}${validateLogicalKey("fileBackend", key)}`;
+  const pathFor = (key) => join(dir, `${FILE_STEM_PREFIX}${keyToStem(storageKey(key))}${extension}`);
+  const keyFromFilename = (filename) => {
+    if (!filename.endsWith(extension)) return null;
+    const stem = filename.slice(0, -extension.length);
+    if (!stem.startsWith(FILE_STEM_PREFIX)) return null;
+    const key = stemToKey(stem.slice(FILE_STEM_PREFIX.length));
+    if (key === null || !key.startsWith(namespacePrefix)) return null;
+    const logical = key.slice(namespacePrefix.length);
+    if (logical.includes(NAMESPACE_SEPARATOR)) {
+      throw new TypeError("fileBackend: malformed stored key");
+    }
+    return logical;
+  };
+  return {
+    get(key) {
+      try {
+        return Uint8Array.from(readFileSync(pathFor(key)));
+      } catch (error) {
+        if (isErrno(error, "ENOENT")) return void 0;
+        throw error;
+      }
+    },
+    put(key, value) {
+      mkdirSync(dir, { recursive: true });
+      const filePath = pathFor(key);
+      const base = basename(filePath);
+      const parent = dirname(filePath);
+      const tmp = join(parent, `.${base}.${randomBytes(8).toString("hex")}.tmp`);
+      try {
+        writeFileSync(tmp, value);
+        renameSync(tmp, filePath);
+      } catch (error) {
+        try {
+          unlinkSync(tmp);
+        } catch {
+        }
+        throw error;
+      }
+    },
+    putIfAbsent(key, value) {
+      mkdirSync(dir, { recursive: true });
+      const filePath = pathFor(key);
+      let fd;
+      try {
+        fd = openSync(filePath, "wx");
+        writeFileSync(fd, value);
+        return true;
+      } catch (error) {
+        if (isErrno(error, "EEXIST")) return false;
+        if (fd !== void 0) {
+          try {
+            unlinkSync(filePath);
+          } catch {
+          }
+        }
+        throw error;
+      } finally {
+        if (fd !== void 0) closeSync(fd);
+      }
+    },
+    delete(key) {
+      try {
+        unlinkSync(pathFor(key));
+      } catch (error) {
+        if (!isErrno(error, "ENOENT")) throw error;
+      }
+    },
+    list(prefix = "") {
+      const validatedPrefix = validateListPrefix("fileBackend", prefix);
+      let entries;
+      try {
+        entries = readdirSync(dir);
+      } catch (error) {
+        if (isErrno(error, "ENOENT")) return [];
+        throw error;
+      }
+      const keys = [];
+      for (const entry of entries) {
+        if (entry.startsWith(".")) continue;
+        const key = keyFromFilename(entry);
+        if (key?.startsWith(validatedPrefix)) keys.push(key);
+      }
+      return keys.sort();
+    }
+  };
+}
+function fileKv(dir, opts = {}) {
+  return kvStorage({
+    backend: fileBackend(dir, opts),
+    codec: opts.codec
+  });
+}
+function fileAppendLog(dir, opts = {}) {
+  return appendLogStorage({
+    kv: fileKv(dir, opts),
+    prefix: opts.prefix ?? "event-log"
+  });
+}
+function sqliteBackend(path, opts = {}) {
+  const table = validateSqliteTableName(opts.tableName ?? "graphrefly_storage");
+  const metaTable = validateSqliteTableName(`${table}_meta`);
+  const namespace = opts.namespace === void 0 ? "" : validateNamespace("sqliteBackend", opts.namespace);
+  const DatabaseSync = loadSqliteDatabaseSync();
+  const namespacePrefix = namespace.length > 0 ? `${namespace}${NAMESPACE_SEPARATOR}` : "";
+  const storageKey = (key) => `${namespacePrefix}${validateLogicalKey("sqliteBackend", key)}`;
+  const storageId = Object.freeze({});
+  const logicalKey = (key) => {
+    if (typeof key !== "string") {
+      throw new TypeError("sqliteBackend: stored key is corrupt");
+    }
+    if (!key.startsWith(namespacePrefix)) return void 0;
+    const logical = key.slice(namespacePrefix.length);
+    if (logical.includes(NAMESPACE_SEPARATOR)) {
+      throw new TypeError("sqliteBackend: malformed stored key");
+    }
+    return logical;
+  };
+  const db = new DatabaseSync(path);
+  db.exec(
+    `CREATE TABLE IF NOT EXISTS ${table} (k TEXT PRIMARY KEY, v BLOB NOT NULL, g INTEGER NOT NULL DEFAULT 0)`
+  );
+  const columns = db.prepare(`PRAGMA table_info(${table})`).all();
+  if (!columns.some((column) => column.name === "g")) {
+    db.exec(`ALTER TABLE ${table} ADD COLUMN g INTEGER NOT NULL DEFAULT 0`);
+  }
+  db.exec(`CREATE TABLE IF NOT EXISTS ${metaTable} (k TEXT PRIMARY KEY, v INTEGER NOT NULL)`);
+  db.exec(`
+		CREATE TRIGGER IF NOT EXISTS ${table}_generation_insert
+		AFTER INSERT ON ${table}
+		BEGIN
+			INSERT INTO ${metaTable} (k, v) VALUES (NEW.k, 1)
+			ON CONFLICT(k) DO UPDATE SET v = ${metaTable}.v + 1;
+		END
+	`);
+  db.exec(`
+		CREATE TRIGGER IF NOT EXISTS ${table}_generation_update
+		AFTER UPDATE ON ${table}
+		BEGIN
+			INSERT INTO ${metaTable} (k, v) VALUES (NEW.k, 1)
+			ON CONFLICT(k) DO UPDATE SET v = ${metaTable}.v + 1;
+		END
+	`);
+  db.exec(`
+		CREATE TRIGGER IF NOT EXISTS ${table}_generation_delete
+		AFTER DELETE ON ${table}
+		BEGIN
+			INSERT INTO ${metaTable} (k, v) VALUES (OLD.k, 1)
+			ON CONFLICT(k) DO UPDATE SET v = ${metaTable}.v + 1;
+		END
+	`);
+  const keyEpoch = (key) => {
+    const row = db.prepare(`SELECT v FROM ${metaTable} WHERE k = ?`).get(key);
+    const value = row?.v ?? 0;
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) {
+      throw new Error("sqliteBackend: per-key generation epoch is corrupt");
+    }
+    return value;
+  };
+  const readRow = (key) => {
+    const row = db.prepare(`SELECT v, g FROM ${table} WHERE k = ?`).get(storageKey(key));
+    if (row?.v === void 0) return void 0;
+    const generation = row.g;
+    if (typeof generation !== "number" || !Number.isSafeInteger(generation) || generation < 0) {
+      throw new Error("sqliteBackend: row generation is corrupt");
+    }
+    return { value: sqliteBytes(row.v), generation };
+  };
+  return {
+    name: `sqlite:${path}/${table}`,
+    get(key) {
+      return readRow(key)?.value;
+    },
+    put(key, value) {
+      db.prepare(
+        `INSERT INTO ${table} (k, v, g) VALUES (?, ?, 0) ON CONFLICT(k) DO UPDATE SET v = excluded.v, g = ${table}.g + 1`
+      ).run(storageKey(key), value);
+    },
+    putIfAbsent(key, value) {
+      const result = db.prepare(`INSERT OR IGNORE INTO ${table} (k, v, g) VALUES (?, ?, 0)`).run(storageKey(key), value);
+      return sqliteChanges(result) === 1;
+    },
+    getVersioned(key) {
+      const row = readRow(key);
+      if (row === void 0) {
+        return {
+          kind: "miss",
+          generation: sqliteGeneration(storageId, storageKey(key), null, keyEpoch(storageKey(key)))
+        };
+      }
+      return {
+        kind: "hit",
+        value: row.value,
+        generation: sqliteGeneration(
+          storageId,
+          storageKey(key),
+          row.generation,
+          keyEpoch(storageKey(key))
+        )
+      };
+    },
+    setIfMatch(key, value, generation) {
+      const keyForStorage = storageKey(key);
+      const observed = readSqliteGeneration(generation);
+      if (observed === void 0 || observed[0] !== storageId || observed[1] !== keyForStorage) {
+        return false;
+      }
+      if (observed[2] === null) {
+        return sqliteChanges(
+          db.prepare(
+            `INSERT INTO ${table} (k, v, g) SELECT ?, ?, 0 WHERE COALESCE((SELECT v FROM ${metaTable} WHERE k = ?), 0) = ? AND NOT EXISTS (SELECT 1 FROM ${table} WHERE k = ?)`
+          ).run(keyForStorage, value, keyForStorage, observed[3], keyForStorage)
+        ) === 1;
+      }
+      return sqliteChanges(
+        db.prepare(
+          `UPDATE ${table} SET v = ?, g = g + 1 WHERE k = ? AND g = ? AND COALESCE((SELECT v FROM ${metaTable} WHERE k = ?), 0) = ?`
+        ).run(value, keyForStorage, observed[2], keyForStorage, observed[3])
+      ) === 1;
+    },
+    delete(key) {
+      db.prepare(`DELETE FROM ${table} WHERE k = ?`).run(storageKey(key));
+    },
+    list(prefix = "") {
+      const validatedPrefix = validateListPrefix("sqliteBackend", prefix);
+      const rows = db.prepare(`SELECT k FROM ${table} ORDER BY k`).all();
+      const out = [];
+      for (const row of rows) {
+        const key = logicalKey(row.k);
+        if (key?.startsWith(validatedPrefix)) out.push(key);
+      }
+      return out.sort();
+    },
+    close() {
+      db.close();
+    }
+  };
+}
+function sqliteKv(path, opts = {}) {
+  const backend = sqliteBackend(path, opts);
+  const tier = kvStorage({
+    backend,
+    codec: opts.codec
+  });
+  return Object.assign(tier, { close: () => backend.close() });
+}
+function sqliteAppendLog(path, opts = {}) {
+  const kv = sqliteKv(path, opts);
+  const log = appendLogStorage({ kv, prefix: opts.prefix ?? "event-log" });
+  return Object.assign(log, { close: () => kv.close() });
+}
+export {
+  fileAppendLog,
+  fileBackend,
+  fileKv,
+  sqliteAppendLog,
+  sqliteBackend,
+  sqliteKv
+};
+//# sourceMappingURL=node.js.map

package/dist/storage/node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/storage/node.ts"],"sourcesContent":["/**\n * Node-only passive storage backends (D103).\n *\n * Import from `@graphrefly/ts/storage/node`; the universal storage barrel stays browser-safe.\n */\n\nimport { randomBytes } from \"node:crypto\";\nimport {\n\tcloseSync,\n\tmkdirSync,\n\topenSync,\n\treaddirSync,\n\treadFileSync,\n\trenameSync,\n\tunlinkSync,\n\twriteFileSync,\n} from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { basename, dirname, join } from \"node:path\";\nimport { type AppendLogStorageTier, appendLogStorage } from \"./append-log.js\";\nimport type { StorageBackend, StorageGeneration, StorageNamespaceOptions } from \"./backend.js\";\nimport type { Codec } from \"./codec.js\";\nimport { type KvStorageTier, kvStorage } from \"./kv.js\";\n\nexport interface FileBackendOptions extends StorageNamespaceOptions {\n\t/** File suffix used for stored byte blobs. Defaults to `.bin`. */\n\textension?: string;\n}\n\nexport interface FileKvOptions<T> extends FileBackendOptions {\n\tcodec?: Codec<T>;\n}\n\nexport interface FileAppendLogOptions<T> extends FileKvOptions<T> {\n\t/** Append-log key prefix. Defaults to `event-log`. */\n\tprefix?: string;\n}\n\nexport interface SqliteBackendOptions extends StorageNamespaceOptions {\n\t/** Table name used for passive byte storage. Defaults to `graphrefly_storage`. */\n\ttableName?: string;\n}\n\nexport interface SqliteKvOptions<T> extends SqliteBackendOptions {\n\tcodec?: Codec<T>;\n}\n\nexport interface SqliteAppendLogOptions<T> extends SqliteKvOptions<T> {\n\t/** Append-log key prefix. Defaults to `event-log`. */\n\tprefix?: string;\n}\n\nexport interface ClosableStorageBackend extends StorageBackend {\n\treadonly name: string;\n\tclose(): void;\n}\n\ntype SqliteDatabaseConstructor = new (path: string) => SqliteDatabase;\n\ninterface SqliteDatabase {\n\texec(sql: string): void;\n\tprepare(sql: string): SqliteStatement;\n\tclose(): void;\n}\n\ninterface SqliteStatement {\n\tget(...params: unknown[]): unknown;\n\trun(...params: unknown[]): unknown;\n\tall(...params: unknown[]): unknown[];\n}\n\nconst FILE_STEM_PREFIX = \"k-\";\nconst NAMESPACE_SEPARATOR = \"\\u0000\";\nconst SQLITE_GENERATION = Symbol(\"graphrefly.sqliteBackend.generation\");\nconst encoder = new TextEncoder();\nconst decoder = new TextDecoder(\"utf-8\", { fatal: true });\nconst require = createRequire(\"/graphrefly-storage-node.js\");\n\ninterface SqliteGeneration {\n\treadonly [SQLITE_GENERATION]: readonly [\n\t\tstorageId: object,\n\t\tkey: string,\n\t\trowGeneration: number | null,\n\t\tepoch: number,\n\t];\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n\treturn (\n\t\ttypeof error === \"object\" &&\n\t\terror !== null &&\n\t\t\"code\" in error &&\n\t\t(error as { code?: unknown }).code === code\n\t);\n}\n\nfunction keyToStem(key: string): string {\n\tlet out = \"\";\n\tfor (const ch of key) {\n\t\tif (/^[a-zA-Z0-9_-]$/.test(ch)) {\n\t\t\tout += ch;\n\t\t\tcontinue;\n\t\t}\n\t\tfor (const byte of encoder.encode(ch)) out += `%${byte.toString(16).padStart(2, \"0\")}`;\n\t}\n\treturn out;\n}\n\nfunction stemToKey(stem: string): string | null {\n\tconst bytes: number[] = [];\n\tlet i = 0;\n\twhile (i < stem.length) {\n\t\tconst ch = stem[i]!;\n\t\tif (ch === \"%\" && i + 2 < stem.length) {\n\t\t\tconst hex = stem.slice(i + 1, i + 3);\n\t\t\tif (/^[0-9a-f]{2}$/i.test(hex)) {\n\t\t\t\tbytes.push(Number.parseInt(hex, 16));\n\t\t\t\ti += 3;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\t\tconst code = ch.charCodeAt(0);\n\t\tif (code > 0x7f) return null;\n\t\tbytes.push(code);\n\t\ti += 1;\n\t}\n\ttry {\n\t\treturn decoder.decode(new Uint8Array(bytes));\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction validateExtension(extension: string): string {\n\tif (\n\t\textension.length < 2 ||\n\t\t!extension.startsWith(\".\") ||\n\t\textension.includes(\"..\") ||\n\t\t/[/\\\\\\0]/.test(extension) ||\n\t\t!/^[.A-Za-z0-9_-]+$/.test(extension)\n\t) {\n\t\tthrow new TypeError(\"fileBackend: extension must be a simple suffix such as .bin\");\n\t}\n\treturn extension;\n}\n\nfunction validateNamespace(label: string, namespace: string): string {\n\tif (typeof namespace !== \"string\") {\n\t\tthrow new TypeError(`${label}: namespace must be a string`);\n\t}\n\tif (namespace.includes(NAMESPACE_SEPARATOR)) {\n\t\tthrow new TypeError(`${label}: namespace must not contain U+0000`);\n\t}\n\treturn namespace;\n}\n\nfunction validateLogicalKey(label: string, key: string): string {\n\tif (typeof key !== \"string\") {\n\t\tthrow new TypeError(`${label}: key must be a string`);\n\t}\n\tif (key.includes(NAMESPACE_SEPARATOR)) {\n\t\tthrow new TypeError(`${label}: key must not contain U+0000`);\n\t}\n\treturn key;\n}\n\nfunction validateListPrefix(label: string, prefix: string): string {\n\tif (typeof prefix !== \"string\") {\n\t\tthrow new TypeError(`${label}: list prefix must be a string`);\n\t}\n\tif (prefix.includes(NAMESPACE_SEPARATOR)) {\n\t\tthrow new TypeError(`${label}: list prefix must not contain U+0000`);\n\t}\n\treturn prefix;\n}\n\nfunction validateSqliteTableName(tableName: string): string {\n\tif (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(tableName)) {\n\t\tthrow new TypeError(\"sqliteBackend: tableName must be a simple SQLite identifier\");\n\t}\n\treturn tableName;\n}\n\nfunction sqliteGeneration(\n\tstorageId: object,\n\tkey: string,\n\trowGeneration: number | null,\n\tepoch: number,\n): SqliteGeneration {\n\treturn Object.freeze({\n\t\t[SQLITE_GENERATION]: Object.freeze([storageId, key, rowGeneration, epoch] as const),\n\t});\n}\n\nfunction readSqliteGeneration(\n\tgeneration: StorageGeneration,\n):\n\t| readonly [storageId: object, key: string, rowGeneration: number | null, epoch: number]\n\t| undefined {\n\tif (typeof generation !== \"object\" || generation === null) return undefined;\n\tconst maybe = generation as Partial<SqliteGeneration>;\n\tconst token = maybe[SQLITE_GENERATION];\n\tif (\n\t\tArray.isArray(token) &&\n\t\ttoken.length === 4 &&\n\t\ttypeof token[0] === \"object\" &&\n\t\ttoken[0] !== null &&\n\t\ttypeof token[1] === \"string\" &&\n\t\t(token[2] === null || typeof token[2] === \"number\") &&\n\t\ttypeof token[3] === \"number\"\n\t) {\n\t\treturn token as readonly [object, string, number | null, number];\n\t}\n\treturn undefined;\n}\n\nfunction sqliteChanges(result: unknown): number {\n\treturn typeof result === \"object\" &&\n\t\tresult !== null &&\n\t\t\"changes\" in result &&\n\t\ttypeof (result as { changes?: unknown }).changes === \"number\"\n\t\t? (result as { changes: number }).changes\n\t\t: 0;\n}\n\nfunction sqliteBytes(value: Uint8Array | ArrayBuffer): Uint8Array {\n\treturn Uint8Array.from(value instanceof Uint8Array ? value : new Uint8Array(value));\n}\n\nfunction loadSqliteDatabaseSync(): SqliteDatabaseConstructor {\n\ttry {\n\t\tconst DatabaseSync = (require(\"node:sqlite\") as { DatabaseSync?: unknown }).DatabaseSync;\n\t\tif (typeof DatabaseSync !== \"function\") {\n\t\t\tthrow new TypeError(\"DatabaseSync export is missing\");\n\t\t}\n\t\treturn DatabaseSync as SqliteDatabaseConstructor;\n\t} catch (error) {\n\t\tthrow new Error(\"sqliteBackend: node:sqlite is not available in this Node runtime\", {\n\t\t\tcause: error,\n\t\t});\n\t}\n}\n\n/** Node filesystem byte backend with atomic replace writes and D85 conditional create. */\nexport function fileBackend(dir: string, opts: FileBackendOptions = {}): StorageBackend {\n\tconst extension = validateExtension(opts.extension ?? \".bin\");\n\tconst namespace =\n\t\topts.namespace === undefined ? \"\" : validateNamespace(\"fileBackend\", opts.namespace);\n\tconst namespacePrefix = namespace.length > 0 ? `${namespace}${NAMESPACE_SEPARATOR}` : \"\";\n\tconst storageKey = (key: string) => `${namespacePrefix}${validateLogicalKey(\"fileBackend\", key)}`;\n\tconst pathFor = (key: string) =>\n\t\tjoin(dir, `${FILE_STEM_PREFIX}${keyToStem(storageKey(key))}${extension}`);\n\tconst keyFromFilename = (filename: string): string | null => {\n\t\tif (!filename.endsWith(extension)) return null;\n\t\tconst stem = filename.slice(0, -extension.length);\n\t\tif (!stem.startsWith(FILE_STEM_PREFIX)) return null;\n\t\tconst key = stemToKey(stem.slice(FILE_STEM_PREFIX.length));\n\t\tif (key === null || !key.startsWith(namespacePrefix)) return null;\n\t\tconst logical = key.slice(namespacePrefix.length);\n\t\tif (logical.includes(NAMESPACE_SEPARATOR)) {\n\t\t\tthrow new TypeError(\"fileBackend: malformed stored key\");\n\t\t}\n\t\treturn logical;\n\t};\n\n\treturn {\n\t\tget(key) {\n\t\t\ttry {\n\t\t\t\treturn Uint8Array.from(readFileSync(pathFor(key)));\n\t\t\t} catch (error) {\n\t\t\t\tif (isErrno(error, \"ENOENT\")) return undefined;\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t},\n\t\tput(key, value) {\n\t\t\tmkdirSync(dir, { recursive: true });\n\t\t\tconst filePath = pathFor(key);\n\t\t\tconst base = basename(filePath);\n\t\t\tconst parent = dirname(filePath);\n\t\t\tconst tmp = join(parent, `.${base}.${randomBytes(8).toString(\"hex\")}.tmp`);\n\t\t\ttry {\n\t\t\t\twriteFileSync(tmp, value);\n\t\t\t\trenameSync(tmp, filePath);\n\t\t\t} catch (error) {\n\t\t\t\ttry {\n\t\t\t\t\tunlinkSync(tmp);\n\t\t\t\t} catch {\n\t\t\t\t\t// Ignore cleanup failures; the original write error is the useful one.\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t},\n\t\tputIfAbsent(key, value) {\n\t\t\tmkdirSync(dir, { recursive: true });\n\t\t\tconst filePath = pathFor(key);\n\t\t\tlet fd: number | undefined;\n\t\t\ttry {\n\t\t\t\tfd = openSync(filePath, \"wx\");\n\t\t\t\twriteFileSync(fd, value);\n\t\t\t\treturn true;\n\t\t\t} catch (error) {\n\t\t\t\tif (isErrno(error, \"EEXIST\")) return false;\n\t\t\t\tif (fd !== undefined) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tunlinkSync(filePath);\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Best effort cleanup of a partially-created file.\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t} finally {\n\t\t\t\tif (fd !== undefined) closeSync(fd);\n\t\t\t}\n\t\t},\n\t\tdelete(key) {\n\t\t\ttry {\n\t\t\t\tunlinkSync(pathFor(key));\n\t\t\t} catch (error) {\n\t\t\t\tif (!isErrno(error, \"ENOENT\")) throw error;\n\t\t\t}\n\t\t},\n\t\tlist(prefix = \"\") {\n\t\t\tconst validatedPrefix = validateListPrefix(\"fileBackend\", prefix);\n\t\t\tlet entries: string[];\n\t\t\ttry {\n\t\t\t\tentries = readdirSync(dir);\n\t\t\t} catch (error) {\n\t\t\t\tif (isErrno(error, \"ENOENT\")) return [];\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tconst keys: string[] = [];\n\t\t\tfor (const entry of entries) {\n\t\t\t\tif (entry.startsWith(\".\")) continue;\n\t\t\t\tconst key = keyFromFilename(entry);\n\t\t\t\tif (key?.startsWith(validatedPrefix)) keys.push(key);\n\t\t\t}\n\t\t\treturn keys.sort();\n\t\t},\n\t};\n}\n\n/**\n * Create a typed KV tier over a Node filesystem backend (D106 passive storage).\n */\nexport function fileKv<T>(dir: string, opts: FileKvOptions<T> = {}): KvStorageTier<T> {\n\treturn kvStorage<T>({\n\t\tbackend: fileBackend(dir, opts),\n\t\tcodec: opts.codec,\n\t});\n}\n\n/**\n * Create an append-log tier over a Node filesystem backend (D106 passive storage).\n */\nexport function fileAppendLog<T>(\n\tdir: string,\n\topts: FileAppendLogOptions<T> = {},\n): AppendLogStorageTier<T> {\n\treturn appendLogStorage<T>({\n\t\tkv: fileKv<T>(dir, opts),\n\t\tprefix: opts.prefix ?? \"event-log\",\n\t});\n}\n\n/**\n * Optional Node SQLite byte backend (D106 passive storage).\n *\n * Uses `node:sqlite` when the current Node runtime provides it; otherwise throws a clear\n * runtime error at construction time. The caller owns `close()`.\n */\nexport function sqliteBackend(\n\tpath: string,\n\topts: SqliteBackendOptions = {},\n): ClosableStorageBackend {\n\tconst table = validateSqliteTableName(opts.tableName ?? \"graphrefly_storage\");\n\tconst metaTable = validateSqliteTableName(`${table}_meta`);\n\tconst namespace =\n\t\topts.namespace === undefined ? \"\" : validateNamespace(\"sqliteBackend\", opts.namespace);\n\tconst DatabaseSync = loadSqliteDatabaseSync();\n\tconst namespacePrefix = namespace.length > 0 ? `${namespace}${NAMESPACE_SEPARATOR}` : \"\";\n\tconst storageKey = (key: string) =>\n\t\t`${namespacePrefix}${validateLogicalKey(\"sqliteBackend\", key)}`;\n\tconst storageId = Object.freeze({});\n\tconst logicalKey = (key: string): string | undefined => {\n\t\tif (typeof key !== \"string\") {\n\t\t\tthrow new TypeError(\"sqliteBackend: stored key is corrupt\");\n\t\t}\n\t\tif (!key.startsWith(namespacePrefix)) return undefined;\n\t\tconst logical = key.slice(namespacePrefix.length);\n\t\tif (logical.includes(NAMESPACE_SEPARATOR)) {\n\t\t\tthrow new TypeError(\"sqliteBackend: malformed stored key\");\n\t\t}\n\t\treturn logical;\n\t};\n\tconst db = new DatabaseSync(path);\n\tdb.exec(\n\t\t`CREATE TABLE IF NOT EXISTS ${table} (k TEXT PRIMARY KEY, v BLOB NOT NULL, g INTEGER NOT NULL DEFAULT 0)`,\n\t);\n\tconst columns = db.prepare(`PRAGMA table_info(${table})`).all() as Array<{ name?: string }>;\n\tif (!columns.some((column) => column.name === \"g\")) {\n\t\tdb.exec(`ALTER TABLE ${table} ADD COLUMN g INTEGER NOT NULL DEFAULT 0`);\n\t}\n\tdb.exec(`CREATE TABLE IF NOT EXISTS ${metaTable} (k TEXT PRIMARY KEY, v INTEGER NOT NULL)`);\n\tdb.exec(`\n\t\tCREATE TRIGGER IF NOT EXISTS ${table}_generation_insert\n\t\tAFTER INSERT ON ${table}\n\t\tBEGIN\n\t\t\tINSERT INTO ${metaTable} (k, v) VALUES (NEW.k, 1)\n\t\t\tON CONFLICT(k) DO UPDATE SET v = ${metaTable}.v + 1;\n\t\tEND\n\t`);\n\tdb.exec(`\n\t\tCREATE TRIGGER IF NOT EXISTS ${table}_generation_update\n\t\tAFTER UPDATE ON ${table}\n\t\tBEGIN\n\t\t\tINSERT INTO ${metaTable} (k, v) VALUES (NEW.k, 1)\n\t\t\tON CONFLICT(k) DO UPDATE SET v = ${metaTable}.v + 1;\n\t\tEND\n\t`);\n\tdb.exec(`\n\t\tCREATE TRIGGER IF NOT EXISTS ${table}_generation_delete\n\t\tAFTER DELETE ON ${table}\n\t\tBEGIN\n\t\t\tINSERT INTO ${metaTable} (k, v) VALUES (OLD.k, 1)\n\t\t\tON CONFLICT(k) DO UPDATE SET v = ${metaTable}.v + 1;\n\t\tEND\n\t`);\n\n\tconst keyEpoch = (key: string): number => {\n\t\tconst row = db.prepare(`SELECT v FROM ${metaTable} WHERE k = ?`).get(key) as\n\t\t\t| { v?: number }\n\t\t\t| undefined;\n\t\tconst value = row?.v ?? 0;\n\t\tif (typeof value !== \"number\" || !Number.isSafeInteger(value) || value < 0) {\n\t\t\tthrow new Error(\"sqliteBackend: per-key generation epoch is corrupt\");\n\t\t}\n\t\treturn value;\n\t};\n\tconst readRow = (\n\t\tkey: string,\n\t):\n\t\t| {\n\t\t\t\treadonly value: Uint8Array;\n\t\t\t\treadonly generation: number;\n\t\t  }\n\t\t| undefined => {\n\t\tconst row = db.prepare(`SELECT v, g FROM ${table} WHERE k = ?`).get(storageKey(key)) as\n\t\t\t| { v?: Uint8Array | ArrayBuffer; g?: number }\n\t\t\t| undefined;\n\t\tif (row?.v === undefined) return undefined;\n\t\tconst generation = row.g;\n\t\tif (typeof generation !== \"number\" || !Number.isSafeInteger(generation) || generation < 0) {\n\t\t\tthrow new Error(\"sqliteBackend: row generation is corrupt\");\n\t\t}\n\t\treturn { value: sqliteBytes(row.v), generation };\n\t};\n\n\treturn {\n\t\tname: `sqlite:${path}/${table}`,\n\t\tget(key) {\n\t\t\treturn readRow(key)?.value;\n\t\t},\n\t\tput(key, value) {\n\t\t\tdb.prepare(\n\t\t\t\t`INSERT INTO ${table} (k, v, g) VALUES (?, ?, 0) ON CONFLICT(k) DO UPDATE SET v = excluded.v, g = ${table}.g + 1`,\n\t\t\t).run(storageKey(key), value);\n\t\t},\n\t\tputIfAbsent(key, value) {\n\t\t\tconst result = db\n\t\t\t\t.prepare(`INSERT OR IGNORE INTO ${table} (k, v, g) VALUES (?, ?, 0)`)\n\t\t\t\t.run(storageKey(key), value) as { changes?: number };\n\t\t\treturn sqliteChanges(result) === 1;\n\t\t},\n\t\tgetVersioned(key) {\n\t\t\tconst row = readRow(key);\n\t\t\tif (row === undefined) {\n\t\t\t\treturn {\n\t\t\t\t\tkind: \"miss\",\n\t\t\t\t\tgeneration: sqliteGeneration(storageId, storageKey(key), null, keyEpoch(storageKey(key))),\n\t\t\t\t};\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tkind: \"hit\",\n\t\t\t\tvalue: row.value,\n\t\t\t\tgeneration: sqliteGeneration(\n\t\t\t\t\tstorageId,\n\t\t\t\t\tstorageKey(key),\n\t\t\t\t\trow.generation,\n\t\t\t\t\tkeyEpoch(storageKey(key)),\n\t\t\t\t),\n\t\t\t};\n\t\t},\n\t\tsetIfMatch(key, value, generation) {\n\t\t\tconst keyForStorage = storageKey(key);\n\t\t\tconst observed = readSqliteGeneration(generation);\n\t\t\tif (observed === undefined || observed[0] !== storageId || observed[1] !== keyForStorage) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tif (observed[2] === null) {\n\t\t\t\treturn (\n\t\t\t\t\tsqliteChanges(\n\t\t\t\t\t\tdb\n\t\t\t\t\t\t\t.prepare(\n\t\t\t\t\t\t\t\t`INSERT INTO ${table} (k, v, g) SELECT ?, ?, 0 WHERE COALESCE((SELECT v FROM ${metaTable} WHERE k = ?), 0) = ? AND NOT EXISTS (SELECT 1 FROM ${table} WHERE k = ?)`,\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t.run(keyForStorage, value, keyForStorage, observed[3], keyForStorage),\n\t\t\t\t\t) === 1\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn (\n\t\t\t\tsqliteChanges(\n\t\t\t\t\tdb\n\t\t\t\t\t\t.prepare(\n\t\t\t\t\t\t\t`UPDATE ${table} SET v = ?, g = g + 1 WHERE k = ? AND g = ? AND COALESCE((SELECT v FROM ${metaTable} WHERE k = ?), 0) = ?`,\n\t\t\t\t\t\t)\n\t\t\t\t\t\t.run(value, keyForStorage, observed[2], keyForStorage, observed[3]),\n\t\t\t\t) === 1\n\t\t\t);\n\t\t},\n\t\tdelete(key) {\n\t\t\tdb.prepare(`DELETE FROM ${table} WHERE k = ?`).run(storageKey(key));\n\t\t},\n\t\tlist(prefix = \"\") {\n\t\t\tconst validatedPrefix = validateListPrefix(\"sqliteBackend\", prefix);\n\t\t\tconst rows = db.prepare(`SELECT k FROM ${table} ORDER BY k`).all() as { k: string }[];\n\t\t\tconst out: string[] = [];\n\t\t\tfor (const row of rows) {\n\t\t\t\tconst key = logicalKey(row.k);\n\t\t\t\tif (key?.startsWith(validatedPrefix)) out.push(key);\n\t\t\t}\n\t\t\treturn out.sort();\n\t\t},\n\t\tclose() {\n\t\t\tdb.close();\n\t\t},\n\t};\n}\n\n/**\n * Create a typed KV tier over an optional Node SQLite backend.\n */\nexport function sqliteKv<T>(\n\tpath: string,\n\topts: SqliteKvOptions<T> = {},\n): KvStorageTier<T> & { close(): void } {\n\tconst backend = sqliteBackend(path, opts);\n\tconst tier = kvStorage<T>({\n\t\tbackend,\n\t\tcodec: opts.codec,\n\t});\n\treturn Object.assign(tier, { close: () => backend.close() });\n}\n\n/**\n * Create an append-log tier over an optional Node SQLite backend.\n */\nexport function sqliteAppendLog<T>(\n\tpath: string,\n\topts: SqliteAppendLogOptions<T> = {},\n): AppendLogStorageTier<T> & { close(): void } {\n\tconst kv = sqliteKv<T>(path, opts);\n\tconst log = appendLogStorage<T>({ kv, prefix: opts.prefix ?? \"event-log\" });\n\treturn Object.assign(log, { close: () => kv.close() });\n}\n"],"mappings":"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","names":["require"]}

package/dist/testing/index.cjs

@@ -0,0 +1,95 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/testing/index.ts
+var testing_exports = {};
+__export(testing_exports, {
+  assertDirtyPrecedesTerminalData: () => assertDirtyPrecedesTerminalData
+});
+module.exports = __toCommonJS(testing_exports);
+
+// src/protocol/messages.ts
+var TIER_START = 0;
+var TIER_CONTROL = 1;
+var TIER_NOTIFICATION = 2;
+var TIER_VALUE = 3;
+var TIER_SETTLE = 4;
+var TIER_TERMINAL = 5;
+var TIER_TEARDOWN = 6;
+var TIER = {
+  START: TIER_START,
+  PAUSE: TIER_CONTROL,
+  RESUME: TIER_CONTROL,
+  DIRTY: TIER_NOTIFICATION,
+  DATA: TIER_VALUE,
+  RESOLVED: TIER_VALUE,
+  INVALIDATE: TIER_SETTLE,
+  COMPLETE: TIER_TERMINAL,
+  ERROR: TIER_TERMINAL,
+  TEARDOWN: TIER_TEARDOWN
+};
+function isValueTier(t) {
+  return TIER[t] === TIER_VALUE;
+}
+
+// src/testing/assertions.ts
+function assertDirtyPrecedesTerminalData(messages) {
+  for (let waveIndex = 0; waveIndex < messages.length; waveIndex += 1) {
+    const wave = messages[waveIndex];
+    let handshake = false;
+    let openedByDirty = false;
+    for (let msgIndex = 0; msgIndex < wave.length; msgIndex += 1) {
+      const msg = wave[msgIndex];
+      const type = msg[0];
+      if (msgIndex === 0 && type === "START") {
+        handshake = true;
+        continue;
+      }
+      if (handshake && type === "DATA") {
+        continue;
+      }
+      handshake = false;
+      if (type === "DIRTY") {
+        openedByDirty = true;
+        continue;
+      }
+      if (isValueTier(type)) {
+        if (!openedByDirty) {
+          throw new Error(
+            `assertDirtyPrecedesTerminalData: ${type} at wave ${waveIndex}, index ${msgIndex} arrived without a preceding DIRTY in the same wave (R-dirty-before-data). Wave: ${describeWave(wave, msgIndex)}`
+          );
+        }
+        continue;
+      }
+      openedByDirty = false;
+    }
+  }
+}
+function describeWave(wave, around) {
+  const parts = [];
+  for (let i = 0; i < wave.length; i += 1) {
+    parts.push(`${i === around ? "-> " : "   "}[${wave[i]?.[0] ?? "?"}]`);
+  }
+  return parts.join(", ");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  assertDirtyPrecedesTerminalData
+});
+//# sourceMappingURL=index.cjs.map

package/dist/testing/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/index.ts","../../src/protocol/messages.ts","../../src/testing/assertions.ts"],"sourcesContent":["export {\n\tassertDirtyPrecedesTerminalData,\n\ttype MessageSequence,\n} from \"./assertions.js\";\n","/**\n * Wave-protocol message types and the tier const table.\n *\n * Canonical authority: ~/src/graphrefly/spec/rules.jsonl\n *   R-msg-format, R-msg-closed-set, R-tier (D34), R-data-payload, R-sentinel.\n */\n\n/** Opaque pause-lock identifier (R-pause-lockset). */\nexport type LockId = string | symbol;\n\n/**\n * The CLOSED set of 10 message types (R-msg-closed-set / D9 + START handshake).\n * No open set, no user-defined custom types. Adding a type is a spec change.\n */\nexport type Message =\n\t| readonly [\"START\"]\n\t| readonly [\"DIRTY\"]\n\t| readonly [\"DATA\", unknown]\n\t| readonly [\"RESOLVED\"]\n\t| readonly [\"INVALIDATE\"]\n\t| readonly [\"COMPLETE\"]\n\t| readonly [\"ERROR\", unknown]\n\t| readonly [\"TEARDOWN\"]\n\t| readonly [\"PAUSE\", LockId]\n\t| readonly [\"RESUME\", LockId];\n\n/** One array of messages delivered in one call = one Wave (R-wave-boundary). */\nexport type Wave = readonly Message[];\n\n/** The message-type tag (the first tuple element). */\nexport type MessageType = Message[0];\n\n/**\n * SENTINEL = absence-of-DATA (R-sentinel / D16). TS representation is `undefined`.\n * Never a valid DATA payload; `null` IS a valid DATA value (domain-level absence).\n */\nexport const SENTINEL = undefined;\n\n/** R-data-payload: ERROR payloads must not collide with terminal metadata shorthand. */\nexport function isInvalidErrorPayload(v: unknown): boolean {\n\treturn v === SENTINEL || typeof v === \"boolean\";\n}\n\n/** R-data-payload / D78: host-language failures that collide with ctx.terminal shorthand become diagnostics. */\nexport function errorPayload(reason: unknown, fallback = \"error without a valid payload\"): unknown {\n\treturn isInvalidErrorPayload(reason) ? new Error(fallback) : reason;\n}\n\nexport const TIER_START = 0;\nexport const TIER_CONTROL = 1;\nexport const TIER_NOTIFICATION = 2;\nexport const TIER_VALUE = 3;\nexport const TIER_SETTLE = 4;\nexport const TIER_TERMINAL = 5;\nexport const TIER_TEARDOWN = 6;\n\n/**\n * Tier const table (R-tier / D34). Tiers below value dispatch immediately; value\n * and above are batch-deferred. This is a compile-time const table (D18), not runtime config.\n */\nconst TIER: Record<MessageType, number> = {\n\tSTART: TIER_START,\n\tPAUSE: TIER_CONTROL,\n\tRESUME: TIER_CONTROL,\n\tDIRTY: TIER_NOTIFICATION,\n\tDATA: TIER_VALUE,\n\tRESOLVED: TIER_VALUE,\n\tINVALIDATE: TIER_SETTLE,\n\tCOMPLETE: TIER_TERMINAL,\n\tERROR: TIER_TERMINAL,\n\tTEARDOWN: TIER_TEARDOWN,\n};\n\nexport function messageTier(t: MessageType): number {\n\treturn TIER[t];\n}\n\n/** Value and above are deferred inside a batch (DATA/RESOLVED/INVALIDATE/terminal/teardown). */\nexport function isDeferredTier(t: MessageType): boolean {\n\treturn TIER[t] >= TIER_VALUE;\n}\n\n/** Value-tier messages (DATA/RESOLVED) occupy the tier-3 slot. */\nexport function isValueTier(t: MessageType): boolean {\n\treturn TIER[t] === TIER_VALUE;\n}\n\n/** The pause buffer holds the settle slice only: value-tier DATA/RESOLVED plus INVALIDATE. */\nexport function isPauseBufferedTier(t: MessageType): boolean {\n\tconst tier = TIER[t];\n\treturn tier === TIER_VALUE || tier === TIER_SETTLE;\n}\n\n/**\n * A TERMINAL message = tier 5 (COMPLETE | ERROR), R-tier / D34. Detected via the CENTRAL tier\n * table, NOT a per-variant `=== \"COMPLETE\" || === \"ERROR\"` check — so terminal routing stays\n * driven by the one const table (feedback_use_tier_for_signal_routing); discriminate COMPLETE vs\n * ERROR within the tier by the message type only where the handling actually differs.\n */\nexport function isTerminal(t: MessageType): boolean {\n\treturn TIER[t] === TIER_TERMINAL;\n}\n\n/**\n * ctx.up carries control tiers only (R-ctx-up / DR-5): DIRTY, PAUSE, RESUME,\n * INVALIDATE, TEARDOWN. DATA/RESOLVED (tier 3) and COMPLETE/ERROR (tier 5) are\n * down-only.\n */\nexport function isUpAllowed(t: MessageType): boolean {\n\tconst tier = TIER[t];\n\treturn tier !== TIER_VALUE && tier !== TIER_TERMINAL;\n}\n","/**\n * Public testing assertions for clean-slate GraphReFly message streams.\n *\n * These helpers validate captured protocol output; they do not participate in propagation.\n */\n\nimport { isValueTier, type Message, type Wave } from \"../protocol/messages.js\";\n\n/** Captured subscriber messages grouped by wave. START/replay handshake messages occupy one wave. */\nexport type MessageSequence = readonly Wave[];\n\n/**\n * Assert that observed tier-3 settlements (DATA/RESOLVED) are preceded by DIRTY.\n *\n * This encodes R-dirty-before-data for wave-framed subscriber traces. The leading\n * START push-on-subscribe/replay handshake wave is exempt because cached/replay DATA is\n * advertised to a new subscriber without opening a propagation wave.\n */\nexport function assertDirtyPrecedesTerminalData(messages: MessageSequence): void {\n\tfor (let waveIndex = 0; waveIndex < messages.length; waveIndex += 1) {\n\t\tconst wave = messages[waveIndex];\n\t\tlet handshake = false;\n\t\tlet openedByDirty = false;\n\n\t\tfor (let msgIndex = 0; msgIndex < wave.length; msgIndex += 1) {\n\t\t\tconst msg = wave[msgIndex] as Message;\n\t\t\tconst type = msg[0];\n\n\t\t\tif (msgIndex === 0 && type === \"START\") {\n\t\t\t\thandshake = true;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (handshake && type === \"DATA\") {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\thandshake = false;\n\n\t\t\tif (type === \"DIRTY\") {\n\t\t\t\topenedByDirty = true;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (isValueTier(type)) {\n\t\t\t\tif (!openedByDirty) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`assertDirtyPrecedesTerminalData: ${type} at wave ${waveIndex}, index ${msgIndex} arrived without a preceding DIRTY in the same wave (R-dirty-before-data). Wave: ${describeWave(wave, msgIndex)}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\topenedByDirty = false;\n\t\t}\n\t}\n}\n\nfunction describeWave(wave: Wave, around: number): string {\n\tconst parts: string[] = [];\n\tfor (let i = 0; i < wave.length; i += 1) {\n\t\tparts.push(`${i === around ? \"-> \" : \"   \"}[${wave[i]?.[0] ?? \"?\"}]`);\n\t}\n\treturn parts.join(\", \");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACgDO,IAAM,aAAa;AACnB,IAAM,eAAe;AACrB,IAAM,oBAAoB;AAC1B,IAAM,aAAa;AACnB,IAAM,cAAc;AACpB,IAAM,gBAAgB;AACtB,IAAM,gBAAgB;AAM7B,IAAM,OAAoC;AAAA,EACzC,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,MAAM;AAAA,EACN,UAAU;AAAA,EACV,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,OAAO;AAAA,EACP,UAAU;AACX;AAYO,SAAS,YAAY,GAAyB;AACpD,SAAO,KAAK,CAAC,MAAM;AACpB;;;ACnEO,SAAS,gCAAgC,UAAiC;AAChF,WAAS,YAAY,GAAG,YAAY,SAAS,QAAQ,aAAa,GAAG;AACpE,UAAM,OAAO,SAAS,SAAS;AAC/B,QAAI,YAAY;AAChB,QAAI,gBAAgB;AAEpB,aAAS,WAAW,GAAG,WAAW,KAAK,QAAQ,YAAY,GAAG;AAC7D,YAAM,MAAM,KAAK,QAAQ;AACzB,YAAM,OAAO,IAAI,CAAC;AAElB,UAAI,aAAa,KAAK,SAAS,SAAS;AACvC,oBAAY;AACZ;AAAA,MACD;AAEA,UAAI,aAAa,SAAS,QAAQ;AACjC;AAAA,MACD;AACA,kBAAY;AAEZ,UAAI,SAAS,SAAS;AACrB,wBAAgB;AAChB;AAAA,MACD;AAEA,UAAI,YAAY,IAAI,GAAG;AACtB,YAAI,CAAC,eAAe;AACnB,gBAAM,IAAI;AAAA,YACT,oCAAoC,IAAI,YAAY,SAAS,WAAW,QAAQ,oFAAoF,aAAa,MAAM,QAAQ,CAAC;AAAA,UACjM;AAAA,QACD;AACA;AAAA,MACD;AAEA,sBAAgB;AAAA,IACjB;AAAA,EACD;AACD;AAEA,SAAS,aAAa,MAAY,QAAwB;AACzD,QAAM,QAAkB,CAAC;AACzB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK,GAAG;AACxC,UAAM,KAAK,GAAG,MAAM,SAAS,QAAQ,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG;AAAA,EACrE;AACA,SAAO,MAAM,KAAK,IAAI;AACvB;","names":[]}

package/dist/testing/index.d.cts

@@ -0,0 +1,20 @@
+import { W as Wave } from '../messages-BZqrGGm1.cjs';
+
+/**
+ * Public testing assertions for clean-slate GraphReFly message streams.
+ *
+ * These helpers validate captured protocol output; they do not participate in propagation.
+ */
+
+/** Captured subscriber messages grouped by wave. START/replay handshake messages occupy one wave. */
+type MessageSequence = readonly Wave[];
+/**
+ * Assert that observed tier-3 settlements (DATA/RESOLVED) are preceded by DIRTY.
+ *
+ * This encodes R-dirty-before-data for wave-framed subscriber traces. The leading
+ * START push-on-subscribe/replay handshake wave is exempt because cached/replay DATA is
+ * advertised to a new subscriber without opening a propagation wave.
+ */
+declare function assertDirtyPrecedesTerminalData(messages: MessageSequence): void;
+
+export { type MessageSequence, assertDirtyPrecedesTerminalData };

package/dist/testing/index.d.ts

@@ -0,0 +1,20 @@
+import { W as Wave } from '../messages-BZqrGGm1.js';
+
+/**
+ * Public testing assertions for clean-slate GraphReFly message streams.
+ *
+ * These helpers validate captured protocol output; they do not participate in propagation.
+ */
+
+/** Captured subscriber messages grouped by wave. START/replay handshake messages occupy one wave. */
+type MessageSequence = readonly Wave[];
+/**
+ * Assert that observed tier-3 settlements (DATA/RESOLVED) are preceded by DIRTY.
+ *
+ * This encodes R-dirty-before-data for wave-framed subscriber traces. The leading
+ * START push-on-subscribe/replay handshake wave is exempt because cached/replay DATA is
+ * advertised to a new subscriber without opening a propagation wave.
+ */
+declare function assertDirtyPrecedesTerminalData(messages: MessageSequence): void;
+
+export { type MessageSequence, assertDirtyPrecedesTerminalData };

package/dist/testing/index.js

@@ -0,0 +1,8 @@
+import {
+  assertDirtyPrecedesTerminalData
+} from "../chunk-TEW47IVR.js";
+import "../chunk-DK554R7P.js";
+export {
+  assertDirtyPrecedesTerminalData
+};
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}