@metamask/snaps-utils 8.0.1 → 8.1.1

package/dist/versions.d.cts

@@ -0,0 +1,22 @@
+import type { Json, SemVerVersion, SemVerRange } from "@metamask/utils";
+export declare const DEFAULT_REQUESTED_SNAP_VERSION: SemVerRange;
+/**
+ * Return the highest version in the list that satisfies the range, or `null` if
+ * none of them do. For the satisfaction check, pre-release versions will only
+ * be checked if no satisfactory non-prerelease version is found first.
+ *
+ * @param versions - The list of version to check.
+ * @param versionRange - The SemVer version range to check against.
+ * @returns The highest version in the list that satisfies the range,
+ * or `null` if none of them do.
+ */
+export declare function getTargetVersion(versions: SemVerVersion[], versionRange: SemVerRange): SemVerVersion | null;
+/**
+ * Parse a version received by some subject attempting to access a snap.
+ *
+ * @param version - The received version value.
+ * @returns `*` if the version is `undefined` or `latest", otherwise returns
+ * the specified version.
+ */
+export declare function resolveVersionRange(version?: Json): [error: undefined, range: SemVerRange] | [error: Error, range: undefined];
+//# sourceMappingURL=versions.d.cts.map

package/dist/versions.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.cts","sourceRoot":"","sources":["../src/versions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,wBAAwB;AAIxE,eAAO,MAAM,8BAA8B,aAAqB,CAAC;AAEjE;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,EAAE,EACzB,YAAY,EAAE,WAAW,GACxB,aAAa,GAAG,IAAI,CAetB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,IAAI,GACb,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAK3E"}

package/dist/versions.d.mts

@@ -0,0 +1,22 @@
+import type { Json, SemVerVersion, SemVerRange } from "@metamask/utils";
+export declare const DEFAULT_REQUESTED_SNAP_VERSION: SemVerRange;
+/**
+ * Return the highest version in the list that satisfies the range, or `null` if
+ * none of them do. For the satisfaction check, pre-release versions will only
+ * be checked if no satisfactory non-prerelease version is found first.
+ *
+ * @param versions - The list of version to check.
+ * @param versionRange - The SemVer version range to check against.
+ * @returns The highest version in the list that satisfies the range,
+ * or `null` if none of them do.
+ */
+export declare function getTargetVersion(versions: SemVerVersion[], versionRange: SemVerRange): SemVerVersion | null;
+/**
+ * Parse a version received by some subject attempting to access a snap.
+ *
+ * @param version - The received version value.
+ * @returns `*` if the version is `undefined` or `latest", otherwise returns
+ * the specified version.
+ */
+export declare function resolveVersionRange(version?: Json): [error: undefined, range: SemVerRange] | [error: Error, range: undefined];
+//# sourceMappingURL=versions.d.mts.map

package/dist/versions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.mts","sourceRoot":"","sources":["../src/versions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,wBAAwB;AAIxE,eAAO,MAAM,8BAA8B,aAAqB,CAAC;AAEjE;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,EAAE,EACzB,YAAY,EAAE,WAAW,GACxB,aAAa,GAAG,IAAI,CAetB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,IAAI,GACb,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAK3E"}

package/dist/versions.mjs

@@ -1,12 +1,39 @@
-import {
-  DEFAULT_REQUESTED_SNAP_VERSION,
-  getTargetVersion,
-  resolveVersionRange
-} from "./chunk-N5HVDE3P.mjs";
-import "./chunk-3RUWAMJT.mjs";
-export {
-  DEFAULT_REQUESTED_SNAP_VERSION,
-  getTargetVersion,
-  resolveVersionRange
-};
+import { validate } from "@metamask/superstruct";
+import { VersionRangeStruct } from "@metamask/utils";
+import { maxSatisfying as maxSatisfyingSemver } from "semver";
+export const DEFAULT_REQUESTED_SNAP_VERSION = '*';
+/**
+ * Return the highest version in the list that satisfies the range, or `null` if
+ * none of them do. For the satisfaction check, pre-release versions will only
+ * be checked if no satisfactory non-prerelease version is found first.
+ *
+ * @param versions - The list of version to check.
+ * @param versionRange - The SemVer version range to check against.
+ * @returns The highest version in the list that satisfies the range,
+ * or `null` if none of them do.
+ */
+export function getTargetVersion(versions, versionRange) {
+    const maxSatisfyingNonPreRelease = maxSatisfyingSemver(versions, versionRange);
+    // By default don't use pre-release versions
+    if (maxSatisfyingNonPreRelease) {
+        return maxSatisfyingNonPreRelease;
+    }
+    // If no satisfying release version is found by default, try pre-release versions
+    return maxSatisfyingSemver(versions, versionRange, {
+        includePrerelease: true,
+    });
+}
+/**
+ * Parse a version received by some subject attempting to access a snap.
+ *
+ * @param version - The received version value.
+ * @returns `*` if the version is `undefined` or `latest", otherwise returns
+ * the specified version.
+ */
+export function resolveVersionRange(version) {
+    if (version === undefined || version === 'latest') {
+        return [undefined, DEFAULT_REQUESTED_SNAP_VERSION];
+    }
+    return validate(version, VersionRangeStruct);
+}
 //# sourceMappingURL=versions.mjs.map

