@noy-db/in-devtools 0.2.0-pre.9 → 0.3.0-pre.1

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AccessibleVault, Vault, CollectionDescriptor, CollectionStats, WriteEvent, WriteConflict, Noydb } from '@noy-db/hub';
+import { AccessibleVault, Vault, WriteHook, Unsubscribe, WriteConflict, WriteQueue, CollectionDescriptor, CollectionStats, CollectionMeta, DescribedField, CollectionConfig, VaultMeta, WriteEvent } from '@noy-db/hub';
 import { MeterSnapshot } from '@noy-db/to-meter';
 
 /** Minimal structural view of a to-meter handle the inspector reads (no runtime dep). */
@@ -18,11 +18,19 @@ interface InspectorCollection {
     readonly indexes: CollectionDescriptor['indexes'];
     readonly refs: CollectionDescriptor['refs'];
     readonly stats?: CollectionStats;
+    /** Collection-level descriptive metadata (label/description/icon). */
+    readonly meta?: CollectionMeta;
+    /** Per-field rich descriptors from collection.describe() (label/widget/money/dict/…). */
+    readonly described?: readonly DescribedField[];
+    /** Collection-level configuration (textIndexes/embeddings/crdt/provenance/…). */
+    readonly config?: CollectionConfig;
 }
 /** Structure + stats for one open vault. */
 interface InspectorSnapshot {
     readonly vault: string;
     readonly collections: ReadonlyArray<InspectorCollection>;
+    /** Vault-level descriptive metadata (label/description/icon). */
+    readonly meta?: VaultMeta;
 }
 /** A page of decrypted records from one collection. */
 interface RecordPage {
@@ -54,11 +62,21 @@ interface Inspector {
     /** Aggregate store-op latency snapshot, or null when the store is not metered. */
     meterSnapshot(): MeterSnapshot | null;
 }
-/** @internal — the hub handle the inspector reads from. */
-type InspectorNoydb = Noydb;
+/**
+ * The container of vaults the inspector reads from. A `Noydb` satisfies this
+ * verbatim; a klum `VaultGroup` adapter conforms structurally — so the inspector
+ * works on a single instance OR a federation without importing either.
+ */
+interface InspectableContainer {
+    listAccessibleVaults(): Promise<readonly AccessibleVault[]>;
+    openVault(name: string): Promise<Vault>;
+    onAfterWrite(handler: WriteHook): Unsubscribe;
+    onWriteConflict(handler: (c: WriteConflict) => void): Unsubscribe;
+    readonly writeQueue: WriteQueue;
+}
 
-declare function createInspector(noydb: InspectorNoydb, opts?: {
+declare function createInspector(container: InspectableContainer, opts?: {
     meter?: InspectorMeter;
 }): Inspector;
 
-export { type Inspector, type InspectorCollection, type InspectorMeter, type InspectorSnapshot, type InspectorWriteConflict, type InspectorWriteEvent, type PendingWrites, type RecordPage, type VaultInfo, createInspector };
+export { type InspectableContainer, type Inspector, type InspectorCollection, type InspectorMeter, type InspectorSnapshot, type InspectorWriteConflict, type InspectorWriteEvent, type PendingWrites, type RecordPage, type VaultInfo, createInspector };

package/dist/index.js

@@ -4,14 +4,30 @@ async function listVaults(noydb) {
 }
 async function snapshot(vault) {
   const dump = await vault.dumpSchema({ withStats: true });
-  const collections = Object.entries(dump.collections).map(([name, desc]) => ({
-    name,
-    fields: desc.fields,
-    indexes: desc.indexes,
-    refs: desc.refs,
-    ...desc.stats !== void 0 ? { stats: desc.stats } : {}
-  }));
-  return { vault: dump.vault, collections };
+  const collections = Object.entries(dump.collections).map(([name, desc]) => {
+    let described;
+    try {
+      const coll = vault.collection(name);
+      const collDesc = coll.describe();
+      described = collDesc.fields;
+    } catch {
+    }
+    return {
+      name,
+      fields: desc.fields,
+      indexes: desc.indexes,
+      refs: desc.refs,
+      ...desc.stats !== void 0 ? { stats: desc.stats } : {},
+      ...desc.meta !== void 0 ? { meta: desc.meta } : {},
+      ...desc.config !== void 0 ? { config: desc.config } : {},
+      ...described !== void 0 ? { described } : {}
+    };
+  });
+  return {
+    vault: dump.vault,
+    collections,
+    ...dump.meta !== void 0 ? { meta: dump.meta } : {}
+  };
 }
 
 // src/records.ts
@@ -55,14 +71,14 @@ function meterSnapshot(meter) {
 }
 
 // src/index.ts
-function createInspector(noydb, opts) {
+function createInspector(container, opts) {
   return {
-    listVaults: () => listVaults(noydb),
+    listVaults: () => listVaults(container),
     snapshot: (vault) => snapshot(vault),
     records: (vault, collection, opts2) => records(vault, collection, opts2),
-    subscribe: (handler) => subscribe(noydb, handler),
-    subscribeConflicts: (handler) => subscribeConflicts(noydb, handler),
-    pendingWrites: () => pendingWrites(noydb),
+    subscribe: (handler) => subscribe(container, handler),
+    subscribeConflicts: (handler) => subscribeConflicts(container, handler),
+    pendingWrites: () => pendingWrites(container),
     meterSnapshot: () => meterSnapshot(opts?.meter)
   };
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/snapshot.ts","../src/records.ts","../src/events.ts","../src/meter.ts","../src/index.ts"],"sourcesContent":["import type { Vault } from '@noy-db/hub'\nimport type { InspectorSnapshot, InspectorCollection, VaultInfo, InspectorNoydb } from './types.js'\n\nexport async function listVaults(noydb: InspectorNoydb): Promise<ReadonlyArray<VaultInfo>> {\n  return noydb.listAccessibleVaults()\n}\n\nexport async function snapshot(vault: Vault): Promise<InspectorSnapshot> {\n  // withStats populates per-collection record/byte stats; opaque to the store.\n  const dump = await vault.dumpSchema({ withStats: true })\n  // Omit `stats` when absent rather than setting it to `undefined` —\n  // the repo's tsconfig sets `exactOptionalPropertyTypes`, so an optional\n  // `stats?` field must be omitted, not explicitly undefined.\n  const collections: InspectorCollection[] = Object.entries(dump.collections).map(([name, desc]) => ({\n    name,\n    fields: desc.fields,\n    indexes: desc.indexes,\n    refs: desc.refs,\n    ...(desc.stats !== undefined ? { stats: desc.stats } : {}),\n  }))\n  return { vault: dump.vault, collections }\n}\n","import type { Vault } from '@noy-db/hub'\nimport type { RecordPage } from './types.js'\n\nconst DEFAULT_LIMIT = 50\nconst MAX_LIMIT = 500\n\nfunction clampLimit(n: number | undefined): number {\n  if (n === undefined || Number.isNaN(n)) return DEFAULT_LIMIT\n  return Math.max(1, Math.min(MAX_LIMIT, Math.floor(n)))\n}\n\nfunction clampOffset(n: number | undefined): number {\n  if (n === undefined || Number.isNaN(n) || n < 0) return 0\n  return Math.floor(n)\n}\n\nexport async function records(\n  vault: Vault,\n  collection: string,\n  opts: { limit?: number; offset?: number } = {},\n): Promise<RecordPage> {\n  const limit = clampLimit(opts.limit)\n  const offset = clampOffset(opts.offset)\n  // Eager collections only — `list()` throws on lazy (prefetch:false). The\n  // error propagates to the caller, which decides how to surface it.\n  const all = await vault.collection(collection).list()\n  return {\n    rows: all.slice(offset, offset + limit),\n    total: all.length,\n    limit,\n    offset,\n  }\n}\n","import type { InspectorWriteEvent, InspectorWriteConflict, PendingWrites, InspectorNoydb } from './types.js'\n\nexport function subscribe(\n  noydb: InspectorNoydb,\n  handler: (event: InspectorWriteEvent) => void,\n): () => void {\n  return noydb.onAfterWrite(handler)\n}\n\nexport function pendingWrites(noydb: InspectorNoydb): PendingWrites {\n  const q = noydb.writeQueue\n  return { pending: q.pending, depth: q.depth }\n}\n\nexport function subscribeConflicts(noydb: InspectorNoydb, handler: (c: InspectorWriteConflict) => void): () => void {\n  return noydb.onWriteConflict(handler)\n}\n","import type { InspectorMeter } from './types.js'\nimport type { MeterSnapshot } from '@noy-db/to-meter'\n\nexport function meterSnapshot(meter: InspectorMeter | undefined): MeterSnapshot | null {\n  return meter ? meter.snapshot() : null\n}\n","import type { Vault } from '@noy-db/hub'\nimport type { Inspector, InspectorNoydb, InspectorMeter } from './types.js'\nimport { listVaults, snapshot } from './snapshot.js'\nimport { records } from './records.js'\nimport { subscribe, subscribeConflicts, pendingWrites } from './events.js'\nimport { meterSnapshot } from './meter.js'\n\nexport function createInspector(noydb: InspectorNoydb, opts?: { meter?: InspectorMeter }): Inspector {\n  return {\n    listVaults: () => listVaults(noydb),\n    snapshot: (vault: Vault) => snapshot(vault),\n    records: (vault, collection, opts) => records(vault, collection, opts),\n    subscribe: (handler) => subscribe(noydb, handler),\n    subscribeConflicts: (handler) => subscribeConflicts(noydb, handler),\n    pendingWrites: () => pendingWrites(noydb),\n    meterSnapshot: () => meterSnapshot(opts?.meter),\n  }\n}\n\nexport type {\n  Inspector,\n  VaultInfo,\n  InspectorSnapshot,\n  InspectorCollection,\n  RecordPage,\n  InspectorWriteEvent,\n  InspectorWriteConflict,\n  PendingWrites,\n  InspectorMeter,\n} from './types.js'\n"],"mappings":";AAGA,eAAsB,WAAW,OAA0D;AACzF,SAAO,MAAM,qBAAqB;AACpC;AAEA,eAAsB,SAAS,OAA0C;AAEvE,QAAM,OAAO,MAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;AAIvD,QAAM,cAAqC,OAAO,QAAQ,KAAK,WAAW,EAAE,IAAI,CAAC,CAAC,MAAM,IAAI,OAAO;AAAA,IACjG;AAAA,IACA,QAAQ,KAAK;AAAA,IACb,SAAS,KAAK;AAAA,IACd,MAAM,KAAK;AAAA,IACX,GAAI,KAAK,UAAU,SAAY,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;AAAA,EAC1D,EAAE;AACF,SAAO,EAAE,OAAO,KAAK,OAAO,YAAY;AAC1C;;;AClBA,IAAM,gBAAgB;AACtB,IAAM,YAAY;AAElB,SAAS,WAAW,GAA+B;AACjD,MAAI,MAAM,UAAa,OAAO,MAAM,CAAC,EAAG,QAAO;AAC/C,SAAO,KAAK,IAAI,GAAG,KAAK,IAAI,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC;AACvD;AAEA,SAAS,YAAY,GAA+B;AAClD,MAAI,MAAM,UAAa,OAAO,MAAM,CAAC,KAAK,IAAI,EAAG,QAAO;AACxD,SAAO,KAAK,MAAM,CAAC;AACrB;AAEA,eAAsB,QACpB,OACA,YACA,OAA4C,CAAC,GACxB;AACrB,QAAM,QAAQ,WAAW,KAAK,KAAK;AACnC,QAAM,SAAS,YAAY,KAAK,MAAM;AAGtC,QAAM,MAAM,MAAM,MAAM,WAAW,UAAU,EAAE,KAAK;AACpD,SAAO;AAAA,IACL,MAAM,IAAI,MAAM,QAAQ,SAAS,KAAK;AAAA,IACtC,OAAO,IAAI;AAAA,IACX;AAAA,IACA;AAAA,EACF;AACF;;;AC9BO,SAAS,UACd,OACA,SACY;AACZ,SAAO,MAAM,aAAa,OAAO;AACnC;AAEO,SAAS,cAAc,OAAsC;AAClE,QAAM,IAAI,MAAM;AAChB,SAAO,EAAE,SAAS,EAAE,SAAS,OAAO,EAAE,MAAM;AAC9C;AAEO,SAAS,mBAAmB,OAAuB,SAA0D;AAClH,SAAO,MAAM,gBAAgB,OAAO;AACtC;;;ACbO,SAAS,cAAc,OAAyD;AACrF,SAAO,QAAQ,MAAM,SAAS,IAAI;AACpC;;;ACEO,SAAS,gBAAgB,OAAuB,MAA8C;AACnG,SAAO;AAAA,IACL,YAAY,MAAM,WAAW,KAAK;AAAA,IAClC,UAAU,CAAC,UAAiB,SAAS,KAAK;AAAA,IAC1C,SAAS,CAAC,OAAO,YAAYA,UAAS,QAAQ,OAAO,YAAYA,KAAI;AAAA,IACrE,WAAW,CAAC,YAAY,UAAU,OAAO,OAAO;AAAA,IAChD,oBAAoB,CAAC,YAAY,mBAAmB,OAAO,OAAO;AAAA,IAClE,eAAe,MAAM,cAAc,KAAK;AAAA,IACxC,eAAe,MAAM,cAAc,MAAM,KAAK;AAAA,EAChD;AACF;","names":["opts"]}
+{"version":3,"sources":["../src/snapshot.ts","../src/records.ts","../src/events.ts","../src/meter.ts","../src/index.ts"],"sourcesContent":["import type { Vault } from '@noy-db/hub'\nimport type { InspectorSnapshot, InspectorCollection, VaultInfo, InspectableContainer } from './types.js'\n\nexport async function listVaults(noydb: InspectableContainer): Promise<ReadonlyArray<VaultInfo>> {\n  return noydb.listAccessibleVaults()\n}\n\nexport async function snapshot(vault: Vault): Promise<InspectorSnapshot> {\n  // withStats populates per-collection record/byte stats; opaque to the store.\n  const dump = await vault.dumpSchema({ withStats: true })\n  // Omit optional properties when absent rather than setting them to `undefined` —\n  // the repo's tsconfig sets `exactOptionalPropertyTypes`, so optional fields must\n  // be omitted, not explicitly set to undefined.\n  const collections: InspectorCollection[] = Object.entries(dump.collections).map(([name, desc]) => {\n    // Attempt to call describe() on the live collection to get rich field descriptors.\n    // Guard: a collection that was not live-declared on this Vault instance (e.g. from a\n    // prior open or a different process) may throw or return minimal output — skip\n    // `described` for it without failing the whole snapshot.\n    let described: InspectorCollection['described'] | undefined\n    try {\n      const coll = vault.collection(name)\n      const collDesc = coll.describe()\n      described = collDesc.fields\n    } catch {\n      // Not live-declared or no schema — skip described for this collection.\n    }\n\n    return {\n      name,\n      fields: desc.fields,\n      indexes: desc.indexes,\n      refs: desc.refs,\n      ...(desc.stats !== undefined ? { stats: desc.stats } : {}),\n      ...(desc.meta !== undefined ? { meta: desc.meta } : {}),\n      ...(desc.config !== undefined ? { config: desc.config } : {}),\n      ...(described !== undefined ? { described } : {}),\n    }\n  })\n\n  return {\n    vault: dump.vault,\n    collections,\n    ...(dump.meta !== undefined ? { meta: dump.meta } : {}),\n  }\n}\n","import type { Vault } from '@noy-db/hub'\nimport type { RecordPage } from './types.js'\n\nconst DEFAULT_LIMIT = 50\nconst MAX_LIMIT = 500\n\nfunction clampLimit(n: number | undefined): number {\n  if (n === undefined || Number.isNaN(n)) return DEFAULT_LIMIT\n  return Math.max(1, Math.min(MAX_LIMIT, Math.floor(n)))\n}\n\nfunction clampOffset(n: number | undefined): number {\n  if (n === undefined || Number.isNaN(n) || n < 0) return 0\n  return Math.floor(n)\n}\n\nexport async function records(\n  vault: Vault,\n  collection: string,\n  opts: { limit?: number; offset?: number } = {},\n): Promise<RecordPage> {\n  const limit = clampLimit(opts.limit)\n  const offset = clampOffset(opts.offset)\n  // Eager collections only — `list()` throws on lazy (prefetch:false). The\n  // error propagates to the caller, which decides how to surface it.\n  const all = await vault.collection(collection).list()\n  return {\n    rows: all.slice(offset, offset + limit),\n    total: all.length,\n    limit,\n    offset,\n  }\n}\n","import type { InspectorWriteEvent, InspectorWriteConflict, PendingWrites, InspectableContainer } from './types.js'\n\nexport function subscribe(\n  noydb: InspectableContainer,\n  handler: (event: InspectorWriteEvent) => void,\n): () => void {\n  return noydb.onAfterWrite(handler)\n}\n\nexport function pendingWrites(noydb: InspectableContainer): PendingWrites {\n  const q = noydb.writeQueue\n  return { pending: q.pending, depth: q.depth }\n}\n\nexport function subscribeConflicts(noydb: InspectableContainer, handler: (c: InspectorWriteConflict) => void): () => void {\n  return noydb.onWriteConflict(handler)\n}\n","import type { InspectorMeter } from './types.js'\nimport type { MeterSnapshot } from '@noy-db/to-meter'\n\nexport function meterSnapshot(meter: InspectorMeter | undefined): MeterSnapshot | null {\n  return meter ? meter.snapshot() : null\n}\n","import type { Vault } from '@noy-db/hub'\nimport type { Inspector, InspectableContainer, InspectorMeter } from './types.js'\nimport { listVaults, snapshot } from './snapshot.js'\nimport { records } from './records.js'\nimport { subscribe, subscribeConflicts, pendingWrites } from './events.js'\nimport { meterSnapshot } from './meter.js'\n\nexport function createInspector(container: InspectableContainer, opts?: { meter?: InspectorMeter }): Inspector {\n  return {\n    listVaults: () => listVaults(container),\n    snapshot: (vault: Vault) => snapshot(vault),\n    records: (vault, collection, opts) => records(vault, collection, opts),\n    subscribe: (handler) => subscribe(container, handler),\n    subscribeConflicts: (handler) => subscribeConflicts(container, handler),\n    pendingWrites: () => pendingWrites(container),\n    meterSnapshot: () => meterSnapshot(opts?.meter),\n  }\n}\n\nexport type {\n  Inspector,\n  InspectableContainer,\n  VaultInfo,\n  InspectorSnapshot,\n  InspectorCollection,\n  RecordPage,\n  InspectorWriteEvent,\n  InspectorWriteConflict,\n  PendingWrites,\n  InspectorMeter,\n} from './types.js'\n"],"mappings":";AAGA,eAAsB,WAAW,OAAgE;AAC/F,SAAO,MAAM,qBAAqB;AACpC;AAEA,eAAsB,SAAS,OAA0C;AAEvE,QAAM,OAAO,MAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;AAIvD,QAAM,cAAqC,OAAO,QAAQ,KAAK,WAAW,EAAE,IAAI,CAAC,CAAC,MAAM,IAAI,MAAM;AAKhG,QAAI;AACJ,QAAI;AACF,YAAM,OAAO,MAAM,WAAW,IAAI;AAClC,YAAM,WAAW,KAAK,SAAS;AAC/B,kBAAY,SAAS;AAAA,IACvB,QAAQ;AAAA,IAER;AAEA,WAAO;AAAA,MACL;AAAA,MACA,QAAQ,KAAK;AAAA,MACb,SAAS,KAAK;AAAA,MACd,MAAM,KAAK;AAAA,MACX,GAAI,KAAK,UAAU,SAAY,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;AAAA,MACxD,GAAI,KAAK,SAAS,SAAY,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC;AAAA,MACrD,GAAI,KAAK,WAAW,SAAY,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;AAAA,MAC3D,GAAI,cAAc,SAAY,EAAE,UAAU,IAAI,CAAC;AAAA,IACjD;AAAA,EACF,CAAC;AAED,SAAO;AAAA,IACL,OAAO,KAAK;AAAA,IACZ;AAAA,IACA,GAAI,KAAK,SAAS,SAAY,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC;AAAA,EACvD;AACF;;;ACzCA,IAAM,gBAAgB;AACtB,IAAM,YAAY;AAElB,SAAS,WAAW,GAA+B;AACjD,MAAI,MAAM,UAAa,OAAO,MAAM,CAAC,EAAG,QAAO;AAC/C,SAAO,KAAK,IAAI,GAAG,KAAK,IAAI,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC;AACvD;AAEA,SAAS,YAAY,GAA+B;AAClD,MAAI,MAAM,UAAa,OAAO,MAAM,CAAC,KAAK,IAAI,EAAG,QAAO;AACxD,SAAO,KAAK,MAAM,CAAC;AACrB;AAEA,eAAsB,QACpB,OACA,YACA,OAA4C,CAAC,GACxB;AACrB,QAAM,QAAQ,WAAW,KAAK,KAAK;AACnC,QAAM,SAAS,YAAY,KAAK,MAAM;AAGtC,QAAM,MAAM,MAAM,MAAM,WAAW,UAAU,EAAE,KAAK;AACpD,SAAO;AAAA,IACL,MAAM,IAAI,MAAM,QAAQ,SAAS,KAAK;AAAA,IACtC,OAAO,IAAI;AAAA,IACX;AAAA,IACA;AAAA,EACF;AACF;;;AC9BO,SAAS,UACd,OACA,SACY;AACZ,SAAO,MAAM,aAAa,OAAO;AACnC;AAEO,SAAS,cAAc,OAA4C;AACxE,QAAM,IAAI,MAAM;AAChB,SAAO,EAAE,SAAS,EAAE,SAAS,OAAO,EAAE,MAAM;AAC9C;AAEO,SAAS,mBAAmB,OAA6B,SAA0D;AACxH,SAAO,MAAM,gBAAgB,OAAO;AACtC;;;ACbO,SAAS,cAAc,OAAyD;AACrF,SAAO,QAAQ,MAAM,SAAS,IAAI;AACpC;;;ACEO,SAAS,gBAAgB,WAAiC,MAA8C;AAC7G,SAAO;AAAA,IACL,YAAY,MAAM,WAAW,SAAS;AAAA,IACtC,UAAU,CAAC,UAAiB,SAAS,KAAK;AAAA,IAC1C,SAAS,CAAC,OAAO,YAAYA,UAAS,QAAQ,OAAO,YAAYA,KAAI;AAAA,IACrE,WAAW,CAAC,YAAY,UAAU,WAAW,OAAO;AAAA,IACpD,oBAAoB,CAAC,YAAY,mBAAmB,WAAW,OAAO;AAAA,IACtE,eAAe,MAAM,cAAc,SAAS;AAAA,IAC5C,eAAe,MAAM,cAAc,MAAM,KAAK;AAAA,EAChD;AACF;","names":["opts"]}

package/package.json

@@ -1,33 +1,29 @@
 {
   "name": "@noy-db/in-devtools",
-  "version": "0.2.0-pre.9",
+  "version": "0.3.0-pre.1",
   "description": "Framework-agnostic read-only inspector for a live noy-db — vaults, collections, schema, stats, records, and live writes.",
   "license": "MIT",
   "type": "module",
-  "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     }
   },
   "files": [
     "dist"
   ],
   "peerDependencies": {
-    "@noy-db/hub": "0.2.0-pre.9"
+    "@noy-db/hub": "0.3.0-pre.1"
   },
   "devDependencies": {
-    "@noy-db/hub": "0.2.0-pre.9",
-    "@noy-db/to-meter": "0.2.0-pre.9"
+    "@noy-db/hub": "0.3.0-pre.1",
+    "@noy-db/to-meter": "0.3.0-pre.1"
+  },
+  "engines": {
+    "node": ">=22.0.0"
   },
   "scripts": {
     "build": "tsup",

package/dist/index.cjs

@@ -1,99 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  createInspector: () => createInspector
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/snapshot.ts
-async function listVaults(noydb) {
-  return noydb.listAccessibleVaults();
-}
-async function snapshot(vault) {
-  const dump = await vault.dumpSchema({ withStats: true });
-  const collections = Object.entries(dump.collections).map(([name, desc]) => ({
-    name,
-    fields: desc.fields,
-    indexes: desc.indexes,
-    refs: desc.refs,
-    ...desc.stats !== void 0 ? { stats: desc.stats } : {}
-  }));
-  return { vault: dump.vault, collections };
-}
-
-// src/records.ts
-var DEFAULT_LIMIT = 50;
-var MAX_LIMIT = 500;
-function clampLimit(n) {
-  if (n === void 0 || Number.isNaN(n)) return DEFAULT_LIMIT;
-  return Math.max(1, Math.min(MAX_LIMIT, Math.floor(n)));
-}
-function clampOffset(n) {
-  if (n === void 0 || Number.isNaN(n) || n < 0) return 0;
-  return Math.floor(n);
-}
-async function records(vault, collection, opts = {}) {
-  const limit = clampLimit(opts.limit);
-  const offset = clampOffset(opts.offset);
-  const all = await vault.collection(collection).list();
-  return {
-    rows: all.slice(offset, offset + limit),
-    total: all.length,
-    limit,
-    offset
-  };
-}
-
-// src/events.ts
-function subscribe(noydb, handler) {
-  return noydb.onAfterWrite(handler);
-}
-function pendingWrites(noydb) {
-  const q = noydb.writeQueue;
-  return { pending: q.pending, depth: q.depth };
-}
-function subscribeConflicts(noydb, handler) {
-  return noydb.onWriteConflict(handler);
-}
-
-// src/meter.ts
-function meterSnapshot(meter) {
-  return meter ? meter.snapshot() : null;
-}
-
-// src/index.ts
-function createInspector(noydb, opts) {
-  return {
-    listVaults: () => listVaults(noydb),
-    snapshot: (vault) => snapshot(vault),
-    records: (vault, collection, opts2) => records(vault, collection, opts2),
-    subscribe: (handler) => subscribe(noydb, handler),
-    subscribeConflicts: (handler) => subscribeConflicts(noydb, handler),
-    pendingWrites: () => pendingWrites(noydb),
-    meterSnapshot: () => meterSnapshot(opts?.meter)
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createInspector
-});
-//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts","../src/snapshot.ts","../src/records.ts","../src/events.ts","../src/meter.ts"],"sourcesContent":["import type { Vault } from '@noy-db/hub'\nimport type { Inspector, InspectorNoydb, InspectorMeter } from './types.js'\nimport { listVaults, snapshot } from './snapshot.js'\nimport { records } from './records.js'\nimport { subscribe, subscribeConflicts, pendingWrites } from './events.js'\nimport { meterSnapshot } from './meter.js'\n\nexport function createInspector(noydb: InspectorNoydb, opts?: { meter?: InspectorMeter }): Inspector {\n  return {\n    listVaults: () => listVaults(noydb),\n    snapshot: (vault: Vault) => snapshot(vault),\n    records: (vault, collection, opts) => records(vault, collection, opts),\n    subscribe: (handler) => subscribe(noydb, handler),\n    subscribeConflicts: (handler) => subscribeConflicts(noydb, handler),\n    pendingWrites: () => pendingWrites(noydb),\n    meterSnapshot: () => meterSnapshot(opts?.meter),\n  }\n}\n\nexport type {\n  Inspector,\n  VaultInfo,\n  InspectorSnapshot,\n  InspectorCollection,\n  RecordPage,\n  InspectorWriteEvent,\n  InspectorWriteConflict,\n  PendingWrites,\n  InspectorMeter,\n} from './types.js'\n","import type { Vault } from '@noy-db/hub'\nimport type { InspectorSnapshot, InspectorCollection, VaultInfo, InspectorNoydb } from './types.js'\n\nexport async function listVaults(noydb: InspectorNoydb): Promise<ReadonlyArray<VaultInfo>> {\n  return noydb.listAccessibleVaults()\n}\n\nexport async function snapshot(vault: Vault): Promise<InspectorSnapshot> {\n  // withStats populates per-collection record/byte stats; opaque to the store.\n  const dump = await vault.dumpSchema({ withStats: true })\n  // Omit `stats` when absent rather than setting it to `undefined` —\n  // the repo's tsconfig sets `exactOptionalPropertyTypes`, so an optional\n  // `stats?` field must be omitted, not explicitly undefined.\n  const collections: InspectorCollection[] = Object.entries(dump.collections).map(([name, desc]) => ({\n    name,\n    fields: desc.fields,\n    indexes: desc.indexes,\n    refs: desc.refs,\n    ...(desc.stats !== undefined ? { stats: desc.stats } : {}),\n  }))\n  return { vault: dump.vault, collections }\n}\n","import type { Vault } from '@noy-db/hub'\nimport type { RecordPage } from './types.js'\n\nconst DEFAULT_LIMIT = 50\nconst MAX_LIMIT = 500\n\nfunction clampLimit(n: number | undefined): number {\n  if (n === undefined || Number.isNaN(n)) return DEFAULT_LIMIT\n  return Math.max(1, Math.min(MAX_LIMIT, Math.floor(n)))\n}\n\nfunction clampOffset(n: number | undefined): number {\n  if (n === undefined || Number.isNaN(n) || n < 0) return 0\n  return Math.floor(n)\n}\n\nexport async function records(\n  vault: Vault,\n  collection: string,\n  opts: { limit?: number; offset?: number } = {},\n): Promise<RecordPage> {\n  const limit = clampLimit(opts.limit)\n  const offset = clampOffset(opts.offset)\n  // Eager collections only — `list()` throws on lazy (prefetch:false). The\n  // error propagates to the caller, which decides how to surface it.\n  const all = await vault.collection(collection).list()\n  return {\n    rows: all.slice(offset, offset + limit),\n    total: all.length,\n    limit,\n    offset,\n  }\n}\n","import type { InspectorWriteEvent, InspectorWriteConflict, PendingWrites, InspectorNoydb } from './types.js'\n\nexport function subscribe(\n  noydb: InspectorNoydb,\n  handler: (event: InspectorWriteEvent) => void,\n): () => void {\n  return noydb.onAfterWrite(handler)\n}\n\nexport function pendingWrites(noydb: InspectorNoydb): PendingWrites {\n  const q = noydb.writeQueue\n  return { pending: q.pending, depth: q.depth }\n}\n\nexport function subscribeConflicts(noydb: InspectorNoydb, handler: (c: InspectorWriteConflict) => void): () => void {\n  return noydb.onWriteConflict(handler)\n}\n","import type { InspectorMeter } from './types.js'\nimport type { MeterSnapshot } from '@noy-db/to-meter'\n\nexport function meterSnapshot(meter: InspectorMeter | undefined): MeterSnapshot | null {\n  return meter ? meter.snapshot() : null\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGA,eAAsB,WAAW,OAA0D;AACzF,SAAO,MAAM,qBAAqB;AACpC;AAEA,eAAsB,SAAS,OAA0C;AAEvE,QAAM,OAAO,MAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;AAIvD,QAAM,cAAqC,OAAO,QAAQ,KAAK,WAAW,EAAE,IAAI,CAAC,CAAC,MAAM,IAAI,OAAO;AAAA,IACjG;AAAA,IACA,QAAQ,KAAK;AAAA,IACb,SAAS,KAAK;AAAA,IACd,MAAM,KAAK;AAAA,IACX,GAAI,KAAK,UAAU,SAAY,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;AAAA,EAC1D,EAAE;AACF,SAAO,EAAE,OAAO,KAAK,OAAO,YAAY;AAC1C;;;AClBA,IAAM,gBAAgB;AACtB,IAAM,YAAY;AAElB,SAAS,WAAW,GAA+B;AACjD,MAAI,MAAM,UAAa,OAAO,MAAM,CAAC,EAAG,QAAO;AAC/C,SAAO,KAAK,IAAI,GAAG,KAAK,IAAI,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC;AACvD;AAEA,SAAS,YAAY,GAA+B;AAClD,MAAI,MAAM,UAAa,OAAO,MAAM,CAAC,KAAK,IAAI,EAAG,QAAO;AACxD,SAAO,KAAK,MAAM,CAAC;AACrB;AAEA,eAAsB,QACpB,OACA,YACA,OAA4C,CAAC,GACxB;AACrB,QAAM,QAAQ,WAAW,KAAK,KAAK;AACnC,QAAM,SAAS,YAAY,KAAK,MAAM;AAGtC,QAAM,MAAM,MAAM,MAAM,WAAW,UAAU,EAAE,KAAK;AACpD,SAAO;AAAA,IACL,MAAM,IAAI,MAAM,QAAQ,SAAS,KAAK;AAAA,IACtC,OAAO,IAAI;AAAA,IACX;AAAA,IACA;AAAA,EACF;AACF;;;AC9BO,SAAS,UACd,OACA,SACY;AACZ,SAAO,MAAM,aAAa,OAAO;AACnC;AAEO,SAAS,cAAc,OAAsC;AAClE,QAAM,IAAI,MAAM;AAChB,SAAO,EAAE,SAAS,EAAE,SAAS,OAAO,EAAE,MAAM;AAC9C;AAEO,SAAS,mBAAmB,OAAuB,SAA0D;AAClH,SAAO,MAAM,gBAAgB,OAAO;AACtC;;;ACbO,SAAS,cAAc,OAAyD;AACrF,SAAO,QAAQ,MAAM,SAAS,IAAI;AACpC;;;AJEO,SAAS,gBAAgB,OAAuB,MAA8C;AACnG,SAAO;AAAA,IACL,YAAY,MAAM,WAAW,KAAK;AAAA,IAClC,UAAU,CAAC,UAAiB,SAAS,KAAK;AAAA,IAC1C,SAAS,CAAC,OAAO,YAAYA,UAAS,QAAQ,OAAO,YAAYA,KAAI;AAAA,IACrE,WAAW,CAAC,YAAY,UAAU,OAAO,OAAO;AAAA,IAChD,oBAAoB,CAAC,YAAY,mBAAmB,OAAO,OAAO;AAAA,IAClE,eAAe,MAAM,cAAc,KAAK;AAAA,IACxC,eAAe,MAAM,cAAc,MAAM,KAAK;AAAA,EAChD;AACF;","names":["opts"]}

package/dist/index.d.cts

@@ -1,64 +0,0 @@
-import { AccessibleVault, Vault, CollectionDescriptor, CollectionStats, WriteEvent, WriteConflict, Noydb } from '@noy-db/hub';
-import { MeterSnapshot } from '@noy-db/to-meter';
-
-/** Minimal structural view of a to-meter handle the inspector reads (no runtime dep). */
-interface InspectorMeter {
-    snapshot(): MeterSnapshot;
-}
-/** Top-level accessible-vault entry (plain projection of the hub's AccessibleVault). */
-type VaultInfo = AccessibleVault;
-/**
- * One collection in a snapshot — a flattened projection of the hub's
- * CollectionDescriptor. Field/index/ref/stats shapes are derived directly from
- * the hub types so they never drift.
- */
-interface InspectorCollection {
-    readonly name: string;
-    readonly fields: CollectionDescriptor['fields'];
-    readonly indexes: CollectionDescriptor['indexes'];
-    readonly refs: CollectionDescriptor['refs'];
-    readonly stats?: CollectionStats;
-}
-/** Structure + stats for one open vault. */
-interface InspectorSnapshot {
-    readonly vault: string;
-    readonly collections: ReadonlyArray<InspectorCollection>;
-}
-/** A page of decrypted records from one collection. */
-interface RecordPage {
-    readonly rows: ReadonlyArray<unknown>;
-    readonly total: number;
-    readonly limit: number;
-    readonly offset: number;
-}
-/** Live write event surfaced to subscribers (the hub's public WriteEvent, unchanged — already plain). */
-type InspectorWriteEvent = WriteEvent;
-/** Write-conflict surfaced to conflict subscribers (the hub's public WriteConflict, unchanged — already plain). */
-type InspectorWriteConflict = WriteConflict;
-/** Pending-write state. */
-interface PendingWrites {
-    readonly pending: boolean;
-    readonly depth: number;
-}
-/** The read-only inspector facade returned by createInspector(). */
-interface Inspector {
-    listVaults(): Promise<ReadonlyArray<VaultInfo>>;
-    snapshot(vault: Vault): Promise<InspectorSnapshot>;
-    records(vault: Vault, collection: string, opts?: {
-        limit?: number;
-        offset?: number;
-    }): Promise<RecordPage>;
-    subscribe(handler: (event: InspectorWriteEvent) => void): () => void;
-    subscribeConflicts(handler: (c: InspectorWriteConflict) => void): () => void;
-    pendingWrites(): PendingWrites;
-    /** Aggregate store-op latency snapshot, or null when the store is not metered. */
-    meterSnapshot(): MeterSnapshot | null;
-}
-/** @internal — the hub handle the inspector reads from. */
-type InspectorNoydb = Noydb;
-
-declare function createInspector(noydb: InspectorNoydb, opts?: {
-    meter?: InspectorMeter;
-}): Inspector;
-
-export { type Inspector, type InspectorCollection, type InspectorMeter, type InspectorSnapshot, type InspectorWriteConflict, type InspectorWriteEvent, type PendingWrites, type RecordPage, type VaultInfo, createInspector };