@vielzeug/vault 2.4.0 → 3.0.0

package/dist/query.js.map

@@ -1 +1 @@
-{"version":3,"file":"query.js","names":[],"sources":["../src/query.ts"],"sourcesContent":["import { VaultError } from './errors';\n\ntype Predicate<T> = (value: T, index: number, array: T[]) => boolean;\n/**\n * `isNonFilter`: when true this op is excluded from `count()` — it does not restrict\n * *which* records match (limit, offset, orderBy), only how results are presented.\n */\ntype QueryOp<T> = { apply: (data: T[]) => T[]; isNonFilter?: boolean };\n\nexport type QueryContext<T extends object> = {\n  deleteMany?: (records: T[]) => Promise<number>;\n  source: () => Promise<T[]>;\n};\n\n/* -------------------- Public interfaces -------------------- */\n\n/**\n * Fluent query builder. `T` is the record type.\n */\nexport interface QueryBuilder<T extends object> {\n  /**\n   * Returns the number of records matching the applied filter predicates.\n   * Presentation-only ops (`limit`, `offset`, `orderBy`) are intentionally ignored — this\n   * always counts the full filtered set, making paginated total-count queries possible\n   * without a second query.\n   */\n  count(): Promise<number>;\n  delete(): Promise<number>;\n  /**\n   * Filter records where `field` exactly equals `value`.\n   */\n  equals<K extends keyof T & string, V extends T[K]>(field: K, value: V): QueryBuilder<T>;\n  filter(fn: Predicate<T>): QueryBuilder<T>;\n  first(): Promise<T | undefined>;\n  limit(n: number): QueryBuilder<T>;\n  offset(n: number): QueryBuilder<T>;\n  orderBy<K extends keyof T>(field: K, direction?: 'asc' | 'desc'): QueryBuilder<T>;\n  toArray(): Promise<T[]>;\n}\n\n/* -------------------- Helpers -------------------- */\n\nasync function applyOps<T extends object>(ctx: QueryContext<T>, ops: readonly QueryOp<T>[]): Promise<T[]> {\n  let data = await ctx.source();\n\n  for (const op of ops) {\n    data = op.apply(data);\n  }\n\n  return data;\n}\n\nfunction assertNonNegativeInteger(value: number, name: string): number {\n  if (!Number.isInteger(value) || value < 0) {\n    throw new VaultError(`${name} must be a non-negative integer`);\n  }\n\n  return value;\n}\n\n/* -------------------- Factory -------------------- */\n\nexport function createQueryBuilder<T extends object>(\n  ctx: QueryContext<T>,\n  ops: readonly QueryOp<T>[] = [],\n): QueryBuilder<T> {\n  const append = (op: QueryOp<T>): QueryBuilder<T> => createQueryBuilder<T>(ctx, [...ops, op]);\n\n  return {\n    count(): Promise<number> {\n      const filterOps = ops.filter((op) => !op.isNonFilter);\n\n      return applyOps(ctx, filterOps).then((r) => r.length);\n    },\n    async delete(): Promise<number> {\n      if (!ctx.deleteMany) {\n        throw new VaultError('query.delete is not available for this adapter context');\n      }\n\n      const records = await applyOps(ctx, ops);\n\n      return ctx.deleteMany(records);\n    },\n    equals<K extends keyof T & string, V extends T[K]>(field: K, value: V): QueryBuilder<T> {\n      return append({ apply: (data) => data.filter((r) => r[field] === value) });\n    },\n    filter(fn) {\n      return append({ apply: (data) => data.filter(fn) });\n    },\n    first(): Promise<T | undefined> {\n      if (ops.length === 0) return ctx.source().then((r) => r[0]);\n\n      return applyOps(ctx, ops).then((r) => r[0]);\n    },\n    limit(n) {\n      const safeN = assertNonNegativeInteger(n, 'query.limit');\n\n      return append({ apply: (data) => data.slice(0, safeN), isNonFilter: true });\n    },\n    offset(n) {\n      const safeN = assertNonNegativeInteger(n, 'query.offset');\n\n      return append({ apply: (data) => data.slice(safeN), isNonFilter: true });\n    },\n    orderBy(field, direction = 'asc') {\n      return append({\n        apply: (data) => {\n          const sign = direction === 'asc' ? 1 : -1;\n\n          return [...data].sort((a, b) => {\n            const av = a[field] as number | string;\n            const bv = b[field] as number | string;\n\n            if (av === bv) return 0;\n\n            return av > bv ? sign : -sign;\n          });\n        },\n        isNonFilter: true,\n      });\n    },\n    toArray(): Promise<T[]> {\n      return applyOps(ctx, ops);\n    },\n  };\n}\n"],"mappings":";;AA0CA,eAAe,EAA2B,GAAsB,GAA0C;CACxG,IAAI,IAAO,MAAM,EAAI,OAAO;CAE5B,KAAK,IAAM,KAAM,GACf,IAAO,EAAG,MAAM,CAAI;CAGtB,OAAO;AACT;AAEA,SAAS,EAAyB,GAAe,GAAsB;CACrE,IAAI,CAAC,OAAO,UAAU,CAAK,KAAK,IAAQ,GACtC,MAAM,IAAI,EAAW,GAAG,EAAK,gCAAgC;CAG/D,OAAO;AACT;AAIA,SAAgB,EACd,GACA,IAA6B,CAAC,GACb;CACjB,IAAM,KAAU,MAAoC,EAAsB,GAAK,CAAC,GAAG,GAAK,CAAE,CAAC;CAE3F,OAAO;EACL,QAAyB;GAGvB,OAAO,EAAS,GAFE,EAAI,QAAQ,MAAO,CAAC,EAAG,WAEpB,CAAS,CAAC,CAAC,MAAM,MAAM,EAAE,MAAM;EACtD;EACA,MAAM,SAA0B;GAC9B,IAAI,CAAC,EAAI,YACP,MAAM,IAAI,EAAW,wDAAwD;GAG/E,IAAM,IAAU,MAAM,EAAS,GAAK,CAAG;GAEvC,OAAO,EAAI,WAAW,CAAO;EAC/B;EACA,OAAmD,GAAU,GAA2B;GACtF,OAAO,EAAO,EAAE,QAAQ,MAAS,EAAK,QAAQ,MAAM,EAAE,OAAW,CAAK,EAAE,CAAC;EAC3E;EACA,OAAO,GAAI;GACT,OAAO,EAAO,EAAE,QAAQ,MAAS,EAAK,OAAO,CAAE,EAAE,CAAC;EACpD;EACA,QAAgC;GAG9B,OAFI,EAAI,WAAW,IAAU,EAAI,OAAO,CAAC,CAAC,MAAM,MAAM,EAAE,EAAE,IAEnD,EAAS,GAAK,CAAG,CAAC,CAAC,MAAM,MAAM,EAAE,EAAE;EAC5C;EACA,MAAM,GAAG;GACP,IAAM,IAAQ,EAAyB,GAAG,aAAa;GAEvD,OAAO,EAAO;IAAE,QAAQ,MAAS,EAAK,MAAM,GAAG,CAAK;IAAG,aAAa;GAAK,CAAC;EAC5E;EACA,OAAO,GAAG;GACR,IAAM,IAAQ,EAAyB,GAAG,cAAc;GAExD,OAAO,EAAO;IAAE,QAAQ,MAAS,EAAK,MAAM,CAAK;IAAG,aAAa;GAAK,CAAC;EACzE;EACA,QAAQ,GAAO,IAAY,OAAO;GAChC,OAAO,EAAO;IACZ,QAAQ,MAAS;KACf,IAAM,IAAO,MAAc,QAAQ,IAAI;KAEvC,OAAO,CAAC,GAAG,CAAI,CAAC,CAAC,MAAM,GAAG,MAAM;MAC9B,IAAM,IAAK,EAAE,IACP,IAAK,EAAE;MAIb,OAFI,MAAO,IAAW,IAEf,IAAK,IAAK,IAAO,CAAC;KAC3B,CAAC;IACH;IACA,aAAa;GACf,CAAC;EACH;EACA,UAAwB;GACtB,OAAO,EAAS,GAAK,CAAG;EAC1B;CACF;AACF"}
+{"version":3,"file":"query.js","names":[],"sources":["../src/query.ts"],"sourcesContent":["import { VaultError } from './errors';\n\ntype Predicate<T> = (value: T, index: number, array: readonly T[]) => boolean;\ntype QueryOp<T> = { apply: (data: T[]) => T[]; isPresentation?: boolean };\n\nexport type QueryContext<T extends object> = {\n  deleteMany?: (records: readonly T[]) => Promise<number>;\n  source: () => Promise<T[]>;\n};\n\nexport interface QueryBuilder<T extends object> {\n  count(): Promise<number>;\n  delete(): Promise<number>;\n  equals<K extends keyof T & string>(field: K, value: T[K]): QueryBuilder<T>;\n  filter(predicate: Predicate<T>): QueryBuilder<T>;\n  first(): Promise<T | undefined>;\n  limit(count: number): QueryBuilder<T>;\n  offset(count: number): QueryBuilder<T>;\n  orderBy<K extends keyof T>(field: K, direction?: 'asc' | 'desc'): QueryBuilder<T>;\n  toArray(): Promise<T[]>;\n}\n\nconst applyOps = async <T extends object>(\n  context: QueryContext<T>,\n  operations: readonly QueryOp<T>[],\n): Promise<T[]> => {\n  let data = await context.source();\n  for (const operation of operations) data = operation.apply(data);\n  return data;\n};\n\nconst nonNegativeInteger = (value: number, name: string): number => {\n  if (!Number.isInteger(value) || value < 0) throw new VaultError(`${name} must be a non-negative integer`);\n  return value;\n};\n\nexport function createQueryBuilder<T extends object>(\n  context: QueryContext<T>,\n  operations: readonly QueryOp<T>[] = [],\n): QueryBuilder<T> {\n  const append = (operation: QueryOp<T>): QueryBuilder<T> => createQueryBuilder(context, [...operations, operation]);\n\n  return {\n    count: () =>\n      applyOps(\n        context,\n        operations.filter((operation) => !operation.isPresentation),\n      ).then((data) => data.length),\n    async delete() {\n      if (!context.deleteMany) throw new VaultError('query.delete is not available in this context');\n      return context.deleteMany(await applyOps(context, operations));\n    },\n    equals: (field, value) => append({ apply: (data) => data.filter((record) => record[field] === value) }),\n    filter: (predicate) => append({ apply: (data) => data.filter(predicate) }),\n    async first() {\n      return (await applyOps(context, operations))[0];\n    },\n    limit(count) {\n      const safeCount = nonNegativeInteger(count, 'query.limit');\n      return append({ apply: (data) => data.slice(0, safeCount), isPresentation: true });\n    },\n    offset(count) {\n      const safeCount = nonNegativeInteger(count, 'query.offset');\n      return append({ apply: (data) => data.slice(safeCount), isPresentation: true });\n    },\n    orderBy: (field, direction = 'asc') =>\n      append({\n        apply: (data) => {\n          const sign = direction === 'asc' ? 1 : -1;\n          return [...data].sort((left, right) => {\n            const a = left[field] as number | string;\n            const b = right[field] as number | string;\n            return a === b ? 0 : a > b ? sign : -sign;\n          });\n        },\n        isPresentation: true,\n      }),\n    toArray: () => applyOps(context, operations),\n  };\n}\n"],"mappings":";;AAsBA,IAAM,IAAW,OACf,GACA,MACiB;CACjB,IAAI,IAAO,MAAM,EAAQ,OAAO;CAChC,KAAK,IAAM,KAAa,GAAY,IAAO,EAAU,MAAM,CAAI;CAC/D,OAAO;AACT,GAEM,KAAsB,GAAe,MAAyB;CAClE,IAAI,CAAC,OAAO,UAAU,CAAK,KAAK,IAAQ,GAAG,MAAM,IAAI,EAAW,GAAG,EAAK,gCAAgC;CACxG,OAAO;AACT;AAEA,SAAgB,EACd,GACA,IAAoC,CAAC,GACpB;CACjB,IAAM,KAAU,MAA2C,EAAmB,GAAS,CAAC,GAAG,GAAY,CAAS,CAAC;CAEjH,OAAO;EACL,aACE,EACE,GACA,EAAW,QAAQ,MAAc,CAAC,EAAU,cAAc,CAC5D,CAAC,CAAC,MAAM,MAAS,EAAK,MAAM;EAC9B,MAAM,SAAS;GACb,IAAI,CAAC,EAAQ,YAAY,MAAM,IAAI,EAAW,+CAA+C;GAC7F,OAAO,EAAQ,WAAW,MAAM,EAAS,GAAS,CAAU,CAAC;EAC/D;EACA,SAAS,GAAO,MAAU,EAAO,EAAE,QAAQ,MAAS,EAAK,QAAQ,MAAW,EAAO,OAAW,CAAK,EAAE,CAAC;EACtG,SAAS,MAAc,EAAO,EAAE,QAAQ,MAAS,EAAK,OAAO,CAAS,EAAE,CAAC;EACzE,MAAM,QAAQ;GACZ,QAAQ,MAAM,EAAS,GAAS,CAAU,EAAA,CAAG;EAC/C;EACA,MAAM,GAAO;GACX,IAAM,IAAY,EAAmB,GAAO,aAAa;GACzD,OAAO,EAAO;IAAE,QAAQ,MAAS,EAAK,MAAM,GAAG,CAAS;IAAG,gBAAgB;GAAK,CAAC;EACnF;EACA,OAAO,GAAO;GACZ,IAAM,IAAY,EAAmB,GAAO,cAAc;GAC1D,OAAO,EAAO;IAAE,QAAQ,MAAS,EAAK,MAAM,CAAS;IAAG,gBAAgB;GAAK,CAAC;EAChF;EACA,UAAU,GAAO,IAAY,UAC3B,EAAO;GACL,QAAQ,MAAS;IACf,IAAM,IAAO,MAAc,QAAQ,IAAI;IACvC,OAAO,CAAC,GAAG,CAAI,CAAC,CAAC,MAAM,GAAM,MAAU;KACrC,IAAM,IAAI,EAAK,IACT,IAAI,EAAM;KAChB,OAAO,MAAM,IAAI,IAAI,IAAI,IAAI,IAAO,CAAC;IACvC,CAAC;GACH;GACA,gBAAgB;EAClB,CAAC;EACH,eAAe,EAAS,GAAS,CAAU;CAC7C;AACF"}

package/dist/sqlite.d.ts

@@ -1,3 +1,3 @@
-export type { SQLiteDatabase, SQLiteParameter, SQLiteStatement, SQLiteVaultOptions, SQLiteVaultStore, TransactionContext, } from './adapters/sqlite';
+export type { SQLiteDatabase, SQLiteParameter, SQLiteStatement, SQLiteVaultOptions, TransactionContext, } from './adapters/sqlite';
 export { createSQLite } from './adapters/sqlite';
 //# sourceMappingURL=sqlite.d.ts.map

package/dist/sqlite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/ttl.cjs

@@ -1,2 +1,2 @@
-const e=require("./errors.cjs");var t={days:e=>r(e*864e5,`ttl.days`),hours:e=>r(e*36e5,`ttl.hours`),minutes:e=>r(e*6e4,`ttl.minutes`),ms:e=>r(e,`ttl.ms`),seconds:e=>r(e*1e3,`ttl.seconds`)};function n(e){return e!==void 0&&Date.now()>=e}function r(t,n){if(!Number.isFinite(t)||t<=0)throw new e.VaultError(`${n} expected a finite positive number, received ${String(t)}`);return t}function i(e){if(typeof e!=`object`||!e||!(`value`in e))return;let t=e;if(!(t.expiresAt!==void 0&&(typeof t.expiresAt!=`number`||!Number.isFinite(t.expiresAt))))return t}exports.assertPositiveFinite=r,exports.isExpired=n,exports.parseStored=i,exports.ttl=t;
+const e=require("./errors.cjs");var t={days:e=>r(e*864e5,`ttl.days`),hours:e=>r(e*36e5,`ttl.hours`),minutes:e=>r(e*6e4,`ttl.minutes`),ms:e=>r(e,`ttl.ms`),seconds:e=>r(e*1e3,`ttl.seconds`)};function n(e){return e!==void 0&&Date.now()>=e}function r(t,n){if(!Number.isFinite(t)||t<=0)throw new e.VaultError(`${n} expected a finite positive number, received ${String(t)}`);return t}function i(e){if(typeof e!=`object`||!e||!(`value`in e))return;let t=e;if(t.expiresAt===void 0||typeof t.expiresAt==`number`&&Number.isFinite(t.expiresAt))return t}exports.assertPositiveFinite=r,exports.isExpired=n,exports.parseStored=i,exports.ttl=t;
 //# sourceMappingURL=ttl.cjs.map

