@global-cache/core 0.2.3

package/dist/server/storage/single-instance/fs.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilesystemStorage = void 0;
+/**
+ * File system storage implementation.
+ */
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+class FilesystemStorage {
+    constructor(basePath) {
+        this.basePath = basePath;
+    }
+    async load(key) {
+        const filePath = this.getFilePath(key);
+        const fileExists = node_fs_1.default.existsSync(filePath);
+        if (!fileExists)
+            return;
+        const content = await node_fs_1.default.promises.readFile(filePath, 'utf8');
+        // todo: json parse safe (with warning)
+        const storedInfo = JSON.parse(content);
+        return {
+            key,
+            state: 'computed',
+            persistent: true,
+            computedAt: storedInfo.computedAt,
+            value: storedInfo.value,
+            sig: storedInfo.sig,
+        };
+    }
+    async save({ key, value, sig }) {
+        const computedAt = Date.now();
+        const storedInfo = { computedAt, sig, value };
+        const content = JSON.stringify(storedInfo, null, 2);
+        const filePath = this.getFilePath(key);
+        await node_fs_1.default.promises.mkdir(node_path_1.default.dirname(filePath), { recursive: true });
+        await node_fs_1.default.promises.writeFile(filePath, content, 'utf8');
+    }
+    async delete(key) {
+        const filePath = this.getFilePath(key);
+        if (node_fs_1.default.existsSync(filePath)) {
+            await node_fs_1.default.promises.rm(filePath);
+        }
+    }
+    getFilePath(key) {
+        return node_path_1.default.join(this.basePath, `${filenamify(key)}.json`);
+    }
+}
+exports.FilesystemStorage = FilesystemStorage;
+// eslint-disable-next-line no-control-regex
+const filenameReservedRegex = /[<>:"/\\|?*\u0000-\u001F]/g;
+function filenamify(s, replacement = '-') {
+    return s
+        .replace(filenameReservedRegex, replacement) // prettier-ignore
+        .replace(/\s+/g, replacement); // additionally replace spaces
+}
+//# sourceMappingURL=fs.js.map

package/dist/server/storage/single-instance/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../../src/server/storage/single-instance/fs.ts"],"names":[],"mappings":";;;;;;AAAA;;GAEG;AACH,sDAAyB;AACzB,0DAA6B;AAU7B,MAAa,iBAAiB;IAC5B,YAAoB,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAExC,KAAK,CAAC,IAAI,CAAC,GAAW;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,iBAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU;YAAE,OAAO;QAExB,MAAM,OAAO,GAAG,MAAM,iBAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7D,uCAAuC;QACvC,MAAM,UAAU,GAAe,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEnD,OAAO;YACL,GAAG;YACH,KAAK,EAAE,UAAU;YACjB,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,UAAU,CAAC,UAAU;YACjC,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,GAAG,EAAE,UAAU,CAAC,GAAG;SACpB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAoB;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAe,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,iBAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,MAAM,iBAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,iBAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,MAAM,iBAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,GAAW;QAC7B,OAAO,mBAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7D,CAAC;CACF;AAzCD,8CAyCC;AAED,4CAA4C;AAC5C,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AAC3D,SAAS,UAAU,CAAC,CAAS,EAAE,WAAW,GAAG,GAAG;IAC9C,OAAO,CAAC;SACL,OAAO,CAAC,qBAAqB,EAAE,WAAW,CAAC,CAAC,kBAAkB;SAC9D,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,8BAA8B;AACjE,CAAC"}

package/dist/server/storage/single-instance/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Single-instance mode of Global Storage Server.
+ * - non-persistent values are stored in memory
+ * - presistent values are stored on file system
+ * - compute-listeners are implemented via memory
+ */
+import { MemoryStorage } from './memory';
+import { FilesystemStorage } from './fs';
+export declare function getMemoryStorage(runId: string): MemoryStorage;
+export declare function getFsStorage(basePath: string): FilesystemStorage;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/storage/single-instance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/single-instance/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAQzC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,iBAO7C;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,qBAO5C"}

package/dist/server/storage/single-instance/index.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMemoryStorage = getMemoryStorage;
+exports.getFsStorage = getFsStorage;
+/**
+ * Single-instance mode of Global Storage Server.
+ * - non-persistent values are stored in memory
+ * - presistent values are stored on file system
+ * - compute-listeners are implemented via memory
+ */
+const memory_1 = require("./memory");
+const fs_1 = require("./fs");
+// In-memory storage of test runs with values
+const memoryStorageMap = new Map();
+const fsStorageMap = new Map();
+// todo: cleanup old testRuns from the map
+function getMemoryStorage(runId) {
+    let storage = memoryStorageMap.get(runId);
+    if (!storage) {
+        storage = new memory_1.MemoryStorage();
+        memoryStorageMap.set(runId, storage);
+    }
+    return storage;
+}
+function getFsStorage(basePath) {
+    let storage = fsStorageMap.get(basePath);
+    if (!storage) {
+        storage = new fs_1.FilesystemStorage(basePath);
+        fsStorageMap.set(basePath, storage);
+    }
+    return storage;
+}
+//# sourceMappingURL=index.js.map

package/dist/server/storage/single-instance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/storage/single-instance/index.ts"],"names":[],"mappings":";;AAeA,4CAOC;AAED,oCAOC;AA/BD;;;;;GAKG;AACH,qCAAyC;AACzC,6BAAyC;AAEzC,6CAA6C;AAC7C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAyB,CAAC;AAC1D,MAAM,YAAY,GAAG,IAAI,GAAG,EAA6B,CAAC;AAE1D,0CAA0C;AAE1C,SAAgB,gBAAgB,CAAC,KAAa;IAC5C,IAAI,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,sBAAa,EAAE,CAAC;QAC9B,gBAAgB,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,YAAY,CAAC,QAAgB;IAC3C,IAAI,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,sBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC1C,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/server/storage/single-instance/memory.d.ts

@@ -0,0 +1,15 @@
+import { TestRunValueInfo } from '../../../shared/value-info';
+import { ITestRunStorage } from '../types';
+export declare class MemoryStorage implements ITestRunStorage {
+    private values;
+    private listeners;
+    load(key: string): Promise<TestRunValueInfo | undefined>;
+    loadByPrefix(prefix: string): Promise<TestRunValueInfo[]>;
+    save(valueInfo: TestRunValueInfo, { notify }?: {
+        notify?: boolean | undefined;
+    }): Promise<void>;
+    clear(): Promise<void>;
+    wait(key: string): Promise<TestRunValueInfo>;
+    private notify;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/server/storage/single-instance/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/single-instance/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAI3C,qBAAa,aAAc,YAAW,eAAe;IACnD,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,SAAS,CAA2C;IAEtD,IAAI,CAAC,GAAG,EAAE,MAAM;IAIhB,YAAY,CAAC,MAAM,EAAE,MAAM;IAI3B,IAAI,CAAC,SAAS,EAAE,gBAAgB,EAAE,EAAE,MAAc,EAAE;;KAAK;IAKzD,KAAK;IAIL,IAAI,CAAC,GAAG,EAAE,MAAM;IAQtB,OAAO,CAAC,MAAM;CAQf"}

package/dist/server/storage/single-instance/memory.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStorage = void 0;
+class MemoryStorage {
+    constructor() {
+        this.values = new Map();
+        this.listeners = new Map();
+    }
+    async load(key) {
+        return this.values.get(key);
+    }
+    async loadByPrefix(prefix) {
+        return [...this.values.values()].filter((valueInfo) => valueInfo.key.startsWith(prefix));
+    }
+    async save(valueInfo, { notify = false } = {}) {
+        this.values.set(valueInfo.key, valueInfo);
+        if (notify)
+            this.notify(valueInfo);
+    }
+    async clear() {
+        this.values.clear();
+    }
+    async wait(key) {
+        return new Promise((resolve) => {
+            const listeners = this.listeners.get(key) || [];
+            listeners.push(resolve);
+            this.listeners.set(key, listeners);
+        });
+    }
+    notify(valueInfo) {
+        const listeners = this.listeners.get(valueInfo.key);
+        try {
+            listeners?.forEach((resolve) => resolve(valueInfo));
+        }
+        finally {
+            this.listeners.delete(valueInfo.key);
+        }
+    }
+}
+exports.MemoryStorage = MemoryStorage;
+//# sourceMappingURL=memory.js.map

package/dist/server/storage/single-instance/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../../src/server/storage/single-instance/memory.ts"],"names":[],"mappings":";;;AAKA,MAAa,aAAa;IAA1B;QACU,WAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;QAC7C,cAAS,GAAG,IAAI,GAAG,EAAgC,CAAC;IAmC9D,CAAC;IAjCC,KAAK,CAAC,IAAI,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAc;QAC/B,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3F,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAA2B,EAAE,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,EAAE;QAC7D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC1C,IAAI,MAAM;YAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW;QACpB,OAAO,IAAI,OAAO,CAAmB,CAAC,OAAO,EAAE,EAAE;YAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAChD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM,CAAC,SAA2B;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,SAAS,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QACtD,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;CACF;AArCD,sCAqCC"}

package/dist/server/storage/types.d.ts

@@ -0,0 +1,14 @@
+import { TestRunValueInfo } from '../../shared/value-info';
+export type ITestRunStorage = {
+    load(key: string): Promise<TestRunValueInfo | undefined>;
+    save(valueInfo: TestRunValueInfo, options?: {
+        notify?: boolean;
+    }): Promise<void>;
+    wait(key: string): Promise<TestRunValueInfo>;
+};
+export type IPersistentStorage = {
+    load(key: string): Promise<TestRunValueInfo | undefined>;
+    save(valueInfo: TestRunValueInfo): Promise<void>;
+    delete(key: string): Promise<void>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/server/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/server/storage/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IACzD,IAAI,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IACzD,IAAI,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC,CAAC"}

package/dist/server/storage/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/server/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/server/storage/types.ts"],"names":[],"mappings":""}

package/dist/server/utils/express.d.ts

@@ -0,0 +1,8 @@
+import express from 'express';
+import http from 'node:http';
+/**
+ * Start server.
+ * See: https://github.com/nodejs/node/issues/21482#issuecomment-626025579
+ */
+export declare function startExpressServer(app: express.Express, port?: number): Promise<http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>>;
+//# sourceMappingURL=express.d.ts.map

package/dist/server/utils/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../../src/server/utils/express.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,SAAI,iFAMtE"}

package/dist/server/utils/express.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startExpressServer = startExpressServer;
+/**
+ * Start server.
+ * See: https://github.com/nodejs/node/issues/21482#issuecomment-626025579
+ */
+async function startExpressServer(app, port = 0) {
+    return new Promise((resolve, reject) => {
+        const server = app.listen(port);
+        server.once('listening', () => resolve(server));
+        server.once('error', reject);
+    });
+}
+//# sourceMappingURL=express.js.map

package/dist/server/utils/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../../src/server/utils/express.ts"],"names":[],"mappings":";;AAOA,gDAMC;AAVD;;;GAGG;AACI,KAAK,UAAU,kBAAkB,CAAC,GAAoB,EAAE,IAAI,GAAG,CAAC;IACrE,OAAO,IAAI,OAAO,CAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAClD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/shared/debug.d.ts

@@ -0,0 +1,4 @@
+import Debug from 'debug';
+export declare const debug: Debug.Debugger;
+export declare const debugKey: (key: string, message: string) => void;
+//# sourceMappingURL=debug.d.ts.map

package/dist/shared/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/shared/debug.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,eAAO,MAAM,KAAK,gBAAwB,CAAC;AAC3C,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,EAAE,SAAS,MAAM,SAGpD,CAAC"}

package/dist/shared/debug.js

@@ -0,0 +1,14 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.debugKey = exports.debug = void 0;
+const debug_1 = __importDefault(require("debug"));
+exports.debug = (0, debug_1.default)('global-cache');
+const debugKey = (key, message) => {
+    const debug = (0, debug_1.default)(`global-cache:${key}`);
+    debug(message);
+};
+exports.debugKey = debugKey;
+//# sourceMappingURL=debug.js.map

package/dist/shared/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/shared/debug.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAEb,QAAA,KAAK,GAAG,IAAA,eAAK,EAAC,cAAc,CAAC,CAAC;AACpC,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,OAAe,EAAE,EAAE;IACvD,MAAM,KAAK,GAAG,IAAA,eAAK,EAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;IAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;AACjB,CAAC,CAAC;AAHW,QAAA,QAAQ,YAGnB"}

package/dist/shared/logger.d.ts

@@ -0,0 +1,2 @@
+export declare const logger: Console;
+//# sourceMappingURL=logger.d.ts.map

package/dist/shared/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/shared/logger.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM,SAAU,CAAC"}

package/dist/shared/logger.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.logger = console;
+//# sourceMappingURL=logger.js.map

package/dist/shared/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/shared/logger.ts"],"names":[],"mappings":";;;AAAa,QAAA,MAAM,GAAG,OAAO,CAAC"}

package/dist/shared/sig.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Calculate the calling signature for a given key:
+ * ttl + stack + computeFn body
+ *
+ * Signature is used to invalidate the key in case of changes in the calling code.
+ * Signature is computed on client and sent to the server.
+ * Server compares the signature with the stored one and invalidates the key if they differ.
+ */
+import { TTL } from './ttl';
+type SingatureParams = {
+    fn: Function;
+    stack: string;
+    ttl?: TTL;
+};
+export type SignatureMismatch = {
+    field: 'fn' | 'stack' | 'ttl' | 'sig';
+    value1: unknown;
+    value2: unknown;
+};
+export declare function calcSignature({ ttl, stack, fn }: SingatureParams): string;
+export declare function checkSignature(key: string, storedSigStr: string, currentSigStr: string): SignatureMismatch | undefined;
+export {};
+//# sourceMappingURL=sig.d.ts.map

package/dist/shared/sig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sig.d.ts","sourceRoot":"","sources":["../../src/shared/sig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,KAAK,eAAe,GAAG;IACrB,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,GAAG,CAAC;CACX,CAAC;AAQF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,IAAI,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,wBAAgB,aAAa,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,eAAe,UAOhE;AAGD,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,iBAAiB,GAAG,SAAS,CAwB/B"}

package/dist/shared/sig.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Calculate the calling signature for a given key:
+ * ttl + stack + computeFn body
+ *
+ * Signature is used to invalidate the key in case of changes in the calling code.
+ * Signature is computed on client and sent to the server.
+ * Server compares the signature with the stored one and invalidates the key if they differ.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calcSignature = calcSignature;
+exports.checkSignature = checkSignature;
+function calcSignature({ ttl, stack, fn }) {
+    // todo: use hashing?
+    // todo: remove spaces and newlines from stack and computeFn?
+    const fnBody = fn.toString().replace(/[\n\s]+/g, ' ');
+    const obj = { ttl, stack, fn: fnBody };
+    return JSON.stringify(obj);
+}
+// eslint-disable-next-line visual/complexity
+function checkSignature(key, storedSigStr, currentSigStr) {
+    const storedSig = parseSignatureSafe(storedSigStr);
+    const currentSig = parseSignatureSafe(currentSigStr);
+    // fallback to string comparison if parsing failed for any of the signatures
+    // todo: remove in the future releases
+    if (!storedSig || !currentSig) {
+        return storedSigStr !== currentSigStr
+            ? createSignatureMismatch('sig', storedSigStr, currentSigStr)
+            : undefined;
+    }
+    // checking stack first -> allows to navigate to the code by click in IDE.
+    if (storedSig.stack !== currentSig.stack) {
+        return createSignatureMismatch('stack', storedSig.stack, currentSig.stack);
+    }
+    if (storedSig.ttl !== currentSig.ttl) {
+        return createSignatureMismatch('ttl', storedSig.ttl, currentSig.ttl);
+    }
+    if (storedSig.fn !== currentSig.fn) {
+        return createSignatureMismatch('fn', storedSig.fn, currentSig.fn);
+    }
+}
+function createSignatureMismatch(field, value1, value2) {
+    return { field, value1, value2 };
+}
+function parseSignatureSafe(sigStr) {
+    try {
+        return JSON.parse(sigStr);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=sig.js.map

package/dist/shared/sig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sig.js","sourceRoot":"","sources":["../../src/shared/sig.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAsBH,sCAOC;AAGD,wCA4BC;AAtCD,SAAgB,aAAa,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAmB;IAC/D,qBAAqB;IACrB,6DAA6D;IAC7D,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,GAAG,GAAiB,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IAErD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,6CAA6C;AAC7C,SAAgB,cAAc,CAC5B,GAAW,EACX,YAAoB,EACpB,aAAqB;IAErB,MAAM,SAAS,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAErD,4EAA4E;IAC5E,sCAAsC;IACtC,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9B,OAAO,YAAY,KAAK,aAAa;YACnC,CAAC,CAAC,uBAAuB,CAAC,KAAK,EAAE,YAAY,EAAE,aAAa,CAAC;YAC7D,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;IAED,0EAA0E;IAC1E,IAAI,SAAS,CAAC,KAAK,KAAK,UAAU,CAAC,KAAK,EAAE,CAAC;QACzC,OAAO,uBAAuB,CAAC,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,SAAS,CAAC,GAAG,KAAK,UAAU,CAAC,GAAG,EAAE,CAAC;QACrC,OAAO,uBAAuB,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,SAAS,CAAC,EAAE,KAAK,UAAU,CAAC,EAAE,EAAE,CAAC;QACnC,OAAO,uBAAuB,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAiC,EACjC,MAAe,EACf,MAAe;IAEf,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAc;IACxC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAiB,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/shared/ttl.d.ts

@@ -0,0 +1,8 @@
+import { StringValue } from 'ms';
+export type TTL = number | StringValue | 'infinite';
+/**
+ * TTL can be a stringified number or a string like "1h" or "infinite".
+ */
+export declare function parseTTL(ttl: string | number | undefined): number | undefined;
+export declare function isExpired(computedAt: number | undefined, ttl: number): boolean;
+//# sourceMappingURL=ttl.d.ts.map

package/dist/shared/ttl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.d.ts","sourceRoot":"","sources":["../../src/shared/ttl.ts"],"names":[],"mappings":"AAAA,OAAW,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAGrC,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;AAEpD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,sBAKxD;AAED,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,WAGpE"}

package/dist/shared/ttl.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTTL = parseTTL;
+exports.isExpired = isExpired;
+const ms_1 = __importDefault(require("ms"));
+/**
+ * TTL can be a stringified number or a string like "1h" or "infinite".
+ */
+function parseTTL(ttl) {
+    if (ttl === '' || ttl === undefined)
+        return undefined;
+    if (ttl === 'infinite')
+        return -1;
+    const ttlNumber = Number(ttl);
+    return Number.isNaN(ttlNumber) ? (0, ms_1.default)(ttl) : ttlNumber;
+}
+function isExpired(computedAt, ttl) {
+    if (!computedAt || ttl === -1)
+        return false;
+    return Date.now() > computedAt + ttl;
+}
+//# sourceMappingURL=ttl.js.map

package/dist/shared/ttl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.js","sourceRoot":"","sources":["../../src/shared/ttl.ts"],"names":[],"mappings":";;;;;AAQA,4BAKC;AAED,8BAGC;AAlBD,4CAAqC;AAKrC;;GAEG;AACH,SAAgB,QAAQ,CAAC,GAAgC;IACvD,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtD,IAAI,GAAG,KAAK,UAAU;QAAE,OAAO,CAAC,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAA,YAAE,EAAC,GAAkB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtE,CAAC;AAED,SAAgB,SAAS,CAAC,UAA8B,EAAE,GAAW;IACnE,IAAI,CAAC,UAAU,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,GAAG,CAAC;AACvC,CAAC"}

package/dist/shared/utils/object.d.ts

@@ -0,0 +1,2 @@
+export declare function removeUndefined<T extends Record<string, unknown>>(obj?: T): T | undefined;
+//# sourceMappingURL=object.d.ts.map

package/dist/shared/utils/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/object.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAGzF"}

package/dist/shared/utils/object.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeUndefined = removeUndefined;
+function removeUndefined(obj) {
+    if (!obj)
+        return;
+    return Object.fromEntries(Object.entries(obj).filter(([_, value]) => value !== undefined));
+}
+//# sourceMappingURL=object.js.map

package/dist/shared/utils/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../src/shared/utils/object.ts"],"names":[],"mappings":";;AAAA,0CAGC;AAHD,SAAgB,eAAe,CAAoC,GAAO;IACxE,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAM,CAAC;AAClG,CAAC"}

package/dist/shared/value-info.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Value info in the scope of particular test run.
+ */
+export type TestRunValueInfo = {
+    key: string;
+    sig: string;
+    state: 'computing' | 'computed' | 'error';
+    computedAt?: number;
+    value?: unknown;
+    persistent?: boolean;
+    prevValue?: unknown;
+    errorMessage?: string;
+};
+export declare function updateValueInfo(valueInfo: TestRunValueInfo, props: Partial<TestRunValueInfo>): TestRunValueInfo & Partial<TestRunValueInfo>;
+export declare function setComputed(valueInfo: TestRunValueInfo, value: unknown): void;
+export declare function setError(valueInfo: TestRunValueInfo, errorMessage: string): void;
+export declare function getStaleValue(valueInfo?: TestRunValueInfo | null): unknown;
+//# sourceMappingURL=value-info.d.ts.map

package/dist/shared/value-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-info.d.ts","sourceRoot":"","sources":["../../src/shared/value-info.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wBAAgB,eAAe,CAAC,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,gDAE5F;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,QAOtE;AAED,wBAAgB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,QAOzE;AAED,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,gBAAgB,GAAG,IAAI,WAEhE"}

package/dist/shared/value-info.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Value info in the scope of particular test run.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateValueInfo = updateValueInfo;
+exports.setComputed = setComputed;
+exports.setError = setError;
+exports.getStaleValue = getStaleValue;
+function updateValueInfo(valueInfo, props) {
+    return Object.assign(valueInfo, props);
+}
+function setComputed(valueInfo, value) {
+    updateValueInfo(valueInfo, {
+        state: 'computed',
+        value,
+        computedAt: Date.now(),
+        errorMessage: undefined,
+    });
+}
+function setError(valueInfo, errorMessage) {
+    updateValueInfo(valueInfo, {
+        state: 'error',
+        errorMessage,
+        value: undefined,
+        computedAt: undefined,
+    });
+}
+function getStaleValue(valueInfo) {
+    return valueInfo?.persistent ? valueInfo.prevValue : valueInfo?.value;
+}
+//# sourceMappingURL=value-info.js.map

package/dist/shared/value-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-info.js","sourceRoot":"","sources":["../../src/shared/value-info.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAaH,0CAEC;AAED,kCAOC;AAED,4BAOC;AAED,sCAEC;AAxBD,SAAgB,eAAe,CAAC,SAA2B,EAAE,KAAgC;IAC3F,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,SAAgB,WAAW,CAAC,SAA2B,EAAE,KAAc;IACrE,eAAe,CAAC,SAAS,EAAE;QACzB,KAAK,EAAE,UAAU;QACjB,KAAK;QACL,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;QACtB,YAAY,EAAE,SAAS;KACxB,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,QAAQ,CAAC,SAA2B,EAAE,YAAoB;IACxE,eAAe,CAAC,SAAS,EAAE;QACzB,KAAK,EAAE,OAAO;QACd,YAAY;QACZ,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,SAAS;KACtB,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,aAAa,CAAC,SAAmC;IAC/D,OAAO,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC;AACxE,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@global-cache/core",
+  "description": "Key-value cache for sharing data between parallel workers.",
+  "version": "0.2.3",
+  "type": "commonjs",
+  "exports": {
+    ".": "./dist/index.js",
+    "./server": "./dist/server/index.js",
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run --no-cache --testTimeout 5000 --dir ./test",
+    "test:d": "DEBUG=global-cache* npm t",
+    "release": "release-it"
+  },
+  "release-it": {
+    "git": false
+  },
+  "dependencies": {
+    "@types/debug": "^4.1.12",
+    "@types/express": "^5.0.3",
+    "@types/ms": "^2.1.0",
+    "debug": "^4.4.1",
+    "express": "^5.1.0",
+    "ms": "^2.1.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "funding": "https://github.com/sponsors/vitalets",
+  "license": "MIT"
+}

package/src/client/api.ts

@@ -0,0 +1,51 @@
+import type { GetValueParams, GetValueResponse } from '../server/routes/get';
+import type { SetValueParams, SetValueResponse } from '../server/routes/set';
+import type { GetStaleParams, SetStaleResponse } from '../server/routes/get-stale';
+import type { GetStaleListParams, SetStaleListResponse } from '../server/routes/get-stale-list';
+import { TTL } from '../shared/ttl';
+import { HttpJson } from './utils/http-json';
+import { prepareQueryParams } from './utils/http-query';
+import { throwIfHttpError } from './utils/http-error';
+import { getStaleValue } from '../shared/value-info';
+
+export class StorageApi {
+  private http: HttpJson;
+
+  constructor(serverUrl: string, runId: string) {
+    const baseUrl = new URL(`/run/${runId}/`, serverUrl).toString();
+    this.http = new HttpJson(baseUrl);
+  }
+
+  async get({ key, sig, ttl }: { key: string; sig: string; ttl?: TTL }) {
+    const params: GetValueParams = prepareQueryParams({ key, sig, ttl });
+    const res = await this.http.get('get', params);
+    await throwIfHttpError(res, `Failed to get key "${key}":`);
+    return (await res.json()) as GetValueResponse;
+  }
+
+  async set({ key, value, error }: { key: string; value: unknown; error?: Error }) {
+    const body: SetValueParams = { key, value, error: error?.message };
+    const res = await this.http.post('set', body);
+    await throwIfHttpError(res, `Failed to save key "${key}":`);
+    return (await res.json()) as SetValueResponse;
+  }
+
+  async getStale({ key }: GetStaleParams) {
+    const res = await this.http.get('get-stale', { key });
+    await throwIfHttpError(res, `Failed to get stale key "${key}":`);
+    const valueInfo = (await res.json()) as SetStaleResponse;
+    return getStaleValue(valueInfo);
+  }
+
+  async getStaleList({ prefix }: GetStaleListParams) {
+    const res = await this.http.get('get-stale-list', { prefix });
+    await throwIfHttpError(res, `Failed to get stale list for prefix "${prefix}":`);
+    const valueInfoList = (await res.json()) as SetStaleListResponse;
+    return valueInfoList.map((valueInfo) => getStaleValue(valueInfo));
+  }
+
+  async clear() {
+    const res = await this.http.post('clear');
+    await throwIfHttpError(res, 'Failed to clear session:');
+  }
+}