@powerhousedao/shared 6.0.0-dev.47

package/dist/document-model/types.d.ts

@@ -0,0 +1,97 @@
+import type { ProcessorFactoryBuilder } from "../processors/types.js";
+import type { Action } from "./core/actions.js";
+import type { PHDocument } from "./core/documents.js";
+import type { PHBaseState } from "./core/state.js";
+import type { AssertIsDocumentOfType, AssertIsStateOfType, CreateDocument, CreateState, EditorModule, ID, ImportScriptModule, IsDocumentOfType, IsStateOfType, LoadFromInput, Manifest, Reducer, SaveToFileHandle, SubgraphModule } from "./core/types.js";
+import type { UpgradeManifest } from "./core/upgrades.js";
+export type State = {
+    examples: CodeExample[];
+    initialValue: string;
+    schema: string;
+};
+export type ScopeState = {
+    global: State;
+    local: State;
+};
+export type DocumentModelUtils<TState extends PHBaseState = PHBaseState> = {
+    fileExtension: string;
+    createState: CreateState<TState>;
+    createDocument: CreateDocument<TState>;
+    loadFromInput: LoadFromInput<TState>;
+    saveToFileHandle: SaveToFileHandle;
+    isStateOfType: IsStateOfType<TState>;
+    assertIsStateOfType: AssertIsStateOfType<TState>;
+    isDocumentOfType: IsDocumentOfType<TState>;
+    assertIsDocumentOfType: AssertIsDocumentOfType<TState>;
+};
+export type DocumentModelModule<TState extends PHBaseState = PHBaseState> = {
+    /** optional version field, should be made required */
+    version?: number;
+    reducer: Reducer<TState>;
+    actions: Record<string, (...args: any[]) => Action>;
+    utils: DocumentModelUtils<TState>;
+    documentModel: DocumentModelPHState;
+};
+export type DocumentModelLib<TState extends PHBaseState = PHBaseState> = {
+    manifest: Manifest;
+    documentModels: DocumentModelModule<TState>[];
+    editors: EditorModule[];
+    subgraphs: SubgraphModule[];
+    importScripts: ImportScriptModule[];
+    upgradeManifests: UpgradeManifest<readonly number[]>[];
+    processorFactory: ProcessorFactoryBuilder;
+};
+export type Author = {
+    name: string;
+    website: string | null;
+};
+export type OperationErrorSpecification = {
+    code: string | null;
+    description: string | null;
+    id: ID;
+    name: string | null;
+    template: string | null;
+};
+export type CodeExample = {
+    id: ID;
+    value: string;
+};
+export type OperationSpecification = {
+    description: string | null;
+    errors: OperationErrorSpecification[];
+    examples: CodeExample[];
+    id: ID;
+    name: string | null;
+    reducer: string | null;
+    schema: string | null;
+    template: string | null;
+    scope: string;
+};
+export type ModuleSpecification = {
+    description: string | null;
+    id: ID;
+    name: string;
+    operations: OperationSpecification[];
+};
+export type DocumentSpecification = {
+    changeLog: string[];
+    modules: ModuleSpecification[];
+    state: ScopeState;
+    version: number;
+};
+export type DocumentModelGlobalState = {
+    author: Author;
+    description: string;
+    extension: string;
+    id: string;
+    name: string;
+    specifications: DocumentSpecification[];
+};
+export type DocumentModelLocalState = {};
+export type DocumentModelPHState = PHBaseState & {
+    global: DocumentModelGlobalState;
+    local: DocumentModelLocalState;
+};
+export type DocumentModelDocument = PHDocument<DocumentModelPHState>;
+export type DocumentModelDocumentModelModule = DocumentModelModule<DocumentModelPHState>;
+//# sourceMappingURL=types.d.ts.map