package/dist/ttl.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ttl.cjs","names":[],"sources":["../src/ttl.ts"],"sourcesContent":["import { VaultError } from './errors';\n\n/** Duration helpers that produce finite, positive millisecond values. */\nexport const ttl = {\n  days: (n: number) => assertPositiveFinite(n * 86_400_000, 'ttl.days'),\n  hours: (n: number) => assertPositiveFinite(n * 3_600_000, 'ttl.hours'),\n  minutes: (n: number) => assertPositiveFinite(n * 60_000, 'ttl.minutes'),\n  ms: (n: number) => assertPositiveFinite(n, 'ttl.ms'),\n  seconds: (n: number) => assertPositiveFinite(n * 1000, 'ttl.seconds'),\n} as const;\n\n/** Fixed storage envelope shared by every adapter, so data and indexes stay portable. */\nexport type StoredRecord<T> = { expiresAt?: number; value: T };\n\nexport function isExpired(expiresAt: number | undefined): boolean {\n  return expiresAt !== undefined && Date.now() >= expiresAt;\n}\n\n/** Throws when `ttlMs` is not a finite, positive number. Returns it unchanged otherwise. */\nexport function assertPositiveFinite(ttlMs: number, source: string): number {\n  if (!Number.isFinite(ttlMs) || ttlMs <= 0) {\n    throw new VaultError(`${source} expected a finite positive number, received ${String(ttlMs)}`);\n  }\n\n  return ttlMs;\n}\n\nexport function parseStored<T>(raw: unknown): StoredRecord<T> | undefined {\n  if (typeof raw !== 'object' || raw === null || !('value' in raw)) return undefined;\n\n  const record = raw as { expiresAt?: unknown; value: unknown };\n\n  if (record.expiresAt !== undefined && (typeof record.expiresAt !== 'number' || !Number.isFinite(record.expiresAt))) {\n    return undefined;\n  }\n\n  return record as StoredRecord<T>;\n}\n"],"mappings":"gCAGA,IAAa,EAAM,CACjB,KAAO,GAAc,EAAqB,EAAI,MAAY,UAAU,EACpE,MAAQ,GAAc,EAAqB,EAAI,KAAW,WAAW,EACrE,QAAU,GAAc,EAAqB,EAAI,IAAQ,aAAa,EACtE,GAAK,GAAc,EAAqB,EAAG,QAAQ,EACnD,QAAU,GAAc,EAAqB,EAAI,IAAM,aAAa,CACtE,EAKA,SAAgB,EAAU,EAAwC,CAChE,OAAO,IAAc,IAAA,IAAa,KAAK,IAAI,GAAK,CAClD,CAGA,SAAgB,EAAqB,EAAe,EAAwB,CAC1E,GAAI,CAAC,OAAO,SAAS,CAAK,GAAK,GAAS,EACtC,MAAM,IAAI,EAAA,WAAW,GAAG,EAAO,+CAA+C,OAAO,CAAK,GAAG,EAG/F,OAAO,CACT,CAEA,SAAgB,EAAe,EAA2C,CACxE,GAAI,OAAO,GAAQ,WAAY,GAAgB,EAAE,UAAW,GAAM,OAElE,IAAM,EAAS,EAEX,OAAO,YAAc,IAAA,KAAc,OAAO,EAAO,WAAc,UAAY,CAAC,OAAO,SAAS,EAAO,SAAS,IAIhH,OAAO,CACT"}
+{"version":3,"file":"ttl.cjs","names":[],"sources":["../src/ttl.ts"],"sourcesContent":["import { VaultError } from './errors';\n\n/** Duration helpers that produce finite, positive millisecond values. */\nexport const ttl = {\n  days: (n: number) => assertPositiveFinite(n * 86_400_000, 'ttl.days'),\n  hours: (n: number) => assertPositiveFinite(n * 3_600_000, 'ttl.hours'),\n  minutes: (n: number) => assertPositiveFinite(n * 60_000, 'ttl.minutes'),\n  ms: (n: number) => assertPositiveFinite(n, 'ttl.ms'),\n  seconds: (n: number) => assertPositiveFinite(n * 1000, 'ttl.seconds'),\n} as const;\n\n/** Fixed storage envelope shared by every adapter, so data and indexes stay portable. */\nexport type StoredRecord<T> = { expiresAt?: number; value: T };\n\nexport function isExpired(expiresAt: number | undefined): boolean {\n  return expiresAt !== undefined && Date.now() >= expiresAt;\n}\n\n/** Throws when `ttlMs` is not a finite, positive number. Returns it unchanged otherwise. */\nexport function assertPositiveFinite(ttlMs: number, source: string): number {\n  if (!Number.isFinite(ttlMs) || ttlMs <= 0) {\n    throw new VaultError(`${source} expected a finite positive number, received ${String(ttlMs)}`);\n  }\n\n  return ttlMs;\n}\n\nexport function parseStored<T>(raw: unknown): StoredRecord<T> | undefined {\n  if (typeof raw !== 'object' || raw === null || !('value' in raw)) return undefined;\n\n  const record = raw as { expiresAt?: unknown; value: unknown };\n\n  if (record.expiresAt !== undefined && (typeof record.expiresAt !== 'number' || !Number.isFinite(record.expiresAt))) {\n    return undefined;\n  }\n\n  return record as StoredRecord<T>;\n}\n"],"mappings":"gCAGA,IAAa,EAAM,CACjB,KAAO,GAAc,EAAqB,EAAI,MAAY,UAAU,EACpE,MAAQ,GAAc,EAAqB,EAAI,KAAW,WAAW,EACrE,QAAU,GAAc,EAAqB,EAAI,IAAQ,aAAa,EACtE,GAAK,GAAc,EAAqB,EAAG,QAAQ,EACnD,QAAU,GAAc,EAAqB,EAAI,IAAM,aAAa,CACtE,EAKA,SAAgB,EAAU,EAAwC,CAChE,OAAO,IAAc,IAAA,IAAa,KAAK,IAAI,GAAK,CAClD,CAGA,SAAgB,EAAqB,EAAe,EAAwB,CAC1E,GAAI,CAAC,OAAO,SAAS,CAAK,GAAK,GAAS,EACtC,MAAM,IAAI,EAAA,WAAW,GAAG,EAAO,+CAA+C,OAAO,CAAK,GAAG,EAG/F,OAAO,CACT,CAEA,SAAgB,EAAe,EAA2C,CACxE,GAAI,OAAO,GAAQ,WAAY,GAAgB,EAAE,UAAW,GAAM,OAElE,IAAM,EAAS,EAEX,KAAO,YAAc,IAAA,IAAc,OAAO,EAAO,WAAc,UAAa,OAAO,SAAS,EAAO,SAAS,EAIhH,OAAO,CACT"}

package/dist/ttl.js