package/dist/versions.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"versions.mjs","sourceRoot":"","sources":["../src/versions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,8BAA8B;AAEjD,OAAO,EAAE,kBAAkB,EAAE,wBAAwB;AACrD,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,eAAe;AAE9D,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAkB,CAAC;AAEjE;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAyB,EACzB,YAAyB;IAEzB,MAAM,0BAA0B,GAAG,mBAAmB,CACpD,QAAQ,EACR,YAAY,CACb,CAAC;IAEF,4CAA4C;IAC5C,IAAI,0BAA0B,EAAE,CAAC;QAC/B,OAAO,0BAA0B,CAAC;IACpC,CAAC;IAED,iFAAiF;IACjF,OAAO,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE;QACjD,iBAAiB,EAAE,IAAI;KACxB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAc;IAEd,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QAClD,OAAO,CAAC,SAAS,EAAE,8BAA8B,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;AAC/C,CAAC","sourcesContent":["import { validate } from '@metamask/superstruct';\nimport type { Json, SemVerVersion, SemVerRange } from '@metamask/utils';\nimport { VersionRangeStruct } from '@metamask/utils';\nimport { maxSatisfying as maxSatisfyingSemver } from 'semver';\n\nexport const DEFAULT_REQUESTED_SNAP_VERSION = '*' as SemVerRange;\n\n/**\n * Return the highest version in the list that satisfies the range, or `null` if\n * none of them do. For the satisfaction check, pre-release versions will only\n * be checked if no satisfactory non-prerelease version is found first.\n *\n * @param versions - The list of version to check.\n * @param versionRange - The SemVer version range to check against.\n * @returns The highest version in the list that satisfies the range,\n * or `null` if none of them do.\n */\nexport function getTargetVersion(\n  versions: SemVerVersion[],\n  versionRange: SemVerRange,\n): SemVerVersion | null {\n  const maxSatisfyingNonPreRelease = maxSatisfyingSemver(\n    versions,\n    versionRange,\n  );\n\n  // By default don't use pre-release versions\n  if (maxSatisfyingNonPreRelease) {\n    return maxSatisfyingNonPreRelease;\n  }\n\n  // If no satisfying release version is found by default, try pre-release versions\n  return maxSatisfyingSemver(versions, versionRange, {\n    includePrerelease: true,\n  });\n}\n\n/**\n * Parse a version received by some subject attempting to access a snap.\n *\n * @param version - The received version value.\n * @returns `*` if the version is `undefined` or `latest\", otherwise returns\n * the specified version.\n */\nexport function resolveVersionRange(\n  version?: Json,\n): [error: undefined, range: SemVerRange] | [error: Error, range: undefined] {\n  if (version === undefined || version === 'latest') {\n    return [undefined, DEFAULT_REQUESTED_SNAP_VERSION];\n  }\n  return validate(version, VersionRangeStruct);\n}\n"]}

package/dist/virtual-file/VirtualFile.cjs

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VirtualFile = void 0;
+// TODO(ritave): Move into separate package @metamask/vfile / @metamask/utils + @metamask/to-vfile when passes code review
+// TODO(ritave): Streaming vfile contents similar to vinyl maybe?
+// TODO(ritave): Move fixing manifest in cli and bundler plugins to write messages to vfile
+//               similar to unified instead of throwing "ProgrammaticallyFixableErrors".
+//
+// Using https://github.com/vfile/vfile would be helpful, but they only support ESM and we need to support CommonJS.
+// https://github.com/gulpjs/vinyl is also good, but they normalize paths, which we can't do, because
+// we're calculating checksums based on original path.
+const utils_1 = require("@metamask/utils");
+const base_1 = require("@scure/base");
+const deep_clone_1 = require("../deep-clone.cjs");
+class VirtualFile {
+    constructor(value) {
+        let options;
+        if (typeof value === 'string' || value instanceof Uint8Array) {
+            options = { value };
+        }
+        else {
+            options = value;
+        }
+        this.value = options?.value ?? '';
+        // This situations happens when there's no .result used,
+        // we expect the file to have default generic in that situation:
+        // VirtualFile<unknown> which will handle undefined properly
+        //
+        // While not 100% type safe, it'll be way less frustrating to work with.
+        // The alternative would be to have VirtualFile.result be Result | undefined
+        // and that would result in needing to branch out and check in all situations.
+        //
+        // In short, optimizing for most common use case.
+        this.result = options?.result ?? undefined;
+        this.data = options?.data ?? {};
+        this.path = options?.path ?? '/';
+    }
+    get size() {
+        return typeof this.value === 'string'
+            ? this.value.length
+            : this.value.byteLength;
+    }
+    toString(encoding) {
+        if (typeof this.value === 'string') {
+            (0, utils_1.assert)(encoding === undefined, 'Tried to encode string.');
+            return this.value;
+        }
+        else if (this.value instanceof Uint8Array && encoding === 'hex') {
+            return (0, utils_1.bytesToHex)(this.value);
+        }
+        else if (this.value instanceof Uint8Array && encoding === 'base64') {
+            // For large files, this is quite slow, instead use `encodeBase64()`
+            // TODO: Use @metamask/utils for this
+            return base_1.base64.encode(this.value);
+        }
+        const decoder = new TextDecoder(encoding);
+        return decoder.decode(this.value);
+    }
+    clone() {
+        const vfile = new VirtualFile();
+        if (typeof this.value === 'string') {
+            vfile.value = this.value;
+        }
+        else {
+            // deep-clone doesn't clone Buffer properly, even if it's a sub-class of Uint8Array
+            vfile.value = this.value.slice(0);
+        }
+        vfile.result = (0, deep_clone_1.deepClone)(this.result);
+        vfile.data = (0, deep_clone_1.deepClone)(this.data);
+        vfile.path = this.path;
+        return vfile;
+    }
+}
+exports.VirtualFile = VirtualFile;
+//# sourceMappingURL=VirtualFile.cjs.map

