@sidequest/engine 1.0.0-next.4

package/dist/job/job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.js","sources":["../../src/job/job.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/queue/grant-queue-config.cjs

@@ -0,0 +1,49 @@
+'use strict';
+
+var core = require('@sidequest/core');
+
+/**
+ * Determines if a new queue configuration differs from the existing queue configuration.
+ *
+ * Compares the provided queue data against the current queue configuration to detect
+ * any changes in concurrency, state, or priority properties. Only checks properties
+ * that are defined (truthy) in the new queue data.
+ *
+ * @param queue - The new queue data to compare against the existing configuration
+ * @param queueConfig - The current queue configuration to compare against
+ * @returns `true` if any of the defined properties in the new queue data differ from
+ *          the corresponding properties in the existing configuration, `false` otherwise
+ */
+function differentQueueConfig(queue, queueConfig) {
+    return ((!!queue.concurrency && queue.concurrency !== queueConfig.concurrency) ||
+        (!!queue.state && queue.state !== queueConfig.state) ||
+        (!!queue.priority && queue.priority !== queueConfig.priority));
+}
+/**
+ * Ensures a queue configuration exists, creating it if necessary.
+ * @param queue The name of the queue.
+ * @param config Optional configuration for the new queue.
+ * @returns The queue configuration.
+ */
+async function grantQueueConfig(backend, queue, defaults) {
+    const queueConfig = await backend?.getQueue(queue.name);
+    if (queueConfig) {
+        if (differentQueueConfig(queue, queueConfig)) {
+            core.logger("Engine").warn(`Queue config for ${queue.name} exists but differs from the provided configuration. Updating...`);
+            return await backend.updateQueue({ ...queueConfig, ...queue });
+        }
+        else {
+            return queueConfig;
+        }
+    }
+    const newConfig = {
+        ...defaults,
+        ...queue,
+    };
+    core.logger("Engine").info(`Creating queue config for ${queue.name}`);
+    return backend?.createNewQueue(newConfig);
+}
+
+exports.differentQueueConfig = differentQueueConfig;
+exports.grantQueueConfig = grantQueueConfig;
+//# sourceMappingURL=grant-queue-config.cjs.map

package/dist/queue/grant-queue-config.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"grant-queue-config.cjs","sources":["../../src/queue/grant-queue-config.ts"],"sourcesContent":[null],"names":["logger"],"mappings":";;;;AAUA;;;;;;;;;;;AAWG;AACG,SAAU,oBAAoB,CAAC,KAAmB,EAAE,WAAwB,EAAA;AAChF,IAAA,QACE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,KAAK,WAAW,CAAC,WAAW;AACrE,SAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW,CAAC,KAAK,CAAC;AACpD,SAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,WAAW,CAAC,QAAQ,CAAC;AAEjE;AAEA;;;;;AAKG;AACI,eAAe,gBAAgB,CAAC,OAAgB,EAAE,KAAmB,EAAE,QAAwB,EAAA;IACpG,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;IACvD,IAAI,WAAW,EAAE;AACf,QAAA,IAAI,oBAAoB,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE;AAC5C,YAAAA,WAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CACnB,CAAA,iBAAA,EAAoB,KAAK,CAAC,IAAI,CAAA,gEAAA,CAAkE,CACjG;AACD,YAAA,OAAO,MAAM,OAAO,CAAC,WAAW,CAAC,EAAE,GAAG,WAAW,EAAE,GAAG,KAAK,EAAE,CAAC;QAChE;aAAO;AACL,YAAA,OAAO,WAAW;QACpB;IACF;AAEA,IAAA,MAAM,SAAS,GAAiB;AAC9B,QAAA,GAAG,QAAQ;AACX,QAAA,GAAG,KAAK;KACT;AAED,IAAAA,WAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA,0BAAA,EAA6B,KAAK,CAAC,IAAI,CAAA,CAAE,CAAC;AAEhE,IAAA,OAAO,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC;AAC3C;;;;;"}

package/dist/queue/grant-queue-config.d.ts

@@ -0,0 +1,32 @@
+import { NewQueueData, Backend } from '@sidequest/backend';
+import { QueueConfig } from '@sidequest/core';
+
+/**
+ * Represents the default configuration data for creating a new queue.
+ * This type excludes the 'id' field from NewQueueData, as IDs are typically
+ * generated automatically when creating new queue instances.
+ */
+type QueueDefaults = Omit<NewQueueData, "id" | "name">;
+/**
+ * Determines if a new queue configuration differs from the existing queue configuration.
+ *
+ * Compares the provided queue data against the current queue configuration to detect
+ * any changes in concurrency, state, or priority properties. Only checks properties
+ * that are defined (truthy) in the new queue data.
+ *
+ * @param queue - The new queue data to compare against the existing configuration
+ * @param queueConfig - The current queue configuration to compare against
+ * @returns `true` if any of the defined properties in the new queue data differ from
+ *          the corresponding properties in the existing configuration, `false` otherwise
+ */
+declare function differentQueueConfig(queue: NewQueueData, queueConfig: QueueConfig): boolean;
+/**
+ * Ensures a queue configuration exists, creating it if necessary.
+ * @param queue The name of the queue.
+ * @param config Optional configuration for the new queue.
+ * @returns The queue configuration.
+ */
+declare function grantQueueConfig(backend: Backend, queue: NewQueueData, defaults?: QueueDefaults): Promise<QueueConfig>;
+
+export { differentQueueConfig, grantQueueConfig };
+export type { QueueDefaults };

