@powerhousedao/reactor-api 1.21.2 → 1.22.0

package/dist/src/subgraphs/system/index.js

@@ -0,0 +1,63 @@
+import { Subgraph } from "#subgraphs/index.js";
+import { GraphQLError } from "graphql";
+import { gql } from "graphql-tag";
+import { ADMIN_USERS } from "./env/index.js";
+export class SystemSubgraph extends Subgraph {
+    name = "system";
+    typeDefs = gql `
+    type Query {
+      drives: [String!]!
+      driveIdBySlug(slug: String!): String
+    }
+
+    type Mutation {
+      addDrive(
+        global: DocumentDriveStateInput!
+        preferredEditor: String
+      ): DocumentDrive_DocumentDriveState
+      deleteDrive(id: ID!): Boolean
+      setDriveIcon(id: String!, icon: String!): Boolean
+      setDriveName(id: String!, name: String!): Boolean
+    }
+
+    input DocumentDriveStateInput {
+      name: String
+      id: String
+      slug: String
+      icon: String
+    }
+  `;
+    resolvers = {
+        Query: {
+            drives: async () => {
+                return await this.reactor.getDrives();
+            },
+        },
+        Mutation: {
+            addDrive: async (parent, args, ctx) => {
+                try {
+                    const isAdmin = ctx.isAdmin(ctx);
+                    if (!isAdmin) {
+                        throw new GraphQLError("Unauthorized");
+                    }
+                    const drive = await this.reactor.addDrive({ global: args.global, local: args.local }, args.preferredEditor);
+                    return drive.state.global;
+                }
+                catch (e) {
+                    console.error(e);
+                    throw new Error(e);
+                }
+            },
+        },
+    };
+    async onSetup() {
+        await super.onSetup();
+        this.subgraphManager.setAdditionalContextFields({
+            isAdmin: (ctx) => {
+                return (ADMIN_USERS.length === 0 ||
+                    (ctx.session.address &&
+                        ADMIN_USERS.includes(ctx.session.address.toLocaleLowerCase())));
+            },
+        });
+    }
+}

package/dist/src/subgraphs/system/types.d.ts