package/dist/virtual-file/VirtualFile.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualFile.cjs","sourceRoot":"","sources":["../../src/virtual-file/VirtualFile.ts"],"names":[],"mappings":";;;AAAA,0HAA0H;AAC1H,iEAAiE;AACjE,2FAA2F;AAC3F,wFAAwF;AACxF,EAAE;AACF,oHAAoH;AACpH,qGAAqG;AACrG,sDAAsD;AACtD,2CAAqD;AACrD,sCAAqC;AAErC,kDAA0C;AA+B1C,MAAa,WAAW;IACtB,YAAY,KAA0B;QACpC,IAAI,OAA4B,CAAC;QACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;YAC7D,OAAO,GAAG,EAAE,KAAK,EAAE,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;QAClC,wDAAwD;QACxD,gEAAgE;QAChE,4DAA4D;QAC5D,EAAE;QACF,wEAAwE;QACxE,4EAA4E;QAC5E,8EAA8E;QAC9E,EAAE;QACF,iDAAiD;QACjD,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,IAAK,SAAiB,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,GAAG,CAAC;IACnC,CAAC;IAUD,IAAI,IAAI;QACN,OAAO,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;YACnC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM;YACnB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;IAC5B,CAAC;IAED,QAAQ,CAAC,QAAiB;QACxB,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACnC,IAAA,cAAM,EAAC,QAAQ,KAAK,SAAS,EAAE,yBAAyB,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,YAAY,UAAU,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YAClE,OAAO,IAAA,kBAAU,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,YAAY,UAAU,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACrE,oEAAoE;YACpE,qCAAqC;YACrC,OAAO,aAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC1C,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK;QACH,MAAM,KAAK,GAAG,IAAI,WAAW,EAAU,CAAC;QACxC,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACnC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,mFAAmF;YACnF,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC;QACD,KAAK,CAAC,MAAM,GAAG,IAAA,sBAAS,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,GAAG,IAAA,sBAAS,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAlED,kCAkEC","sourcesContent":["// TODO(ritave): Move into separate package @metamask/vfile / @metamask/utils + @metamask/to-vfile when passes code review\n// TODO(ritave): Streaming vfile contents similar to vinyl maybe?\n// TODO(ritave): Move fixing manifest in cli and bundler plugins to write messages to vfile\n//               similar to unified instead of throwing \"ProgrammaticallyFixableErrors\".\n//\n// Using https://github.com/vfile/vfile would be helpful, but they only support ESM and we need to support CommonJS.\n// https://github.com/gulpjs/vinyl is also good, but they normalize paths, which we can't do, because\n// we're calculating checksums based on original path.\nimport { assert, bytesToHex } from '@metamask/utils';\nimport { base64 } from '@scure/base';\n\nimport { deepClone } from '../deep-clone';\n\n/**\n * This map registers the type of the {@link VirtualFile.data} key of a {@link VirtualFile}.\n *\n * This type can be augmented to register custom `data` types.\n *\n * @example\n * declare module '@metamask/snaps-utils' {\n *   interface DataMap {\n *     // `file.data.name` is typed as `string`\n *     name: string\n *   }\n * }\n */\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions, @typescript-eslint/no-empty-interface\nexport interface DataMap {}\n\nexport type Value = string | Uint8Array;\nexport type Compatible<Result = unknown> =\n  | string\n  | Uint8Array\n  | Options<Result>;\nexport type Data = Record<string, unknown> & Partial<DataMap>;\nexport type Options<Result = unknown> = {\n  value: Value;\n  path?: string;\n  data?: Data;\n  result?: Result;\n};\n\nexport class VirtualFile<Result = unknown> {\n  constructor(value?: Compatible<Result>) {\n    let options: Options | undefined;\n    if (typeof value === 'string' || value instanceof Uint8Array) {\n      options = { value };\n    } else {\n      options = value;\n    }\n\n    this.value = options?.value ?? '';\n    // This situations happens when there's no .result used,\n    // we expect the file to have default generic in that situation:\n    // VirtualFile<unknown> which will handle undefined properly\n    //\n    // While not 100% type safe, it'll be way less frustrating to work with.\n    // The alternative would be to have VirtualFile.result be Result | undefined\n    // and that would result in needing to branch out and check in all situations.\n    //\n    // In short, optimizing for most common use case.\n    this.result = options?.result ?? (undefined as any);\n    this.data = options?.data ?? {};\n    this.path = options?.path ?? '/';\n  }\n\n  value: Value;\n\n  result: Result;\n\n  data: Data;\n\n  path: string;\n\n  get size() {\n    return typeof this.value === 'string'\n      ? this.value.length\n      : this.value.byteLength;\n  }\n\n  toString(encoding?: string) {\n    if (typeof this.value === 'string') {\n      assert(encoding === undefined, 'Tried to encode string.');\n      return this.value;\n    } else if (this.value instanceof Uint8Array && encoding === 'hex') {\n      return bytesToHex(this.value);\n    } else if (this.value instanceof Uint8Array && encoding === 'base64') {\n      // For large files, this is quite slow, instead use `encodeBase64()`\n      // TODO: Use @metamask/utils for this\n      return base64.encode(this.value);\n    }\n    const decoder = new TextDecoder(encoding);\n    return decoder.decode(this.value);\n  }\n\n  clone() {\n    const vfile = new VirtualFile<Result>();\n    if (typeof this.value === 'string') {\n      vfile.value = this.value;\n    } else {\n      // deep-clone doesn't clone Buffer properly, even if it's a sub-class of Uint8Array\n      vfile.value = this.value.slice(0);\n    }\n    vfile.result = deepClone(this.result);\n    vfile.data = deepClone(this.data);\n    vfile.path = this.path;\n    return vfile;\n  }\n}\n"]}

