@fgv/ts-utils 2.0.2-alpha.0 → 2.1.1-alpha.0

package/lib/packlets/hash/hash.js

@@ -1,166 +0,0 @@
-"use strict";
-/*
- * Copyright (c) 2021 Erik Fortune
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Normalizer = exports.computeHash = void 0;
-const crypto = __importStar(require("crypto"));
-const base_1 = require("../base");
-/**
- * Computes an md5 hash from an array of strings. Not secure and not intended to be secure.
- * @param parts - The strings to be hashed
- * @returns An md5 hash of the parts
- * @public
- */
-function computeHash(parts) {
-    return crypto.createHash('md5').update(parts.join('|'), 'utf8').digest('hex');
-}
-exports.computeHash = computeHash;
-/**
- * Computes a normalized hash for an arbitrary javascript value.
- * @public
- */
-class Normalizer {
-    /**
-     * Computes a normalized md5 hash from an arbitrary supplied object.  Not secure and not
-     * intended to be secure.  Also not fast and not intended to be fast.
-     *
-     * Normalization just sorts Maps, Sets and object keys by hash so that differences in order
-     * do not affect the hash.
-     *
-     * @param from - The arbitrary `unknown` to be hashed.
-     * @returns A normalized md5 hash for the supplied value.
-     */
-    computeHash(from) {
-        switch (typeof from) {
-            case 'string':
-            case 'bigint':
-            case 'boolean':
-            case 'number':
-            case 'symbol':
-            case 'undefined':
-                return this._normalizeLiteral(from).onSuccess((v) => {
-                    return (0, base_1.captureResult)(() => computeHash([v]));
-                });
-            case 'object':
-                if (from === null || from instanceof Date || from instanceof RegExp) {
-                    return this._normalizeLiteral(from).onSuccess((v) => {
-                        return (0, base_1.captureResult)(() => computeHash([v]));
-                    });
-                }
-                else if (Array.isArray(from)) {
-                    return (0, base_1.mapResults)(from.map((e) => this.computeHash(e))).onSuccess((a) => {
-                        return (0, base_1.captureResult)(() => computeHash(a));
-                    });
-                }
-                else if (from instanceof Map || from instanceof Set) {
-                    return this.computeHash(this._normalizeEntries(from.entries()));
-                }
-                return this.computeHash(this._normalizeEntries(Object.entries(from)));
-        }
-        return (0, base_1.fail)(`computeHash: Unexpected type - cannot hash '${typeof from}'`);
-    }
-    /**
-     * Compares two property names from some object being normalized.
-     * @param k1 - First key to be compared.
-     * @param k2 - Second key to be compared.
-     * @returns `1` if `k1` is greater, `-1` if `k2` is greater and
-     * `0` if they are equal.
-     * @internal
-     */
-    _compareKeys(k1, k2) {
-        const cs1 = String(k1);
-        const cs2 = String(k2);
-        if (cs1 > cs2) {
-            return 1;
-        }
-        if (cs2 > cs1) {
-            return -1;
-        }
-        /* c8 ignore next 2 */
-        return 0;
-    }
-    /**
-     * Normalizes an array of object property entries (e.g. as returned by `Object.entries()`).
-     * @remarks
-     * Converts property names (entry key) to string and then sorts as string.
-     * @param entries - The entries to be normalized.
-     * @returns A normalized sorted array of entries.
-     * @internal
-     */
-    _normalizeEntries(entries) {
-        return Array.from(entries).sort((e1, e2) => this._compareKeys(e1[0], e2[0]));
-    }
-    /**
-     * Constructs a normalized string representation of some literal value.
-     * @param from - The literal value to be normalized.
-     * @returns A normalized string representation of the literal.
-     * @internal
-     */
-    _normalizeLiteral(from) {
-        switch (typeof from) {
-            case 'string':
-                return (0, base_1.succeed)(from);
-            case 'bigint':
-            case 'boolean':
-            case 'number':
-            case 'symbol':
-            case 'undefined':
-                return (0, base_1.succeed)(`${typeof from}:[[[${String(from)}]]]`);
-        }
-        if (from === null) {
-            return (0, base_1.succeed)('object:[[[null]]');
-        }
-        if (from instanceof Date) {
-            return (0, base_1.succeed)(`Date:[[[${String(from.valueOf())}]]]`);
-        }
-        if (from instanceof RegExp) {
-            return (0, base_1.succeed)(`RegExp:[[[${from.toString()}]]]`);
-        }
-        /* c8 ignore next 2 */
-        return (0, base_1.fail)(`cannot normalize ${JSON.stringify(from)}`);
-    }
-}
-exports.Normalizer = Normalizer;
-//# sourceMappingURL=hash.js.map

