@emdzej/bimmerz-vfs 0.1.0

package/LICENSE

@@ -0,0 +1,131 @@
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose.  However, you may
+only distribute the software according to [Distribution
+License](#distribution-license) and make changes or new works
+based on the software according to [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software.  Your license
+to distribute covers distributing the software with
+changes and new works permitted by [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization,
+or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting
+from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.

package/README.md

@@ -0,0 +1,154 @@
+# @emdzej/bimmerz-vfs
+
+Read-only virtual file system for bimmerz tools — one interface, two backends:
+
+| Backend | Class | Source |
+|---|---|---|
+| **Local** | `FsaDirectory` | File System Access API / OPFS (`FileSystemDirectoryHandle`) |
+| **Remote** | `HttpDirectory` | HTTP server + `index.json` directory listings |
+
+Both implement `VirtualDirectory`. All lookups are **case-insensitive**.
+
+## Install
+
+```bash
+npm i @emdzej/bimmerz-vfs
+```
+
+## Quick start
+
+```ts
+import { FsaDirectory, HttpDirectory, drillPath, listFiles } from '@emdzej/bimmerz-vfs';
+
+// ---- Local (File System Access API / OPFS) ----
+const handle = await showDirectoryPicker();
+const local = new FsaDirectory(handle);
+
+// ---- Remote (HTTP + index.json) ----
+const remote = new HttpDirectory('https://files.example.com/inpa-bundle');
+
+// ---- Same API for both ----
+const ecu = await drillPath(remote, 'EDIABAS', 'Ecu');   // case-insensitive
+const ipos = await listFiles(ecu!, '.ipo');               // [{ name: 'MS43.IPO', size: 12345 }]
+const file = await ecu!.file('ms43.prg');                 // case-insensitive
+const bytes = await file!.arrayBuffer();
+```
+
+## API
+
+### `VirtualDirectory`
+
+```ts
+interface VirtualDirectory {
+  readonly name: string;
+
+  /** Case-insensitive. Returns null if not found. */
+  file(name: string): Promise<VirtualFile | null>;
+
+  /** Case-insensitive. Returns null if not found. */
+  dir(name: string): Promise<VirtualDirectory | null>;
+
+  /**
+   * Flat listing of direct children.
+   * Note: FsaDirectory returns size=0 for files — call file(name) for the real size.
+   */
+  entries(): Promise<VirtualEntry[]>;
+}
+
+type VirtualEntry =
+  | { kind: 'file'; name: string; size: number }
+  | { kind: 'dir';  name: string };
+```
+
+### `VirtualFile`
+
+```ts
+interface VirtualFile {
+  readonly name: string;   // original-cased full basename: "MS43.IPO"
+  readonly size: number;
+  arrayBuffer(): Promise<ArrayBuffer>;
+}
+```
+
+### `FsaDirectory(handle)`
+
+Wraps a `FileSystemDirectoryHandle` (File System Access API or OPFS). Both sources return the same handle type, so this class works for both.
+
+```ts
+// File System Access API (user picks a folder)
+const root = new FsaDirectory(await showDirectoryPicker());
+
+// OPFS (pre-extracted bundle)
+const opfsRoot = await navigator.storage.getDirectory();
+const root = new FsaDirectory(opfsRoot);
+```
+
+`entries()` does not call `getFile()` per entry (no extra I/O for listings). Call `file(name)` when you need the actual size.
+
+### `HttpDirectory(baseUrl, options?)`
+
+Navigates a remote tree using `index.json` files generated by `bimmerz data index`.
+
+```ts
+const root = new HttpDirectory('https://cdn.example.com/inpa', {
+  indexFile: 'index.json',  // default
+  fetch: customFetch,       // inject auth headers, mock in tests, etc.
+});
+```
+
+**How it works:**
+1. On first access `entries()` / `file()` / `dir()` fetches `{baseUrl}/index.json` and caches it.
+2. `file(name)` finds the matching entry (case-insensitive on `fullName`) and returns an `HttpFile` that fetches `{baseUrl}/{originalFullName}` on `arrayBuffer()`.
+3. `dir(name)` returns a new `HttpDirectory` rooted at `{baseUrl}/{originalFullName}/`, which lazily fetches its own `index.json`.
+
+The `index.json` format is the one written by [`bimmerz data index`](../../../apps/cli) — both `fullName` (lowercase) and `originalFullName` (original casing) are present in every entry. The lookup uses `fullName` for matching and `originalFullName` for the fetch URL, so the original casing of the server's files is preserved in HTTP requests.
+
+**`link` entries** (symlinks recorded by `bimmerz data index`) are treated as files.
+
+### `drillPath(root, ...segments)`
+
+Walk down a path segment by segment, case-insensitively. Returns `null` at the first missing segment.
+
+```ts
+const cfgdat = await drillPath(root, 'EC-APPS', 'INPA', 'CFGDAT');
+// equivalent to:
+// root.dir('EC-APPS') → .dir('INPA') → .dir('CFGDAT')
+```
+
+### `listFiles(dir, ext?)`
+
+Return all file entries in `dir`, optionally filtered by extension (case-insensitive, dot required).
+
+```ts
+const ipos = await listFiles(cfgdat, '.ipo');
+// [{ kind: 'file', name: 'MS43.IPO', size: 512 }, ...]
+```
+
+Returns `Array<{ kind: 'file'; name: string; size: number }>` — lightweight entry objects. Call `dir.file(name)` to open one.
+
+## Serving an install remotely
+
+Use `bimmerz data index` to write `index.json` files into the extracted install tree, then serve the whole directory over HTTP (nginx, GitHub Pages, any static host):
+
+```bash
+bimmerz data index ~/inpa-extracted
+# → writes index.json in every subdirectory
+
+# Serve with any static file server
+npx serve ~/inpa-extracted
+```
+
+Then point `HttpDirectory` at the server root:
+
+```ts
+const root = new HttpDirectory('http://localhost:3000');
+const cfgdat = await drillPath(root, 'EC-APPS', 'INPA', 'CFGDAT');
+const ipo = await cfgdat!.file('MS43.IPO');
+const bytes = await ipo!.arrayBuffer();
+```
+
+## Notes
+
+- **Read-only** — no write operations. External write-back (fault-store reports, etc.) is application-layer concern.
+- **No runtime dependencies** — FSA is a browser built-in; HTTP uses `fetch`. Works in any environment with `fetch` (browsers, Node ≥ 18, Deno, Bun).
+- **Index caching** — each `HttpDirectory` instance fetches its `index.json` at most once. Create a new instance to force a refresh.

package/dist/fsa.d.ts

@@ -0,0 +1,17 @@
+import type { VirtualFile, VirtualDirectory, VirtualEntry } from './types.js';
+export declare class FsaFile implements VirtualFile {
+    #private;
+    readonly name: string;
+    readonly size: number;
+    constructor(handle: FileSystemFileHandle, file: File);
+    arrayBuffer(): Promise<ArrayBuffer>;
+}
+export declare class FsaDirectory implements VirtualDirectory {
+    #private;
+    readonly name: string;
+    constructor(handle: FileSystemDirectoryHandle);
+    file(name: string): Promise<VirtualFile | null>;
+    dir(name: string): Promise<VirtualDirectory | null>;
+    entries(): Promise<VirtualEntry[]>;
+}
+//# sourceMappingURL=fsa.d.ts.map

package/dist/fsa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsa.d.ts","sourceRoot":"","sources":["../src/fsa.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9E,qBAAa,OAAQ,YAAW,WAAW;;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAKV,MAAM,EAAE,oBAAoB,EAAE,IAAI,EAAE,IAAI;IAMpD,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;CAGpC;AAED,qBAAa,YAAa,YAAW,gBAAgB;;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGV,MAAM,EAAE,yBAAyB;IAKvC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAY/C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAUnD,OAAO,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;CAazC"}

package/dist/fsa.js

@@ -0,0 +1,58 @@
+export class FsaFile {
+    name;
+    size;
+    // Cache the File object obtained during construction so arrayBuffer()
+    // doesn't need a second getFile() round-trip.
+    #file;
+    constructor(handle, file) {
+        this.name = handle.name;
+        this.size = file.size;
+        this.#file = file;
+    }
+    arrayBuffer() {
+        return this.#file.arrayBuffer();
+    }
+}
+export class FsaDirectory {
+    name;
+    #handle;
+    constructor(handle) {
+        this.name = handle.name;
+        this.#handle = handle;
+    }
+    async file(name) {
+        const target = name.toLowerCase();
+        for await (const [entryName, handle] of this.#handle.entries()) {
+            if (handle.kind === 'file' && entryName.toLowerCase() === target) {
+                const fileHandle = handle;
+                const file = await fileHandle.getFile();
+                return new FsaFile(fileHandle, file);
+            }
+        }
+        return null;
+    }
+    async dir(name) {
+        const target = name.toLowerCase();
+        for await (const [entryName, handle] of this.#handle.entries()) {
+            if (handle.kind === 'directory' && entryName.toLowerCase() === target) {
+                return new FsaDirectory(handle);
+            }
+        }
+        return null;
+    }
+    async entries() {
+        const result = [];
+        for await (const [name, handle] of this.#handle.entries()) {
+            if (handle.kind === 'file') {
+                // Avoid calling getFile() for every entry — size is 0 here.
+                // Call dir.file(name) when you need the actual file and its size.
+                result.push({ kind: 'file', name, size: 0 });
+            }
+            else if (handle.kind === 'directory') {
+                result.push({ kind: 'dir', name });
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=fsa.js.map

package/dist/fsa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsa.js","sourceRoot":"","sources":["../src/fsa.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,OAAO;IACT,IAAI,CAAS;IACb,IAAI,CAAS;IACtB,sEAAsE;IACtE,8CAA8C;IACrC,KAAK,CAAO;IAErB,YAAY,MAA4B,EAAE,IAAU;QAClD,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,YAAY;IACd,IAAI,CAAS;IACb,OAAO,CAA4B;IAE5C,YAAY,MAAiC;QAC3C,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAClC,IAAI,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/D,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,SAAS,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;gBACjE,MAAM,UAAU,GAAG,MAA8B,CAAC;gBAClD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;gBACxC,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAY;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAClC,IAAI,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/D,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,SAAS,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;gBACtE,OAAO,IAAI,YAAY,CAAC,MAAmC,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,MAAM,GAAmB,EAAE,CAAC;QAClC,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1D,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC3B,4DAA4D;gBAC5D,kEAAkE;gBAClE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/C,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACvC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/fsa.test.d.ts

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

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

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

package/dist/fsa.test.js

@@ -0,0 +1,118 @@
+import { describe, expect, it } from 'vitest';
+import { FsaDirectory, FsaFile } from './fsa.js';
+// ---------------------------------------------------------------------------
+// Mock helpers — minimal FSA-shaped objects without a real browser
+// ---------------------------------------------------------------------------
+function mockFile(name, content) {
+    return {
+        kind: 'file',
+        name,
+        getFile: async () => ({ arrayBuffer: async () => content.buffer.slice(0), size: content.length }),
+    };
+}
+function mockDir(name, children) {
+    return {
+        kind: 'directory',
+        name,
+        entries: async function* () {
+            for (const child of children) {
+                yield [child.name, child];
+            }
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// FsaFile
+// ---------------------------------------------------------------------------
+describe('FsaFile', () => {
+    const content = new Uint8Array([0x49, 0x50, 0x4f]);
+    const handle = mockFile('MS43.IPO', content);
+    it('exposes name and size from constructor args', async () => {
+        const file = await handle.getFile();
+        const fsaFile = new FsaFile(handle, file);
+        expect(fsaFile.name).toBe('MS43.IPO');
+        expect(fsaFile.size).toBe(3);
+    });
+    it('arrayBuffer() returns the file contents', async () => {
+        const file = await handle.getFile();
+        const fsaFile = new FsaFile(handle, file);
+        const buf = await fsaFile.arrayBuffer();
+        expect(new Uint8Array(buf)).toEqual(content);
+    });
+});
+// ---------------------------------------------------------------------------
+// FsaDirectory
+// ---------------------------------------------------------------------------
+const IPO = new Uint8Array([0x01, 0x02, 0x03]);
+const INI = new Uint8Array([0x5b, 0x49, 0x4e, 0x50, 0x41, 0x5d]); // [INPA]
+const ecuHandle = mockDir('Ecu', [
+    mockFile('MS43.prg', new Uint8Array([0x50, 0x52, 0x47])),
+]);
+const rootHandle = mockDir('root', [
+    mockFile('MS43.IPO', IPO),
+    mockFile('INPA.INI', INI),
+    ecuHandle,
+]);
+const root = new FsaDirectory(rootHandle);
+describe('FsaDirectory.file()', () => {
+    it('returns null when the file does not exist', async () => {
+        expect(await root.file('missing.ipo')).toBeNull();
+    });
+    it('finds a file by exact name', async () => {
+        const f = await root.file('MS43.IPO');
+        expect(f).not.toBeNull();
+        expect(f.name).toBe('MS43.IPO');
+    });
+    it('finds a file case-insensitively', async () => {
+        const f = await root.file('ms43.ipo');
+        expect(f).not.toBeNull();
+        expect(f.name).toBe('MS43.IPO');
+    });
+    it('does not return a directory when looking for a file', async () => {
+        expect(await root.file('Ecu')).toBeNull();
+    });
+    it('returns file with correct size and contents', async () => {
+        const f = await root.file('MS43.IPO');
+        expect(f.size).toBe(IPO.length);
+        const buf = await f.arrayBuffer();
+        expect(new Uint8Array(buf)).toEqual(IPO);
+    });
+});
+describe('FsaDirectory.dir()', () => {
+    it('returns null when the directory does not exist', async () => {
+        expect(await root.dir('missing')).toBeNull();
+    });
+    it('finds a directory by exact name', async () => {
+        const d = await root.dir('Ecu');
+        expect(d).not.toBeNull();
+        expect(d.name).toBe('Ecu');
+    });
+    it('finds a directory case-insensitively', async () => {
+        const d = await root.dir('ecu');
+        expect(d).not.toBeNull();
+        expect(d.name).toBe('Ecu');
+    });
+    it('does not return a file when looking for a directory', async () => {
+        expect(await root.dir('MS43.IPO')).toBeNull();
+    });
+});
+describe('FsaDirectory.entries()', () => {
+    it('lists files with kind "file" and size 0', async () => {
+        const entries = await root.entries();
+        const files = entries.filter((e) => e.kind === 'file');
+        expect(files.length).toBe(2);
+        expect(files.every((f) => f.kind === 'file' && f.size === 0)).toBe(true);
+    });
+    it('lists directories with kind "dir"', async () => {
+        const entries = await root.entries();
+        const dirs = entries.filter((e) => e.kind === 'dir');
+        expect(dirs.length).toBe(1);
+        expect(dirs[0].name).toBe('Ecu');
+    });
+    it('preserves original casing in entry names', async () => {
+        const entries = await root.entries();
+        const names = entries.map((e) => e.name).sort();
+        expect(names).toEqual(['Ecu', 'INPA.INI', 'MS43.IPO'].sort());
+    });
+});
+//# sourceMappingURL=fsa.test.js.map

package/dist/fsa.test.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,26 @@
+import type { VirtualFile, VirtualDirectory, VirtualEntry } from './types.js';
+export interface HttpDirectoryOptions {
+    /** Name of the index file to fetch from each directory. Default: `"index.json"`. */
+    indexFile?: string;
+    /**
+     * Custom fetch implementation. Defaults to `globalThis.fetch`.
+     * Useful for injecting auth headers, mocking in tests, etc.
+     */
+    fetch?: typeof globalThis.fetch;
+}
+export declare class HttpFile implements VirtualFile {
+    #private;
+    readonly name: string;
+    readonly size: number;
+    constructor(name: string, size: number, url: string, fetchFn: typeof globalThis.fetch);
+    arrayBuffer(): Promise<ArrayBuffer>;
+}
+export declare class HttpDirectory implements VirtualDirectory {
+    #private;
+    readonly name: string;
+    constructor(baseUrl: string, options?: HttpDirectoryOptions);
+    file(name: string): Promise<VirtualFile | null>;
+    dir(name: string): Promise<VirtualDirectory | null>;
+    entries(): Promise<VirtualEntry[]>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiB9E,MAAM,WAAW,oBAAoB;IACnC,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,qBAAa,QAAS,YAAW,WAAW;;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAKpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,UAAU,CAAC,KAAK;IAQ5B,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;CAK1C;AAED,qBAAa,aAAc,YAAW,gBAAgB;;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAOV,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB;IAkBzD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAY/C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAWnD,OAAO,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;CAYzC"}

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

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

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

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