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

package/dist/lib/store/workDir/storage/getChangedLinesSince.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChangedLinesSince = void 0;
+const fs_1 = __importDefault(require("fs"));
+const logger_1 = require("@lib/utils/logger");
+const getLogFile_1 = require("./getLogFile");
+/**
+   * Get changed files since a date.
+   *
+   * @param sinceDate - Date to search
+
+  * @returns Array of changed lines
+   */
+const getChangedLinesSince = (sinceDate) => {
+    let allLines = [];
+    const logFile = (0, getLogFile_1.getLogFile)();
+    if (logFile) {
+        try {
+            allLines = fs_1.default.readFileSync(logFile).toString().split('\n');
+        }
+        catch (e) {
+            logger_1.logger.error(`Error reading metadata log file located at ${`logFile`}: ${e}`);
+        }
+    }
+    // todo - Do not use dates and use timestamps in all cases
+    //  to avoid having to fix offsets.
+    const date = new Date();
+    const dateOffset = -(date.getTimezoneOffset() * 60 * 1000);
+    const changedLines = allLines.filter(line => {
+        const uniqueId = line.substring(0, 32);
+        if (!uniqueId) {
+            return false;
+        }
+        const dateString = uniqueId.replace(/(\d{4})-(\d{2})-(\d{2})_(\d{2})-(\d{2})-(\d{2})\.(\d{3}).*/, '$1-$2-$3T$4:$5:$6.$7');
+        const uniqueIdDate = Date.parse(dateString) + dateOffset;
+        return uniqueIdDate && uniqueIdDate > sinceDate.getTime();
+    });
+    logger_1.logger.debug(`Found ${changedLines.length} changed lines`);
+    changedLines.forEach(line => {
+        logger_1.logger.debug(`Found changed line: ${line}`);
+    });
+    return changedLines;
+};
+exports.getChangedLinesSince = getChangedLinesSince;

package/dist/lib/store/workDir/storage/getDataFromLogLine.d.ts

@@ -0,0 +1,10 @@
+import { LogLineData } from '../workDir.types';
+/**
+ * Extract information from Static Suite's log line.
+ *
+ * @param line - Log line.
+ *
+ * @returns An object with parsed data, or null if line format is not valid.
+ */
+export declare const getDataFromLogLine: (line: string) => LogLineData | null;
+//# sourceMappingURL=getDataFromLogLine.d.ts.map

package/dist/lib/store/workDir/storage/getDataFromLogLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDataFromLogLine.d.ts","sourceRoot":"","sources":["../../../../../src/lib/store/workDir/storage/getDataFromLogLine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,SAAU,MAAM,KAAG,WAAW,GAAG,IAqB/D,CAAC"}

package/dist/lib/store/workDir/storage/getDataFromLogLine.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDataFromLogLine = void 0;
+/**
+ * Extract information from Static Suite's log line.
+ *
+ * @param line - Log line.
+ *
+ * @returns An object with parsed data, or null if line format is not valid.
+ */
+const getDataFromLogLine = (line) => {
+    const matches = line.match(/^(\S+) (\S+) \[ID: ([^\]]+)] (.+)/);
+    if (matches) {
+        const uniqueId = matches[1];
+        const operation = matches[2];
+        const fileId = matches[3];
+        const [fileLabel, uri] = matches[4].split(' | ');
+        const [, uriTarget] = uri.split('://');
+        if (operation === 'write' || operation === 'delete') {
+            return {
+                uniqueId,
+                operation,
+                file: {
+                    id: fileId,
+                    label: fileLabel,
+                    relativePath: uriTarget,
+                },
+            };
+        }
+    }
+    return null;
+};
+exports.getDataFromLogLine = getDataFromLogLine;

package/dist/lib/store/workDir/storage/getLogFile.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Gets the absolute path to Static Suite's log file.
+ *
+ * @returns The absolute path to Static Suite's log file.
+ */
+declare const getLogFile: () => string | null;
+export { getLogFile };
+//# sourceMappingURL=getLogFile.d.ts.map

package/dist/lib/store/workDir/storage/getLogFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getLogFile.d.ts","sourceRoot":"","sources":["../../../../../src/lib/store/workDir/storage/getLogFile.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,QAAA,MAAM,UAAU,QAAO,MAAM,GAAG,IAC+B,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/lib/store/workDir/storage/getLogFile.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLogFile = void 0;
+const config_1 = require("@lib/config");
+/**
+ * Gets the absolute path to Static Suite's log file.
+ *
+ * @returns The absolute path to Static Suite's log file.
+ */
+const getLogFile = () => config_1.config.workDir ? `${config_1.config.workDir}/lock-executed.log` : null;
+exports.getLogFile = getLogFile;