package/lib/packlets/hash/hash.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../src/packlets/hash/hash.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2021 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as crypto from 'crypto';\nimport { Result, captureResult, fail, mapResults, succeed } from '../base';\n\n/**\n * Computes an md5 hash from an array of strings. Not secure and not intended to be secure.\n * @param parts - The strings to be hashed\n * @returns An md5 hash of the parts\n * @public\n */\nexport function computeHash(parts: string[]): string {\n  return crypto.createHash('md5').update(parts.join('|'), 'utf8').digest('hex');\n}\n\n/**\n * Computes a normalized hash for an arbitrary javascript value.\n * @public\n */\nexport class Normalizer {\n  /**\n   * Computes a normalized md5 hash from an arbitrary supplied object.  Not secure and not\n   * intended to be secure.  Also not fast and not intended to be fast.\n   *\n   * Normalization just sorts Maps, Sets and object keys by hash so that differences in order\n   * do not affect the hash.\n   *\n   * @param from - The arbitrary `unknown` to be hashed.\n   * @returns A normalized md5 hash for the supplied value.\n   */\n  public computeHash(from: unknown): Result<string> {\n    switch (typeof from) {\n      case 'string':\n      case 'bigint':\n      case 'boolean':\n      case 'number':\n      case 'symbol':\n      case 'undefined':\n        return this._normalizeLiteral(from).onSuccess((v) => {\n          return captureResult(() => computeHash([v]));\n        });\n      case 'object':\n        if (from === null || from instanceof Date || from instanceof RegExp) {\n          return this._normalizeLiteral(from).onSuccess((v) => {\n            return captureResult(() => computeHash([v]));\n          });\n        } else if (Array.isArray(from)) {\n          return mapResults(from.map((e) => this.computeHash(e))).onSuccess((a) => {\n            return captureResult(() => computeHash(a));\n          });\n        } else if (from instanceof Map || from instanceof Set) {\n          return this.computeHash(this._normalizeEntries(from.entries()));\n        }\n        return this.computeHash(this._normalizeEntries(Object.entries(from)));\n    }\n    return fail(`computeHash: Unexpected type - cannot hash '${typeof from}'`);\n  }\n\n  /**\n   * Compares two property names from some object being normalized.\n   * @param k1 - First key to be compared.\n   * @param k2 - Second key to be compared.\n   * @returns `1` if `k1` is greater, `-1` if `k2` is greater and\n   * `0` if they are equal.\n   * @internal\n   */\n  protected _compareKeys(k1: unknown, k2: unknown): number {\n    const cs1 = String(k1);\n    const cs2 = String(k2);\n    if (cs1 > cs2) {\n      return 1;\n    }\n    if (cs2 > cs1) {\n      return -1;\n    }\n    /* c8 ignore next 2 */\n    return 0;\n  }\n\n  /**\n   * Normalizes an array of object property entries (e.g. as returned by `Object.entries()`).\n   * @remarks\n   * Converts property names (entry key) to string and then sorts as string.\n   * @param entries - The entries to be normalized.\n   * @returns A normalized sorted array of entries.\n   * @internal\n   */\n  protected _normalizeEntries(entries: Iterable<[unknown, unknown]>): [unknown, unknown][] {\n    return Array.from(entries).sort((e1, e2) => this._compareKeys(e1[0], e2[0]));\n  }\n\n  /**\n   * Constructs a normalized string representation of some literal value.\n   * @param from - The literal value to be normalized.\n   * @returns A normalized string representation of the literal.\n   * @internal\n   */\n  protected _normalizeLiteral(\n    from: string | number | bigint | boolean | symbol | undefined | Date | RegExp | null\n  ): Result<string> {\n    switch (typeof from) {\n      case 'string':\n        return succeed(from);\n      case 'bigint':\n      case 'boolean':\n      case 'number':\n      case 'symbol':\n      case 'undefined':\n        return succeed(`${typeof from}:[[[${String(from)}]]]`);\n    }\n    if (from === null) {\n      return succeed('object:[[[null]]');\n    }\n    if (from instanceof Date) {\n      return succeed(`Date:[[[${String(from.valueOf())}]]]`);\n    }\n    if (from instanceof RegExp) {\n      return succeed(`RegExp:[[[${from.toString()}]]]`);\n    }\n    /* c8 ignore next 2 */\n    return fail(`cannot normalize ${JSON.stringify(from)}`);\n  }\n}\n"]}