@@ -17,7 +17,7 @@ function r(t, n) {
 function i(e) {
 	if (typeof e != "object" || !e || !("value" in e)) return;
 	let t = e;
-	if (!(t.expiresAt !== void 0 && (typeof t.expiresAt != "number" || !Number.isFinite(t.expiresAt)))) return t;
+	if (t.expiresAt === void 0 || typeof t.expiresAt == "number" && Number.isFinite(t.expiresAt)) return t;
 }
 //#endregion
 export { r as assertPositiveFinite, n as isExpired, i as parseStored, t as ttl };

package/dist/ttl.js.map

@@ -1 +1 @@
-{"version":3,"file":"ttl.js","names":[],"sources":["../src/ttl.ts"],"sourcesContent":["import { VaultError } from './errors';\n\n/** Duration helpers that produce finite, positive millisecond values. */\nexport const ttl = {\n  days: (n: number) => assertPositiveFinite(n * 86_400_000, 'ttl.days'),\n  hours: (n: number) => assertPositiveFinite(n * 3_600_000, 'ttl.hours'),\n  minutes: (n: number) => assertPositiveFinite(n * 60_000, 'ttl.minutes'),\n  ms: (n: number) => assertPositiveFinite(n, 'ttl.ms'),\n  seconds: (n: number) => assertPositiveFinite(n * 1000, 'ttl.seconds'),\n} as const;\n\n/** Fixed storage envelope shared by every adapter, so data and indexes stay portable. */\nexport type StoredRecord<T> = { expiresAt?: number; value: T };\n\nexport function isExpired(expiresAt: number | undefined): boolean {\n  return expiresAt !== undefined && Date.now() >= expiresAt;\n}\n\n/** Throws when `ttlMs` is not a finite, positive number. Returns it unchanged otherwise. */\nexport function assertPositiveFinite(ttlMs: number, source: string): number {\n  if (!Number.isFinite(ttlMs) || ttlMs <= 0) {\n    throw new VaultError(`${source} expected a finite positive number, received ${String(ttlMs)}`);\n  }\n\n  return ttlMs;\n}\n\nexport function parseStored<T>(raw: unknown): StoredRecord<T> | undefined {\n  if (typeof raw !== 'object' || raw === null || !('value' in raw)) return undefined;\n\n  const record = raw as { expiresAt?: unknown; value: unknown };\n\n  if (record.expiresAt !== undefined && (typeof record.expiresAt !== 'number' || !Number.isFinite(record.expiresAt))) {\n    return undefined;\n  }\n\n  return record as StoredRecord<T>;\n}\n"],"mappings":";;AAGA,IAAa,IAAM;CACjB,OAAO,MAAc,EAAqB,IAAI,OAAY,UAAU;CACpE,QAAQ,MAAc,EAAqB,IAAI,MAAW,WAAW;CACrE,UAAU,MAAc,EAAqB,IAAI,KAAQ,aAAa;CACtE,KAAK,MAAc,EAAqB,GAAG,QAAQ;CACnD,UAAU,MAAc,EAAqB,IAAI,KAAM,aAAa;AACtE;AAKA,SAAgB,EAAU,GAAwC;CAChE,OAAO,MAAc,KAAA,KAAa,KAAK,IAAI,KAAK;AAClD;AAGA,SAAgB,EAAqB,GAAe,GAAwB;CAC1E,IAAI,CAAC,OAAO,SAAS,CAAK,KAAK,KAAS,GACtC,MAAM,IAAI,EAAW,GAAG,EAAO,+CAA+C,OAAO,CAAK,GAAG;CAG/F,OAAO;AACT;AAEA,SAAgB,EAAe,GAA2C;CACxE,IAAI,OAAO,KAAQ,aAAY,KAAgB,EAAE,WAAW,IAAM;CAElE,IAAM,IAAS;CAEX,QAAO,cAAc,KAAA,MAAc,OAAO,EAAO,aAAc,YAAY,CAAC,OAAO,SAAS,EAAO,SAAS,KAIhH,OAAO;AACT"}
+{"version":3,"file":"ttl.js","names":[],"sources":["../src/ttl.ts"],"sourcesContent":["import { VaultError } from './errors';\n\n/** Duration helpers that produce finite, positive millisecond values. */\nexport const ttl = {\n  days: (n: number) => assertPositiveFinite(n * 86_400_000, 'ttl.days'),\n  hours: (n: number) => assertPositiveFinite(n * 3_600_000, 'ttl.hours'),\n  minutes: (n: number) => assertPositiveFinite(n * 60_000, 'ttl.minutes'),\n  ms: (n: number) => assertPositiveFinite(n, 'ttl.ms'),\n  seconds: (n: number) => assertPositiveFinite(n * 1000, 'ttl.seconds'),\n} as const;\n\n/** Fixed storage envelope shared by every adapter, so data and indexes stay portable. */\nexport type StoredRecord<T> = { expiresAt?: number; value: T };\n\nexport function isExpired(expiresAt: number | undefined): boolean {\n  return expiresAt !== undefined && Date.now() >= expiresAt;\n}\n\n/** Throws when `ttlMs` is not a finite, positive number. Returns it unchanged otherwise. */\nexport function assertPositiveFinite(ttlMs: number, source: string): number {\n  if (!Number.isFinite(ttlMs) || ttlMs <= 0) {\n    throw new VaultError(`${source} expected a finite positive number, received ${String(ttlMs)}`);\n  }\n\n  return ttlMs;\n}\n\nexport function parseStored<T>(raw: unknown): StoredRecord<T> | undefined {\n  if (typeof raw !== 'object' || raw === null || !('value' in raw)) return undefined;\n\n  const record = raw as { expiresAt?: unknown; value: unknown };\n\n  if (record.expiresAt !== undefined && (typeof record.expiresAt !== 'number' || !Number.isFinite(record.expiresAt))) {\n    return undefined;\n  }\n\n  return record as StoredRecord<T>;\n}\n"],"mappings":";;AAGA,IAAa,IAAM;CACjB,OAAO,MAAc,EAAqB,IAAI,OAAY,UAAU;CACpE,QAAQ,MAAc,EAAqB,IAAI,MAAW,WAAW;CACrE,UAAU,MAAc,EAAqB,IAAI,KAAQ,aAAa;CACtE,KAAK,MAAc,EAAqB,GAAG,QAAQ;CACnD,UAAU,MAAc,EAAqB,IAAI,KAAM,aAAa;AACtE;AAKA,SAAgB,EAAU,GAAwC;CAChE,OAAO,MAAc,KAAA,KAAa,KAAK,IAAI,KAAK;AAClD;AAGA,SAAgB,EAAqB,GAAe,GAAwB;CAC1E,IAAI,CAAC,OAAO,SAAS,CAAK,KAAK,KAAS,GACtC,MAAM,IAAI,EAAW,GAAG,EAAO,+CAA+C,OAAO,CAAK,GAAG;CAG/F,OAAO;AACT;AAEA,SAAgB,EAAe,GAA2C;CACxE,IAAI,OAAO,KAAQ,aAAY,KAAgB,EAAE,WAAW,IAAM;CAElE,IAAM,IAAS;CAEX,MAAO,cAAc,KAAA,KAAc,OAAO,EAAO,aAAc,YAAa,OAAO,SAAS,EAAO,SAAS,GAIhH,OAAO;AACT"}

package/dist/types.cjs

@@ -1,2 +1,2 @@
-const e=require("./errors.cjs"),t=require("./ttl.cjs");function n(n,r={}){let{defaultTtl:i,indexes:a}=r;if(i!==void 0&&t.assertPositiveFinite(i,`table: defaultTtl`),a){let t=new Set;for(let n of a){if(t.has(n))throw new e.VaultError(`table: index "${n}" is already registered`);t.add(n)}}return{defaultTtl:i,indexes:a,key:n}}exports.table=n;
+const e=require("./errors.cjs"),t=require("./ttl.cjs");function n(e){return{decode:t=>e.parse(t),encode:e=>e}}function r(n,r={}){let{defaultTtl:i,indexes:a}=r;if(i!==void 0&&t.assertPositiveFinite(i,`table: defaultTtl`),a){let t=new Set;for(let n of a){if(t.has(n))throw new e.VaultError(`table: index "${n}" is already registered`);t.add(n)}}return{defaultTtl:i,indexes:a,key:n}}exports.table=r,exports.validatorCodec=n;
 //# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["/// <reference lib=\"dom\" />\n\nimport { VaultError } from './errors';\nimport type { QueryBuilder } from './query';\nimport { assertPositiveFinite } from './ttl';\n\n/** Portable primary-key values. Vault preserves their type and encodes them distinctly at rest. */\nexport type VaultKey = number | string;\n\n/** A typed table definition whose primary-key field must hold a portable Vault key. */\nexport type SchemaEntry<T extends object, Key extends keyof T & string = keyof T & string> = {\n  defaultTtl?: number;\n  /** IndexedDB creates these as `value.<field>` indexes; other stores filter in memory. */\n  indexes?: readonly (keyof T & string)[];\n  key: Key;\n};\n\nexport type AnySchema = Record<string, { defaultTtl?: number; indexes?: readonly string[]; key: string }>;\n\nexport type RecordOf<S extends AnySchema, K extends keyof S> =\n  S[K] extends SchemaEntry<infer R, infer _Key> ? R : never;\nexport type KeyOf<S extends AnySchema, K extends keyof S> = Extract<\n  S[K] extends SchemaEntry<infer R, infer Key> ? R[Key] : never,\n  VaultKey\n>;\n\nexport type RecordValidator<T> = {\n  parse(value: unknown): T;\n};\n\nexport type TableValidators<S extends AnySchema> = {\n  [K in keyof S]?: RecordValidator<RecordOf<S, K>>;\n};\n\nexport type Observer<T> = (records: T[]) => void;\nexport type Unsubscribe = () => void;\n\n/** Shared factory options. Values always use Vault's fixed `{ value, expiresAt? }` envelope. */\nexport type BaseAdapterOptions<S extends AnySchema> = {\n  schema: S;\n  validators?: TableValidators<S>;\n};\n\n/** Methods available within an IndexedDB or SQLite transaction. */\nexport type TransactionContext<S extends AnySchema, K extends keyof S & string = keyof S & string> = {\n  clear<T extends K>(table: T): Promise<void>;\n  count<T extends K>(table: T): Promise<number>;\n  delete<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;\n  deleteMany<T extends K>(table: T, keys: KeyOf<S, T>[]): Promise<number>;\n  get<T extends K>(table: T, key: KeyOf<S, T>): Promise<RecordOf<S, T> | undefined>;\n  getAll<T extends K>(table: T): Promise<RecordOf<S, T>[]>;\n  getMany<T extends K>(table: T, keys: KeyOf<S, T>[]): Promise<Array<RecordOf<S, T> | undefined>>;\n  has<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;\n  isEmpty<T extends K>(table: T): Promise<boolean>;\n  keys<T extends K>(table: T, filter?: (record: RecordOf<S, T>) => boolean): Promise<KeyOf<S, T>[]>;\n  put<T extends K>(table: T, value: RecordOf<S, T>, ttl?: number): Promise<void>;\n  putAll<T extends K>(table: T, values: RecordOf<S, T>[], ttl?: number): Promise<void>;\n  query<T extends K>(table: T): QueryBuilder<RecordOf<S, T>>;\n  update<T extends K>(\n    table: T,\n    key: KeyOf<S, T>,\n    changes: Partial<RecordOf<S, T>>,\n    ttl?: number,\n  ): Promise<RecordOf<S, T> | undefined>;\n  upsert<T extends K>(\n    table: T,\n    key: KeyOf<S, T>,\n    fn: (existing: RecordOf<S, T> | undefined) => RecordOf<S, T>,\n    ttl?: number,\n  ): Promise<RecordOf<S, T>>;\n};\n\n/** Portable API returned by memory and Web Storage factories. */\nexport interface VaultStore<S extends AnySchema> {\n  clear<K extends keyof S & string>(table: K): Promise<void>;\n  count<K extends keyof S & string>(table: K): Promise<number>;\n  delete<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<boolean>;\n  deleteMany<K extends keyof S & string>(table: K, keys: KeyOf<S, K>[]): Promise<number>;\n  readonly disposalSignal: AbortSignal;\n  dispose(): Promise<void>;\n  readonly disposed: boolean;\n  get<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<RecordOf<S, K> | undefined>;\n  getAll<K extends keyof S & string>(table: K): Promise<RecordOf<S, K>[]>;\n  getMany<K extends keyof S & string>(table: K, keys: KeyOf<S, K>[]): Promise<Array<RecordOf<S, K> | undefined>>;\n  has<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<boolean>;\n  isEmpty<K extends keyof S & string>(table: K): Promise<boolean>;\n  keys<K extends keyof S & string>(table: K, filter?: (record: RecordOf<S, K>) => boolean): Promise<KeyOf<S, K>[]>;\n  observe<K extends keyof S & string>(\n    table: K,\n    listener: Observer<RecordOf<S, K>>,\n    options?: { immediate?: boolean; signal?: AbortSignal },\n  ): Unsubscribe;\n  pruneExpired(): Promise<Record<keyof S & string, number>>;\n  put<K extends keyof S & string>(table: K, value: RecordOf<S, K>, ttl?: number): Promise<void>;\n  putAll<K extends keyof S & string>(table: K, values: RecordOf<S, K>[], ttl?: number): Promise<void>;\n  query<K extends keyof S & string>(table: K): QueryBuilder<RecordOf<S, K>>;\n  update<K extends keyof S & string>(\n    table: K,\n    key: KeyOf<S, K>,\n    changes: Partial<RecordOf<S, K>>,\n    ttl?: number,\n  ): Promise<RecordOf<S, K> | undefined>;\n  upsert<K extends keyof S & string>(\n    table: K,\n    key: KeyOf<S, K>,\n    fn: (existing: RecordOf<S, K> | undefined) => RecordOf<S, K>,\n    ttl?: number,\n  ): Promise<RecordOf<S, K>>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\n/** Atomic, scoped transactions and lazy iteration supplied by storage engines that support them. */\nexport interface TransactionalVaultStore<S extends AnySchema> extends VaultStore<S> {\n  batch<K extends keyof S & string, R>(\n    tables: readonly K[],\n    fn: (tx: TransactionContext<S, K>) => Promise<R>,\n  ): Promise<R>;\n  iterate<K extends keyof S & string>(table: K): AsyncIterable<RecordOf<S, K>>;\n}\n\n/** Define a typed table whose primary-key field holds a portable Vault key. */\nexport function table<T extends object, Key extends keyof T & string = keyof T & string>(\n  key: Key,\n  options: { defaultTtl?: number; indexes?: readonly (keyof T & string)[] } = {},\n): SchemaEntry<T, Key> {\n  const { defaultTtl, indexes } = options;\n\n  if (defaultTtl !== undefined) assertPositiveFinite(defaultTtl, 'table: defaultTtl');\n\n  if (indexes) {\n    const seen = new Set<string>();\n\n    for (const field of indexes) {\n      if (seen.has(field)) {\n        throw new VaultError(`table: index \"${field}\" is already registered`);\n      }\n\n      seen.add(field);\n    }\n  }\n\n  return { defaultTtl, indexes, key } as unknown as SchemaEntry<T, Key>;\n}\n"],"mappings":"uDAyHA,SAAgB,EACd,EACA,EAA4E,CAAC,EACxD,CACrB,GAAM,CAAE,aAAY,WAAY,EAIhC,GAFI,IAAe,IAAA,IAAW,EAAA,qBAAqB,EAAY,mBAAmB,EAE9E,EAAS,CACX,IAAM,EAAO,IAAI,IAEjB,IAAK,IAAM,KAAS,EAAS,CAC3B,GAAI,EAAK,IAAI,CAAK,EAChB,MAAM,IAAI,EAAA,WAAW,iBAAiB,EAAM,wBAAwB,EAGtE,EAAK,IAAI,CAAK,CAChB,CACF,CAEA,MAAO,CAAE,aAAY,UAAS,KAAI,CACpC"}
+{"version":3,"file":"types.cjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["/// <reference lib=\"dom\" />\n\nimport { VaultError } from './errors';\nimport type { QueryBuilder } from './query';\nimport { assertPositiveFinite } from './ttl';\n\n/** Portable primary-key values. Vault preserves their type and encodes them distinctly at rest. */\nexport type VaultKey = number | string;\n\n/** A typed table definition whose primary-key field must hold a portable Vault key. */\nexport type SchemaEntry<T extends object, Key extends keyof T & string = keyof T & string> = {\n  defaultTtl?: number;\n  /** IndexedDB creates these as `value.<field>` indexes; other stores filter in memory. */\n  indexes?: readonly (keyof T & string)[];\n  key: Key;\n};\n\nexport type AnySchema = Record<string, { defaultTtl?: number; indexes?: readonly string[]; key: string }>;\n\nexport type RecordOf<S extends AnySchema, K extends keyof S> =\n  S[K] extends SchemaEntry<infer R, infer _Key> ? R : never;\nexport type KeyOf<S extends AnySchema, K extends keyof S> = Extract<\n  S[K] extends SchemaEntry<infer R, infer Key> ? R[Key] : never,\n  VaultKey\n>;\n\n/** A codec validates and decodes persisted values crossing a trust boundary. */\nexport type RecordCodec<T> = {\n  decode(value: unknown): T;\n  encode(value: T): unknown;\n};\n\nexport type RecordParser<T> = {\n  parse(value: unknown): T;\n};\n\nexport type CodecInput<T> = RecordCodec<T> | RecordParser<T>;\n\nexport type TableCodecs<S extends AnySchema> = {\n  [K in keyof S]: CodecInput<RecordOf<S, K>>;\n};\n\n/** A validator-only codec: encodes values as-is, validates on decode. */\nexport function validatorCodec<T>(validator: RecordParser<T>): RecordCodec<T> {\n  return {\n    decode: (value) => validator.parse(value),\n    encode: (value) => value,\n  };\n}\n\nexport type Observer<T> = (records: T[]) => void;\nexport type Unsubscribe = () => void;\n\n/** Shared factory options for stores that do not require durable codecs. */\nexport type MemoryStoreOptions<S extends AnySchema> = {\n  schema: S;\n  /** Optional per-table codecs. Memory values never cross a trust boundary, so codecs may be omitted. */\n  codecs?: TableCodecs<S>;\n};\n\n/** Shared factory options for durable stores whose values cross a trust boundary. */\nexport type DurableStoreOptions<S extends AnySchema> = {\n  schema: S;\n  /** Required per-table codecs. Persisted values are decoded through these before entering typed code. */\n  codecs: TableCodecs<S>;\n};\n\nexport type VaultConveniences<S extends AnySchema, K extends keyof S & string = keyof S & string> = {\n  count<T extends K>(table: T): Promise<number>;\n  deleteMany<T extends K>(table: T, keys: readonly KeyOf<S, T>[]): Promise<number>;\n  getMany<T extends K>(table: T, keys: readonly KeyOf<S, T>[]): Promise<Array<RecordOf<S, T> | undefined>>;\n  has<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;\n  isEmpty<T extends K>(table: T): Promise<boolean>;\n  keys<T extends K>(table: T, filter?: (record: RecordOf<S, T>) => boolean): Promise<KeyOf<S, T>[]>;\n  query<T extends K>(table: T): QueryBuilder<RecordOf<S, T>>;\n  update<T extends K>(\n    table: T,\n    key: KeyOf<S, T>,\n    changes: Partial<RecordOf<S, T>>,\n    ttl?: number,\n  ): Promise<RecordOf<S, T> | undefined>;\n  upsert<T extends K>(\n    table: T,\n    key: KeyOf<S, T>,\n    update: (existing: RecordOf<S, T> | undefined) => RecordOf<S, T>,\n    ttl?: number,\n  ): Promise<RecordOf<S, T>>;\n};\n\n/** Methods available within an IndexedDB or SQLite transaction. */\nexport type TransactionContext<S extends AnySchema, K extends keyof S & string = keyof S & string> = VaultConveniences<\n  S,\n  K\n> & {\n  clear<T extends K>(table: T): Promise<void>;\n  delete<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;\n  get<T extends K>(table: T, key: KeyOf<S, T>): Promise<RecordOf<S, T> | undefined>;\n  getAll<T extends K>(table: T): Promise<RecordOf<S, T>[]>;\n  iterate<T extends K>(table: T): AsyncIterable<RecordOf<S, T>>;\n  put<T extends K>(table: T, value: RecordOf<S, T>, ttl?: number): Promise<RecordOf<S, T>>;\n  putAll<T extends K>(table: T, values: readonly RecordOf<S, T>[], ttl?: number): Promise<void>;\n};\n\n/** Key-value store for Memory and Web Storage: core CRUD, observation, TTL, and pruning. */\nexport interface KeyValueVaultStore<S extends AnySchema> extends VaultConveniences<S> {\n  clear<K extends keyof S & string>(table: K): Promise<void>;\n  delete<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<boolean>;\n  readonly disposalSignal: AbortSignal;\n  dispose(): Promise<void>;\n  readonly disposed: boolean;\n  get<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<RecordOf<S, K> | undefined>;\n  getAll<K extends keyof S & string>(table: K): Promise<RecordOf<S, K>[]>;\n  observe<K extends keyof S & string>(\n    table: K,\n    listener: Observer<RecordOf<S, K>>,\n    options?: { immediate?: boolean; signal?: AbortSignal },\n  ): Unsubscribe;\n  pruneExpired(): Promise<Record<keyof S & string, number>>;\n  put<K extends keyof S & string>(table: K, value: RecordOf<S, K>, ttl?: number): Promise<RecordOf<S, K>>;\n  putAll<K extends keyof S & string>(table: K, values: readonly RecordOf<S, K>[], ttl?: number): Promise<void>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\n/** Document store for IndexedDB and SQLite: adds atomic transactions and lazy iteration. */\nexport interface DocumentVaultStore<S extends AnySchema> extends KeyValueVaultStore<S> {\n  batch<K extends keyof S & string, R>(\n    tables: readonly K[],\n    fn: (tx: TransactionContext<S, K>) => Promise<R>,\n  ): Promise<R>;\n  iterate<K extends keyof S & string>(table: K): AsyncIterable<RecordOf<S, K>>;\n}\n\ntype VaultKeyField<T extends object> = {\n  [K in keyof T & string]: T[K] extends VaultKey ? K : never;\n}[keyof T & string];\n\n/** Define a typed table whose primary-key field holds a portable Vault key. */\nexport function table<T extends object, Key extends VaultKeyField<T> = VaultKeyField<T>>(\n  key: Key,\n  options: { defaultTtl?: number; indexes?: readonly (keyof T & string)[] } = {},\n): SchemaEntry<T, Key> {\n  const { defaultTtl, indexes } = options;\n\n  if (defaultTtl !== undefined) assertPositiveFinite(defaultTtl, 'table: defaultTtl');\n\n  if (indexes) {\n    const seen = new Set<string>();\n\n    for (const field of indexes) {\n      if (seen.has(field)) {\n        throw new VaultError(`table: index \"${field}\" is already registered`);\n      }\n\n      seen.add(field);\n    }\n  }\n\n  return { defaultTtl, indexes, key };\n}\n"],"mappings":"uDA2CA,SAAgB,EAAkB,EAA4C,CAC5E,MAAO,CACL,OAAS,GAAU,EAAU,MAAM,CAAK,EACxC,OAAS,GAAU,CACrB,CACF,CAyFA,SAAgB,EACd,EACA,EAA4E,CAAC,EACxD,CACrB,GAAM,CAAE,aAAY,WAAY,EAIhC,GAFI,IAAe,IAAA,IAAW,EAAA,qBAAqB,EAAY,mBAAmB,EAE9E,EAAS,CACX,IAAM,EAAO,IAAI,IAEjB,IAAK,IAAM,KAAS,EAAS,CAC3B,GAAI,EAAK,IAAI,CAAK,EAChB,MAAM,IAAI,EAAA,WAAW,iBAAiB,EAAM,wBAAwB,EAGtE,EAAK,IAAI,CAAK,CAChB,CACF,CAEA,MAAO,CAAE,aAAY,UAAS,KAAI,CACpC"}

package/dist/types.d.ts

@@ -15,72 +15,85 @@ export type AnySchema = Record<string, {
 }>;
 export type RecordOf<S extends AnySchema, K extends keyof S> = S[K] extends SchemaEntry<infer R, infer _Key> ? R : never;
 export type KeyOf<S extends AnySchema, K extends keyof S> = Extract<S[K] extends SchemaEntry<infer R, infer Key> ? R[Key] : never, VaultKey>;
-export type RecordValidator<T> = {
+/** A codec validates and decodes persisted values crossing a trust boundary. */
+export type RecordCodec<T> = {
+    decode(value: unknown): T;
+    encode(value: T): unknown;
+};
+export type RecordParser<T> = {
     parse(value: unknown): T;
 };
-export type TableValidators<S extends AnySchema> = {
-    [K in keyof S]?: RecordValidator<RecordOf<S, K>>;
+export type CodecInput<T> = RecordCodec<T> | RecordParser<T>;
+export type TableCodecs<S extends AnySchema> = {
+    [K in keyof S]: CodecInput<RecordOf<S, K>>;
 };
+/** A validator-only codec: encodes values as-is, validates on decode. */
+export declare function validatorCodec<T>(validator: RecordParser<T>): RecordCodec<T>;
 export type Observer<T> = (records: T[]) => void;
 export type Unsubscribe = () => void;
-/** Shared factory options. Values always use Vault's fixed `{ value, expiresAt? }` envelope. */
-export type BaseAdapterOptions<S extends AnySchema> = {
+/** Shared factory options for stores that do not require durable codecs. */
+export type MemoryStoreOptions<S extends AnySchema> = {
     schema: S;
-    validators?: TableValidators<S>;
+    /** Optional per-table codecs. Memory values never cross a trust boundary, so codecs may be omitted. */
+    codecs?: TableCodecs<S>;
 };
-/** Methods available within an IndexedDB or SQLite transaction. */
-export type TransactionContext<S extends AnySchema, K extends keyof S & string = keyof S & string> = {
-    clear<T extends K>(table: T): Promise<void>;
+/** Shared factory options for durable stores whose values cross a trust boundary. */
+export type DurableStoreOptions<S extends AnySchema> = {
+    schema: S;
+    /** Required per-table codecs. Persisted values are decoded through these before entering typed code. */
+    codecs: TableCodecs<S>;
+};
+export type VaultConveniences<S extends AnySchema, K extends keyof S & string = keyof S & string> = {
     count<T extends K>(table: T): Promise<number>;
-    delete<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;
-    deleteMany<T extends K>(table: T, keys: KeyOf<S, T>[]): Promise<number>;
-    get<T extends K>(table: T, key: KeyOf<S, T>): Promise<RecordOf<S, T> | undefined>;
-    getAll<T extends K>(table: T): Promise<RecordOf<S, T>[]>;
-    getMany<T extends K>(table: T, keys: KeyOf<S, T>[]): Promise<Array<RecordOf<S, T> | undefined>>;
+    deleteMany<T extends K>(table: T, keys: readonly KeyOf<S, T>[]): Promise<number>;
+    getMany<T extends K>(table: T, keys: readonly KeyOf<S, T>[]): Promise<Array<RecordOf<S, T> | undefined>>;
     has<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;
     isEmpty<T extends K>(table: T): Promise<boolean>;
     keys<T extends K>(table: T, filter?: (record: RecordOf<S, T>) => boolean): Promise<KeyOf<S, T>[]>;
-    put<T extends K>(table: T, value: RecordOf<S, T>, ttl?: number): Promise<void>;
-    putAll<T extends K>(table: T, values: RecordOf<S, T>[], ttl?: number): Promise<void>;
     query<T extends K>(table: T): QueryBuilder<RecordOf<S, T>>;
     update<T extends K>(table: T, key: KeyOf<S, T>, changes: Partial<RecordOf<S, T>>, ttl?: number): Promise<RecordOf<S, T> | undefined>;
-    upsert<T extends K>(table: T, key: KeyOf<S, T>, fn: (existing: RecordOf<S, T> | undefined) => RecordOf<S, T>, ttl?: number): Promise<RecordOf<S, T>>;
+    upsert<T extends K>(table: T, key: KeyOf<S, T>, update: (existing: RecordOf<S, T> | undefined) => RecordOf<S, T>, ttl?: number): Promise<RecordOf<S, T>>;
+};
+/** Methods available within an IndexedDB or SQLite transaction. */
+export type TransactionContext<S extends AnySchema, K extends keyof S & string = keyof S & string> = VaultConveniences<S, K> & {
+    clear<T extends K>(table: T): Promise<void>;
+    delete<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;
+    get<T extends K>(table: T, key: KeyOf<S, T>): Promise<RecordOf<S, T> | undefined>;
+    getAll<T extends K>(table: T): Promise<RecordOf<S, T>[]>;
+    iterate<T extends K>(table: T): AsyncIterable<RecordOf<S, T>>;
+    put<T extends K>(table: T, value: RecordOf<S, T>, ttl?: number): Promise<RecordOf<S, T>>;
+    putAll<T extends K>(table: T, values: readonly RecordOf<S, T>[], ttl?: number): Promise<void>;
 };
-/** Portable API returned by memory and Web Storage factories. */
-export interface VaultStore<S extends AnySchema> {
+/** Key-value store for Memory and Web Storage: core CRUD, observation, TTL, and pruning. */
+export interface KeyValueVaultStore<S extends AnySchema> extends VaultConveniences<S> {
     clear<K extends keyof S & string>(table: K): Promise<void>;
-    count<K extends keyof S & string>(table: K): Promise<number>;
     delete<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<boolean>;
-    deleteMany<K extends keyof S & string>(table: K, keys: KeyOf<S, K>[]): Promise<number>;
     readonly disposalSignal: AbortSignal;
     dispose(): Promise<void>;
     readonly disposed: boolean;
     get<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<RecordOf<S, K> | undefined>;
     getAll<K extends keyof S & string>(table: K): Promise<RecordOf<S, K>[]>;
-    getMany<K extends keyof S & string>(table: K, keys: KeyOf<S, K>[]): Promise<Array<RecordOf<S, K> | undefined>>;
-    has<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<boolean>;
-    isEmpty<K extends keyof S & string>(table: K): Promise<boolean>;
-    keys<K extends keyof S & string>(table: K, filter?: (record: RecordOf<S, K>) => boolean): Promise<KeyOf<S, K>[]>;
     observe<K extends keyof S & string>(table: K, listener: Observer<RecordOf<S, K>>, options?: {
         immediate?: boolean;
         signal?: AbortSignal;
     }): Unsubscribe;
     pruneExpired(): Promise<Record<keyof S & string, number>>;
-    put<K extends keyof S & string>(table: K, value: RecordOf<S, K>, ttl?: number): Promise<void>;
-    putAll<K extends keyof S & string>(table: K, values: RecordOf<S, K>[], ttl?: number): Promise<void>;
-    query<K extends keyof S & string>(table: K): QueryBuilder<RecordOf<S, K>>;
-    update<K extends keyof S & string>(table: K, key: KeyOf<S, K>, changes: Partial<RecordOf<S, K>>, ttl?: number): Promise<RecordOf<S, K> | undefined>;
-    upsert<K extends keyof S & string>(table: K, key: KeyOf<S, K>, fn: (existing: RecordOf<S, K> | undefined) => RecordOf<S, K>, ttl?: number): Promise<RecordOf<S, K>>;
+    put<K extends keyof S & string>(table: K, value: RecordOf<S, K>, ttl?: number): Promise<RecordOf<S, K>>;
+    putAll<K extends keyof S & string>(table: K, values: readonly RecordOf<S, K>[], ttl?: number): Promise<void>;
     [Symbol.asyncDispose](): Promise<void>;
 }
-/** Atomic, scoped transactions and lazy iteration supplied by storage engines that support them. */
-export interface TransactionalVaultStore<S extends AnySchema> extends VaultStore<S> {
+/** Document store for IndexedDB and SQLite: adds atomic transactions and lazy iteration. */
+export interface DocumentVaultStore<S extends AnySchema> extends KeyValueVaultStore<S> {
     batch<K extends keyof S & string, R>(tables: readonly K[], fn: (tx: TransactionContext<S, K>) => Promise<R>): Promise<R>;
     iterate<K extends keyof S & string>(table: K): AsyncIterable<RecordOf<S, K>>;
 }
+type VaultKeyField<T extends object> = {
+    [K in keyof T & string]: T[K] extends VaultKey ? K : never;
+}[keyof T & string];
 /** Define a typed table whose primary-key field holds a portable Vault key. */
-export declare function table<T extends object, Key extends keyof T & string = keyof T & string>(key: Key, options?: {
+export declare function table<T extends object, Key extends VaultKeyField<T> = VaultKeyField<T>>(key: Key, options?: {
     defaultTtl?: number;
     indexes?: readonly (keyof T & string)[];
 }): SchemaEntry<T, Key>;
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,7 +1,13 @@
 import { VaultError as e } from "./errors.js";
 import { assertPositiveFinite as t } from "./ttl.js";
 //#region src/types.ts
-function n(n, r = {}) {
+function n(e) {
+	return {
+		decode: (t) => e.parse(t),
+		encode: (e) => e
+	};
+}
+function r(n, r = {}) {
 	let { defaultTtl: i, indexes: a } = r;
 	if (i !== void 0 && t(i, "table: defaultTtl"), a) {
 		let t = /* @__PURE__ */ new Set();
@@ -17,6 +23,6 @@ function n(n, r = {}) {
 	};
 }
 //#endregion
-export { n as table };
+export { r as table, n as validatorCodec };
 
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/// <reference lib=\"dom\" />\n\nimport { VaultError } from './errors';\nimport type { QueryBuilder } from './query';\nimport { assertPositiveFinite } from './ttl';\n\n/** Portable primary-key values. Vault preserves their type and encodes them distinctly at rest. */\nexport type VaultKey = number | string;\n\n/** A typed table definition whose primary-key field must hold a portable Vault key. */\nexport type SchemaEntry<T extends object, Key extends keyof T & string = keyof T & string> = {\n  defaultTtl?: number;\n  /** IndexedDB creates these as `value.<field>` indexes; other stores filter in memory. */\n  indexes?: readonly (keyof T & string)[];\n  key: Key;\n};\n\nexport type AnySchema = Record<string, { defaultTtl?: number; indexes?: readonly string[]; key: string }>;\n\nexport type RecordOf<S extends AnySchema, K extends keyof S> =\n  S[K] extends SchemaEntry<infer R, infer _Key> ? R : never;\nexport type KeyOf<S extends AnySchema, K extends keyof S> = Extract<\n  S[K] extends SchemaEntry<infer R, infer Key> ? R[Key] : never,\n  VaultKey\n>;\n\nexport type RecordValidator<T> = {\n  parse(value: unknown): T;\n};\n\nexport type TableValidators<S extends AnySchema> = {\n  [K in keyof S]?: RecordValidator<RecordOf<S, K>>;\n};\n\nexport type Observer<T> = (records: T[]) => void;\nexport type Unsubscribe = () => void;\n\n/** Shared factory options. Values always use Vault's fixed `{ value, expiresAt? }` envelope. */\nexport type BaseAdapterOptions<S extends AnySchema> = {\n  schema: S;\n  validators?: TableValidators<S>;\n};\n\n/** Methods available within an IndexedDB or SQLite transaction. */\nexport type TransactionContext<S extends AnySchema, K extends keyof S & string = keyof S & string> = {\n  clear<T extends K>(table: T): Promise<void>;\n  count<T extends K>(table: T): Promise<number>;\n  delete<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;\n  deleteMany<T extends K>(table: T, keys: KeyOf<S, T>[]): Promise<number>;\n  get<T extends K>(table: T, key: KeyOf<S, T>): Promise<RecordOf<S, T> | undefined>;\n  getAll<T extends K>(table: T): Promise<RecordOf<S, T>[]>;\n  getMany<T extends K>(table: T, keys: KeyOf<S, T>[]): Promise<Array<RecordOf<S, T> | undefined>>;\n  has<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;\n  isEmpty<T extends K>(table: T): Promise<boolean>;\n  keys<T extends K>(table: T, filter?: (record: RecordOf<S, T>) => boolean): Promise<KeyOf<S, T>[]>;\n  put<T extends K>(table: T, value: RecordOf<S, T>, ttl?: number): Promise<void>;\n  putAll<T extends K>(table: T, values: RecordOf<S, T>[], ttl?: number): Promise<void>;\n  query<T extends K>(table: T): QueryBuilder<RecordOf<S, T>>;\n  update<T extends K>(\n    table: T,\n    key: KeyOf<S, T>,\n    changes: Partial<RecordOf<S, T>>,\n    ttl?: number,\n  ): Promise<RecordOf<S, T> | undefined>;\n  upsert<T extends K>(\n    table: T,\n    key: KeyOf<S, T>,\n    fn: (existing: RecordOf<S, T> | undefined) => RecordOf<S, T>,\n    ttl?: number,\n  ): Promise<RecordOf<S, T>>;\n};\n\n/** Portable API returned by memory and Web Storage factories. */\nexport interface VaultStore<S extends AnySchema> {\n  clear<K extends keyof S & string>(table: K): Promise<void>;\n  count<K extends keyof S & string>(table: K): Promise<number>;\n  delete<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<boolean>;\n  deleteMany<K extends keyof S & string>(table: K, keys: KeyOf<S, K>[]): Promise<number>;\n  readonly disposalSignal: AbortSignal;\n  dispose(): Promise<void>;\n  readonly disposed: boolean;\n  get<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<RecordOf<S, K> | undefined>;\n  getAll<K extends keyof S & string>(table: K): Promise<RecordOf<S, K>[]>;\n  getMany<K extends keyof S & string>(table: K, keys: KeyOf<S, K>[]): Promise<Array<RecordOf<S, K> | undefined>>;\n  has<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<boolean>;\n  isEmpty<K extends keyof S & string>(table: K): Promise<boolean>;\n  keys<K extends keyof S & string>(table: K, filter?: (record: RecordOf<S, K>) => boolean): Promise<KeyOf<S, K>[]>;\n  observe<K extends keyof S & string>(\n    table: K,\n    listener: Observer<RecordOf<S, K>>,\n    options?: { immediate?: boolean; signal?: AbortSignal },\n  ): Unsubscribe;\n  pruneExpired(): Promise<Record<keyof S & string, number>>;\n  put<K extends keyof S & string>(table: K, value: RecordOf<S, K>, ttl?: number): Promise<void>;\n  putAll<K extends keyof S & string>(table: K, values: RecordOf<S, K>[], ttl?: number): Promise<void>;\n  query<K extends keyof S & string>(table: K): QueryBuilder<RecordOf<S, K>>;\n  update<K extends keyof S & string>(\n    table: K,\n    key: KeyOf<S, K>,\n    changes: Partial<RecordOf<S, K>>,\n    ttl?: number,\n  ): Promise<RecordOf<S, K> | undefined>;\n  upsert<K extends keyof S & string>(\n    table: K,\n    key: KeyOf<S, K>,\n    fn: (existing: RecordOf<S, K> | undefined) => RecordOf<S, K>,\n    ttl?: number,\n  ): Promise<RecordOf<S, K>>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\n/** Atomic, scoped transactions and lazy iteration supplied by storage engines that support them. */\nexport interface TransactionalVaultStore<S extends AnySchema> extends VaultStore<S> {\n  batch<K extends keyof S & string, R>(\n    tables: readonly K[],\n    fn: (tx: TransactionContext<S, K>) => Promise<R>,\n  ): Promise<R>;\n  iterate<K extends keyof S & string>(table: K): AsyncIterable<RecordOf<S, K>>;\n}\n\n/** Define a typed table whose primary-key field holds a portable Vault key. */\nexport function table<T extends object, Key extends keyof T & string = keyof T & string>(\n  key: Key,\n  options: { defaultTtl?: number; indexes?: readonly (keyof T & string)[] } = {},\n): SchemaEntry<T, Key> {\n  const { defaultTtl, indexes } = options;\n\n  if (defaultTtl !== undefined) assertPositiveFinite(defaultTtl, 'table: defaultTtl');\n\n  if (indexes) {\n    const seen = new Set<string>();\n\n    for (const field of indexes) {\n      if (seen.has(field)) {\n        throw new VaultError(`table: index \"${field}\" is already registered`);\n      }\n\n      seen.add(field);\n    }\n  }\n\n  return { defaultTtl, indexes, key } as unknown as SchemaEntry<T, Key>;\n}\n"],"mappings":";;;AAyHA,SAAgB,EACd,GACA,IAA4E,CAAC,GACxD;CACrB,IAAM,EAAE,eAAY,eAAY;CAIhC,IAFI,MAAe,KAAA,KAAW,EAAqB,GAAY,mBAAmB,GAE9E,GAAS;EACX,IAAM,oBAAO,IAAI,IAAY;EAE7B,KAAK,IAAM,KAAS,GAAS;GAC3B,IAAI,EAAK,IAAI,CAAK,GAChB,MAAM,IAAI,EAAW,iBAAiB,EAAM,wBAAwB;GAGtE,EAAK,IAAI,CAAK;EAChB;CACF;CAEA,OAAO;EAAE;EAAY;EAAS;CAAI;AACpC"}
+{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/// <reference lib=\"dom\" />\n\nimport { VaultError } from './errors';\nimport type { QueryBuilder } from './query';\nimport { assertPositiveFinite } from './ttl';\n\n/** Portable primary-key values. Vault preserves their type and encodes them distinctly at rest. */\nexport type VaultKey = number | string;\n\n/** A typed table definition whose primary-key field must hold a portable Vault key. */\nexport type SchemaEntry<T extends object, Key extends keyof T & string = keyof T & string> = {\n  defaultTtl?: number;\n  /** IndexedDB creates these as `value.<field>` indexes; other stores filter in memory. */\n  indexes?: readonly (keyof T & string)[];\n  key: Key;\n};\n\nexport type AnySchema = Record<string, { defaultTtl?: number; indexes?: readonly string[]; key: string }>;\n\nexport type RecordOf<S extends AnySchema, K extends keyof S> =\n  S[K] extends SchemaEntry<infer R, infer _Key> ? R : never;\nexport type KeyOf<S extends AnySchema, K extends keyof S> = Extract<\n  S[K] extends SchemaEntry<infer R, infer Key> ? R[Key] : never,\n  VaultKey\n>;\n\n/** A codec validates and decodes persisted values crossing a trust boundary. */\nexport type RecordCodec<T> = {\n  decode(value: unknown): T;\n  encode(value: T): unknown;\n};\n\nexport type RecordParser<T> = {\n  parse(value: unknown): T;\n};\n\nexport type CodecInput<T> = RecordCodec<T> | RecordParser<T>;\n\nexport type TableCodecs<S extends AnySchema> = {\n  [K in keyof S]: CodecInput<RecordOf<S, K>>;\n};\n\n/** A validator-only codec: encodes values as-is, validates on decode. */\nexport function validatorCodec<T>(validator: RecordParser<T>): RecordCodec<T> {\n  return {\n    decode: (value) => validator.parse(value),\n    encode: (value) => value,\n  };\n}\n\nexport type Observer<T> = (records: T[]) => void;\nexport type Unsubscribe = () => void;\n\n/** Shared factory options for stores that do not require durable codecs. */\nexport type MemoryStoreOptions<S extends AnySchema> = {\n  schema: S;\n  /** Optional per-table codecs. Memory values never cross a trust boundary, so codecs may be omitted. */\n  codecs?: TableCodecs<S>;\n};\n\n/** Shared factory options for durable stores whose values cross a trust boundary. */\nexport type DurableStoreOptions<S extends AnySchema> = {\n  schema: S;\n  /** Required per-table codecs. Persisted values are decoded through these before entering typed code. */\n  codecs: TableCodecs<S>;\n};\n\nexport type VaultConveniences<S extends AnySchema, K extends keyof S & string = keyof S & string> = {\n  count<T extends K>(table: T): Promise<number>;\n  deleteMany<T extends K>(table: T, keys: readonly KeyOf<S, T>[]): Promise<number>;\n  getMany<T extends K>(table: T, keys: readonly KeyOf<S, T>[]): Promise<Array<RecordOf<S, T> | undefined>>;\n  has<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;\n  isEmpty<T extends K>(table: T): Promise<boolean>;\n  keys<T extends K>(table: T, filter?: (record: RecordOf<S, T>) => boolean): Promise<KeyOf<S, T>[]>;\n  query<T extends K>(table: T): QueryBuilder<RecordOf<S, T>>;\n  update<T extends K>(\n    table: T,\n    key: KeyOf<S, T>,\n    changes: Partial<RecordOf<S, T>>,\n    ttl?: number,\n  ): Promise<RecordOf<S, T> | undefined>;\n  upsert<T extends K>(\n    table: T,\n    key: KeyOf<S, T>,\n    update: (existing: RecordOf<S, T> | undefined) => RecordOf<S, T>,\n    ttl?: number,\n  ): Promise<RecordOf<S, T>>;\n};\n\n/** Methods available within an IndexedDB or SQLite transaction. */\nexport type TransactionContext<S extends AnySchema, K extends keyof S & string = keyof S & string> = VaultConveniences<\n  S,\n  K\n> & {\n  clear<T extends K>(table: T): Promise<void>;\n  delete<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;\n  get<T extends K>(table: T, key: KeyOf<S, T>): Promise<RecordOf<S, T> | undefined>;\n  getAll<T extends K>(table: T): Promise<RecordOf<S, T>[]>;\n  iterate<T extends K>(table: T): AsyncIterable<RecordOf<S, T>>;\n  put<T extends K>(table: T, value: RecordOf<S, T>, ttl?: number): Promise<RecordOf<S, T>>;\n  putAll<T extends K>(table: T, values: readonly RecordOf<S, T>[], ttl?: number): Promise<void>;\n};\n\n/** Key-value store for Memory and Web Storage: core CRUD, observation, TTL, and pruning. */\nexport interface KeyValueVaultStore<S extends AnySchema> extends VaultConveniences<S> {\n  clear<K extends keyof S & string>(table: K): Promise<void>;\n  delete<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<boolean>;\n  readonly disposalSignal: AbortSignal;\n  dispose(): Promise<void>;\n  readonly disposed: boolean;\n  get<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<RecordOf<S, K> | undefined>;\n  getAll<K extends keyof S & string>(table: K): Promise<RecordOf<S, K>[]>;\n  observe<K extends keyof S & string>(\n    table: K,\n    listener: Observer<RecordOf<S, K>>,\n    options?: { immediate?: boolean; signal?: AbortSignal },\n  ): Unsubscribe;\n  pruneExpired(): Promise<Record<keyof S & string, number>>;\n  put<K extends keyof S & string>(table: K, value: RecordOf<S, K>, ttl?: number): Promise<RecordOf<S, K>>;\n  putAll<K extends keyof S & string>(table: K, values: readonly RecordOf<S, K>[], ttl?: number): Promise<void>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\n/** Document store for IndexedDB and SQLite: adds atomic transactions and lazy iteration. */\nexport interface DocumentVaultStore<S extends AnySchema> extends KeyValueVaultStore<S> {\n  batch<K extends keyof S & string, R>(\n    tables: readonly K[],\n    fn: (tx: TransactionContext<S, K>) => Promise<R>,\n  ): Promise<R>;\n  iterate<K extends keyof S & string>(table: K): AsyncIterable<RecordOf<S, K>>;\n}\n\ntype VaultKeyField<T extends object> = {\n  [K in keyof T & string]: T[K] extends VaultKey ? K : never;\n}[keyof T & string];\n\n/** Define a typed table whose primary-key field holds a portable Vault key. */\nexport function table<T extends object, Key extends VaultKeyField<T> = VaultKeyField<T>>(\n  key: Key,\n  options: { defaultTtl?: number; indexes?: readonly (keyof T & string)[] } = {},\n): SchemaEntry<T, Key> {\n  const { defaultTtl, indexes } = options;\n\n  if (defaultTtl !== undefined) assertPositiveFinite(defaultTtl, 'table: defaultTtl');\n\n  if (indexes) {\n    const seen = new Set<string>();\n\n    for (const field of indexes) {\n      if (seen.has(field)) {\n        throw new VaultError(`table: index \"${field}\" is already registered`);\n      }\n\n      seen.add(field);\n    }\n  }\n\n  return { defaultTtl, indexes, key };\n}\n"],"mappings":";;;AA2CA,SAAgB,EAAkB,GAA4C;CAC5E,OAAO;EACL,SAAS,MAAU,EAAU,MAAM,CAAK;EACxC,SAAS,MAAU;CACrB;AACF;AAyFA,SAAgB,EACd,GACA,IAA4E,CAAC,GACxD;CACrB,IAAM,EAAE,eAAY,eAAY;CAIhC,IAFI,MAAe,KAAA,KAAW,EAAqB,GAAY,mBAAmB,GAE9E,GAAS;EACX,IAAM,oBAAO,IAAI,IAAY;EAE7B,KAAK,IAAM,KAAS,GAAS;GAC3B,IAAI,EAAK,IAAI,CAAK,GAChB,MAAM,IAAI,EAAW,iBAAiB,EAAM,wBAAwB;GAGtE,EAAK,IAAI,CAAK;EAChB;CACF;CAEA,OAAO;EAAE;EAAY;EAAS;CAAI;AACpC"}

package/dist/vault.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},t=class extends e{constructor(e=`adapter is disposed`,t){super(e,t)}},n=class extends e{},r=class extends e{},i=class extends e{},a={days:e=>s(e*864e5,`ttl.days`),hours:e=>s(e*36e5,`ttl.hours`),minutes:e=>s(e*6e4,`ttl.minutes`),ms:e=>s(e,`ttl.ms`),seconds:e=>s(e*1e3,`ttl.seconds`)};function o(e){return e!==void 0&&Date.now()>=e}function s(t,n){if(!Number.isFinite(t)||t<=0)throw new e(`${n} expected a finite positive number, received ${String(t)}`);return t}function c(t,n={}){let{defaultTtl:r,indexes:i}=n;if(r!==void 0&&s(r,`table: defaultTtl`),i){let t=new Set;for(let n of i){if(t.has(n))throw new e(`table: index "${n}" is already registered`);t.add(n)}}return{defaultTtl:r,indexes:i,key:t}}exports.VaultDisposedError=t,exports.VaultError=e,exports.VaultMigrationError=i,exports.VaultQuotaError=r,exports.VaultScopeError=n,exports.isExpired=o,exports.table=c,exports.ttl=a;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class extends Error{static errorName=`VaultError`;constructor(e,t){super(e,t),this.name=new.target.errorName,Object.setPrototypeOf(this,new.target.prototype)}},t=class extends e{static errorName=`VaultDisposedError`;constructor(e=`adapter is disposed`,t){super(e,t)}},n=class extends e{static errorName=`VaultScopeError`},r=class extends e{static errorName=`VaultQuotaError`},i=class extends e{static errorName=`VaultMigrationError`},a={days:e=>s(e*864e5,`ttl.days`),hours:e=>s(e*36e5,`ttl.hours`),minutes:e=>s(e*6e4,`ttl.minutes`),ms:e=>s(e,`ttl.ms`),seconds:e=>s(e*1e3,`ttl.seconds`)};function o(e){return e!==void 0&&Date.now()>=e}function s(t,n){if(!Number.isFinite(t)||t<=0)throw new e(`${n} expected a finite positive number, received ${String(t)}`);return t}async function c(e,t,n){return e.has(t,n)}async function l(e,t){return e.count(t)}async function u(e,t){return e.isEmpty(t)}async function d(e,t,n){return e.getMany(t,n)}async function f(e,t,n){return e.keys(t,n)}async function p(e,t,n){return e.deleteMany(t,n)}async function m(e,t,n,r,i){return e.update(t,n,r,i)}async function h(e,t,n,r,i){return e.upsert(t,n,r,i)}function g(e){return{decode:t=>e.parse(t),encode:e=>e}}function _(t,n={}){let{defaultTtl:r,indexes:i}=n;if(r!==void 0&&s(r,`table: defaultTtl`),i){let t=new Set;for(let n of i){if(t.has(n))throw new e(`table: index "${n}" is already registered`);t.add(n)}}return{defaultTtl:r,indexes:i,key:t}}exports.VaultDisposedError=t,exports.VaultError=e,exports.VaultMigrationError=i,exports.VaultQuotaError=r,exports.VaultScopeError=n,exports.count=l,exports.deleteMany=p,exports.getMany=d,exports.has=c,exports.isEmpty=u,exports.isExpired=o,exports.keys=f,exports.table=_,exports.ttl=a,exports.update=m,exports.upsert=h,exports.validatorCodec=g;
 //# sourceMappingURL=vault.cjs.map

package/dist/vault.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"vault.cjs","names":[],"sources":["../src/errors.ts","../src/ttl.ts","../src/types.ts"],"sourcesContent":["/**\n * Base class for all vault errors. Catch with `instanceof VaultError` to\n * handle any vault-originated error regardless of its specific subtype.\n */\nexport class VaultError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    // Ensures `instanceof` works correctly when transpiled to ES5.\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when an operation is attempted on a disposed adapter or observer hub. */\nexport class VaultDisposedError extends VaultError {\n  constructor(message = 'adapter is disposed', opts?: ErrorOptions) {\n    super(message, opts);\n  }\n}\n\n/** Thrown when a `batch()` callback accesses a table not declared in the scope. */\nexport class VaultScopeError extends VaultError {}\n\n/** Thrown when a WebStorage write exceeds the storage quota. */\nexport class VaultQuotaError extends VaultError {}\n\n/** Thrown when an IndexedDB `onupgradeneeded` migration callback throws. */\nexport class VaultMigrationError extends VaultError {}\n","import { VaultError } from './errors';\n\n/** Duration helpers that produce finite, positive millisecond values. */\nexport const ttl = {\n  days: (n: number) => assertPositiveFinite(n * 86_400_000, 'ttl.days'),\n  hours: (n: number) => assertPositiveFinite(n * 3_600_000, 'ttl.hours'),\n  minutes: (n: number) => assertPositiveFinite(n * 60_000, 'ttl.minutes'),\n  ms: (n: number) => assertPositiveFinite(n, 'ttl.ms'),\n  seconds: (n: number) => assertPositiveFinite(n * 1000, 'ttl.seconds'),\n} as const;\n\n/** Fixed storage envelope shared by every adapter, so data and indexes stay portable. */\nexport type StoredRecord<T> = { expiresAt?: number; value: T };\n\nexport function isExpired(expiresAt: number | undefined): boolean {\n  return expiresAt !== undefined && Date.now() >= expiresAt;\n}\n\n/** Throws when `ttlMs` is not a finite, positive number. Returns it unchanged otherwise. */\nexport function assertPositiveFinite(ttlMs: number, source: string): number {\n  if (!Number.isFinite(ttlMs) || ttlMs <= 0) {\n    throw new VaultError(`${source} expected a finite positive number, received ${String(ttlMs)}`);\n  }\n\n  return ttlMs;\n}\n\nexport function parseStored<T>(raw: unknown): StoredRecord<T> | undefined {\n  if (typeof raw !== 'object' || raw === null || !('value' in raw)) return undefined;\n\n  const record = raw as { expiresAt?: unknown; value: unknown };\n\n  if (record.expiresAt !== undefined && (typeof record.expiresAt !== 'number' || !Number.isFinite(record.expiresAt))) {\n    return undefined;\n  }\n\n  return record as StoredRecord<T>;\n}\n","/// <reference lib=\"dom\" />\n\nimport { VaultError } from './errors';\nimport type { QueryBuilder } from './query';\nimport { assertPositiveFinite } from './ttl';\n\n/** Portable primary-key values. Vault preserves their type and encodes them distinctly at rest. */\nexport type VaultKey = number | string;\n\n/** A typed table definition whose primary-key field must hold a portable Vault key. */\nexport type SchemaEntry<T extends object, Key extends keyof T & string = keyof T & string> = {\n  defaultTtl?: number;\n  /** IndexedDB creates these as `value.<field>` indexes; other stores filter in memory. */\n  indexes?: readonly (keyof T & string)[];\n  key: Key;\n};\n\nexport type AnySchema = Record<string, { defaultTtl?: number; indexes?: readonly string[]; key: string }>;\n\nexport type RecordOf<S extends AnySchema, K extends keyof S> =\n  S[K] extends SchemaEntry<infer R, infer _Key> ? R : never;\nexport type KeyOf<S extends AnySchema, K extends keyof S> = Extract<\n  S[K] extends SchemaEntry<infer R, infer Key> ? R[Key] : never,\n  VaultKey\n>;\n\nexport type RecordValidator<T> = {\n  parse(value: unknown): T;\n};\n\nexport type TableValidators<S extends AnySchema> = {\n  [K in keyof S]?: RecordValidator<RecordOf<S, K>>;\n};\n\nexport type Observer<T> = (records: T[]) => void;\nexport type Unsubscribe = () => void;\n\n/** Shared factory options. Values always use Vault's fixed `{ value, expiresAt? }` envelope. */\nexport type BaseAdapterOptions<S extends AnySchema> = {\n  schema: S;\n  validators?: TableValidators<S>;\n};\n\n/** Methods available within an IndexedDB or SQLite transaction. */\nexport type TransactionContext<S extends AnySchema, K extends keyof S & string = keyof S & string> = {\n  clear<T extends K>(table: T): Promise<void>;\n  count<T extends K>(table: T): Promise<number>;\n  delete<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;\n  deleteMany<T extends K>(table: T, keys: KeyOf<S, T>[]): Promise<number>;\n  get<T extends K>(table: T, key: KeyOf<S, T>): Promise<RecordOf<S, T> | undefined>;\n  getAll<T extends K>(table: T): Promise<RecordOf<S, T>[]>;\n  getMany<T extends K>(table: T, keys: KeyOf<S, T>[]): Promise<Array<RecordOf<S, T> | undefined>>;\n  has<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;\n  isEmpty<T extends K>(table: T): Promise<boolean>;\n  keys<T extends K>(table: T, filter?: (record: RecordOf<S, T>) => boolean): Promise<KeyOf<S, T>[]>;\n  put<T extends K>(table: T, value: RecordOf<S, T>, ttl?: number): Promise<void>;\n  putAll<T extends K>(table: T, values: RecordOf<S, T>[], ttl?: number): Promise<void>;\n  query<T extends K>(table: T): QueryBuilder<RecordOf<S, T>>;\n  update<T extends K>(\n    table: T,\n    key: KeyOf<S, T>,\n    changes: Partial<RecordOf<S, T>>,\n    ttl?: number,\n  ): Promise<RecordOf<S, T> | undefined>;\n  upsert<T extends K>(\n    table: T,\n    key: KeyOf<S, T>,\n    fn: (existing: RecordOf<S, T> | undefined) => RecordOf<S, T>,\n    ttl?: number,\n  ): Promise<RecordOf<S, T>>;\n};\n\n/** Portable API returned by memory and Web Storage factories. */\nexport interface VaultStore<S extends AnySchema> {\n  clear<K extends keyof S & string>(table: K): Promise<void>;\n  count<K extends keyof S & string>(table: K): Promise<number>;\n  delete<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<boolean>;\n  deleteMany<K extends keyof S & string>(table: K, keys: KeyOf<S, K>[]): Promise<number>;\n  readonly disposalSignal: AbortSignal;\n  dispose(): Promise<void>;\n  readonly disposed: boolean;\n  get<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<RecordOf<S, K> | undefined>;\n  getAll<K extends keyof S & string>(table: K): Promise<RecordOf<S, K>[]>;\n  getMany<K extends keyof S & string>(table: K, keys: KeyOf<S, K>[]): Promise<Array<RecordOf<S, K> | undefined>>;\n  has<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<boolean>;\n  isEmpty<K extends keyof S & string>(table: K): Promise<boolean>;\n  keys<K extends keyof S & string>(table: K, filter?: (record: RecordOf<S, K>) => boolean): Promise<KeyOf<S, K>[]>;\n  observe<K extends keyof S & string>(\n    table: K,\n    listener: Observer<RecordOf<S, K>>,\n    options?: { immediate?: boolean; signal?: AbortSignal },\n  ): Unsubscribe;\n  pruneExpired(): Promise<Record<keyof S & string, number>>;\n  put<K extends keyof S & string>(table: K, value: RecordOf<S, K>, ttl?: number): Promise<void>;\n  putAll<K extends keyof S & string>(table: K, values: RecordOf<S, K>[], ttl?: number): Promise<void>;\n  query<K extends keyof S & string>(table: K): QueryBuilder<RecordOf<S, K>>;\n  update<K extends keyof S & string>(\n    table: K,\n    key: KeyOf<S, K>,\n    changes: Partial<RecordOf<S, K>>,\n    ttl?: number,\n  ): Promise<RecordOf<S, K> | undefined>;\n  upsert<K extends keyof S & string>(\n    table: K,\n    key: KeyOf<S, K>,\n    fn: (existing: RecordOf<S, K> | undefined) => RecordOf<S, K>,\n    ttl?: number,\n  ): Promise<RecordOf<S, K>>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\n/** Atomic, scoped transactions and lazy iteration supplied by storage engines that support them. */\nexport interface TransactionalVaultStore<S extends AnySchema> extends VaultStore<S> {\n  batch<K extends keyof S & string, R>(\n    tables: readonly K[],\n    fn: (tx: TransactionContext<S, K>) => Promise<R>,\n  ): Promise<R>;\n  iterate<K extends keyof S & string>(table: K): AsyncIterable<RecordOf<S, K>>;\n}\n\n/** Define a typed table whose primary-key field holds a portable Vault key. */\nexport function table<T extends object, Key extends keyof T & string = keyof T & string>(\n  key: Key,\n  options: { defaultTtl?: number; indexes?: readonly (keyof T & string)[] } = {},\n): SchemaEntry<T, Key> {\n  const { defaultTtl, indexes } = options;\n\n  if (defaultTtl !== undefined) assertPositiveFinite(defaultTtl, 'table: defaultTtl');\n\n  if (indexes) {\n    const seen = new Set<string>();\n\n    for (const field of indexes) {\n      if (seen.has(field)) {\n        throw new VaultError(`table: index \"${field}\" is already registered`);\n      }\n\n      seen.add(field);\n    }\n  }\n\n  return { defaultTtl, indexes, key } as unknown as SchemaEntry<T, Key>;\n}\n"],"mappings":"mEAIA,IAAa,EAAb,cAAgC,KAAM,CACpC,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAO,WAAW,KAEvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAGa,EAAb,cAAwC,CAAW,CACjD,YAAY,EAAU,sBAAuB,EAAqB,CAChE,MAAM,EAAS,CAAI,CACrB,CACF,EAGa,EAAb,cAAqC,CAAW,CAAC,EAGpC,EAAb,cAAqC,CAAW,CAAC,EAGpC,EAAb,cAAyC,CAAW,CAAC,ECxBxC,EAAM,CACjB,KAAO,GAAc,EAAqB,EAAI,MAAY,UAAU,EACpE,MAAQ,GAAc,EAAqB,EAAI,KAAW,WAAW,EACrE,QAAU,GAAc,EAAqB,EAAI,IAAQ,aAAa,EACtE,GAAK,GAAc,EAAqB,EAAG,QAAQ,EACnD,QAAU,GAAc,EAAqB,EAAI,IAAM,aAAa,CACtE,EAKA,SAAgB,EAAU,EAAwC,CAChE,OAAO,IAAc,IAAA,IAAa,KAAK,IAAI,GAAK,CAClD,CAGA,SAAgB,EAAqB,EAAe,EAAwB,CAC1E,GAAI,CAAC,OAAO,SAAS,CAAK,GAAK,GAAS,EACtC,MAAM,IAAI,EAAW,GAAG,EAAO,+CAA+C,OAAO,CAAK,GAAG,EAG/F,OAAO,CACT,CCgGA,SAAgB,EACd,EACA,EAA4E,CAAC,EACxD,CACrB,GAAM,CAAE,aAAY,WAAY,EAIhC,GAFI,IAAe,IAAA,IAAW,EAAqB,EAAY,mBAAmB,EAE9E,EAAS,CACX,IAAM,EAAO,IAAI,IAEjB,IAAK,IAAM,KAAS,EAAS,CAC3B,GAAI,EAAK,IAAI,CAAK,EAChB,MAAM,IAAI,EAAW,iBAAiB,EAAM,wBAAwB,EAGtE,EAAK,IAAI,CAAK,CAChB,CACF,CAEA,MAAO,CAAE,aAAY,UAAS,KAAI,CACpC"}
+{"version":3,"file":"vault.cjs","names":[],"sources":["../src/errors.ts","../src/ttl.ts","../src/adapter-core.ts","../src/types.ts"],"sourcesContent":["/**\n * Base class for all vault errors. Catch with `instanceof VaultError` to\n * handle any vault-originated error regardless of its specific subtype.\n */\nexport class VaultError extends Error {\n  protected static readonly errorName: string = 'VaultError';\n\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = (new.target as typeof VaultError).errorName;\n    // Ensures `instanceof` works correctly when transpiled to ES5.\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when an operation is attempted on a disposed adapter or observer hub. */\nexport class VaultDisposedError extends VaultError {\n  protected static override readonly errorName = 'VaultDisposedError';\n\n  constructor(message = 'adapter is disposed', opts?: ErrorOptions) {\n    super(message, opts);\n  }\n}\n\n/** Thrown when a `batch()` callback accesses a table not declared in the scope. */\nexport class VaultScopeError extends VaultError {\n  protected static override readonly errorName = 'VaultScopeError';\n}\n\n/** Thrown when a WebStorage write exceeds the storage quota. */\nexport class VaultQuotaError extends VaultError {\n  protected static override readonly errorName = 'VaultQuotaError';\n}\n\n/** Thrown when an IndexedDB `onupgradeneeded` migration callback throws. */\nexport class VaultMigrationError extends VaultError {\n  protected static override readonly errorName = 'VaultMigrationError';\n}\n","import { VaultError } from './errors';\n\n/** Duration helpers that produce finite, positive millisecond values. */\nexport const ttl = {\n  days: (n: number) => assertPositiveFinite(n * 86_400_000, 'ttl.days'),\n  hours: (n: number) => assertPositiveFinite(n * 3_600_000, 'ttl.hours'),\n  minutes: (n: number) => assertPositiveFinite(n * 60_000, 'ttl.minutes'),\n  ms: (n: number) => assertPositiveFinite(n, 'ttl.ms'),\n  seconds: (n: number) => assertPositiveFinite(n * 1000, 'ttl.seconds'),\n} as const;\n\n/** Fixed storage envelope shared by every adapter, so data and indexes stay portable. */\nexport type StoredRecord<T> = { expiresAt?: number; value: T };\n\nexport function isExpired(expiresAt: number | undefined): boolean {\n  return expiresAt !== undefined && Date.now() >= expiresAt;\n}\n\n/** Throws when `ttlMs` is not a finite, positive number. Returns it unchanged otherwise. */\nexport function assertPositiveFinite(ttlMs: number, source: string): number {\n  if (!Number.isFinite(ttlMs) || ttlMs <= 0) {\n    throw new VaultError(`${source} expected a finite positive number, received ${String(ttlMs)}`);\n  }\n\n  return ttlMs;\n}\n\nexport function parseStored<T>(raw: unknown): StoredRecord<T> | undefined {\n  if (typeof raw !== 'object' || raw === null || !('value' in raw)) return undefined;\n\n  const record = raw as { expiresAt?: unknown; value: unknown };\n\n  if (record.expiresAt !== undefined && (typeof record.expiresAt !== 'number' || !Number.isFinite(record.expiresAt))) {\n    return undefined;\n  }\n\n  return record as StoredRecord<T>;\n}\n","import { validateRecord } from './codec';\nimport { VaultDisposedError, VaultError, VaultScopeError } from './errors';\nimport { createObserverHub, getRecordKey } from './internal';\nimport { createQueryBuilder } from './query';\nimport { assertPositiveFinite } from './ttl';\nimport type {\n  AnySchema,\n  DocumentVaultStore,\n  DurableStoreOptions,\n  KeyOf,\n  KeyValueVaultStore,\n  MemoryStoreOptions,\n  RecordOf,\n  TableCodecs,\n  TransactionContext,\n} from './types';\n\n/* -------------------- Internal backend protocol -------------------- */\n\n/** @internal Full backend protocol implemented by each adapter. */\nexport type StorageBackend<S extends AnySchema, K extends keyof S & string = keyof S & string> = {\n  clear<T extends K>(table: T): Promise<void>;\n  count?<T extends K>(table: T): Promise<number>;\n  delete<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;\n  deleteMany?<T extends K>(table: T, keys: readonly KeyOf<S, T>[]): Promise<number>;\n  dispose?(): Promise<void>;\n  get<T extends K>(table: T, key: KeyOf<S, T>): Promise<RecordOf<S, T> | undefined>;\n  getAll<T extends K>(table: T): Promise<RecordOf<S, T>[]>;\n  getAllKeys?<T extends K>(table: T): Promise<KeyOf<S, T>[]>;\n  getMany?<T extends K>(table: T, keys: readonly KeyOf<S, T>[]): Promise<Array<RecordOf<S, T> | undefined>>;\n  has?<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;\n  /**\n   * Optional: lazy iteration over live records. Document stores implement this natively\n   * (IDB cursor, SQLite keyset pagination). Key-value stores fall back to getAll().\n   */\n  iterate?<T extends K>(table: T): AsyncIterable<RecordOf<S, T>>;\n  /**\n   * Optional: prune all expired records across all tables in a single atomic operation.\n   * When present, `pruneExpired()` delegates here instead of calling `pruneExpiredInTable` N times.\n   */\n  pruneAllExpired?(): Promise<Record<string, number>>;\n  pruneExpiredInTable<T extends K>(table: T): Promise<number>;\n  put<T extends K>(table: T, value: RecordOf<S, T>, ttl?: number): Promise<void>;\n  putAll<T extends K>(table: T, values: readonly RecordOf<S, T>[], ttl?: number): Promise<void>;\n};\n\n/** @internal */\nexport type BatchDeps<S extends AnySchema> = {\n  notifyMutation: (table: keyof S & string) => void;\n  validate: <K extends keyof S & string>(table: K, value: RecordOf<S, K>) => RecordOf<S, K>;\n};\n\n/** @internal */\nexport type BatchImpl<S extends AnySchema> = <K extends keyof S & string, R>(\n  tables: readonly K[],\n  fn: (tx: TransactionContext<S, K>) => Promise<R>,\n) => Promise<R>;\n\n/* -------------------- Helpers -------------------- */\n\nexport function assertBatchTables(tables: readonly string[]): void {\n  if (tables.length === 0) throw new VaultError('batch: declare at least one table');\n}\n\nfunction resolveTtl<S extends AnySchema, K extends keyof S & string>(\n  schema: S,\n  table: K,\n  ttl?: number,\n): number | undefined {\n  if (ttl !== undefined) assertPositiveFinite(ttl, 'put/putAll');\n\n  return ttl ?? schema[table].defaultTtl;\n}\n\nfunction verifyKey<S extends AnySchema, K extends keyof S & string>(\n  schema: S,\n  table: K,\n  expected: KeyOf<S, K>,\n  value: RecordOf<S, K>,\n  op: string,\n): void {\n  const actual = getRecordKey(schema, table, value);\n\n  if (actual !== expected) {\n    throw new VaultError(\n      `${op}: key field \"${schema[table].key}\" must be \"${String(expected)}\" but got \"${String(actual)}\" in table \"${table}\"`,\n    );\n  }\n}\n\n/* -------------------- Codec helpers -------------------- */\n\nexport function makeValidator<S extends AnySchema>(\n  codecs: TableCodecs<S> | undefined,\n): <K extends keyof S & string>(table: K, value: RecordOf<S, K>) => RecordOf<S, K> {\n  return <K extends keyof S & string>(table: K, value: RecordOf<S, K>): RecordOf<S, K> => {\n    const codec = codecs?.[table];\n\n    if (!codec) return value;\n\n    try {\n      return validateRecord(codec, value);\n    } catch (err) {\n      throw new VaultError(`validation failed for table \"${table}\"`, { cause: err });\n    }\n  };\n}\n\n/* -------------------- buildTxContext -------------------- */\n\nexport function buildTxContext<S extends AnySchema, K extends keyof S & string>(\n  schema: S,\n  core: StorageBackend<S, K>,\n  onMutate: (table: K) => void,\n  validate?: <T extends K>(table: T, value: RecordOf<S, T>) => RecordOf<S, T>,\n  scope?: ReadonlySet<string>,\n  isActive: () => boolean = () => true,\n): TransactionContext<S, K> {\n  const applyValidation = validate ?? ((_: K, v: RecordOf<S, K>) => v);\n\n  const checkScope = (table: K): void => {\n    if (!isActive()) throw new VaultScopeError('transaction context is no longer active');\n    if (scope && !scope.has(table)) throw new VaultScopeError(`table \"${table}\" is not part of this batch scope`);\n  };\n\n  const context: TransactionContext<S, K> = {\n    async clear(table) {\n      checkScope(table);\n      await core.clear(table);\n      onMutate(table);\n    },\n    async count(table) {\n      checkScope(table);\n      return core.count ? core.count(table) : (await core.getAll(table)).length;\n    },\n    async delete(table, key) {\n      checkScope(table);\n\n      const deleted = await core.delete(table, key);\n\n      if (deleted) onMutate(table);\n\n      return deleted;\n    },\n    async deleteMany(table, keys) {\n      checkScope(table);\n      if (!core.deleteMany) {\n        const results = await Promise.all(keys.map((key) => core.delete(table, key)));\n        const deleted = results.filter(Boolean).length;\n        if (deleted > 0) onMutate(table);\n        return deleted;\n      }\n      const deleted = await core.deleteMany(table, keys);\n      if (deleted > 0) onMutate(table);\n      return deleted;\n    },\n    async get(table, key) {\n      checkScope(table);\n\n      return core.get(table, key);\n    },\n    async getAll(table) {\n      checkScope(table);\n\n      return core.getAll(table);\n    },\n    async getMany(table, keys) {\n      checkScope(table);\n      return core.getMany ? core.getMany(table, keys) : Promise.all(keys.map((key) => core.get(table, key)));\n    },\n    async has(table, key) {\n      checkScope(table);\n      return core.has ? core.has(table, key) : (await core.get(table, key)) !== undefined;\n    },\n    async isEmpty(table) {\n      return (await context.count(table)) === 0;\n    },\n    iterate(table) {\n      checkScope(table);\n\n      if (core.iterate) return core.iterate(table);\n\n      // Fallback: iterate over getAll() materialized records.\n      return (async function* (): AsyncIterable<RecordOf<S, typeof table>> {\n        const records = await core.getAll(table);\n\n        for (const record of records) yield record;\n      })();\n    },\n    async keys(table, filter) {\n      checkScope(table);\n      if (!filter && core.getAllKeys) return core.getAllKeys(table);\n      const records = await core.getAll(table);\n      const selected = filter ? records.filter(filter) : records;\n      const keyField = schema[table].key;\n      return selected.map((record) => (record as Record<string, unknown>)[keyField] as KeyOf<S, typeof table>);\n    },\n    async put(table, value, ttl) {\n      checkScope(table);\n      const canonical = applyValidation(table, value);\n      await core.put(table, canonical, resolveTtl(schema, table, ttl));\n      onMutate(table);\n      return canonical;\n    },\n    async putAll(table, values, ttl) {\n      checkScope(table);\n\n      if (values.length === 0) return;\n\n      const toWrite = values.map((v) => applyValidation(table, v));\n\n      await core.putAll(table, toWrite, resolveTtl(schema, table, ttl));\n      onMutate(table);\n    },\n    query(table) {\n      checkScope(table);\n      return createQueryBuilder({\n        deleteMany: async (records) => {\n          const keys = records.map((record) => getRecordKey(schema, table, record));\n          return context.deleteMany(table, keys);\n        },\n        source: () => context.getAll(table),\n      });\n    },\n    async update(table, key, changes, ttl) {\n      const current = await context.get(table, key);\n      if (current === undefined) return undefined;\n      const merged = { ...current, ...changes } as RecordOf<S, typeof table>;\n      verifyKey(schema, table, key, merged, 'update');\n      return context.put(table, merged, ttl);\n    },\n    async upsert(table, key, update, ttl) {\n      const value = update(await context.get(table, key));\n      verifyKey(schema, table, key, value, 'upsert: update()');\n      return context.put(table, value, ttl);\n    },\n  };\n\n  return context;\n}\n\n/* -------------------- buildKeyValueStore -------------------- */\n\n/** Builds a KeyValueVaultStore from a backend and options. */\nexport function buildKeyValueStore<S extends AnySchema>(\n  schema: S,\n  core: StorageBackend<S>,\n  options?: MemoryStoreOptions<S> & {\n    onCrossTabMessage?: (notify: (table: keyof S & string) => void) => (() => void) | undefined;\n    onMutation?: (table: keyof S & string) => void;\n    onTransactions?: (deps: BatchDeps<S>) => void;\n  },\n): KeyValueVaultStore<S> {\n  const { codecs } = options ?? {};\n\n  const observers = createObserverHub<S>((table) => core.getAll(table));\n\n  const notifyMutation = (table: keyof S & string): void => {\n    observers.notify(table);\n    options?.onMutation?.(table);\n  };\n\n  // Cross-tab notifications must NOT call onMutation (which would re-publish to BroadcastChannel,\n  // creating an infinite loop). They only notify local observers.\n  const notifyExternal = (table: keyof S & string): void => {\n    observers.notify(table);\n  };\n\n  const pruneAll = core.pruneAllExpired?.bind(core);\n\n  const disconnectExternal = options?.onCrossTabMessage?.(notifyExternal) ?? undefined;\n\n  const validate = makeValidator(codecs);\n\n  options?.onTransactions?.({ notifyMutation, validate });\n\n  const disposeController = new AbortController();\n  let disposed = false;\n\n  const checkDisposed = (): void => {\n    if (disposed) throw new VaultDisposedError();\n  };\n\n  const adapter: KeyValueVaultStore<S> = {\n    async clear(table) {\n      checkDisposed();\n      await core.clear(table);\n      notifyMutation(table);\n    },\n    async count(table) {\n      checkDisposed();\n      return core.count ? core.count(table) : (await core.getAll(table)).length;\n    },\n\n    async delete(table, key) {\n      checkDisposed();\n\n      const deleted = await core.delete(table, key);\n\n      if (deleted) notifyMutation(table);\n\n      return deleted;\n    },\n    async deleteMany(table, keys) {\n      checkDisposed();\n      const deleted = core.deleteMany\n        ? await core.deleteMany(table, keys)\n        : (await Promise.all(keys.map((key) => core.delete(table, key)))).filter(Boolean).length;\n      if (deleted > 0) notifyMutation(table);\n      return deleted;\n    },\n\n    get disposalSignal(): AbortSignal {\n      return disposeController.signal;\n    },\n\n    async dispose() {\n      if (disposed) return;\n\n      disposed = true;\n      disposeController.abort();\n      disconnectExternal?.();\n      observers.dispose();\n      await core.dispose?.();\n    },\n\n    get disposed(): boolean {\n      return disposed;\n    },\n\n    async get(table, key) {\n      checkDisposed();\n\n      return core.get(table, key);\n    },\n\n    async getAll(table) {\n      checkDisposed();\n\n      return core.getAll(table);\n    },\n    async getMany(table, keys) {\n      checkDisposed();\n      return core.getMany ? core.getMany(table, keys) : Promise.all(keys.map((key) => core.get(table, key)));\n    },\n    async has(table, key) {\n      checkDisposed();\n      return core.has ? core.has(table, key) : (await core.get(table, key)) !== undefined;\n    },\n    async isEmpty(table) {\n      return (await adapter.count(table)) === 0;\n    },\n    async keys(table, filter) {\n      checkDisposed();\n      if (!filter && core.getAllKeys) return core.getAllKeys(table);\n      const records = await core.getAll(table);\n      const selected = filter ? records.filter(filter) : records;\n      const keyField = schema[table].key;\n      return selected.map((record) => (record as Record<string, unknown>)[keyField] as KeyOf<S, typeof table>);\n    },\n\n    observe(table, listener, opts) {\n      checkDisposed();\n\n      return observers.observe(table, listener, opts);\n    },\n\n    async pruneExpired() {\n      checkDisposed();\n\n      if (pruneAll) {\n        const result = await pruneAll();\n\n        for (const [table, pruned] of Object.entries(result)) {\n          if (pruned > 0) notifyMutation(table as keyof S & string);\n        }\n\n        return result as { [K in keyof S & string]: number };\n      }\n\n      const tableNames = Object.keys(schema) as Array<keyof S & string>;\n      const pairs = await Promise.all(\n        tableNames.map(async (name) => {\n          const pruned = await core.pruneExpiredInTable(name);\n\n          return [name, pruned] as const;\n        }),\n      );\n\n      for (const [table, pruned] of pairs) {\n        if (pruned > 0) notifyMutation(table);\n      }\n\n      return Object.fromEntries(pairs) as { [K in keyof S & string]: number };\n    },\n\n    async put(table, value, ttl) {\n      checkDisposed();\n      const canonical = validate(table, value);\n      await core.put(table, canonical, resolveTtl(schema, table, ttl));\n      notifyMutation(table);\n      return canonical;\n    },\n\n    async putAll(table, values, ttl) {\n      checkDisposed();\n\n      if (values.length === 0) return;\n\n      const toWrite = values.map((v) => validate(table, v));\n\n      await core.putAll(table, toWrite, resolveTtl(schema, table, ttl));\n      notifyMutation(table);\n    },\n    query(table) {\n      checkDisposed();\n      return createQueryBuilder({\n        deleteMany: async (records) => {\n          const keys = records.map((record) => getRecordKey(schema, table, record));\n          return adapter.deleteMany(table, keys);\n        },\n        source: () => adapter.getAll(table),\n      });\n    },\n    async update(table, key, changes, ttl) {\n      const current = await adapter.get(table, key);\n      if (current === undefined) return undefined;\n      const merged = { ...current, ...changes } as RecordOf<S, typeof table>;\n      verifyKey(schema, table, key, merged, 'update');\n      return adapter.put(table, merged, ttl);\n    },\n    async upsert(table, key, apply, ttl) {\n      const value = apply(await adapter.get(table, key));\n      verifyKey(schema, table, key, value, 'upsert: apply()');\n      return adapter.put(table, value, ttl);\n    },\n\n    async [Symbol.asyncDispose]() {\n      await adapter.dispose();\n    },\n  };\n\n  return adapter;\n}\n\n/* -------------------- buildDocumentStore -------------------- */\n\n/** A document store before batch() is attached. */\nexport type DocumentVaultStoreWithoutBatch<S extends AnySchema> = Omit<DocumentVaultStore<S>, 'batch'>;\n\n/** Builds a DocumentVaultStore (without batch) from a backend, codecs, and options. */\nexport function buildDocumentStore<S extends AnySchema>(\n  schema: S,\n  core: StorageBackend<S>,\n  options: DurableStoreOptions<S> & {\n    onCrossTabMessage?: (notify: (table: keyof S & string) => void) => (() => void) | undefined;\n    onMutation?: (table: keyof S & string) => void;\n    onTransactions?: (deps: BatchDeps<S>) => void;\n  },\n): DocumentVaultStoreWithoutBatch<S> {\n  const store = buildKeyValueStore(schema, core, options);\n\n  return Object.assign(store, {\n    iterate<K extends keyof S & string>(table: K): AsyncIterable<RecordOf<S, K>> {\n      if (store.disposed) throw new VaultDisposedError();\n      if (core.iterate) return core.iterate(table);\n      return (async function* (): AsyncIterable<RecordOf<S, K>> {\n        for (const record of await store.getAll(table)) yield record;\n      })();\n    },\n  });\n}\n\n/** Attaches a batch() implementation to a document store. */\nexport function withBatch<S extends AnySchema>(\n  store: DocumentVaultStoreWithoutBatch<S>,\n  batch: BatchImpl<S>,\n  schema: S,\n): DocumentVaultStore<S> {\n  const runBatch: BatchImpl<S> = (tables, fn) => {\n    if (store.disposed) return Promise.reject(new VaultDisposedError());\n    return batch(tables, fn);\n  };\n\n  return Object.assign(store, {\n    batch: runBatch,\n    deleteMany<K extends keyof S & string>(table: K, keys: readonly KeyOf<S, K>[]) {\n      return runBatch([table], (tx) => tx.deleteMany(table, keys));\n    },\n    query<K extends keyof S & string>(table: K) {\n      if (store.disposed) throw new VaultDisposedError();\n      return createQueryBuilder({\n        deleteMany: async (records) => {\n          const keys = records.map((record) => getRecordKey(schema, table, record));\n          return runBatch([table], (tx) => tx.deleteMany(table, keys));\n        },\n        source: () => store.getAll(table),\n      });\n    },\n    update<K extends keyof S & string>(table: K, key: KeyOf<S, K>, changes: Partial<RecordOf<S, K>>, ttl?: number) {\n      return runBatch([table], (tx) => tx.update(table, key, changes, ttl));\n    },\n    upsert<K extends keyof S & string>(\n      table: K,\n      key: KeyOf<S, K>,\n      apply: (existing: RecordOf<S, K> | undefined) => RecordOf<S, K>,\n      ttl?: number,\n    ) {\n      return runBatch([table], (tx) => tx.upsert(table, key, apply, ttl));\n    },\n  }) as DocumentVaultStore<S>;\n}\n\n/* -------------------- Derived convenience helpers -------------------- */\n\n/** Check whether a record exists for the given key. */\nexport async function has<S extends AnySchema, K extends keyof S & string>(\n  store: KeyValueVaultStore<S>,\n  table: K,\n  key: KeyOf<S, K>,\n): Promise<boolean> {\n  return store.has(table, key);\n}\n\n/** Count live records in a table. */\nexport async function count<S extends AnySchema, K extends keyof S & string>(\n  store: KeyValueVaultStore<S>,\n  table: K,\n): Promise<number> {\n  return store.count(table);\n}\n\n/** Check whether a table has no live records. */\nexport async function isEmpty<S extends AnySchema, K extends keyof S & string>(\n  store: KeyValueVaultStore<S>,\n  table: K,\n): Promise<boolean> {\n  return store.isEmpty(table);\n}\n\n/** Fetch multiple records by key. Preserves key order; missing keys yield `undefined`. */\nexport async function getMany<S extends AnySchema, K extends keyof S & string>(\n  store: KeyValueVaultStore<S>,\n  table: K,\n  keys: readonly KeyOf<S, K>[],\n): Promise<Array<RecordOf<S, K> | undefined>> {\n  return store.getMany(table, keys);\n}\n\n/** Fetch all live primary keys for a table. */\nexport async function keys<S extends AnySchema, K extends keyof S & string>(\n  store: KeyValueVaultStore<S>,\n  table: K,\n  filter?: (record: RecordOf<S, K>) => boolean,\n): Promise<KeyOf<S, K>[]> {\n  return store.keys(table, filter);\n}\n\n/** Delete multiple records by key. Returns the count of records that were actually deleted. */\nexport async function deleteMany<S extends AnySchema, K extends keyof S & string>(\n  store: KeyValueVaultStore<S>,\n  table: K,\n  keys: readonly KeyOf<S, K>[],\n): Promise<number> {\n  return store.deleteMany(table, keys);\n}\n\n/** Partially update an existing record. Returns `undefined` when the key does not exist. */\nexport async function update<S extends AnySchema, K extends keyof S & string>(\n  store: KeyValueVaultStore<S>,\n  table: K,\n  key: KeyOf<S, K>,\n  changes: Partial<RecordOf<S, K>>,\n  ttl?: number,\n): Promise<RecordOf<S, K> | undefined> {\n  return store.update(table, key, changes, ttl);\n}\n\n/** Read-modify-write: the callback receives the current record (or `undefined`) and returns the value to store. */\nexport async function upsert<S extends AnySchema, K extends keyof S & string>(\n  store: KeyValueVaultStore<S>,\n  table: K,\n  key: KeyOf<S, K>,\n  apply: (existing: RecordOf<S, K> | undefined) => RecordOf<S, K>,\n  ttl?: number,\n): Promise<RecordOf<S, K>> {\n  return store.upsert(table, key, apply, ttl);\n}\n","/// <reference lib=\"dom\" />\n\nimport { VaultError } from './errors';\nimport type { QueryBuilder } from './query';\nimport { assertPositiveFinite } from './ttl';\n\n/** Portable primary-key values. Vault preserves their type and encodes them distinctly at rest. */\nexport type VaultKey = number | string;\n\n/** A typed table definition whose primary-key field must hold a portable Vault key. */\nexport type SchemaEntry<T extends object, Key extends keyof T & string = keyof T & string> = {\n  defaultTtl?: number;\n  /** IndexedDB creates these as `value.<field>` indexes; other stores filter in memory. */\n  indexes?: readonly (keyof T & string)[];\n  key: Key;\n};\n\nexport type AnySchema = Record<string, { defaultTtl?: number; indexes?: readonly string[]; key: string }>;\n\nexport type RecordOf<S extends AnySchema, K extends keyof S> =\n  S[K] extends SchemaEntry<infer R, infer _Key> ? R : never;\nexport type KeyOf<S extends AnySchema, K extends keyof S> = Extract<\n  S[K] extends SchemaEntry<infer R, infer Key> ? R[Key] : never,\n  VaultKey\n>;\n\n/** A codec validates and decodes persisted values crossing a trust boundary. */\nexport type RecordCodec<T> = {\n  decode(value: unknown): T;\n  encode(value: T): unknown;\n};\n\nexport type RecordParser<T> = {\n  parse(value: unknown): T;\n};\n\nexport type CodecInput<T> = RecordCodec<T> | RecordParser<T>;\n\nexport type TableCodecs<S extends AnySchema> = {\n  [K in keyof S]: CodecInput<RecordOf<S, K>>;\n};\n\n/** A validator-only codec: encodes values as-is, validates on decode. */\nexport function validatorCodec<T>(validator: RecordParser<T>): RecordCodec<T> {\n  return {\n    decode: (value) => validator.parse(value),\n    encode: (value) => value,\n  };\n}\n\nexport type Observer<T> = (records: T[]) => void;\nexport type Unsubscribe = () => void;\n\n/** Shared factory options for stores that do not require durable codecs. */\nexport type MemoryStoreOptions<S extends AnySchema> = {\n  schema: S;\n  /** Optional per-table codecs. Memory values never cross a trust boundary, so codecs may be omitted. */\n  codecs?: TableCodecs<S>;\n};\n\n/** Shared factory options for durable stores whose values cross a trust boundary. */\nexport type DurableStoreOptions<S extends AnySchema> = {\n  schema: S;\n  /** Required per-table codecs. Persisted values are decoded through these before entering typed code. */\n  codecs: TableCodecs<S>;\n};\n\nexport type VaultConveniences<S extends AnySchema, K extends keyof S & string = keyof S & string> = {\n  count<T extends K>(table: T): Promise<number>;\n  deleteMany<T extends K>(table: T, keys: readonly KeyOf<S, T>[]): Promise<number>;\n  getMany<T extends K>(table: T, keys: readonly KeyOf<S, T>[]): Promise<Array<RecordOf<S, T> | undefined>>;\n  has<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;\n  isEmpty<T extends K>(table: T): Promise<boolean>;\n  keys<T extends K>(table: T, filter?: (record: RecordOf<S, T>) => boolean): Promise<KeyOf<S, T>[]>;\n  query<T extends K>(table: T): QueryBuilder<RecordOf<S, T>>;\n  update<T extends K>(\n    table: T,\n    key: KeyOf<S, T>,\n    changes: Partial<RecordOf<S, T>>,\n    ttl?: number,\n  ): Promise<RecordOf<S, T> | undefined>;\n  upsert<T extends K>(\n    table: T,\n    key: KeyOf<S, T>,\n    update: (existing: RecordOf<S, T> | undefined) => RecordOf<S, T>,\n    ttl?: number,\n  ): Promise<RecordOf<S, T>>;\n};\n\n/** Methods available within an IndexedDB or SQLite transaction. */\nexport type TransactionContext<S extends AnySchema, K extends keyof S & string = keyof S & string> = VaultConveniences<\n  S,\n  K\n> & {\n  clear<T extends K>(table: T): Promise<void>;\n  delete<T extends K>(table: T, key: KeyOf<S, T>): Promise<boolean>;\n  get<T extends K>(table: T, key: KeyOf<S, T>): Promise<RecordOf<S, T> | undefined>;\n  getAll<T extends K>(table: T): Promise<RecordOf<S, T>[]>;\n  iterate<T extends K>(table: T): AsyncIterable<RecordOf<S, T>>;\n  put<T extends K>(table: T, value: RecordOf<S, T>, ttl?: number): Promise<RecordOf<S, T>>;\n  putAll<T extends K>(table: T, values: readonly RecordOf<S, T>[], ttl?: number): Promise<void>;\n};\n\n/** Key-value store for Memory and Web Storage: core CRUD, observation, TTL, and pruning. */\nexport interface KeyValueVaultStore<S extends AnySchema> extends VaultConveniences<S> {\n  clear<K extends keyof S & string>(table: K): Promise<void>;\n  delete<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<boolean>;\n  readonly disposalSignal: AbortSignal;\n  dispose(): Promise<void>;\n  readonly disposed: boolean;\n  get<K extends keyof S & string>(table: K, key: KeyOf<S, K>): Promise<RecordOf<S, K> | undefined>;\n  getAll<K extends keyof S & string>(table: K): Promise<RecordOf<S, K>[]>;\n  observe<K extends keyof S & string>(\n    table: K,\n    listener: Observer<RecordOf<S, K>>,\n    options?: { immediate?: boolean; signal?: AbortSignal },\n  ): Unsubscribe;\n  pruneExpired(): Promise<Record<keyof S & string, number>>;\n  put<K extends keyof S & string>(table: K, value: RecordOf<S, K>, ttl?: number): Promise<RecordOf<S, K>>;\n  putAll<K extends keyof S & string>(table: K, values: readonly RecordOf<S, K>[], ttl?: number): Promise<void>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\n/** Document store for IndexedDB and SQLite: adds atomic transactions and lazy iteration. */\nexport interface DocumentVaultStore<S extends AnySchema> extends KeyValueVaultStore<S> {\n  batch<K extends keyof S & string, R>(\n    tables: readonly K[],\n    fn: (tx: TransactionContext<S, K>) => Promise<R>,\n  ): Promise<R>;\n  iterate<K extends keyof S & string>(table: K): AsyncIterable<RecordOf<S, K>>;\n}\n\ntype VaultKeyField<T extends object> = {\n  [K in keyof T & string]: T[K] extends VaultKey ? K : never;\n}[keyof T & string];\n\n/** Define a typed table whose primary-key field holds a portable Vault key. */\nexport function table<T extends object, Key extends VaultKeyField<T> = VaultKeyField<T>>(\n  key: Key,\n  options: { defaultTtl?: number; indexes?: readonly (keyof T & string)[] } = {},\n): SchemaEntry<T, Key> {\n  const { defaultTtl, indexes } = options;\n\n  if (defaultTtl !== undefined) assertPositiveFinite(defaultTtl, 'table: defaultTtl');\n\n  if (indexes) {\n    const seen = new Set<string>();\n\n    for (const field of indexes) {\n      if (seen.has(field)) {\n        throw new VaultError(`table: index \"${field}\" is already registered`);\n      }\n\n      seen.add(field);\n    }\n  }\n\n  return { defaultTtl, indexes, key };\n}\n"],"mappings":"mEAIA,IAAa,EAAb,cAAgC,KAAM,CACpC,OAA0B,UAAoB,aAE9C,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAQ,WAAiC,UAE9C,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAGa,EAAb,cAAwC,CAAW,CACjD,OAAmC,UAAY,qBAE/C,YAAY,EAAU,sBAAuB,EAAqB,CAChE,MAAM,EAAS,CAAI,CACrB,CACF,EAGa,EAAb,cAAqC,CAAW,CAC9C,OAAmC,UAAY,iBACjD,EAGa,EAAb,cAAqC,CAAW,CAC9C,OAAmC,UAAY,iBACjD,EAGa,EAAb,cAAyC,CAAW,CAClD,OAAmC,UAAY,qBACjD,EClCa,EAAM,CACjB,KAAO,GAAc,EAAqB,EAAI,MAAY,UAAU,EACpE,MAAQ,GAAc,EAAqB,EAAI,KAAW,WAAW,EACrE,QAAU,GAAc,EAAqB,EAAI,IAAQ,aAAa,EACtE,GAAK,GAAc,EAAqB,EAAG,QAAQ,EACnD,QAAU,GAAc,EAAqB,EAAI,IAAM,aAAa,CACtE,EAKA,SAAgB,EAAU,EAAwC,CAChE,OAAO,IAAc,IAAA,IAAa,KAAK,IAAI,GAAK,CAClD,CAGA,SAAgB,EAAqB,EAAe,EAAwB,CAC1E,GAAI,CAAC,OAAO,SAAS,CAAK,GAAK,GAAS,EACtC,MAAM,IAAI,EAAW,GAAG,EAAO,+CAA+C,OAAO,CAAK,GAAG,EAG/F,OAAO,CACT,CC2eA,eAAsB,EACpB,EACA,EACA,EACkB,CAClB,OAAO,EAAM,IAAI,EAAO,CAAG,CAC7B,CAGA,eAAsB,EACpB,EACA,EACiB,CACjB,OAAO,EAAM,MAAM,CAAK,CAC1B,CAGA,eAAsB,EACpB,EACA,EACkB,CAClB,OAAO,EAAM,QAAQ,CAAK,CAC5B,CAGA,eAAsB,EACpB,EACA,EACA,EAC4C,CAC5C,OAAO,EAAM,QAAQ,EAAO,CAAI,CAClC,CAGA,eAAsB,EACpB,EACA,EACA,EACwB,CACxB,OAAO,EAAM,KAAK,EAAO,CAAM,CACjC,CAGA,eAAsB,EACpB,EACA,EACA,EACiB,CACjB,OAAO,EAAM,WAAW,EAAO,CAAI,CACrC,CAGA,eAAsB,EACpB,EACA,EACA,EACA,EACA,EACqC,CACrC,OAAO,EAAM,OAAO,EAAO,EAAK,EAAS,CAAG,CAC9C,CAGA,eAAsB,EACpB,EACA,EACA,EACA,EACA,EACyB,CACzB,OAAO,EAAM,OAAO,EAAO,EAAK,EAAO,CAAG,CAC5C,CChiBA,SAAgB,EAAkB,EAA4C,CAC5E,MAAO,CACL,OAAS,GAAU,EAAU,MAAM,CAAK,EACxC,OAAS,GAAU,CACrB,CACF,CAyFA,SAAgB,EACd,EACA,EAA4E,CAAC,EACxD,CACrB,GAAM,CAAE,aAAY,WAAY,EAIhC,GAFI,IAAe,IAAA,IAAW,EAAqB,EAAY,mBAAmB,EAE9E,EAAS,CACX,IAAM,EAAO,IAAI,IAEjB,IAAK,IAAM,KAAS,EAAS,CAC3B,GAAI,EAAK,IAAI,CAAK,EAChB,MAAM,IAAI,EAAW,iBAAiB,EAAM,wBAAwB,EAGtE,EAAK,IAAI,CAAK,CAChB,CACF,CAEA,MAAO,CAAE,aAAY,UAAS,KAAI,CACpC"}

package/dist/vault.iife.js

@@ -1,2 +1,2 @@
-var Vault=(function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var t=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},n=class extends t{constructor(e=`adapter is disposed`,t){super(e,t)}},r=class extends t{},i=class extends t{},a=class extends t{},o={days:e=>c(e*864e5,`ttl.days`),hours:e=>c(e*36e5,`ttl.hours`),minutes:e=>c(e*6e4,`ttl.minutes`),ms:e=>c(e,`ttl.ms`),seconds:e=>c(e*1e3,`ttl.seconds`)};function s(e){return e!==void 0&&Date.now()>=e}function c(e,n){if(!Number.isFinite(e)||e<=0)throw new t(`${n} expected a finite positive number, received ${String(e)}`);return e}function l(e,n={}){let{defaultTtl:r,indexes:i}=n;if(r!==void 0&&c(r,`table: defaultTtl`),i){let e=new Set;for(let n of i){if(e.has(n))throw new t(`table: index "${n}" is already registered`);e.add(n)}}return{defaultTtl:r,indexes:i,key:e}}return e.VaultDisposedError=n,e.VaultError=t,e.VaultMigrationError=a,e.VaultQuotaError=i,e.VaultScopeError=r,e.isExpired=s,e.table=l,e.ttl=o,e})({});
+var Vault=(function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var t=class extends Error{static errorName=`VaultError`;constructor(e,t){super(e,t),this.name=new.target.errorName,Object.setPrototypeOf(this,new.target.prototype)}},n=class extends t{static errorName=`VaultDisposedError`;constructor(e=`adapter is disposed`,t){super(e,t)}},r=class extends t{static errorName=`VaultScopeError`},i=class extends t{static errorName=`VaultQuotaError`},a=class extends t{static errorName=`VaultMigrationError`},o={days:e=>c(e*864e5,`ttl.days`),hours:e=>c(e*36e5,`ttl.hours`),minutes:e=>c(e*6e4,`ttl.minutes`),ms:e=>c(e,`ttl.ms`),seconds:e=>c(e*1e3,`ttl.seconds`)};function s(e){return e!==void 0&&Date.now()>=e}function c(e,n){if(!Number.isFinite(e)||e<=0)throw new t(`${n} expected a finite positive number, received ${String(e)}`);return e}async function l(e,t,n){return e.has(t,n)}async function u(e,t){return e.count(t)}async function d(e,t){return e.isEmpty(t)}async function f(e,t,n){return e.getMany(t,n)}async function p(e,t,n){return e.keys(t,n)}async function m(e,t,n){return e.deleteMany(t,n)}async function h(e,t,n,r,i){return e.update(t,n,r,i)}async function g(e,t,n,r,i){return e.upsert(t,n,r,i)}function _(e){return{decode:t=>e.parse(t),encode:e=>e}}function v(e,n={}){let{defaultTtl:r,indexes:i}=n;if(r!==void 0&&c(r,`table: defaultTtl`),i){let e=new Set;for(let n of i){if(e.has(n))throw new t(`table: index "${n}" is already registered`);e.add(n)}}return{defaultTtl:r,indexes:i,key:e}}return e.VaultDisposedError=n,e.VaultError=t,e.VaultMigrationError=a,e.VaultQuotaError=i,e.VaultScopeError=r,e.count=u,e.deleteMany=m,e.getMany=f,e.has=l,e.isEmpty=d,e.isExpired=s,e.keys=p,e.table=v,e.ttl=o,e.update=h,e.upsert=g,e.validatorCodec=_,e})({});
 //# sourceMappingURL=vault.iife.js.map