@static-suite/static-suite-data-server 0.0.1

package/dist/lib/utils/module/index.js

@@ -0,0 +1,14 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (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("./moduleManager"), exports);
+__exportStar(require("./dirBasedModuleGroupManager"), exports);

package/dist/lib/utils/module/module.types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * A manager for a group of user-land modules.
+ *
+ * @typeParam ModuleType - The type of module being managed.
+ */
+export declare type ModuleGroupManager<ModuleType> = {
+    /**
+     * Gets an array with information of each module inside a module group.
+     *
+     * @returns An array with information of each detected module, containing:
+     * - module ID
+     * - module's absolute path
+     * - module's relative path
+     * - a function to load the module on demand
+     */
+    getModuleGroupInfo(): Map<string, ModuleInfo<ModuleType>>;
+    /**
+     * Resets the cache of found modules inside a module group.
+     */
+    reset(): void;
+};
+/**
+ * Information about a user-land module.
+ *
+ * @typeParam ModuleType - The type of the module.
+ */
+export declare type ModuleInfo<ModuleType> = {
+    /**
+     * Module ID.
+     *
+     * Given the following modules, their IDs are:
+     * - main.hook.js: main
+     * - dir/main.hook.js: dir/main
+     * - dir/taxonomy.hook.js: dir/taxonomy
+     * - latestContents.query.js: latestContents
+     * - dir/latestContents.query.js: dir/latestContents
+     * - dir/searchByTitle.query.js: dir/searchByTitle
+     */
+    id: string;
+    /**
+     * Module's absolute path.
+     */
+    absolutePath: string;
+    /**
+     * Module's relative path inside module group directory.
+     */
+    relativePath: string;
+    /**
+     * Gets a module, loading it if not already loaded.
+     */
+    getModule(): ModuleType;
+};
+//# sourceMappingURL=module.types.d.ts.map

package/dist/lib/utils/module/module.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.types.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/module/module.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oBAAY,kBAAkB,CAAC,UAAU,IAAI;IAC3C;;;;;;;;OAQG;IACH,kBAAkB,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IAE1D;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAEF;;;;GAIG;AACH,oBAAY,UAAU,CAAC,UAAU,IAAI;IACnC;;;;;;;;;;OAUG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,IAAI,UAAU,CAAC;CACzB,CAAC"}

package/dist/lib/utils/module/module.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/utils/module/moduleManager.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Module system that manages the caching of modules.
+ *
+ * @remarks
+ * Modules are cached by Node.js when they are required. This module handler
+ * is able to remove them from Node.js cache and reload them from scratch.
+ *
+ * This manager is aimed at handling "user-land" modules, i.e.- modules managed
+ * by users and not part of the Data Server core. Those "user-land" modules are
+ * queries and hooks, so trying to manage other kind of module will throw and error.
+ */
+export declare const moduleManager: {
+    /**
+     * Loads a module from scratch
+     *
+     * @remarks
+     * Removes a module from Node.js cache, and loads it from scratch.
+     * If the module is not valid or not found, it logs an error and throws
+     * an exception.
+     *
+     * @param modulePath - Path to the module to be loaded
+     * @typeParam Type - Type of the module to be loaded
+     *
+     * @returns - The requested module
+     *
+     * @throws
+     * An exception if the module is not valid or it cannot be loaded.
+     */
+    load: <Type>(modulePath: string) => Type;
+    /**
+     * Removes a single module from Node.js cache
+     *
+     * @param modulePath - Path to the module to be removed
+     * @param options - Object of options:
+     * useLogger: Flag to use logger or not. Useful to avoid
+     * "remove" log lines when this function is called from
+     * other functions.
+     */
+    remove: (modulePath: string, options?: {
+        useLogger: boolean;
+    }) => void;
+    /**
+     * Removes several modules from Node.js cache at once
+     *
+     * @param regex - Regular expression to be tested again cached modules path
+     */
+    removeAll: (regex: RegExp) => void;
+    /**
+     * Gets a module from cache or loads it from scratch
+     *
+     * @remarks
+     * If module is not found, logs an error and throws an exception.
+     *
+     * @param modulePath - Path to the module to be loaded
+     * @typeParam Type - Type of the module to be loaded
+     *
+     * @returns - The requested module
+     *
+     * @throws
+     * An exception if the module cannot be loaded.
+     */
+    get: <Type_1>(modulePath: string) => Type_1;
+};
+//# sourceMappingURL=moduleManager.d.ts.map