package/dist/virtual-file/VirtualFile.d.cts

@@ -0,0 +1,35 @@
+/**
+ * This map registers the type of the {@link VirtualFile.data} key of a {@link VirtualFile}.
+ *
+ * This type can be augmented to register custom `data` types.
+ *
+ * @example
+ * declare module '@metamask/snaps-utils' {
+ *   interface DataMap {
+ *     // `file.data.name` is typed as `string`
+ *     name: string
+ *   }
+ * }
+ */
+export interface DataMap {
+}
+export type Value = string | Uint8Array;
+export type Compatible<Result = unknown> = string | Uint8Array | Options<Result>;
+export type Data = Record<string, unknown> & Partial<DataMap>;
+export type Options<Result = unknown> = {
+    value: Value;
+    path?: string;
+    data?: Data;
+    result?: Result;
+};
+export declare class VirtualFile<Result = unknown> {
+    constructor(value?: Compatible<Result>);
+    value: Value;
+    result: Result;
+    data: Data;
+    path: string;
+    get size(): number;
+    toString(encoding?: string): string;
+    clone(): VirtualFile<Result>;
+}
+//# sourceMappingURL=VirtualFile.d.cts.map

package/dist/virtual-file/VirtualFile.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualFile.d.cts","sourceRoot":"","sources":["../../src/virtual-file/VirtualFile.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,OAAO;CAAG;AAE3B,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AACxC,MAAM,MAAM,UAAU,CAAC,MAAM,GAAG,OAAO,IACnC,MAAM,GACN,UAAU,GACV,OAAO,CAAC,MAAM,CAAC,CAAC;AACpB,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAC9D,MAAM,MAAM,OAAO,CAAC,MAAM,GAAG,OAAO,IAAI;IACtC,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qBAAa,WAAW,CAAC,MAAM,GAAG,OAAO;gBAC3B,KAAK,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC;IAuBtC,KAAK,EAAE,KAAK,CAAC;IAEb,MAAM,EAAE,MAAM,CAAC;IAEf,IAAI,EAAE,IAAI,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,IAAI,WAIP;IAED,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM;IAe1B,KAAK;CAaN"}

package/dist/virtual-file/VirtualFile.d.mts

@@ -0,0 +1,35 @@
+/**
+ * This map registers the type of the {@link VirtualFile.data} key of a {@link VirtualFile}.
+ *
+ * This type can be augmented to register custom `data` types.
+ *
+ * @example
+ * declare module '@metamask/snaps-utils' {
+ *   interface DataMap {
+ *     // `file.data.name` is typed as `string`
+ *     name: string
+ *   }
+ * }
+ */
+export interface DataMap {
+}
+export type Value = string | Uint8Array;
+export type Compatible<Result = unknown> = string | Uint8Array | Options<Result>;
+export type Data = Record<string, unknown> & Partial<DataMap>;
+export type Options<Result = unknown> = {
+    value: Value;
+    path?: string;
+    data?: Data;
+    result?: Result;
+};
+export declare class VirtualFile<Result = unknown> {
+    constructor(value?: Compatible<Result>);
+    value: Value;
+    result: Result;
+    data: Data;
+    path: string;
+    get size(): number;
+    toString(encoding?: string): string;
+    clone(): VirtualFile<Result>;
+}
+//# sourceMappingURL=VirtualFile.d.mts.map