package/lib/packlets/hash/index.d.ts

@@ -1,2 +0,0 @@
-export * from './hash';
-//# sourceMappingURL=index.d.ts.map

package/lib/packlets/hash/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/hash/index.ts"],"names":[],"mappings":"AAsBA,cAAc,QAAQ,CAAC"}

package/lib/packlets/hash/index.js

@@ -1,39 +0,0 @@
-"use strict";
-/*
- * Copyright (c) 2020 Erik Fortune
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-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("./hash"), exports);
-//# sourceMappingURL=index.js.map

package/lib/packlets/hash/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/hash/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,yCAAuB","sourcesContent":["/*\n * Copyright (c) 2020 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport * from './hash';\n"]}

package/lib/packlets/record-jar/index.d.ts

@@ -1,2 +0,0 @@
-export * from './recordJarHelpers';
-//# sourceMappingURL=index.d.ts.map

package/lib/packlets/record-jar/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/record-jar/index.ts"],"names":[],"mappings":"AAsBA,cAAc,oBAAoB,CAAC"}

package/lib/packlets/record-jar/index.js

@@ -1,39 +0,0 @@
-"use strict";
-/*
- * Copyright (c) 2023 Erik Fortune
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-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("./recordJarHelpers"), exports);
-//# sourceMappingURL=index.js.map

package/lib/packlets/record-jar/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/record-jar/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,qDAAmC","sourcesContent":["/*\n * Copyright (c) 2023 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport * from './recordJarHelpers';\n"]}

package/lib/packlets/record-jar/recordJarHelpers.d.ts

@@ -1,37 +0,0 @@
-import { Result } from '../base';
-/**
- * Represents a single record in a JAR file
- * @public
- */
-export type JarRecord = Record<string, string | string[]>;
-/**
- * @public
- */
-export type JarFieldPicker<T extends JarRecord = JarRecord> = (record: T) => (keyof T)[];
-/**
- * Options for a JAR record parser.
- * @public
- */
-export interface JarRecordParserOptions {
-    readonly arrayFields?: string[] | JarFieldPicker;
-    readonly fixedContinuationSize?: number;
-}
-/**
- * Reads a record-jar from an array of strings, each of which represents one
- * line in the source file.
- * @param lines - the array of strings to be parsed
- * @param options - Optional parser configuration
- * @returns a corresponding array of `Record<string, string>`
- * @public
- */
-export declare function parseRecordJarLines(lines: string[], options?: JarRecordParserOptions): Result<JarRecord[]>;
-/**
- * Reads a record-jar file from a supplied path.
- * @param srcPath - Source path from which the file is read.
- * @param options - Optional parser configuration
- * @returns The contents of the file as an array of `Record<string, string>`
- * @see https://datatracker.ietf.org/doc/html/draft-phillips-record-jar-01
- * @public
- */
-export declare function readRecordJarFileSync(srcPath: string, options?: JarRecordParserOptions): Result<JarRecord[]>;
-//# sourceMappingURL=recordJarHelpers.d.ts.map

package/lib/packlets/record-jar/recordJarHelpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"recordJarHelpers.d.ts","sourceRoot":"","sources":["../../../src/packlets/record-jar/recordJarHelpers.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,MAAM,EAAyC,MAAM,SAAS,CAAC;AAOxE;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;AAEzF;;;GAGG;AAEH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC;IACjD,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CACzC;AAoMD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,CAE1G;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,sBAAsB,GAC/B,MAAM,CAAC,SAAS,EAAE,CAAC,CAOrB"}

package/lib/packlets/record-jar/recordJarHelpers.js