package/dist/lib/utils/module/moduleManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleManager.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/module/moduleManager.ts"],"names":[],"mappings":"AA8CA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa;IACxB;;;;;;;;;;;;;;;OAeG;6BACsB,MAAM;IAgB/B;;;;;;;;OAQG;yBACkB,MAAM;;UAAkC,IAAI;IASjE;;;;OAIG;uBACgB,MAAM,KAAG,IAAI;IAShC;;;;;;;;;;;;;OAaG;8BACqB,MAAM;CAO/B,CAAC"}

package/dist/lib/utils/module/moduleManager.js

@@ -0,0 +1,139 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.moduleManager = void 0;
+/* eslint-disable global-require */
+/* eslint-disable import/no-dynamic-require */
+const clear_module_1 = __importDefault(require("clear-module"));
+const logger_1 = require("@lib/utils/logger");
+const config_1 = require("@lib/config");
+const store_1 = require("@lib/store");
+/**
+ * Internal module cache.
+ *
+ * @remarks
+ * It does not use the shared cache util since this cache must to be
+ * managed only by this module, and should not be accessible nor
+ * managed from the outside.
+ */
+const internalModuleCache = {};
+/**
+ * Internal resolve cache.
+ *
+ * @remarks
+ * It does not use the shared cache util since this cache must be
+ * managed only by this module, and should not be accessible nor
+ * managed from the outside.
+ */
+const internalResolveCache = {};
+/**
+ * Resolves a path to a module
+ *
+ * @param modulePath - A path to a module
+ * @returns The resolved path, or the given unresolved path if module cannot be found
+ */
+const resolve = (modulePath) => {
+    let resolvedModulePath = internalResolveCache[modulePath];
+    if (!resolvedModulePath) {
+        try {
+            resolvedModulePath = require.resolve(modulePath);
+        }
+        catch (e) {
+            resolvedModulePath = modulePath;
+        }
+        internalResolveCache[modulePath] = resolvedModulePath;
+    }
+    return resolvedModulePath;
+};
+/**
+ * Module system that manages the caching of modules.
+ *
+ * @remarks
+ * Modules are cached by Node.js when they are required. This module handler
+ * is able to remove them from Node.js cache and reload them from scratch.
+ *
+ * This manager is aimed at handling "user-land" modules, i.e.- modules managed
+ * by users and not part of the Data Server core. Those "user-land" modules are
+ * queries and hooks, so trying to manage other kind of module will throw and error.
+ */
+exports.moduleManager = {
+    /**
+     * Loads a module from scratch
+     *
+     * @remarks
+     * Removes a module from Node.js cache, and loads it from scratch.
+     * If the module is not valid or not found, it logs an error and throws
+     * an exception.
+     *
+     * @param modulePath - Path to the module to be loaded
+     * @typeParam Type - Type of the module to be loaded
+     *
+     * @returns - The requested module
+     *
+     * @throws
+     * An exception if the module is not valid or it cannot be loaded.
+     */
+    load: (modulePath) => {
+        const resolvedModulePath = resolve(modulePath);
+        exports.moduleManager.remove(resolvedModulePath, { useLogger: false });
+        try {
+            internalModuleCache[resolvedModulePath] = require(resolvedModulePath);
+        }
+        catch (e) {
+            logger_1.logger.error(`Module "${resolvedModulePath}" not found.`);
+            throw e;
+        }
+        if (internalModuleCache[resolvedModulePath].onModuleLoad) {
+            internalModuleCache[resolvedModulePath].onModuleLoad({ config: config_1.config, store: store_1.store });
+        }
+        logger_1.logger.debug(`Module ${resolvedModulePath} successfully loaded.`);
+        return internalModuleCache[resolvedModulePath];
+    },
+    /**
+     * Removes a single module from Node.js cache
+     *
+     * @param modulePath - Path to the module to be removed
+     * @param options - Object of options:
+     * useLogger: Flag to use logger or not. Useful to avoid
+     * "remove" log lines when this function is called from
+     * other functions.
+     */
+    remove: (modulePath, options = { useLogger: true }) => {
+        const resolvedModulePath = resolve(modulePath);
+        (0, clear_module_1.default)(resolvedModulePath);
+        delete internalModuleCache[resolvedModulePath];
+        if (options.useLogger) {
+            logger_1.logger.debug(`Module ${resolvedModulePath} successfully removed.`);
+        }
+    },
+    /**
+     * Removes several modules from Node.js cache at once
+     *
+     * @param regex - Regular expression to be tested again cached modules path
+     */
+    removeAll: (regex) => {
+        const modulePathsToBeRemoved = Object.keys(require.cache).filter(modulePath => regex.test(modulePath));
+        modulePathsToBeRemoved.forEach(modulePath => exports.moduleManager.remove(modulePath));
+    },
+    /**
+     * Gets a module from cache or loads it from scratch
+     *
+     * @remarks
+     * If module is not found, logs an error and throws an exception.
+     *
+     * @param modulePath - Path to the module to be loaded
+     * @typeParam Type - Type of the module to be loaded
+     *
+     * @returns - The requested module
+     *
+     * @throws
+     * An exception if the module cannot be loaded.
+     */
+    get: (modulePath) => {
+        const resolvedModulePath = resolve(modulePath);
+        return (internalModuleCache[resolvedModulePath] ||
+            exports.moduleManager.load(resolvedModulePath));
+    },
+};