package/dist/virtual-file/VirtualFile.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualFile.d.mts","sourceRoot":"","sources":["../../src/virtual-file/VirtualFile.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,OAAO;CAAG;AAE3B,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AACxC,MAAM,MAAM,UAAU,CAAC,MAAM,GAAG,OAAO,IACnC,MAAM,GACN,UAAU,GACV,OAAO,CAAC,MAAM,CAAC,CAAC;AACpB,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAC9D,MAAM,MAAM,OAAO,CAAC,MAAM,GAAG,OAAO,IAAI;IACtC,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qBAAa,WAAW,CAAC,MAAM,GAAG,OAAO;gBAC3B,KAAK,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC;IAuBtC,KAAK,EAAE,KAAK,CAAC;IAEb,MAAM,EAAE,MAAM,CAAC;IAEf,IAAI,EAAE,IAAI,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,IAAI,WAIP;IAED,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM;IAe1B,KAAK;CAaN"}

package/dist/virtual-file/VirtualFile.mjs

@@ -1,9 +1,71 @@
-import {
-  VirtualFile
-} from "../chunk-DE22V5AO.mjs";
-import "../chunk-Z2JQNSVL.mjs";
-import "../chunk-3RUWAMJT.mjs";
-export {
-  VirtualFile
-};
+// TODO(ritave): Move into separate package @metamask/vfile / @metamask/utils + @metamask/to-vfile when passes code review
+// TODO(ritave): Streaming vfile contents similar to vinyl maybe?
+// TODO(ritave): Move fixing manifest in cli and bundler plugins to write messages to vfile
+//               similar to unified instead of throwing "ProgrammaticallyFixableErrors".
+//
+// Using https://github.com/vfile/vfile would be helpful, but they only support ESM and we need to support CommonJS.
+// https://github.com/gulpjs/vinyl is also good, but they normalize paths, which we can't do, because
+// we're calculating checksums based on original path.
+import { assert, bytesToHex } from "@metamask/utils";
+import { base64 } from "@scure/base";
+import { deepClone } from "../deep-clone.mjs";
+export class VirtualFile {
+    constructor(value) {
+        let options;
+        if (typeof value === 'string' || value instanceof Uint8Array) {
+            options = { value };
+        }
+        else {
+            options = value;
+        }
+        this.value = options?.value ?? '';
+        // This situations happens when there's no .result used,
+        // we expect the file to have default generic in that situation:
+        // VirtualFile<unknown> which will handle undefined properly
+        //
+        // While not 100% type safe, it'll be way less frustrating to work with.
+        // The alternative would be to have VirtualFile.result be Result | undefined
+        // and that would result in needing to branch out and check in all situations.
+        //
+        // In short, optimizing for most common use case.
+        this.result = options?.result ?? undefined;
+        this.data = options?.data ?? {};
+        this.path = options?.path ?? '/';
+    }
+    get size() {
+        return typeof this.value === 'string'
+            ? this.value.length
+            : this.value.byteLength;
+    }
+    toString(encoding) {
+        if (typeof this.value === 'string') {
+            assert(encoding === undefined, 'Tried to encode string.');
+            return this.value;
+        }
+        else if (this.value instanceof Uint8Array && encoding === 'hex') {
+            return bytesToHex(this.value);
+        }
+        else if (this.value instanceof Uint8Array && encoding === 'base64') {
+            // For large files, this is quite slow, instead use `encodeBase64()`
+            // TODO: Use @metamask/utils for this
+            return base64.encode(this.value);
+        }
+        const decoder = new TextDecoder(encoding);
+        return decoder.decode(this.value);
+    }
+    clone() {
+        const vfile = new VirtualFile();
+        if (typeof this.value === 'string') {
+            vfile.value = this.value;
+        }
+        else {
+            // deep-clone doesn't clone Buffer properly, even if it's a sub-class of Uint8Array
+            vfile.value = this.value.slice(0);
+        }
+        vfile.result = deepClone(this.result);
+        vfile.data = deepClone(this.data);
+        vfile.path = this.path;
+        return vfile;
+    }
+}
 //# sourceMappingURL=VirtualFile.mjs.map

