@forthtilliath/expo-test-kit 0.4.0 → 0.5.0

package/README.md

@@ -5,7 +5,9 @@ Test helpers for Expo/Drizzle apps: a real in-memory SQLite database (via libsql
 ## Install
 
 ```bash
-npm install --save-dev @forthtilliath/expo-test-kit drizzle-orm @libsql/client
+npm install --save-dev @forthtilliath/expo-test-kit
+# only for the sqlite/ helpers:
+npm install --save-dev drizzle-orm @libsql/client
 ```
 
 Or, from within this monorepo, as a workspace dependency:
@@ -18,7 +20,7 @@ Or, from within this monorepo, as a workspace dependency:
 }
 ```
 
-`drizzle-orm` and `@libsql/client` are peer dependencies — install them if not already present. Both are dev-only: `expo-test-kit` doesn't touch your app's production `expo-sqlite` driver, it's a separate in-memory database used only while testing.
+`drizzle-orm` and `@libsql/client` are **optional** peer dependencies: only the `sqlite/` modules need them, so an app that only takes `router/createRenderApp` or the file-system fake doesn't install them. Both are dev-only: `expo-test-kit` doesn't touch your app's production `expo-sqlite` driver, it's a separate in-memory database used only while testing.
 
 ## Usage
 
@@ -77,7 +79,7 @@ beforeAll(async () => {
 
 ### `createFakeExpoFileSystem()` / `getFakeExpoFileSystem()`
 
-A minimal in-memory `File`/`Paths` fake — enough to test code that reads/writes files via `expo-file-system`, without the native filesystem (unavailable under Jest/Vitest).
+A minimal in-memory `File`/`Directory`/`Paths` fake — enough to test code that reads/writes files via `expo-file-system`, without the native filesystem (unavailable under Jest/Vitest).
 
 ```ts
 import {
@@ -96,6 +98,10 @@ beforeAll(() => {
 });
 ```
 
+- `File`: `exists`, `create()`, `write(content)`, `delete()`, `text()`, `textSync()`; `Directory`: `exists` (created, a `Paths` root, or holding a file), `create()`, `delete()` (with its files). `store` maps each URI to its content.
+- `fakeFs.failWrites = true` simulates a full disk: `create()`/`write()` throw `"Fake disk full"` and change nothing. `fakeFs.reset()` (e.g. in `beforeEach`) empties the store and turns it back off.
+- `Paths.document` / `Paths.cache` are `"document"` / `"cache"` by default; pass `{ documentUri: "file:///documents", cacheUri: "file:///cache" }` for code that checks the scheme. Parts are joined with a single `/`, as expo-file-system does.
+
 ### `createRenderApp(deps, options?)`
 
 Builds a `renderApp(initialUrl)` that renders the whole app — the real screens of `app/`, the real Expo Router navigation — from a URL, and returns `{ getPathname, getSearchParams, navigate }`. It settles the two traps of `renderRouter` under Testing Library v14: fake timers are advanced _before_ awaiting the render (`renderRouter` turns them on, and the first async render never ends otherwise), and a plain object is returned rather than the enriched promise. `navigate` runs inside `act` and waits for the render.

package/dist/file-system/createFakeExpoFileSystem.d.ts

@@ -1,3 +1,6 @@
+type PathPart = string | {
+    uri: string;
+};
 export interface FakeFile {
     uri: string;
     exists: boolean;
@@ -5,21 +8,42 @@ export interface FakeFile {
     write: (content: string) => void;
     delete: () => void;
     text: () => Promise<string>;
+    textSync: () => string;
+}
+export interface FakeDirectory {
+    uri: string;
+    /** Created, one of the `Paths` roots, or holding a file. */
+    exists: boolean;
+    create: () => void;
+    /** Removes the directory and everything under it. */
+    delete: () => void;
 }
 export interface FakeExpoFileSystem {
     store: Map<string, string>;
-    File: new (...parts: (string | {
-        uri: string;
-    })[]) => FakeFile;
+    File: new (...parts: PathPart[]) => FakeFile;
+    Directory: new (...parts: PathPart[]) => FakeDirectory;
     Paths: {
-        cache: {
-            uri: string;
-        };
-        document: {
-            uri: string;
-        };
+        cache: FakeDirectory;
+        document: FakeDirectory;
     };
+    /**
+     * Set to `true` to simulate a full disk: `File#create`/`write` then throw
+     * ("Fake disk full") and leave the store untouched.
+     */
+    failWrites: boolean;
+    /** Empties the store, forgets created directories, resets `failWrites`. */
+    reset: () => void;
+}
+export interface FakeExpoFileSystemOptions {
+    /**
+     * URI of `Paths.document`, e.g. `"file:///documents"` for code that checks
+     * the scheme. @defaultValue "document"
+     */
+    documentUri?: string;
+    /** URI of `Paths.cache`. @defaultValue "cache" */
+    cacheUri?: string;
 }
-export declare function createFakeExpoFileSystem(): FakeExpoFileSystem;
+export declare function createFakeExpoFileSystem({ documentUri, cacheUri, }?: FakeExpoFileSystemOptions): FakeExpoFileSystem;
 export declare function getFakeExpoFileSystem(): FakeExpoFileSystem;
+export {};
 //# sourceMappingURL=createFakeExpoFileSystem.d.ts.map