package/dist/document-model/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../document-model/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,EAAE,EACF,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,QAAQ,EACR,OAAO,EACP,gBAAgB,EAChB,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,MAAM,KAAK,GAAG;IAClB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,KAAK,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,MAAM,SAAS,WAAW,GAAG,WAAW,IAAI;IACzE,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,cAAc,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,mBAAmB,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACjD,gBAAgB,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3C,sBAAsB,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,MAAM,SAAS,WAAW,GAAG,WAAW,IAAI;IAC1E,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,CAAC;IACpD,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClC,aAAa,EAAE,oBAAoB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,MAAM,SAAS,WAAW,GAAG,WAAW,IAAI;IACvE,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9C,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,gBAAgB,EAAE,eAAe,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;IACvD,gBAAgB,EAAE,uBAAuB,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,EAAE,EAAE,EAAE,CAAC;IACP,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,EAAE,CAAC;IACP,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,2BAA2B,EAAE,CAAC;IACtC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,EAAE,EAAE,EAAE,CAAC;IACP,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,EAAE,EAAE,EAAE,CAAC;IACP,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,sBAAsB,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,qBAAqB,EAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,EAAE,CAAC;AACzC,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG;IAC/C,MAAM,EAAE,wBAAwB,CAAC;IACjC,KAAK,EAAE,uBAAuB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;AACrE,MAAM,MAAM,gCAAgC,GAC1C,mBAAmB,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/document-model/types.js

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

package/dist/document-model/types.js.map

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

package/dist/processors/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const PROCESSOR_APPS: readonly ["connect", "switchboard"];
+export declare const DEFAULT_RELATIONAL_PROCESSOR_DB_NAME = "relational-db";
+export declare const DEFAULT_ANALYTICS_PROCESSOR_DB_NAME = "analytics-db";
+//# sourceMappingURL=constants.d.ts.map

package/dist/processors/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../processors/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,qCAAsC,CAAC;AAClE,eAAO,MAAM,oCAAoC,kBAAkB,CAAC;AACpE,eAAO,MAAM,mCAAmC,iBAAiB,CAAC"}

package/dist/processors/constants.js

@@ -0,0 +1,4 @@
+export const PROCESSOR_APPS = ["connect", "switchboard"];
+export const DEFAULT_RELATIONAL_PROCESSOR_DB_NAME = "relational-db";
+export const DEFAULT_ANALYTICS_PROCESSOR_DB_NAME = "analytics-db";
+//# sourceMappingURL=constants.js.map

package/dist/processors/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../processors/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,aAAa,CAAU,CAAC;AAClE,MAAM,CAAC,MAAM,oCAAoC,GAAG,eAAe,CAAC;AACpE,MAAM,CAAC,MAAM,mCAAmC,GAAG,cAAc,CAAC"}

package/dist/processors/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./constants.js";
+export * from "./relational/types.js";
+export * from "./relational/utils.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../processors/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,mBAAmB,YAAY,CAAC"}

package/dist/processors/index.js

@@ -0,0 +1,4 @@
+export * from "./constants.js";
+export * from "./relational/types.js";
+export * from "./relational/utils.js";
+//# sourceMappingURL=index.js.map

package/dist/processors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../processors/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

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

@@ -0,0 +1,72 @@
+import type { OperationWithContext } from "@powerhousedao/shared/document-model";
+import type { Kysely, QueryCreator } from "kysely";
+import type { IProcessor, ProcessorFilter } from "../types.js";
+export type IRelationalQueryMethods = "selectFrom" | "selectNoFrom" | "with" | "withRecursive";
+export type IRelationalQueryBuilder<Schema = unknown> = Pick<QueryCreator<Schema>, IRelationalQueryMethods> & {
+    withSchema: (schema: string) => IRelationalQueryBuilder<Schema>;
+};
+export type HashAlgorithms = "fnv1a";
+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 type ExtractProcessorSchemaOrSelf<TProcessor> = TProcessor extends RelationalDbProcessor<infer TSchema> ? TSchema : TProcessor;
+export type RelationalDbProcessorClass<TSchema> = typeof RelationalDbProcessor<TSchema>;
+export interface IRelationalDbProcessor<TDatabaseSchema = unknown> extends IProcessor {
+    namespace: string;
+    query: IRelationalQueryBuilder<TDatabaseSchema>;
+    filter: ProcessorFilter;
+    initAndUpgrade(): Promise<void>;
+}
+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=types.d.ts.map

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

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