package/dist/queue/grant-queue-config.js

@@ -0,0 +1,46 @@
+import { logger } from '@sidequest/core';
+
+/**
+ * Determines if a new queue configuration differs from the existing queue configuration.
+ *
+ * Compares the provided queue data against the current queue configuration to detect
+ * any changes in concurrency, state, or priority properties. Only checks properties
+ * that are defined (truthy) in the new queue data.
+ *
+ * @param queue - The new queue data to compare against the existing configuration
+ * @param queueConfig - The current queue configuration to compare against
+ * @returns `true` if any of the defined properties in the new queue data differ from
+ *          the corresponding properties in the existing configuration, `false` otherwise
+ */
+function differentQueueConfig(queue, queueConfig) {
+    return ((!!queue.concurrency && queue.concurrency !== queueConfig.concurrency) ||
+        (!!queue.state && queue.state !== queueConfig.state) ||
+        (!!queue.priority && queue.priority !== queueConfig.priority));
+}
+/**
+ * Ensures a queue configuration exists, creating it if necessary.
+ * @param queue The name of the queue.
+ * @param config Optional configuration for the new queue.
+ * @returns The queue configuration.
+ */
+async function grantQueueConfig(backend, queue, defaults) {
+    const queueConfig = await backend?.getQueue(queue.name);
+    if (queueConfig) {
+        if (differentQueueConfig(queue, queueConfig)) {
+            logger("Engine").warn(`Queue config for ${queue.name} exists but differs from the provided configuration. Updating...`);
+            return await backend.updateQueue({ ...queueConfig, ...queue });
+        }
+        else {
+            return queueConfig;
+        }
+    }
+    const newConfig = {
+        ...defaults,
+        ...queue,
+    };
+    logger("Engine").info(`Creating queue config for ${queue.name}`);
+    return backend?.createNewQueue(newConfig);
+}
+
+export { differentQueueConfig, grantQueueConfig };
+//# sourceMappingURL=grant-queue-config.js.map

package/dist/queue/grant-queue-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grant-queue-config.js","sources":["../../src/queue/grant-queue-config.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAUA;;;;;;;;;;;AAWG;AACG,SAAU,oBAAoB,CAAC,KAAmB,EAAE,WAAwB,EAAA;AAChF,IAAA,QACE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,KAAK,WAAW,CAAC,WAAW;AACrE,SAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW,CAAC,KAAK,CAAC;AACpD,SAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,WAAW,CAAC,QAAQ,CAAC;AAEjE;AAEA;;;;;AAKG;AACI,eAAe,gBAAgB,CAAC,OAAgB,EAAE,KAAmB,EAAE,QAAwB,EAAA;IACpG,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;IACvD,IAAI,WAAW,EAAE;AACf,QAAA,IAAI,oBAAoB,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE;AAC5C,YAAA,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CACnB,CAAA,iBAAA,EAAoB,KAAK,CAAC,IAAI,CAAA,gEAAA,CAAkE,CACjG;AACD,YAAA,OAAO,MAAM,OAAO,CAAC,WAAW,CAAC,EAAE,GAAG,WAAW,EAAE,GAAG,KAAK,EAAE,CAAC;QAChE;aAAO;AACL,YAAA,OAAO,WAAW;QACpB;IACF;AAEA,IAAA,MAAM,SAAS,GAAiB;AAC9B,QAAA,GAAG,QAAQ;AACX,QAAA,GAAG,KAAK;KACT;AAED,IAAA,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA,0BAAA,EAA6B,KAAK,CAAC,IAAI,CAAA,CAAE,CAAC;AAEhE,IAAA,OAAO,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC;AAC3C;;;;"}

package/dist/routines/cleanup-finished-job.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+var core = require('@sidequest/core');
+
+/**
+ * Deletes finished jobs older than one month from the backend.
+ * @param backend The backend instance to operate on.
+ * @param cutoffMs The cutoff time in milliseconds.
+ */
+async function cleanupFinishedJobs(backend, cutoffMs) {
+    const cutoffDate = new Date(Date.now() - cutoffMs);
+    core.logger("Engine").debug(`Deleting finished jobs older than ${cutoffDate.toISOString()}`);
+    await backend?.deleteFinishedJobs(cutoffDate);
+}
+
+exports.cleanupFinishedJobs = cleanupFinishedJobs;
+//# sourceMappingURL=cleanup-finished-job.cjs.map