package/dist/virtual-file/VirtualFile.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"VirtualFile.mjs","sourceRoot":"","sources":["../../src/virtual-file/VirtualFile.ts"],"names":[],"mappings":"AAAA,0HAA0H;AAC1H,iEAAiE;AACjE,2FAA2F;AAC3F,wFAAwF;AACxF,EAAE;AACF,oHAAoH;AACpH,qGAAqG;AACrG,sDAAsD;AACtD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,wBAAwB;AACrD,OAAO,EAAE,MAAM,EAAE,oBAAoB;AAErC,OAAO,EAAE,SAAS,EAAE,0BAAsB;AA+B1C,MAAM,OAAO,WAAW;IACtB,YAAY,KAA0B;QACpC,IAAI,OAA4B,CAAC;QACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;YAC7D,OAAO,GAAG,EAAE,KAAK,EAAE,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;QAClC,wDAAwD;QACxD,gEAAgE;QAChE,4DAA4D;QAC5D,EAAE;QACF,wEAAwE;QACxE,4EAA4E;QAC5E,8EAA8E;QAC9E,EAAE;QACF,iDAAiD;QACjD,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,IAAK,SAAiB,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,GAAG,CAAC;IACnC,CAAC;IAUD,IAAI,IAAI;QACN,OAAO,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;YACnC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM;YACnB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;IAC5B,CAAC;IAED,QAAQ,CAAC,QAAiB;QACxB,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,yBAAyB,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,YAAY,UAAU,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YAClE,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,YAAY,UAAU,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACrE,oEAAoE;YACpE,qCAAqC;YACrC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC1C,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK;QACH,MAAM,KAAK,GAAG,IAAI,WAAW,EAAU,CAAC;QACxC,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACnC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,mFAAmF;YACnF,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC;QACD,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;CACF","sourcesContent":["// TODO(ritave): Move into separate package @metamask/vfile / @metamask/utils + @metamask/to-vfile when passes code review\n// TODO(ritave): Streaming vfile contents similar to vinyl maybe?\n// TODO(ritave): Move fixing manifest in cli and bundler plugins to write messages to vfile\n//               similar to unified instead of throwing \"ProgrammaticallyFixableErrors\".\n//\n// Using https://github.com/vfile/vfile would be helpful, but they only support ESM and we need to support CommonJS.\n// https://github.com/gulpjs/vinyl is also good, but they normalize paths, which we can't do, because\n// we're calculating checksums based on original path.\nimport { assert, bytesToHex } from '@metamask/utils';\nimport { base64 } from '@scure/base';\n\nimport { deepClone } from '../deep-clone';\n\n/**\n * This map registers the type of the {@link VirtualFile.data} key of a {@link VirtualFile}.\n *\n * This type can be augmented to register custom `data` types.\n *\n * @example\n * declare module '@metamask/snaps-utils' {\n *   interface DataMap {\n *     // `file.data.name` is typed as `string`\n *     name: string\n *   }\n * }\n */\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions, @typescript-eslint/no-empty-interface\nexport interface DataMap {}\n\nexport type Value = string | Uint8Array;\nexport type Compatible<Result = unknown> =\n  | string\n  | Uint8Array\n  | Options<Result>;\nexport type Data = Record<string, unknown> & Partial<DataMap>;\nexport type Options<Result = unknown> = {\n  value: Value;\n  path?: string;\n  data?: Data;\n  result?: Result;\n};\n\nexport class VirtualFile<Result = unknown> {\n  constructor(value?: Compatible<Result>) {\n    let options: Options | undefined;\n    if (typeof value === 'string' || value instanceof Uint8Array) {\n      options = { value };\n    } else {\n      options = value;\n    }\n\n    this.value = options?.value ?? '';\n    // This situations happens when there's no .result used,\n    // we expect the file to have default generic in that situation:\n    // VirtualFile<unknown> which will handle undefined properly\n    //\n    // While not 100% type safe, it'll be way less frustrating to work with.\n    // The alternative would be to have VirtualFile.result be Result | undefined\n    // and that would result in needing to branch out and check in all situations.\n    //\n    // In short, optimizing for most common use case.\n    this.result = options?.result ?? (undefined as any);\n    this.data = options?.data ?? {};\n    this.path = options?.path ?? '/';\n  }\n\n  value: Value;\n\n  result: Result;\n\n  data: Data;\n\n  path: string;\n\n  get size() {\n    return typeof this.value === 'string'\n      ? this.value.length\n      : this.value.byteLength;\n  }\n\n  toString(encoding?: string) {\n    if (typeof this.value === 'string') {\n      assert(encoding === undefined, 'Tried to encode string.');\n      return this.value;\n    } else if (this.value instanceof Uint8Array && encoding === 'hex') {\n      return bytesToHex(this.value);\n    } else if (this.value instanceof Uint8Array && encoding === 'base64') {\n      // For large files, this is quite slow, instead use `encodeBase64()`\n      // TODO: Use @metamask/utils for this\n      return base64.encode(this.value);\n    }\n    const decoder = new TextDecoder(encoding);\n    return decoder.decode(this.value);\n  }\n\n  clone() {\n    const vfile = new VirtualFile<Result>();\n    if (typeof this.value === 'string') {\n      vfile.value = this.value;\n    } else {\n      // deep-clone doesn't clone Buffer properly, even if it's a sub-class of Uint8Array\n      vfile.value = this.value.slice(0);\n    }\n    vfile.result = deepClone(this.result);\n    vfile.data = deepClone(this.data);\n    vfile.path = this.path;\n    return vfile;\n  }\n}\n"]}

package/dist/virtual-file/index.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./VirtualFile.cjs"), exports);
+//# sourceMappingURL=index.cjs.map