@@ -0,0 +1,5 @@
+import { AuthContext } from "#subgraphs/auth/types.js";
+export type SystemContext = AuthContext & {
+    isAdmin: (ctx: AuthContext) => boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/subgraphs/system/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/subgraphs/system/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG;IACxC,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC;CACxC,CAAC"}

package/dist/src/subgraphs/system/types.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,27 @@
+import { IDocumentDriveServer } from "document-drive";
+import { DocumentNode } from "graphql";
+import type { IncomingHttpHeaders } from "http";
+import { Db } from "#types.js";
+import { IAnalyticsStore } from "@powerhousedao/analytics-engine-core";
+import { SubgraphManager } from "./manager.js";
+export type Context = {
+    driveServer: IDocumentDriveServer;
+    driveId?: string;
+    headers: IncomingHttpHeaders;
+    db: unknown;
+};
+export type ISubgraph = {
+    name: string;
+    resolvers: Record<string, any>;
+    typeDefs: DocumentNode;
+    reactor: IDocumentDriveServer;
+    operationalStore: Db;
+    onSetup?: () => Promise<void>;
+};
+export type SubgraphArgs = {
+    reactor: IDocumentDriveServer;
+    operationalStore: Db;
+    analyticsStore: IAnalyticsStore;
+    subgraphManager: SubgraphManager;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/subgraphs/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAChD,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,MAAM,OAAO,GAAG;IACpB,WAAW,EAAE,oBAAoB,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,EAAE,EAAE,OAAO,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,gBAAgB,EAAE,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,gBAAgB,EAAE,EAAE,CAAC;IACrB,cAAc,EAAE,eAAe,CAAC;IAChC,eAAe,EAAE,eAAe,CAAC;CAClC,CAAC"}

package/dist/src/subgraphs/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/sync/utils.d.ts

@@ -0,0 +1,13 @@
+import { IDocumentDriveServer, ListenerRevision, StrandUpdate } from "document-drive";
+import { Operation, OperationScope } from "document-model";
+export type InternalStrandUpdate = {
+    operations: Operation[];
+    documentId: string;
+    driveId: string;
+    scope: OperationScope;
+    branch: string;
+};
+export declare const processPushUpdate: (reactor: IDocumentDriveServer, strand: InternalStrandUpdate) => Promise<ListenerRevision>;
+export declare const processAcknowledge: (reactor: IDocumentDriveServer, driveId: string, listenerId: string, revisions: ListenerRevision[]) => Promise<boolean>;
+export declare const processGetStrands: (reactor: IDocumentDriveServer, driveId: string, listenerId: string, since: string | undefined) => Promise<StrandUpdate[]>;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/sync/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,oBAAoB,EACpB,gBAAgB,EAEhB,YAAY,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAG3D,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAGF,eAAO,MAAM,iBAAiB,YACnB,oBAAoB,UACrB,oBAAoB,KAC3B,OAAO,CAAC,gBAAgB,CAkC1B,CAAC;AAGF,eAAO,MAAM,kBAAkB,YACpB,oBAAoB,WACpB,MAAM,cACH,MAAM,aACP,gBAAgB,EAAE,KAC5B,OAAO,CAAC,OAAO,CAMjB,CAAC;AAGF,eAAO,MAAM,iBAAiB,YACnB,oBAAoB,WACpB,MAAM,cACH,MAAM,SACX,MAAM,GAAG,SAAS,KACxB,OAAO,CAAC,YAAY,EAAE,CAMxB,CAAC"}

package/dist/src/sync/utils.js

@@ -0,0 +1,37 @@
+// processes a strand update and returns a listener revision
+export const processPushUpdate = async (reactor, strand) => {
+    const result = await (strand.documentId !== undefined
+        ? reactor.queueOperations(strand.driveId, strand.documentId, strand.operations)
+        : reactor.queueDriveOperations(strand.driveId, strand.operations));
+    const scopeOperations = result.document?.operations[strand.scope] ?? [];
+    if (scopeOperations.length === 0) {
+        return {
+            revision: -1,
+            branch: strand.branch,
+            documentId: strand.documentId ?? "",
+            driveId: strand.driveId,
+            scope: strand.scope,
+            status: result.status,
+        };
+    }
+    const revision = scopeOperations.slice().pop()?.index ?? -1;
+    return {
+        revision,
+        branch: strand.branch,
+        documentId: strand.documentId ?? "",
+        driveId: strand.driveId,
+        scope: strand.scope,
+        status: result.status,
+        error: result.error?.message || undefined,
+    };
+};
+// processes an acknowledge request and returns a boolean
+export const processAcknowledge = async (reactor, driveId, listenerId, revisions) => {
+    const transmitter = (await reactor.getTransmitter(driveId, listenerId));
+    return transmitter.processAcknowledge(driveId, listenerId, revisions);
+};
+// processes a get strands request and returns a list of strand updates
+export const processGetStrands = async (reactor, driveId, listenerId, since) => {
+    const transmitter = (await reactor.getTransmitter(driveId, listenerId));
+    return transmitter.getStrands({ since });
+};

package/dist/src/types.d.ts

@@ -0,0 +1,29 @@
+import { IDocumentDriveServer, IReceiver, Listener } from "document-drive";
+import { Express } from "express";
+import { IAnalyticsStore } from "./processors/analytics-processor.js";
+import { ProcessorClass } from "./processors/processor.js";
+import { SubgraphManager } from "./subgraphs/manager.js";
+import { Db } from "./utils/db.js";
+export type { Db } from "./utils/db.js";
+export type IProcessorManager = {
+    registerProcessor(module: IProcessor | ProcessorClass): Promise<IProcessor>;
+};
+export type API = {
+    app: Express;
+    subgraphManager: SubgraphManager;
+    processorManager: IProcessorManager;
+};
+export type ProcessorType = "analytics" | "operational";
+export type ProcessorSetupArgs = {
+    reactor: IDocumentDriveServer;
+    operationalStore: Db;
+    analyticsStore: IAnalyticsStore;
+};
+export type IProcessor = IReceiver & {
+    onSetup?: (args: ProcessorSetupArgs) => void;
+    getOptions: () => ProcessorOptions;
+};
+export type ProcessorOptions = Omit<Listener, "driveId" | "callInfo"> & {
+    label: string;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAEnC,YAAY,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7E,CAAC;AAEF,MAAM,MAAM,GAAG,GAAG;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,eAAe,EAAE,eAAe,CAAC;IACjC,gBAAgB,EAAE,iBAAiB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,aAAa,CAAC;AAExD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,gBAAgB,EAAE,EAAE,CAAC;IACrB,cAAc,EAAE,eAAe,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG;IACnC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC7C,UAAU,EAAE,MAAM,gBAAgB,CAAC;CACpC,CAAC;AAQF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,UAAU,CAAC,GAAG;IACtE,KAAK,EAAE,MAAM,CAAC;CACf,CAAC"}

package/dist/src/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/utils/create-schema.d.ts

@@ -0,0 +1,7 @@
+import { Context } from "#subgraphs/types.js";
+import { GraphQLResolverMap } from "@apollo/subgraph/dist/schema-helper/resolverMap.js";
+import { IDocumentDriveServer } from "document-drive";
+import { DocumentNode } from "graphql";
+export declare const createSchema: (documentDriveServer: IDocumentDriveServer, resolvers: GraphQLResolverMap<Context>, typeDefs: DocumentNode) => import("graphql").GraphQLSchema;
+export declare const getDocumentModelTypeDefs: (documentDriveServer: IDocumentDriveServer, typeDefs: DocumentNode) => DocumentNode;
+//# sourceMappingURL=create-schema.d.ts.map

package/dist/src/utils/create-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-schema.d.ts","sourceRoot":"","sources":["../../../src/utils/create-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAGxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,eAAO,MAAM,YAAY,wBACF,oBAAoB,aAC9B,kBAAkB,CAAC,OAAO,CAAC,YAC5B,YAAY,oCAOpB,CAAC;AAEL,eAAO,MAAM,wBAAwB,wBACd,oBAAoB,YAC/B,YAAY,iBAwIvB,CAAC"}

package/dist/src/utils/create-schema.js

@@ -0,0 +1,122 @@
+import { buildSubgraphSchema } from "@apollo/subgraph";
+import { typeDefs as scalarsTypeDefs } from "@powerhousedao/scalars";
+import { pascalCase } from "change-case";
+import { gql } from "graphql-tag";
+export const createSchema = (documentDriveServer, resolvers, typeDefs) => buildSubgraphSchema([
+    {
+        typeDefs: getDocumentModelTypeDefs(documentDriveServer, typeDefs),
+        resolvers,
+    },
+]);
+export const getDocumentModelTypeDefs = (documentDriveServer, typeDefs) => {
+    const documentModels = documentDriveServer.getDocumentModelModules();
+    let dmSchema = "";
+    documentModels.forEach(({ documentModel }) => {
+        const dmSchemaName = pascalCase(documentModel.name.replaceAll("/", " "));
+        let tmpDmSchema = `
+          ${documentModel.specifications
+            .map((specification) => specification.state.global.schema
+            .replaceAll("scalar DateTime", "")
+            .replaceAll(/input (.*?) {[\s\S]*?}/g, ""))
+            .join("\n")};
+  
+          ${documentModel.specifications
+            .map((specification) => specification.state.local.schema
+            .replaceAll("scalar DateTime", "")
+            .replaceAll(/input (.*?) {[\s\S]*?}/g, "")
+            .replaceAll("type AccountSnapshotLocalState", "")
+            .replaceAll("type BudgetStatementLocalState", "")
+            .replaceAll("type ScopeFrameworkLocalState", ""))
+            .join("\n")};
+
+    \n`;
+        const found = tmpDmSchema.match(/(type|enum|union)\s+(\w+)\s/g);
+        const trimmedFound = found?.map((f) => f
+            .replaceAll("type ", "")
+            .replaceAll("enum ", "")
+            .replaceAll("union ", "")
+            .trim());
+        trimmedFound?.forEach((f) => {
+            // Create a regex that matches the type name with proper boundaries
+            const typeRegex = new RegExp(
+            // Match type references in various GraphQL contexts
+            `(?<![_A-Za-z0-9])(${f})(?![_A-Za-z0-9])|` + // Basic type references
+                `\\[(${f})\\]|` + // Array types without nullability
+                `\\[(${f})!\\]|` + // Array of non-null types
+                `\\[(${f})\\]!|` + // Non-null array of types
+                `\\[(${f})!\\]!`, // Non-null array of non-null types
+            "g");
+            tmpDmSchema = tmpDmSchema.replace(typeRegex, (match, p1, p2, p3, p4, p5) => {
+                // If it's an array type, preserve the brackets and ! while replacing the type name
+                if (match.startsWith("[")) {
+                    return match.replace(p2 || p3 || p4 || p5, `${dmSchemaName}_${p2 || p3 || p4 || p5}`);
+                }
+                // Basic type reference
+                return `${dmSchemaName}_${p1}`;
+            });
+        });
+        dmSchema += tmpDmSchema;
+        dmSchema += `
+    type ${dmSchemaName} implements IDocument {
+              id: String!
+              name: String!
+              documentType: String!
+              operations(skip: Int, first: Int): [Operation!]!
+              revision: Int!
+              created: DateTime!
+              lastModified: DateTime!
+              ${dmSchemaName !== "DocumentModel" ? `initialState: ${dmSchemaName}_${dmSchemaName}State!` : ""}
+              ${dmSchemaName !== "DocumentModel" ? `state: ${dmSchemaName}_${dmSchemaName}State!` : ""}
+          }\n`;
+    });
+    // add the mutation and query types
+    const schema = gql `
+    ${scalarsTypeDefs.join("\n").replaceAll(";", "")}
+
+    type PHOperationContext {
+      signer: Signer
+    }
+
+    type Signer {
+      user: SignerUser
+      app: SignerApp
+      signatures: [String!]!
+    }
+
+    type SignerUser {
+      address: String!
+      networkId: String!
+      chainId: Int!
+    }
+
+    type SignerApp {
+      name: String!
+      key: String!
+    }
+
+    type Operation {
+      id: String!
+      type: String!
+      index: Int!
+      timestamp: DateTime!
+      hash: String!
+      skip: Int
+      inputText: String
+      error: String
+      context: PHOperationContext
+    }
+    interface IDocument {
+      id: String!
+      name: String!
+      documentType: String!
+      revision: Int!
+      created: DateTime!
+      lastModified: DateTime!
+      operations(first: Int, skip: Int): [Operation!]!
+    }
+    ${dmSchema.replaceAll(";", "")}
+
+    ${typeDefs}
+  `;
+    return schema;
+};

package/dist/src/utils/db.d.ts

@@ -0,0 +1,4 @@
+import { type Knex } from "knex";
+export type Db = Knex;
+export declare function getDbClient(connectionString?: string | undefined): Db;
+//# sourceMappingURL=db.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../src/utils/db.ts"],"names":[],"mappings":"AACA,OAAa,EAAE,KAAK,IAAI,EAAE,MAAM,MAAM,CAAC;AAGvC,MAAM,MAAM,EAAE,GAAG,IAAI,CAAC;AAStB,wBAAgB,WAAW,CACzB,gBAAgB,GAAE,MAAM,GAAG,SAAqB,GAC/C,EAAE,CAUJ"}

package/dist/src/utils/db.js

@@ -0,0 +1,20 @@
+import { PGlite } from "@electric-sql/pglite";
+import knex from "knex";
+import ClientPgLite from "knex-pglite";
+function isPG(connectionString) {
+    if (connectionString.startsWith("postgres://")) {
+        return true;
+    }
+    return false;
+}
+export function getDbClient(connectionString = undefined) {
+    const isPg = connectionString && isPG(connectionString);
+    const client = isPg ? "pg" : ClientPgLite;
+    const connection = isPg
+        ? { connectionString }
+        : { pglite: new PGlite(connectionString) };
+    return knex({
+        client,
+        connection,
+    });
+}

package/dist/src/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./create-schema.js";
+export * from "./db.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC"}

package/dist/src/utils/index.js

@@ -0,0 +1,2 @@
+export * from "./create-schema.js";
+export * from "./db.js";