package/dist/lib/store/workDir/storage/index.d.ts

@@ -0,0 +1,4 @@
+export * from './getChangedLinesSince';
+export * from './getDataFromLogLine';
+export * from './getLogFile';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/store/workDir/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/store/workDir/storage/index.ts"],"names":[],"mappings":"AAKA,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}

package/dist/lib/store/workDir/storage/index.js

@@ -0,0 +1,20 @@
+"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 });
+/*
+These functions are separated from workDirHelper, since they are specific
+to the current storage backend (log files saved on disk) and they can change
+in the future.
+*/
+__exportStar(require("./getChangedLinesSince"), exports);
+__exportStar(require("./getDataFromLogLine"), exports);
+__exportStar(require("./getLogFile"), exports);

package/dist/lib/store/workDir/workDir.types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * A group of changed files in Static Suite's data dir.
+ */
+export declare type ChangedFiles = {
+    /**
+     * A list of updated files (both newly added and changed files).
+     */
+    updated: string[];
+    /**
+     * A list of deleted files.
+     */
+    deleted: string[];
+};
+/**
+ * Information from a Static Suite's log line.
+ */
+export declare type LogLineData = {
+    /**
+     * The unique ID of the write/delete operation from Static Suite.
+     */
+    uniqueId: string;
+    /**
+     * The type of operation executed in the log line.
+     */
+    operation: 'write' | 'delete';
+    /**
+     * Information about the affected file
+     */
+    file: {
+        /**
+         * File ID, a string identifying the file in a meaningful way, usually a numeric ID
+         */
+        id: string;
+        /**
+         * A long text identifying the file in a meaningful way, usually the content title.
+         */
+        label: string;
+        /**
+         * Relative file path inside data dir.
+         */
+        relativePath: string;
+    };
+};
+//# sourceMappingURL=workDir.types.d.ts.map

package/dist/lib/store/workDir/workDir.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workDir.types.d.ts","sourceRoot":"","sources":["../../../../src/lib/store/workDir/workDir.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,YAAY,GAAG;IACzB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,oBAAY,WAAW,GAAG;IACxB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,OAAO,GAAG,QAAQ,CAAC;IAE9B;;OAEG;IACH,IAAI,EAAE;QACJ;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH,CAAC"}

package/dist/lib/store/workDir/workDir.types.js

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

package/dist/lib/store/workDir/workDirHelper.d.ts

@@ -0,0 +1,20 @@
+import { ChangedFiles } from './workDir.types';
+export declare const workDirHelper: {
+    /**
+     * Gets date of last modification of work directory.
+     *
+     * @returns The date of last modification of work directory, or null if directory not found.
+     */
+    getModificationDate: () => Date | null;
+    /**
+     * Get changed files since a date.
+     *
+     * @param sinceDate - Date to search
+     *
+     * @returns Object with two properties:
+     * - updated: array of changed files.
+     * - deleted: array of deleted files.
+     */
+    getChangedFilesSince: (sinceDate: Date) => ChangedFiles;
+};
+//# sourceMappingURL=workDirHelper.d.ts.map

package/dist/lib/store/workDir/workDirHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workDirHelper.d.ts","sourceRoot":"","sources":["../../../../src/lib/store/workDir/workDirHelper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAe,MAAM,iBAAiB,CAAC;AAO5D,eAAO,MAAM,aAAa;IACxB;;;;OAIG;+BACsB,IAAI,GAAG,IAAI;IAKpC;;;;;;;;OAQG;sCAC+B,IAAI,KAAG,YAAY;CA6BtD,CAAC"}