@@ -1,263 +0,0 @@
-"use strict";
-/*
- * Copyright (c) 2022 Erik Fortune
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readRecordJarFileSync = exports.parseRecordJarLines = void 0;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const base_1 = require("../base");
-class RecordParser {
-    // eslint-disable-next-line @typescript-eslint/no-empty-function
-    constructor(options) {
-        this.records = [];
-        this._fields = {};
-        this._name = undefined;
-        this._body = undefined;
-        this.options = options !== null && options !== void 0 ? options : {};
-    }
-    static parse(lines, options) {
-        return new RecordParser(options)._parse(lines);
-    }
-    static _parseRecordBody(body) {
-        const isContinuation = body.endsWith('\\');
-        if (isContinuation) {
-            body = body.slice(0, body.length - 1);
-        }
-        if (this._hasEscapes(body)) {
-            const result = this._replaceEscapes(body);
-            if (result.isFailure()) {
-                return (0, base_1.fail)(result.message);
-            }
-            body = result.value;
-        }
-        return (0, base_1.succeed)({ body, isContinuation });
-    }
-    static _hasEscapes(from) {
-        return from.includes('\\') || from.includes('&');
-    }
-    static _replaceEscapes(body) {
-        const invalid = [];
-        const escaped = body.replace(/(\\.)|(&#x[a-fA-F0-9]{2,6};)/g, (match) => {
-            switch (match) {
-                case '\\\\':
-                    return '\\';
-                case '\\&':
-                    return '&';
-                case '\\r':
-                    return '\r';
-                case '\\n':
-                    return '\n';
-                case '\\t':
-                    return '\t';
-            }
-            if (match.startsWith('&')) {
-                const hexCode = `0x${match.slice(3, match.length - 1)}`;
-                const charCode = Number.parseInt(hexCode, 16);
-                return String.fromCharCode(charCode);
-            }
-            invalid.push(match);
-            return '\\';
-        });
-        if (invalid.length > 0) {
-            return (0, base_1.fail)(`unrecognized escape "${invalid.join(', ')}" in record-jar body`);
-        }
-        return (0, base_1.succeed)(escaped);
-    }
-    static _applyOptions(record, options) {
-        if (options.arrayFields) {
-            record = Object.assign({}, record); // don't edit incoming values
-            const arrayFields = Array.isArray(options.arrayFields)
-                ? options.arrayFields
-                : options.arrayFields(record);
-            for (const field of arrayFields) {
-                if ((0, base_1.isKeyOf)(field, record) && typeof record[field] === 'string') {
-                    const current = record[field];
-                    record[field] = [current];
-                }
-            }
-        }
-        return record;
-    }
-    _parse(lines) {
-        var _a, _b;
-        for (let n = 0; n < lines.length; n++) {
-            const line = lines[n];
-            if (line.startsWith('%%') && !((_a = this._body) === null || _a === void 0 ? void 0 : _a.isContinuation)) {
-                const result = this._writePendingRecord();
-                if (result.isFailure()) {
-                    return (0, base_1.fail)(`${n}: ${result.message}`);
-                }
-            }
-            else if (/^\s*$/.test(line)) {
-                // ignore blank lines but cancel continuation
-                if (this._body) {
-                    this._body.isContinuation = false;
-                }
-                continue;
-            }
-            else if (((_b = this._body) === null || _b === void 0 ? void 0 : _b.isContinuation) || /^\s+/.test(line)) {
-                // explicit continuation on previous line or implicit starts with whitespace
-                if (this._body === undefined) {
-                    return (0, base_1.fail)(`${n}: continuation ("${line}") without prior value.`);
-                }
-                const result = this._parseContinuation(line);
-                if (result.isFailure()) {
-                    return (0, base_1.fail)(`${n}: ${result.message}`);
-                }
-                this._body = result.value;
-            }
-            else {
-                const result = this._parseField(line);
-                if (result.isFailure()) {
-                    return (0, base_1.fail)(`${n}: ${result.message}`);
-                }
-            }
-        }
-        const result = this._writePendingRecord();
-        if (result.isFailure()) {
-            return (0, base_1.fail)(`${lines.length}: ${result.message}`);
-        }
-        return (0, base_1.succeed)(this.records);
-    }
-    _parseField(line) {
-        const separatorIndex = line.indexOf(':');
-        if (separatorIndex < 1) {
-            return (0, base_1.fail)(`malformed line ("${line}") in record-jar.`);
-        }
-        const parts = [line.slice(0, separatorIndex), line.slice(separatorIndex + 1)];
-        return this._writePendingField().onSuccess(() => {
-            this._name = parts[0].trimEnd();
-            return RecordParser._parseRecordBody(parts[1].trim()).onSuccess((body) => {
-                this._body = body;
-                return (0, base_1.succeed)(true);
-            });
-        });
-    }
-    _parseContinuation(line) {
-        var _a, _b;
-        let trimmed = line.trim();
-        if (!this._body.isContinuation) {
-            /* c8 ignore next */
-            const fixedSize = (_b = (_a = this.options) === null || _a === void 0 ? void 0 : _a.fixedContinuationSize) !== null && _b !== void 0 ? _b : 0;
-            if (fixedSize > 0) {
-                if (trimmed.length < line.length - fixedSize) {
-                    // oops, took too much
-                    trimmed = line.slice(fixedSize);
-                }
-            }
-        }
-        return RecordParser._parseRecordBody(trimmed).onSuccess((newBody) => {
-            return (0, base_1.succeed)({
-                body: `${this._body.body}${newBody.body}`,
-                isContinuation: newBody.isContinuation
-            });
-        });
-    }
-    _havePendingRecord() {
-        return Object.keys(this._fields).length > 0;
-    }
-    _writePendingRecord() {
-        return this._writePendingField().onSuccess(() => {
-            let record = this._havePendingRecord() ? this._fields : undefined;
-            if (record !== undefined) {
-                record = RecordParser._applyOptions(record, this.options);
-                this.records.push(record);
-                this._fields = {};
-            }
-            return (0, base_1.succeed)(undefined);
-        });
-    }
-    _writePendingField() {
-        if (this._name !== undefined) {
-            if (this._body.body.length < 1) {
-                return (0, base_1.fail)('empty body value not allowed');
-            }
-            if (!(0, base_1.isKeyOf)(this._name, this._fields)) {
-                this._fields[this._name] = this._body.body;
-            }
-            else if (typeof this._fields[this._name] === 'string') {
-                const current = this._fields[this._name];
-                this._fields[this._name] = [current, this._body.body];
-            }
-            else {
-                const current = this._fields[this._name];
-                current.push(this._body.body);
-            }
-            this._name = undefined;
-            this._body = undefined;
-        }
-        return (0, base_1.succeed)(true);
-    }
-}
-/**
- * Reads a record-jar from an array of strings, each of which represents one
- * line in the source file.
- * @param lines - the array of strings to be parsed
- * @param options - Optional parser configuration
- * @returns a corresponding array of `Record<string, string>`
- * @public
- */
-function parseRecordJarLines(lines, options) {
-    return RecordParser.parse(lines, options);
-}
-exports.parseRecordJarLines = parseRecordJarLines;
-/**
- * Reads a record-jar file from a supplied path.
- * @param srcPath - Source path from which the file is read.
- * @param options - Optional parser configuration
- * @returns The contents of the file as an array of `Record<string, string>`
- * @see https://datatracker.ietf.org/doc/html/draft-phillips-record-jar-01
- * @public
- */
-function readRecordJarFileSync(srcPath, options) {
-    return (0, base_1.captureResult)(() => {
-        const fullPath = path.resolve(srcPath);
-        return fs.readFileSync(fullPath, 'utf8').toString().split(/\r?\n/);
-    }).onSuccess((lines) => {
-        return parseRecordJarLines(lines, options);
-    });
-}
-exports.readRecordJarFileSync = readRecordJarFileSync;
-//# sourceMappingURL=recordJarHelpers.js.map

