@powerhousedao/reactor-api 6.0.2-staging.4 → 6.0.2-staging.5

package/dist/index.d.mts

@@ -10,6 +10,7 @@ import { DocumentModelGlobalState as DocumentModelGlobalState$1, DocumentModelMo
 import { IDocumentModelLoader, IDocumentModelRegistry, IReactorClient, IRelationalDb, ISyncManager, ParsedDriveUrl, ReactorClientModule, driveIdFromUrl, parseDriveUrl } from "@powerhousedao/reactor";
 import * as z$1 from "zod";
 import { DocumentDriveDocument, DocumentDriveGlobalState } from "@powerhousedao/shared/document-drive";
+import { AttachmentBuildResult } from "@powerhousedao/reactor-attachments";
 import { WebSocketServer } from "ws";
 import { IProcessorHostModule, IRelationalDb as IRelationalDb$1, ProcessorApp, ProcessorRecord } from "@powerhousedao/shared/processors";
 import { Generated, Kysely } from "kysely";
@@ -94,7 +95,14 @@ interface OperationGroupPermissionTable {
   createdAt: Date;
 }
 type Db = Kysely<any>;
-declare function getDbClient(connectionString?: string | undefined): {
+/**
+ * Optional factory used by callers (e.g. Switchboard) to inject a
+ * version-specific PGLite instance — e.g. `pglite-legacy-02` when an existing
+ * data dir was created with an older PG major. Wire-compatible with the
+ * current PGLite class for the surface knex-pglite uses.
+ */
+type PgliteFactory = (connectionString: string | undefined) => PGlite;
+declare function getDbClient(connectionString?: string | undefined, pgliteFactory?: PgliteFactory): {
   db: Db;
   knex: Knex;
 };
@@ -817,6 +825,11 @@ declare class AuthService {
   private readonly config;
   constructor(config: AuthConfig);
   authenticateRequest(request: globalThis.Request): Promise<AuthContext | globalThis.Response>;
+  /**
+   * Verify a Bearer token regardless of HTTP method. Use this from non-GraphQL
+   * middleware that must enforce authentication on every request.
+   */
+  verifyBearer(authorization: string | undefined): Promise<AuthContext | globalThis.Response>;
   authenticateWebSocketConnection(connectionParams: Record<string, unknown>): Promise<User | null>;
   /**
    * Verify the auth bearer token
@@ -935,7 +948,7 @@ interface IHttpAdapter {
    * The req/res objects are `http.IncomingMessage`/`http.ServerResponse`
    * (Express Request/Response are compatible subtypes).
    */
-  mountNodeRoute(method: "DELETE" | "GET" | "POST", path: string, handler: (req: http.IncomingMessage, res: http.ServerResponse, body?: unknown) => void): void;
+  mountNodeRoute(method: "DELETE" | "GET" | "POST" | "PUT", path: string, handler: (req: http.IncomingMessage, res: http.ServerResponse, body?: unknown) => void): void;
   /**
    * Register framework-specific Sentry error-capturing middleware after all routes
    * are mounted. Each adapter calls the Sentry setup function appropriate for its
@@ -1046,6 +1059,8 @@ type API = {
   httpAdapter: IHttpAdapter;
   graphqlManager: GraphQLManager$1;
   packages: IPackageManager;
+  attachments: AttachmentBuildResult;
+  authService: AuthService | undefined;
 };
 type ReactorModule = {
   analyticsStore: IAnalyticsStore;
@@ -1361,28 +1376,29 @@ type JobInfo = {
   readonly result: Scalars["JSONObject"]["output"];
   readonly status: Scalars["String"]["output"];
 };
-type MoveChildrenResult = {
+type MoveRelationshipResult = {
   readonly source: PhDocument;
   readonly target: PhDocument;
 };
 type Mutation = {
-  readonly addChildren: PhDocument;
+  readonly addRelationship: PhDocument;
   readonly createDocument: PhDocument;
   readonly createEmptyDocument: PhDocument;
   readonly deleteDocument: Scalars["Boolean"]["output"];
   readonly deleteDocuments: Scalars["Boolean"]["output"];
-  readonly moveChildren: MoveChildrenResult;
+  readonly moveRelationship: MoveRelationshipResult;
   readonly mutateDocument: PhDocument;
   readonly mutateDocumentAsync: Scalars["String"]["output"];
   readonly pushSyncEnvelopes: Scalars["Boolean"]["output"];
-  readonly removeChildren: PhDocument;
+  readonly removeRelationship: PhDocument;
   readonly renameDocument: PhDocument;
   readonly touchChannel: TouchChannelResult;
 };
-type MutationAddChildrenArgs = {
+type MutationAddRelationshipArgs = {
   branch?: InputMaybe<Scalars["String"]["input"]>;
-  documentIdentifiers: ReadonlyArray<Scalars["String"]["input"]>;
-  parentIdentifier: Scalars["String"]["input"];
+  relationshipType: Scalars["String"]["input"];
+  sourceIdentifier: Scalars["String"]["input"];
+  targetIdentifier: Scalars["String"]["input"];
 };
 type MutationCreateDocumentArgs = {
   document: Scalars["JSONObject"]["input"];
@@ -1400,10 +1416,11 @@ type MutationDeleteDocumentsArgs = {
   identifiers: ReadonlyArray<Scalars["String"]["input"]>;
   propagate?: InputMaybe<PropagationMode>;
 };
-type MutationMoveChildrenArgs = {
+type MutationMoveRelationshipArgs = {
   branch?: InputMaybe<Scalars["String"]["input"]>;
-  documentIdentifiers: ReadonlyArray<Scalars["String"]["input"]>;
+  relationshipType: Scalars["String"]["input"];
   sourceParentIdentifier: Scalars["String"]["input"];
+  targetIdentifier: Scalars["String"]["input"];
   targetParentIdentifier: Scalars["String"]["input"];
 };
 type MutationMutateDocumentArgs = {
@@ -1419,10 +1436,11 @@ type MutationMutateDocumentAsyncArgs = {
 type MutationPushSyncEnvelopesArgs = {
   envelopes: ReadonlyArray<SyncEnvelopeInput>;
 };
-type MutationRemoveChildrenArgs = {
+type MutationRemoveRelationshipArgs = {
   branch?: InputMaybe<Scalars["String"]["input"]>;
-  documentIdentifiers: ReadonlyArray<Scalars["String"]["input"]>;
-  parentIdentifier: Scalars["String"]["input"];
+  relationshipType: Scalars["String"]["input"];
+  sourceIdentifier: Scalars["String"]["input"];
+  targetIdentifier: Scalars["String"]["input"];
 };
 type MutationRenameDocumentArgs = {
   branch?: InputMaybe<Scalars["String"]["input"]>;
@@ -1512,10 +1530,10 @@ declare enum PropagationMode {
 }
 type Query = {
   readonly document?: Maybe<DocumentWithChildren>;
-  readonly documentChildren: PhDocumentResultPage;
+  readonly documentIncomingRelationships: PhDocumentResultPage;
   readonly documentModels: DocumentModelResultPage;
   readonly documentOperations: ReactorOperationResultPage;
-  readonly documentParents: PhDocumentResultPage;
+  readonly documentOutgoingRelationships: PhDocumentResultPage;
   readonly findDocuments: PhDocumentResultPage;
   readonly jobStatus?: Maybe<JobInfo>;
   readonly pollSyncEnvelopes: PollSyncEnvelopesResult;
@@ -1524,9 +1542,10 @@ type QueryDocumentArgs = {
   identifier: Scalars["String"]["input"];
   view?: InputMaybe<ViewFilterInput>;
 };
-type QueryDocumentChildrenArgs = {
+type QueryDocumentIncomingRelationshipsArgs = {
   paging?: InputMaybe<PagingInput>;
-  parentIdentifier: Scalars["String"]["input"];
+  relationshipType: Scalars["String"]["input"];
+  targetIdentifier: Scalars["String"]["input"];
   view?: InputMaybe<ViewFilterInput>;
 };
 type QueryDocumentModelsArgs = {
@@ -1537,9 +1556,10 @@ type QueryDocumentOperationsArgs = {
   filter: OperationsFilterInput;
   paging?: InputMaybe<PagingInput>;
 };
-type QueryDocumentParentsArgs = {
-  childIdentifier: Scalars["String"]["input"];
+type QueryDocumentOutgoingRelationshipsArgs = {
   paging?: InputMaybe<PagingInput>;
+  relationshipType: Scalars["String"]["input"];
+  sourceIdentifier: Scalars["String"]["input"];
   view?: InputMaybe<ViewFilterInput>;
 };
 type QueryFindDocumentsArgs = {
@@ -1789,13 +1809,14 @@ type GetDocumentWithOperationsQuery = {
     };
   } | null | undefined;
 };
-type GetDocumentChildrenQueryVariables = Exact<{
-  parentIdentifier: Scalars["String"]["input"];
+type GetDocumentOutgoingRelationshipsQueryVariables = Exact<{
+  sourceIdentifier: Scalars["String"]["input"];
+  relationshipType: Scalars["String"]["input"];
   view?: InputMaybe<ViewFilterInput>;
   paging?: InputMaybe<PagingInput>;
 }>;
-type GetDocumentChildrenQuery = {
-  readonly documentChildren: {
+type GetDocumentOutgoingRelationshipsQuery = {
+  readonly documentOutgoingRelationships: {
     readonly totalCount: number;
     readonly hasNextPage: boolean;
     readonly hasPreviousPage: boolean;
@@ -1815,13 +1836,14 @@ type GetDocumentChildrenQuery = {
     }>;
   };
 };
-type GetDocumentParentsQueryVariables = Exact<{
-  childIdentifier: Scalars["String"]["input"];
+type GetDocumentIncomingRelationshipsQueryVariables = Exact<{
+  targetIdentifier: Scalars["String"]["input"];
+  relationshipType: Scalars["String"]["input"];
   view?: InputMaybe<ViewFilterInput>;
   paging?: InputMaybe<PagingInput>;
 }>;
-type GetDocumentParentsQuery = {
-  readonly documentParents: {
+type GetDocumentIncomingRelationshipsQuery = {
+  readonly documentIncomingRelationships: {
     readonly totalCount: number;
     readonly hasNextPage: boolean;
     readonly hasPreviousPage: boolean;
@@ -2014,13 +2036,14 @@ type RenameDocumentMutation = {
     }>;
   };
 };
-type AddChildrenMutationVariables = Exact<{
-  parentIdentifier: Scalars["String"]["input"];
-  documentIdentifiers: ReadonlyArray<Scalars["String"]["input"]>;
+type AddRelationshipMutationVariables = Exact<{
+  sourceIdentifier: Scalars["String"]["input"];
+  targetIdentifier: Scalars["String"]["input"];
+  relationshipType: Scalars["String"]["input"];
   branch?: InputMaybe<Scalars["String"]["input"]>;
 }>;
-type AddChildrenMutation = {
-  readonly addChildren: {
+type AddRelationshipMutation = {
+  readonly addRelationship: {
     readonly id: string;
     readonly slug?: string | null | undefined;
     readonly name: string;
@@ -2034,13 +2057,14 @@ type AddChildrenMutation = {
     }>;
   };
 };
-type RemoveChildrenMutationVariables = Exact<{
-  parentIdentifier: Scalars["String"]["input"];
-  documentIdentifiers: ReadonlyArray<Scalars["String"]["input"]>;
+type RemoveRelationshipMutationVariables = Exact<{
+  sourceIdentifier: Scalars["String"]["input"];
+  targetIdentifier: Scalars["String"]["input"];
+  relationshipType: Scalars["String"]["input"];
   branch?: InputMaybe<Scalars["String"]["input"]>;
 }>;
-type RemoveChildrenMutation = {
-  readonly removeChildren: {
+type RemoveRelationshipMutation = {
+  readonly removeRelationship: {
     readonly id: string;
     readonly slug?: string | null | undefined;
     readonly name: string;
@@ -2054,14 +2078,15 @@ type RemoveChildrenMutation = {
     }>;
   };
 };
-type MoveChildrenMutationVariables = Exact<{
+type MoveRelationshipMutationVariables = Exact<{
   sourceParentIdentifier: Scalars["String"]["input"];
   targetParentIdentifier: Scalars["String"]["input"];
-  documentIdentifiers: ReadonlyArray<Scalars["String"]["input"]>;
+  targetIdentifier: Scalars["String"]["input"];
+  relationshipType: Scalars["String"]["input"];
   branch?: InputMaybe<Scalars["String"]["input"]>;
 }>;
-type MoveChildrenMutation = {
-  readonly moveChildren: {
+type MoveRelationshipMutation = {
+  readonly moveRelationship: {
     readonly source: {
       readonly id: string;
       readonly slug?: string | null | undefined;
@@ -2276,7 +2301,7 @@ type ResolversTypes = ResolversObject<{
   JSONObject: ResolverTypeWrapper<Scalars["JSONObject"]["output"]>;
   JobChangeEvent: ResolverTypeWrapper<JobChangeEvent>;
   JobInfo: ResolverTypeWrapper<JobInfo>;
-  MoveChildrenResult: ResolverTypeWrapper<MoveChildrenResult>;
+  MoveRelationshipResult: ResolverTypeWrapper<MoveRelationshipResult>;
   Mutation: ResolverTypeWrapper<Record<PropertyKey, never>>;
   OperationContext: ResolverTypeWrapper<OperationContext>;
   OperationContextInput: OperationContextInput;
@@ -2335,7 +2360,7 @@ type ResolversParentTypes = ResolversObject<{
   JSONObject: Scalars["JSONObject"]["output"];
   JobChangeEvent: JobChangeEvent;
   JobInfo: JobInfo;
-  MoveChildrenResult: MoveChildrenResult;
+  MoveRelationshipResult: MoveRelationshipResult;
   Mutation: Record<PropertyKey, never>;
   OperationContext: OperationContext;
   OperationContextInput: OperationContextInput;
@@ -2446,21 +2471,21 @@ type JobInfoResolvers<ContextType = Context, ParentType extends ResolversParentT
   result?: Resolver<ResolversTypes["JSONObject"], ParentType, ContextType>;
   status?: Resolver<ResolversTypes["String"], ParentType, ContextType>;
 }>;
-type MoveChildrenResultResolvers<ContextType = Context, ParentType extends ResolversParentTypes["MoveChildrenResult"] = ResolversParentTypes["MoveChildrenResult"]> = ResolversObject<{
+type MoveRelationshipResultResolvers<ContextType = Context, ParentType extends ResolversParentTypes["MoveRelationshipResult"] = ResolversParentTypes["MoveRelationshipResult"]> = ResolversObject<{
   source?: Resolver<ResolversTypes["PHDocument"], ParentType, ContextType>;
   target?: Resolver<ResolversTypes["PHDocument"], ParentType, ContextType>;
 }>;
 type MutationResolvers<ContextType = Context, ParentType extends ResolversParentTypes["Mutation"] = ResolversParentTypes["Mutation"]> = ResolversObject<{
-  addChildren?: Resolver<ResolversTypes["PHDocument"], ParentType, ContextType, RequireFields<MutationAddChildrenArgs, "documentIdentifiers" | "parentIdentifier">>;
+  addRelationship?: Resolver<ResolversTypes["PHDocument"], ParentType, ContextType, RequireFields<MutationAddRelationshipArgs, "relationshipType" | "sourceIdentifier" | "targetIdentifier">>;
   createDocument?: Resolver<ResolversTypes["PHDocument"], ParentType, ContextType, RequireFields<MutationCreateDocumentArgs, "document">>;
   createEmptyDocument?: Resolver<ResolversTypes["PHDocument"], ParentType, ContextType, RequireFields<MutationCreateEmptyDocumentArgs, "documentType">>;
   deleteDocument?: Resolver<ResolversTypes["Boolean"], ParentType, ContextType, RequireFields<MutationDeleteDocumentArgs, "identifier">>;
   deleteDocuments?: Resolver<ResolversTypes["Boolean"], ParentType, ContextType, RequireFields<MutationDeleteDocumentsArgs, "identifiers">>;
-  moveChildren?: Resolver<ResolversTypes["MoveChildrenResult"], ParentType, ContextType, RequireFields<MutationMoveChildrenArgs, "documentIdentifiers" | "sourceParentIdentifier" | "targetParentIdentifier">>;
+  moveRelationship?: Resolver<ResolversTypes["MoveRelationshipResult"], ParentType, ContextType, RequireFields<MutationMoveRelationshipArgs, "relationshipType" | "sourceParentIdentifier" | "targetIdentifier" | "targetParentIdentifier">>;
   mutateDocument?: Resolver<ResolversTypes["PHDocument"], ParentType, ContextType, RequireFields<MutationMutateDocumentArgs, "actions" | "documentIdentifier">>;
   mutateDocumentAsync?: Resolver<ResolversTypes["String"], ParentType, ContextType, RequireFields<MutationMutateDocumentAsyncArgs, "actions" | "documentIdentifier">>;
   pushSyncEnvelopes?: Resolver<ResolversTypes["Boolean"], ParentType, ContextType, RequireFields<MutationPushSyncEnvelopesArgs, "envelopes">>;
-  removeChildren?: Resolver<ResolversTypes["PHDocument"], ParentType, ContextType, RequireFields<MutationRemoveChildrenArgs, "documentIdentifiers" | "parentIdentifier">>;
+  removeRelationship?: Resolver<ResolversTypes["PHDocument"], ParentType, ContextType, RequireFields<MutationRemoveRelationshipArgs, "relationshipType" | "sourceIdentifier" | "targetIdentifier">>;
   renameDocument?: Resolver<ResolversTypes["PHDocument"], ParentType, ContextType, RequireFields<MutationRenameDocumentArgs, "documentIdentifier" | "name">>;
   touchChannel?: Resolver<ResolversTypes["TouchChannelResult"], ParentType, ContextType, RequireFields<MutationTouchChannelArgs, "input">>;
 }>;
@@ -2502,10 +2527,10 @@ type PollSyncEnvelopesResultResolvers<ContextType = Context, ParentType extends
 }>;
 type QueryResolvers<ContextType = Context, ParentType extends ResolversParentTypes["Query"] = ResolversParentTypes["Query"]> = ResolversObject<{
   document?: Resolver<Maybe<ResolversTypes["DocumentWithChildren"]>, ParentType, ContextType, RequireFields<QueryDocumentArgs, "identifier">>;
-  documentChildren?: Resolver<ResolversTypes["PHDocumentResultPage"], ParentType, ContextType, RequireFields<QueryDocumentChildrenArgs, "parentIdentifier">>;
+  documentIncomingRelationships?: Resolver<ResolversTypes["PHDocumentResultPage"], ParentType, ContextType, RequireFields<QueryDocumentIncomingRelationshipsArgs, "relationshipType" | "targetIdentifier">>;
   documentModels?: Resolver<ResolversTypes["DocumentModelResultPage"], ParentType, ContextType, Partial<QueryDocumentModelsArgs>>;
   documentOperations?: Resolver<ResolversTypes["ReactorOperationResultPage"], ParentType, ContextType, RequireFields<QueryDocumentOperationsArgs, "filter">>;
-  documentParents?: Resolver<ResolversTypes["PHDocumentResultPage"], ParentType, ContextType, RequireFields<QueryDocumentParentsArgs, "childIdentifier">>;
+  documentOutgoingRelationships?: Resolver<ResolversTypes["PHDocumentResultPage"], ParentType, ContextType, RequireFields<QueryDocumentOutgoingRelationshipsArgs, "relationshipType" | "sourceIdentifier">>;
   findDocuments?: Resolver<ResolversTypes["PHDocumentResultPage"], ParentType, ContextType, Partial<QueryFindDocumentsArgs>>;
   jobStatus?: Resolver<Maybe<ResolversTypes["JobInfo"]>, ParentType, ContextType, RequireFields<QueryJobStatusArgs, "jobId">>;
   pollSyncEnvelopes?: Resolver<ResolversTypes["PollSyncEnvelopesResult"], ParentType, ContextType, RequireFields<QueryPollSyncEnvelopesArgs, "channelId" | "outboxAck" | "outboxLatest">>;
@@ -2580,7 +2605,7 @@ type Resolvers<ContextType = Context> = ResolversObject<{
   JSONObject?: GraphQLScalarType;
   JobChangeEvent?: JobChangeEventResolvers<ContextType>;
   JobInfo?: JobInfoResolvers<ContextType>;
-  MoveChildrenResult?: MoveChildrenResultResolvers<ContextType>;
+  MoveRelationshipResult?: MoveRelationshipResultResolvers<ContextType>;
   Mutation?: MutationResolvers<ContextType>;
   OperationContext?: OperationContextResolvers<ContextType>;
   OperationWithContext?: OperationWithContextResolvers<ContextType>;
@@ -2629,8 +2654,8 @@ declare const PhDocumentFieldsFragmentDoc: DocumentNode;
 declare const GetDocumentModelsDocument: DocumentNode;
 declare const GetDocumentDocument: DocumentNode;
 declare const GetDocumentWithOperationsDocument: DocumentNode;
-declare const GetDocumentChildrenDocument: DocumentNode;
-declare const GetDocumentParentsDocument: DocumentNode;
+declare const GetDocumentOutgoingRelationshipsDocument: DocumentNode;
+declare const GetDocumentIncomingRelationshipsDocument: DocumentNode;
 declare const FindDocumentsDocument: DocumentNode;
 declare const GetDocumentOperationsDocument: DocumentNode;
 declare const GetJobStatusDocument: DocumentNode;
@@ -2639,9 +2664,9 @@ declare const CreateEmptyDocumentDocument: DocumentNode;
 declare const MutateDocumentDocument: DocumentNode;
 declare const MutateDocumentAsyncDocument: DocumentNode;
 declare const RenameDocumentDocument: DocumentNode;
-declare const AddChildrenDocument: DocumentNode;
-declare const RemoveChildrenDocument: DocumentNode;
-declare const MoveChildrenDocument: DocumentNode;
+declare const AddRelationshipDocument: DocumentNode;
+declare const RemoveRelationshipDocument: DocumentNode;
+declare const MoveRelationshipDocument: DocumentNode;
 declare const DeleteDocumentDocument: DocumentNode;
 declare const DeleteDocumentsDocument: DocumentNode;
 declare const DocumentChangesDocument: DocumentNode;
@@ -2654,8 +2679,8 @@ declare function getSdk<C>(requester: Requester<C>): {
   GetDocumentModels(variables?: GetDocumentModelsQueryVariables, options?: C): Promise<GetDocumentModelsQuery>;
   GetDocument(variables: GetDocumentQueryVariables, options?: C): Promise<GetDocumentQuery>;
   GetDocumentWithOperations(variables: GetDocumentWithOperationsQueryVariables, options?: C): Promise<GetDocumentWithOperationsQuery>;
-  GetDocumentChildren(variables: GetDocumentChildrenQueryVariables, options?: C): Promise<GetDocumentChildrenQuery>;
-  GetDocumentParents(variables: GetDocumentParentsQueryVariables, options?: C): Promise<GetDocumentParentsQuery>;
+  GetDocumentOutgoingRelationships(variables: GetDocumentOutgoingRelationshipsQueryVariables, options?: C): Promise<GetDocumentOutgoingRelationshipsQuery>;
+  GetDocumentIncomingRelationships(variables: GetDocumentIncomingRelationshipsQueryVariables, options?: C): Promise<GetDocumentIncomingRelationshipsQuery>;
   FindDocuments(variables?: FindDocumentsQueryVariables, options?: C): Promise<FindDocumentsQuery>;
   GetDocumentOperations(variables: GetDocumentOperationsQueryVariables, options?: C): Promise<GetDocumentOperationsQuery>;
   GetJobStatus(variables: GetJobStatusQueryVariables, options?: C): Promise<GetJobStatusQuery>;
@@ -2664,9 +2689,9 @@ declare function getSdk<C>(requester: Requester<C>): {
   MutateDocument(variables: MutateDocumentMutationVariables, options?: C): Promise<MutateDocumentMutation>;
   MutateDocumentAsync(variables: MutateDocumentAsyncMutationVariables, options?: C): Promise<MutateDocumentAsyncMutation>;
   RenameDocument(variables: RenameDocumentMutationVariables, options?: C): Promise<RenameDocumentMutation>;
-  AddChildren(variables: AddChildrenMutationVariables, options?: C): Promise<AddChildrenMutation>;
-  RemoveChildren(variables: RemoveChildrenMutationVariables, options?: C): Promise<RemoveChildrenMutation>;
-  MoveChildren(variables: MoveChildrenMutationVariables, options?: C): Promise<MoveChildrenMutation>;
+  AddRelationship(variables: AddRelationshipMutationVariables, options?: C): Promise<AddRelationshipMutation>;
+  RemoveRelationship(variables: RemoveRelationshipMutationVariables, options?: C): Promise<RemoveRelationshipMutation>;
+  MoveRelationship(variables: MoveRelationshipMutationVariables, options?: C): Promise<MoveRelationshipMutation>;
   DeleteDocument(variables: DeleteDocumentMutationVariables, options?: C): Promise<DeleteDocumentMutation>;
   DeleteDocuments(variables: DeleteDocumentsMutationVariables, options?: C): Promise<DeleteDocumentsMutation>;
   DocumentChanges(variables?: DocumentChangesSubscriptionVariables, options?: C): AsyncIterable<DocumentChangesSubscription>;
@@ -2696,16 +2721,18 @@ declare function createReactorGraphQLClient(url: string, fetchImpl?: FetchLike,
     operationsFilter?: InputMaybe<DocumentOperationsFilterInput>;
     operationsPaging?: InputMaybe<PagingInput>;
   }>, options?: {} | undefined): Promise<GetDocumentWithOperationsQuery>;
-  GetDocumentChildren(variables: Exact<{
-    parentIdentifier: Scalars["String"]["input"];
+  GetDocumentOutgoingRelationships(variables: Exact<{
+    sourceIdentifier: Scalars["String"]["input"];
+    relationshipType: Scalars["String"]["input"];
     view?: InputMaybe<ViewFilterInput>;
     paging?: InputMaybe<PagingInput>;
-  }>, options?: {} | undefined): Promise<GetDocumentChildrenQuery>;
-  GetDocumentParents(variables: Exact<{
-    childIdentifier: Scalars["String"]["input"];
+  }>, options?: {} | undefined): Promise<GetDocumentOutgoingRelationshipsQuery>;
+  GetDocumentIncomingRelationships(variables: Exact<{
+    targetIdentifier: Scalars["String"]["input"];
+    relationshipType: Scalars["String"]["input"];
     view?: InputMaybe<ViewFilterInput>;
     paging?: InputMaybe<PagingInput>;
-  }>, options?: {} | undefined): Promise<GetDocumentParentsQuery>;
+  }>, options?: {} | undefined): Promise<GetDocumentIncomingRelationshipsQuery>;
   FindDocuments(variables?: Exact<{
     search?: InputMaybe<SearchFilterInput>;
     view?: InputMaybe<ViewFilterInput>;
@@ -2741,22 +2768,25 @@ declare function createReactorGraphQLClient(url: string, fetchImpl?: FetchLike,
     name: Scalars["String"]["input"];
     branch?: InputMaybe<Scalars["String"]["input"]>;
   }>, options?: {} | undefined): Promise<RenameDocumentMutation>;
-  AddChildren(variables: Exact<{
-    parentIdentifier: Scalars["String"]["input"];
-    documentIdentifiers: ReadonlyArray<Scalars["String"]["input"]>;
+  AddRelationship(variables: Exact<{
+    sourceIdentifier: Scalars["String"]["input"];
+    targetIdentifier: Scalars["String"]["input"];
+    relationshipType: Scalars["String"]["input"];
     branch?: InputMaybe<Scalars["String"]["input"]>;
-  }>, options?: {} | undefined): Promise<AddChildrenMutation>;
-  RemoveChildren(variables: Exact<{
-    parentIdentifier: Scalars["String"]["input"];
-    documentIdentifiers: ReadonlyArray<Scalars["String"]["input"]>;
+  }>, options?: {} | undefined): Promise<AddRelationshipMutation>;
+  RemoveRelationship(variables: Exact<{
+    sourceIdentifier: Scalars["String"]["input"];
+    targetIdentifier: Scalars["String"]["input"];
+    relationshipType: Scalars["String"]["input"];
     branch?: InputMaybe<Scalars["String"]["input"]>;
-  }>, options?: {} | undefined): Promise<RemoveChildrenMutation>;
-  MoveChildren(variables: Exact<{
+  }>, options?: {} | undefined): Promise<RemoveRelationshipMutation>;
+  MoveRelationship(variables: Exact<{
     sourceParentIdentifier: Scalars["String"]["input"];
     targetParentIdentifier: Scalars["String"]["input"];
-    documentIdentifiers: ReadonlyArray<Scalars["String"]["input"]>;
+    targetIdentifier: Scalars["String"]["input"];
+    relationshipType: Scalars["String"]["input"];
     branch?: InputMaybe<Scalars["String"]["input"]>;
-  }>, options?: {} | undefined): Promise<MoveChildrenMutation>;
+  }>, options?: {} | undefined): Promise<MoveRelationshipMutation>;
   DeleteDocument(variables: Exact<{
     identifier: Scalars["String"]["input"];
     propagate?: InputMaybe<PropagationMode>;
@@ -2804,6 +2834,25 @@ declare class ReactorSubgraph extends BaseSubgraph {
 //#region src/graphql/system/env/index.d.ts
 declare const ADMIN_USERS: string[];
 //#endregion
+//#region src/graphql/system/subgraph.d.ts
+declare class SystemSubgraph extends BaseSubgraph {
+  name: string;
+  hasSubscriptions: boolean;
+  typeDefs: graphql.DocumentNode;
+  resolvers: {
+    Query: {
+      system: () => {
+        version: string;
+        gitHash: string;
+      };
+    };
+  };
+}
+//#endregion
+//#region src/graphql/system/version.d.ts
+declare function getVersion(): string;
+declare function getGitHash(): string;
+//#endregion
 //#region src/graphql/utils.d.ts
 declare function isSubgraphClass(candidate: unknown): candidate is SubgraphClass$1;
 declare function buildGraphqlOperations(operations: Operation[], skip: number, first: number): GqlOperation$1[];
@@ -2859,6 +2908,13 @@ type Options = {
   port?: number;
   dbPath: string | undefined;
   client?: PGlite | typeof Pool | undefined;
+  /**
+   * Factory for the PGLite instance backing the read-model store. When set,
+   * `getDbClient` uses it instead of constructing `new PGlite(dbPath)`. Used
+   * by Switchboard to keep a legacy-version data dir readable while running
+   * the newer Switchboard binary.
+   */
+  pgliteFactory?: PgliteFactory;
   configFile?: string;
   packages?: string[];
   auth?: {
@@ -2883,6 +2939,12 @@ type Options = {
   documentPermissionService?: DocumentPermissionService;
   enableDocumentModelSubgraphs?: boolean;
   logger?: ILogger;
+  /**
+   * Filesystem path for attachment binary storage.
+   * Defaults to a sibling "attachments" directory next to dbPath,
+   * or os.tmpdir() for in-memory DB deployments.
+   */
+  attachmentStoragePath?: string;
 };
 type ProcessorInitializer = ProcessorFactoryBuilder;
 /**
@@ -2939,5 +3001,5 @@ interface DocumentModelSchemaOptions {
  */
 declare function generateDocumentModelSchema(documentModel: DocumentModelGlobalState$1, options?: DocumentModelSchemaOptions): DocumentNode;
 //#endregion
-export { ADMIN_USERS, API, Action, ActionContext, ActionContextInput, ActionContextInputSchema, ActionContextResolvers, ActionInput, ActionInputSchema, ActionResolvers, AddChildrenDocument, AddChildrenMutation, AddChildrenMutationVariables, AnalyticsSubgraph, Attachment, AttachmentInput, AttachmentInputSchema, AttachmentResolvers, AuthConfig, AuthContext, AuthFetchMiddleware, AuthService, AuthSubgraph, BaseSubgraph, ChannelMeta, ChannelMetaInput, ChannelMetaInputSchema, ChannelMetaResolvers, Context, CreateDocumentDocument, CreateDocumentMutation, CreateDocumentMutationVariables, CreateEmptyDocumentDocument, CreateEmptyDocumentMutation, CreateEmptyDocumentMutationVariables, DateTimeScalarConfig, DeadLetterInfo, DeadLetterInfoResolvers, DeleteDocumentDocument, DeleteDocumentMutation, DeleteDocumentMutationVariables, DeleteDocumentsDocument, DeleteDocumentsMutation, DeleteDocumentsMutationVariables, DirectiveResolverFn, DocumentChangeContext, DocumentChangeContextResolvers, DocumentChangeEvent, DocumentChangeEventResolvers, DocumentChangeType, DocumentChangeTypeSchema, DocumentChangesDocument, DocumentChangesSubscription, DocumentChangesSubscriptionVariables, DocumentGroupPermissionEntry, DocumentGroupPermissionTable, DocumentModelGlobalState, DocumentModelGlobalStateResolvers, DocumentModelResultPage, DocumentModelResultPageResolvers, DocumentModelSchemaOptions, DocumentOperationsFilterInput, DocumentOperationsFilterInputSchema, DocumentPermissionConfig, DocumentPermissionDatabase, DocumentPermissionEntry, DocumentPermissionLevel, DocumentPermissionService, DocumentPermissionTable, DocumentProtectionTable, DocumentWithChildren, DocumentWithChildrenResolvers, Exact, FetchHandler, FindDocumentsDocument, FindDocumentsQuery, FindDocumentsQueryVariables, GatewayAdapterType, GatewayContextFactory, GetDocumentChildrenDocument, GetDocumentChildrenQuery, GetDocumentChildrenQueryVariables, GetDocumentDocument, GetDocumentModelsDocument, GetDocumentModelsQuery, GetDocumentModelsQueryVariables, GetDocumentOperationsDocument, GetDocumentOperationsQuery, GetDocumentOperationsQueryVariables, GetDocumentParentsDocument, GetDocumentParentsQuery, GetDocumentParentsQueryVariables, GetDocumentQuery, GetDocumentQueryVariables, GetDocumentWithOperationsDocument, GetDocumentWithOperationsQuery, GetDocumentWithOperationsQueryVariables, GetJobStatusDocument, GetJobStatusQuery, GetJobStatusQueryVariables, GetParentIdsFn, GqlDocument, GqlDriveDocument, GqlOperation, GqlOperationContext, GqlSigner, GqlSignerApp, GqlSignerUser, GraphQLManager, GraphqlManagerFeatureFlags, Group, GroupTable, HttpAdapterSetup, HttpAdapterType, HttpDocumentModelLoader, HttpPackageLoader, HttpPackageLoaderLogger, HttpPackageLoaderOptions, IGatewayAdapter, IHttpAdapter, type IPackageLoader, type IPackageLoaderOptions, IPackageStorage, ISubgraph, ImportPackageLoader, InMemoryPackageStorage, Incremental, InputMaybe, InstallPackageResult, InstalledPackageInfo, IsTypeOfResolverFn, JobChangeEvent, JobChangeEventResolvers, JobChangesDocument, JobChangesSubscription, JobChangesSubscriptionVariables, JobInfo, JobInfoResolvers, JsonObjectScalarConfig, MakeEmpty, MakeMaybe, MakeOptional, Maybe, MoveChildrenDocument, MoveChildrenMutation, MoveChildrenMutationVariables, MoveChildrenResult, MoveChildrenResultResolvers, MutateDocumentAsyncDocument, MutateDocumentAsyncMutation, MutateDocumentAsyncMutationVariables, MutateDocumentDocument, MutateDocumentMutation, MutateDocumentMutationVariables, Mutation, MutationAddChildrenArgs, MutationCreateDocumentArgs, MutationCreateEmptyDocumentArgs, MutationDeleteDocumentArgs, MutationDeleteDocumentsArgs, MutationMoveChildrenArgs, MutationMutateDocumentArgs, MutationMutateDocumentAsyncArgs, MutationPushSyncEnvelopesArgs, MutationRemoveChildrenArgs, MutationRenameDocumentArgs, MutationResolvers, MutationTouchChannelArgs, NextResolverFn, OperationContext, OperationContextInput, OperationContextInputSchema, OperationContextResolvers, OperationGroupPermissionEntry, OperationGroupPermissionTable, OperationInput, OperationInputSchema, OperationUserPermissionEntry, OperationUserPermissionTable, OperationWithContext, OperationWithContextInput, OperationWithContextInputSchema, OperationWithContextResolvers, OperationsFilterInput, OperationsFilterInputSchema, PackageManagementService, PackageManagementServiceOptions, PackageManager, PackagesSubgraph, type PackagesSubgraphArgs, PagingInput, PagingInputSchema, type ParsedDriveUrl, PhDocument, PhDocumentFieldsFragment, PhDocumentFieldsFragmentDoc, PhDocumentOperationsArgs, PhDocumentResolvers, PhDocumentResultPage, PhDocumentResultPageResolvers, PollSyncEnvelopesDocument, PollSyncEnvelopesQuery, PollSyncEnvelopesQueryVariables, PollSyncEnvelopesResult, PollSyncEnvelopesResultResolvers, Processor, ProcessorDriveFactory, ProcessorFactoryBuilder, PropagationMode, PropagationModeSchema, PushSyncEnvelopesDocument, PushSyncEnvelopesMutation, PushSyncEnvelopesMutationVariables, Query, QueryDocumentArgs, QueryDocumentChildrenArgs, QueryDocumentModelsArgs, QueryDocumentOperationsArgs, QueryDocumentParentsArgs, QueryFindDocumentsArgs, QueryJobStatusArgs, QueryPollSyncEnvelopesArgs, QueryResolvers, ReactorModule, ReactorOperation, ReactorOperationResolvers, ReactorOperationResultPage, ReactorOperationResultPageResolvers, ReactorSigner, ReactorSignerApp, ReactorSignerAppInput, ReactorSignerAppInputSchema, ReactorSignerAppResolvers, ReactorSignerInput, ReactorSignerInputSchema, ReactorSignerResolvers, ReactorSignerUser, ReactorSignerUserInput, ReactorSignerUserInputSchema, ReactorSignerUserResolvers, ReactorSubgraph, RemoteCursor, RemoteCursorInput, RemoteCursorInputSchema, RemoteCursorResolvers, RemoteFilterInput, RemoteFilterInputSchema, RemoveChildrenDocument, RemoveChildrenMutation, RemoveChildrenMutationVariables, RenameDocumentDocument, RenameDocumentMutation, RenameDocumentMutationVariables, Requester, RequireFields, Resolver, ResolverFn, ResolverTypeWrapper, ResolverWithResolve, Resolvers, ResolversObject, ResolversParentTypes, ResolversTypes, Revision, RevisionResolvers, Scalars, Sdk, SearchFilterInput, SearchFilterInputSchema, SubgraphArgs, SubgraphClass, SubgraphDefinition, Subscription, SubscriptionDocumentChangesArgs, SubscriptionJobChangesArgs, SubscriptionObject, SubscriptionResolveFn, SubscriptionResolver, SubscriptionResolverObject, SubscriptionResolvers, SubscriptionSubscribeFn, SubscriptionSubscriberObject, SyncEnvelope, SyncEnvelopeInput, SyncEnvelopeInputSchema, SyncEnvelopeResolvers, SyncEnvelopeType, SyncEnvelopeTypeSchema, TlsOptions, TouchChannelDocument, TouchChannelInput, TouchChannelInputSchema, TouchChannelMutation, TouchChannelMutationVariables, TouchChannelResult, TouchChannelResultResolvers, TypeResolveFn, User, UserGroupTable, ViewFilterInput, ViewFilterInputSchema, WithIndex, WsContextFactory, WsDisposer, buildGraphQlDocument, buildGraphQlDriveDocument, buildGraphqlOperation, buildGraphqlOperations, buildSubgraphSchemaModule, createAuthFetchMiddleware, createGatewayAdapter, createHttpAdapter, createMergedSchema, createReactorGraphQLClient, createSchema, definedNonNullAnySchema, driveIdFromUrl, generateDocumentModelSchema, getAuthContext, getDbClient, getDocumentModelSchemaName, getDocumentModelTypeDefs, getSdk, getUniqueDocumentModels, initAnalyticsStoreSql, initTracing, initializeAndStartAPI, isDefinedNonNullAny, isSubgraphClass, isTracingEnabled, parseDriveUrl, renderGraphqlPlayground, trace };
+export { ADMIN_USERS, API, Action, ActionContext, ActionContextInput, ActionContextInputSchema, ActionContextResolvers, ActionInput, ActionInputSchema, ActionResolvers, AddRelationshipDocument, AddRelationshipMutation, AddRelationshipMutationVariables, AnalyticsSubgraph, Attachment, AttachmentInput, AttachmentInputSchema, AttachmentResolvers, AuthConfig, AuthContext, AuthFetchMiddleware, AuthService, AuthSubgraph, BaseSubgraph, ChannelMeta, ChannelMetaInput, ChannelMetaInputSchema, ChannelMetaResolvers, Context, CreateDocumentDocument, CreateDocumentMutation, CreateDocumentMutationVariables, CreateEmptyDocumentDocument, CreateEmptyDocumentMutation, CreateEmptyDocumentMutationVariables, DateTimeScalarConfig, DeadLetterInfo, DeadLetterInfoResolvers, DeleteDocumentDocument, DeleteDocumentMutation, DeleteDocumentMutationVariables, DeleteDocumentsDocument, DeleteDocumentsMutation, DeleteDocumentsMutationVariables, DirectiveResolverFn, DocumentChangeContext, DocumentChangeContextResolvers, DocumentChangeEvent, DocumentChangeEventResolvers, DocumentChangeType, DocumentChangeTypeSchema, DocumentChangesDocument, DocumentChangesSubscription, DocumentChangesSubscriptionVariables, DocumentGroupPermissionEntry, DocumentGroupPermissionTable, DocumentModelGlobalState, DocumentModelGlobalStateResolvers, DocumentModelResultPage, DocumentModelResultPageResolvers, DocumentModelSchemaOptions, DocumentOperationsFilterInput, DocumentOperationsFilterInputSchema, DocumentPermissionConfig, DocumentPermissionDatabase, DocumentPermissionEntry, DocumentPermissionLevel, DocumentPermissionService, DocumentPermissionTable, DocumentProtectionTable, DocumentWithChildren, DocumentWithChildrenResolvers, Exact, FetchHandler, FindDocumentsDocument, FindDocumentsQuery, FindDocumentsQueryVariables, GatewayAdapterType, GatewayContextFactory, GetDocumentDocument, GetDocumentIncomingRelationshipsDocument, GetDocumentIncomingRelationshipsQuery, GetDocumentIncomingRelationshipsQueryVariables, GetDocumentModelsDocument, GetDocumentModelsQuery, GetDocumentModelsQueryVariables, GetDocumentOperationsDocument, GetDocumentOperationsQuery, GetDocumentOperationsQueryVariables, GetDocumentOutgoingRelationshipsDocument, GetDocumentOutgoingRelationshipsQuery, GetDocumentOutgoingRelationshipsQueryVariables, GetDocumentQuery, GetDocumentQueryVariables, GetDocumentWithOperationsDocument, GetDocumentWithOperationsQuery, GetDocumentWithOperationsQueryVariables, GetJobStatusDocument, GetJobStatusQuery, GetJobStatusQueryVariables, GetParentIdsFn, GqlDocument, GqlDriveDocument, GqlOperation, GqlOperationContext, GqlSigner, GqlSignerApp, GqlSignerUser, GraphQLManager, GraphqlManagerFeatureFlags, Group, GroupTable, HttpAdapterSetup, HttpAdapterType, HttpDocumentModelLoader, HttpPackageLoader, HttpPackageLoaderLogger, HttpPackageLoaderOptions, IGatewayAdapter, IHttpAdapter, type IPackageLoader, type IPackageLoaderOptions, IPackageStorage, ISubgraph, ImportPackageLoader, InMemoryPackageStorage, Incremental, InputMaybe, InstallPackageResult, InstalledPackageInfo, IsTypeOfResolverFn, JobChangeEvent, JobChangeEventResolvers, JobChangesDocument, JobChangesSubscription, JobChangesSubscriptionVariables, JobInfo, JobInfoResolvers, JsonObjectScalarConfig, MakeEmpty, MakeMaybe, MakeOptional, Maybe, MoveRelationshipDocument, MoveRelationshipMutation, MoveRelationshipMutationVariables, MoveRelationshipResult, MoveRelationshipResultResolvers, MutateDocumentAsyncDocument, MutateDocumentAsyncMutation, MutateDocumentAsyncMutationVariables, MutateDocumentDocument, MutateDocumentMutation, MutateDocumentMutationVariables, Mutation, MutationAddRelationshipArgs, MutationCreateDocumentArgs, MutationCreateEmptyDocumentArgs, MutationDeleteDocumentArgs, MutationDeleteDocumentsArgs, MutationMoveRelationshipArgs, MutationMutateDocumentArgs, MutationMutateDocumentAsyncArgs, MutationPushSyncEnvelopesArgs, MutationRemoveRelationshipArgs, MutationRenameDocumentArgs, MutationResolvers, MutationTouchChannelArgs, NextResolverFn, OperationContext, OperationContextInput, OperationContextInputSchema, OperationContextResolvers, OperationGroupPermissionEntry, OperationGroupPermissionTable, OperationInput, OperationInputSchema, OperationUserPermissionEntry, OperationUserPermissionTable, OperationWithContext, OperationWithContextInput, OperationWithContextInputSchema, OperationWithContextResolvers, OperationsFilterInput, OperationsFilterInputSchema, PackageManagementService, PackageManagementServiceOptions, PackageManager, PackagesSubgraph, type PackagesSubgraphArgs, PagingInput, PagingInputSchema, type ParsedDriveUrl, PgliteFactory, PhDocument, PhDocumentFieldsFragment, PhDocumentFieldsFragmentDoc, PhDocumentOperationsArgs, PhDocumentResolvers, PhDocumentResultPage, PhDocumentResultPageResolvers, PollSyncEnvelopesDocument, PollSyncEnvelopesQuery, PollSyncEnvelopesQueryVariables, PollSyncEnvelopesResult, PollSyncEnvelopesResultResolvers, Processor, ProcessorDriveFactory, ProcessorFactoryBuilder, PropagationMode, PropagationModeSchema, PushSyncEnvelopesDocument, PushSyncEnvelopesMutation, PushSyncEnvelopesMutationVariables, Query, QueryDocumentArgs, QueryDocumentIncomingRelationshipsArgs, QueryDocumentModelsArgs, QueryDocumentOperationsArgs, QueryDocumentOutgoingRelationshipsArgs, QueryFindDocumentsArgs, QueryJobStatusArgs, QueryPollSyncEnvelopesArgs, QueryResolvers, ReactorModule, ReactorOperation, ReactorOperationResolvers, ReactorOperationResultPage, ReactorOperationResultPageResolvers, ReactorSigner, ReactorSignerApp, ReactorSignerAppInput, ReactorSignerAppInputSchema, ReactorSignerAppResolvers, ReactorSignerInput, ReactorSignerInputSchema, ReactorSignerResolvers, ReactorSignerUser, ReactorSignerUserInput, ReactorSignerUserInputSchema, ReactorSignerUserResolvers, ReactorSubgraph, RemoteCursor, RemoteCursorInput, RemoteCursorInputSchema, RemoteCursorResolvers, RemoteFilterInput, RemoteFilterInputSchema, RemoveRelationshipDocument, RemoveRelationshipMutation, RemoveRelationshipMutationVariables, RenameDocumentDocument, RenameDocumentMutation, RenameDocumentMutationVariables, Requester, RequireFields, Resolver, ResolverFn, ResolverTypeWrapper, ResolverWithResolve, Resolvers, ResolversObject, ResolversParentTypes, ResolversTypes, Revision, RevisionResolvers, Scalars, Sdk, SearchFilterInput, SearchFilterInputSchema, SubgraphArgs, SubgraphClass, SubgraphDefinition, Subscription, SubscriptionDocumentChangesArgs, SubscriptionJobChangesArgs, SubscriptionObject, SubscriptionResolveFn, SubscriptionResolver, SubscriptionResolverObject, SubscriptionResolvers, SubscriptionSubscribeFn, SubscriptionSubscriberObject, SyncEnvelope, SyncEnvelopeInput, SyncEnvelopeInputSchema, SyncEnvelopeResolvers, SyncEnvelopeType, SyncEnvelopeTypeSchema, SystemSubgraph, TlsOptions, TouchChannelDocument, TouchChannelInput, TouchChannelInputSchema, TouchChannelMutation, TouchChannelMutationVariables, TouchChannelResult, TouchChannelResultResolvers, TypeResolveFn, User, UserGroupTable, ViewFilterInput, ViewFilterInputSchema, WithIndex, WsContextFactory, WsDisposer, buildGraphQlDocument, buildGraphQlDriveDocument, buildGraphqlOperation, buildGraphqlOperations, buildSubgraphSchemaModule, createAuthFetchMiddleware, createGatewayAdapter, createHttpAdapter, createMergedSchema, createReactorGraphQLClient, createSchema, definedNonNullAnySchema, driveIdFromUrl, generateDocumentModelSchema, getAuthContext, getDbClient, getDocumentModelSchemaName, getDocumentModelTypeDefs, getGitHash, getSdk, getUniqueDocumentModels, getVersion, initAnalyticsStoreSql, initTracing, initializeAndStartAPI, isDefinedNonNullAny, isSubgraphClass, isTracingEnabled, parseDriveUrl, renderGraphqlPlayground, trace };
 //# sourceMappingURL=index.d.mts.map