package/dist/lib/store/workDir/workDirHelper.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.workDirHelper = void 0;
+const fs_1 = require("@lib/utils/fs");
+const logger_1 = require("@lib/utils/logger");
+const storage_1 = require("./storage");
+exports.workDirHelper = {
+    /**
+     * Gets date of last modification of work directory.
+     *
+     * @returns The date of last modification of work directory, or null if directory not found.
+     */
+    getModificationDate: () => {
+        const logFile = (0, storage_1.getLogFile)();
+        return logFile ? (0, fs_1.getModificationDate)(logFile) : null;
+    },
+    /**
+     * Get changed files since a date.
+     *
+     * @param sinceDate - Date to search
+     *
+     * @returns Object with two properties:
+     * - updated: array of changed files.
+     * - deleted: array of deleted files.
+     */
+    getChangedFilesSince: (sinceDate) => {
+        const changedLines = (0, storage_1.getChangedLinesSince)(sinceDate);
+        const lineData = {};
+        changedLines.forEach(line => {
+            const dataFromLogLine = (0, storage_1.getDataFromLogLine)(line);
+            if (dataFromLogLine) {
+                // Save lines keyed by its relativePath so only the last
+                // operation on the same file is processed.
+                lineData[dataFromLogLine.file.relativePath] = dataFromLogLine;
+            }
+        });
+        const lineDataArray = Object.values(lineData);
+        const updated = lineDataArray
+            .filter(data => data.operation === 'write')
+            .map(data => data.file.relativePath);
+        updated.forEach(file => {
+            logger_1.logger.debug(`Found updated file "${file}"`);
+        });
+        const deleted = lineDataArray
+            .filter(data => data.operation === 'delete')
+            .map(data => data.file.relativePath);
+        deleted.forEach(file => {
+            logger_1.logger.debug(`Found deleted file "${file}"`);
+        });
+        return { updated, deleted };
+    },
+};

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

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

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

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

package/dist/lib/task/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("./taskManager"), exports);
+__exportStar(require("./taskRunner"), exports);

package/dist/lib/task/task.types.d.ts

@@ -0,0 +1,140 @@
+import { Store } from '@lib/store/store.types';
+/**
+ * A service to handle the execution of tasks.
+ *
+ * @public
+ */
+export declare type TaskRunner = {
+    /**
+     * Runs a task and returns its results with metadata.
+     *
+     * @remarks
+     * It checks several validations before a task is run, and then task is executed.
+     *
+     * It logs an error and throws an exception if any problem occurs during the
+     * task execution.
+     *
+     * @param taskId - Task ID (filename without extension and suffix) of the task
+     * to be executed. @see {@link ModuleInfo#id | Definition of a module ID}
+     * @param args - Optional object with task arguments.
+     *
+     * @returns The result of the task as a JSON object with data and metadata keys,
+     * or an error response if some validation is not met.
+     *
+     * @example
+     * Here's a result example:
+     * ```
+     * {
+     * data: ['title 1', 'title 2'],
+     *  metadata: {
+     *    contentType: 'application/json',
+     *    execTime: 2,
+     *  }
+     * }
+     * ```
+  
+    * @throws
+     * Exception thrown if any problem occurs during the task execution.
+     */
+    run(taskId: string, args: TaskArgs): TaskSuccessfulResponse | TaskErrorResponse;
+};
+/**
+ * An object with task arguments.
+ *
+ * @public
+ */
+export declare type TaskArgs = Record<string, any>;
+/**
+ * The result that a task returns after being executed.
+ */
+export declare type TaskModuleResult = {
+    /**
+     * A result, which can be of any kind (and array, an object, a string, etc)
+     */
+    result: any;
+    /**
+     * Optional content type for the data available in "result"
+     *
+     * @remarks
+     * Data coming from the task can be anything (XML, a string, etc).
+     * This content type is added to the metadata section of the TaskResponse.
+     * @see {@link TaskSuccessfulResponse#metadata}.
+     *
+     * @defaultValue 'application/json'
+     */
+    contentType?: string;
+};
+/**
+ * A successful response returned after executing a task.
+ *
+ * @remarks
+ * It takes the results from a TaskModule#taskHandler, and wraps them into an
+ * structure with metadata. @see {@link TaskModule#default}
+ *
+ * @public
+ */
+export declare type TaskSuccessfulResponse = {
+    /**
+     * Data returned by the task. @see {@link TaskModule#default}
+     */
+    data: any;
+    /**
+     * Task metadata
+     */
+    metadata: {
+        /**
+         * Content type for the data available in "data"
+         *
+         * @remarks
+         * Even thought this structure is a JSON object, data coming from the
+         * task can be anything (XML, a string, etc). It must be specified so any
+         * consumer of this data knows what is being returned.
+         */
+        contentType: string;
+        /**
+         * Execution time taken by the task, in milliseconds.
+         */
+        execTimeMs: number;
+    };
+};
+/**
+ * A module that defines a task.
+ */
+export declare type TaskModule = {
+    /**
+     * The handler that executes a task.
+     *
+     * @remarks
+     * It receives the store data and a set of arguments, executes the task
+     * and returns its results.
+     *
+     * @param options - An object with options for the task: store and args
+     */
+    default(options: {
+        store: Store;
+        args: TaskArgs;
+    }): TaskModuleResult;
+};
+/**
+ * An error response returned after executing a task.
+ *
+ * @remarks
+ * It takes an string from TaskModule#taskHandler, and wraps them into an
+ * structure with metadata. @see {@link TaskModule#default}
+ *
+ * @public
+ */
+export declare type TaskErrorResponse = {
+    /**
+     * Error message from the task, usually coming from a failed validation.
+     */
+    error: string;
+};
+/**
+ * Tells whether a task response is erroneous or not.
+ *
+ * @param taskResponse - A response (successful or erroneous) from the task handler.
+ * @returns True if taskResponse is erroneous.
+ */
+export declare const isTaskErrorResponse: (taskResponse: TaskSuccessfulResponse | TaskErrorResponse) => taskResponse is TaskErrorResponse;
+//# sourceMappingURL=task.types.d.ts.map