package/dist/lib/utils/object/index.d.ts

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

package/dist/lib/utils/object/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/object/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/lib/utils/object/index.js

@@ -0,0 +1,13 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (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("./objectUtils"), exports);

package/dist/lib/utils/object/object.types.d.ts

@@ -0,0 +1,72 @@
+export declare type ObjectType = Record<string, unknown>;
+/**
+ * Structure where a content's data and metadata os hold.
+ *
+ * @remarks
+ * This type describes any JSON object, which can contain any data, but
+ * it is usually structured this way:
+ *
+ * @example
+ * ```
+ * {
+ *  "data": {
+ *    "content": {
+ *      ...,
+ *    }
+ *  }
+ *  "metadata": {
+ *    "includes": [
+ *	    "data.content.author.entity.entityInclude",
+ *	    "data.content.image.entity.entityInclude",
+ *	    "data.content.queryInclude"
+ *    ]
+ *  }
+ * }
+ * ```
+ */
+export declare type Json = {
+    [key: string]: any;
+    /**
+     * Optional structure for a content's data.
+     */
+    data?: {
+        [key: string]: any;
+        /**
+         * Optional object that holds the fields of a Drupal content.
+         */
+        content?: Record<string, any>;
+    };
+    /**
+     * Optional structure for metadata includes.
+     */
+    metadata?: {
+        [key: string]: any;
+        /**
+         * Optional array for metadata includes.
+         *
+         * @remarks
+         * Every include path is stored in this array, so they can be
+         * easily accessed.
+         *
+         * @example
+         * ```
+         * "metadata": {
+         *  "includes": [
+         *    "static": [
+         *	    "data.content.author.entity.entityInclude",
+         *	    "data.content.image.entity.entityInclude",
+         *    ]
+         *    "dynamic": [
+         *	    "data.content.queryInclude"
+         *    ]
+         *  ]
+         * }
+         * ```
+         */
+        includes?: {
+            static?: Record<string, string>;
+            dynamic?: Record<string, string>;
+        };
+    };
+};
+//# sourceMappingURL=object.types.d.ts.map

package/dist/lib/utils/object/object.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.types.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/object/object.types.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,oBAAY,IAAI,GAAG;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE;QACL,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;QACnB;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC/B,CAAC;IAEF;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;QACnB;;;;;;;;;;;;;;;;;;;;;WAqBG;QACH,QAAQ,CAAC,EAAE;YACT,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SAClC,CAAC;KACH,CAAC;CACH,CAAC"}

package/dist/lib/utils/object/object.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/utils/object/objectUtils.d.ts