package/dist/virtual-file/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/virtual-file/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAA8B","sourcesContent":["export * from './VirtualFile';\n"]}

package/dist/virtual-file/index.d.cts

@@ -0,0 +1,2 @@
+export * from "./VirtualFile.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/virtual-file/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/virtual-file/index.ts"],"names":[],"mappings":"AAAA,kCAA8B"}

package/dist/virtual-file/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./VirtualFile.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/virtual-file/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/virtual-file/index.ts"],"names":[],"mappings":"AAAA,kCAA8B"}

package/dist/virtual-file/index.mjs

@@ -1,10 +1,2 @@
-import "../chunk-HYF7Q6VY.mjs";
-import {
-  VirtualFile
-} from "../chunk-DE22V5AO.mjs";
-import "../chunk-Z2JQNSVL.mjs";
-import "../chunk-3RUWAMJT.mjs";
-export {
-  VirtualFile
-};
+export * from "./VirtualFile.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/virtual-file/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/virtual-file/index.ts"],"names":[],"mappings":"AAAA,kCAA8B","sourcesContent":["export * from './VirtualFile';\n"]}

package/dist/virtual-file/node.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./index.cjs"), exports);
+__exportStar(require("./toVirtualFile.cjs"), exports);
+//# sourceMappingURL=node.cjs.map

package/dist/virtual-file/node.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.cjs","sourceRoot":"","sources":["../../src/virtual-file/node.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAAkB;AAClB,sDAAgC","sourcesContent":["export * from '.';\nexport * from './toVirtualFile';\n"]}

package/dist/virtual-file/node.d.cts

@@ -0,0 +1,3 @@
+export * from "./index.cjs";
+export * from "./toVirtualFile.cjs";
+//# sourceMappingURL=node.d.cts.map

package/dist/virtual-file/node.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.cts","sourceRoot":"","sources":["../../src/virtual-file/node.ts"],"names":[],"mappings":"AAAA,4BAAkB;AAClB,oCAAgC"}

package/dist/virtual-file/node.d.mts

@@ -0,0 +1,3 @@
+export * from "./index.mjs";
+export * from "./toVirtualFile.mjs";
+//# sourceMappingURL=node.d.mts.map

package/dist/virtual-file/node.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.mts","sourceRoot":"","sources":["../../src/virtual-file/node.ts"],"names":[],"mappings":"AAAA,4BAAkB;AAClB,oCAAgC"}

package/dist/virtual-file/node.mjs

@@ -1,17 +1,3 @@
-import "../chunk-RAZ7XG4Z.mjs";
-import {
-  readVirtualFile,
-  writeVirtualFile
-} from "../chunk-XZNJFDBF.mjs";
-import "../chunk-HYF7Q6VY.mjs";
-import {
-  VirtualFile
-} from "../chunk-DE22V5AO.mjs";
-import "../chunk-Z2JQNSVL.mjs";
-import "../chunk-3RUWAMJT.mjs";
-export {
-  VirtualFile,
-  readVirtualFile,
-  writeVirtualFile
-};
+export * from "./index.mjs";
+export * from "./toVirtualFile.mjs";
 //# sourceMappingURL=node.mjs.map

package/dist/virtual-file/node.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"node.mjs","sourceRoot":"","sources":["../../src/virtual-file/node.ts"],"names":[],"mappings":"AAAA,4BAAkB;AAClB,oCAAgC","sourcesContent":["export * from '.';\nexport * from './toVirtualFile';\n"]}

package/dist/virtual-file/toVirtualFile.cjs

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeVirtualFile = exports.readVirtualFile = void 0;
+const fs_1 = require("fs");
+const VirtualFile_1 = require("./VirtualFile.cjs");
+/**
+ * Reads a file from filesystem and creates a vfile.
+ *
+ * @param path - Filesystem path to load the contents from.
+ * @param encoding - Optional encoding to pass down to fs.readFile.
+ * @returns Promise returning VFile with loaded file contents.
+ */
+async function readVirtualFile(path, encoding = null) {
+    return new VirtualFile_1.VirtualFile({
+        path,
+        value: await fs_1.promises.readFile(path, { encoding }),
+    });
+}
+exports.readVirtualFile = readVirtualFile;
+/**
+ * Writes vfile to filesystem.
+ *
+ * @param vfile - The vfile to write.
+ * @param options - Options to pass down to fs.writeFile.
+ * @returns A promise that resolves when the file is written.
+ */
+async function writeVirtualFile(vfile, options) {
+    return fs_1.promises.writeFile(vfile.path, vfile.value, options);
+}
+exports.writeVirtualFile = writeVirtualFile;
+//# sourceMappingURL=toVirtualFile.cjs.map