package/dist/lib/task/task.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.types.d.ts","sourceRoot":"","sources":["../../../src/lib/task/task.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAE/C;;;;GAIG;AACH,oBAAY,UAAU,GAAG;IACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,GAAG,CACD,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,GACb,sBAAsB,GAAG,iBAAiB,CAAC;CAC/C,CAAC;AAEF;;;;GAIG;AACH,oBAAY,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE3C;;GAEG;AACH,oBAAY,gBAAgB,GAAG;IAC7B;;OAEG;IACH,MAAM,EAAE,GAAG,CAAC;IAEZ;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;;;GAQG;AACH,oBAAY,sBAAsB,GAAG;IACnC;;OAEG;IACH,IAAI,EAAE,GAAG,CAAC;IAEV;;OAEG;IACH,QAAQ,EAAE;QACR;;;;;;;WAOG;QACH,WAAW,EAAE,MAAM,CAAC;QAEpB;;WAEG;QACH,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,oBAAY,UAAU,GAAG;IACvB;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,GAAG,gBAAgB,CAAC;CACtE,CAAC;AACF;;;;;;;;GAQG;AACH,oBAAY,iBAAiB,GAAG;IAC9B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,iBAChB,sBAAsB,GAAG,iBAAiB,sCAED,CAAC"}

package/dist/lib/task/task.types.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTaskErrorResponse = void 0;
+/**
+ * Tells whether a task response is erroneous or not.
+ *
+ * @param taskResponse - A response (successful or erroneous) from the task handler.
+ * @returns True if taskResponse is erroneous.
+ */
+const isTaskErrorResponse = (taskResponse) => taskResponse.error !== undefined;
+exports.isTaskErrorResponse = isTaskErrorResponse;

package/dist/lib/task/taskManager.d.ts

@@ -0,0 +1,10 @@
+import { TaskModule } from './task.types';
+/**
+ * A manager for tasks stored in a user-land directory defined by configuration.
+ *
+ * @remarks
+ * It extends dirBasedModuleGroupManager, which manages groups of modules based
+ * on a directory: @see {@link dirBasedModuleGroupManager}
+ */
+export declare const taskManager: import("../utils/module/module.types").ModuleGroupManager<TaskModule>;
+//# sourceMappingURL=taskManager.d.ts.map

package/dist/lib/task/taskManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskManager.d.ts","sourceRoot":"","sources":["../../../src/lib/task/taskManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,uEAAiD,CAAC"}

package/dist/lib/task/taskManager.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taskManager = void 0;
+const module_1 = require("@lib/utils/module");
+/**
+ * A manager for tasks stored in a user-land directory defined by configuration.
+ *
+ * @remarks
+ * It extends dirBasedModuleGroupManager, which manages groups of modules based
+ * on a directory: @see {@link dirBasedModuleGroupManager}
+ */
+exports.taskManager = (0, module_1.dirBasedModuleGroupManager)('task');

package/dist/lib/task/taskRunner.d.ts

@@ -0,0 +1,3 @@
+import { TaskRunner } from './task.types';
+export declare const taskRunner: TaskRunner;
+//# sourceMappingURL=taskRunner.d.ts.map

package/dist/lib/task/taskRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskRunner.d.ts","sourceRoot":"","sources":["../../../src/lib/task/taskRunner.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,UAAU,EAIX,MAAM,cAAc,CAAC;AAkBtB,eAAO,MAAM,UAAU,EAAE,UAkDxB,CAAC"}