@@ -0,0 +1,45 @@
+import { ObjectType } from './object.types';
+/**
+ * Checks if an object is empty (i.e.- contains zero keys)
+ *
+ * @param object - An object
+ *
+ * @returns True if the object contains zero keys, false otherwise.
+ */
+export declare const isEmptyObject: (object: ObjectType) => boolean;
+/**
+ * Checks if an object contains a key
+ *
+ * @param object - An object
+ * @param key - The name of a key
+ *
+ * @returns True if the object has the given key, false otherwise.
+ */
+export declare const hasKey: <O>(object: O, key: PropertyKey) => key is keyof O;
+/**
+ * Clones an object and all its nested objects
+ *
+ * @param object - An object to be cloned
+ *
+ * @returns An identical object without references to nested objects
+ */
+export declare const deepClone: (object: ObjectType) => ObjectType;
+/**
+ * Gets object property by property path
+ *
+ * @param object - An object
+ * @param path - A string or array of strings
+ * @param separator - Optional separator if path is a string. '.' by default.
+ *
+ * @returns Value of the path or undefined
+ */
+export declare const getObjValue: (object: ObjectType, path: string | string[], separator?: string | undefined) => any | undefined;
+/**
+ * Converts a JavaScript value containing Set and Map, to a JSON object.
+ *
+ * @param value - A JavaScript value to be converted.
+ *
+ * @returns A JSON object
+ */
+export declare const jsonify: <T>(value: T) => T;
+//# sourceMappingURL=objectUtils.d.ts.map

package/dist/lib/utils/object/objectUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectUtils.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/object/objectUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,WAAY,UAAU,KAAG,OACjB,CAAC;AAEnC;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,sBAAuB,WAAW,mBAEpD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,WAAY,UAAU,KAAG,UACX,CAAC;AAErC;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,WACd,UAAU,QACZ,MAAM,GAAG,MAAM,EAAE,qCAEtB,GAAG,GAAG,SAMR,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,oBAQnB,CAAC"}

package/dist/lib/utils/object/objectUtils.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonify = exports.getObjValue = exports.deepClone = exports.hasKey = exports.isEmptyObject = void 0;
+/**
+ * Checks if an object is empty (i.e.- contains zero keys)
+ *
+ * @param object - An object
+ *
+ * @returns True if the object contains zero keys, false otherwise.
+ */
+const isEmptyObject = (object) => Object.keys(object).length === 0;
+exports.isEmptyObject = isEmptyObject;
+/**
+ * Checks if an object contains a key
+ *
+ * @param object - An object
+ * @param key - The name of a key
+ *
+ * @returns True if the object has the given key, false otherwise.
+ */
+const hasKey = (object, key) => {
+    return key in object;
+};
+exports.hasKey = hasKey;
+/**
+ * Clones an object and all its nested objects
+ *
+ * @param object - An object to be cloned
+ *
+ * @returns An identical object without references to nested objects
+ */
+const deepClone = (object) => JSON.parse(JSON.stringify(object));
+exports.deepClone = deepClone;
+/**
+ * Gets object property by property path
+ *
+ * @param object - An object
+ * @param path - A string or array of strings
+ * @param separator - Optional separator if path is a string. '.' by default.
+ *
+ * @returns Value of the path or undefined
+ */
+const getObjValue = (object, path, separator) => {
+    const pathArray = Array.isArray(path) ? path : path.split(separator || '.');
+    return pathArray.reduce((previous, current) => previous?.[current], object);
+};
+exports.getObjValue = getObjValue;
+/**
+ * Converts a JavaScript value containing Set and Map, to a JSON object.
+ *
+ * @param value - A JavaScript value to be converted.
+ *
+ * @returns A JSON object
+ */
+const jsonify = (value) => {
+    return JSON.parse(JSON.stringify(value, (k, v) => {
+        if (v instanceof Set)
+            return [...v];
+        if (v instanceof Map)
+            return Object.fromEntries(v);
+        return v;
+    }));
+};
+exports.jsonify = jsonify;

package/dist/lib/utils/string/index.d.ts

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

package/dist/lib/utils/string/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/lib/utils/string/index.js

@@ -0,0 +1,13 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (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("./stringUtils"), exports);

package/dist/lib/utils/string/string.types.d.ts

@@ -0,0 +1,2 @@
+export declare type URLSearchParamsObject = Record<string, string | string[] | null>;
+//# sourceMappingURL=string.types.d.ts.map