package/lib/packlets/record-jar/recordJarHelpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"recordJarHelpers.js","sourceRoot":"","sources":["../../../src/packlets/record-jar/recordJarHelpers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAE7B,kCAAwE;AA4BxE,MAAM,YAAY;IAQhB,gEAAgE;IAChE,YAAoB,OAAgC;QARpC,YAAO,GAAgB,EAAE,CAAC;QAGhC,YAAO,GAAc,EAAE,CAAC;QACxB,UAAK,GAAuB,SAAS,CAAC;QACtC,UAAK,GAA4B,SAAS,CAAC;QAInD,IAAI,CAAC,OAAO,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,CAAC;IAC/B,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,KAAe,EAAE,OAAgC;QACnE,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;IAES,MAAM,CAAC,gBAAgB,CAAC,IAAY;QAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,cAAc,EAAE;YAClB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;SACvC;QACD,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE;YAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE;gBACtB,OAAO,IAAA,WAAI,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC;aAC7B;YACD,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;SACrB;QACD,OAAO,IAAA,cAAO,EAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IAC3C,CAAC;IAES,MAAM,CAAC,WAAW,CAAC,IAAY;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IAES,MAAM,CAAC,eAAe,CAAC,IAAY;QAC3C,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,+BAA+B,EAAE,CAAC,KAAK,EAAE,EAAE;YACtE,QAAQ,KAAK,EAAE;gBACb,KAAK,MAAM;oBACT,OAAO,IAAI,CAAC;gBACd,KAAK,KAAK;oBACR,OAAO,GAAG,CAAC;gBACb,KAAK,KAAK;oBACR,OAAO,IAAI,CAAC;gBACd,KAAK,KAAK;oBACR,OAAO,IAAI,CAAC;gBACd,KAAK,KAAK;oBACR,OAAO,IAAI,CAAC;aACf;YACD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;gBACzB,MAAM,OAAO,GAAG,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;gBACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC9C,OAAO,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;aACtC;YACD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE;YACtB,OAAO,IAAA,WAAI,EAAC,wBAAwB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;SAC/E;QACD,OAAO,IAAA,cAAO,EAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAES,MAAM,CAAC,aAAa,CAAC,MAAiB,EAAE,OAA+B;QAC/E,IAAI,OAAO,CAAC,WAAW,EAAE;YACvB,MAAM,qBAAQ,MAAM,CAAE,CAAC,CAAC,6BAA6B;YACrD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;gBACpD,CAAC,CAAC,OAAO,CAAC,WAAW;gBACrB,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAEhC,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE;gBAC/B,IAAI,IAAA,cAAO,EAAC,KAAK,EAAE,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE;oBAC/D,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAW,CAAC;oBACxC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;iBAC3B;aACF;SACF;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAES,MAAM,CAAC,KAAe;;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,MAAA,IAAI,CAAC,KAAK,0CAAE,cAAc,CAAA,EAAE;gBACxD,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBAC1C,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE;oBACtB,OAAO,IAAA,WAAI,EAAC,GAAG,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;iBACxC;aACF;iBAAM,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBAC7B,6CAA6C;gBAC7C,IAAI,IAAI,CAAC,KAAK,EAAE;oBACd,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC;iBACnC;gBACD,SAAS;aACV;iBAAM,IAAI,CAAA,MAAA,IAAI,CAAC,KAAK,0CAAE,cAAc,KAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBAC1D,4EAA4E;gBAC5E,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE;oBAC5B,OAAO,IAAA,WAAI,EAAC,GAAG,CAAC,oBAAoB,IAAI,yBAAyB,CAAC,CAAC;iBACpE;gBACD,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBAC7C,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE;oBACtB,OAAO,IAAA,WAAI,EAAC,GAAG,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;iBACxC;gBACD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;aAC3B;iBAAM;gBACL,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBACtC,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE;oBACtB,OAAO,IAAA,WAAI,EAAC,GAAG,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;iBACxC;aACF;SACF;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1C,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE;YACtB,OAAO,IAAA,WAAI,EAAC,GAAG,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;SACnD;QACD,OAAO,IAAA,cAAO,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAES,WAAW,CAAC,IAAY;QAChC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,cAAc,GAAG,CAAC,EAAE;YACtB,OAAO,IAAA,WAAI,EAAC,oBAAoB,IAAI,mBAAmB,CAAC,CAAC;SAC1D;QACD,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC;QAE9E,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE;YAC9C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAChC,OAAO,YAAY,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;gBACvE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;gBAClB,OAAO,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC;YACvB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAES,kBAAkB,CAAC,IAAY;;QACvC,IAAI,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,KAAM,CAAC,cAAc,EAAE;YAC/B,oBAAoB;YACpB,MAAM,SAAS,GAAG,MAAA,MAAA,IAAI,CAAC,OAAO,0CAAE,qBAAqB,mCAAI,CAAC,CAAC;YAC3D,IAAI,SAAS,GAAG,CAAC,EAAE;gBACjB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,SAAS,EAAE;oBAC5C,sBAAsB;oBACtB,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;iBACjC;aACF;SACF;QACD,OAAO,YAAY,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE;YAClE,OAAO,IAAA,cAAO,EAAC;gBACb,IAAI,EAAE,GAAG,IAAI,CAAC,KAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE;gBAC1C,cAAc,EAAE,OAAO,CAAC,cAAc;aACvC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAES,kBAAkB;QAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9C,CAAC;IAES,mBAAmB;QAC3B,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE;YAC9C,IAAI,MAAM,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YAClE,IAAI,MAAM,KAAK,SAAS,EAAE;gBACxB,MAAM,GAAG,YAAY,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC1D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC1B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;aACnB;YACD,OAAO,IAAA,cAAO,EAAC,SAAS,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAES,kBAAkB;QAC1B,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE;YAC5B,IAAI,IAAI,CAAC,KAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE;gBAC/B,OAAO,IAAA,WAAI,EAAC,8BAA8B,CAAC,CAAC;aAC7C;YACD,IAAI,CAAC,IAAA,cAAO,EAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE;gBACtC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAM,CAAC,IAAI,CAAC;aAC7C;iBAAM,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE;gBACvD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAW,CAAC;gBACnD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAM,CAAC,IAAI,CAAC,CAAC;aACxD;iBAAM;gBACL,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAa,CAAC;gBACrD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAM,CAAC,IAAI,CAAC,CAAC;aAChC;YACD,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;YACvB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;SACxB;QACD,OAAO,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC;IACvB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CAAC,KAAe,EAAE,OAAgC;IACnF,OAAO,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAFD,kDAEC;AAED;;;;;;;GAOG;AACH,SAAgB,qBAAqB,CACnC,OAAe,EACf,OAAgC;IAEhC,OAAO,IAAA,oBAAa,EAAC,GAAG,EAAE;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;QACrB,OAAO,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC;AAVD,sDAUC","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\n\nimport { Result, captureResult, fail, isKeyOf, succeed } from '../base';\n\ninterface IRecordBody {\n  body: string;\n  isContinuation: boolean;\n}\n\n/**\n * Represents a single record in a JAR file\n * @public\n */\nexport type JarRecord = Record<string, string | string[]>;\n\n/**\n * @public\n */\nexport type JarFieldPicker<T extends JarRecord = JarRecord> = (record: T) => (keyof T)[];\n\n/**\n * Options for a JAR record parser.\n * @public\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport interface JarRecordParserOptions {\n  readonly arrayFields?: string[] | JarFieldPicker;\n  readonly fixedContinuationSize?: number;\n}\n\nclass RecordParser {\n  public readonly records: JarRecord[] = [];\n  public readonly options: JarRecordParserOptions;\n\n  protected _fields: JarRecord = {};\n  protected _name: string | undefined = undefined;\n  protected _body: IRecordBody | undefined = undefined;\n\n  // eslint-disable-next-line @typescript-eslint/no-empty-function\n  private constructor(options?: JarRecordParserOptions) {\n    this.options = options ?? {};\n  }\n\n  public static parse(lines: string[], options?: JarRecordParserOptions): Result<JarRecord[]> {\n    return new RecordParser(options)._parse(lines);\n  }\n\n  protected static _parseRecordBody(body: string): Result<IRecordBody> {\n    const isContinuation = body.endsWith('\\\\');\n    if (isContinuation) {\n      body = body.slice(0, body.length - 1);\n    }\n    if (this._hasEscapes(body)) {\n      const result = this._replaceEscapes(body);\n      if (result.isFailure()) {\n        return fail(result.message);\n      }\n      body = result.value;\n    }\n    return succeed({ body, isContinuation });\n  }\n\n  protected static _hasEscapes(from: string): boolean {\n    return from.includes('\\\\') || from.includes('&');\n  }\n\n  protected static _replaceEscapes(body: string): Result<string> {\n    const invalid: string[] = [];\n    const escaped = body.replace(/(\\\\.)|(&#x[a-fA-F0-9]{2,6};)/g, (match) => {\n      switch (match) {\n        case '\\\\\\\\':\n          return '\\\\';\n        case '\\\\&':\n          return '&';\n        case '\\\\r':\n          return '\\r';\n        case '\\\\n':\n          return '\\n';\n        case '\\\\t':\n          return '\\t';\n      }\n      if (match.startsWith('&')) {\n        const hexCode = `0x${match.slice(3, match.length - 1)}`;\n        const charCode = Number.parseInt(hexCode, 16);\n        return String.fromCharCode(charCode);\n      }\n      invalid.push(match);\n      return '\\\\';\n    });\n    if (invalid.length > 0) {\n      return fail(`unrecognized escape \"${invalid.join(', ')}\" in record-jar body`);\n    }\n    return succeed(escaped);\n  }\n\n  protected static _applyOptions(record: JarRecord, options: JarRecordParserOptions): JarRecord {\n    if (options.arrayFields) {\n      record = { ...record }; // don't edit incoming values\n      const arrayFields = Array.isArray(options.arrayFields)\n        ? options.arrayFields\n        : options.arrayFields(record);\n\n      for (const field of arrayFields) {\n        if (isKeyOf(field, record) && typeof record[field] === 'string') {\n          const current = record[field] as string;\n          record[field] = [current];\n        }\n      }\n    }\n    return record;\n  }\n\n  protected _parse(lines: string[]): Result<JarRecord[]> {\n    for (let n = 0; n < lines.length; n++) {\n      const line = lines[n];\n      if (line.startsWith('%%') && !this._body?.isContinuation) {\n        const result = this._writePendingRecord();\n        if (result.isFailure()) {\n          return fail(`${n}: ${result.message}`);\n        }\n      } else if (/^\\s*$/.test(line)) {\n        // ignore blank lines but cancel continuation\n        if (this._body) {\n          this._body.isContinuation = false;\n        }\n        continue;\n      } else if (this._body?.isContinuation || /^\\s+/.test(line)) {\n        // explicit continuation on previous line or implicit starts with whitespace\n        if (this._body === undefined) {\n          return fail(`${n}: continuation (\"${line}\") without prior value.`);\n        }\n        const result = this._parseContinuation(line);\n        if (result.isFailure()) {\n          return fail(`${n}: ${result.message}`);\n        }\n        this._body = result.value;\n      } else {\n        const result = this._parseField(line);\n        if (result.isFailure()) {\n          return fail(`${n}: ${result.message}`);\n        }\n      }\n    }\n\n    const result = this._writePendingRecord();\n    if (result.isFailure()) {\n      return fail(`${lines.length}: ${result.message}`);\n    }\n    return succeed(this.records);\n  }\n\n  protected _parseField(line: string): Result<boolean> {\n    const separatorIndex = line.indexOf(':');\n    if (separatorIndex < 1) {\n      return fail(`malformed line (\"${line}\") in record-jar.`);\n    }\n    const parts = [line.slice(0, separatorIndex), line.slice(separatorIndex + 1)];\n\n    return this._writePendingField().onSuccess(() => {\n      this._name = parts[0].trimEnd();\n      return RecordParser._parseRecordBody(parts[1].trim()).onSuccess((body) => {\n        this._body = body;\n        return succeed(true);\n      });\n    });\n  }\n\n  protected _parseContinuation(line: string): Result<IRecordBody> {\n    let trimmed = line.trim();\n    if (!this._body!.isContinuation) {\n      /* c8 ignore next */\n      const fixedSize = this.options?.fixedContinuationSize ?? 0;\n      if (fixedSize > 0) {\n        if (trimmed.length < line.length - fixedSize) {\n          // oops, took too much\n          trimmed = line.slice(fixedSize);\n        }\n      }\n    }\n    return RecordParser._parseRecordBody(trimmed).onSuccess((newBody) => {\n      return succeed({\n        body: `${this._body!.body}${newBody.body}`,\n        isContinuation: newBody.isContinuation\n      });\n    });\n  }\n\n  protected _havePendingRecord(): boolean {\n    return Object.keys(this._fields).length > 0;\n  }\n\n  protected _writePendingRecord(): Result<JarRecord | undefined> {\n    return this._writePendingField().onSuccess(() => {\n      let record = this._havePendingRecord() ? this._fields : undefined;\n      if (record !== undefined) {\n        record = RecordParser._applyOptions(record, this.options);\n        this.records.push(record);\n        this._fields = {};\n      }\n      return succeed(undefined);\n    });\n  }\n\n  protected _writePendingField(): Result<boolean> {\n    if (this._name !== undefined) {\n      if (this._body!.body.length < 1) {\n        return fail('empty body value not allowed');\n      }\n      if (!isKeyOf(this._name, this._fields)) {\n        this._fields[this._name] = this._body!.body;\n      } else if (typeof this._fields[this._name] === 'string') {\n        const current = this._fields[this._name] as string;\n        this._fields[this._name] = [current, this._body!.body];\n      } else {\n        const current = this._fields[this._name] as string[];\n        current.push(this._body!.body);\n      }\n      this._name = undefined;\n      this._body = undefined;\n    }\n    return succeed(true);\n  }\n}\n\n/**\n * Reads a record-jar from an array of strings, each of which represents one\n * line in the source file.\n * @param lines - the array of strings to be parsed\n * @param options - Optional parser configuration\n * @returns a corresponding array of `Record<string, string>`\n * @public\n */\nexport function parseRecordJarLines(lines: string[], options?: JarRecordParserOptions): Result<JarRecord[]> {\n  return RecordParser.parse(lines, options);\n}\n\n/**\n * Reads a record-jar file from a supplied path.\n * @param srcPath - Source path from which the file is read.\n * @param options - Optional parser configuration\n * @returns The contents of the file as an array of `Record<string, string>`\n * @see https://datatracker.ietf.org/doc/html/draft-phillips-record-jar-01\n * @public\n */\nexport function readRecordJarFileSync(\n  srcPath: string,\n  options?: JarRecordParserOptions\n): Result<JarRecord[]> {\n  return captureResult(() => {\n    const fullPath = path.resolve(srcPath);\n    return fs.readFileSync(fullPath, 'utf8').toString().split(/\\r?\\n/);\n  }).onSuccess((lines) => {\n    return parseRecordJarLines(lines, options);\n  });\n}\n"]}