@emdzej/bimmerz-vfs 0.1.0

package/dist/http.e2e.test.js

@@ -0,0 +1,170 @@
+/**
+ * End-to-end tests — HttpDirectory against a real in-process HTTP server.
+ * The fixture is defined as a nested JS object; index.json files are
+ * generated automatically for every level, matching the format written
+ * by `bimmerz data index`.
+ */
+import { createServer } from 'node:http';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+import { HttpDirectory } from './http.js';
+import { drillPath, listFiles } from './utils.js';
+const MS43_IPO = new Uint8Array([0x49, 0x50, 0x4f, 0x01, 0x02]);
+const RADIO_IPO = new Uint8Array([0x52, 0x41, 0x44, 0x03]);
+const MS43_PRG = new Uint8Array([0x50, 0x52, 0x47, 0x04]);
+const INPA_INI = '[INPA]\nPath=C:\\EC-APPS\\INPA\n';
+const EDIABAS_INI = '[EDIABAS]\nInterface=STD:OBD\n';
+const FIXTURE = {
+    'INPA.INI': INPA_INI,
+    'EC-APPS': {
+        INPA: {
+            CFGDAT: {
+                'MS43.IPO': MS43_IPO,
+                'INPA.INI': INPA_INI,
+                'E46.ENG': 'E46\nMOTOR\n',
+            },
+            SGDAT: {
+                'RADIO.IPO': RADIO_IPO,
+            },
+        },
+    },
+    EDIABAS: {
+        Ecu: {
+            'MS43.prg': MS43_PRG,
+        },
+        Bin: {
+            'EDIABAS.INI': EDIABAS_INI,
+        },
+    },
+};
+function buildRoutes(tree, prefix = '') {
+    const routes = new Map();
+    const indexEntries = [];
+    for (const [name, value] of Object.entries(tree)) {
+        const path = prefix ? `${prefix}/${name}` : name;
+        if (value instanceof Uint8Array || typeof value === 'string') {
+            const buf = typeof value === 'string' ? Buffer.from(value, 'utf-8') : Buffer.from(value);
+            routes.set(path, buf);
+            const dotIdx = name.lastIndexOf('.');
+            const baseName = dotIdx > 0 ? name.slice(0, dotIdx) : name;
+            indexEntries.push({
+                type: 'file',
+                name: baseName.toLowerCase(),
+                fullName: name.toLowerCase(),
+                originalName: baseName,
+                originalFullName: name,
+                size: buf.length,
+            });
+        }
+        else {
+            for (const [sub, subBuf] of buildRoutes(value, path)) {
+                routes.set(sub, subBuf);
+            }
+            indexEntries.push({
+                type: 'dir',
+                name: name.toLowerCase(),
+                fullName: name.toLowerCase(),
+                originalName: name,
+                originalFullName: name,
+                size: 0,
+            });
+        }
+    }
+    const indexPath = prefix ? `${prefix}/index.json` : 'index.json';
+    routes.set(indexPath, Buffer.from(JSON.stringify(indexEntries, null, 2), 'utf-8'));
+    return routes;
+}
+// ---------------------------------------------------------------------------
+// HTTP server lifecycle
+// ---------------------------------------------------------------------------
+let server;
+let baseUrl;
+beforeAll(async () => {
+    const routes = buildRoutes(FIXTURE);
+    await new Promise((resolve) => {
+        server = createServer((req, res) => {
+            const rawPath = decodeURIComponent((req.url ?? '/').replace(/^\//, ''));
+            const buf = routes.get(rawPath);
+            if (!buf) {
+                res.writeHead(404, { 'Content-Type': 'text/plain' });
+                res.end('Not Found');
+                return;
+            }
+            res.writeHead(200, {
+                'Content-Type': rawPath.endsWith('.json') ? 'application/json' : 'application/octet-stream',
+                'Content-Length': buf.length,
+            });
+            res.end(buf);
+        });
+        server.listen(0, '127.0.0.1', () => {
+            const { port } = server.address();
+            baseUrl = `http://127.0.0.1:${port}`;
+            resolve();
+        });
+    });
+});
+afterAll(() => {
+    server?.close();
+});
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+function root() {
+    return new HttpDirectory(baseUrl);
+}
+describe('HttpDirectory E2E', () => {
+    it('reads root-level entries from index.json', async () => {
+        const entries = await root().entries();
+        const names = entries.map((e) => e.name).sort();
+        expect(names).toEqual(['EDIABAS', 'EC-APPS', 'INPA.INI'].sort());
+    });
+    it('navigates a multi-level path', async () => {
+        const cfgdat = await drillPath(root(), 'EC-APPS', 'INPA', 'CFGDAT');
+        expect(cfgdat?.name).toBe('CFGDAT');
+    });
+    it('is case-insensitive at every path segment', async () => {
+        const cfgdat = await drillPath(root(), 'ec-apps', 'inpa', 'cfgdat');
+        expect(cfgdat?.name).toBe('CFGDAT');
+    });
+    it('reads a text file', async () => {
+        const f = await root().file('INPA.INI');
+        expect(f).not.toBeNull();
+        const buf = await f.arrayBuffer();
+        const text = new TextDecoder().decode(buf);
+        expect(text).toBe(INPA_INI);
+    });
+    it('reads a binary file', async () => {
+        const ecu = await drillPath(root(), 'EDIABAS', 'Ecu');
+        const f = await ecu.file('MS43.prg');
+        expect(f).not.toBeNull();
+        const buf = await f.arrayBuffer();
+        expect(new Uint8Array(buf)).toEqual(MS43_PRG);
+    });
+    it('resolves a file case-insensitively', async () => {
+        const cfgdat = await drillPath(root(), 'EC-APPS', 'INPA', 'CFGDAT');
+        const f = await cfgdat.file('ms43.ipo');
+        expect(f?.name).toBe('MS43.IPO');
+        const buf = await f.arrayBuffer();
+        expect(new Uint8Array(buf)).toEqual(MS43_IPO);
+    });
+    it('returns null for a missing file', async () => {
+        expect(await root().file('ghost.ipo')).toBeNull();
+    });
+    it('returns null for a missing directory', async () => {
+        expect(await root().dir('missing')).toBeNull();
+    });
+    it('lists only IPO files in CFGDAT', async () => {
+        const cfgdat = await drillPath(root(), 'EC-APPS', 'INPA', 'CFGDAT');
+        const ipos = await listFiles(cfgdat, '.ipo');
+        expect(ipos.map((f) => f.name)).toEqual(['MS43.IPO']);
+    });
+    it('reports correct file sizes', async () => {
+        const cfgdat = await drillPath(root(), 'EC-APPS', 'INPA', 'CFGDAT');
+        const f = await cfgdat.file('MS43.IPO');
+        expect(f?.size).toBe(MS43_IPO.length);
+    });
+    it('index.json is not listed as an entry', async () => {
+        const entries = await root().entries();
+        expect(entries.find((e) => e.name === 'index.json')).toBeUndefined();
+    });
+});
+//# sourceMappingURL=http.e2e.test.js.map

package/dist/http.e2e.test.js.map

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

package/dist/http.js

@@ -0,0 +1,76 @@
+export class HttpFile {
+    name;
+    size;
+    #url;
+    #fetch;
+    constructor(name, size, url, fetchFn) {
+        this.name = name;
+        this.size = size;
+        this.#url = url;
+        this.#fetch = fetchFn;
+    }
+    async arrayBuffer() {
+        const res = await this.#fetch(this.#url);
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status} ${res.statusText}: ${this.#url}`);
+        return res.arrayBuffer();
+    }
+}
+export class HttpDirectory {
+    name;
+    #baseUrl;
+    #indexFile;
+    #fetch;
+    // Lazily populated on first access; one fetch per directory instance.
+    #index = null;
+    constructor(baseUrl, options = {}) {
+        // Normalise: no trailing slash so URL joins are predictable.
+        this.#baseUrl = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;
+        this.#indexFile = options.indexFile ?? 'index.json';
+        this.#fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+        // Use the last non-empty URL segment as the directory name.
+        this.name = this.#baseUrl.split('/').filter(Boolean).at(-1) ?? '';
+    }
+    async #loadIndex() {
+        if (this.#index !== null)
+            return this.#index;
+        const url = `${this.#baseUrl}/${this.#indexFile}`;
+        const res = await this.#fetch(url);
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status} ${res.statusText}: ${url}`);
+        this.#index = (await res.json());
+        return this.#index;
+    }
+    async file(name) {
+        const index = await this.#loadIndex();
+        const target = name.toLowerCase();
+        // Both 'file' and 'link' entries are readable resources.
+        const entry = index.find((e) => (e.type === 'file' || e.type === 'link') && e.fullName === target);
+        if (!entry)
+            return null;
+        const url = `${this.#baseUrl}/${entry.originalFullName}`;
+        return new HttpFile(entry.originalFullName, entry.size, url, this.#fetch);
+    }
+    async dir(name) {
+        const index = await this.#loadIndex();
+        const target = name.toLowerCase();
+        const entry = index.find((e) => e.type === 'dir' && e.fullName === target);
+        if (!entry)
+            return null;
+        return new HttpDirectory(`${this.#baseUrl}/${entry.originalFullName}`, { indexFile: this.#indexFile, fetch: this.#fetch });
+    }
+    async entries() {
+        const index = await this.#loadIndex();
+        const result = [];
+        for (const entry of index) {
+            if (entry.type === 'file' || entry.type === 'link') {
+                result.push({ kind: 'file', name: entry.originalFullName, size: entry.size });
+            }
+            else if (entry.type === 'dir') {
+                result.push({ kind: 'dir', name: entry.originalFullName });
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/http.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http.test.d.ts.map

package/dist/http.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.test.d.ts","sourceRoot":"","sources":["../src/http.test.ts"],"names":[],"mappings":""}

package/dist/http.test.js

@@ -0,0 +1,220 @@
+import { describe, expect, it } from 'vitest';
+import { HttpDirectory, HttpFile } from './http.js';
+function makeFetch(routes, spy) {
+    return async (input) => {
+        const url = input.toString();
+        if (spy)
+            spy.calls.push(url);
+        const value = routes[url];
+        if (value === undefined) {
+            return new Response(null, { status: 404, statusText: 'Not Found' });
+        }
+        return new Response(value, { status: 200 });
+    };
+}
+// Minimal index.json fixture used by most HttpDirectory tests.
+const BASE = 'http://test.local/install';
+const INDEX = {
+    [`${BASE}/index.json`]: JSON.stringify([
+        {
+            type: 'file',
+            name: 'ms43',
+            fullName: 'ms43.ipo',
+            originalName: 'MS43',
+            originalFullName: 'MS43.IPO',
+            size: 512,
+        },
+        {
+            type: 'link',
+            name: 'readme',
+            fullName: 'readme.txt',
+            originalName: 'README',
+            originalFullName: 'README.TXT',
+            size: 64,
+        },
+        {
+            type: 'dir',
+            name: 'ediabas',
+            fullName: 'ediabas',
+            originalName: 'EDIABAS',
+            originalFullName: 'EDIABAS',
+            size: 0,
+        },
+        {
+            type: 'dir',
+            name: 'ec-apps',
+            fullName: 'ec-apps',
+            originalName: 'EC-APPS',
+            originalFullName: 'EC-APPS',
+            size: 0,
+        },
+    ]),
+    [`${BASE}/MS43.IPO`]: new Uint8Array([0x49, 0x50, 0x4f]),
+    [`${BASE}/README.TXT`]: 'hello',
+};
+// ---------------------------------------------------------------------------
+// HttpFile
+// ---------------------------------------------------------------------------
+describe('HttpFile', () => {
+    it('exposes name and size', () => {
+        const f = new HttpFile('MS43.IPO', 512, `${BASE}/MS43.IPO`, makeFetch(INDEX));
+        expect(f.name).toBe('MS43.IPO');
+        expect(f.size).toBe(512);
+    });
+    it('arrayBuffer() fetches the URL and returns the body', async () => {
+        const f = new HttpFile('MS43.IPO', 512, `${BASE}/MS43.IPO`, makeFetch(INDEX));
+        const buf = await f.arrayBuffer();
+        expect(new Uint8Array(buf)).toEqual(new Uint8Array([0x49, 0x50, 0x4f]));
+    });
+    it('arrayBuffer() throws on a non-200 response', async () => {
+        const f = new HttpFile('ghost.ipo', 0, `${BASE}/ghost.ipo`, makeFetch(INDEX));
+        await expect(f.arrayBuffer()).rejects.toThrow('404');
+    });
+});
+// ---------------------------------------------------------------------------
+// HttpDirectory — entries()
+// ---------------------------------------------------------------------------
+describe('HttpDirectory.entries()', () => {
+    it('returns file and dir entries from index.json', async () => {
+        const dir = new HttpDirectory(BASE, { fetch: makeFetch(INDEX) });
+        const entries = await dir.entries();
+        expect(entries).toHaveLength(4);
+    });
+    it('maps file entries with kind "file" and original-cased name + size', async () => {
+        const dir = new HttpDirectory(BASE, { fetch: makeFetch(INDEX) });
+        const entries = await dir.entries();
+        const file = entries.find((e) => e.name === 'MS43.IPO');
+        expect(file).toEqual({ kind: 'file', name: 'MS43.IPO', size: 512 });
+    });
+    it('maps dir entries with kind "dir" and original-cased name', async () => {
+        const dir = new HttpDirectory(BASE, { fetch: makeFetch(INDEX) });
+        const entries = await dir.entries();
+        const d = entries.find((e) => e.name === 'EDIABAS');
+        expect(d).toEqual({ kind: 'dir', name: 'EDIABAS' });
+    });
+    it('treats "link" type entries as "file" kind', async () => {
+        const dir = new HttpDirectory(BASE, { fetch: makeFetch(INDEX) });
+        const entries = await dir.entries();
+        const link = entries.find((e) => e.name === 'README.TXT');
+        expect(link?.kind).toBe('file');
+    });
+    it('fetches index.json only once across multiple accesses', async () => {
+        const spy = { calls: [] };
+        const dir = new HttpDirectory(BASE, { fetch: makeFetch(INDEX, spy) });
+        await dir.entries();
+        await dir.entries();
+        await dir.file('MS43.IPO');
+        const indexFetches = spy.calls.filter((u) => u.endsWith('index.json'));
+        expect(indexFetches).toHaveLength(1);
+    });
+});
+// ---------------------------------------------------------------------------
+// HttpDirectory — file()
+// ---------------------------------------------------------------------------
+describe('HttpDirectory.file()', () => {
+    it('returns null when name is not in the index', async () => {
+        const dir = new HttpDirectory(BASE, { fetch: makeFetch(INDEX) });
+        expect(await dir.file('ghost.ipo')).toBeNull();
+    });
+    it('finds a file by exact lowercased name', async () => {
+        const dir = new HttpDirectory(BASE, { fetch: makeFetch(INDEX) });
+        const f = await dir.file('ms43.ipo');
+        expect(f?.name).toBe('MS43.IPO');
+    });
+    it('finds a file case-insensitively', async () => {
+        const dir = new HttpDirectory(BASE, { fetch: makeFetch(INDEX) });
+        const f = await dir.file('MS43.IPO');
+        expect(f?.name).toBe('MS43.IPO');
+    });
+    it('finds a link entry as a file', async () => {
+        const dir = new HttpDirectory(BASE, { fetch: makeFetch(INDEX) });
+        const f = await dir.file('readme.txt');
+        expect(f?.name).toBe('README.TXT');
+    });
+    it('returned file fetches from original-cased URL', async () => {
+        const spy = { calls: [] };
+        const dir = new HttpDirectory(BASE, { fetch: makeFetch(INDEX, spy) });
+        const f = await dir.file('ms43.ipo');
+        await f.arrayBuffer();
+        expect(spy.calls).toContain(`${BASE}/MS43.IPO`);
+    });
+    it('returned file has the correct size', async () => {
+        const dir = new HttpDirectory(BASE, { fetch: makeFetch(INDEX) });
+        const f = await dir.file('MS43.IPO');
+        expect(f?.size).toBe(512);
+    });
+});
+// ---------------------------------------------------------------------------
+// HttpDirectory — dir()
+// ---------------------------------------------------------------------------
+describe('HttpDirectory.dir()', () => {
+    it('returns null when name is not in the index', async () => {
+        const dir = new HttpDirectory(BASE, { fetch: makeFetch(INDEX) });
+        expect(await dir.dir('missing')).toBeNull();
+    });
+    it('finds a directory case-insensitively', async () => {
+        const dir = new HttpDirectory(BASE, { fetch: makeFetch(INDEX) });
+        const child = await dir.dir('ediabas');
+        expect(child?.name).toBe('EDIABAS');
+    });
+    it('child directory base URL uses original-cased name', async () => {
+        const spy = { calls: [] };
+        const routes = {
+            ...INDEX,
+            [`${BASE}/EDIABAS/index.json`]: JSON.stringify([]),
+        };
+        const dir = new HttpDirectory(BASE, { fetch: makeFetch(routes, spy) });
+        const child = await dir.dir('ediabas');
+        await child.entries();
+        expect(spy.calls).toContain(`${BASE}/EDIABAS/index.json`);
+    });
+    it('child inherits the custom indexFile option', async () => {
+        const spy = { calls: [] };
+        const custom = 'dir.json';
+        const routes = {
+            [`${BASE}/${custom}`]: JSON.stringify([
+                {
+                    type: 'dir',
+                    name: 'ediabas',
+                    fullName: 'ediabas',
+                    originalName: 'EDIABAS',
+                    originalFullName: 'EDIABAS',
+                    size: 0,
+                },
+            ]),
+            [`${BASE}/EDIABAS/${custom}`]: JSON.stringify([]),
+        };
+        const dir = new HttpDirectory(BASE, { indexFile: custom, fetch: makeFetch(routes, spy) });
+        const child = await dir.dir('EDIABAS');
+        await child.entries();
+        expect(spy.calls).toContain(`${BASE}/EDIABAS/${custom}`);
+    });
+    it('child inherits the custom fetch function', async () => {
+        const spy = { calls: [] };
+        const routes = {
+            ...INDEX,
+            [`${BASE}/EDIABAS/index.json`]: JSON.stringify([]),
+        };
+        const dir = new HttpDirectory(BASE, { fetch: makeFetch(routes, spy) });
+        const child = await dir.dir('EDIABAS');
+        await child.entries();
+        // Both the parent index and child index went through the same fetch spy
+        expect(spy.calls.filter((u) => u.includes('EDIABAS'))).not.toHaveLength(0);
+    });
+});
+// ---------------------------------------------------------------------------
+// HttpDirectory — constructor
+// ---------------------------------------------------------------------------
+describe('HttpDirectory constructor', () => {
+    it('name is the last URL segment', () => {
+        expect(new HttpDirectory('http://x.com/a/b/c').name).toBe('c');
+    });
+    it('strips a trailing slash from the base URL', async () => {
+        const spy = { calls: [] };
+        const routes = { [`${BASE}/index.json`]: JSON.stringify([]) };
+        const dir = new HttpDirectory(BASE + '/', { fetch: makeFetch(routes, spy) });
+        await dir.entries();
+        expect(spy.calls[0]).toBe(`${BASE}/index.json`);
+    });
+});
+//# sourceMappingURL=http.test.js.map

package/dist/http.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { VirtualFile, VirtualDirectory, VirtualEntry } from './types.js';
+export { FsaFile, FsaDirectory } from './fsa.js';
+export { HttpFile, HttpDirectory, type HttpDirectoryOptions } from './http.js';
+export { drillPath, listFiles } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { FsaFile, FsaDirectory } from './fsa.js';
+export { HttpFile, HttpDirectory } from './http.js';
+export { drillPath, listFiles } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAA6B,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,37 @@
+/** A readable file in the virtual FS. */
+export interface VirtualFile {
+    /** Original-cased full basename, e.g. `"MS43.IPO"`. */
+    readonly name: string;
+    /** Size in bytes. */
+    readonly size: number;
+    arrayBuffer(): Promise<ArrayBuffer>;
+}
+/** A read-only directory in the virtual FS. */
+export interface VirtualDirectory {
+    /** Original-cased directory name. */
+    readonly name: string;
+    /**
+     * Case-insensitive file lookup.
+     * Returns `null` when no file with that name exists.
+     */
+    file(name: string): Promise<VirtualFile | null>;
+    /**
+     * Case-insensitive subdirectory lookup.
+     * Returns `null` when no directory with that name exists.
+     */
+    dir(name: string): Promise<VirtualDirectory | null>;
+    /**
+     * Flat listing of direct children. For FSA-backed directories, file
+     * sizes are 0 — call `file(name)` when you need the actual size.
+     */
+    entries(): Promise<VirtualEntry[]>;
+}
+export type VirtualEntry = {
+    kind: 'file';
+    name: string;
+    size: number;
+} | {
+    kind: 'dir';
+    name: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACrC;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAEhD;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAEpD;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,19 @@
+import type { VirtualDirectory, VirtualEntry } from './types.js';
+/**
+ * Walk down path segments case-insensitively.
+ * Returns `null` as soon as any segment is not found.
+ *
+ * @example
+ * const cfgdat = await drillPath(root, 'EC-APPS', 'INPA', 'CFGDAT');
+ */
+export declare function drillPath(root: VirtualDirectory, ...segments: string[]): Promise<VirtualDirectory | null>;
+/**
+ * List all files directly inside `dir`, optionally filtered by extension
+ * (matched case-insensitively, leading dot required, e.g. `".ipo"`).
+ *
+ * Returns lightweight entry objects — call `dir.file(name)` to open one.
+ */
+export declare function listFiles(dir: VirtualDirectory, ext?: string): Promise<Array<VirtualEntry & {
+    kind: 'file';
+}>>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,gBAAgB,EACtB,GAAG,QAAQ,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAQlC;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,gBAAgB,EACrB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAMjD"}

package/dist/utils.js

@@ -0,0 +1,32 @@
+/**
+ * Walk down path segments case-insensitively.
+ * Returns `null` as soon as any segment is not found.
+ *
+ * @example
+ * const cfgdat = await drillPath(root, 'EC-APPS', 'INPA', 'CFGDAT');
+ */
+export async function drillPath(root, ...segments) {
+    let current = root;
+    for (const segment of segments) {
+        const next = await current.dir(segment);
+        if (!next)
+            return null;
+        current = next;
+    }
+    return current;
+}
+/**
+ * List all files directly inside `dir`, optionally filtered by extension
+ * (matched case-insensitively, leading dot required, e.g. `".ipo"`).
+ *
+ * Returns lightweight entry objects — call `dir.file(name)` to open one.
+ */
+export async function listFiles(dir, ext) {
+    const all = await dir.entries();
+    const files = all.filter((e) => e.kind === 'file');
+    if (!ext)
+        return files;
+    const extLower = ext.toLowerCase();
+    return files.filter((e) => e.name.toLowerCase().endsWith(extLower));
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAsB,EACtB,GAAG,QAAkB;IAErB,IAAI,OAAO,GAAqB,IAAI,CAAC;IACrC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAqB,EACrB,GAAY;IAEZ,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAwC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACzF,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACnC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACtE,CAAC"}