@powerhousedao/reactor 6.0.0-dev.4 → 6.0.0-dev.40

package/dist/src/logging/console.js

@@ -1,108 +1,2 @@
-const tokenSub = /@([a-zA-Z0-9_]+)/g;
-const dtf = new Intl.DateTimeFormat();
-const formatMessage = (tagString, message, replacements) => {
-    const meta = {};
-    const uniqueTokens = [];
-    let results;
-    while ((results = tokenSub.exec(message)) !== null) {
-        const tokenName = results[1];
-        const index = uniqueTokens.indexOf(tokenName);
-        if (index === -1) {
-            uniqueTokens.push(tokenName);
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-            const replacement = replacements[uniqueTokens.length - 1];
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-            meta[tokenName] = replacement;
-        }
-    }
-    // replace
-    for (const [key, value] of Object.entries(meta)) {
-        let stringValue;
-        if (!value) {
-            stringValue = "null";
-        }
-        else if (typeof value === "string") {
-            stringValue = value;
-        }
-        else if (typeof value === "object") {
-            stringValue = JSON.stringify(value);
-        }
-        else if (typeof value === "function") {
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
-            const name = value.name;
-            stringValue = name ? `${name}()` : "anonymous()";
-        }
-        else {
-            stringValue = String(value);
-        }
-        message = message.replaceAll(`@${key}`, stringValue);
-    }
-    if (tagString.length > 0) {
-        message = `${tagString} ${message}`;
-    }
-    // timestamp
-    const now = new Date();
-    const timestamp = dtf.format(now);
-    meta["timestamp"] = timestamp;
-    return [message, meta];
-};
-const LOG_LEVELS = {
-    verbose: 0,
-    debug: 1,
-    info: 2,
-    warn: 3,
-    error: 4,
-};
-export class ConsoleLogger {
-    #tags;
-    #tagString;
-    #level = LOG_LEVELS.info;
-    errorHandler;
-    constructor(tags, handler) {
-        this.#tags = tags || [];
-        this.#tagString = this.#tags.map((tag) => `[${tag}]`).join("");
-        this.errorHandler = handler ?? (() => { });
-    }
-    get level() {
-        return Object.keys(LOG_LEVELS).find((key) => LOG_LEVELS[key] === this.#level);
-    }
-    set level(value) {
-        this.#level = LOG_LEVELS[value];
-    }
-    child(tags) {
-        const logger = new ConsoleLogger([...this.#tags, ...tags], this.errorHandler);
-        logger.level = this.level;
-        return logger;
-    }
-    verbose(message, ...replacements) {
-        if (this.#level <= LOG_LEVELS.verbose) {
-            const [formattedMessage, meta] = formatMessage(this.#tagString, message, replacements);
-            console.debug(`[${meta["timestamp"]}] ${formattedMessage}`, meta);
-        }
-    }
-    debug(message, ...replacements) {
-        if (this.#level <= LOG_LEVELS.debug) {
-            const [formattedMessage, meta] = formatMessage(this.#tagString, message, replacements);
-            console.debug(`[${meta["timestamp"]}] ${formattedMessage}`, meta);
-        }
-    }
-    info(message, ...replacements) {
-        if (this.#level <= LOG_LEVELS.info) {
-            const [formattedMessage, meta] = formatMessage(this.#tagString, message, replacements);
-            console.info(`[${meta["timestamp"]}] ${formattedMessage}`, meta);
-        }
-    }
-    warn(message, ...replacements) {
-        if (this.#level <= LOG_LEVELS.warn) {
-            const [formattedMessage, meta] = formatMessage(this.#tagString, message, replacements);
-            console.warn(`[${meta["timestamp"]}] ${formattedMessage}`, meta);
-        }
-    }
-    error(message, ...replacements) {
-        if (this.#level <= LOG_LEVELS.error) {
-            const [formattedMessage, meta] = formatMessage(this.#tagString, message, replacements);
-            console.error(`[${meta["timestamp"]}] ${formattedMessage}`, meta);
-        }
-    }
-}
+export { ConsoleLogger } from "document-model/core";
 //# sourceMappingURL=console.js.map

package/dist/src/logging/console.js.map

@@ -1 +1 @@
-{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/logging/console.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/logging/console.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/logging/types.d.ts

@@ -1,12 +1,2 @@
-export type LoggerErrorHandler = (...data: any[]) => void;
-export type ILogger = {
-    level: "verbose" | "debug" | "info" | "warn" | "error";
-    verbose: (message: string, ...replacements: any[]) => void;
-    debug: (message: string, ...replacements: any[]) => void;
-    info: (message: string, ...replacements: any[]) => void;
-    warn: (message: string, ...replacements: any[]) => void;
-    error: (message: string, ...replacements: any[]) => void;
-    errorHandler: LoggerErrorHandler;
-    child: (tags: string[]) => ILogger;
-};
+export type { ILogger, LoggerErrorHandler } from "document-model/core";
 //# sourceMappingURL=types.d.ts.map

package/dist/src/logging/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/logging/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAE1D,MAAM,MAAM,OAAO,GAAG;IACpB,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAEvD,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC3D,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACzD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACxD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACxD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAEzD,YAAY,EAAE,kBAAkB,CAAC;IAEjC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;CACpC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/logging/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/processors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/processors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/processors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/src/processors/relational/relational-db-processor.d.ts

@@ -0,0 +1,47 @@
+import type { IRelationalDb, IRelationalDbProcessor, IRelationalQueryBuilder, OperationWithContext, ProcessorFilter, RelationalDbProcessorClass } from "@powerhousedao/reactor";
+declare const IS_RELATIONAL_DB_PROCESSOR: unique symbol;
+/**
+ * Base class for relational db processors that require a relational database storage.
+ * This class abstracts database initialization, migration management, and resource cleanup,
+ * allowing derived classes to focus on business logic.
+ */
+export declare abstract class RelationalDbProcessor<TDatabaseSchema = unknown> implements IRelationalDbProcessor<TDatabaseSchema> {
+    protected _namespace: string;
+    protected _filter: ProcessorFilter;
+    protected relationalDb: IRelationalDb<TDatabaseSchema>;
+    constructor(_namespace: string, _filter: ProcessorFilter, relationalDb: IRelationalDb<TDatabaseSchema>);
+    static [IS_RELATIONAL_DB_PROCESSOR]: boolean;
+    /**
+     * Returns the namespace for a given drive id.
+     * This method can be overridden by derived classes to provide a custom namespace.
+     */
+    static getNamespace(driveId: string): string;
+    static query<Schema>(this: RelationalDbProcessorClass<Schema>, driveId: string, db: IRelationalDb<any>): IRelationalQueryBuilder<Schema>;
+    /**
+     * Processes a list of operations with context.
+     * Called when operations match this processor's filter.
+     */
+    abstract onOperations(operations: OperationWithContext[]): Promise<void>;
+    /**
+     * Returns the filter for the processor.
+     * This method can be overridden by derived classes to provide a custom filter.
+     */
+    get filter(): ProcessorFilter;
+    /**
+     * Returns the namespace used by the processor.
+     */
+    get namespace(): string;
+    get query(): IRelationalQueryBuilder<TDatabaseSchema>;
+    /**
+     * Abstract method that derived classes must implement.
+     * This method is meant to be called on subclasses to initialize and upgrade the database.
+     */
+    abstract initAndUpgrade(): Promise<void>;
+    /**
+     * Called when the processor is disconnected.
+     * This method is meant to be overridden by subclasses to clean up resources.
+     */
+    abstract onDisconnect(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=relational-db-processor.d.ts.map

package/dist/src/processors/relational/relational-db-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relational-db-processor.d.ts","sourceRoot":"","sources":["../../../../src/processors/relational/relational-db-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,0BAA0B,EAC3B,MAAM,wBAAwB,CAAC;AAGhC,QAAA,MAAM,0BAA0B,eAA8C,CAAC;AAE/E;;;;GAIG;AACH,8BAAsB,qBAAqB,CAAC,eAAe,GAAG,OAAO,CACnE,YAAW,sBAAsB,CAAC,eAAe,CAAC;IAGhD,SAAS,CAAC,UAAU,EAAE,MAAM;IAC5B,SAAS,CAAC,OAAO,EAAE,eAAe;IAClC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC,eAAe,CAAC;gBAF5C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,aAAa,CAAC,eAAe,CAAC;IAGxD,MAAM,CAAC,CAAC,0BAA0B,CAAC,UAAQ;IAE3C;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI5C,MAAM,CAAC,KAAK,CAAC,MAAM,EACjB,IAAI,EAAE,0BAA0B,CAAC,MAAM,CAAC,EACxC,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,aAAa,CAAC,GAAG,CAAC,GACrB,uBAAuB,CAAC,MAAM,CAAC;IAIlC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAExE;;;OAGG;IACH,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,KAAK,IAAI,uBAAuB,CAAC,eAAe,CAAC,CAEpD;IAED;;;OAGG;IACH,QAAQ,CAAC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAExC;;;OAGG;IACH,QAAQ,CAAC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CACvC"}

package/dist/src/processors/relational/relational-db-processor.js

@@ -0,0 +1,45 @@
+import { relationalDbToQueryBuilder } from "./utils.js";
+const IS_RELATIONAL_DB_PROCESSOR = Symbol.for("ph.IS_RELATIONAL_DB_PROCESSOR");
+/**
+ * Base class for relational db processors that require a relational database storage.
+ * This class abstracts database initialization, migration management, and resource cleanup,
+ * allowing derived classes to focus on business logic.
+ */
+export class RelationalDbProcessor {
+    _namespace;
+    _filter;
+    relationalDb;
+    constructor(_namespace, _filter, relationalDb) {
+        this._namespace = _namespace;
+        this._filter = _filter;
+        this.relationalDb = relationalDb;
+    }
+    static [IS_RELATIONAL_DB_PROCESSOR] = true;
+    /**
+     * Returns the namespace for a given drive id.
+     * This method can be overridden by derived classes to provide a custom namespace.
+     */
+    static getNamespace(driveId) {
+        return `${this.name}_${driveId.replaceAll("-", "_")}`;
+    }
+    static query(driveId, db) {
+        return db.queryNamespace(this.getNamespace(driveId));
+    }
+    /**
+     * Returns the filter for the processor.
+     * This method can be overridden by derived classes to provide a custom filter.
+     */
+    get filter() {
+        return this._filter;
+    }
+    /**
+     * Returns the namespace used by the processor.
+     */
+    get namespace() {
+        return this._namespace;
+    }
+    get query() {
+        return relationalDbToQueryBuilder(this.relationalDb);
+    }
+}
+//# sourceMappingURL=relational-db-processor.js.map

package/dist/src/processors/relational/relational-db-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relational-db-processor.js","sourceRoot":"","sources":["../../../../src/processors/relational/relational-db-processor.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,0BAA0B,GAAG,MAAM,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAE/E;;;;GAIG;AACH,MAAM,OAAgB,qBAAqB;IAI7B;IACA;IACA;IAHZ,YACY,UAAkB,EAClB,OAAwB,EACxB,YAA4C;QAF5C,eAAU,GAAV,UAAU,CAAQ;QAClB,YAAO,GAAP,OAAO,CAAiB;QACxB,iBAAY,GAAZ,YAAY,CAAgC;IACrD,CAAC;IAEJ,MAAM,CAAC,CAAC,0BAA0B,CAAC,GAAG,IAAI,CAAC;IAE3C;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,OAAe;QACjC,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,KAAK,CAEV,OAAe,EACf,EAAsB;QAEtB,OAAO,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IAQD;;;OAGG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,IAAI,KAAK;QACP,OAAO,0BAA0B,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACvD,CAAC"}

package/dist/src/processors/relational/types.d.ts

@@ -0,0 +1,27 @@
+import type { IProcessor, ProcessorFilter } from "@powerhousedao/reactor";
+import type { Kysely, QueryCreator } from "kysely";
+import type { RelationalDbProcessor } from "./relational-db-processor.js";
+export type IRelationalQueryMethods = "selectFrom" | "selectNoFrom" | "with" | "withRecursive";
+export type IRelationalQueryBuilder<Schema = unknown> = Pick<QueryCreator<Schema>, IRelationalQueryMethods> & {
+    withSchema: (schema: string) => IRelationalQueryBuilder<Schema>;
+};
+export type IBaseRelationalDb<Schema = unknown> = Kysely<Schema>;
+/**
+ * The standardized relational database interface for relational db processors.
+ * This abstraction provides type-safe database operations while hiding the underlying
+ * database framework implementation details.
+ **/
+export type IRelationalDb<Schema = unknown> = IBaseRelationalDb<Schema> & {
+    createNamespace<NamespaceSchema>(namespace: string): Promise<IRelationalDb<ExtractProcessorSchemaOrSelf<NamespaceSchema>>>;
+    queryNamespace<NamespaceSchema>(namespace: string): IRelationalQueryBuilder<NamespaceSchema>;
+};
+export interface IRelationalDbProcessor<TDatabaseSchema = unknown> extends IProcessor {
+    namespace: string;
+    query: IRelationalQueryBuilder<TDatabaseSchema>;
+    filter: ProcessorFilter;
+    initAndUpgrade(): Promise<void>;
+}
+export type ExtractProcessorSchemaOrSelf<TProcessor> = TProcessor extends RelationalDbProcessor<infer TSchema> ? TSchema : TProcessor;
+export type RelationalDbProcessorClass<TSchema> = typeof RelationalDbProcessor<TSchema>;
+export type HashAlgorithms = "fnv1a";
+//# sourceMappingURL=types.d.ts.map

package/dist/src/processors/relational/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/processors/relational/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,MAAM,MAAM,uBAAuB,GAC/B,YAAY,GACZ,cAAc,GACd,MAAM,GACN,eAAe,CAAC;AAEpB,MAAM,MAAM,uBAAuB,CAAC,MAAM,GAAG,OAAO,IAAI,IAAI,CAC1D,YAAY,CAAC,MAAM,CAAC,EACpB,uBAAuB,CACxB,GAAG;IACF,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,uBAAuB,CAAC,MAAM,CAAC,CAAC;CACjE,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,MAAM,GAAG,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;AAEjE;;;;IAII;AACJ,MAAM,MAAM,aAAa,CAAC,MAAM,GAAG,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,GAAG;IACxE,eAAe,CAAC,eAAe,EAC7B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,4BAA4B,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACzE,cAAc,CAAC,eAAe,EAC5B,SAAS,EAAE,MAAM,GAChB,uBAAuB,CAAC,eAAe,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,WAAW,sBAAsB,CAAC,eAAe,GAAG,OAAO,CAC/D,SAAQ,UAAU;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,uBAAuB,CAAC,eAAe,CAAC,CAAC;IAChD,MAAM,EAAE,eAAe,CAAC;IACxB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,4BAA4B,CAAC,UAAU,IACjD,UAAU,SAAS,qBAAqB,CAAC,MAAM,OAAO,CAAC,GACnD,OAAO,GACP,UAAU,CAAC;AAEjB,MAAM,MAAM,0BAA0B,CAAC,OAAO,IAC5C,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAExC,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC"}

package/dist/src/processors/relational/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/processors/relational/types.js.map

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

package/dist/src/processors/relational/utils.d.ts

@@ -0,0 +1,29 @@
+import type { IBaseRelationalDb, IRelationalDb, IRelationalQueryBuilder } from "@powerhousedao/reactor";
+/**
+ * Hashes a string to a lowercase base-26 string.
+ * @param str The string to hash.
+ * @param length The length of the hash. Defaults to 10.
+ * @param algorithm The hashing algorithm to use. Defaults to "fnv1a".
+ * @returns The hashed string.
+ */
+export declare function hashNamespace(str: string, length?: number): string;
+/**
+ * Creates a RelationalDb instance with namespace support.
+ * @param baseDb The base RelationalDb instance to enhance.
+ * @param baseOptions The default options for namespace creation. Hashes namespace by default.
+ * @returns The enhanced RelationalDb instance.
+ */
+export declare function createRelationalDb<Schema>(baseDb: IBaseRelationalDb<Schema>, baseOptions?: NamespaceOptions): IRelationalDb<Schema>;
+type NamespaceOptions = {
+    hashNamespace?: boolean;
+};
+export declare function createNamespacedDb<Schema>(db: IBaseRelationalDb<any>, namespace: string, options?: NamespaceOptions): Promise<IRelationalDb<Schema>>;
+export declare function createNamespacedQueryBuilder<Schema>(db: IBaseRelationalDb<any>, namespace: string, options?: NamespaceOptions): IRelationalQueryBuilder<Schema>;
+/**
+ * Returns a query builder for a RelationalDb instance.
+ * @param query The RelationalDb instance to convert.
+ * @returns The IRelationalQueryBuilder instance.
+ */
+export declare function relationalDbToQueryBuilder<TSchema>(query: IBaseRelationalDb<TSchema>): IRelationalQueryBuilder<TSchema>;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/processors/relational/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/processors/relational/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAMhC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAK,UAMrD;AAaD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EACvC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,EACjC,WAAW,CAAC,EAAE,gBAAgB,GAC7B,aAAa,CAAC,MAAM,CAAC,CAwBvB;AAED,KAAK,gBAAgB,GAAG;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,MAAM,EAC7C,EAAE,EAAE,iBAAiB,CAAC,GAAG,CAAC,EAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAOhC;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EACjD,EAAE,EAAE,iBAAiB,CAAC,GAAG,CAAC,EAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,gBAAgB,GACzB,uBAAuB,CAAC,MAAM,CAAC,CAKjC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAChD,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAChC,uBAAuB,CAAC,OAAO,CAAC,CASlC"}

package/dist/src/processors/relational/utils.js

@@ -0,0 +1,67 @@
+import fnv1a from "@sindresorhus/fnv1a";
+const SUPPORTED_SIZES = [32, 64, 128, 256, 512, 1024];
+const LOG2_26 = Math.log2(26); //
+/**
+ * Hashes a string to a lowercase base-26 string.
+ * @param str The string to hash.
+ * @param length The length of the hash. Defaults to 10.
+ * @param algorithm The hashing algorithm to use. Defaults to "fnv1a".
+ * @returns The hashed string.
+ */
+export function hashNamespace(str, length = 10) {
+    const requiredBits = Math.ceil(length * LOG2_26);
+    const bitSize = SUPPORTED_SIZES.find((size) => size && size >= requiredBits) ?? 1024;
+    const hash = fnv1a(str, { size: bitSize });
+    return toBase26(hash, length);
+}
+// converts hash to lowercase letters
+function toBase26(num, length = 10) {
+    const alphabet = "abcdefghijklmnopqrstuvwxyz";
+    let out = "";
+    while (num > 0n && out.length < length) {
+        out = alphabet[Number(num % 26n)] + out;
+        num /= 26n;
+    }
+    return out.padStart(length, "a"); // optional padding
+}
+/**
+ * Creates a RelationalDb instance with namespace support.
+ * @param baseDb The base RelationalDb instance to enhance.
+ * @param baseOptions The default options for namespace creation. Hashes namespace by default.
+ * @returns The enhanced RelationalDb instance.
+ */
+export function createRelationalDb(baseDb, baseOptions) {
+    const relationalDb = baseDb;
+    relationalDb.createNamespace = (namespace, options) => createNamespacedDb(baseDb, namespace, options ?? baseOptions);
+    relationalDb.queryNamespace = (namespace, options) => createNamespacedQueryBuilder(baseDb, namespace, options ?? baseOptions);
+    return relationalDb;
+}
+export async function createNamespacedDb(db, namespace, options) {
+    // hash the namespace to avoid too long namespaces
+    const shouldHash = options?.hashNamespace ?? true;
+    const hashValue = shouldHash ? hashNamespace(namespace) : namespace;
+    await db.schema.createSchema(hashValue).ifNotExists().execute();
+    const schemaRelationalDb = db.withSchema(hashValue);
+    return schemaRelationalDb;
+}
+export function createNamespacedQueryBuilder(db, namespace, options) {
+    const shouldHash = options?.hashNamespace ?? true;
+    const hashValue = shouldHash ? hashNamespace(namespace) : namespace;
+    const namespacedDb = db.withSchema(hashValue);
+    return relationalDbToQueryBuilder(namespacedDb);
+}
+/**
+ * Returns a query builder for a RelationalDb instance.
+ * @param query The RelationalDb instance to convert.
+ * @returns The IRelationalQueryBuilder instance.
+ */
+export function relationalDbToQueryBuilder(query) {
+    return {
+        selectFrom: query.selectFrom.bind(query),
+        selectNoFrom: query.selectNoFrom.bind(query),
+        with: query.with.bind(query),
+        withRecursive: query.withRecursive.bind(query),
+        withSchema: (schema) => relationalDbToQueryBuilder(query.withSchema(schema)),
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/processors/relational/utils.js.map

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

package/dist/src/processors/types.d.ts

@@ -1,5 +1,13 @@
+import type { IAnalyticsStore } from "@powerhousedao/analytics-engine-core";
+import type { IRelationalDb, OperationWithContext } from "@powerhousedao/reactor";
 import type { PHDocumentHeader } from "document-model";
-import type { OperationWithContext } from "../storage/interfaces.js";
+export type TempProcessorAppToBeRemoved = "connect" | "switchboard";
+export interface IProcessorHostModule {
+    analyticsStore: IAnalyticsStore;
+    relationalDb: IRelationalDb;
+    processorApp: TempProcessorAppToBeRemoved;
+    config?: Map<string, unknown>;
+}
 /**
  * Filter for matching operations to processors.
  * All fields are optional arrays - when provided, operations must match at least one value in each specified field.
@@ -37,7 +45,7 @@ export type ProcessorRecord = {
  * A factory function that creates processor records for a given drive.
  * Called once per drive when the drive is first detected or when the factory is registered.
  */
-export type ProcessorFactory = (driveHeader: PHDocumentHeader) => ProcessorRecord[] | Promise<ProcessorRecord[]>;
+export type ProcessorFactory = (driveHeader: PHDocumentHeader, processorApp?: TempProcessorAppToBeRemoved) => ProcessorRecord[] | Promise<ProcessorRecord[]>;
 /**
  * Manages processor creation and destruction based on drive operations.
  */

package/dist/src/processors/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/processors/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,YAAY,CAAC,UAAU,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,UAAU,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;CACzB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,WAAW,EAAE,gBAAgB,KAC1B,eAAe,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9E;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;OAEG;IACH,qBAAqB,IAAI,MAAM,EAAE,CAAC;IAElC;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;CAC3D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/processors/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,MAAM,MAAM,2BAA2B,GAAG,SAAS,GAAG,aAAa,CAAC;AAEpE,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,eAAe,CAAC;IAChC,YAAY,EAAE,aAAa,CAAC;IAC5B,YAAY,EAAE,2BAA2B,CAAC;IAC1C,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,YAAY,CAAC,UAAU,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,UAAU,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;CACzB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,WAAW,EAAE,gBAAgB,EAC7B,YAAY,CAAC,EAAE,2BAA2B,KACvC,eAAe,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9E;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;OAEG;IACH,qBAAqB,IAAI,MAAM,EAAE,CAAC;IAElC;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;CAC3D"}

package/dist/src/processors/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/processors/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,wBAAgB,eAAe,CAAC,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAKjE;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAEjE;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,oBAAoB,GACvB,gBAAgB,GAAG,SAAS,CAQ9B;AAED,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,oBAAoB,GACvB,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAe1E;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,oBAAoB,EACxB,MAAM,EAAE,eAAe,GACtB,OAAO,CA0BT"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/processors/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,wBAAgB,eAAe,CAAC,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAKjE;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAEjE;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,oBAAoB,GACvB,gBAAgB,GAAG,SAAS,CAQ9B;AAED,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,oBAAoB,GACvB,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAe1E;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,oBAAoB,EACxB,MAAM,EAAE,eAAe,GACtB,OAAO,CA2BT"}

package/dist/src/processors/utils.js

@@ -49,7 +49,8 @@ export function matchesFilter(op, filter) {
         }
     }
     if (filter.documentId && filter.documentId.length > 0) {
-        if (!filter.documentId.includes(op.context.documentId)) {
+        const hasWildcard = filter.documentId.includes("*");
+        if (!hasWildcard && !filter.documentId.includes(op.context.documentId)) {
             return false;
         }
     }

package/dist/src/processors/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/processors/utils.ts"],"names":[],"mappings":"AAIA,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAExD,MAAM,UAAU,eAAe,CAAC,EAAwB;IACtD,OAAO,CACL,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,iBAAiB;QAC9C,EAAE,CAAC,OAAO,CAAC,YAAY,KAAK,mBAAmB,CAChD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAwB;IACtD,OAAO,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,iBAAiB,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,EAAwB;IAExB,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc;QAAE,OAAO,SAAS,CAAC;IAEjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAGjD,CAAC;IACF,OAAO,KAAK,CAAC,MAAsC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,EAAwB;IAExB,MAAM,KAAK,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,KAAgC,CAAC;IACnE,OAAO,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,OAAO;QACL,EAAE,EAAE,OAAO;QACX,YAAY,EAAE,mBAAmB;QACjC,GAAG,EAAE;YACH,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,EAAE;SACV;QACD,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,EAAE;QACR,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACzC,oBAAoB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,EAAwB,EACxB,MAAuB;IAEvB,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3D,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/C,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/processors/utils.ts"],"names":[],"mappings":"AAIA,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAExD,MAAM,UAAU,eAAe,CAAC,EAAwB;IACtD,OAAO,CACL,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,iBAAiB;QAC9C,EAAE,CAAC,OAAO,CAAC,YAAY,KAAK,mBAAmB,CAChD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAwB;IACtD,OAAO,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,iBAAiB,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,EAAwB;IAExB,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc;QAAE,OAAO,SAAS,CAAC;IAEjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAGjD,CAAC;IACF,OAAO,KAAK,CAAC,MAAsC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,EAAwB;IAExB,MAAM,KAAK,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,KAAgC,CAAC;IACnE,OAAO,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,OAAO;QACL,EAAE,EAAE,OAAO;QACX,YAAY,EAAE,mBAAmB;QACjC,GAAG,EAAE;YACH,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,EAAE;SACV;QACD,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,EAAE;QACR,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACzC,oBAAoB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,EAAwB,EACxB,MAAuB;IAEvB,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3D,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/C,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACvE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/queue/queue.d.ts

@@ -18,6 +18,7 @@ export declare class InMemoryQueue implements IQueue {
     private jobIndex;
     private isBlocked;
     private onDrainedCallback?;
+    private isPausedFlag;
     constructor(eventBus: IEventBus);
     private toErrorInfo;
     /**
@@ -77,5 +78,29 @@ export declare class InMemoryQueue implements IQueue {
      * Unblocks the queue from accepting new jobs.
      */
     unblock(): void;
+    /**
+     * Pauses job dequeuing. Jobs can still be enqueued but dequeueNext() will return null.
+     */
+    pause(): void;
+    /**
+     * Resumes job dequeuing and emits JOB_AVAILABLE events for pending jobs to wake up executors.
+     */
+    resume(): Promise<void>;
+    /**
+     * Returns whether job dequeuing is paused.
+     */
+    get paused(): boolean;
+    /**
+     * Returns all pending jobs across all queues.
+     */
+    getPendingJobs(): Job[];
+    /**
+     * Returns a map of document IDs to sets of executing job IDs.
+     */
+    getExecutingJobIds(): Map<string, Set<string>>;
+    /**
+     * Returns a job by ID from the job index.
+     */
+    getJob(jobId: string): Job | undefined;
 }
 //# sourceMappingURL=queue.d.ts.map

package/dist/src/queue/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/queue/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,GAAG,EAAqB,MAAM,YAAY,CAAC;AAG9E;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,MAAM;IAU9B,OAAO,CAAC,QAAQ;IAT5B,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,iBAAiB,CAAC,CAAa;gBAEnB,QAAQ,EAAE,SAAS;IAEvC,OAAO,CAAC,WAAW;IAanB;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAShB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAS/B,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BtC,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAiDtC,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAqDtE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxE,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAQ5B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqCvC,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBvE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAYzB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAOrB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBzC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BxD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC/D;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAUvB;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;IAQnC;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/queue/queue.ts"],"names":[],"mappings":"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"}

package/dist/src/queue/queue.js

@@ -16,6 +16,7 @@ export class InMemoryQueue {
     jobIndex = new Map();
     isBlocked = false;
     onDrainedCallback;
+    isPausedFlag = false;
     constructor(eventBus) {
         this.eventBus = eventBus;
     }
@@ -164,6 +165,9 @@ export class InMemoryQueue {
         if (signal?.aborted) {
             return Promise.reject(new Error("Operation aborted"));
         }
+        if (this.isPausedFlag) {
+            return Promise.resolve(null);
+        }
         // Find the first non-empty queue for a document that's not currently executing
         for (const [queueKey, queue] of this.queues.entries()) {
             if (queue.length > 0) {
@@ -380,5 +384,57 @@ export class InMemoryQueue {
         this.isBlocked = false;
         this.onDrainedCallback = undefined;
     }
+    /**
+     * Pauses job dequeuing. Jobs can still be enqueued but dequeueNext() will return null.
+     */
+    pause() {
+        this.isPausedFlag = true;
+    }
+    /**
+     * Resumes job dequeuing and emits JOB_AVAILABLE events for pending jobs to wake up executors.
+     */
+    async resume() {
+        this.isPausedFlag = false;
+        // Emit JOB_AVAILABLE for each queue with pending jobs to wake up the executor manager
+        for (const [, queue] of this.queues.entries()) {
+            if (queue.length > 0) {
+                const job = queue[0];
+                await this.eventBus.emit(QueueEventTypes.JOB_AVAILABLE, {
+                    documentId: job.documentId,
+                    scope: job.scope,
+                    branch: job.branch,
+                    jobId: job.id,
+                });
+            }
+        }
+    }
+    /**
+     * Returns whether job dequeuing is paused.
+     */
+    get paused() {
+        return this.isPausedFlag;
+    }
+    /**
+     * Returns all pending jobs across all queues.
+     */
+    getPendingJobs() {
+        const jobs = [];
+        for (const queue of this.queues.values()) {
+            jobs.push(...queue);
+        }
+        return jobs;
+    }
+    /**
+     * Returns a map of document IDs to sets of executing job IDs.
+     */
+    getExecutingJobIds() {
+        return new Map(Array.from(this.docIdToJobId.entries()).map(([k, v]) => [k, new Set(v)]));
+    }
+    /**
+     * Returns a job by ID from the job index.
+     */
+    getJob(jobId) {
+        return this.jobIndex.get(jobId);
+    }
 }
 //# sourceMappingURL=queue.js.map