@wener/common 2.0.2 → 2.0.3

package/lib/dayjs/resolveRelativeTime.test.js

@@ -0,0 +1,310 @@
+import dayjs from "dayjs";
+import quarterOfYear from "dayjs/plugin/quarterOfYear";
+import weekOfYear from "dayjs/plugin/weekOfYear";
+import { describe, expect, it } from "vitest";
+import { resolveRelativeTime } from "./resolveRelativeTime.js";
+dayjs.extend(quarterOfYear);
+dayjs.extend(weekOfYear);
+describe("resolveRelativeTime", function () {
+    var fixedDate = new Date("2024-03-15T14:30:45.123Z");
+    describe("basic cases", function () {
+        it("should handle \"now\"", function () {
+            var result = resolveRelativeTime("now", fixedDate);
+            expect(result).toEqual(fixedDate);
+        });
+        it("should handle \"now\" without reference date", function () {
+            var result = resolveRelativeTime("now", undefined);
+            expect(result).toBeInstanceOf(Date);
+        });
+    });
+    describe("subtraction operations", function () {
+        it("should subtract seconds", function () {
+            var result = resolveRelativeTime("now-30s", fixedDate);
+            var expected = dayjs(fixedDate).subtract(30, "second").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should subtract minutes", function () {
+            var result = resolveRelativeTime("now-15m", fixedDate);
+            var expected = dayjs(fixedDate).subtract(15, "minute").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should subtract hours", function () {
+            var result = resolveRelativeTime("now-2h", fixedDate);
+            var expected = dayjs(fixedDate).subtract(2, "hour").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should subtract days", function () {
+            var result = resolveRelativeTime("now-7d", fixedDate);
+            var expected = dayjs(fixedDate).subtract(7, "day").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should subtract weeks", function () {
+            var result = resolveRelativeTime("now-2w", fixedDate);
+            var expected = dayjs(fixedDate).subtract(2, "week").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should subtract months", function () {
+            var result = resolveRelativeTime("now-1M", fixedDate);
+            var expected = dayjs(fixedDate).subtract(1, "month").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should subtract quarters", function () {
+            var result = resolveRelativeTime("now-1Q", fixedDate);
+            var expected = dayjs(fixedDate).subtract(1, "quarter").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should subtract years", function () {
+            var result = resolveRelativeTime("now-1y", fixedDate);
+            var expected = dayjs(fixedDate).subtract(1, "year").toDate();
+            expect(result).toEqual(expected);
+        });
+    });
+    describe("addition operations", function () {
+        it("should add seconds", function () {
+            var result = resolveRelativeTime("now+30s", fixedDate);
+            var expected = dayjs(fixedDate).add(30, "second").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should add minutes", function () {
+            var result = resolveRelativeTime("now+15m", fixedDate);
+            var expected = dayjs(fixedDate).add(15, "minute").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should add hours", function () {
+            var result = resolveRelativeTime("now+3h", fixedDate);
+            var expected = dayjs(fixedDate).add(3, "hour").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should add days", function () {
+            var result = resolveRelativeTime("now+5d", fixedDate);
+            var expected = dayjs(fixedDate).add(5, "day").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should add weeks", function () {
+            var result = resolveRelativeTime("now+2w", fixedDate);
+            var expected = dayjs(fixedDate).add(2, "week").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should add months", function () {
+            var result = resolveRelativeTime("now+2M", fixedDate);
+            var expected = dayjs(fixedDate).add(2, "month").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should add quarters", function () {
+            var result = resolveRelativeTime("now+1Q", fixedDate);
+            var expected = dayjs(fixedDate).add(1, "quarter").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should add years", function () {
+            var result = resolveRelativeTime("now+1y", fixedDate);
+            var expected = dayjs(fixedDate).add(1, "year").toDate();
+            expect(result).toEqual(expected);
+        });
+    });
+    describe("truncation operations", function () {
+        it("should truncate to start of second", function () {
+            var result = resolveRelativeTime("now/s", fixedDate);
+            var expected = dayjs(fixedDate).startOf("second").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should truncate to start of minute", function () {
+            var result = resolveRelativeTime("now/m", fixedDate);
+            var expected = dayjs(fixedDate).startOf("minute").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should truncate to start of hour", function () {
+            var result = resolveRelativeTime("now/h", fixedDate);
+            var expected = dayjs(fixedDate).startOf("hour").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should truncate to start of day", function () {
+            var result = resolveRelativeTime("now/d", fixedDate);
+            var expected = dayjs(fixedDate).startOf("day").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should truncate to start of week", function () {
+            var result = resolveRelativeTime("now/w", fixedDate);
+            var expected = dayjs(fixedDate).startOf("week").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should truncate to start of month", function () {
+            var result = resolveRelativeTime("now/M", fixedDate);
+            var expected = dayjs(fixedDate).startOf("month").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should truncate to start of quarter", function () {
+            var result = resolveRelativeTime("now/Q", fixedDate);
+            var expected = dayjs(fixedDate).startOf("quarter").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should truncate to start of year", function () {
+            var result = resolveRelativeTime("now/y", fixedDate);
+            var expected = dayjs(fixedDate).startOf("year").toDate();
+            expect(result).toEqual(expected);
+        });
+    });
+    describe("endOf truncation operations (backslash)", function () {
+        it("should truncate to end of second", function () {
+            var result = resolveRelativeTime("now\\s", fixedDate);
+            var expected = dayjs(fixedDate).endOf("second").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should truncate to end of minute", function () {
+            var result = resolveRelativeTime("now\\m", fixedDate);
+            var expected = dayjs(fixedDate).endOf("minute").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should truncate to end of hour", function () {
+            var result = resolveRelativeTime("now\\h", fixedDate);
+            var expected = dayjs(fixedDate).endOf("hour").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should truncate to end of day", function () {
+            var result = resolveRelativeTime("now\\d", fixedDate);
+            var expected = dayjs(fixedDate).endOf("day").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should truncate to end of week", function () {
+            var result = resolveRelativeTime("now\\w", fixedDate);
+            var expected = dayjs(fixedDate).endOf("week").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should truncate to end of month", function () {
+            var result = resolveRelativeTime("now\\M", fixedDate);
+            var expected = dayjs(fixedDate).endOf("month").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should truncate to end of quarter", function () {
+            var result = resolveRelativeTime("now\\Q", fixedDate);
+            var expected = dayjs(fixedDate).endOf("quarter").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should truncate to end of year", function () {
+            var result = resolveRelativeTime("now\\y", fixedDate);
+            var expected = dayjs(fixedDate).endOf("year").toDate();
+            expect(result).toEqual(expected);
+        });
+    });
+    describe("complex combinations", function () {
+        it("should handle \"now-1M/M\" (start of previous month)", function () {
+            var result = resolveRelativeTime("now-1M/M", fixedDate);
+            var expected = dayjs(fixedDate).subtract(1, "month").startOf("month").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should handle \"now/d+1d-1s\" (end of current day)", function () {
+            var result = resolveRelativeTime("now/d+1d-1s", fixedDate);
+            var expected = dayjs(fixedDate).startOf("day").add(1, "day").subtract(1, "second").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should handle multiple operations \"now-1w+2d-3h\"", function () {
+            var result = resolveRelativeTime("now-1w+2d-3h", fixedDate);
+            var expected = dayjs(fixedDate).subtract(1, "week").add(2, "day").subtract(3, "hour").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should handle \"now-1M\\M\" (end of previous month)", function () {
+            var result = resolveRelativeTime("now-1M\\M", fixedDate);
+            var expected = dayjs(fixedDate).subtract(1, "month").endOf("month").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should handle \"now\\d\" vs \"now/d+1d-1s\" (both end of current day)", function () {
+            var resultBackslash = resolveRelativeTime("now\\d", fixedDate);
+            var resultAlternative = resolveRelativeTime("now/d+1d-1s", fixedDate);
+            var expectedBackslash = dayjs(fixedDate).endOf("day").toDate();
+            var expectedAlternative = dayjs(fixedDate).startOf("day").add(1, "day").subtract(1, "second").toDate();
+            expect(resultBackslash).toEqual(expectedBackslash);
+            expect(resultAlternative).toEqual(expectedAlternative);
+            // Note: endOf gives millisecond precision (.999), while alternative gives second precision (.000)
+            // Both represent end of day, but endOf is more precise
+            expect(resultBackslash.getTime()).toBeGreaterThan(resultAlternative.getTime());
+        });
+        it("should handle \"now-1y\\y\" (end of previous year)", function () {
+            var result = resolveRelativeTime("now-1y\\y", fixedDate);
+            var expected = dayjs(fixedDate).subtract(1, "year").endOf("year").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should handle \"now/y+6M\" (middle of current year)", function () {
+            var result = resolveRelativeTime("now/y+6M", fixedDate);
+            var expected = dayjs(fixedDate).startOf("year").add(6, "month").toDate();
+            expect(result).toEqual(expected);
+        });
+    });
+    describe("error cases", function () {
+        it("should throw error for invalid format", function () {
+            expect(function () {
+                return resolveRelativeTime("invalid", fixedDate);
+            }).toThrow("Invalid");
+        });
+        it("should throw error for non-now start", function () {
+            expect(function () {
+                return resolveRelativeTime("then-1h", fixedDate);
+            }).toThrow("Invalid");
+        });
+        it("should throw error for invalid time unit", function () {
+            expect(function () {
+                return resolveRelativeTime("now-1x", fixedDate);
+            }).toThrow("Invalid time operand");
+        });
+        it("should throw error for invalid operator", function () {
+            expect(function () {
+                return resolveRelativeTime("now*1h", fixedDate);
+            }).toThrow("Invalid relative time format");
+        });
+        it("should throw error for invalid truncation unit", function () {
+            expect(function () {
+                return resolveRelativeTime("now/z", fixedDate);
+            }).toThrow();
+        });
+        it("should throw error for incomplete operation", function () {
+            expect(function () {
+                return resolveRelativeTime("now-", fixedDate);
+            }).toThrow("Invalid relative time format");
+        });
+    });
+    describe("Grafana examples from comments", function () {
+        it("should handle \"now-24h\" (last 24 hours)", function () {
+            var result = resolveRelativeTime("now-24h", fixedDate);
+            var expected = dayjs(fixedDate).subtract(24, "hour").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should handle \"now/M\" (start of current month)", function () {
+            var result = resolveRelativeTime("now/M", fixedDate);
+            var expected = dayjs(fixedDate).startOf("month").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should handle \"now-7d\" (last 7 days)", function () {
+            var result = resolveRelativeTime("now-7d", fixedDate);
+            var expected = dayjs(fixedDate).subtract(7, "day").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should handle \"now/y\" (start of current year)", function () {
+            var result = resolveRelativeTime("now/y", fixedDate);
+            var expected = dayjs(fixedDate).startOf("year").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should handle \"now/w\" (start of current week)", function () {
+            var result = resolveRelativeTime("now/w", fixedDate);
+            var expected = dayjs(fixedDate).startOf("week").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should handle \"now\\d\" (end of current day)", function () {
+            var result = resolveRelativeTime("now\\d", fixedDate);
+            var expected = dayjs(fixedDate).endOf("day").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should handle \"now\\M\" (end of current month)", function () {
+            var result = resolveRelativeTime("now\\M", fixedDate);
+            var expected = dayjs(fixedDate).endOf("month").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should handle \"now\\w\" (end of current week)", function () {
+            var result = resolveRelativeTime("now\\w", fixedDate);
+            var expected = dayjs(fixedDate).endOf("week").toDate();
+            expect(result).toEqual(expected);
+        });
+        it("should handle \"now\\y\" (end of current year)", function () {
+            var result = resolveRelativeTime("now\\y", fixedDate);
+            var expected = dayjs(fixedDate).endOf("year").toDate();
+            expect(result).toEqual(expected);
+        });
+    });
+});

package/lib/decimal/index.js

@@ -1 +1,2 @@
 export { parseDecimal } from "./parseDecimal.js";
+//# sourceMappingURL=index.js.map

package/lib/decimal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/decimal/index.ts"],"sourcesContent":["export { parseDecimal } from './parseDecimal';\n"],"names":["parseDecimal"],"mappings":"AAAA,SAASA,YAAY,QAAQ,iBAAiB"}

package/lib/decimal/parseDecimal.js

@@ -1,4 +1,4 @@
-import Decimal from 'decimal.js';
+import Decimal from "decimal.js";
 export function parseDecimal(v) {
     switch(v){
         case '':
@@ -11,3 +11,5 @@ export function parseDecimal(v) {
     }
     return new Decimal(v);
 }
+
+//# sourceMappingURL=parseDecimal.js.map

package/lib/decimal/parseDecimal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/decimal/parseDecimal.ts"],"sourcesContent":["import Decimal from 'decimal.js';\n\nexport function parseDecimal(v: string | number | Decimal): Decimal;\nexport function parseDecimal(v: string | number | Decimal | undefined | null): Decimal | undefined;\nexport function parseDecimal(v: string | number | Decimal | undefined | null): Decimal | undefined {\n\tswitch (v) {\n\t\tcase '':\n\t\tcase undefined:\n\t\tcase null:\n\t\t\treturn undefined;\n\t}\n\tif (Decimal.isDecimal(v)) {\n\t\treturn v;\n\t}\n\treturn new Decimal(v);\n}\n"],"names":["Decimal","parseDecimal","v","undefined","isDecimal"],"mappings":"AAAA,OAAOA,aAAa,aAAa;AAIjC,OAAO,SAASC,aAAaC,CAA+C;IAC3E,OAAQA;QACP,KAAK;QACL,KAAKC;QACL,KAAK;YACJ,OAAOA;IACT;IACA,IAAIH,QAAQI,SAAS,CAACF,IAAI;QACzB,OAAOA;IACR;IACA,OAAO,IAAIF,QAAQE;AACpB"}

package/lib/emittery/emitter.js

@@ -0,0 +1,10 @@
+import Emittery from "emittery";
+export function createEmitter(name) {
+    return new Emittery({
+        debug: {
+            name
+        }
+    });
+}
+
+//# sourceMappingURL=emitter.js.map

package/lib/emittery/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/emittery/emitter.ts"],"sourcesContent":["import Emittery, { type EventName } from 'emittery';\n\nexport function createEmitter<EventData = Record<EventName, any>>(name: string) {\n\treturn new Emittery<EventData>({\n\t\tdebug: {\n\t\t\tname,\n\t\t},\n\t});\n}\n"],"names":["Emittery","createEmitter","name","debug"],"mappings":"AAAA,OAAOA,cAAkC,WAAW;AAEpD,OAAO,SAASC,cAAkDC,IAAY;IAC7E,OAAO,IAAIF,SAAoB;QAC9BG,OAAO;YACND;QACD;IACD;AACD"}

package/lib/emittery/index.js

@@ -0,0 +1,2 @@
+export { createEmitter } from "./emitter.js";
+//# sourceMappingURL=index.js.map

package/lib/emittery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/emittery/index.ts"],"sourcesContent":["export { createEmitter } from './emitter';\n"],"names":["createEmitter"],"mappings":"AAAA,SAASA,aAAa,QAAQ,YAAY"}

package/lib/foundation/schema/SexType.js

@@ -1,14 +1,16 @@
-import { z } from 'zod/v4';
+import { z } from "zod/v4";
 // Sex 指的是生理性别/生物性别，通常由出生时的生物特征决定
-export var SexType = Object.freeze({
+export const SexType = Object.freeze({
     __proto__: null,
     Male: 'Male',
     Female: 'Female'
 });
-export var SexTypeSchema = z.union([
+export const SexTypeSchema = z.union([
     //
     z.literal(SexType.Male).describe('男'),
     z.literal(SexType.Female).describe('女')
 ]).describe('性别').meta({
     title: 'SexType'
 });
+
+//# sourceMappingURL=SexType.js.map

package/lib/foundation/schema/SexType.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/foundation/schema/SexType.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport type { EnumValues } from '../../resource/schema';\n\n// Sex 指的是生理性别/生物性别，通常由出生时的生物特征决定\nexport const SexType = Object.freeze({\n\t__proto__: null,\n\tMale: 'Male',\n\tFemale: 'Female',\n});\nexport type SexType = EnumValues<typeof SexType>;\n\nexport const SexTypeSchema = z\n\t.union([\n\t\t//\n\t\tz.literal(SexType.Male).describe('男'),\n\t\tz.literal(SexType.Female).describe('女'),\n\t])\n\t.describe('性别')\n\t.meta({\n\t\ttitle: 'SexType',\n\t});\n"],"names":["z","SexType","Object","freeze","__proto__","Male","Female","SexTypeSchema","union","literal","describe","meta","title"],"mappings":"AAAA,SAASA,CAAC,QAAQ,SAAS;AAG3B,iCAAiC;AACjC,OAAO,MAAMC,UAAUC,OAAOC,MAAM,CAAC;IACpCC,WAAW;IACXC,MAAM;IACNC,QAAQ;AACT,GAAG;AAGH,OAAO,MAAMC,gBAAgBP,EAC3BQ,KAAK,CAAC;IACN,EAAE;IACFR,EAAES,OAAO,CAACR,QAAQI,IAAI,EAAEK,QAAQ,CAAC;IACjCV,EAAES,OAAO,CAACR,QAAQK,MAAM,EAAEI,QAAQ,CAAC;CACnC,EACAA,QAAQ,CAAC,MACTC,IAAI,CAAC;IACLC,OAAO;AACR,GAAG"}

package/lib/foundation/schema/index.js

@@ -1 +1,2 @@
 export { SexType, SexTypeSchema } from "./SexType.js";
+//# sourceMappingURL=index.js.map

package/lib/foundation/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/foundation/schema/index.ts"],"sourcesContent":["export { SexType, SexTypeSchema } from './SexType';\n"],"names":["SexType","SexTypeSchema"],"mappings":"AAAA,SAASA,OAAO,EAAEC,aAAa,QAAQ,YAAY"}

package/lib/foundation/schema/parseSexType.js

@@ -16,3 +16,4 @@ export function parseSexType(s) {
     }
     return undefined;
 }
+//# sourceMappingURL=parseSexType.js.map

package/lib/foundation/schema/parseSexType.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/foundation/schema/parseSexType.ts"],"sourcesContent":["import { SexType } from './SexType';\n\nexport function parseSexType(s: string | null | undefined): undefined | SexType {\n\tif (!s) return undefined;\n\n\tswitch (s.toLowerCase()) {\n\t\tcase '♂':\n\t\tcase '男':\n\t\tcase 'male':\n\t\tcase 'man':\n\t\t\treturn SexType.Male;\n\t\tcase '♀':\n\t\tcase '女':\n\t\tcase 'female':\n\t\tcase 'woman':\n\t\t\treturn SexType.Female;\n\t}\n\treturn undefined;\n}\n"],"names":["SexType","parseSexType","s","undefined","toLowerCase","Male","Female"],"mappings":"AAAA,SAASA,OAAO,QAAQ,YAAY;AAEpC,OAAO,SAASC,aAAaC,CAA4B;IACxD,IAAI,CAACA,GAAG,OAAOC;IAEf,OAAQD,EAAEE,WAAW;QACpB,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;YACJ,OAAOJ,QAAQK,IAAI;QACpB,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;YACJ,OAAOL,QAAQM,MAAM;IACvB;IACA,OAAOH;AACR"}

package/lib/foundation/schema/types.js

@@ -1,5 +1,7 @@
-import z from 'zod/v4';
-export var CoordinatesSchema = z.object({
+import z from "zod/v4";
+export const CoordinatesSchema = z.object({
     latitude: z.number().min(-90).max(90).describe('纬度'),
     longitude: z.number().min(-180).max(180).describe('经度')
 }).describe('坐标信息');
+
+//# sourceMappingURL=types.js.map

package/lib/foundation/schema/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/foundation/schema/types.ts"],"sourcesContent":["import z from 'zod/v4';\n\nexport const CoordinatesSchema = z\n\t.object({\n\t\tlatitude: z.number().min(-90).max(90).describe('纬度'),\n\t\tlongitude: z.number().min(-180).max(180).describe('经度'),\n\t})\n\t.describe('坐标信息');\n"],"names":["z","CoordinatesSchema","object","latitude","number","min","max","describe","longitude"],"mappings":"AAAA,OAAOA,OAAO,SAAS;AAEvB,OAAO,MAAMC,oBAAoBD,EAC/BE,MAAM,CAAC;IACPC,UAAUH,EAAEI,MAAM,GAAGC,GAAG,CAAC,CAAC,IAAIC,GAAG,CAAC,IAAIC,QAAQ,CAAC;IAC/CC,WAAWR,EAAEI,MAAM,GAAGC,GAAG,CAAC,CAAC,KAAKC,GAAG,CAAC,KAAKC,QAAQ,CAAC;AACnD,GACCA,QAAQ,CAAC,QAAQ"}

package/lib/fs/FileSystemError.js

@@ -0,0 +1,23 @@
+export const FileSystemErrorCode = {
+    ENOENT: 'ENOENT',
+    ENOTDIR: 'ENOTDIR',
+    EEXIST: 'EEXIST',
+    EISDIR: 'EISDIR',
+    ENOTEMPTY: 'ENOTEMPTY',
+    EACCES: 'EACCES',
+    EPERM: 'EPERM',
+    EINVAL: 'EINVAL'
+};
+export class FileSystemError extends Error {
+    code;
+    constructor(message, code){
+        super(message), this.code = code;
+        this.name = 'FileSystemError';
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, FileSystemError);
+        }
+    }
+}
+
+//# sourceMappingURL=FileSystemError.js.map

package/lib/fs/FileSystemError.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/fs/FileSystemError.ts"],"sourcesContent":["export const FileSystemErrorCode = {\n\tENOENT: 'ENOENT',\n\tENOTDIR: 'ENOTDIR',\n\tEEXIST: 'EEXIST',\n\tEISDIR: 'EISDIR',\n\tENOTEMPTY: 'ENOTEMPTY',\n\tEACCES: 'EACCES',\n\tEPERM: 'EPERM',\n\tEINVAL: 'EINVAL',\n} as const;\n\nexport type FileSystemErrorCode = (typeof FileSystemErrorCode)[keyof typeof FileSystemErrorCode];\n\nexport class FileSystemError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly code: FileSystemErrorCode | string,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = 'FileSystemError';\n\t\t// Maintains proper stack trace for where our error was thrown (only available on V8)\n\t\tif (Error.captureStackTrace) {\n\t\t\tError.captureStackTrace(this, FileSystemError);\n\t\t}\n\t}\n}\n"],"names":["FileSystemErrorCode","ENOENT","ENOTDIR","EEXIST","EISDIR","ENOTEMPTY","EACCES","EPERM","EINVAL","FileSystemError","Error","message","code","name","captureStackTrace"],"mappings":"AAAA,OAAO,MAAMA,sBAAsB;IAClCC,QAAQ;IACRC,SAAS;IACTC,QAAQ;IACRC,QAAQ;IACRC,WAAW;IACXC,QAAQ;IACRC,OAAO;IACPC,QAAQ;AACT,EAAW;AAIX,OAAO,MAAMC,wBAAwBC;;IACpC,YACCC,OAAe,EACf,AAAgBC,IAAkC,CACjD;QACD,KAAK,CAACD,eAFUC,OAAAA;QAGhB,IAAI,CAACC,IAAI,GAAG;QACZ,qFAAqF;QACrF,IAAIH,MAAMI,iBAAiB,EAAE;YAC5BJ,MAAMI,iBAAiB,CAAC,IAAI,EAAEL;QAC/B;IACD;AACD"}

package/lib/fs/IFileSystem.d.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=IFileSystem.d.js.map

package/lib/fs/IFileSystem.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/fs/IFileSystem.d.ts"],"sourcesContent":["import type { FileKind, FileUrlOptions } from './types';\n\n// Base operation options\ntype OperationOptions = {\n\tsignal?: AbortSignal;\n};\n\n// Directory operations\nexport type ReaddirOptions = OperationOptions & {\n\tglob?: string;\n\trecursive?: boolean;\n\tdepth?: number;\n\tkind?: FileKind;\n\thidden?: boolean;\n};\nexport type MkdirOptions = OperationOptions & {\n\trecursive?: boolean;\n};\n// File operations\nexport type ReadFileOptions = OperationOptions & {\n\tencoding?: 'text' | 'binary';\n\tonDownloadProgress?: (e: { loaded: number; total: number }) => void;\n};\nexport type WriteFileOptions = OperationOptions & {\n\toverwrite?: boolean;\n\tonUploadProgress?: (e: { loaded: number; total: number }) => void;\n};\nexport type RenameOptions = OperationOptions & {\n\toverwrite?: boolean;\n};\nexport type RmOptions = OperationOptions & {\n\trecursive?: boolean;\n\tforce?: boolean;\n};\nexport type CopyOptions = OperationOptions & {\n\toverwrite?: boolean;\n\tshallow?: boolean;\n};\nexport type CreateReadStreamOptions = OperationOptions & {\n\trange?: { start: number; end?: number };\n\tsignal?: AbortSignal;\n};\nexport type CreateWriteStreamOptions = OperationOptions & {\n\toverwrite?: boolean;\n};\nexport type StatOptions = OperationOptions & {};\n\ntype WritableData = string | ArrayBuffer | ArrayBufferView | ReadableStream;\n\n/**\n * Universal file system interface (browser & server compatible)\n */\nexport type IFileSystem = {\n\treaddir(dir: string, options?: ReaddirOptions): Promise<IFileStat[]>;\n\tstat(entry: string, options?: StatOptions): Promise<IFileStat>;\n\tmkdir(path: string, options?: MkdirOptions): Promise<void>;\n\treadFile(path: string, options?: ReadFileOptions & { encoding: 'text' }): Promise<string>;\n\treadFile(path: string, options?: ReadFileOptions): Promise<Uint8Array>;\n\twriteFile(path: string, data: WritableData, options?: WriteFileOptions): Promise<void>;\n\trm(path: string, options?: RmOptions): Promise<void>;\n\trename(oldPath: string, newPath: string, options?: RenameOptions): Promise<void>;\n\texists(path: string): Promise<boolean>;\n\tcopy(src: string, dest: string, options?: CopyOptions): Promise<void>;\n\n\tgetUrl?(path: IFileStat | string, options?: FileUrlOptions): string | undefined;\n\n\tcreateReadableStream?(path: string, options?: CreateReadStreamOptions): ReadableStream;\n\tcreateWritableStream?(path: string, options?: CreateWriteStreamOptions): WritableStream;\n};\n\n/**\n * Server/Node.js specific file system interface with stream support\n */\nexport type IServerFileSystem = IFileSystem & {\n\tcreateReadStream(path: string, options?: CreateReadStreamOptions): import('node:stream').Readable;\n\tcreateWriteStream(path: string, options?: CreateWriteStreamOptions): import('node:stream').Writable;\n\twriteFile(\n\t\tpath: string,\n\t\tdata: WritableData | Buffer | import('node:stream').Readable,\n\t\toptions?: WriteFileOptions,\n\t): Promise<void>;\n};\n\nexport type IFileStat = {\n\t/**\n\t * parent path\n\t */\n\tdirectory: string;\n\t/**\n\t * full path\n\t */\n\tpath: string;\n\t/**\n\t * basename\n\t */\n\tname: string;\n\tkind: 'directory' | 'file';\n\tmtime: number;\n\tmeta: Record<string, any>;\n\tsize: number;\n};\n\n"],"names":[],"mappings":"AAmFA,WAiBE"}

package/lib/fs/MemoryFileSystem.test.js

@@ -0,0 +1,188 @@
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    }
+    catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    }
+    else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function () {
+        var self = this, args = arguments;
+        return new Promise(function (resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function () {
+            if (t[0] & 1)
+                throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function () {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function (v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f)
+            throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _)
+            try {
+                if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done)
+                    return t;
+                if (y = 0, t)
+                    op = [
+                        op[0] & 2,
+                        t.value
+                    ];
+                switch (op[0]) {
+                    case 0:
+                    case 1:
+                        t = op;
+                        break;
+                    case 4:
+                        _.label++;
+                        return {
+                            value: op[1],
+                            done: false
+                        };
+                    case 5:
+                        _.label++;
+                        y = op[1];
+                        op = [
+                            0
+                        ];
+                        continue;
+                    case 7:
+                        op = _.ops.pop();
+                        _.trys.pop();
+                        continue;
+                    default:
+                        if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                            _ = 0;
+                            continue;
+                        }
+                        if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                            _.label = op[1];
+                            break;
+                        }
+                        if (op[0] === 6 && _.label < t[1]) {
+                            _.label = t[1];
+                            t = op;
+                            break;
+                        }
+                        if (t && _.label < t[2]) {
+                            _.label = t[2];
+                            _.ops.push(op);
+                            break;
+                        }
+                        if (t[2])
+                            _.ops.pop();
+                        _.trys.pop();
+                        continue;
+                }
+                op = body.call(thisArg, _);
+            }
+            catch (e) {
+                op = [
+                    6,
+                    e
+                ];
+                y = 0;
+            }
+            finally {
+                f = t = 0;
+            }
+        if (op[0] & 5)
+            throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+import { beforeEach, describe, test } from "vitest";
+import { createMemoryFileSystem } from "./createMemoryFileSystem.js";
+import { runFileSystemTest } from "./tests/runFileSystemTest.js";
+describe("MemoryFileSystem", function () {
+    var fs;
+    beforeEach(function () {
+        fs = createMemoryFileSystem({
+            root: {
+                path: "/",
+                directory: "",
+                name: "",
+                kind: "directory",
+                meta: {},
+                mtime: Date.now(),
+                size: 0,
+                children: [
+                    {
+                        path: "/README.txt",
+                        directory: "/",
+                        name: "README.txt",
+                        kind: "file",
+                        content: "Hello",
+                        size: 5,
+                        meta: {},
+                        mtime: Date.now()
+                    }
+                ]
+            }
+        });
+    });
+    test("common tests", function () {
+        return _async_to_generator(function () {
+            return _ts_generator(this, function (_state) {
+                switch (_state.label) {
+                    case 0:
+                        return [
+                            4,
+                            runFileSystemTest(fs)
+                        ];
+                    case 1:
+                        _state.sent();
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+});