package/dist/lib/task/taskRunner.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taskRunner = void 0;
+const microtime_1 = __importDefault(require("microtime"));
+const config_1 = require("@lib/config");
+const store_1 = require("@lib/store");
+const logger_1 = require("@lib/utils/logger");
+const taskManager_1 = require("./taskManager");
+let count = 0;
+/**
+ * Creates a TaskErrorResponse object ready to be returned to clients.
+ *
+ * @param message - Error message
+ *
+ * @returns A JSON object with an error key
+ *
+ * @internal
+ */
+const createErrorResponse = (message) => {
+    logger_1.logger.error(message);
+    return { error: message };
+};
+exports.taskRunner = {
+    run: (taskId, args) => {
+        if (!config_1.config.taskDir) {
+            return createErrorResponse('No task directory ("taskDir") configured');
+        }
+        if (!taskId) {
+            return createErrorResponse('No task ID received');
+        }
+        const taskModuleInfo = taskManager_1.taskManager.getModuleGroupInfo().get(taskId);
+        if (!taskModuleInfo) {
+            return createErrorResponse(`Task module for ID ${taskId} not found`);
+        }
+        count += 1;
+        const startDate = microtime_1.default.now();
+        const argsString = JSON.stringify(args);
+        logger_1.logger.debug(`#${count} Task started: "${taskId}", args "${argsString}"`);
+        const taskResult = {
+            result: undefined,
+            contentType: undefined,
+        };
+        try {
+            const taskModule = taskModuleInfo.getModule();
+            const taskResponse = taskModule.default({
+                store: store_1.store,
+                args,
+            });
+            taskResult.result = taskResponse?.result;
+            taskResult.contentType = taskResponse?.contentType || 'application/json';
+        }
+        catch (e) {
+            // Log error and rethrow.
+            logger_1.logger.error(`#${count} Task error: "${taskId}", args "${argsString}": ${e}`);
+            throw e;
+        }
+        const execTimeMs = (microtime_1.default.now() - startDate) / 1000;
+        const response = {
+            data: taskResult.result,
+            metadata: {
+                contentType: taskResult.contentType || 'application/json',
+                execTimeMs,
+            },
+        };
+        logger_1.logger.debug(`#${count} Task "${taskId}" took ${execTimeMs} ms.`);
+        return response;
+    },
+};

package/dist/lib/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.18.19"
+    }
+  ]
+}

package/dist/lib/utils/array/arrayUtils.d.ts

@@ -0,0 +1,2 @@
+export declare const arrayRemoveByValue: (arr: any[], value: any) => void;
+//# sourceMappingURL=arrayUtils.d.ts.map

package/dist/lib/utils/array/arrayUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayUtils.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/array/arrayUtils.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,kBAAkB,QAAS,GAAG,EAAE,SAAS,GAAG,KAAG,IAK3D,CAAC"}

package/dist/lib/utils/array/arrayUtils.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrayRemoveByValue = void 0;
+// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+const arrayRemoveByValue = (arr, value) => {
+    const index = arr.indexOf(value);
+    if (index !== -1) {
+        arr.splice(index, 1);
+    }
+};
+exports.arrayRemoveByValue = arrayRemoveByValue;

package/dist/lib/utils/cache/cacheBinManager.d.ts

@@ -0,0 +1,37 @@
+export declare type CacheBin<Type> = Map<string, Type>;
+export declare type Cache = {
+    /**
+     * Gets a cache bin by its id.
+     *
+     * @param binId - The id of the bin.
+     * @returns The cache bin.
+     */
+    bin<Type>(binId: string): CacheBin<Type>;
+    /**
+     * Returns a boolean indicating whether a cache bin
+     * with the specified key exists or not.
+     *
+     * @param binId - The id of the bin.
+     * @returns True if the cache bin exists, false otherwise.
+     */
+    has(binId: string): boolean;
+    /**
+     * Gets an array of keys of all available cache bins.
+     *
+     * @returns An array of cache bin keys.
+     */
+    keys(): string[];
+    /**
+     * Clears all available cache bins.
+     */
+    clear(): void;
+};
+/**
+ * Cache system based on specialized bins.
+ *
+ * All cache items belong to a specific bin ("file", "query", etc),
+ * which is a kind of "folder" or "directory" where data belonging
+ * to the same context/domain is stored altogether.
+ */
+export declare const cache: Cache;
+//# sourceMappingURL=cacheBinManager.d.ts.map

package/dist/lib/utils/cache/cacheBinManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheBinManager.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/cache/cacheBinManager.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAE/C,oBAAY,KAAK,GAAG;IAClB;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEzC;;;;;;OAMG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAE5B;;;;OAIG;IACH,IAAI,IAAI,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAoBF;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,EAAE,KA6BnB,CAAC"}