package/dist/lib/utils/string/string.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.types.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/string/string.types.ts"],"names":[],"mappings":"AAAA,oBAAY,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC"}

package/dist/lib/utils/string/string.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/utils/string/stringUtils.d.ts

@@ -0,0 +1,37 @@
+import { URLSearchParamsObject } from './string.types';
+/**
+ * Separator for variant data files saved to storage.
+ *
+ * @remarks
+ * Refers to the separator that is used by variant data files when they are
+ * saved. If a "master" data file name is "12345.json", and its variant keys
+ * are "card" and "search", its resulting variant file names are:
+ *   - 12345--card.json
+ *   - 12345--search.json
+ * @see ExporterPluginInterface::VARIANT_SEPARATOR in https://www.drupal.org/project/static_suite
+ *
+ * @sealed
+ * Not intended to be over ride.
+ */
+export declare const VARIANT_SEPARATOR = "--";
+/**
+ * Parses a JSON string and logs an error on failure.
+ *
+ * @param jsonString - The string to be parsed.
+ *
+ * @returns A JSON object or null on error.
+ */
+export declare const parseJsonString: (jsonString: string) => any;
+/**
+ * Parses a raw URL search (aka "query string") into an object.
+ *
+ * @remarks
+ * Turns a string like "arg1=a&arg2=b" into an object like
+ * \{ arg1: 'a', arg2: 'b'\}
+ *
+ * @param queryString - A raw URL search string
+ *
+ * @returns An object where its keys are the query arguments.
+ */
+export declare const parseURLSearchParams: (queryString: string) => URLSearchParamsObject;
+//# sourceMappingURL=stringUtils.d.ts.map

package/dist/lib/utils/string/stringUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringUtils.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/string/stringUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,eAAgB,MAAM,KAAG,GAQpD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,gBAClB,MAAM,KAClB,qBAWF,CAAC"}

package/dist/lib/utils/string/stringUtils.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseURLSearchParams = exports.parseJsonString = exports.VARIANT_SEPARATOR = void 0;
+const logger_1 = require("@lib/utils/logger");
+/**
+ * Separator for variant data files saved to storage.
+ *
+ * @remarks
+ * Refers to the separator that is used by variant data files when they are
+ * saved. If a "master" data file name is "12345.json", and its variant keys
+ * are "card" and "search", its resulting variant file names are:
+ *   - 12345--card.json
+ *   - 12345--search.json
+ * @see ExporterPluginInterface::VARIANT_SEPARATOR in https://www.drupal.org/project/static_suite
+ *
+ * @sealed
+ * Not intended to be over ride.
+ */
+exports.VARIANT_SEPARATOR = '--';
+/**
+ * Parses a JSON string and logs an error on failure.
+ *
+ * @param jsonString - The string to be parsed.
+ *
+ * @returns A JSON object or null on error.
+ */
+const parseJsonString = (jsonString) => {
+    let json = null;
+    try {
+        json = JSON.parse(jsonString);
+    }
+    catch (error) {
+        logger_1.logger.error(`Error parsing JSON data "${jsonString}": ${error}`);
+    }
+    return json;
+};
+exports.parseJsonString = parseJsonString;
+/**
+ * Parses a raw URL search (aka "query string") into an object.
+ *
+ * @remarks
+ * Turns a string like "arg1=a&arg2=b" into an object like
+ * \{ arg1: 'a', arg2: 'b'\}
+ *
+ * @param queryString - A raw URL search string
+ *
+ * @returns An object where its keys are the query arguments.
+ */
+const parseURLSearchParams = (queryString) => {
+    const params = new URLSearchParams(queryString);
+    const obj = {};
+    Array.from(params.keys()).forEach(key => {
+        if (params.getAll(key).length > 1) {
+            obj[key] = params.getAll(key);
+        }
+        else {
+            obj[key] = params.get(key);
+        }
+    });
+    return obj;
+};
+exports.parseURLSearchParams = parseURLSearchParams;

package/dist/lib/watcher/index.d.ts

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

package/dist/lib/watcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/watcher/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/lib/watcher/index.js

@@ -0,0 +1,13 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (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("./watcher"), exports);