package/dist/routines/cleanup-finished-job.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-finished-job.cjs","sources":["../../src/routines/cleanup-finished-job.ts"],"sourcesContent":[null],"names":["logger"],"mappings":";;;;AAGA;;;;AAIG;AACI,eAAe,mBAAmB,CAAC,OAAgB,EAAE,QAAgB,EAAA;AAC1E,IAAA,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC;AAClD,IAAAA,WAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,kCAAA,EAAqC,UAAU,CAAC,WAAW,EAAE,CAAA,CAAE,CAAC;AACvF,IAAA,MAAM,OAAO,EAAE,kBAAkB,CAAC,UAAU,CAAC;AAC/C;;;;"}

package/dist/routines/cleanup-finished-job.d.ts

@@ -0,0 +1,10 @@
+import { Backend } from '@sidequest/backend';
+
+/**
+ * Deletes finished jobs older than one month from the backend.
+ * @param backend The backend instance to operate on.
+ * @param cutoffMs The cutoff time in milliseconds.
+ */
+declare function cleanupFinishedJobs(backend: Backend, cutoffMs: number): Promise<void>;
+
+export { cleanupFinishedJobs };

package/dist/routines/cleanup-finished-job.js

@@ -0,0 +1,15 @@
+import { logger } from '@sidequest/core';
+
+/**
+ * Deletes finished jobs older than one month from the backend.
+ * @param backend The backend instance to operate on.
+ * @param cutoffMs The cutoff time in milliseconds.
+ */
+async function cleanupFinishedJobs(backend, cutoffMs) {
+    const cutoffDate = new Date(Date.now() - cutoffMs);
+    logger("Engine").debug(`Deleting finished jobs older than ${cutoffDate.toISOString()}`);
+    await backend?.deleteFinishedJobs(cutoffDate);
+}
+
+export { cleanupFinishedJobs };
+//# sourceMappingURL=cleanup-finished-job.js.map

package/dist/routines/cleanup-finished-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-finished-job.js","sources":["../../src/routines/cleanup-finished-job.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA;;;;AAIG;AACI,eAAe,mBAAmB,CAAC,OAAgB,EAAE,QAAgB,EAAA;AAC1E,IAAA,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC;AAClD,IAAA,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,kCAAA,EAAqC,UAAU,CAAC,WAAW,EAAE,CAAA,CAAE,CAAC;AACvF,IAAA,MAAM,OAAO,EAAE,kBAAkB,CAAC,UAAU,CAAC;AAC/C;;;;"}

package/dist/routines/release-stale-jobs.cjs

@@ -0,0 +1,28 @@
+'use strict';
+
+var core = require('@sidequest/core');
+
+/**
+ * Finds and releases stale jobs, making them available for processing again.
+ * @param backend The backend instance to operate on.
+ * @param maxStaleMs Maximum age of a job to be considered stale.
+ * @param maxClaimedMs Maximum age of a claimed job to be considered stale.
+ * @returns A promise that resolves when the operation is complete.
+ */
+async function releaseStaleJobs(backend, maxStaleMs, maxClaimedMs) {
+    const staleJobs = await backend.staleJobs(maxStaleMs, maxClaimedMs);
+    if (staleJobs.length > 0) {
+        core.logger("Engine").info(`Stale jobs found, making them available to process`);
+        core.logger("Engine").debug(`Stale jobs: ${JSON.stringify(staleJobs)}`);
+        for (const jobData of staleJobs) {
+            jobData.state = "waiting";
+            await backend.updateJob(jobData);
+        }
+    }
+    else {
+        core.logger("Engine").debug(`No stale jobs found`);
+    }
+}
+
+exports.releaseStaleJobs = releaseStaleJobs;
+//# sourceMappingURL=release-stale-jobs.cjs.map

package/dist/routines/release-stale-jobs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-stale-jobs.cjs","sources":["../../src/routines/release-stale-jobs.ts"],"sourcesContent":[null],"names":["logger"],"mappings":";;;;AAGA;;;;;;AAMG;AACI,eAAe,gBAAgB,CAAC,OAAgB,EAAE,UAAkB,EAAE,YAAoB,EAAA;IAC/F,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,YAAY,CAAC;AAEnE,IAAA,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE;QACxBA,WAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA,kDAAA,CAAoD,CAAC;AAC3E,QAAAA,WAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,YAAA,EAAe,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA,CAAE,CAAC;AAClE,QAAA,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE;AAC/B,YAAA,OAAO,CAAC,KAAK,GAAG,SAAS;AACzB,YAAA,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;QAClC;IACF;SAAO;QACLA,WAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,mBAAA,CAAqB,CAAC;IAC/C;AACF;;;;"}

package/dist/routines/release-stale-jobs.d.ts