package/dist/virtual-file/toVirtualFile.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"toVirtualFile.cjs","sourceRoot":"","sources":["../../src/virtual-file/toVirtualFile.ts"],"names":[],"mappings":";;;AAAA,2BAA4C;AAE5C,mDAA4C;AAE5C;;;;;;GAMG;AACI,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,WAAkC,IAAI;IAEtC,OAAO,IAAI,yBAAW,CAAC;QACrB,IAAI;QACJ,KAAK,EAAE,MAAM,aAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC;KACrD,CAAC,CAAC;AACL,CAAC;AARD,0CAQC;AAOD;;;;;;GAMG;AACI,KAAK,UAAU,gBAAgB,CACpC,KAAkB,EAClB,OAA2B;IAE3B,OAAO,aAAU,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AALD,4CAKC","sourcesContent":["import { promises as fsPromises } from 'fs';\n\nimport { VirtualFile } from './VirtualFile';\n\n/**\n * Reads a file from filesystem and creates a vfile.\n *\n * @param path - Filesystem path to load the contents from.\n * @param encoding - Optional encoding to pass down to fs.readFile.\n * @returns Promise returning VFile with loaded file contents.\n */\nexport async function readVirtualFile(\n  path: string,\n  encoding: BufferEncoding | null = null,\n) {\n  return new VirtualFile({\n    path,\n    value: await fsPromises.readFile(path, { encoding }),\n  });\n}\n\ntype WriteVFileOptions = Exclude<\n  Parameters<(typeof fsPromises)['writeFile']>[2],\n  undefined\n>;\n\n/**\n * Writes vfile to filesystem.\n *\n * @param vfile - The vfile to write.\n * @param options - Options to pass down to fs.writeFile.\n * @returns A promise that resolves when the file is written.\n */\nexport async function writeVirtualFile(\n  vfile: VirtualFile,\n  options?: WriteVFileOptions,\n) {\n  return fsPromises.writeFile(vfile.path, vfile.value, options);\n}\n"]}

package/dist/virtual-file/toVirtualFile.d.cts

@@ -0,0 +1,24 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+import { promises as fsPromises } from "fs";
+import { VirtualFile } from "./VirtualFile.cjs";
+/**
+ * Reads a file from filesystem and creates a vfile.
+ *
+ * @param path - Filesystem path to load the contents from.
+ * @param encoding - Optional encoding to pass down to fs.readFile.
+ * @returns Promise returning VFile with loaded file contents.
+ */
+export declare function readVirtualFile(path: string, encoding?: BufferEncoding | null): Promise<VirtualFile<unknown>>;
+type WriteVFileOptions = Exclude<Parameters<(typeof fsPromises)['writeFile']>[2], undefined>;
+/**
+ * Writes vfile to filesystem.
+ *
+ * @param vfile - The vfile to write.
+ * @param options - Options to pass down to fs.writeFile.
+ * @returns A promise that resolves when the file is written.
+ */
+export declare function writeVirtualFile(vfile: VirtualFile, options?: WriteVFileOptions): Promise<void>;
+export {};
+//# sourceMappingURL=toVirtualFile.d.cts.map

package/dist/virtual-file/toVirtualFile.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toVirtualFile.d.cts","sourceRoot":"","sources":["../../src/virtual-file/toVirtualFile.ts"],"names":[],"mappings":";;;AAAA,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,WAAW;AAE5C,OAAO,EAAE,WAAW,EAAE,0BAAsB;AAE5C;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,cAAc,GAAG,IAAW,iCAMvC;AAED,KAAK,iBAAiB,GAAG,OAAO,CAC9B,UAAU,CAAC,CAAC,OAAO,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAC/C,SAAS,CACV,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE,iBAAiB,iBAG5B"}

package/dist/virtual-file/toVirtualFile.d.mts

@@ -0,0 +1,24 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+import { promises as fsPromises } from "fs";
+import { VirtualFile } from "./VirtualFile.mjs";
+/**
+ * Reads a file from filesystem and creates a vfile.
+ *
+ * @param path - Filesystem path to load the contents from.
+ * @param encoding - Optional encoding to pass down to fs.readFile.
+ * @returns Promise returning VFile with loaded file contents.
+ */
+export declare function readVirtualFile(path: string, encoding?: BufferEncoding | null): Promise<VirtualFile<unknown>>;
+type WriteVFileOptions = Exclude<Parameters<(typeof fsPromises)['writeFile']>[2], undefined>;
+/**
+ * Writes vfile to filesystem.
+ *
+ * @param vfile - The vfile to write.
+ * @param options - Options to pass down to fs.writeFile.
+ * @returns A promise that resolves when the file is written.
+ */
+export declare function writeVirtualFile(vfile: VirtualFile, options?: WriteVFileOptions): Promise<void>;
+export {};
+//# sourceMappingURL=toVirtualFile.d.mts.map

package/dist/virtual-file/toVirtualFile.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toVirtualFile.d.mts","sourceRoot":"","sources":["../../src/virtual-file/toVirtualFile.ts"],"names":[],"mappings":";;;AAAA,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,WAAW;AAE5C,OAAO,EAAE,WAAW,EAAE,0BAAsB;AAE5C;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,cAAc,GAAG,IAAW,iCAMvC;AAED,KAAK,iBAAiB,GAAG,OAAO,CAC9B,UAAU,CAAC,CAAC,OAAO,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAC/C,SAAS,CACV,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE,iBAAiB,iBAG5B"}