@noy-db/file 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vLannaAi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# @noy-db/file
+
+> JSON file adapter for [noy-db](https://github.com/vLannaAi/noy-db) — encrypted document store on local disk, USB sticks, or network drives.
+
+[![npm](https://img.shields.io/npm/v/@noy-db/file.svg)](https://www.npmjs.com/package/@noy-db/file)
+
+## Install
+
+```bash
+pnpm add @noy-db/core @noy-db/file
+```
+
+## Usage
+
+```ts
+import { createNoydb } from '@noy-db/core'
+import { file } from '@noy-db/file'
+
+const db = await createNoydb({
+  adapter: file({ dir: '/Volumes/USB/firm-data' }),
+  userId: 'alice',
+  passphrase: process.env.NOYDB_PASSPHRASE!,
+})
+```
+
+Each compartment is written as a set of JSON files containing only ciphertext envelopes — the adapter never sees plaintext. Perfect for:
+
+- USB-stick workflows (air-gapped data portability)
+- Local-first desktop apps
+- Network drive sharing with per-user passphrases
+- Backup-friendly storage
+
+## License
+
+MIT © vLannaAi — see the [noy-db repo](https://github.com/vLannaAi/noy-db) for full documentation.

package/dist/index.cjs

@@ -0,0 +1,199 @@
+"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, {
+  jsonFile: () => jsonFile
+});
+module.exports = __toCommonJS(index_exports);
+var import_promises = require("fs/promises");
+var import_node_path = require("path");
+var import_core = require("@noy-db/core");
+function jsonFile(options) {
+  const { dir, pretty = true } = options;
+  function recordPath(compartment, collection, id) {
+    return (0, import_node_path.join)(dir, compartment, collection, `${id}.json`);
+  }
+  function collectionDir(compartment, collection) {
+    return (0, import_node_path.join)(dir, compartment, collection);
+  }
+  async function ensureDir(path) {
+    await (0, import_promises.mkdir)(path, { recursive: true });
+  }
+  async function fileExists(path) {
+    try {
+      await (0, import_promises.stat)(path);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  function serialize(envelope) {
+    return pretty ? JSON.stringify(envelope, null, 2) : JSON.stringify(envelope);
+  }
+  return {
+    name: "file",
+    async get(compartment, collection, id) {
+      const path = recordPath(compartment, collection, id);
+      try {
+        const content = await (0, import_promises.readFile)(path, "utf-8");
+        return JSON.parse(content);
+      } catch {
+        return null;
+      }
+    },
+    async put(compartment, collection, id, envelope, expectedVersion) {
+      const path = recordPath(compartment, collection, id);
+      if (expectedVersion !== void 0 && await fileExists(path)) {
+        const existing = JSON.parse(await (0, import_promises.readFile)(path, "utf-8"));
+        if (existing._v !== expectedVersion) {
+          throw new import_core.ConflictError(existing._v, `Version conflict: expected ${expectedVersion}, found ${existing._v}`);
+        }
+      }
+      await ensureDir(collectionDir(compartment, collection));
+      await (0, import_promises.writeFile)(path, serialize(envelope), "utf-8");
+    },
+    async delete(compartment, collection, id) {
+      const path = recordPath(compartment, collection, id);
+      try {
+        await (0, import_promises.unlink)(path);
+      } catch {
+      }
+    },
+    async list(compartment, collection) {
+      const dirPath = collectionDir(compartment, collection);
+      try {
+        const entries = await (0, import_promises.readdir)(dirPath);
+        return entries.filter((f) => f.endsWith(".json")).map((f) => f.slice(0, -5));
+      } catch {
+        return [];
+      }
+    },
+    async loadAll(compartment) {
+      const compDir = (0, import_node_path.join)(dir, compartment);
+      const snapshot = {};
+      try {
+        const collections = await (0, import_promises.readdir)(compDir);
+        for (const collName of collections) {
+          if (collName.startsWith("_")) continue;
+          const collPath = (0, import_node_path.join)(compDir, collName);
+          const collStat = await (0, import_promises.stat)(collPath);
+          if (!collStat.isDirectory()) continue;
+          const records = {};
+          const files = await (0, import_promises.readdir)(collPath);
+          for (const file of files) {
+            if (!file.endsWith(".json")) continue;
+            const id = file.slice(0, -5);
+            const content = await (0, import_promises.readFile)((0, import_node_path.join)(collPath, file), "utf-8");
+            records[id] = JSON.parse(content);
+          }
+          snapshot[collName] = records;
+        }
+      } catch {
+      }
+      return snapshot;
+    },
+    async saveAll(compartment, data) {
+      for (const [collName, records] of Object.entries(data)) {
+        const collDir = collectionDir(compartment, collName);
+        await ensureDir(collDir);
+        for (const [id, envelope] of Object.entries(records)) {
+          await (0, import_promises.writeFile)((0, import_node_path.join)(collDir, `${id}.json`), serialize(envelope), "utf-8");
+        }
+      }
+    },
+    async ping() {
+      try {
+        await (0, import_promises.stat)(dir);
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    /**
+     * Enumerate every top-level compartment subdirectory under the
+     * configured base directory. Used by
+     * `Noydb.listAccessibleCompartments()` (v0.5 #63).
+     *
+     * The implementation is `readdir(dir)` filtered to entries that
+     * are themselves directories — files at the top level (READMEs,
+     * .DS_Store, etc.) are skipped, and missing base directory
+     * returns an empty array rather than throwing. Result order is
+     * filesystem-defined; consumers that want stable order should
+     * sort themselves.
+     */
+    async listCompartments() {
+      let entries;
+      try {
+        entries = await (0, import_promises.readdir)(dir);
+      } catch {
+        return [];
+      }
+      const compartments = [];
+      for (const entry of entries) {
+        try {
+          const entryStat = await (0, import_promises.stat)((0, import_node_path.join)(dir, entry));
+          if (entryStat.isDirectory()) compartments.push(entry);
+        } catch {
+        }
+      }
+      return compartments;
+    },
+    /**
+     * Paginate over a collection. Cursor is a numeric offset (as a string)
+     * into the sorted filename list. Files are sorted alphabetically so
+     * pages are stable across runs and across processes that share the
+     * same data directory.
+     *
+     * The default `limit` is 100. Each item carries its decoded envelope
+     * so callers don't need an extra `get()` round-trip per id.
+     */
+    async listPage(compartment, collection, cursor, limit = 100) {
+      const dirPath = collectionDir(compartment, collection);
+      let files;
+      try {
+        files = await (0, import_promises.readdir)(dirPath);
+      } catch {
+        return { items: [], nextCursor: null };
+      }
+      const ids = files.filter((f) => f.endsWith(".json")).map((f) => f.slice(0, -5)).sort();
+      const start = cursor ? parseInt(cursor, 10) : 0;
+      const end = Math.min(start + limit, ids.length);
+      const items = [];
+      for (let i = start; i < end; i++) {
+        const id = ids[i];
+        try {
+          const content = await (0, import_promises.readFile)((0, import_node_path.join)(dirPath, `${id}.json`), "utf-8");
+          items.push({ id, envelope: JSON.parse(content) });
+        } catch {
+        }
+      }
+      return {
+        items,
+        nextCursor: end < ids.length ? String(end) : null
+      };
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  jsonFile
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { readFile, writeFile, mkdir, readdir, unlink, stat } from 'node:fs/promises'\nimport { join } from 'node:path'\nimport type { NoydbAdapter, EncryptedEnvelope, CompartmentSnapshot } from '@noy-db/core'\nimport { ConflictError } from '@noy-db/core'\n\nexport interface JsonFileOptions {\n  /** Base directory for NOYDB data. */\n  dir: string\n  /** Pretty-print JSON files. Default: true. */\n  pretty?: boolean\n}\n\n/**\n * Create a JSON file adapter.\n * Maps the NOYDB hierarchy to the filesystem:\n *\n * ```\n * {dir}/{compartment}/{collection}/{id}.json\n * {dir}/{compartment}/_keyring/{userId}.json\n * ```\n */\nexport function jsonFile(options: JsonFileOptions): NoydbAdapter {\n  const { dir, pretty = true } = options\n\n  function recordPath(compartment: string, collection: string, id: string): string {\n    return join(dir, compartment, collection, `${id}.json`)\n  }\n\n  function collectionDir(compartment: string, collection: string): string {\n    return join(dir, compartment, collection)\n  }\n\n  async function ensureDir(path: string): Promise<void> {\n    await mkdir(path, { recursive: true })\n  }\n\n  async function fileExists(path: string): Promise<boolean> {\n    try {\n      await stat(path)\n      return true\n    } catch {\n      return false\n    }\n  }\n\n  function serialize(envelope: EncryptedEnvelope): string {\n    return pretty ? JSON.stringify(envelope, null, 2) : JSON.stringify(envelope)\n  }\n\n  return {\n    name: 'file',\n\n    async get(compartment, collection, id) {\n      const path = recordPath(compartment, collection, id)\n      try {\n        const content = await readFile(path, 'utf-8')\n        return JSON.parse(content) as EncryptedEnvelope\n      } catch {\n        return null\n      }\n    },\n\n    async put(compartment, collection, id, envelope, expectedVersion) {\n      const path = recordPath(compartment, collection, id)\n\n      if (expectedVersion !== undefined && await fileExists(path)) {\n        const existing = JSON.parse(await readFile(path, 'utf-8')) as EncryptedEnvelope\n        if (existing._v !== expectedVersion) {\n          throw new ConflictError(existing._v, `Version conflict: expected ${expectedVersion}, found ${existing._v}`)\n        }\n      }\n\n      await ensureDir(collectionDir(compartment, collection))\n      await writeFile(path, serialize(envelope), 'utf-8')\n    },\n\n    async delete(compartment, collection, id) {\n      const path = recordPath(compartment, collection, id)\n      try {\n        await unlink(path)\n      } catch {\n        // File doesn't exist — that's fine\n      }\n    },\n\n    async list(compartment, collection) {\n      const dirPath = collectionDir(compartment, collection)\n      try {\n        const entries = await readdir(dirPath)\n        return entries\n          .filter(f => f.endsWith('.json'))\n          .map(f => f.slice(0, -5)) // remove .json extension\n      } catch {\n        return []\n      }\n    },\n\n    async loadAll(compartment) {\n      const compDir = join(dir, compartment)\n      const snapshot: CompartmentSnapshot = {}\n\n      try {\n        const collections = await readdir(compDir)\n        for (const collName of collections) {\n          if (collName.startsWith('_')) continue // skip _keyring, _sync\n          const collPath = join(compDir, collName)\n          const collStat = await stat(collPath)\n          if (!collStat.isDirectory()) continue\n\n          const records: Record<string, EncryptedEnvelope> = {}\n          const files = await readdir(collPath)\n          for (const file of files) {\n            if (!file.endsWith('.json')) continue\n            const id = file.slice(0, -5)\n            const content = await readFile(join(collPath, file), 'utf-8')\n            records[id] = JSON.parse(content) as EncryptedEnvelope\n          }\n          snapshot[collName] = records\n        }\n      } catch {\n        // Directory doesn't exist — return empty snapshot\n      }\n\n      return snapshot\n    },\n\n    async saveAll(compartment, data) {\n      for (const [collName, records] of Object.entries(data)) {\n        const collDir = collectionDir(compartment, collName)\n        await ensureDir(collDir)\n        for (const [id, envelope] of Object.entries(records)) {\n          await writeFile(join(collDir, `${id}.json`), serialize(envelope), 'utf-8')\n        }\n      }\n    },\n\n    async ping() {\n      try {\n        await stat(dir)\n        return true\n      } catch {\n        return false\n      }\n    },\n\n    /**\n     * Enumerate every top-level compartment subdirectory under the\n     * configured base directory. Used by\n     * `Noydb.listAccessibleCompartments()` (v0.5 #63).\n     *\n     * The implementation is `readdir(dir)` filtered to entries that\n     * are themselves directories — files at the top level (READMEs,\n     * .DS_Store, etc.) are skipped, and missing base directory\n     * returns an empty array rather than throwing. Result order is\n     * filesystem-defined; consumers that want stable order should\n     * sort themselves.\n     */\n    async listCompartments() {\n      let entries: string[]\n      try {\n        entries = await readdir(dir)\n      } catch {\n        return []\n      }\n      const compartments: string[] = []\n      for (const entry of entries) {\n        try {\n          const entryStat = await stat(join(dir, entry))\n          if (entryStat.isDirectory()) compartments.push(entry)\n        } catch {\n          // Entry vanished between readdir and stat — skip silently.\n        }\n      }\n      return compartments\n    },\n\n    /**\n     * Paginate over a collection. Cursor is a numeric offset (as a string)\n     * into the sorted filename list. Files are sorted alphabetically so\n     * pages are stable across runs and across processes that share the\n     * same data directory.\n     *\n     * The default `limit` is 100. Each item carries its decoded envelope\n     * so callers don't need an extra `get()` round-trip per id.\n     */\n    async listPage(compartment, collection, cursor, limit = 100) {\n      const dirPath = collectionDir(compartment, collection)\n      let files: string[]\n      try {\n        files = await readdir(dirPath)\n      } catch {\n        return { items: [], nextCursor: null }\n      }\n\n      const ids = files\n        .filter(f => f.endsWith('.json'))\n        .map(f => f.slice(0, -5))\n        .sort()\n\n      const start = cursor ? parseInt(cursor, 10) : 0\n      const end = Math.min(start + limit, ids.length)\n\n      const items: Array<{ id: string; envelope: EncryptedEnvelope }> = []\n      for (let i = start; i < end; i++) {\n        const id = ids[i]!\n        try {\n          const content = await readFile(join(dirPath, `${id}.json`), 'utf-8')\n          items.push({ id, envelope: JSON.parse(content) as EncryptedEnvelope })\n        } catch {\n          // File disappeared between readdir and readFile — skip silently.\n        }\n      }\n\n      return {\n        items,\n        nextCursor: end < ids.length ? String(end) : null,\n      }\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,20 @@
+import { NoydbAdapter } from '@noy-db/core';
+
+interface JsonFileOptions {
+    /** Base directory for NOYDB data. */
+    dir: string;
+    /** Pretty-print JSON files. Default: true. */
+    pretty?: boolean;
+}
+/**
+ * Create a JSON file adapter.
+ * Maps the NOYDB hierarchy to the filesystem:
+ *
+ * ```
+ * {dir}/{compartment}/{collection}/{id}.json
+ * {dir}/{compartment}/_keyring/{userId}.json
+ * ```
+ */
+declare function jsonFile(options: JsonFileOptions): NoydbAdapter;
+
+export { type JsonFileOptions, jsonFile };

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import { NoydbAdapter } from '@noy-db/core';
+
+interface JsonFileOptions {
+    /** Base directory for NOYDB data. */
+    dir: string;
+    /** Pretty-print JSON files. Default: true. */
+    pretty?: boolean;
+}
+/**
+ * Create a JSON file adapter.
+ * Maps the NOYDB hierarchy to the filesystem:
+ *
+ * ```
+ * {dir}/{compartment}/{collection}/{id}.json
+ * {dir}/{compartment}/_keyring/{userId}.json
+ * ```
+ */
+declare function jsonFile(options: JsonFileOptions): NoydbAdapter;
+
+export { type JsonFileOptions, jsonFile };

package/dist/index.js

@@ -0,0 +1,174 @@
+// src/index.ts
+import { readFile, writeFile, mkdir, readdir, unlink, stat } from "fs/promises";
+import { join } from "path";
+import { ConflictError } from "@noy-db/core";
+function jsonFile(options) {
+  const { dir, pretty = true } = options;
+  function recordPath(compartment, collection, id) {
+    return join(dir, compartment, collection, `${id}.json`);
+  }
+  function collectionDir(compartment, collection) {
+    return join(dir, compartment, collection);
+  }
+  async function ensureDir(path) {
+    await mkdir(path, { recursive: true });
+  }
+  async function fileExists(path) {
+    try {
+      await stat(path);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  function serialize(envelope) {
+    return pretty ? JSON.stringify(envelope, null, 2) : JSON.stringify(envelope);
+  }
+  return {
+    name: "file",
+    async get(compartment, collection, id) {
+      const path = recordPath(compartment, collection, id);
+      try {
+        const content = await readFile(path, "utf-8");
+        return JSON.parse(content);
+      } catch {
+        return null;
+      }
+    },
+    async put(compartment, collection, id, envelope, expectedVersion) {
+      const path = recordPath(compartment, collection, id);
+      if (expectedVersion !== void 0 && await fileExists(path)) {
+        const existing = JSON.parse(await readFile(path, "utf-8"));
+        if (existing._v !== expectedVersion) {
+          throw new ConflictError(existing._v, `Version conflict: expected ${expectedVersion}, found ${existing._v}`);
+        }
+      }
+      await ensureDir(collectionDir(compartment, collection));
+      await writeFile(path, serialize(envelope), "utf-8");
+    },
+    async delete(compartment, collection, id) {
+      const path = recordPath(compartment, collection, id);
+      try {
+        await unlink(path);
+      } catch {
+      }
+    },
+    async list(compartment, collection) {
+      const dirPath = collectionDir(compartment, collection);
+      try {
+        const entries = await readdir(dirPath);
+        return entries.filter((f) => f.endsWith(".json")).map((f) => f.slice(0, -5));
+      } catch {
+        return [];
+      }
+    },
+    async loadAll(compartment) {
+      const compDir = join(dir, compartment);
+      const snapshot = {};
+      try {
+        const collections = await readdir(compDir);
+        for (const collName of collections) {
+          if (collName.startsWith("_")) continue;
+          const collPath = join(compDir, collName);
+          const collStat = await stat(collPath);
+          if (!collStat.isDirectory()) continue;
+          const records = {};
+          const files = await readdir(collPath);
+          for (const file of files) {
+            if (!file.endsWith(".json")) continue;
+            const id = file.slice(0, -5);
+            const content = await readFile(join(collPath, file), "utf-8");
+            records[id] = JSON.parse(content);
+          }
+          snapshot[collName] = records;
+        }
+      } catch {
+      }
+      return snapshot;
+    },
+    async saveAll(compartment, data) {
+      for (const [collName, records] of Object.entries(data)) {
+        const collDir = collectionDir(compartment, collName);
+        await ensureDir(collDir);
+        for (const [id, envelope] of Object.entries(records)) {
+          await writeFile(join(collDir, `${id}.json`), serialize(envelope), "utf-8");
+        }
+      }
+    },
+    async ping() {
+      try {
+        await stat(dir);
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    /**
+     * Enumerate every top-level compartment subdirectory under the
+     * configured base directory. Used by
+     * `Noydb.listAccessibleCompartments()` (v0.5 #63).
+     *
+     * The implementation is `readdir(dir)` filtered to entries that
+     * are themselves directories — files at the top level (READMEs,
+     * .DS_Store, etc.) are skipped, and missing base directory
+     * returns an empty array rather than throwing. Result order is
+     * filesystem-defined; consumers that want stable order should
+     * sort themselves.
+     */
+    async listCompartments() {
+      let entries;
+      try {
+        entries = await readdir(dir);
+      } catch {
+        return [];
+      }
+      const compartments = [];
+      for (const entry of entries) {
+        try {
+          const entryStat = await stat(join(dir, entry));
+          if (entryStat.isDirectory()) compartments.push(entry);
+        } catch {
+        }
+      }
+      return compartments;
+    },
+    /**
+     * Paginate over a collection. Cursor is a numeric offset (as a string)
+     * into the sorted filename list. Files are sorted alphabetically so
+     * pages are stable across runs and across processes that share the
+     * same data directory.
+     *
+     * The default `limit` is 100. Each item carries its decoded envelope
+     * so callers don't need an extra `get()` round-trip per id.
+     */
+    async listPage(compartment, collection, cursor, limit = 100) {
+      const dirPath = collectionDir(compartment, collection);
+      let files;
+      try {
+        files = await readdir(dirPath);
+      } catch {
+        return { items: [], nextCursor: null };
+      }
+      const ids = files.filter((f) => f.endsWith(".json")).map((f) => f.slice(0, -5)).sort();
+      const start = cursor ? parseInt(cursor, 10) : 0;
+      const end = Math.min(start + limit, ids.length);
+      const items = [];
+      for (let i = start; i < end; i++) {
+        const id = ids[i];
+        try {
+          const content = await readFile(join(dirPath, `${id}.json`), "utf-8");
+          items.push({ id, envelope: JSON.parse(content) });
+        } catch {
+        }
+      }
+      return {
+        items,
+        nextCursor: end < ids.length ? String(end) : null
+      };
+    }
+  };
+}
+export {
+  jsonFile
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { readFile, writeFile, mkdir, readdir, unlink, stat } from 'node:fs/promises'\nimport { join } from 'node:path'\nimport type { NoydbAdapter, EncryptedEnvelope, CompartmentSnapshot } from '@noy-db/core'\nimport { ConflictError } from '@noy-db/core'\n\nexport interface JsonFileOptions {\n  /** Base directory for NOYDB data. */\n  dir: string\n  /** Pretty-print JSON files. Default: true. */\n  pretty?: boolean\n}\n\n/**\n * Create a JSON file adapter.\n * Maps the NOYDB hierarchy to the filesystem:\n *\n * ```\n * {dir}/{compartment}/{collection}/{id}.json\n * {dir}/{compartment}/_keyring/{userId}.json\n * ```\n */\nexport function jsonFile(options: JsonFileOptions): NoydbAdapter {\n  const { dir, pretty = true } = options\n\n  function recordPath(compartment: string, collection: string, id: string): string {\n    return join(dir, compartment, collection, `${id}.json`)\n  }\n\n  function collectionDir(compartment: string, collection: string): string {\n    return join(dir, compartment, collection)\n  }\n\n  async function ensureDir(path: string): Promise<void> {\n    await mkdir(path, { recursive: true })\n  }\n\n  async function fileExists(path: string): Promise<boolean> {\n    try {\n      await stat(path)\n      return true\n    } catch {\n      return false\n    }\n  }\n\n  function serialize(envelope: EncryptedEnvelope): string {\n    return pretty ? JSON.stringify(envelope, null, 2) : JSON.stringify(envelope)\n  }\n\n  return {\n    name: 'file',\n\n    async get(compartment, collection, id) {\n      const path = recordPath(compartment, collection, id)\n      try {\n        const content = await readFile(path, 'utf-8')\n        return JSON.parse(content) as EncryptedEnvelope\n      } catch {\n        return null\n      }\n    },\n\n    async put(compartment, collection, id, envelope, expectedVersion) {\n      const path = recordPath(compartment, collection, id)\n\n      if (expectedVersion !== undefined && await fileExists(path)) {\n        const existing = JSON.parse(await readFile(path, 'utf-8')) as EncryptedEnvelope\n        if (existing._v !== expectedVersion) {\n          throw new ConflictError(existing._v, `Version conflict: expected ${expectedVersion}, found ${existing._v}`)\n        }\n      }\n\n      await ensureDir(collectionDir(compartment, collection))\n      await writeFile(path, serialize(envelope), 'utf-8')\n    },\n\n    async delete(compartment, collection, id) {\n      const path = recordPath(compartment, collection, id)\n      try {\n        await unlink(path)\n      } catch {\n        // File doesn't exist — that's fine\n      }\n    },\n\n    async list(compartment, collection) {\n      const dirPath = collectionDir(compartment, collection)\n      try {\n        const entries = await readdir(dirPath)\n        return entries\n          .filter(f => f.endsWith('.json'))\n          .map(f => f.slice(0, -5)) // remove .json extension\n      } catch {\n        return []\n      }\n    },\n\n    async loadAll(compartment) {\n      const compDir = join(dir, compartment)\n      const snapshot: CompartmentSnapshot = {}\n\n      try {\n        const collections = await readdir(compDir)\n        for (const collName of collections) {\n          if (collName.startsWith('_')) continue // skip _keyring, _sync\n          const collPath = join(compDir, collName)\n          const collStat = await stat(collPath)\n          if (!collStat.isDirectory()) continue\n\n          const records: Record<string, EncryptedEnvelope> = {}\n          const files = await readdir(collPath)\n          for (const file of files) {\n            if (!file.endsWith('.json')) continue\n            const id = file.slice(0, -5)\n            const content = await readFile(join(collPath, file), 'utf-8')\n            records[id] = JSON.parse(content) as EncryptedEnvelope\n          }\n          snapshot[collName] = records\n        }\n      } catch {\n        // Directory doesn't exist — return empty snapshot\n      }\n\n      return snapshot\n    },\n\n    async saveAll(compartment, data) {\n      for (const [collName, records] of Object.entries(data)) {\n        const collDir = collectionDir(compartment, collName)\n        await ensureDir(collDir)\n        for (const [id, envelope] of Object.entries(records)) {\n          await writeFile(join(collDir, `${id}.json`), serialize(envelope), 'utf-8')\n        }\n      }\n    },\n\n    async ping() {\n      try {\n        await stat(dir)\n        return true\n      } catch {\n        return false\n      }\n    },\n\n    /**\n     * Enumerate every top-level compartment subdirectory under the\n     * configured base directory. Used by\n     * `Noydb.listAccessibleCompartments()` (v0.5 #63).\n     *\n     * The implementation is `readdir(dir)` filtered to entries that\n     * are themselves directories — files at the top level (READMEs,\n     * .DS_Store, etc.) are skipped, and missing base directory\n     * returns an empty array rather than throwing. Result order is\n     * filesystem-defined; consumers that want stable order should\n     * sort themselves.\n     */\n    async listCompartments() {\n      let entries: string[]\n      try {\n        entries = await readdir(dir)\n      } catch {\n        return []\n      }\n      const compartments: string[] = []\n      for (const entry of entries) {\n        try {\n          const entryStat = await stat(join(dir, entry))\n          if (entryStat.isDirectory()) compartments.push(entry)\n        } catch {\n          // Entry vanished between readdir and stat — skip silently.\n        }\n      }\n      return compartments\n    },\n\n    /**\n     * Paginate over a collection. Cursor is a numeric offset (as a string)\n     * into the sorted filename list. Files are sorted alphabetically so\n     * pages are stable across runs and across processes that share the\n     * same data directory.\n     *\n     * The default `limit` is 100. Each item carries its decoded envelope\n     * so callers don't need an extra `get()` round-trip per id.\n     */\n    async listPage(compartment, collection, cursor, limit = 100) {\n      const dirPath = collectionDir(compartment, collection)\n      let files: string[]\n      try {\n        files = await readdir(dirPath)\n      } catch {\n        return { items: [], nextCursor: null }\n      }\n\n      const ids = files\n        .filter(f => f.endsWith('.json'))\n        .map(f => f.slice(0, -5))\n        .sort()\n\n      const start = cursor ? parseInt(cursor, 10) : 0\n      const end = Math.min(start + limit, ids.length)\n\n      const items: Array<{ id: string; envelope: EncryptedEnvelope }> = []\n      for (let i = start; i < end; i++) {\n        const id = ids[i]!\n        try {\n          const content = await readFile(join(dirPath, `${id}.json`), 'utf-8')\n          items.push({ id, envelope: JSON.parse(content) as EncryptedEnvelope })\n        } catch {\n          // File disappeared between readdir and readFile — skip silently.\n        }\n      }\n\n      return {\n        items,\n        nextCursor: end < ids.length ? String(end) : null,\n      }\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@noy-db/file",
+  "version": "0.5.0",
+  "description": "JSON file adapter for noy-db — encrypted document store on local disk, USB sticks, or network drives",
+  "license": "MIT",
+  "author": "vLannaAi <vicio@lanna.ai>",
+  "homepage": "https://github.com/vLannaAi/noy-db/tree/main/packages/file#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vLannaAi/noy-db.git",
+    "directory": "packages/file"
+  },
+  "bugs": {
+    "url": "https://github.com/vLannaAi/noy-db/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "@noy-db/core": "^0.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@noy-db/test-adapter-conformance": "0.0.0",
+    "@noy-db/core": "0.5.0"
+  },
+  "keywords": [
+    "noy-db",
+    "adapter",
+    "file",
+    "json",
+    "filesystem",
+    "local-disk",
+    "usb",
+    "storage",
+    "encryption",
+    "offline-first"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit"
+  }
+}