@@ -0,0 +1,12 @@
+import { Backend } from '@sidequest/backend';
+
+/**
+ * Finds and releases stale jobs, making them available for processing again.
+ * @param backend The backend instance to operate on.
+ * @param maxStaleMs Maximum age of a job to be considered stale.
+ * @param maxClaimedMs Maximum age of a claimed job to be considered stale.
+ * @returns A promise that resolves when the operation is complete.
+ */
+declare function releaseStaleJobs(backend: Backend, maxStaleMs: number, maxClaimedMs: number): Promise<void>;
+
+export { releaseStaleJobs };

package/dist/routines/release-stale-jobs.js

@@ -0,0 +1,26 @@
+import { logger } from '@sidequest/core';
+
+/**
+ * Finds and releases stale jobs, making them available for processing again.
+ * @param backend The backend instance to operate on.
+ * @param maxStaleMs Maximum age of a job to be considered stale.
+ * @param maxClaimedMs Maximum age of a claimed job to be considered stale.
+ * @returns A promise that resolves when the operation is complete.
+ */
+async function releaseStaleJobs(backend, maxStaleMs, maxClaimedMs) {
+    const staleJobs = await backend.staleJobs(maxStaleMs, maxClaimedMs);
+    if (staleJobs.length > 0) {
+        logger("Engine").info(`Stale jobs found, making them available to process`);
+        logger("Engine").debug(`Stale jobs: ${JSON.stringify(staleJobs)}`);
+        for (const jobData of staleJobs) {
+            jobData.state = "waiting";
+            await backend.updateJob(jobData);
+        }
+    }
+    else {
+        logger("Engine").debug(`No stale jobs found`);
+    }
+}
+
+export { releaseStaleJobs };
+//# sourceMappingURL=release-stale-jobs.js.map

package/dist/routines/release-stale-jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-stale-jobs.js","sources":["../../src/routines/release-stale-jobs.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA;;;;;;AAMG;AACI,eAAe,gBAAgB,CAAC,OAAgB,EAAE,UAAkB,EAAE,YAAoB,EAAA;IAC/F,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,YAAY,CAAC;AAEnE,IAAA,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE;QACxB,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA,kDAAA,CAAoD,CAAC;AAC3E,QAAA,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,YAAA,EAAe,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA,CAAE,CAAC;AAClE,QAAA,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE;AAC/B,YAAA,OAAO,CAAC,KAAK,GAAG,SAAS;AACzB,YAAA,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;QAClC;IACF;SAAO;QACL,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,mBAAA,CAAqB,CAAC;IAC/C;AACF;;;;"}

package/dist/shared-runner/runner-pool.cjs

@@ -0,0 +1,46 @@
+'use strict';
+
+var core = require('@sidequest/core');
+var path = require('path');
+var Piscina = require('piscina');
+
+const runnerPath = path.resolve(__dirname, "runner.js");
+/**
+ * A pool of worker threads for running jobs in parallel using Piscina.
+ */
+class RunnerPool {
+    /** The underlying Piscina worker pool. */
+    pool;
+    /**
+     * Creates a new RunnerPool.
+     * @param size The number of worker threads to use (defaults to number of CPUs).
+     */
+    constructor(minThreads, maxThreads) {
+        this.pool = new Piscina({
+            filename: runnerPath,
+            minThreads,
+            maxThreads,
+        });
+        core.logger("RunnerPool").debug(`Created worker pool with min ${minThreads} threads and max ${maxThreads} threads`);
+    }
+    /**
+     * Runs a job in the worker pool.
+     * @param job The job data to run.
+     * @param signal Optional event emitter for cancellation.
+     * @returns A promise resolving to the job result.
+     */
+    run(job, signal) {
+        core.logger("RunnerPool").debug(`Running job ${job.id} in pool`);
+        return this.pool.run(job, { signal });
+    }
+    /**
+     * Destroys the worker pool and releases resources.
+     */
+    async destroy() {
+        core.logger("RunnerPool").debug("Destroying worker pool");
+        await this.pool.destroy();
+    }
+}
+
+exports.RunnerPool = RunnerPool;
+//# sourceMappingURL=runner-pool.cjs.map

package/dist/shared-runner/runner-pool.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-pool.cjs","sources":["../../src/shared-runner/runner-pool.ts"],"sourcesContent":[null],"names":["logger"],"mappings":";;;;;;AAKA,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAmB,EAAE,WAAW,CAAC;AAEjE;;AAEG;MACU,UAAU,CAAA;;AAEJ,IAAA,IAAI;AAErB;;;AAGG;IACH,WAAA,CAAY,UAAkB,EAAE,UAAkB,EAAA;AAChD,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC;AACtB,YAAA,QAAQ,EAAE,UAAU;YACpB,UAAU;YACV,UAAU;AACX,SAAA,CAAC;AACF,QAAAA,WAAM,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAA,6BAAA,EAAgC,UAAU,CAAA,iBAAA,EAAoB,UAAU,CAAA,QAAA,CAAU,CAAC;IAChH;AAEA;;;;;AAKG;IACH,GAAG,CAAC,GAAY,EAAE,MAAqB,EAAA;AACrC,QAAAA,WAAM,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAA,YAAA,EAAe,GAAG,CAAC,EAAE,CAAA,QAAA,CAAU,CAAC;AAC3D,QAAA,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC;IACvC;AAEA;;AAEG;AACH,IAAA,MAAM,OAAO,GAAA;QACXA,WAAM,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;AACpD,QAAA,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;IAC3B;AACD;;;;"}