package/dist/processors/relational/types.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=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../processors/relational/types.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAgDxD,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/processors/relational/utils.d.ts

@@ -0,0 +1,29 @@
+import type { IBaseRelationalDb, IRelationalDb, IRelationalQueryBuilder } from "./types.js";
+/**
+ * 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/processors/relational/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../processors/relational/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAIpB;;;;;;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/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/processors/relational/utils.js.map

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

package/dist/processors/types.d.ts

@@ -0,0 +1,76 @@
+import type { IAnalyticsStore } from "@powerhousedao/analytics-engine-core";
+import type { OperationWithContext } from "@powerhousedao/shared/document-model";
+import type { PHDocumentHeader } from "../document-model/core/documents.js";
+import type { PROCESSOR_APPS } from "./constants.js";
+import type { IRelationalDb } from "./relational/types.js";
+export interface IProcessorHostModule {
+    analyticsStore: IAnalyticsStore;
+    relationalDb: IRelationalDb;
+    processorApp: ProcessorApp;
+    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.
+ * When a field is undefined or empty, it matches all values for that field.
+ */
+export type ProcessorFilter = {
+    documentType?: string[];
+    scope?: string[];
+    branch?: string[];
+    documentId?: string[];
+};
+/**
+ * Describes an object that can process operations.
+ */
+export interface IProcessor {
+    /**
+     * Processes a list of operations with context.
+     * Called when operations match this processor's filter.
+     */
+    onOperations(operations: OperationWithContext[]): Promise<void>;
+    /**
+     * Called when the processor is disconnected.
+     * Used to clean up any resources allocated during processor creation.
+     */
+    onDisconnect(): Promise<void>;
+}
+/**
+ * Relates a processor to its filter configuration.
+ */
+export type ProcessorRecord = {
+    processor: IProcessor;
+    filter: ProcessorFilter;
+};
+/**
+ * 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, processorApp?: ProcessorApp) => ProcessorRecord[] | Promise<ProcessorRecord[]>;
+/** Takes a processor host module and builds processor factories using its context */
+export type ProcessorFactoryBuilder = (module: IProcessorHostModule) => Promise<(driveHeader: PHDocumentHeader) => Promise<ProcessorRecord[]>>;
+/**
+ * Manages processor creation and destruction based on drive operations.
+ */
+export interface IProcessorManager {
+    /**
+     * Registers a processor factory.
+     * Immediately creates processors for all existing drives.
+     */
+    registerFactory(identifier: string, factory: ProcessorFactory): Promise<void>;
+    /**
+     * Unregisters a processor factory and disconnects all processors it created.
+     */
+    unregisterFactory(identifier: string): Promise<void>;
+    /**
+     * Gets all registered factory identifiers.
+     */
+    getFactoryIdentifiers(): string[];
+    /**
+     * Gets all processor records for a specific drive.
+     */
+    getProcessorsForDrive(driveId: string): ProcessorRecord[];
+}
+export type ProcessorApp = (typeof PROCESSOR_APPS)[number];
+export type ProcessorApps = readonly ProcessorApp[];
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../processors/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,eAAe,CAAC;IAChC,YAAY,EAAE,aAAa,CAAC;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B,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,YAAY,KACxB,eAAe,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;AAEpD,qFAAqF;AACrF,MAAM,MAAM,uBAAuB,GAAG,CACpC,MAAM,EAAE,oBAAoB,KACzB,OAAO,CAAC,CAAC,WAAW,EAAE,gBAAgB,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;AAE5E;;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;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG,SAAS,YAAY,EAAE,CAAC"}

package/dist/processors/types.js

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

package/dist/processors/types.js.map

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