@xfcfam/xf-fs 0.1.0

package/dist/src/repository/structs/WatchEvent.d.ts

@@ -0,0 +1,18 @@
+/** Kind of filesystem change observed by a `Watcher`. */
+export type WatchEventKind = 'created' | 'modified' | 'deleted' | 'renamed';
+/**
+ * Access-layer Transfer — a single filesystem-change event delivered
+ * by a `Watcher` callback.
+ *
+ * The `path` is absolute; `oldPath` is populated on `renamed` events
+ * to carry the previous path of the entry.
+ */
+export interface WatchEvent {
+    /** Absolute path of the affected entry (the new path on rename). */
+    path: string;
+    /** Previous absolute path on rename events; otherwise undefined. */
+    oldPath?: string;
+    /** Kind of change observed. */
+    kind: WatchEventKind;
+}
+//# sourceMappingURL=WatchEvent.d.ts.map

package/dist/src/repository/structs/WatchEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WatchEvent.d.ts","sourceRoot":"","sources":["../../../../src/repository/structs/WatchEvent.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAA;AAE3E;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,IAAI,EAAE,cAAc,CAAA;CACrB"}

package/dist/src/repository/structs/WatchEvent.js

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

package/dist/src/repository/structs/WatchEvent.js.map

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

package/dist/src/repository/structs/Watcher.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Access-layer Transfer — an active filesystem watcher returned by
+ * `FileRepository.watch()`. Carries the live handle plus a `close()`
+ * to release the OS resource.
+ *
+ * The XF model treats a stateful resource handle as a Transfer (just
+ * like a database cursor or an HTTP response stream): the Logical
+ * (Repository) hands it back to the caller, who owns its lifecycle.
+ */
+export interface Watcher {
+    /** Absolute path being watched (root of the watch — may be a file or directory). */
+    readonly path: string;
+    /** Whether the watcher is still active. */
+    readonly isActive: boolean;
+    /** Stop receiving events and release the underlying OS handle. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=Watcher.d.ts.map

package/dist/src/repository/structs/Watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Watcher.d.ts","sourceRoot":"","sources":["../../../../src/repository/structs/Watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,OAAO;IACtB,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,kEAAkE;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB"}

package/dist/src/repository/structs/Watcher.js

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

package/dist/src/repository/structs/Watcher.js.map

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

package/dist/src/repository/transfers/DirectoryNotEmptyException.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Access-layer Exception — `rmdir` was called on a directory that
+ * still contains entries.
+ *
+ * `FileRepository` translates `node:fs`'s `ENOTEMPTY` into this typed
+ * Exception. Callers that want recursive deletion call `rmdir(path,
+ * { recursive: true })` instead of catching this one.
+ */
+export declare class DirectoryNotEmptyException extends Error {
+    readonly path: string;
+    constructor(path: string);
+}
+//# sourceMappingURL=DirectoryNotEmptyException.d.ts.map

package/dist/src/repository/transfers/DirectoryNotEmptyException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectoryNotEmptyException.d.ts","sourceRoot":"","sources":["../../../../src/repository/transfers/DirectoryNotEmptyException.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAET,IAAI,EAAE,MAAM;CAKzB"}

package/dist/src/repository/transfers/DirectoryNotEmptyException.js

@@ -0,0 +1,17 @@
+/**
+ * Access-layer Exception — `rmdir` was called on a directory that
+ * still contains entries.
+ *
+ * `FileRepository` translates `node:fs`'s `ENOTEMPTY` into this typed
+ * Exception. Callers that want recursive deletion call `rmdir(path,
+ * { recursive: true })` instead of catching this one.
+ */
+export class DirectoryNotEmptyException extends Error {
+    path;
+    constructor(path) {
+        super(`Directory not empty: ${path}`);
+        this.name = 'DirectoryNotEmptyException';
+        this.path = path;
+    }
+}
+//# sourceMappingURL=DirectoryNotEmptyException.js.map

package/dist/src/repository/transfers/DirectoryNotEmptyException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectoryNotEmptyException.js","sourceRoot":"","sources":["../../../../src/repository/transfers/DirectoryNotEmptyException.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,IAAI,CAAQ;IAErB,YAAY,IAAY;QACtB,KAAK,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAA;QACrC,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAA;QACxC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF"}

package/dist/src/repository/transfers/FileAccessDeniedException.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Access-layer Exception — the operating system denied permission
+ * to perform the requested operation on the path.
+ *
+ * Thrown by `FileRepository` when `node:fs` raises `EACCES` or
+ * `EPERM`. The Repository translates the platform error into this
+ * typed Exception so consumers can branch on permission failure
+ * without inspecting `errno` codes.
+ */
+export declare class FileAccessDeniedException extends Error {
+    readonly path: string;
+    constructor(path: string);
+}
+//# sourceMappingURL=FileAccessDeniedException.d.ts.map

package/dist/src/repository/transfers/FileAccessDeniedException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileAccessDeniedException.d.ts","sourceRoot":"","sources":["../../../../src/repository/transfers/FileAccessDeniedException.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAET,IAAI,EAAE,MAAM;CAKzB"}

package/dist/src/repository/transfers/FileAccessDeniedException.js

@@ -0,0 +1,18 @@
+/**
+ * Access-layer Exception — the operating system denied permission
+ * to perform the requested operation on the path.
+ *
+ * Thrown by `FileRepository` when `node:fs` raises `EACCES` or
+ * `EPERM`. The Repository translates the platform error into this
+ * typed Exception so consumers can branch on permission failure
+ * without inspecting `errno` codes.
+ */
+export class FileAccessDeniedException extends Error {
+    path;
+    constructor(path) {
+        super(`Access denied: ${path}`);
+        this.name = 'FileAccessDeniedException';
+        this.path = path;
+    }
+}
+//# sourceMappingURL=FileAccessDeniedException.js.map

package/dist/src/repository/transfers/FileAccessDeniedException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileAccessDeniedException.js","sourceRoot":"","sources":["../../../../src/repository/transfers/FileAccessDeniedException.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACzC,IAAI,CAAQ;IAErB,YAAY,IAAY;QACtB,KAAK,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAA;QAC/B,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF"}

package/dist/src/repository/transfers/FileEntry.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Access-layer Transfer — a single entry yielded by directory
+ * traversal (`list` / `walk`). Captures path information and the
+ * cheap stat fields available from the directory iteration; richer
+ * metadata is fetched separately via {@link FileStat}.
+ */
+export interface FileEntry {
+    /** Absolute path of the entry on disk. */
+    path: string;
+    /** Path relative to the walk's root, with `/` separators. */
+    relativePath: string;
+    /** Final segment of `path` (the filename or directory name). */
+    name: string;
+    /** Whether the entry is a regular file. */
+    isFile: boolean;
+    /** Whether the entry is a directory. */
+    isDirectory: boolean;
+    /** Whether the entry is a symbolic link. */
+    isSymlink: boolean;
+}
+//# sourceMappingURL=FileEntry.d.ts.map

package/dist/src/repository/transfers/FileEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileEntry.d.ts","sourceRoot":"","sources":["../../../../src/repository/transfers/FileEntry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAA;IACpB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAA;IACZ,2CAA2C;IAC3C,MAAM,EAAE,OAAO,CAAA;IACf,wCAAwC;IACxC,WAAW,EAAE,OAAO,CAAA;IACpB,4CAA4C;IAC5C,SAAS,EAAE,OAAO,CAAA;CACnB"}

package/dist/src/repository/transfers/FileEntry.js

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

package/dist/src/repository/transfers/FileEntry.js.map

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

package/dist/src/repository/transfers/FileNotFoundException.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Access-layer Exception — the requested path does not exist on disk.
+ *
+ * Thrown by `FileRepository` operations that require the path to
+ * exist (`read`, `stat`, `delete`, `list`, …). The Repository
+ * translates the `node:fs` `ENOENT` error into this typed Exception
+ * before propagating it upward.
+ */
+export declare class FileNotFoundException extends Error {
+    readonly path: string;
+    constructor(path: string);
+}
+//# sourceMappingURL=FileNotFoundException.d.ts.map

package/dist/src/repository/transfers/FileNotFoundException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileNotFoundException.d.ts","sourceRoot":"","sources":["../../../../src/repository/transfers/FileNotFoundException.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAET,IAAI,EAAE,MAAM;CAKzB"}

package/dist/src/repository/transfers/FileNotFoundException.js

@@ -0,0 +1,17 @@
+/**
+ * Access-layer Exception — the requested path does not exist on disk.
+ *
+ * Thrown by `FileRepository` operations that require the path to
+ * exist (`read`, `stat`, `delete`, `list`, …). The Repository
+ * translates the `node:fs` `ENOENT` error into this typed Exception
+ * before propagating it upward.
+ */
+export class FileNotFoundException extends Error {
+    path;
+    constructor(path) {
+        super(`File not found: ${path}`);
+        this.name = 'FileNotFoundException';
+        this.path = path;
+    }
+}
+//# sourceMappingURL=FileNotFoundException.js.map

package/dist/src/repository/transfers/FileNotFoundException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileNotFoundException.js","sourceRoot":"","sources":["../../../../src/repository/transfers/FileNotFoundException.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,IAAI,CAAQ;IAErB,YAAY,IAAY;QACtB,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAA;QAChC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF"}

package/dist/src/repository/transfers/FileStat.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Access-layer Transfer — metadata of a single file or directory.
+ * Mirrors `node:fs` `Stats` but reduced to the surface XF artefacts
+ * actually consume.
+ */
+export interface FileStat {
+    /** Absolute path the stat was taken from. */
+    path: string;
+    /** Size in bytes (0 for directories). */
+    size: number;
+    /** Last modification time. */
+    modifiedAt: Date;
+    /** Creation time. May equal `modifiedAt` on filesystems without birth time. */
+    createdAt: Date;
+    /** Whether the entry is a regular file. */
+    isFile: boolean;
+    /** Whether the entry is a directory. */
+    isDirectory: boolean;
+    /** Whether the entry is a symbolic link. */
+    isSymlink: boolean;
+    /** POSIX-style permission bits (e.g. `0o644`). */
+    mode: number;
+}
+//# sourceMappingURL=FileStat.d.ts.map

package/dist/src/repository/transfers/FileStat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileStat.d.ts","sourceRoot":"","sources":["../../../../src/repository/transfers/FileStat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,UAAU,EAAE,IAAI,CAAA;IAChB,+EAA+E;IAC/E,SAAS,EAAE,IAAI,CAAA;IACf,2CAA2C;IAC3C,MAAM,EAAE,OAAO,CAAA;IACf,wCAAwC;IACxC,WAAW,EAAE,OAAO,CAAA;IACpB,4CAA4C;IAC5C,SAAS,EAAE,OAAO,CAAA;IAClB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAA;CACb"}

package/dist/src/repository/transfers/FileStat.js

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

package/dist/src/repository/transfers/FileStat.js.map

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

package/dist/src/repository/transfers/TempFile.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Access-layer Transfer — a temporary file allocated by
+ * `FileRepository.tempFile()`. Carries its absolute path plus a
+ * `close()` that deletes the file on the disk.
+ *
+ * Same shape as {@link Watcher}: a resource handle that the caller
+ * is responsible for releasing. The owning `FileRepository` also
+ * cleans up every tempfile it ever issued on `terminate()`, so even
+ * a careless caller won't leak.
+ */
+export interface TempFile {
+    /** Absolute path of the temporary file on disk. */
+    readonly path: string;
+    /** Whether the temp file is still present (false after `close()`). */
+    readonly isOpen: boolean;
+    /** Delete the file from disk and mark this handle closed. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=TempFile.d.ts.map

package/dist/src/repository/transfers/TempFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TempFile.d.ts","sourceRoot":"","sources":["../../../../src/repository/transfers/TempFile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACvB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,6DAA6D;IAC7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB"}

package/dist/src/repository/transfers/TempFile.js

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

package/dist/src/repository/transfers/TempFile.js.map

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

package/dist/src/repository/transfers/WatchEvent.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Kind of filesystem change observed by a `Watcher`.
+ *
+ * Note: the built-in `node:fs` watcher only ever emits `'modified'` and
+ * `'renamed'`. `'created'` and `'deleted'` are part of the general contract
+ * for custom `Watcher` implementations and are never produced by the
+ * filesystem watcher shipped with this package.
+ */
+export type WatchEventKind = 'created' | 'modified' | 'deleted' | 'renamed';
+/**
+ * Access-layer Transfer — a single filesystem-change event delivered
+ * by a `Watcher` callback.
+ *
+ * The `path` is absolute; `oldPath` is populated on `renamed` events
+ * to carry the previous path of the entry.
+ */
+export interface WatchEvent {
+    /** Absolute path of the affected entry (the new path on rename). */
+    path: string;
+    /** Previous absolute path on rename events; otherwise undefined. */
+    oldPath?: string;
+    /** Kind of change observed. */
+    kind: WatchEventKind;
+}
+//# sourceMappingURL=WatchEvent.d.ts.map

package/dist/src/repository/transfers/WatchEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WatchEvent.d.ts","sourceRoot":"","sources":["../../../../src/repository/transfers/WatchEvent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAA;AAE3E;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,IAAI,EAAE,cAAc,CAAA;CACrB"}

package/dist/src/repository/transfers/WatchEvent.js

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

package/dist/src/repository/transfers/WatchEvent.js.map

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

package/dist/src/repository/transfers/Watcher.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Access-layer Transfer — an active filesystem watcher returned by
+ * `FileRepository.watch()`. Carries the live handle plus a `close()`
+ * to release the OS resource.
+ *
+ * The XF model treats a stateful resource handle as a Transfer (just
+ * like a database cursor or an HTTP response stream): the Logical
+ * (Repository) hands it back to the caller, who owns its lifecycle.
+ */
+export interface Watcher {
+    /** Absolute path being watched (root of the watch — may be a file or directory). */
+    readonly path: string;
+    /** Whether the watcher is still active. */
+    readonly isActive: boolean;
+    /** Stop receiving events and release the underlying OS handle. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=Watcher.d.ts.map

package/dist/src/repository/transfers/Watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Watcher.d.ts","sourceRoot":"","sources":["../../../../src/repository/transfers/Watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,OAAO;IACtB,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,kEAAkE;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB"}

package/dist/src/repository/transfers/Watcher.js

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

package/dist/src/repository/transfers/Watcher.js.map

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

package/dist/src/repository/utils/EncodingUtils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Static utility — text encoding helpers operating only on in-memory
+ * buffers. No I/O.
+ *
+ * Currently scoped to BOM detection / stripping and the canonical
+ * UTF-8 / UTF-16 byte order marks. Detection beyond these (chardet-
+ * style heuristics for Latin-1, Windows-1252, etc.) is out of scope
+ * for v0 and lives behind a dedicated library if it's ever needed.
+ */
+export type Encoding = 'utf-8' | 'utf-16le' | 'utf-16be' | 'utf-8-bom';
+export declare class EncodingUtils {
+    private constructor();
+    /**
+     * Inspect the first few bytes of `bytes` and return the detected
+     * BOM-bearing encoding, or `'utf-8'` when no BOM is present (the
+     * default modern encoding).
+     */
+    static detect(bytes: Uint8Array): Encoding;
+    /**
+     * Remove the BOM at the start of `text` if present. Safe to call
+     * unconditionally — returns `text` unchanged when there's no BOM.
+     */
+    static stripBom(text: string): string;
+    /** Encode a string as UTF-8 bytes. */
+    static toBytes(text: string): Uint8Array;
+    /** Decode UTF-8 bytes into a string, stripping any leading BOM. */
+    static fromBytes(bytes: Uint8Array): string;
+}
+//# sourceMappingURL=EncodingUtils.d.ts.map

package/dist/src/repository/utils/EncodingUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EncodingUtils.d.ts","sourceRoot":"","sources":["../../../../src/repository/utils/EncodingUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAA;AAEtE,qBAAa,aAAa;IACxB,OAAO;IAEP;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ;IAS1C;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKrC,sCAAsC;IACtC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAIxC,mEAAmE;IACnE,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;CAG5C"}

package/dist/src/repository/utils/EncodingUtils.js

@@ -0,0 +1,36 @@
+export class EncodingUtils {
+    constructor() { }
+    /**
+     * Inspect the first few bytes of `bytes` and return the detected
+     * BOM-bearing encoding, or `'utf-8'` when no BOM is present (the
+     * default modern encoding).
+     */
+    static detect(bytes) {
+        if (bytes.length >= 3 && bytes[0] === 0xef && bytes[1] === 0xbb && bytes[2] === 0xbf) {
+            return 'utf-8-bom';
+        }
+        if (bytes.length >= 2 && bytes[0] === 0xff && bytes[1] === 0xfe)
+            return 'utf-16le';
+        if (bytes.length >= 2 && bytes[0] === 0xfe && bytes[1] === 0xff)
+            return 'utf-16be';
+        return 'utf-8';
+    }
+    /**
+     * Remove the BOM at the start of `text` if present. Safe to call
+     * unconditionally — returns `text` unchanged when there's no BOM.
+     */
+    static stripBom(text) {
+        if (text.length > 0 && text.charCodeAt(0) === 0xfeff)
+            return text.slice(1);
+        return text;
+    }
+    /** Encode a string as UTF-8 bytes. */
+    static toBytes(text) {
+        return new TextEncoder().encode(text);
+    }
+    /** Decode UTF-8 bytes into a string, stripping any leading BOM. */
+    static fromBytes(bytes) {
+        return EncodingUtils.stripBom(new TextDecoder('utf-8').decode(bytes));
+    }
+}
+//# sourceMappingURL=EncodingUtils.js.map

package/dist/src/repository/utils/EncodingUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EncodingUtils.js","sourceRoot":"","sources":["../../../../src/repository/utils/EncodingUtils.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,aAAa;IACxB,gBAAuB,CAAC;IAExB;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,KAAiB;QAC7B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACrF,OAAO,WAAW,CAAA;QACpB,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,UAAU,CAAA;QAClF,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,UAAU,CAAA;QAClF,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAY;QAC1B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QAC1E,OAAO,IAAI,CAAA;IACb,CAAC;IAED,sCAAsC;IACtC,MAAM,CAAC,OAAO,CAAC,IAAY;QACzB,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACvC,CAAC;IAED,mEAAmE;IACnE,MAAM,CAAC,SAAS,CAAC,KAAiB;QAChC,OAAO,aAAa,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACvE,CAAC;CACF"}

package/dist/src/repository/utils/PathUtils.d.ts

@@ -0,0 +1,23 @@
+export declare class PathUtils {
+    private constructor();
+    /** Concatenate path segments with `/`, collapsing duplicate separators. */
+    static join(...segments: string[]): string;
+    /** Collapse `..`/`.`, duplicate `/`, and unify separators to `/`. */
+    static normalize(p: string): string;
+    /** Last segment (filename including extension). */
+    static basename(p: string): string;
+    /**
+     * Filename extension including the leading dot (`.txt`), or `''` if
+     * the basename has no extension or is a dotfile.
+     */
+    static extname(p: string): string;
+    /** Parent directory of `p` (or `'.'` for bare basenames). */
+    static dirname(p: string): string;
+    /** Compute the relative path from `from` to `to`. */
+    static relative(from: string, to: string): string;
+    /** Whether `p` is an absolute path. */
+    static isAbsolute(p: string): boolean;
+    /** Strip the filename extension (`'foo.txt'` → `'foo'`). */
+    static stripExtension(p: string): string;
+}
+//# sourceMappingURL=PathUtils.d.ts.map

package/dist/src/repository/utils/PathUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathUtils.d.ts","sourceRoot":"","sources":["../../../../src/repository/utils/PathUtils.ts"],"names":[],"mappings":"AAWA,qBAAa,SAAS;IACpB,OAAO;IAEP,2EAA2E;IAC3E,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAI1C,qEAAqE;IACrE,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAInC,mDAAmD;IACnD,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIlC;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIjC,6DAA6D;IAC7D,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIjC,qDAAqD;IACrD,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM;IAIjD,uCAAuC;IACvC,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAIrC,4DAA4D;IAC5D,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;CAMzC"}

package/dist/src/repository/utils/PathUtils.js

@@ -0,0 +1,53 @@
+/**
+ * Static utility — pure path manipulation. Operates only on string
+ * tokens; no syscalls. Adopts forward-slash normalisation across
+ * platforms so XF artefacts can keep paths comparable.
+ *
+ * Built on top of `node:path/posix` so the behaviour is deterministic
+ * regardless of the host OS (Windows backslashes are normalised to
+ * forward slashes on input).
+ */
+import { posix } from 'node:path';
+export class PathUtils {
+    constructor() { }
+    /** Concatenate path segments with `/`, collapsing duplicate separators. */
+    static join(...segments) {
+        return posix.join(...segments.map(PathUtils.normalize));
+    }
+    /** Collapse `..`/`.`, duplicate `/`, and unify separators to `/`. */
+    static normalize(p) {
+        return posix.normalize(p.replace(/\\/g, '/'));
+    }
+    /** Last segment (filename including extension). */
+    static basename(p) {
+        return posix.basename(PathUtils.normalize(p));
+    }
+    /**
+     * Filename extension including the leading dot (`.txt`), or `''` if
+     * the basename has no extension or is a dotfile.
+     */
+    static extname(p) {
+        return posix.extname(PathUtils.normalize(p));
+    }
+    /** Parent directory of `p` (or `'.'` for bare basenames). */
+    static dirname(p) {
+        return posix.dirname(PathUtils.normalize(p));
+    }
+    /** Compute the relative path from `from` to `to`. */
+    static relative(from, to) {
+        return posix.relative(PathUtils.normalize(from), PathUtils.normalize(to));
+    }
+    /** Whether `p` is an absolute path. */
+    static isAbsolute(p) {
+        return posix.isAbsolute(PathUtils.normalize(p));
+    }
+    /** Strip the filename extension (`'foo.txt'` → `'foo'`). */
+    static stripExtension(p) {
+        const base = PathUtils.basename(p);
+        const ext = PathUtils.extname(base);
+        if (ext === '')
+            return base;
+        return base.slice(0, -ext.length);
+    }
+}
+//# sourceMappingURL=PathUtils.js.map

package/dist/src/repository/utils/PathUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathUtils.js","sourceRoot":"","sources":["../../../../src/repository/utils/PathUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAEjC,MAAM,OAAO,SAAS;IACpB,gBAAuB,CAAC;IAExB,2EAA2E;IAC3E,MAAM,CAAC,IAAI,CAAC,GAAG,QAAkB;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAA;IACzD,CAAC;IAED,qEAAqE;IACrE,MAAM,CAAC,SAAS,CAAC,CAAS;QACxB,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAA;IAC/C,CAAC;IAED,mDAAmD;IACnD,MAAM,CAAC,QAAQ,CAAC,CAAS;QACvB,OAAO,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/C,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,CAAS;QACtB,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9C,CAAC;IAED,6DAA6D;IAC7D,MAAM,CAAC,OAAO,CAAC,CAAS;QACtB,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9C,CAAC;IAED,qDAAqD;IACrD,MAAM,CAAC,QAAQ,CAAC,IAAY,EAAE,EAAU;QACtC,OAAO,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAA;IAC3E,CAAC;IAED,uCAAuC;IACvC,MAAM,CAAC,UAAU,CAAC,CAAS;QACzB,OAAO,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IACjD,CAAC;IAED,4DAA4D;IAC5D,MAAM,CAAC,cAAc,CAAC,CAAS;QAC7B,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;QAClC,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACnC,IAAI,GAAG,KAAK,EAAE;YAAE,OAAO,IAAI,CAAA;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACnC,CAAC;CACF"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@xfcfam/xf-fs",
+  "version": "0.1.0",
+  "description": "Filesystem Access Layer Generalization for the XF Architecture Model — encapsulates local-disk file operations (node:fs).",
+  "author": "XF Contributors",
+  "license": "MIT",
+  "homepage": "https://xfcfam.org",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xfcfam/lib-npm",
+    "directory": "packages/xf-fs"
+  },
+  "keywords": [
+    "xf",
+    "cfam",
+    "filesystem",
+    "fs",
+    "files",
+    "io"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@xfcfam/xf": "^0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}