package/dist/shared-runner/runner-pool.d.ts

@@ -0,0 +1,28 @@
+import { JobData, JobResult } from '@sidequest/core';
+import EventEmitter from 'events';
+
+/**
+ * A pool of worker threads for running jobs in parallel using Piscina.
+ */
+declare class RunnerPool {
+    /** The underlying Piscina worker pool. */
+    private readonly pool;
+    /**
+     * Creates a new RunnerPool.
+     * @param size The number of worker threads to use (defaults to number of CPUs).
+     */
+    constructor(minThreads: number, maxThreads: number);
+    /**
+     * Runs a job in the worker pool.
+     * @param job The job data to run.
+     * @param signal Optional event emitter for cancellation.
+     * @returns A promise resolving to the job result.
+     */
+    run(job: JobData, signal?: EventEmitter): Promise<JobResult>;
+    /**
+     * Destroys the worker pool and releases resources.
+     */
+    destroy(): Promise<void>;
+}
+
+export { RunnerPool };

package/dist/shared-runner/runner-pool.js

@@ -0,0 +1,44 @@
+import { logger } from '@sidequest/core';
+import path from 'path';
+import Piscina from 'piscina';
+
+const runnerPath = path.resolve(import.meta.dirname, "runner.js");
+/**
+ * A pool of worker threads for running jobs in parallel using Piscina.
+ */
+class RunnerPool {
+    /** The underlying Piscina worker pool. */
+    pool;
+    /**
+     * Creates a new RunnerPool.
+     * @param size The number of worker threads to use (defaults to number of CPUs).
+     */
+    constructor(minThreads, maxThreads) {
+        this.pool = new Piscina({
+            filename: runnerPath,
+            minThreads,
+            maxThreads,
+        });
+        logger("RunnerPool").debug(`Created worker pool with min ${minThreads} threads and max ${maxThreads} threads`);
+    }
+    /**
+     * Runs a job in the worker pool.
+     * @param job The job data to run.
+     * @param signal Optional event emitter for cancellation.
+     * @returns A promise resolving to the job result.
+     */
+    run(job, signal) {
+        logger("RunnerPool").debug(`Running job ${job.id} in pool`);
+        return this.pool.run(job, { signal });
+    }
+    /**
+     * Destroys the worker pool and releases resources.
+     */
+    async destroy() {
+        logger("RunnerPool").debug("Destroying worker pool");
+        await this.pool.destroy();
+    }
+}
+
+export { RunnerPool };
+//# sourceMappingURL=runner-pool.js.map

package/dist/shared-runner/runner-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-pool.js","sources":["../../src/shared-runner/runner-pool.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAKA,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC;AAEjE;;AAEG;MACU,UAAU,CAAA;;AAEJ,IAAA,IAAI;AAErB;;;AAGG;IACH,WAAA,CAAY,UAAkB,EAAE,UAAkB,EAAA;AAChD,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC;AACtB,YAAA,QAAQ,EAAE,UAAU;YACpB,UAAU;YACV,UAAU;AACX,SAAA,CAAC;AACF,QAAA,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAA,6BAAA,EAAgC,UAAU,CAAA,iBAAA,EAAoB,UAAU,CAAA,QAAA,CAAU,CAAC;IAChH;AAEA;;;;;AAKG;IACH,GAAG,CAAC,GAAY,EAAE,MAAqB,EAAA;AACrC,QAAA,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAA,YAAA,EAAe,GAAG,CAAC,EAAE,CAAA,QAAA,CAAU,CAAC;AAC3D,QAAA,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC;IACvC;AAEA;;AAEG;AACH,IAAA,MAAM,OAAO,GAAA;QACX,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;AACpD,QAAA,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;IAC3B;AACD;;;;"}