package/dist/file-system/createFakeExpoFileSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createFakeExpoFileSystem.d.ts","sourceRoot":"","sources":["../../src/file-system/createFakeExpoFileSystem.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,IAAI,EAAE,KAAK,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,KAAK,QAAQ,CAAC;IAC/D,KAAK,EAAE;QAAE,KAAK,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,QAAQ,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CAC9D;AAWD,wBAAgB,wBAAwB,IAAI,kBAAkB,CAsC7D;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,CAS1D"}
+{"version":3,"file":"createFakeExpoFileSystem.d.ts","sourceRoot":"","sources":["../../src/file-system/createFakeExpoFileSystem.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5B,QAAQ,EAAE,MAAM,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,qDAAqD;IACrD,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,IAAI,EAAE,KAAK,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,QAAQ,CAAC;IAC7C,SAAS,EAAE,KAAK,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,aAAa,CAAC;IACvD,KAAK,EAAE;QAAE,KAAK,EAAE,aAAa,CAAC;QAAC,QAAQ,EAAE,aAAa,CAAA;KAAE,CAAC;IACzD;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAmBD,wBAAgB,wBAAwB,CAAC,EACvC,WAAwB,EACxB,QAAkB,GACnB,GAAE,yBAA8B,GAAG,kBAAkB,CAoFrD;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,CAS1D"}

package/dist/file-system/createFakeExpoFileSystem.js

@@ -1,44 +1,98 @@
 const GLOBAL_KEY = "__forthtilliathFakeExpoFileSystem";
+/** Joins like expo-file-system: one `/` between parts, none doubled. */
+function joinUri(parts) {
+    return parts
+        .map((part) => (typeof part === "string" ? part : part.uri))
+        .reduce((uri, part) => (uri.endsWith("/") ? uri + part : `${uri}/${part}`));
+}
 // Double léger d'expo-file-system : un simple magasin clé/valeur en mémoire,
 // suffisant pour tester du code lisant/écrivant des fichiers via `File`/
-// `Paths`, sans dépendre du système de fichiers natif (indisponible en
-// Jest/Vitest). Stashé sur `globalThis` plutôt que capturé par une closure,
-// car `jest.mock("expo-file-system", () => ...)` interdit de référencer une
-// variable hors-scope dans sa factory — `getFakeExpoFileSystem()` récupère
-// l'instance après coup, une fois le mock enregistré.
-export function createFakeExpoFileSystem() {
+// `Directory`/`Paths`, sans dépendre du système de fichiers natif
+// (indisponible en Jest/Vitest). Stashé sur `globalThis` plutôt que capturé
+// par une closure, car `jest.mock("expo-file-system", () => ...)` interdit de
+// référencer une variable hors-scope dans sa factory —
+// `getFakeExpoFileSystem()` récupère l'instance après coup, une fois le mock
+// enregistré.
+export function createFakeExpoFileSystem({ documentUri = "document", cacheUri = "cache", } = {}) {
     const store = new Map();
+    const directories = new Set();
+    const roots = new Set([documentUri, cacheUri]);
+    function assertWritable() {
+        if (fakeFs.failWrites)
+            throw new Error("Fake disk full");
+    }
     class File {
         uri;
         constructor(...parts) {
-            this.uri = parts
-                .map((p) => (typeof p === "string" ? p : p.uri))
-                .join("/");
+            this.uri = joinUri(parts);
         }
         get exists() {
             return store.has(this.uri);
         }
         create() {
+            assertWritable();
             store.set(this.uri, "");
         }
         write(content) {
+            assertWritable();
             store.set(this.uri, content);
         }
         delete() {
             store.delete(this.uri);
         }
         text() {
+            return Promise.resolve().then(() => this.textSync());
+        }
+        textSync() {
             const content = store.get(this.uri);
             if (content === undefined) {
-                return Promise.reject(new Error(`Fake file not found: ${this.uri}`));
+                throw new Error(`Fake file not found: ${this.uri}`);
+            }
+            return content;
+        }
+    }
+    class Directory {
+        uri;
+        constructor(...parts) {
+            this.uri = joinUri(parts);
+        }
+        get prefix() {
+            return this.uri.endsWith("/") ? this.uri : `${this.uri}/`;
+        }
+        get exists() {
+            if (roots.has(this.uri) || directories.has(this.uri))
+                return true;
+            return [...store.keys()].some((uri) => uri.startsWith(this.prefix));
+        }
+        create() {
+            directories.add(this.uri);
+        }
+        delete() {
+            for (const uri of [...store.keys()]) {
+                if (uri.startsWith(this.prefix))
+                    store.delete(uri);
+            }
+            for (const uri of [...directories]) {
+                if (uri === this.uri || uri.startsWith(this.prefix)) {
+                    directories.delete(uri);
+                }
             }
-            return Promise.resolve(content);
         }
     }
     const fakeFs = {
         store,
         File,
-        Paths: { cache: { uri: "cache" }, document: { uri: "document" } },
+        Directory,
+        Paths: {
+            cache: new Directory(cacheUri),
+            document: new Directory(documentUri),
+        },
+        failWrites: false,
+        reset() {
+            store.clear();
+            directories.clear();
+            fakeFs.failWrites = false;
+        },
     };
     globalThis[GLOBAL_KEY] = fakeFs;
     return fakeFs;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forthtilliath/expo-test-kit",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -23,15 +23,23 @@
     "@libsql/client": ">=0.14.0",
     "drizzle-orm": ">=0.44.0"
   },
+  "peerDependenciesMeta": {
+    "@libsql/client": {
+      "optional": true
+    },
+    "drizzle-orm": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@libsql/client": "^0.17.4",
     "@types/node": "^26.2.0",
     "drizzle-orm": "^0.45.2",
     "eslint": "10.7.0",
     "typescript": "^5.9.3",
-    "vitest": "^5.0.2",
-    "@forthtilliath/eslint-config": "0.9.0",
-    "@forthtilliath/typescript-config": "0.1.1"
+    "vitest": "^5.0.5",
+    "@forthtilliath/typescript-config": "0.1.1",
+    "@forthtilliath/eslint-config": "0.10.0"
   },
   "scripts": {
     "lint": "eslint . --max-warnings 0",