package/dist/shared-runner/runner.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var core = require('@sidequest/core');
+
+/**
+ * Runs a job by dynamically importing its script and executing the specified class.
+ * @param jobData The job data to execute.
+ * @returns A promise resolving to the job result.
+ */
+async function run(jobData) {
+    let script = {};
+    try {
+        core.logger("Runner").debug(`Importing job script "${jobData.script}"`);
+        script = (await import(jobData.script));
+        core.logger("Runner").debug(`Successfully imported job script "${jobData.script}"`);
+    }
+    catch (error) {
+        const errorMessage = `Failed to import job script "${jobData.script}": ${error instanceof Error ? error.message : String(error)}`;
+        core.logger("Runner").error(errorMessage);
+        const errorData = core.toErrorData(error);
+        return { __is_job_transition__: true, type: "failed", error: errorData };
+    }
+    const JobClass = script[jobData.class] ?? script.default;
+    if (!JobClass || typeof JobClass !== "function") {
+        const error = `Invalid job class: ${jobData.class}`;
+        core.logger("Runner").error(error);
+        const errorData = core.toErrorData(new Error(error));
+        return { __is_job_transition__: true, type: "failed", error: errorData };
+    }
+    const job = new JobClass(jobData.constructor_args);
+    job.injectJobData(jobData);
+    core.logger("Runner").debug(`Executing job class "${jobData.class}" with args:`, jobData.args);
+    return job.perform(...jobData.args);
+}
+
+exports.default = run;
+//# sourceMappingURL=runner.cjs.map

package/dist/shared-runner/runner.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.cjs","sources":["../../src/shared-runner/runner.ts"],"sourcesContent":[null],"names":["logger","toErrorData"],"mappings":";;;;;;AAGA;;;;AAIG;AACY,eAAe,GAAG,CAAC,OAAgB,EAAA;IAChD,IAAI,MAAM,GAAiC,EAAE;AAC7C,IAAA,IAAI;AACF,QAAAA,WAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,sBAAA,EAAyB,OAAO,CAAC,MAAM,CAAA,CAAA,CAAG,CAAC;QAClE,MAAM,IAAI,MAAM,OAAO,OAAO,CAAC,MAAM,CAAC,CAAiC;AACvE,QAAAA,WAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,kCAAA,EAAqC,OAAO,CAAC,MAAM,CAAA,CAAA,CAAG,CAAC;IAChF;IAAE,OAAO,KAAK,EAAE;QACd,MAAM,YAAY,GAAG,CAAA,6BAAA,EAAgC,OAAO,CAAC,MAAM,CAAA,GAAA,EAAM,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA,CAAE;QACjIA,WAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;AACpC,QAAA,MAAM,SAAS,GAAGC,gBAAW,CAAC,KAAc,CAAC;AAC7C,QAAA,OAAO,EAAE,qBAAqB,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE;IAC1E;AAEA,IAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO;IACxD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE;AAC/C,QAAA,MAAM,KAAK,GAAG,CAAA,mBAAA,EAAsB,OAAO,CAAC,KAAK,EAAE;QACnDD,WAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;QAC7B,MAAM,SAAS,GAAGC,gBAAW,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;AAC/C,QAAA,OAAO,EAAE,qBAAqB,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE;IAC1E;IACA,MAAM,GAAG,GAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC;AACvD,IAAA,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC;AAC1B,IAAAD,WAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,qBAAA,EAAwB,OAAO,CAAC,KAAK,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC;IACzF,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;AACrC;;;;"}

package/dist/shared-runner/runner.d.ts

@@ -0,0 +1,10 @@
+import { JobData, JobResult } from '@sidequest/core';
+
+/**
+ * Runs a job by dynamically importing its script and executing the specified class.
+ * @param jobData The job data to execute.
+ * @returns A promise resolving to the job result.
+ */
+declare function run(jobData: JobData): Promise<JobResult>;
+
+export { run as default };

package/dist/shared-runner/runner.js

@@ -0,0 +1,35 @@
+import { logger, toErrorData } from '@sidequest/core';
+
+/**
+ * Runs a job by dynamically importing its script and executing the specified class.
+ * @param jobData The job data to execute.
+ * @returns A promise resolving to the job result.
+ */
+async function run(jobData) {
+    let script = {};
+    try {
+        logger("Runner").debug(`Importing job script "${jobData.script}"`);
+        script = (await import(jobData.script));
+        logger("Runner").debug(`Successfully imported job script "${jobData.script}"`);
+    }
+    catch (error) {
+        const errorMessage = `Failed to import job script "${jobData.script}": ${error instanceof Error ? error.message : String(error)}`;
+        logger("Runner").error(errorMessage);
+        const errorData = toErrorData(error);
+        return { __is_job_transition__: true, type: "failed", error: errorData };
+    }
+    const JobClass = script[jobData.class] ?? script.default;
+    if (!JobClass || typeof JobClass !== "function") {
+        const error = `Invalid job class: ${jobData.class}`;
+        logger("Runner").error(error);
+        const errorData = toErrorData(new Error(error));
+        return { __is_job_transition__: true, type: "failed", error: errorData };
+    }
+    const job = new JobClass(jobData.constructor_args);
+    job.injectJobData(jobData);
+    logger("Runner").debug(`Executing job class "${jobData.class}" with args:`, jobData.args);
+    return job.perform(...jobData.args);
+}
+
+export { run as default };
+//# sourceMappingURL=runner.js.map

package/dist/shared-runner/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sources":["../../src/shared-runner/runner.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA;;;;AAIG;AACY,eAAe,GAAG,CAAC,OAAgB,EAAA;IAChD,IAAI,MAAM,GAAiC,EAAE;AAC7C,IAAA,IAAI;AACF,QAAA,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,sBAAA,EAAyB,OAAO,CAAC,MAAM,CAAA,CAAA,CAAG,CAAC;QAClE,MAAM,IAAI,MAAM,OAAO,OAAO,CAAC,MAAM,CAAC,CAAiC;AACvE,QAAA,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,kCAAA,EAAqC,OAAO,CAAC,MAAM,CAAA,CAAA,CAAG,CAAC;IAChF;IAAE,OAAO,KAAK,EAAE;QACd,MAAM,YAAY,GAAG,CAAA,6BAAA,EAAgC,OAAO,CAAC,MAAM,CAAA,GAAA,EAAM,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA,CAAE;QACjI,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;AACpC,QAAA,MAAM,SAAS,GAAG,WAAW,CAAC,KAAc,CAAC;AAC7C,QAAA,OAAO,EAAE,qBAAqB,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE;IAC1E;AAEA,IAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO;IACxD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE;AAC/C,QAAA,MAAM,KAAK,GAAG,CAAA,mBAAA,EAAsB,OAAO,CAAC,KAAK,EAAE;QACnD,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;QAC7B,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;AAC/C,QAAA,OAAO,EAAE,qBAAqB,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE;IAC1E;IACA,MAAM,GAAG,GAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC;AACvD,IAAA,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC;AAC1B,IAAA,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,qBAAA,EAAwB,OAAO,CAAC,KAAK,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC;IACzF,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;AACrC;;;;"}

package/dist/utils/shutdown.cjs

@@ -0,0 +1,53 @@
+'use strict';
+
+var core = require('@sidequest/core');
+
+let shuttingDown = false;
+/**
+ * Handles the shutdown process, ensuring it only runs once and logs appropriately.
+ * @param fn The async function to run during shutdown.
+ * @param tag A label for logging.
+ * @param signal The signal that triggered shutdown.
+ */
+async function shutdown(fn, tag, signal) {
+    try {
+        if (!shuttingDown) {
+            shuttingDown = true;
+            core.logger("Engine").info(`[${tag}] Received ${signal}. Shutting down gracefully...`);
+            await fn();
+        }
+        else {
+            core.logger("Engine").info(`[${tag}] Received ${signal} while already shutting down. Forcing shutdown.`);
+        }
+        core.logger("Engine").info(`[${tag}] Shutdown complete.`);
+        process.exit(0);
+    }
+    catch (error) {
+        core.logger("Engine").error(`[${tag}] Error during shutdown:`, error);
+        process.exit(1);
+    }
+}
+/* eslint-disable @typescript-eslint/no-misused-promises */
+/**
+ * Registers handlers for SIGINT and SIGTERM to gracefully shut down the process.
+ * @param fn The async function to run during shutdown.
+ * @param tag A label for logging.
+ */
+function gracefulShutdown(fn, tag, enabled) {
+    if (enabled) {
+        process.on("SIGINT", async () => {
+            await shutdown(fn, tag, "SIGINT");
+        });
+        process.on("SIGTERM", async () => {
+            await shutdown(fn, tag, "SIGTERM");
+        });
+    }
+}
+function clearGracefulShutdown() {
+    process.removeAllListeners("SIGINT");
+    process.removeAllListeners("SIGTERM");
+}
+
+exports.clearGracefulShutdown = clearGracefulShutdown;
+exports.gracefulShutdown = gracefulShutdown;
+//# sourceMappingURL=shutdown.cjs.map

package/dist/utils/shutdown.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.cjs","sources":["../../src/utils/shutdown.ts"],"sourcesContent":[null],"names":["logger"],"mappings":";;;;AAEA,IAAI,YAAY,GAAG,KAAK;AAExB;;;;;AAKG;AACH,eAAe,QAAQ,CAAC,EAA8B,EAAE,GAAW,EAAE,MAAc,EAAA;AACjF,IAAA,IAAI;QACF,IAAI,CAAC,YAAY,EAAE;YACjB,YAAY,GAAG,IAAI;AACnB,YAAAA,WAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA,CAAA,EAAI,GAAG,CAAA,WAAA,EAAc,MAAM,CAAA,6BAAA,CAA+B,CAAC;YACjF,MAAM,EAAE,EAAE;QACZ;aAAO;AACL,YAAAA,WAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA,CAAA,EAAI,GAAG,CAAA,WAAA,EAAc,MAAM,CAAA,+CAAA,CAAiD,CAAC;QACrG;QACAA,WAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA,CAAA,EAAI,GAAG,CAAA,oBAAA,CAAsB,CAAC;AACpD,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjB;IAAE,OAAO,KAAK,EAAE;AACd,QAAAA,WAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,CAAA,EAAI,GAAG,CAAA,wBAAA,CAA0B,EAAE,KAAK,CAAC;AAChE,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjB;AACF;AAEA;AACA;;;;AAIG;SACa,gBAAgB,CAAC,EAA8B,EAAE,GAAW,EAAE,OAAgB,EAAA;IAC5F,IAAI,OAAO,EAAE;AACX,QAAA,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAW;YAC9B,MAAM,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC;AACnC,QAAA,CAAC,CAAC;AAEF,QAAA,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,YAAW;YAC/B,MAAM,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC;AACpC,QAAA,CAAC,CAAC;IACJ;AACF;SAEgB,qBAAqB,GAAA;AACnC,IAAA,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC;AACpC,IAAA,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC;AACvC;;;;;"}

package/dist/utils/shutdown.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Registers handlers for SIGINT and SIGTERM to gracefully shut down the process.
+ * @param fn The async function to run during shutdown.
+ * @param tag A label for logging.
+ */
+declare function gracefulShutdown(fn: () => void | Promise<void>, tag: string, enabled: boolean): void;
+declare function clearGracefulShutdown(): void;
+
+export { clearGracefulShutdown, gracefulShutdown };

package/dist/utils/shutdown.js

@@ -0,0 +1,50 @@
+import { logger } from '@sidequest/core';
+
+let shuttingDown = false;
+/**
+ * Handles the shutdown process, ensuring it only runs once and logs appropriately.
+ * @param fn The async function to run during shutdown.
+ * @param tag A label for logging.
+ * @param signal The signal that triggered shutdown.
+ */
+async function shutdown(fn, tag, signal) {
+    try {
+        if (!shuttingDown) {
+            shuttingDown = true;
+            logger("Engine").info(`[${tag}] Received ${signal}. Shutting down gracefully...`);
+            await fn();
+        }
+        else {
+            logger("Engine").info(`[${tag}] Received ${signal} while already shutting down. Forcing shutdown.`);
+        }
+        logger("Engine").info(`[${tag}] Shutdown complete.`);
+        process.exit(0);
+    }
+    catch (error) {
+        logger("Engine").error(`[${tag}] Error during shutdown:`, error);
+        process.exit(1);
+    }
+}
+/* eslint-disable @typescript-eslint/no-misused-promises */
+/**
+ * Registers handlers for SIGINT and SIGTERM to gracefully shut down the process.
+ * @param fn The async function to run during shutdown.
+ * @param tag A label for logging.
+ */
+function gracefulShutdown(fn, tag, enabled) {
+    if (enabled) {
+        process.on("SIGINT", async () => {
+            await shutdown(fn, tag, "SIGINT");
+        });
+        process.on("SIGTERM", async () => {
+            await shutdown(fn, tag, "SIGTERM");
+        });
+    }
+}
+function clearGracefulShutdown() {
+    process.removeAllListeners("SIGINT");
+    process.removeAllListeners("SIGTERM");
+}
+
+export { clearGracefulShutdown, gracefulShutdown };
+//# sourceMappingURL=shutdown.js.map

package/dist/utils/shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.js","sources":["../../src/utils/shutdown.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA,IAAI,YAAY,GAAG,KAAK;AAExB;;;;;AAKG;AACH,eAAe,QAAQ,CAAC,EAA8B,EAAE,GAAW,EAAE,MAAc,EAAA;AACjF,IAAA,IAAI;QACF,IAAI,CAAC,YAAY,EAAE;YACjB,YAAY,GAAG,IAAI;AACnB,YAAA,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA,CAAA,EAAI,GAAG,CAAA,WAAA,EAAc,MAAM,CAAA,6BAAA,CAA+B,CAAC;YACjF,MAAM,EAAE,EAAE;QACZ;aAAO;AACL,YAAA,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA,CAAA,EAAI,GAAG,CAAA,WAAA,EAAc,MAAM,CAAA,+CAAA,CAAiD,CAAC;QACrG;QACA,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA,CAAA,EAAI,GAAG,CAAA,oBAAA,CAAsB,CAAC;AACpD,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjB;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,CAAA,EAAI,GAAG,CAAA,wBAAA,CAA0B,EAAE,KAAK,CAAC;AAChE,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjB;AACF;AAEA;AACA;;;;AAIG;SACa,gBAAgB,CAAC,EAA8B,EAAE,GAAW,EAAE,OAAgB,EAAA;IAC5F,IAAI,OAAO,EAAE;AACX,QAAA,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAW;YAC9B,MAAM,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC;AACnC,QAAA,CAAC,CAAC;AAEF,QAAA,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,YAAW;YAC/B,MAAM,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC;AACpC,QAAA,CAAC,CAAC;IACJ;AACF;SAEgB,qBAAqB,GAAA;AACnC,IAAA,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC;AACpC,IAAA,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC;AACvC;;;;"}