@powerhousedao/reactor-api 6.2.3-dev.77 → 6.2.3-dev.79
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{base-document-models-Dh70m9Bh.mjs → base-document-models-ux7TZ9X3.mjs} +5 -5
- package/dist/{base-document-models-Dh70m9Bh.mjs.map → base-document-models-ux7TZ9X3.mjs.map} +1 -1
- package/dist/{error-info-CCQcLAcW.mjs → error-info-BaEL50f5.mjs} +68 -6
- package/dist/error-info-BaEL50f5.mjs.map +1 -0
- package/dist/index.d.mts +1025 -763
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +1720 -1497
- package/dist/index.mjs.map +1 -1
- package/dist/{package-subgraph-check-DhCWO3YR.mjs → package-subgraph-check-BGfeyfnc.mjs} +4 -4
- package/dist/{package-subgraph-check-DhCWO3YR.mjs.map → package-subgraph-check-BGfeyfnc.mjs.map} +1 -1
- package/dist/{pglite-node-BMux5A2Y.mjs → pglite-node-DGms6Ssa.mjs} +19 -6
- package/dist/pglite-node-DGms6Ssa.mjs.map +1 -0
- package/dist/src/graphql/subgraph-types.mjs +1 -1
- package/dist/src/packages/vite-loader.d.mts +2 -2
- package/dist/src/packages/vite-loader.d.mts.map +1 -1
- package/dist/src/packages/vite-loader.mjs +29 -10
- package/dist/src/packages/vite-loader.mjs.map +1 -1
- package/dist/src/pglite/pglite-node.d.mts +43 -5
- package/dist/src/pglite/pglite-node.d.mts.map +1 -1
- package/dist/src/pglite/pglite-node.mjs +5 -5
- package/dist/src/pglite/worker/entry.mjs +1 -1
- package/dist/{subgraph-extraction-zUDn2zX_.mjs → subgraph-extraction-BYKOycxo.mjs} +18 -4
- package/dist/subgraph-extraction-BYKOycxo.mjs.map +1 -0
- package/dist/{types-CCI5IDgT.d.mts → types-BEpxtyKW.d.mts} +2 -2
- package/dist/{types-CCI5IDgT.d.mts.map → types-BEpxtyKW.d.mts.map} +1 -1
- package/package.json +13 -13
- package/dist/error-info-CCQcLAcW.mjs.map +0 -1
- package/dist/pglite-node-BMux5A2Y.mjs.map +0 -1
- package/dist/subgraph-extraction-zUDn2zX_.mjs.map +0 -1
package/dist/index.d.mts
CHANGED
|
@@ -1,19 +1,19 @@
|
|
|
1
1
|
import { n as PGLITE_UTC_PARSERS, t as PGliteLike } from "./pglite-like-CKQEL_Q0.mjs";
|
|
2
|
-
import { a as IPackagePieceSource, c as PackageManagerResult, d as ReportError, f as RunDetachedOptions, i as IPackageManagerOptions, l as PackagePiece, m as runDetached, n as IPackageLoaderOptions, p as reportFailure, r as IPackageManager, t as IPackageLoader, u as PackagePieceEntry } from "./types-
|
|
2
|
+
import { a as IPackagePieceSource, c as PackageManagerResult, d as ReportError, f as RunDetachedOptions, i as IPackageManagerOptions, l as PackagePiece, m as runDetached, n as IPackageLoaderOptions, p as reportFailure, r as IPackageManager, t as IPackageLoader, u as PackagePieceEntry } from "./types-BEpxtyKW.mjs";
|
|
3
3
|
import { C as hasOperationSchemas, E as typeDefinitionNames, S as getGeneratedDocumentModelTypes, T as reservedTypeNamesTaken, _ as generateDocumentModelSchema, a as GeneratedDocumentModelTypes, b as getDocumentModelSubgraphName, c as SubgraphSchemaOptions, d as buildDocumentModelSchema, f as buildSubgraphSchemaModule, g as findSubgraphTypeCollisions, h as documentModelSubgraphTypes, i as DocumentModelSource, l as SubgraphTypeCollisionError, m as createSchema, n as DocumentModelSchemaCache, o as ReservedTypeNames, p as createMergedSchema, r as DocumentModelSchemaOptions, s as ResolvedDocumentModelSchema, t as DocumentModelSchema, u as assembleSubgraphTypeDefs, v as generatedTypesOf, w as reservedTypeNames, x as getDocumentModelTypeDefs, y as getDocumentModelSchemaName } from "./create-schema-BUk-IQCT.mjs";
|
|
4
|
+
import { AttachmentBuildResult, AttachmentDownloadOptions, AttachmentDownloadTarget, AttachmentDownloadTargetOptions, AttachmentHeader, AttachmentReferenceIndexBuildResult, AttachmentResponse, AttachmentStatOptions, AttachmentStorageConfig, IAttachmentReferenceReader, IAttachmentReferenceWriter, IAttachmentService, IAttachmentUpload, ReserveAttachmentOptions } from "@powerhousedao/reactor-attachments";
|
|
5
|
+
import { ILogger } from "document-model";
|
|
4
6
|
import { IAnalyticsStore } from "@powerhousedao/analytics-engine-core";
|
|
5
7
|
import { AnalyticsModel } from "@powerhousedao/analytics-engine-graphql";
|
|
6
8
|
import { DocumentNode, GraphQLError, GraphQLResolveInfo, GraphQLScalarType, GraphQLScalarTypeConfig, GraphQLSchema } from "graphql";
|
|
7
|
-
import { AttachmentRef, CatchUpLoadSample, DocumentModelSource as DocumentModelSource$1, ICatchUpLoadSource, IDocumentModelLoader, IDocumentModelRegistry, IDriveClient, IInspectableAttachmentStore, IInspector, IInspectorAdmin, IInspectorStorageHealthProvider, INSPECTOR_OPS, IReactorClient, IReactorFactsSink, IReactorProcessorHostModuleBase, IReactorReadClient, IReactorWriteClient, IRelationalDb, ISyncInspector, ISyncManager, InProcessReactorClientModule, InProcessReactorModule, InspectorDocumentReader, InspectorReadOpKey, PagedResults, ParsedDriveUrl, ProcessorFactoryBuilder as ProcessorFactoryBuilder$1, Remote, SYNC_INSPECTION_OPS, SearchFilter, SyncInspectionReadOpKey, SyncScopeGate, ViewFilter, driveIdFromUrl, parseDriveUrl } from "@powerhousedao/reactor";
|
|
9
|
+
import { AttachmentRef, CatchUpLoadSample, DocumentModelSource as DocumentModelSource$1, ICatchUpLoadSource, IDocumentModelLoader, IDocumentModelRegistry, IDriveClient, IDriveNodeSource, IInspectableAttachmentStore, IInspector, IInspectorAdmin, IInspectorStorageHealthProvider, INSPECTOR_OPS, IReactorClient, IReactorFactsSink, IReactorProcessorHostModuleBase, IReactorReadClient, IReactorWriteClient, IRelationalDb, ISyncInspector, ISyncManager, InProcessReactorClientModule, InProcessReactorModule, InspectorDocumentReader, InspectorReadOpKey, PagedResults, ParsedDriveUrl, ProcessorFactoryBuilder as ProcessorFactoryBuilder$1, Remote, SYNC_INSPECTION_OPS, SearchFilter, SyncInspectionReadOpKey, SyncScopeGate, ViewFilter, driveIdFromUrl, parseDriveUrl } from "@powerhousedao/reactor";
|
|
8
10
|
import { AuthSubject, DocumentModelModule, Operation, PHDocument, UpgradeManifest } from "@powerhousedao/shared/document-model";
|
|
9
|
-
import { ILogger } from "document-model";
|
|
10
11
|
import { GraphQLResolverMap } from "@apollo/subgraph";
|
|
11
12
|
import * as z$1 from "zod";
|
|
12
13
|
import { DocumentDriveDocument, DocumentDriveGlobalState } from "@powerhousedao/shared/document-drive";
|
|
13
|
-
import {
|
|
14
|
+
import { AuthorizerResult, IHttpScope, IRelationalDb as IRelationalDb$1, IWebhookEndpoints, IWebhookScope, NodeRouteSpec, ProcessorApp, ProcessorFactory, RouteActor, RouteAuth, RouteAuthorizer, RouteBody, RouteContext, RouteHandler, RouteMethod, RouteOptions, RouteSpec, RouteTransport, RouteUser, RouteUser as RouteUser$1, ScopedRouteHandle, WebhookEndpointInfo, WebhookField, WebhookHashAlgorithm, WebhookPolicy, WebhookReply, WebhookRequest, WebhookScheme, WebhookSignatureEncoding, WebhookSpec, WebhookVerification } from "@powerhousedao/shared/processors";
|
|
14
15
|
import { IAttachmentClient } from "@powerhousedao/reactor-attachments/client";
|
|
15
16
|
import { WebSocketServer } from "ws";
|
|
16
|
-
import { AuthorizerResult, IHttpScope, IRelationalDb as IRelationalDb$1, IWebhookEndpoints, IWebhookScope, NodeRouteSpec, ProcessorApp, ProcessorFactory, RouteActor, RouteAuth, RouteAuthorizer, RouteBody, RouteContext, RouteHandler, RouteMethod, RouteOptions, RouteSpec, RouteTransport, RouteUser, RouteUser as RouteUser$1, ScopedRouteHandle, WebhookEndpointInfo, WebhookField, WebhookHashAlgorithm, WebhookPolicy, WebhookReply, WebhookRequest, WebhookScheme, WebhookSignatureEncoding, WebhookSpec, WebhookVerification } from "@powerhousedao/shared/processors";
|
|
17
17
|
import { AttachmentReadGate, IDocumentScopeGate } from "@powerhousedao/reactor-attachments/replication";
|
|
18
18
|
import { Generated, Kysely } from "kysely";
|
|
19
19
|
import { PGlite } from "@electric-sql/pglite";
|
|
@@ -24,340 +24,172 @@ import { Context as Context$1, GqlDocument as GqlDocument$1, GqlDriveDocument as
|
|
|
24
24
|
import { IncomingHttpHeaders } from "http";
|
|
25
25
|
import { Pool } from "pg";
|
|
26
26
|
import { PHReactorRenown } from "@powerhousedao/shared/clis";
|
|
27
|
-
//#region src/
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
export
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
export
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
createdAt: Date;
|
|
57
|
-
updatedAt: Date;
|
|
58
|
-
}
|
|
59
|
-
export interface OperationUserPermissionTable {
|
|
60
|
-
id: Generated<number>;
|
|
61
|
-
documentId: string;
|
|
62
|
-
operationType: string;
|
|
63
|
-
userAddress: string;
|
|
64
|
-
grantedBy: string;
|
|
65
|
-
createdAt: Date;
|
|
66
|
-
}
|
|
67
|
-
type Db = Kysely<any>;
|
|
68
|
-
export declare function isPostgresConnectionString(connectionString: string): boolean;
|
|
69
|
-
/**
|
|
70
|
-
* Optional factory used by callers (e.g. Switchboard) to inject a
|
|
71
|
-
* version-specific PGLite instance — e.g. `pglite-legacy-02` when an existing
|
|
72
|
-
* data dir was created with an older PG major, or a worker-backed
|
|
73
|
-
* `ThreadedPGlite`. Anything meeting {@link PGliteLike} works.
|
|
74
|
-
*/
|
|
75
|
-
export type PgliteFactory = (connectionString: string | undefined) => PGliteLike;
|
|
76
|
-
export interface DbClient {
|
|
77
|
-
db: Db;
|
|
78
|
-
knex: Knex;
|
|
79
|
-
pglite: PGliteLike | undefined;
|
|
80
|
-
}
|
|
81
|
-
export declare function getDbClient(connectionString?: string | undefined, pgliteFactory?: PgliteFactory): DbClient;
|
|
82
|
-
export declare const initAnalyticsStoreSql: string[];
|
|
83
|
-
//#endregion
|
|
84
|
-
//#region src/services/permission-cache.d.ts
|
|
85
|
-
/**
|
|
86
|
-
* Everything an authorization decision reads about one document: its
|
|
87
|
-
* protection flag (the configured default when it has no protection row), its
|
|
88
|
-
* owner, the users' grant levels and the users granted each operation.
|
|
89
|
-
* Addresses are stored lowercase, as the permission service writes them.
|
|
90
|
-
*/
|
|
91
|
-
export declare class DocumentPermissionSnapshot {
|
|
92
|
-
readonly documentId: string;
|
|
93
|
-
readonly isProtected: boolean;
|
|
94
|
-
readonly ownerAddress: string | null;
|
|
95
|
-
readonly grants: ReadonlyMap<string, DocumentPermissionLevel>;
|
|
96
|
-
readonly operationGrants: ReadonlyMap<string, ReadonlySet<string>>;
|
|
97
|
-
constructor(documentId: string, isProtected: boolean, ownerAddress: string | null, grants: ReadonlyMap<string, DocumentPermissionLevel>, operationGrants: ReadonlyMap<string, ReadonlySet<string>>);
|
|
98
|
-
grantLevel(userAddress: string): DocumentPermissionLevel | null;
|
|
99
|
-
isOperationRestricted(operationType: string): boolean;
|
|
100
|
-
hasOperationGrant(operationType: string, userAddress: string): boolean;
|
|
101
|
-
}
|
|
102
|
-
/** Loads the snapshots of the given documents; every id gets one. */
|
|
103
|
-
export type PermissionSnapshotLoader = (documentIds: string[]) => Promise<Map<string, DocumentPermissionSnapshot>>;
|
|
104
|
-
export interface PermissionCacheOptions {
|
|
105
|
-
/** How long an entry is served without reloading; 0 disables caching. */
|
|
106
|
-
ttlMs: number;
|
|
107
|
-
/** Entries kept before the least recently used one is dropped. */
|
|
108
|
-
maxEntries: number;
|
|
109
|
-
now: () => number;
|
|
110
|
-
}
|
|
111
|
-
export declare const DEFAULT_PERMISSION_CACHE_TTL_MS = 30000;
|
|
112
|
-
export declare const DEFAULT_PERMISSION_CACHE_OPTIONS: PermissionCacheOptions;
|
|
27
|
+
//#region src/graphql/gateway/types.d.ts
|
|
28
|
+
export type TlsOptions = {
|
|
29
|
+
keyPath: string;
|
|
30
|
+
certPath: string;
|
|
31
|
+
} | {
|
|
32
|
+
cert: Buffer | string;
|
|
33
|
+
key: Buffer | string;
|
|
34
|
+
} | true;
|
|
35
|
+
export type GatewayContextFactory<TContext = unknown> = (request: Request) => Promise<TContext>;
|
|
36
|
+
/** Under graphql-ws this is `ctx.extra`, created once per socket. */
|
|
37
|
+
export type WsConnection = object;
|
|
38
|
+
export type WsContextFactory<TContext = unknown> = (connectionParams: Record<string, unknown>, connection: WsConnection) => Promise<TContext>;
|
|
39
|
+
export type WsConnectHandler = (connectionParams: Record<string, unknown>, connection: WsConnection) => Promise<boolean>;
|
|
40
|
+
export type WsHandlers<TContext = unknown> = {
|
|
41
|
+
onConnect: WsConnectHandler;
|
|
42
|
+
context: WsContextFactory<TContext>;
|
|
43
|
+
};
|
|
44
|
+
/** No authenticated caller resolved, and REQUIRE_AUTHENTICATED_CALLER wants one. */
|
|
45
|
+
export declare const WS_CLOSE_REASON_AUTHENTICATION_REQUIRED = "authentication-required";
|
|
46
|
+
/** A bearer was sent and could not be verified. */
|
|
47
|
+
export declare const WS_CLOSE_REASON_BEARER_REJECTED = "bearer-rejected";
|
|
48
|
+
/** An admitted connection's credential was revoked or no longer verifies. */
|
|
49
|
+
export declare const WS_CLOSE_REASON_CREDENTIAL_REVOKED = "credential-revoked";
|
|
50
|
+
/** Every reason a refusal closes with, for a client matching on the set. */
|
|
51
|
+
export declare const WS_AUTH_CLOSE_REASONS: readonly ["authentication-required", "bearer-rejected", "credential-revoked"];
|
|
52
|
+
export type WsDisposer = {
|
|
53
|
+
dispose: () => void | Promise<void>;
|
|
54
|
+
};
|
|
55
|
+
export type FetchHandler = (request: Request) => Promise<Response>;
|
|
113
56
|
/**
|
|
114
|
-
*
|
|
57
|
+
* Handle to a route registered directly on the adapter. Packages hot-reload,
|
|
58
|
+
* so every registration is reversible; disposing a route that is already gone
|
|
59
|
+
* is a no-op.
|
|
115
60
|
*
|
|
116
|
-
*
|
|
117
|
-
*
|
|
118
|
-
*
|
|
119
|
-
*
|
|
61
|
+
* The handle *is* the capability to remove that one route: holding it is the
|
|
62
|
+
* only way to take the route back, and it cannot name any other. An opaque
|
|
63
|
+
* integer would let any holder remove any route by arithmetic, and a caller
|
|
64
|
+
* that disposed twice would eventually free somebody else's registration once
|
|
65
|
+
* ids were reused.
|
|
120
66
|
*
|
|
121
|
-
*
|
|
122
|
-
*
|
|
123
|
-
*
|
|
124
|
-
*/
|
|
125
|
-
export declare class PermissionCache {
|
|
126
|
-
#private;
|
|
127
|
-
constructor(load: PermissionSnapshotLoader, options?: PermissionCacheOptions);
|
|
128
|
-
get size(): number;
|
|
129
|
-
get(documentId: string): Promise<DocumentPermissionSnapshot>;
|
|
130
|
-
/** Snapshots for every id, loading the missing and expired ones in one batch. */
|
|
131
|
-
getMany(documentIds: string[]): Promise<Map<string, DocumentPermissionSnapshot>>;
|
|
132
|
-
invalidate(documentId: string): void;
|
|
133
|
-
clear(): void;
|
|
134
|
-
}
|
|
135
|
-
//#endregion
|
|
136
|
-
//#region src/services/document-permission.service.d.ts
|
|
137
|
-
export interface DocumentPermissionEntry {
|
|
138
|
-
documentId: string;
|
|
139
|
-
userAddress: string;
|
|
140
|
-
permission: DocumentPermissionLevel;
|
|
141
|
-
grantedBy: string;
|
|
142
|
-
createdAt: Date;
|
|
143
|
-
updatedAt: Date;
|
|
144
|
-
}
|
|
145
|
-
export interface OperationUserPermissionEntry {
|
|
146
|
-
documentId: string;
|
|
147
|
-
operationType: string;
|
|
148
|
-
userAddress: string;
|
|
149
|
-
grantedBy: string;
|
|
150
|
-
createdAt: Date;
|
|
151
|
-
}
|
|
152
|
-
/**
|
|
153
|
-
* Function type for getting parent document IDs
|
|
154
|
-
* This is injected to avoid circular dependencies with the reactor client
|
|
155
|
-
*/
|
|
156
|
-
export type GetParentIdsFn = (documentId: string) => Promise<string[]>;
|
|
157
|
-
/**
|
|
158
|
-
* Configuration for the DocumentPermissionService
|
|
67
|
+
* Distinct from the `ScopedRouteHandle` a package's HTTP scope hands back,
|
|
68
|
+
* which also carries the public URL the route answers on — at this layer there
|
|
69
|
+
* is no namespace to build one from and no knowledge of the host's origin.
|
|
159
70
|
*/
|
|
160
|
-
export interface
|
|
161
|
-
|
|
71
|
+
export interface AdapterRouteHandle {
|
|
72
|
+
dispose(): void;
|
|
162
73
|
}
|
|
163
74
|
/**
|
|
164
|
-
*
|
|
165
|
-
*
|
|
166
|
-
*
|
|
167
|
-
*
|
|
168
|
-
* - WRITE: Can push updates and modify the document
|
|
169
|
-
* - ADMIN: Can manage document permissions and settings
|
|
170
|
-
*
|
|
171
|
-
* Operation permissions:
|
|
172
|
-
* - Users can be granted permission to execute specific operations
|
|
75
|
+
* A framework-agnostic description of one subgraph.
|
|
76
|
+
* Used by IGatewayAdapter.createSupergraphHandler() to compose the supergraph:
|
|
77
|
+
* federation adapters treat it as a service to call over HTTP, while the
|
|
78
|
+
* stitching adapter merges its typeDefs and resolvers in-process.
|
|
173
79
|
*/
|
|
174
|
-
export
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
* Serves the reads authorization decisions make (protection, owner, grant
|
|
179
|
-
* level, operation grants). Every write through this service invalidates
|
|
180
|
-
* the document it touched.
|
|
181
|
-
*/
|
|
182
|
-
readonly permissionCache: PermissionCache;
|
|
183
|
-
constructor(db: Kysely<DocumentPermissionDatabase>, config?: DocumentPermissionConfig, cacheOptions?: PermissionCacheOptions);
|
|
80
|
+
export type SubgraphDefinition = {
|
|
81
|
+
name: string;
|
|
82
|
+
typeDefs: DocumentNode;
|
|
83
|
+
url: string;
|
|
184
84
|
/**
|
|
185
|
-
*
|
|
186
|
-
*
|
|
85
|
+
* The subgraph's resolver map, in-process form. Optional: federation
|
|
86
|
+
* adapters (Apollo, Mercurius) execute subgraphs over HTTP and ignore this,
|
|
87
|
+
* while stitching-style adapters merge these resolvers directly into the
|
|
88
|
+
* supergraph schema. Subgraph authors never see this field - it is filled
|
|
89
|
+
* in by the gateway manager from the subgraph's own resolvers.
|
|
187
90
|
*/
|
|
188
|
-
|
|
91
|
+
resolvers?: Record<string, unknown>;
|
|
92
|
+
};
|
|
93
|
+
export interface IGatewayAdapter<TContext = unknown> {
|
|
94
|
+
/** One-time startup. */
|
|
95
|
+
start(httpServer: http.Server): Promise<void>;
|
|
189
96
|
/**
|
|
190
|
-
*
|
|
97
|
+
* Returns a Fetch API handler for the given schema.
|
|
98
|
+
* Caller (IHttpAdapter) is responsible for mounting it at a path.
|
|
191
99
|
*/
|
|
192
|
-
|
|
100
|
+
createHandler(schema: GraphQLSchema, contextFactory: GatewayContextFactory<TContext>): Promise<FetchHandler>;
|
|
193
101
|
/**
|
|
194
|
-
*
|
|
102
|
+
* Create a handler that composes all subgraphs into a supergraph (a
|
|
103
|
+
* federation gateway, or a merged in-process schema under the stitching
|
|
104
|
+
* adapter). getSubgraphs is called eagerly (during setup) and again on every
|
|
105
|
+
* updateSupergraph() call.
|
|
195
106
|
*/
|
|
196
|
-
|
|
107
|
+
createSupergraphHandler(getSubgraphs: () => SubgraphDefinition[], httpServer: http.Server, contextFactory: GatewayContextFactory<TContext>): Promise<FetchHandler>;
|
|
197
108
|
/**
|
|
198
|
-
*
|
|
109
|
+
* Recompose the supergraph from the current subgraph list and push the update
|
|
110
|
+
* to the running gateway (a federation gateway, or a merged in-process schema
|
|
111
|
+
* under the stitching adapter). No-op if createSupergraphHandler() has not
|
|
112
|
+
* been called yet, or after stop().
|
|
199
113
|
*/
|
|
200
|
-
|
|
114
|
+
updateSupergraph(): Promise<void>;
|
|
115
|
+
stop(): Promise<void>;
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* Methods a node route may bind. OPTIONS is excluded: the framework's CORS
|
|
119
|
+
* plugin owns preflight, and a duplicate registration conflicts at startup.
|
|
120
|
+
*/
|
|
121
|
+
export type HttpMethod = "DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT";
|
|
122
|
+
export interface NodeRouteOptions {
|
|
123
|
+
/** Serve sub-paths too, not just an exact path match. */
|
|
124
|
+
prefix?: boolean;
|
|
201
125
|
/**
|
|
202
|
-
*
|
|
126
|
+
* Deliver the request body as the client sent it: unparsed and byte-exact.
|
|
127
|
+
* The handler reads `req` itself; the `body` argument stays undefined.
|
|
128
|
+
*
|
|
129
|
+
* Without this, the body has already been parsed by the time the handler
|
|
130
|
+
* runs, so a signature computed over the raw payload cannot be verified —
|
|
131
|
+
* re-encoding loses key order, whitespace and duplicate keys. This is the
|
|
132
|
+
* one capability a webhook endpoint cannot do without, and the reason a
|
|
133
|
+
* route needs to be dispatched ahead of the body parsers rather than behind
|
|
134
|
+
* them.
|
|
203
135
|
*/
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
}
|
|
212
|
-
/** Delete a document's protection row, which names its owner. */
|
|
213
|
-
deleteDocumentProtection(documentId: string): Promise<number>;
|
|
214
|
-
/** Every row that names the address, for a subject access request. */
|
|
215
|
-
rowsForAddress(address: string): Promise<{
|
|
216
|
-
permissions: DocumentPermissionEntry[];
|
|
217
|
-
operationPermissions: OperationUserPermissionEntry[];
|
|
218
|
-
ownedDocumentIds: string[];
|
|
219
|
-
}>;
|
|
220
|
-
/**
|
|
221
|
-
* Grant a user permission to execute an operation on a document
|
|
222
|
-
*/
|
|
223
|
-
grantOperationPermission(documentId: string, operationType: string, userAddress: string, grantedBy: string): Promise<OperationUserPermissionEntry>;
|
|
224
|
-
/**
|
|
225
|
-
* Revoke a user's permission to execute an operation
|
|
226
|
-
*/
|
|
227
|
-
revokeOperationPermission(documentId: string, operationType: string, userAddress: string): Promise<void>;
|
|
228
|
-
/**
|
|
229
|
-
* Get all users with permission to execute an operation
|
|
230
|
-
*/
|
|
231
|
-
getOperationUserPermissions(documentId: string, operationType: string): Promise<OperationUserPermissionEntry[]>;
|
|
232
|
-
/**
|
|
233
|
-
* Whether an operation-permission row exists for the user on this operation.
|
|
234
|
-
*/
|
|
235
|
-
hasOperationGrant(documentId: string, operationType: string, userAddress: string): Promise<boolean>;
|
|
236
|
-
/**
|
|
237
|
-
* Check if an operation has any permissions set (is restricted)
|
|
238
|
-
*/
|
|
239
|
-
isOperationRestricted(documentId: string, operationType: string): Promise<boolean>;
|
|
240
|
-
/**
|
|
241
|
-
* Check if a specific document has a protection row set to true.
|
|
242
|
-
* Falls back to `config.defaultProtection` if no row exists.
|
|
243
|
-
*/
|
|
244
|
-
isDocumentProtected(documentId: string): Promise<boolean>;
|
|
245
|
-
/**
|
|
246
|
-
* Walk the parent chain: if the document itself or any ancestor is protected, return true.
|
|
247
|
-
* Collects all ancestor IDs first (with cycle detection), then batch-checks protection.
|
|
248
|
-
*/
|
|
249
|
-
isProtectedWithAncestors(documentId: string, getParentIds: GetParentIdsFn): Promise<boolean>;
|
|
250
|
-
/**
|
|
251
|
-
* Reads the permission rows of the given documents from the store, three
|
|
252
|
-
* queries for the whole batch. The permission cache's loader.
|
|
253
|
-
*/
|
|
254
|
-
loadPermissionSnapshots(documentIds: string[]): Promise<Map<string, DocumentPermissionSnapshot>>;
|
|
255
|
-
/**
|
|
256
|
-
* Collect all ancestor IDs (including the document itself) with cycle detection.
|
|
257
|
-
*/
|
|
258
|
-
private collectAncestorIds;
|
|
259
|
-
/**
|
|
260
|
-
* Upsert protection status for a document.
|
|
261
|
-
*/
|
|
262
|
-
setDocumentProtection(documentId: string, isProtected: boolean): Promise<void>;
|
|
263
|
-
/**
|
|
264
|
-
* Get the owner address for a document, or null if not set.
|
|
265
|
-
*/
|
|
266
|
-
getDocumentOwner(documentId: string): Promise<string | null>;
|
|
136
|
+
rawBody?: boolean;
|
|
137
|
+
}
|
|
138
|
+
export interface IHttpAdapter {
|
|
139
|
+
/** Set up CORS and body-parser equivalent middleware. */
|
|
140
|
+
setupMiddleware(config: {
|
|
141
|
+
corsOptions?: CorsOptions;
|
|
142
|
+
bodyLimit?: string;
|
|
143
|
+
}): void;
|
|
267
144
|
/**
|
|
268
|
-
*
|
|
145
|
+
* Mount a Fetch API handler. Returns a handle whose `dispose()` removes it.
|
|
146
|
+
* - exact = false (default): exact path match.
|
|
147
|
+
* - exact = true: prefix match - handler also receives all sub-paths.
|
|
148
|
+
*
|
|
149
|
+
* Mounting a path that already holds a fetch mount of the same kind
|
|
150
|
+
* replaces the previous one (last write wins).
|
|
269
151
|
*/
|
|
270
|
-
|
|
152
|
+
mount(path: string, handler: FetchHandler, options?: {
|
|
153
|
+
prefix?: boolean;
|
|
154
|
+
/** @deprecated Misleading name: this always meant *prefix*, not exact. */
|
|
155
|
+
exact?: boolean;
|
|
156
|
+
}): AdapterRouteHandle;
|
|
271
157
|
/**
|
|
272
|
-
*
|
|
273
|
-
*
|
|
158
|
+
* Register a GET-only route that returns a Fetch Response (for health,
|
|
159
|
+
* explorer, etc.). Returns a handle whose `dispose()` removes it.
|
|
274
160
|
*/
|
|
275
|
-
|
|
161
|
+
getRoute(path: string, handler: (request: Request) => Response | Promise<Response>): AdapterRouteHandle;
|
|
276
162
|
/**
|
|
277
|
-
*
|
|
163
|
+
* Start listening on the given port. Returns the underlying http.Server
|
|
164
|
+
* so callers can attach WebSocket servers. Without `host` it binds the
|
|
165
|
+
* wildcard address.
|
|
278
166
|
*/
|
|
279
|
-
|
|
280
|
-
documentId: string;
|
|
281
|
-
protected: boolean;
|
|
282
|
-
ownerAddress: string | null;
|
|
283
|
-
}>;
|
|
284
|
-
}
|
|
285
|
-
//#endregion
|
|
286
|
-
//#region src/services/authorization.service.d.ts
|
|
287
|
-
/**
|
|
288
|
-
* A document id that has been resolved to its canonical form, never a slug.
|
|
289
|
-
*
|
|
290
|
-
* Protection and grant rows are written under the canonical id, while the
|
|
291
|
-
* read/operation data paths accept an id-or-slug identifier. The decision layer
|
|
292
|
-
* must key on the canonical id, so branding it forces every caller to resolve a
|
|
293
|
-
* slug to its id before consulting this service, closing the slug-aliasing
|
|
294
|
-
* bypass (S-C1). The only sanctioned cast from string to CanonicalDocumentId
|
|
295
|
-
* lives in createCanonicalDocumentIdResolver, immediately after the shared
|
|
296
|
-
* resolveIdOrSlug lookup returns.
|
|
297
|
-
*/
|
|
298
|
-
type CanonicalDocumentId = string & {
|
|
299
|
-
readonly __canonicalDocumentId: unique symbol;
|
|
300
|
-
};
|
|
301
|
-
/**
|
|
302
|
-
* Result of a passed per-document authorization check. `fetchIdentifier` is
|
|
303
|
-
* always safe for the data fetch: the canonical id when resolved, or the raw
|
|
304
|
-
* identifier when the check was skipped for a policy-wide caller.
|
|
305
|
-
*/
|
|
306
|
-
export declare class AuthorizedDocumentHandle {
|
|
307
|
-
readonly fetchIdentifier: string;
|
|
308
|
-
readonly isResolved: boolean;
|
|
309
|
-
private constructor();
|
|
310
|
-
static resolved(documentId: CanonicalDocumentId): AuthorizedDocumentHandle;
|
|
311
|
-
static skipped(identifier: string): AuthorizedDocumentHandle;
|
|
312
|
-
/** The verified canonical id; throws when resolution was skipped. */
|
|
313
|
-
canonicalId(): CanonicalDocumentId;
|
|
314
|
-
}
|
|
315
|
-
export declare const AuthorizationPolicy: {
|
|
316
|
-
readonly OPEN: "OPEN";
|
|
317
|
-
readonly ADMIN_ONLY: "ADMIN_ONLY";
|
|
318
|
-
readonly DOCUMENT_PERMISSIONS: "DOCUMENT_PERMISSIONS";
|
|
319
|
-
};
|
|
320
|
-
export type AuthorizationPolicy = (typeof AuthorizationPolicy)[keyof typeof AuthorizationPolicy];
|
|
321
|
-
interface AuthorizationConfig {
|
|
322
|
-
admins: string[];
|
|
323
|
-
defaultProtection: boolean;
|
|
324
|
-
policy: AuthorizationPolicy;
|
|
325
|
-
}
|
|
326
|
-
/**
|
|
327
|
-
* Single source of truth for every permission decision. Always present (never
|
|
328
|
-
* null) so callers branch on data, not on the existence of a service.
|
|
329
|
-
*
|
|
330
|
-
* The policy selects an implementation once at boot:
|
|
331
|
-
* - OPEN: authentication disabled — everyone (incl. anonymous) is allowed.
|
|
332
|
-
* - ADMIN_ONLY: authentication on, document permissions off — only ADMINS.
|
|
333
|
-
* - DOCUMENT_PERMISSIONS: the full per-document protection + grant model.
|
|
334
|
-
*
|
|
335
|
-
* Permission inheritance walks the parent-document hierarchy through a
|
|
336
|
-
* parent resolver injected at construction; callers never supply one.
|
|
337
|
-
*/
|
|
338
|
-
interface IAuthorizationService {
|
|
339
|
-
readonly config: AuthorizationConfig;
|
|
167
|
+
listen(port: number, tls?: TlsOptions, host?: string): Promise<http.Server>;
|
|
340
168
|
/**
|
|
341
|
-
*
|
|
342
|
-
*
|
|
343
|
-
*
|
|
344
|
-
* filtering. It does NOT mean the caller is in the ADMINS list.
|
|
169
|
+
* Mount a raw Connect/Express-compatible middleware function (e.g. Vite dev
|
|
170
|
+
* server middleware). The implementation is adapter-specific; for Express this
|
|
171
|
+
* is equivalent to `app.use(middleware)`.
|
|
345
172
|
*/
|
|
346
|
-
|
|
173
|
+
mountRawMiddleware(middleware: unknown): void;
|
|
347
174
|
/**
|
|
348
|
-
*
|
|
349
|
-
*
|
|
350
|
-
*
|
|
175
|
+
* Register a method-specific route handler using Node.js core HTTP types.
|
|
176
|
+
* Use this when a Fetch API FetchHandler is not possible (e.g. streaming
|
|
177
|
+
* protocols that require direct access to IncomingMessage/ServerResponse).
|
|
178
|
+
*
|
|
179
|
+
* The req/res objects are `http.IncomingMessage`/`http.ServerResponse`
|
|
180
|
+
* (Express Request/Response are compatible subtypes). Returns a handle
|
|
181
|
+
* whose `dispose()` removes it.
|
|
351
182
|
*/
|
|
352
|
-
|
|
353
|
-
canRead(documentId: CanonicalDocumentId, userAddress?: string): Promise<boolean>;
|
|
354
|
-
canWrite(documentId: CanonicalDocumentId, userAddress?: string): Promise<boolean>;
|
|
183
|
+
mountNodeRoute(method: HttpMethod, path: string, handler: (req: http.IncomingMessage, res: http.ServerResponse, body?: unknown) => void | Promise<void>, options?: NodeRouteOptions): AdapterRouteHandle;
|
|
355
184
|
/**
|
|
356
|
-
*
|
|
357
|
-
*
|
|
185
|
+
* Register framework-specific Sentry error-capturing middleware after all routes
|
|
186
|
+
* are mounted. Each adapter calls the Sentry setup function appropriate for its
|
|
187
|
+
* framework (e.g. setupExpressErrorHandler, setupFastifyErrorHandler).
|
|
188
|
+
* No-op if Sentry is not relevant for the adapter.
|
|
358
189
|
*/
|
|
359
|
-
|
|
360
|
-
|
|
190
|
+
setupSentryErrorHandler(sentry: object): void;
|
|
191
|
+
/** The raw framework handle (e.g. Express app). Cast as needed at call sites. */
|
|
192
|
+
readonly handle: unknown;
|
|
361
193
|
}
|
|
362
194
|
//#endregion
|
|
363
195
|
//#region src/services/auth.service.d.ts
|
|
@@ -495,252 +327,71 @@ export declare class AuthService implements ICredentialInvalidator {
|
|
|
495
327
|
private fetchCredentialExists;
|
|
496
328
|
}
|
|
497
329
|
//#endregion
|
|
498
|
-
//#region src/
|
|
330
|
+
//#region src/http/webhook-store.d.ts
|
|
499
331
|
/**
|
|
500
|
-
*
|
|
501
|
-
*
|
|
332
|
+
* Where webhook tokens live. Core-owned and relational rather than per-host, so
|
|
333
|
+
* any host in a fleet can serve any endpoint: a provider's registered URL keeps
|
|
334
|
+
* working after a restart, a redeploy or a request landing on another replica.
|
|
502
335
|
*/
|
|
503
|
-
interface
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
/**
|
|
523
|
-
|
|
524
|
-
|
|
525
|
-
|
|
526
|
-
export
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
|
|
536
|
-
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
|
|
540
|
-
|
|
541
|
-
export
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
|
|
545
|
-
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
|
|
549
|
-
|
|
550
|
-
* that disposed twice would eventually free somebody else's registration once
|
|
551
|
-
* ids were reused.
|
|
552
|
-
*
|
|
553
|
-
* Distinct from the `ScopedRouteHandle` a package's HTTP scope hands back,
|
|
554
|
-
* which also carries the public URL the route answers on — at this layer there
|
|
555
|
-
* is no namespace to build one from and no knowledge of the host's origin.
|
|
556
|
-
*/
|
|
557
|
-
export interface AdapterRouteHandle {
|
|
558
|
-
dispose(): void;
|
|
559
|
-
}
|
|
560
|
-
/**
|
|
561
|
-
* A framework-agnostic description of one subgraph.
|
|
562
|
-
* Used by IGatewayAdapter.createSupergraphHandler() to compose the supergraph:
|
|
563
|
-
* federation adapters treat it as a service to call over HTTP, while the
|
|
564
|
-
* stitching adapter merges its typeDefs and resolvers in-process.
|
|
565
|
-
*/
|
|
566
|
-
export type SubgraphDefinition = {
|
|
567
|
-
name: string;
|
|
568
|
-
typeDefs: DocumentNode;
|
|
569
|
-
url: string;
|
|
570
|
-
/**
|
|
571
|
-
* The subgraph's resolver map, in-process form. Optional: federation
|
|
572
|
-
* adapters (Apollo, Mercurius) execute subgraphs over HTTP and ignore this,
|
|
573
|
-
* while stitching-style adapters merge these resolvers directly into the
|
|
574
|
-
* supergraph schema. Subgraph authors never see this field - it is filled
|
|
575
|
-
* in by the gateway manager from the subgraph's own resolvers.
|
|
576
|
-
*/
|
|
577
|
-
resolvers?: Record<string, unknown>;
|
|
578
|
-
};
|
|
579
|
-
export interface IGatewayAdapter<TContext = unknown> {
|
|
580
|
-
/** One-time startup. */
|
|
581
|
-
start(httpServer: http.Server): Promise<void>;
|
|
582
|
-
/**
|
|
583
|
-
* Returns a Fetch API handler for the given schema.
|
|
584
|
-
* Caller (IHttpAdapter) is responsible for mounting it at a path.
|
|
585
|
-
*/
|
|
586
|
-
createHandler(schema: GraphQLSchema, contextFactory: GatewayContextFactory<TContext>): Promise<FetchHandler>;
|
|
587
|
-
/**
|
|
588
|
-
* Create a handler that composes all subgraphs into a supergraph (a
|
|
589
|
-
* federation gateway, or a merged in-process schema under the stitching
|
|
590
|
-
* adapter). getSubgraphs is called eagerly (during setup) and again on every
|
|
591
|
-
* updateSupergraph() call.
|
|
592
|
-
*/
|
|
593
|
-
createSupergraphHandler(getSubgraphs: () => SubgraphDefinition[], httpServer: http.Server, contextFactory: GatewayContextFactory<TContext>): Promise<FetchHandler>;
|
|
594
|
-
/**
|
|
595
|
-
* Recompose the supergraph from the current subgraph list and push the update
|
|
596
|
-
* to the running gateway (a federation gateway, or a merged in-process schema
|
|
597
|
-
* under the stitching adapter). No-op if createSupergraphHandler() has not
|
|
598
|
-
* been called yet, or after stop().
|
|
599
|
-
*/
|
|
600
|
-
updateSupergraph(): Promise<void>;
|
|
601
|
-
stop(): Promise<void>;
|
|
602
|
-
}
|
|
603
|
-
/**
|
|
604
|
-
* Methods a node route may bind. OPTIONS is excluded: the framework's CORS
|
|
605
|
-
* plugin owns preflight, and a duplicate registration conflicts at startup.
|
|
606
|
-
*/
|
|
607
|
-
export type HttpMethod = "DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT";
|
|
608
|
-
export interface NodeRouteOptions {
|
|
609
|
-
/** Serve sub-paths too, not just an exact path match. */
|
|
610
|
-
prefix?: boolean;
|
|
611
|
-
/**
|
|
612
|
-
* Deliver the request body as the client sent it: unparsed and byte-exact.
|
|
613
|
-
* The handler reads `req` itself; the `body` argument stays undefined.
|
|
614
|
-
*
|
|
615
|
-
* Without this, the body has already been parsed by the time the handler
|
|
616
|
-
* runs, so a signature computed over the raw payload cannot be verified —
|
|
617
|
-
* re-encoding loses key order, whitespace and duplicate keys. This is the
|
|
618
|
-
* one capability a webhook endpoint cannot do without, and the reason a
|
|
619
|
-
* route needs to be dispatched ahead of the body parsers rather than behind
|
|
620
|
-
* them.
|
|
621
|
-
*/
|
|
622
|
-
rawBody?: boolean;
|
|
623
|
-
}
|
|
624
|
-
export interface IHttpAdapter {
|
|
625
|
-
/** Set up CORS and body-parser equivalent middleware. */
|
|
626
|
-
setupMiddleware(config: {
|
|
627
|
-
corsOptions?: CorsOptions;
|
|
628
|
-
bodyLimit?: string;
|
|
629
|
-
}): void;
|
|
630
|
-
/**
|
|
631
|
-
* Mount a Fetch API handler. Returns a handle whose `dispose()` removes it.
|
|
632
|
-
* - exact = false (default): exact path match.
|
|
633
|
-
* - exact = true: prefix match - handler also receives all sub-paths.
|
|
634
|
-
*
|
|
635
|
-
* Mounting a path that already holds a fetch mount of the same kind
|
|
636
|
-
* replaces the previous one (last write wins).
|
|
637
|
-
*/
|
|
638
|
-
mount(path: string, handler: FetchHandler, options?: {
|
|
639
|
-
prefix?: boolean;
|
|
640
|
-
/** @deprecated Misleading name: this always meant *prefix*, not exact. */
|
|
641
|
-
exact?: boolean;
|
|
642
|
-
}): AdapterRouteHandle;
|
|
643
|
-
/**
|
|
644
|
-
* Register a GET-only route that returns a Fetch Response (for health,
|
|
645
|
-
* explorer, etc.). Returns a handle whose `dispose()` removes it.
|
|
646
|
-
*/
|
|
647
|
-
getRoute(path: string, handler: (request: Request) => Response | Promise<Response>): AdapterRouteHandle;
|
|
648
|
-
/**
|
|
649
|
-
* Start listening on the given port. Returns the underlying http.Server
|
|
650
|
-
* so callers can attach WebSocket servers. Without `host` it binds the
|
|
651
|
-
* wildcard address.
|
|
652
|
-
*/
|
|
653
|
-
listen(port: number, tls?: TlsOptions, host?: string): Promise<http.Server>;
|
|
654
|
-
/**
|
|
655
|
-
* Mount a raw Connect/Express-compatible middleware function (e.g. Vite dev
|
|
656
|
-
* server middleware). The implementation is adapter-specific; for Express this
|
|
657
|
-
* is equivalent to `app.use(middleware)`.
|
|
658
|
-
*/
|
|
659
|
-
mountRawMiddleware(middleware: unknown): void;
|
|
660
|
-
/**
|
|
661
|
-
* Register a method-specific route handler using Node.js core HTTP types.
|
|
662
|
-
* Use this when a Fetch API FetchHandler is not possible (e.g. streaming
|
|
663
|
-
* protocols that require direct access to IncomingMessage/ServerResponse).
|
|
664
|
-
*
|
|
665
|
-
* The req/res objects are `http.IncomingMessage`/`http.ServerResponse`
|
|
666
|
-
* (Express Request/Response are compatible subtypes). Returns a handle
|
|
667
|
-
* whose `dispose()` removes it.
|
|
668
|
-
*/
|
|
669
|
-
mountNodeRoute(method: HttpMethod, path: string, handler: (req: http.IncomingMessage, res: http.ServerResponse, body?: unknown) => void | Promise<void>, options?: NodeRouteOptions): AdapterRouteHandle;
|
|
670
|
-
/**
|
|
671
|
-
* Register framework-specific Sentry error-capturing middleware after all routes
|
|
672
|
-
* are mounted. Each adapter calls the Sentry setup function appropriate for its
|
|
673
|
-
* framework (e.g. setupExpressErrorHandler, setupFastifyErrorHandler).
|
|
674
|
-
* No-op if Sentry is not relevant for the adapter.
|
|
675
|
-
*/
|
|
676
|
-
setupSentryErrorHandler(sentry: object): void;
|
|
677
|
-
/** The raw framework handle (e.g. Express app). Cast as needed at call sites. */
|
|
678
|
-
readonly handle: unknown;
|
|
679
|
-
}
|
|
680
|
-
//#endregion
|
|
681
|
-
//#region src/http/webhook-store.d.ts
|
|
682
|
-
/**
|
|
683
|
-
* Where webhook tokens live. Core-owned and relational rather than per-host, so
|
|
684
|
-
* any host in a fleet can serve any endpoint: a provider's registered URL keeps
|
|
685
|
-
* working after a restart, a redeploy or a request landing on another replica.
|
|
686
|
-
*/
|
|
687
|
-
interface WebhookEndpointRow {
|
|
688
|
-
token: string;
|
|
689
|
-
/** The owning package's npm name. */
|
|
690
|
-
namespace: string;
|
|
691
|
-
/** The registration within that package. */
|
|
692
|
-
endpoint: string;
|
|
693
|
-
/** The caller's own key, e.g. a document id. Never appears in the URL. */
|
|
694
|
-
ownerKey: string;
|
|
695
|
-
createdAt: string;
|
|
696
|
-
}
|
|
697
|
-
interface IWebhookStore {
|
|
698
|
-
init(): Promise<void>;
|
|
699
|
-
/** Returns the existing token for this key, or mints one. */
|
|
700
|
-
ensure(namespace: string, endpoint: string, ownerKey: string): Promise<WebhookEndpointRow>;
|
|
701
|
-
find(token: string): Promise<WebhookEndpointRow | undefined>;
|
|
702
|
-
list(namespace: string, endpoint?: string): Promise<WebhookEndpointRow[]>;
|
|
703
|
-
revoke(namespace: string, endpoint: string, ownerKey: string): Promise<void>;
|
|
704
|
-
/** True when this delivery has been seen before, within the TTL. */
|
|
705
|
-
seen(token: string, key: string, ttlSeconds: number): Promise<boolean>;
|
|
706
|
-
/** Drops a delivery recorded by seen(), so a retry of it is delivered. */
|
|
707
|
-
forget(token: string, key: string): Promise<void>;
|
|
708
|
-
}
|
|
709
|
-
/** Opaque and unguessable: the URL is a bearer capability held by a third party. */
|
|
710
|
-
export declare function newWebhookToken(): string;
|
|
711
|
-
/** Relational implementation, over the reactor's own database. */
|
|
712
|
-
export declare class RelationalWebhookStore implements IWebhookStore {
|
|
713
|
-
#private;
|
|
714
|
-
private readonly relationalDb;
|
|
715
|
-
constructor(relationalDb: IRelationalDb$1);
|
|
716
|
-
init(): Promise<void>;
|
|
717
|
-
ensure(namespace: string, endpoint: string, ownerKey: string): Promise<WebhookEndpointRow>;
|
|
718
|
-
find(token: string): Promise<WebhookEndpointRow | undefined>;
|
|
719
|
-
list(namespace: string, endpoint?: string): Promise<WebhookEndpointRow[]>;
|
|
720
|
-
revoke(namespace: string, endpoint: string, ownerKey: string): Promise<void>;
|
|
721
|
-
forget(token: string, key: string): Promise<void>;
|
|
722
|
-
seen(token: string, key: string, ttlSeconds: number): Promise<boolean>;
|
|
723
|
-
}
|
|
724
|
-
/** In-memory store, for hosts with no relational database and for tests. */
|
|
725
|
-
export declare class MemoryWebhookStore implements IWebhookStore {
|
|
726
|
-
#private;
|
|
727
|
-
init(): Promise<void>;
|
|
728
|
-
ensure(namespace: string, endpoint: string, ownerKey: string): Promise<WebhookEndpointRow>;
|
|
729
|
-
find(token: string): Promise<WebhookEndpointRow | undefined>;
|
|
730
|
-
forget(token: string, key: string): Promise<void>;
|
|
731
|
-
list(namespace: string, endpoint?: string): Promise<WebhookEndpointRow[]>;
|
|
732
|
-
revoke(namespace: string, endpoint: string, ownerKey: string): Promise<void>;
|
|
733
|
-
seen(token: string, key: string, ttlSeconds: number): Promise<boolean>;
|
|
336
|
+
interface WebhookEndpointRow {
|
|
337
|
+
token: string;
|
|
338
|
+
/** The owning package's npm name. */
|
|
339
|
+
namespace: string;
|
|
340
|
+
/** The registration within that package. */
|
|
341
|
+
endpoint: string;
|
|
342
|
+
/** The caller's own key, e.g. a document id. Never appears in the URL. */
|
|
343
|
+
ownerKey: string;
|
|
344
|
+
createdAt: string;
|
|
345
|
+
}
|
|
346
|
+
interface IWebhookStore {
|
|
347
|
+
init(): Promise<void>;
|
|
348
|
+
/** Returns the existing token for this key, or mints one. */
|
|
349
|
+
ensure(namespace: string, endpoint: string, ownerKey: string): Promise<WebhookEndpointRow>;
|
|
350
|
+
find(token: string): Promise<WebhookEndpointRow | undefined>;
|
|
351
|
+
list(namespace: string, endpoint?: string): Promise<WebhookEndpointRow[]>;
|
|
352
|
+
revoke(namespace: string, endpoint: string, ownerKey: string): Promise<void>;
|
|
353
|
+
/** True when this delivery has been seen before, within the TTL. */
|
|
354
|
+
seen(token: string, key: string, ttlSeconds: number): Promise<boolean>;
|
|
355
|
+
/** Drops a delivery recorded by seen(), so a retry of it is delivered. */
|
|
356
|
+
forget(token: string, key: string): Promise<void>;
|
|
357
|
+
}
|
|
358
|
+
/** Opaque and unguessable: the URL is a bearer capability held by a third party. */
|
|
359
|
+
export declare function newWebhookToken(): string;
|
|
360
|
+
/** Relational implementation, over the reactor's own database. */
|
|
361
|
+
export declare class RelationalWebhookStore implements IWebhookStore {
|
|
362
|
+
#private;
|
|
363
|
+
private readonly relationalDb;
|
|
364
|
+
constructor(relationalDb: IRelationalDb$1);
|
|
365
|
+
init(): Promise<void>;
|
|
366
|
+
ensure(namespace: string, endpoint: string, ownerKey: string): Promise<WebhookEndpointRow>;
|
|
367
|
+
find(token: string): Promise<WebhookEndpointRow | undefined>;
|
|
368
|
+
list(namespace: string, endpoint?: string): Promise<WebhookEndpointRow[]>;
|
|
369
|
+
revoke(namespace: string, endpoint: string, ownerKey: string): Promise<void>;
|
|
370
|
+
forget(token: string, key: string): Promise<void>;
|
|
371
|
+
seen(token: string, key: string, ttlSeconds: number): Promise<boolean>;
|
|
372
|
+
}
|
|
373
|
+
/** In-memory store, for hosts with no relational database and for tests. */
|
|
374
|
+
export declare class MemoryWebhookStore implements IWebhookStore {
|
|
375
|
+
#private;
|
|
376
|
+
init(): Promise<void>;
|
|
377
|
+
ensure(namespace: string, endpoint: string, ownerKey: string): Promise<WebhookEndpointRow>;
|
|
378
|
+
find(token: string): Promise<WebhookEndpointRow | undefined>;
|
|
379
|
+
forget(token: string, key: string): Promise<void>;
|
|
380
|
+
list(namespace: string, endpoint?: string): Promise<WebhookEndpointRow[]>;
|
|
381
|
+
revoke(namespace: string, endpoint: string, ownerKey: string): Promise<void>;
|
|
382
|
+
seen(token: string, key: string, ttlSeconds: number): Promise<boolean>;
|
|
734
383
|
}
|
|
735
384
|
//#endregion
|
|
736
385
|
//#region src/http/webhook-service.d.ts
|
|
737
386
|
/** The flat, token-addressed path family. */
|
|
738
387
|
export declare const WEBHOOK_SEGMENT = "webhooks";
|
|
388
|
+
/** An origin, or a read of one only known once the server listens. */
|
|
389
|
+
type PublicOrigin = string | (() => string);
|
|
739
390
|
interface WebhookServiceOptions {
|
|
740
391
|
store: IWebhookStore;
|
|
741
392
|
basePath?: string;
|
|
742
393
|
/** Public origin to advertise, e.g. https://switchboard.example. */
|
|
743
|
-
publicUrl?:
|
|
394
|
+
publicUrl?: PublicOrigin;
|
|
744
395
|
}
|
|
745
396
|
/** One host route for `/webhooks/:token`, dispatching by token. The flat path leaks
|
|
746
397
|
* neither package nor document; the namespace lives in the token record, which is also what stops one package's token reaching another's handler. */
|
|
@@ -777,7 +428,7 @@ interface HttpRouteServiceOptions {
|
|
|
777
428
|
/** Absent when auth is disabled host-wide; every route then sees an anonymous actor. */
|
|
778
429
|
authService?: AuthService;
|
|
779
430
|
/** The host's public origin; empty when unknowable, the only case where advertised URLs degrade to paths. */
|
|
780
|
-
publicUrl?:
|
|
431
|
+
publicUrl?: PublicOrigin;
|
|
781
432
|
/** Whether to believe the `X-Forwarded-*` headers that name the request's public origin.
|
|
782
433
|
* Off by default: they are client-written, so with no proxy in front a caller could choose the origin a route advertises. */
|
|
783
434
|
trustProxy?: boolean;
|
|
@@ -830,84 +481,420 @@ export declare function namespacePath(packageName: string): string;
|
|
|
830
481
|
*/
|
|
831
482
|
export declare function resolvePackageName(key: string, readPackageJsonName?: (dir: string) => string | undefined): string;
|
|
832
483
|
/**
|
|
833
|
-
* A mount path the host named for one of its own route groups.
|
|
834
|
-
*
|
|
835
|
-
* The host owns the whole URL space — it holds the adapter — so unlike a
|
|
836
|
-
* package it may name an absolute path. That is the difference between hosting
|
|
837
|
-
* and being hosted, and it is why this lives on the service rather than on a
|
|
838
|
-
* scope: a package is only ever handed a scope, and a scope has no way to
|
|
839
|
-
* express a path outside itself.
|
|
484
|
+
* A mount path the host named for one of its own route groups.
|
|
485
|
+
*
|
|
486
|
+
* The host owns the whole URL space — it holds the adapter — so unlike a
|
|
487
|
+
* package it may name an absolute path. That is the difference between hosting
|
|
488
|
+
* and being hosted, and it is why this lives on the service rather than on a
|
|
489
|
+
* scope: a package is only ever handed a scope, and a scope has no way to
|
|
490
|
+
* express a path outside itself.
|
|
491
|
+
*
|
|
492
|
+
* What the host still may not name is anything that is not one stable literal
|
|
493
|
+
* prefix. A traversal segment, or a pattern segment, would make the group's own
|
|
494
|
+
* routes unpredictable relative to each other. Returns the normalized path,
|
|
495
|
+
* with a leading and no trailing slash.
|
|
496
|
+
*/
|
|
497
|
+
export declare function assertHostMountPath(path: string): string;
|
|
498
|
+
//#endregion
|
|
499
|
+
//#region src/http/webhook-verify.d.ts
|
|
500
|
+
type VerifyResult = {
|
|
501
|
+
ok: true;
|
|
502
|
+
} | {
|
|
503
|
+
ok: false;
|
|
504
|
+
reason: string;
|
|
505
|
+
};
|
|
506
|
+
/** Verifies a delivery against the configured scheme; `raw` must be the exact bytes
|
|
507
|
+
* received. The reason is for the log only: callers answer a fixed 401, so a probing sender learns nothing from the body. */
|
|
508
|
+
export declare function verifyWebhook(options: {
|
|
509
|
+
verification: WebhookVerification;
|
|
510
|
+
headers: Record<string, string>;
|
|
511
|
+
raw: Buffer;
|
|
512
|
+
now?: Date;
|
|
513
|
+
}): VerifyResult;
|
|
514
|
+
export declare function redactHeaders(headers: Record<string, string>, extra?: string): Record<string, string>;
|
|
515
|
+
/** JSON and form bodies become objects; anything else stays decoded text, so a verified
|
|
516
|
+
* XML or CSV payload is still reachable downstream. */
|
|
517
|
+
export declare function parseWebhookBody(raw: Buffer, contentType?: string): unknown;
|
|
518
|
+
//#endregion
|
|
519
|
+
//#region src/http/request-load.d.ts
|
|
520
|
+
/**
|
|
521
|
+
* Whether a request counts as user load: not the monitor's inspection calls,
|
|
522
|
+
* not a health probe, not a static asset and not a long-lived stream.
|
|
523
|
+
*/
|
|
524
|
+
export declare function isCountedRequest(url: string, accept?: string): boolean;
|
|
525
|
+
/** Main-thread event-loop delay, as the recorder reads it once per sample. */
|
|
526
|
+
interface IEventLoopDelaySource {
|
|
527
|
+
/** p99 delay since the last call, in ms. */
|
|
528
|
+
takeP99Ms(): number;
|
|
529
|
+
stop(): void;
|
|
530
|
+
}
|
|
531
|
+
/** `perf_hooks.monitorEventLoopDelay`, reset on every read. */
|
|
532
|
+
export declare class NodeEventLoopDelay implements IEventLoopDelaySource {
|
|
533
|
+
private readonly histogram;
|
|
534
|
+
constructor(resolutionMs?: number);
|
|
535
|
+
takeP99Ms(): number;
|
|
536
|
+
stop(): void;
|
|
537
|
+
}
|
|
538
|
+
type RequestLoadRecorderOptions = {
|
|
539
|
+
windowMs?: number;
|
|
540
|
+
now?: () => number;
|
|
541
|
+
eventLoopDelay?: IEventLoopDelaySource;
|
|
542
|
+
};
|
|
543
|
+
/**
|
|
544
|
+
* Counts completed user requests and their latency over a sliding window, and
|
|
545
|
+
* reads the main thread's event-loop delay, as the catch-up controller's load
|
|
546
|
+
* source. Loop delay over the window is the highest per-sample p99 in it.
|
|
547
|
+
*/
|
|
548
|
+
export declare class RequestLoadRecorder implements ICatchUpLoadSource {
|
|
549
|
+
private readonly windowMs;
|
|
550
|
+
private readonly now;
|
|
551
|
+
private readonly eventLoopDelay;
|
|
552
|
+
private readonly completions;
|
|
553
|
+
private readonly loopReadings;
|
|
554
|
+
private lastCompletedAt;
|
|
555
|
+
private readonly detachers;
|
|
556
|
+
constructor(options?: RequestLoadRecorderOptions);
|
|
557
|
+
/** Records every counted request `server` completes, until `stop`. */
|
|
558
|
+
attach(server: http.Server): void;
|
|
559
|
+
record(durationMs: number): void;
|
|
560
|
+
sample(): CatchUpLoadSample;
|
|
561
|
+
stop(): void;
|
|
562
|
+
}
|
|
563
|
+
//#endregion
|
|
564
|
+
//#region src/utils/db.d.ts
|
|
565
|
+
/**
|
|
566
|
+
* Permission levels for documents:
|
|
567
|
+
* - READ: Can fetch and read the document
|
|
568
|
+
* - WRITE: Can push updates and modify the document
|
|
569
|
+
* - ADMIN: Can manage document permissions and settings
|
|
570
|
+
*/
|
|
571
|
+
export type DocumentPermissionLevel = "READ" | "WRITE" | "ADMIN";
|
|
572
|
+
/**
|
|
573
|
+
* Database schema for document permissions
|
|
574
|
+
*/
|
|
575
|
+
export interface DocumentProtectionTable {
|
|
576
|
+
documentId: string;
|
|
577
|
+
protected: boolean;
|
|
578
|
+
ownerAddress: string | null;
|
|
579
|
+
createdAt: Date;
|
|
580
|
+
updatedAt: Date;
|
|
581
|
+
}
|
|
582
|
+
export interface DocumentPermissionDatabase {
|
|
583
|
+
DocumentPermission: DocumentPermissionTable;
|
|
584
|
+
OperationUserPermission: OperationUserPermissionTable;
|
|
585
|
+
DocumentProtection: DocumentProtectionTable;
|
|
586
|
+
}
|
|
587
|
+
export interface DocumentPermissionTable {
|
|
588
|
+
id: Generated<number>;
|
|
589
|
+
documentId: string;
|
|
590
|
+
userAddress: string;
|
|
591
|
+
permission: DocumentPermissionLevel;
|
|
592
|
+
grantedBy: string;
|
|
593
|
+
createdAt: Date;
|
|
594
|
+
updatedAt: Date;
|
|
595
|
+
}
|
|
596
|
+
export interface OperationUserPermissionTable {
|
|
597
|
+
id: Generated<number>;
|
|
598
|
+
documentId: string;
|
|
599
|
+
operationType: string;
|
|
600
|
+
userAddress: string;
|
|
601
|
+
grantedBy: string;
|
|
602
|
+
createdAt: Date;
|
|
603
|
+
}
|
|
604
|
+
type Db = Kysely<any>;
|
|
605
|
+
export declare function isPostgresConnectionString(connectionString: string): boolean;
|
|
606
|
+
/**
|
|
607
|
+
* Optional factory used by callers (e.g. Switchboard) to inject a
|
|
608
|
+
* version-specific PGLite instance — e.g. `pglite-legacy-02` when an existing
|
|
609
|
+
* data dir was created with an older PG major, or a worker-backed
|
|
610
|
+
* `ThreadedPGlite`. Anything meeting {@link PGliteLike} works.
|
|
611
|
+
*/
|
|
612
|
+
export type PgliteFactory = (connectionString: string | undefined) => PGliteLike;
|
|
613
|
+
export interface DbClient {
|
|
614
|
+
db: Db;
|
|
615
|
+
knex: Knex;
|
|
616
|
+
pglite: PGliteLike | undefined;
|
|
617
|
+
}
|
|
618
|
+
export declare function getDbClient(connectionString?: string | undefined, pgliteFactory?: PgliteFactory): DbClient;
|
|
619
|
+
export declare const initAnalyticsStoreSql: string[];
|
|
620
|
+
//#endregion
|
|
621
|
+
//#region src/services/permission-cache.d.ts
|
|
622
|
+
/**
|
|
623
|
+
* Everything an authorization decision reads about one document: its
|
|
624
|
+
* protection flag (the configured default when it has no protection row), its
|
|
625
|
+
* owner, the users' grant levels and the users granted each operation.
|
|
626
|
+
* Addresses are stored lowercase, as the permission service writes them.
|
|
627
|
+
*/
|
|
628
|
+
export declare class DocumentPermissionSnapshot {
|
|
629
|
+
readonly documentId: string;
|
|
630
|
+
readonly isProtected: boolean;
|
|
631
|
+
readonly ownerAddress: string | null;
|
|
632
|
+
readonly grants: ReadonlyMap<string, DocumentPermissionLevel>;
|
|
633
|
+
readonly operationGrants: ReadonlyMap<string, ReadonlySet<string>>;
|
|
634
|
+
constructor(documentId: string, isProtected: boolean, ownerAddress: string | null, grants: ReadonlyMap<string, DocumentPermissionLevel>, operationGrants: ReadonlyMap<string, ReadonlySet<string>>);
|
|
635
|
+
grantLevel(userAddress: string): DocumentPermissionLevel | null;
|
|
636
|
+
isOperationRestricted(operationType: string): boolean;
|
|
637
|
+
hasOperationGrant(operationType: string, userAddress: string): boolean;
|
|
638
|
+
}
|
|
639
|
+
/** Loads the snapshots of the given documents; every id gets one. */
|
|
640
|
+
export type PermissionSnapshotLoader = (documentIds: string[]) => Promise<Map<string, DocumentPermissionSnapshot>>;
|
|
641
|
+
export interface PermissionCacheOptions {
|
|
642
|
+
/** How long an entry is served without reloading; 0 disables caching. */
|
|
643
|
+
ttlMs: number;
|
|
644
|
+
/** Entries kept before the least recently used one is dropped. */
|
|
645
|
+
maxEntries: number;
|
|
646
|
+
now: () => number;
|
|
647
|
+
}
|
|
648
|
+
export declare const DEFAULT_PERMISSION_CACHE_TTL_MS = 30000;
|
|
649
|
+
export declare const DEFAULT_PERMISSION_CACHE_OPTIONS: PermissionCacheOptions;
|
|
650
|
+
/**
|
|
651
|
+
* Per-process cache of document permission snapshots, keyed by document id.
|
|
652
|
+
*
|
|
653
|
+
* Filled on miss from the store, invalidated by the permission service after
|
|
654
|
+
* each of its own writes, and expired after `ttlMs` as the safety net for
|
|
655
|
+
* writes made by another process (another switchboard instance on the same
|
|
656
|
+
* database) until cross-instance invalidation exists.
|
|
657
|
+
*
|
|
658
|
+
* A load that overlaps an invalidation still answers its caller but is not
|
|
659
|
+
* stored, so a read that started before a write commits cannot repopulate
|
|
660
|
+
* the cache with the pre-write rows.
|
|
661
|
+
*/
|
|
662
|
+
export declare class PermissionCache {
|
|
663
|
+
#private;
|
|
664
|
+
constructor(load: PermissionSnapshotLoader, options?: PermissionCacheOptions);
|
|
665
|
+
get size(): number;
|
|
666
|
+
get(documentId: string): Promise<DocumentPermissionSnapshot>;
|
|
667
|
+
/** Snapshots for every id, loading the missing and expired ones in one batch. */
|
|
668
|
+
getMany(documentIds: string[]): Promise<Map<string, DocumentPermissionSnapshot>>;
|
|
669
|
+
invalidate(documentId: string): void;
|
|
670
|
+
clear(): void;
|
|
671
|
+
}
|
|
672
|
+
//#endregion
|
|
673
|
+
//#region src/services/document-permission.service.d.ts
|
|
674
|
+
export interface DocumentPermissionEntry {
|
|
675
|
+
documentId: string;
|
|
676
|
+
userAddress: string;
|
|
677
|
+
permission: DocumentPermissionLevel;
|
|
678
|
+
grantedBy: string;
|
|
679
|
+
createdAt: Date;
|
|
680
|
+
updatedAt: Date;
|
|
681
|
+
}
|
|
682
|
+
export interface OperationUserPermissionEntry {
|
|
683
|
+
documentId: string;
|
|
684
|
+
operationType: string;
|
|
685
|
+
userAddress: string;
|
|
686
|
+
grantedBy: string;
|
|
687
|
+
createdAt: Date;
|
|
688
|
+
}
|
|
689
|
+
/**
|
|
690
|
+
* Function type for getting parent document IDs
|
|
691
|
+
* This is injected to avoid circular dependencies with the reactor client
|
|
692
|
+
*/
|
|
693
|
+
export type GetParentIdsFn = (documentId: string) => Promise<string[]>;
|
|
694
|
+
/**
|
|
695
|
+
* Configuration for the DocumentPermissionService
|
|
696
|
+
*/
|
|
697
|
+
export interface DocumentPermissionConfig {
|
|
698
|
+
defaultProtection: boolean;
|
|
699
|
+
}
|
|
700
|
+
/**
|
|
701
|
+
* Service for managing document-level permissions.
|
|
702
|
+
*
|
|
703
|
+
* Permission levels for documents:
|
|
704
|
+
* - READ: Can fetch and read the document
|
|
705
|
+
* - WRITE: Can push updates and modify the document
|
|
706
|
+
* - ADMIN: Can manage document permissions and settings
|
|
707
|
+
*
|
|
708
|
+
* Operation permissions:
|
|
709
|
+
* - Users can be granted permission to execute specific operations
|
|
710
|
+
*/
|
|
711
|
+
export declare class DocumentPermissionService {
|
|
712
|
+
private readonly db;
|
|
713
|
+
readonly config: DocumentPermissionConfig;
|
|
714
|
+
/**
|
|
715
|
+
* Serves the reads authorization decisions make (protection, owner, grant
|
|
716
|
+
* level, operation grants). Every write through this service invalidates
|
|
717
|
+
* the document it touched.
|
|
718
|
+
*/
|
|
719
|
+
readonly permissionCache: PermissionCache;
|
|
720
|
+
constructor(db: Kysely<DocumentPermissionDatabase>, config?: DocumentPermissionConfig, cacheOptions?: PermissionCacheOptions);
|
|
721
|
+
/**
|
|
722
|
+
* Get the permission level for a user on a specific document.
|
|
723
|
+
* Returns null if no permission is set.
|
|
724
|
+
*/
|
|
725
|
+
getUserPermission(documentId: string, userAddress: string): Promise<DocumentPermissionLevel | null>;
|
|
726
|
+
/**
|
|
727
|
+
* Get all permissions for a document
|
|
728
|
+
*/
|
|
729
|
+
getDocumentPermissions(documentId: string): Promise<DocumentPermissionEntry[]>;
|
|
730
|
+
/**
|
|
731
|
+
* Get all documents a user has explicit access to
|
|
732
|
+
*/
|
|
733
|
+
getUserDocuments(userAddress: string): Promise<DocumentPermissionEntry[]>;
|
|
734
|
+
/**
|
|
735
|
+
* Grant or update a user's permission on a document.
|
|
736
|
+
*/
|
|
737
|
+
grantPermission(documentId: string, userAddress: string, permission: DocumentPermissionLevel, grantedBy: string): Promise<DocumentPermissionEntry>;
|
|
738
|
+
/**
|
|
739
|
+
* Revoke a user's permission on a document
|
|
740
|
+
*/
|
|
741
|
+
revokePermission(documentId: string, userAddress: string): Promise<void>;
|
|
742
|
+
/**
|
|
743
|
+
* Delete all permissions for a document (used when deleting a document)
|
|
744
|
+
*/
|
|
745
|
+
deleteAllDocumentPermissions(documentId: string): Promise<{
|
|
746
|
+
DocumentPermission: number;
|
|
747
|
+
OperationUserPermission: number;
|
|
748
|
+
}>;
|
|
749
|
+
/** Delete a document's protection row, which names its owner. */
|
|
750
|
+
deleteDocumentProtection(documentId: string): Promise<number>;
|
|
751
|
+
/** Every row that names the address, for a subject access request. */
|
|
752
|
+
rowsForAddress(address: string): Promise<{
|
|
753
|
+
permissions: DocumentPermissionEntry[];
|
|
754
|
+
operationPermissions: OperationUserPermissionEntry[];
|
|
755
|
+
ownedDocumentIds: string[];
|
|
756
|
+
}>;
|
|
757
|
+
/**
|
|
758
|
+
* Grant a user permission to execute an operation on a document
|
|
759
|
+
*/
|
|
760
|
+
grantOperationPermission(documentId: string, operationType: string, userAddress: string, grantedBy: string): Promise<OperationUserPermissionEntry>;
|
|
761
|
+
/**
|
|
762
|
+
* Revoke a user's permission to execute an operation
|
|
763
|
+
*/
|
|
764
|
+
revokeOperationPermission(documentId: string, operationType: string, userAddress: string): Promise<void>;
|
|
765
|
+
/**
|
|
766
|
+
* Get all users with permission to execute an operation
|
|
767
|
+
*/
|
|
768
|
+
getOperationUserPermissions(documentId: string, operationType: string): Promise<OperationUserPermissionEntry[]>;
|
|
769
|
+
/**
|
|
770
|
+
* Whether an operation-permission row exists for the user on this operation.
|
|
771
|
+
*/
|
|
772
|
+
hasOperationGrant(documentId: string, operationType: string, userAddress: string): Promise<boolean>;
|
|
773
|
+
/**
|
|
774
|
+
* Check if an operation has any permissions set (is restricted)
|
|
775
|
+
*/
|
|
776
|
+
isOperationRestricted(documentId: string, operationType: string): Promise<boolean>;
|
|
777
|
+
/**
|
|
778
|
+
* Check if a specific document has a protection row set to true.
|
|
779
|
+
* Falls back to `config.defaultProtection` if no row exists.
|
|
780
|
+
*/
|
|
781
|
+
isDocumentProtected(documentId: string): Promise<boolean>;
|
|
782
|
+
/**
|
|
783
|
+
* Walk the parent chain: if the document itself or any ancestor is protected, return true.
|
|
784
|
+
* Collects all ancestor IDs first (with cycle detection), then batch-checks protection.
|
|
785
|
+
*/
|
|
786
|
+
isProtectedWithAncestors(documentId: string, getParentIds: GetParentIdsFn): Promise<boolean>;
|
|
787
|
+
/**
|
|
788
|
+
* Reads the permission rows of the given documents from the store, three
|
|
789
|
+
* queries for the whole batch. The permission cache's loader.
|
|
790
|
+
*/
|
|
791
|
+
loadPermissionSnapshots(documentIds: string[]): Promise<Map<string, DocumentPermissionSnapshot>>;
|
|
792
|
+
/**
|
|
793
|
+
* Collect all ancestor IDs (including the document itself) with cycle detection.
|
|
794
|
+
*/
|
|
795
|
+
private collectAncestorIds;
|
|
796
|
+
/**
|
|
797
|
+
* Upsert protection status for a document.
|
|
798
|
+
*/
|
|
799
|
+
setDocumentProtection(documentId: string, isProtected: boolean): Promise<void>;
|
|
800
|
+
/**
|
|
801
|
+
* Get the owner address for a document, or null if not set.
|
|
802
|
+
*/
|
|
803
|
+
getDocumentOwner(documentId: string): Promise<string | null>;
|
|
804
|
+
/**
|
|
805
|
+
* Upsert owner address for a document.
|
|
806
|
+
*/
|
|
807
|
+
setDocumentOwner(documentId: string, ownerAddress: string): Promise<void>;
|
|
808
|
+
/**
|
|
809
|
+
* Initialize protection for a newly created document.
|
|
810
|
+
* Sets protection status and grants ADMIN to the owner.
|
|
811
|
+
*/
|
|
812
|
+
initializeDocumentProtection(documentId: string, ownerAddress: string, defaultProtection?: boolean): Promise<void>;
|
|
813
|
+
/**
|
|
814
|
+
* Get the full protection info for a document.
|
|
815
|
+
*/
|
|
816
|
+
getDocumentProtection(documentId: string): Promise<{
|
|
817
|
+
documentId: string;
|
|
818
|
+
protected: boolean;
|
|
819
|
+
ownerAddress: string | null;
|
|
820
|
+
}>;
|
|
821
|
+
}
|
|
822
|
+
//#endregion
|
|
823
|
+
//#region src/services/authorization.service.d.ts
|
|
824
|
+
/**
|
|
825
|
+
* A document id that has been resolved to its canonical form, never a slug.
|
|
840
826
|
*
|
|
841
|
-
*
|
|
842
|
-
*
|
|
843
|
-
*
|
|
844
|
-
*
|
|
827
|
+
* Protection and grant rows are written under the canonical id, while the
|
|
828
|
+
* read/operation data paths accept an id-or-slug identifier. The decision layer
|
|
829
|
+
* must key on the canonical id, so branding it forces every caller to resolve a
|
|
830
|
+
* slug to its id before consulting this service, closing the slug-aliasing
|
|
831
|
+
* bypass (S-C1). The only sanctioned cast from string to CanonicalDocumentId
|
|
832
|
+
* lives in createCanonicalDocumentIdResolver, immediately after the shared
|
|
833
|
+
* resolveIdOrSlug lookup returns.
|
|
845
834
|
*/
|
|
846
|
-
|
|
847
|
-
|
|
848
|
-
//#region src/http/webhook-verify.d.ts
|
|
849
|
-
type VerifyResult = {
|
|
850
|
-
ok: true;
|
|
851
|
-
} | {
|
|
852
|
-
ok: false;
|
|
853
|
-
reason: string;
|
|
835
|
+
type CanonicalDocumentId = string & {
|
|
836
|
+
readonly __canonicalDocumentId: unique symbol;
|
|
854
837
|
};
|
|
855
|
-
/** Verifies a delivery against the configured scheme; `raw` must be the exact bytes
|
|
856
|
-
* received. The reason is for the log only: callers answer a fixed 401, so a probing sender learns nothing from the body. */
|
|
857
|
-
export declare function verifyWebhook(options: {
|
|
858
|
-
verification: WebhookVerification;
|
|
859
|
-
headers: Record<string, string>;
|
|
860
|
-
raw: Buffer;
|
|
861
|
-
now?: Date;
|
|
862
|
-
}): VerifyResult;
|
|
863
|
-
export declare function redactHeaders(headers: Record<string, string>, extra?: string): Record<string, string>;
|
|
864
|
-
/** JSON and form bodies become objects; anything else stays decoded text, so a verified
|
|
865
|
-
* XML or CSV payload is still reachable downstream. */
|
|
866
|
-
export declare function parseWebhookBody(raw: Buffer, contentType?: string): unknown;
|
|
867
|
-
//#endregion
|
|
868
|
-
//#region src/http/request-load.d.ts
|
|
869
838
|
/**
|
|
870
|
-
*
|
|
871
|
-
*
|
|
839
|
+
* Result of a passed per-document authorization check. `fetchIdentifier` is
|
|
840
|
+
* always safe for the data fetch: the canonical id when resolved, or the raw
|
|
841
|
+
* identifier when the check was skipped for a policy-wide caller.
|
|
872
842
|
*/
|
|
873
|
-
export declare
|
|
874
|
-
|
|
875
|
-
|
|
876
|
-
|
|
877
|
-
|
|
878
|
-
|
|
879
|
-
|
|
880
|
-
|
|
881
|
-
export declare class NodeEventLoopDelay implements IEventLoopDelaySource {
|
|
882
|
-
private readonly histogram;
|
|
883
|
-
constructor(resolutionMs?: number);
|
|
884
|
-
takeP99Ms(): number;
|
|
885
|
-
stop(): void;
|
|
843
|
+
export declare class AuthorizedDocumentHandle {
|
|
844
|
+
readonly fetchIdentifier: string;
|
|
845
|
+
readonly isResolved: boolean;
|
|
846
|
+
private constructor();
|
|
847
|
+
static resolved(documentId: CanonicalDocumentId): AuthorizedDocumentHandle;
|
|
848
|
+
static skipped(identifier: string): AuthorizedDocumentHandle;
|
|
849
|
+
/** The verified canonical id; throws when resolution was skipped. */
|
|
850
|
+
canonicalId(): CanonicalDocumentId;
|
|
886
851
|
}
|
|
887
|
-
|
|
888
|
-
|
|
889
|
-
|
|
890
|
-
|
|
852
|
+
export declare const AuthorizationPolicy: {
|
|
853
|
+
readonly OPEN: "OPEN";
|
|
854
|
+
readonly ADMIN_ONLY: "ADMIN_ONLY";
|
|
855
|
+
readonly DOCUMENT_PERMISSIONS: "DOCUMENT_PERMISSIONS";
|
|
891
856
|
};
|
|
857
|
+
export type AuthorizationPolicy = (typeof AuthorizationPolicy)[keyof typeof AuthorizationPolicy];
|
|
858
|
+
interface AuthorizationConfig {
|
|
859
|
+
admins: string[];
|
|
860
|
+
defaultProtection: boolean;
|
|
861
|
+
policy: AuthorizationPolicy;
|
|
862
|
+
}
|
|
892
863
|
/**
|
|
893
|
-
*
|
|
894
|
-
*
|
|
895
|
-
*
|
|
864
|
+
* Single source of truth for every permission decision. Always present (never
|
|
865
|
+
* null) so callers branch on data, not on the existence of a service.
|
|
866
|
+
*
|
|
867
|
+
* The policy selects an implementation once at boot:
|
|
868
|
+
* - OPEN: authentication disabled — everyone (incl. anonymous) is allowed.
|
|
869
|
+
* - ADMIN_ONLY: authentication on, document permissions off — only ADMINS.
|
|
870
|
+
* - DOCUMENT_PERMISSIONS: the full per-document protection + grant model.
|
|
871
|
+
*
|
|
872
|
+
* Permission inheritance walks the parent-document hierarchy through a
|
|
873
|
+
* parent resolver injected at construction; callers never supply one.
|
|
896
874
|
*/
|
|
897
|
-
|
|
898
|
-
|
|
899
|
-
|
|
900
|
-
|
|
901
|
-
|
|
902
|
-
|
|
903
|
-
|
|
904
|
-
|
|
905
|
-
|
|
906
|
-
/**
|
|
907
|
-
|
|
908
|
-
|
|
909
|
-
|
|
910
|
-
|
|
875
|
+
interface IAuthorizationService {
|
|
876
|
+
readonly config: AuthorizationConfig;
|
|
877
|
+
/**
|
|
878
|
+
* Whether the user has unrestricted, policy-wide access. Under OPEN this is
|
|
879
|
+
* true for everyone (including anonymous callers) by design: OPEN means "no
|
|
880
|
+
* restrictions", and consumers use this check to skip per-document
|
|
881
|
+
* filtering. It does NOT mean the caller is in the ADMINS list.
|
|
882
|
+
*/
|
|
883
|
+
isSupremeAdmin(userAddress?: string): boolean;
|
|
884
|
+
/**
|
|
885
|
+
* Whether the user may create new documents under the current policy:
|
|
886
|
+
* everyone in OPEN, only admins in ADMIN_ONLY, any authenticated user in
|
|
887
|
+
* DOCUMENT_PERMISSIONS.
|
|
888
|
+
*/
|
|
889
|
+
canCreate(userAddress?: string): boolean;
|
|
890
|
+
canRead(documentId: CanonicalDocumentId, userAddress?: string): Promise<boolean>;
|
|
891
|
+
canWrite(documentId: CanonicalDocumentId, userAddress?: string): Promise<boolean>;
|
|
892
|
+
/**
|
|
893
|
+
* Whether the user administers the document: supreme admin, document
|
|
894
|
+
* owner, or holder of an ADMIN grant.
|
|
895
|
+
*/
|
|
896
|
+
canManage(documentId: CanonicalDocumentId, userAddress?: string): Promise<boolean>;
|
|
897
|
+
canMutate(documentId: CanonicalDocumentId, operationType: string, userAddress?: string): Promise<boolean>;
|
|
911
898
|
}
|
|
912
899
|
//#endregion
|
|
913
900
|
//#region src/services/canonical-document-id.d.ts
|
|
@@ -1098,6 +1085,143 @@ export declare class AttachmentClientProvider implements IAttachmentClientProvid
|
|
|
1098
1085
|
forSubject(subject: AuthSubject): IAttachmentClient;
|
|
1099
1086
|
}
|
|
1100
1087
|
//#endregion
|
|
1088
|
+
//#region src/graphql/request-clients.d.ts
|
|
1089
|
+
/**
|
|
1090
|
+
* The reactor client halves a resolver may use, carried on the GraphQL
|
|
1091
|
+
* context as `ctx.clients`.
|
|
1092
|
+
*/
|
|
1093
|
+
interface RequestClients {
|
|
1094
|
+
/** Answers from read models; always present. */
|
|
1095
|
+
readonly read: IReactorReadClient;
|
|
1096
|
+
/**
|
|
1097
|
+
* Enqueues writes. Present while a mutation executes; reading it in a query
|
|
1098
|
+
* or a subscription throws {@link WriteClientUnavailableError}.
|
|
1099
|
+
*/
|
|
1100
|
+
readonly write: IReactorWriteClient;
|
|
1101
|
+
}
|
|
1102
|
+
//#endregion
|
|
1103
|
+
//#region src/graphql/base-subgraph.d.ts
|
|
1104
|
+
/**
|
|
1105
|
+
* The subject a request reads as: its address and the app key its token
|
|
1106
|
+
* carries. Anonymous is an empty subject, never the host's signer.
|
|
1107
|
+
*/
|
|
1108
|
+
export declare function callerSubject(user: Context["user"]): AuthSubject;
|
|
1109
|
+
export declare class BaseSubgraph implements ISubgraph$1 {
|
|
1110
|
+
#private;
|
|
1111
|
+
name: string;
|
|
1112
|
+
path: string;
|
|
1113
|
+
resolvers: Record<string, any>;
|
|
1114
|
+
typeDefs: DocumentNode;
|
|
1115
|
+
/**
|
|
1116
|
+
* The read half, for setup-time use (schema building, model lookup).
|
|
1117
|
+
* Resolvers read through `ctx.clients.read` instead.
|
|
1118
|
+
*/
|
|
1119
|
+
readonly readClient: IReactorReadClient;
|
|
1120
|
+
/**
|
|
1121
|
+
* @deprecated The facade over both halves, for subgraphs that have not
|
|
1122
|
+
* moved. Resolvers use `ctx.clients.read` and, in a mutation,
|
|
1123
|
+
* `ctx.clients.write`; setup-time code uses {@link readClient}.
|
|
1124
|
+
*/
|
|
1125
|
+
reactorClient: IReactorClient;
|
|
1126
|
+
/** This package's namespaced slice of the HTTP surface. */
|
|
1127
|
+
readonly http: SubgraphArgs$1["http"];
|
|
1128
|
+
graphqlManager: GraphQLManager$1;
|
|
1129
|
+
relationalDb: IRelationalDb;
|
|
1130
|
+
syncManager: ISyncManager;
|
|
1131
|
+
documentPermissionService?: DocumentPermissionService;
|
|
1132
|
+
authorizationService: IAuthorizationService;
|
|
1133
|
+
syncServingGate?: SyncScopeGate;
|
|
1134
|
+
/**
|
|
1135
|
+
* The host's credential cache, for a package that revokes credentials:
|
|
1136
|
+
* call `this.credentials.invalidateCredential(address, chainId?, appDid?)`
|
|
1137
|
+
* right after the revocation is stored, so this host refuses the credential
|
|
1138
|
+
* on the next request and closes WebSocket connections that rely on it.
|
|
1139
|
+
* A no-op on a host without authentication.
|
|
1140
|
+
*/
|
|
1141
|
+
readonly credentials: ICredentialInvalidator;
|
|
1142
|
+
constructor(args: SubgraphArgs$1);
|
|
1143
|
+
/**
|
|
1144
|
+
* An attachment client bound to this request's caller, memoized per request.
|
|
1145
|
+
*
|
|
1146
|
+
* @throws Error when the host provides no attachment client to subgraphs.
|
|
1147
|
+
*/
|
|
1148
|
+
attachmentsFor(ctx: Context): IAttachmentClient;
|
|
1149
|
+
/**
|
|
1150
|
+
* The clients this request's operation may use: those the GraphQL layer put
|
|
1151
|
+
* on the context. A context it never saw (a resolver called directly) reads
|
|
1152
|
+
* through {@link readClient} and may not write.
|
|
1153
|
+
*/
|
|
1154
|
+
clientsOf(ctx: Context | undefined): RequestClients;
|
|
1155
|
+
onSetup(): Promise<void>;
|
|
1156
|
+
onDisconnect(): Promise<void>;
|
|
1157
|
+
/**
|
|
1158
|
+
* Resolves a caller-supplied identifier (id or slug) to its canonical
|
|
1159
|
+
* document id, memoized per request. Both the decision layer and the data
|
|
1160
|
+
* layer must agree on the subject, so this runs the lookup the data path
|
|
1161
|
+
* uses: `resolveIdOrSlug` on the read half for a query, `describe` on the
|
|
1162
|
+
* write half for a mutation. A resolution failure (not found, ambiguous, or
|
|
1163
|
+
* transient) surfaces as a generic Forbidden, fail-closed, so a bad
|
|
1164
|
+
* identifier cannot be used as a document-existence oracle.
|
|
1165
|
+
*/
|
|
1166
|
+
resolveCanonicalDocumentId(identifier: string, requestKey: object): Promise<CanonicalDocumentId>;
|
|
1167
|
+
/**
|
|
1168
|
+
* Resolves the args' `documentId` to canonical form. Unconditional (unlike the
|
|
1169
|
+
* assertCan* helpers, no admin skip): ACL rows are keyed on the canonical id.
|
|
1170
|
+
*/
|
|
1171
|
+
withCanonicalDocumentId<T extends {
|
|
1172
|
+
documentId: string;
|
|
1173
|
+
}>(args: T, requestKey: object): Promise<T & {
|
|
1174
|
+
documentId: CanonicalDocumentId;
|
|
1175
|
+
}>;
|
|
1176
|
+
/**
|
|
1177
|
+
* Read filter for an already-canonical document id (one sourced from the data
|
|
1178
|
+
* layer, such as a fetched document's id). Performs no slug resolution.
|
|
1179
|
+
*/
|
|
1180
|
+
canReadDocument(documentId: CanonicalDocumentId, ctx: Context): Promise<boolean>;
|
|
1181
|
+
/** The ids or slugs in `ids` that {@link assertCanRead} admits, in order; the rest are dropped. */
|
|
1182
|
+
filterReadableDocumentIds(ids: readonly string[], ctx: Context): Promise<string[]>;
|
|
1183
|
+
/** Drops the items the host's own ACL refuses the caller. */
|
|
1184
|
+
readableByHost<T extends {
|
|
1185
|
+
id: string;
|
|
1186
|
+
}>(items: readonly T[], ctx: Context): Promise<T[]>;
|
|
1187
|
+
/**
|
|
1188
|
+
* The principal a request decides as: the authenticated caller's address, and
|
|
1189
|
+
* the did:key of the app instance whose token authenticated it.
|
|
1190
|
+
*
|
|
1191
|
+
* Both, because a policy can name either. The key is what a document records
|
|
1192
|
+
* as its creator, so a subject built without one cannot match the creator's
|
|
1193
|
+
* standing permission over the auth scope -- the document's own creator would
|
|
1194
|
+
* be refused an operation the write path accepts, since a signed action
|
|
1195
|
+
* carries the same key. Anonymous callers supply neither.
|
|
1196
|
+
*/
|
|
1197
|
+
protected viewSubject(ctx: Context): AuthSubject;
|
|
1198
|
+
/** Whether a listing would serve the document to the caller; fails closed. */
|
|
1199
|
+
protected servesDocument(documentId: string, ctx: Context): Promise<boolean>;
|
|
1200
|
+
/** {@link servesDocument}, but a reactor that cannot answer throws. */
|
|
1201
|
+
protected servesDocumentOrThrows(identifier: string, ctx: Context, view?: Pick<ViewFilter, "branch" | "scopes">): Promise<boolean>;
|
|
1202
|
+
/**
|
|
1203
|
+
* Whether a listing would serve the document to the caller: the reactor read
|
|
1204
|
+
* gate, then the host's legacy layer, as `findDocuments` applies them. Absent
|
|
1205
|
+
* or withheld is `false`; a failure to decide throws.
|
|
1206
|
+
*/
|
|
1207
|
+
protected listsDocument(identifier: string, ctx: Context, view?: Pick<ViewFilter, "branch" | "scopes">): Promise<boolean>;
|
|
1208
|
+
/**
|
|
1209
|
+
* Asserts read access, resolving a slug first. Returns a handle whose
|
|
1210
|
+
* `fetchIdentifier` the caller reuses for the data fetch; a denial throws.
|
|
1211
|
+
*/
|
|
1212
|
+
assertCanRead(identifier: string, ctx: Context): Promise<AuthorizedDocumentHandle>;
|
|
1213
|
+
assertCanWrite(identifier: string, ctx: Context): Promise<AuthorizedDocumentHandle>;
|
|
1214
|
+
assertCanExecuteOperation(identifier: string, operationType: string, ctx: Context): Promise<AuthorizedDocumentHandle>;
|
|
1215
|
+
/**
|
|
1216
|
+
* Read assertion for an already-canonical document id. No slug resolution;
|
|
1217
|
+
* use only with ids sourced from the data layer or already resolved.
|
|
1218
|
+
*/
|
|
1219
|
+
assertCanReadCanonical(documentId: CanonicalDocumentId, ctx: Context): Promise<void>;
|
|
1220
|
+
assertCanWriteCanonical(documentId: CanonicalDocumentId, ctx: Context): Promise<void>;
|
|
1221
|
+
assertCanExecuteOperationCanonical(documentId: CanonicalDocumentId, operationType: string, ctx: Context): Promise<void>;
|
|
1222
|
+
assertCanCreate(ctx: Context): void;
|
|
1223
|
+
}
|
|
1224
|
+
//#endregion
|
|
1101
1225
|
//#region src/graphql/inspection/throttle.d.ts
|
|
1102
1226
|
type InspectionThrottleConfig = {
|
|
1103
1227
|
/** Per caller, also the burst; admins exempt (PH_INSPECTION_CALLS_PER_MINUTE). */
|
|
@@ -1296,125 +1420,53 @@ export type GqlDriveDocument = GqlDocument & {
|
|
|
1296
1420
|
initialState: DocumentDriveGlobalState;
|
|
1297
1421
|
};
|
|
1298
1422
|
//#endregion
|
|
1299
|
-
//#region src/graphql/
|
|
1300
|
-
|
|
1301
|
-
|
|
1302
|
-
|
|
1303
|
-
|
|
1304
|
-
|
|
1305
|
-
|
|
1306
|
-
|
|
1307
|
-
|
|
1308
|
-
|
|
1309
|
-
|
|
1310
|
-
|
|
1311
|
-
|
|
1312
|
-
|
|
1313
|
-
|
|
1314
|
-
|
|
1315
|
-
|
|
1316
|
-
|
|
1317
|
-
|
|
1318
|
-
|
|
1319
|
-
|
|
1320
|
-
|
|
1321
|
-
|
|
1322
|
-
|
|
1323
|
-
|
|
1324
|
-
|
|
1325
|
-
|
|
1326
|
-
|
|
1327
|
-
|
|
1328
|
-
|
|
1329
|
-
|
|
1330
|
-
|
|
1331
|
-
|
|
1332
|
-
|
|
1333
|
-
|
|
1334
|
-
|
|
1335
|
-
|
|
1336
|
-
|
|
1337
|
-
|
|
1338
|
-
|
|
1339
|
-
|
|
1340
|
-
|
|
1341
|
-
|
|
1342
|
-
|
|
1343
|
-
|
|
1344
|
-
|
|
1345
|
-
|
|
1346
|
-
* The clients this request's operation may use: those the GraphQL layer put
|
|
1347
|
-
* on the context. A context it never saw (a resolver called directly) reads
|
|
1348
|
-
* through {@link readClient} and may not write.
|
|
1349
|
-
*/
|
|
1350
|
-
clientsOf(ctx: Context | undefined): RequestClients;
|
|
1351
|
-
onSetup(): Promise<void>;
|
|
1352
|
-
onDisconnect(): Promise<void>;
|
|
1353
|
-
/**
|
|
1354
|
-
* Resolves a caller-supplied identifier (id or slug) to its canonical
|
|
1355
|
-
* document id, memoized per request. Both the decision layer and the data
|
|
1356
|
-
* layer must agree on the subject, so this runs the lookup the data path
|
|
1357
|
-
* uses: `resolveIdOrSlug` on the read half for a query, `describe` on the
|
|
1358
|
-
* write half for a mutation. A resolution failure (not found, ambiguous, or
|
|
1359
|
-
* transient) surfaces as a generic Forbidden, fail-closed, so a bad
|
|
1360
|
-
* identifier cannot be used as a document-existence oracle.
|
|
1361
|
-
*/
|
|
1362
|
-
resolveCanonicalDocumentId(identifier: string, requestKey: object): Promise<CanonicalDocumentId>;
|
|
1363
|
-
/**
|
|
1364
|
-
* Resolves the args' `documentId` to canonical form. Unconditional (unlike the
|
|
1365
|
-
* assertCan* helpers, no admin skip): ACL rows are keyed on the canonical id.
|
|
1366
|
-
*/
|
|
1367
|
-
withCanonicalDocumentId<T extends {
|
|
1368
|
-
documentId: string;
|
|
1369
|
-
}>(args: T, requestKey: object): Promise<T & {
|
|
1370
|
-
documentId: CanonicalDocumentId;
|
|
1371
|
-
}>;
|
|
1372
|
-
/**
|
|
1373
|
-
* Read filter for an already-canonical document id (one sourced from the data
|
|
1374
|
-
* layer, such as a fetched document's id). Performs no slug resolution.
|
|
1375
|
-
*/
|
|
1376
|
-
canReadDocument(documentId: CanonicalDocumentId, ctx: Context): Promise<boolean>;
|
|
1377
|
-
/** Drops the items the host's own ACL refuses the caller. */
|
|
1378
|
-
readableByHost<T extends {
|
|
1379
|
-
id: string;
|
|
1380
|
-
}>(items: readonly T[], ctx: Context): Promise<T[]>;
|
|
1381
|
-
/**
|
|
1382
|
-
* The principal a request decides as: the authenticated caller's address, and
|
|
1383
|
-
* the did:key of the app instance whose token authenticated it.
|
|
1384
|
-
*
|
|
1385
|
-
* Both, because a policy can name either. The key is what a document records
|
|
1386
|
-
* as its creator, so a subject built without one cannot match the creator's
|
|
1387
|
-
* standing permission over the auth scope -- the document's own creator would
|
|
1388
|
-
* be refused an operation the write path accepts, since a signed action
|
|
1389
|
-
* carries the same key. Anonymous callers supply neither.
|
|
1390
|
-
*/
|
|
1391
|
-
protected viewSubject(ctx: Context): AuthSubject;
|
|
1392
|
-
/** Whether a listing would serve the document to the caller; fails closed. */
|
|
1393
|
-
protected servesDocument(documentId: string, ctx: Context): Promise<boolean>;
|
|
1394
|
-
/** {@link servesDocument}, but a reactor that cannot answer throws. */
|
|
1395
|
-
protected servesDocumentOrThrows(identifier: string, ctx: Context, view?: Pick<ViewFilter, "branch" | "scopes">): Promise<boolean>;
|
|
1396
|
-
/**
|
|
1397
|
-
* Whether a listing would serve the document to the caller: the reactor read
|
|
1398
|
-
* gate, then the host's legacy layer, as `findDocuments` applies them. Absent
|
|
1399
|
-
* or withheld is `false`; a failure to decide throws.
|
|
1400
|
-
*/
|
|
1401
|
-
protected listsDocument(identifier: string, ctx: Context, view?: Pick<ViewFilter, "branch" | "scopes">): Promise<boolean>;
|
|
1402
|
-
/**
|
|
1403
|
-
* Asserts read access, resolving a slug first. Returns a handle whose
|
|
1404
|
-
* `fetchIdentifier` the caller reuses for the data fetch; a denial throws.
|
|
1405
|
-
*/
|
|
1406
|
-
assertCanRead(identifier: string, ctx: Context): Promise<AuthorizedDocumentHandle>;
|
|
1407
|
-
assertCanWrite(identifier: string, ctx: Context): Promise<AuthorizedDocumentHandle>;
|
|
1408
|
-
assertCanExecuteOperation(identifier: string, operationType: string, ctx: Context): Promise<AuthorizedDocumentHandle>;
|
|
1409
|
-
/**
|
|
1410
|
-
* Read assertion for an already-canonical document id. No slug resolution;
|
|
1411
|
-
* use only with ids sourced from the data layer or already resolved.
|
|
1412
|
-
*/
|
|
1413
|
-
assertCanReadCanonical(documentId: CanonicalDocumentId, ctx: Context): Promise<void>;
|
|
1414
|
-
assertCanWriteCanonical(documentId: CanonicalDocumentId, ctx: Context): Promise<void>;
|
|
1415
|
-
assertCanExecuteOperationCanonical(documentId: CanonicalDocumentId, operationType: string, ctx: Context): Promise<void>;
|
|
1416
|
-
assertCanCreate(ctx: Context): void;
|
|
1417
|
-
}
|
|
1423
|
+
//#region src/graphql/gateway/factory.d.ts
|
|
1424
|
+
export type GatewayAdapterType = "apollo" | "mercurius" | "stitching";
|
|
1425
|
+
export type HttpAdapterType = "express" | "fastify";
|
|
1426
|
+
export declare function createGatewayAdapter(type: GatewayAdapterType, logger: ILogger): Promise<IGatewayAdapter<Context>>;
|
|
1427
|
+
export type HttpAdapterSetup = {
|
|
1428
|
+
adapter: IHttpAdapter;
|
|
1429
|
+
};
|
|
1430
|
+
export declare function createHttpAdapter(type: HttpAdapterType): Promise<HttpAdapterSetup>;
|
|
1431
|
+
//#endregion
|
|
1432
|
+
//#region src/api-config.d.ts
|
|
1433
|
+
type Env = Readonly<Record<string, string | undefined>>;
|
|
1434
|
+
/** reactor-api settings env can supply; an unset key means "not configured here". */
|
|
1435
|
+
export type ReactorApiConfig = {
|
|
1436
|
+
server?: {
|
|
1437
|
+
/** Route prefix for GraphQL, the explorer, package routes and webhooks. */
|
|
1438
|
+
basePath?: string;
|
|
1439
|
+
gatewayAdapter?: GatewayAdapterType;
|
|
1440
|
+
/** Origin advertised in webhook URLs; a bare domain gets `https://`. */
|
|
1441
|
+
publicUrl?: string;
|
|
1442
|
+
};
|
|
1443
|
+
auth?: {
|
|
1444
|
+
enabled?: boolean;
|
|
1445
|
+
admins?: string[];
|
|
1446
|
+
resolveIdentity?: boolean;
|
|
1447
|
+
requireAuthenticatedCaller?: boolean;
|
|
1448
|
+
requireAuthenticatedCallerExemptPaths?: string[];
|
|
1449
|
+
attachmentReadsFollowDocumentPolicy?: boolean;
|
|
1450
|
+
defaultProtection?: boolean;
|
|
1451
|
+
documentPermissions?: {
|
|
1452
|
+
enabled?: boolean;
|
|
1453
|
+
cacheTtlMs?: number;
|
|
1454
|
+
};
|
|
1455
|
+
skipCredentialVerification?: boolean;
|
|
1456
|
+
credentialCacheTtlMs?: number;
|
|
1457
|
+
wsRecheckMs?: number;
|
|
1458
|
+
};
|
|
1459
|
+
inspection?: {
|
|
1460
|
+
admin?: boolean;
|
|
1461
|
+
};
|
|
1462
|
+
attachments?: {
|
|
1463
|
+
storage?: AttachmentStorageConfig;
|
|
1464
|
+
};
|
|
1465
|
+
};
|
|
1466
|
+
/** The reactor-api settings `env` names; keys it does not set stay undefined. */
|
|
1467
|
+
export declare function reactorApiConfigFromEnv(env: Env, logger?: ILogger): ReactorApiConfig;
|
|
1468
|
+
/** `DOCUMENT_PERMISSION_CACHE_TTL_MS` in ms (0 disables); invalid warns and uses the default. */
|
|
1469
|
+
export declare function resolvePermissionCacheTtlMs(raw: string | undefined, logger: ILogger): number;
|
|
1418
1470
|
//#endregion
|
|
1419
1471
|
//#region src/graphql/analytics-subgraph.d.ts
|
|
1420
1472
|
export declare class AnalyticsSubgraph extends BaseSubgraph {
|
|
@@ -1644,15 +1696,6 @@ export type AuthFetchMiddleware = (handler: FetchHandler) => FetchHandler;
|
|
|
1644
1696
|
export declare function getAuthContext(request: globalThis.Request): AuthContext | undefined;
|
|
1645
1697
|
export declare function createAuthFetchMiddleware(authService: AuthService): AuthFetchMiddleware;
|
|
1646
1698
|
//#endregion
|
|
1647
|
-
//#region src/graphql/gateway/factory.d.ts
|
|
1648
|
-
export type GatewayAdapterType = "apollo" | "mercurius" | "stitching";
|
|
1649
|
-
export type HttpAdapterType = "express" | "fastify";
|
|
1650
|
-
export declare function createGatewayAdapter(type: GatewayAdapterType, logger: ILogger): Promise<IGatewayAdapter<Context>>;
|
|
1651
|
-
export type HttpAdapterSetup = {
|
|
1652
|
-
adapter: IHttpAdapter;
|
|
1653
|
-
};
|
|
1654
|
-
export declare function createHttpAdapter(type: HttpAdapterType): Promise<HttpAdapterSetup>;
|
|
1655
|
-
//#endregion
|
|
1656
1699
|
//#region src/graphql/gateway/drive-ownership-cache.d.ts
|
|
1657
1700
|
/**
|
|
1658
1701
|
* Where drives are looked up: the raw reactor, past the read gate. Ownership
|
|
@@ -1766,6 +1809,11 @@ export type GraphQLManagerOptions = {
|
|
|
1766
1809
|
authorizationService: IAuthorizationService;
|
|
1767
1810
|
/** Resolvers dispatch to it for reactor-drive parents. */
|
|
1768
1811
|
reactorDriveClient?: IDriveClient;
|
|
1812
|
+
/**
|
|
1813
|
+
* Type-neutral drive node reads behind the reactor subgraph's `driveNodes`,
|
|
1814
|
+
* `driveNode` and `driveDescendants`. Without it those fields refuse.
|
|
1815
|
+
*/
|
|
1816
|
+
driveNodes?: IDriveNodeSource;
|
|
1769
1817
|
syncServingGate?: SyncScopeGate;
|
|
1770
1818
|
httpRoutes?: HttpRouteService;
|
|
1771
1819
|
attachments?: IAttachmentClientProvider;
|
|
@@ -1820,6 +1868,8 @@ export declare class GraphQLManager {
|
|
|
1820
1868
|
* it for reactor-drive parents.
|
|
1821
1869
|
*/
|
|
1822
1870
|
readonly reactorDriveClient?: IDriveClient;
|
|
1871
|
+
/** See {@link GraphQLManagerOptions.driveNodes}. */
|
|
1872
|
+
readonly driveNodes?: IDriveNodeSource;
|
|
1823
1873
|
private readonly authorizationService;
|
|
1824
1874
|
private readonly path;
|
|
1825
1875
|
private readonly httpServer;
|
|
@@ -2015,6 +2065,8 @@ export type ReadinessGate = {
|
|
|
2015
2065
|
};
|
|
2016
2066
|
export type API = {
|
|
2017
2067
|
httpAdapter: IHttpAdapter;
|
|
2068
|
+
/** The port the HTTP server bound; the ephemeral one when 0 was requested. */
|
|
2069
|
+
port: number;
|
|
2018
2070
|
/** The listening server, for host-side observers such as request load. */
|
|
2019
2071
|
httpServer: http.Server;
|
|
2020
2072
|
/** Hands each package a namespaced slice of the HTTP surface. */
|
|
@@ -2336,6 +2388,7 @@ export type MakeEmpty<T extends {
|
|
|
2336
2388
|
[key: string]: unknown;
|
|
2337
2389
|
}, K extends keyof T> = { [_ in K]?: never; };
|
|
2338
2390
|
export type Incremental<T> = T | { [P in keyof T]?: P extends " $fragmentName" | "__typename" ? T[P] : never; };
|
|
2391
|
+
export type Omit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>;
|
|
2339
2392
|
export type RequireFields<T, K extends keyof T> = Omit<T, K> & { [P in K]-?: NonNullable<T[P]>; };
|
|
2340
2393
|
/** All built-in and custom scalars, mapped to their actual values */
|
|
2341
2394
|
export type Scalars = {
|
|
@@ -2580,6 +2633,29 @@ export type DocumentWithChildren = {
|
|
|
2580
2633
|
readonly childIds: ReadonlyArray<Scalars["String"]["output"]>;
|
|
2581
2634
|
readonly document: PhDocument;
|
|
2582
2635
|
};
|
|
2636
|
+
export type DriveFileNode = {
|
|
2637
|
+
readonly documentType: Scalars["String"]["output"];
|
|
2638
|
+
readonly driveId: Scalars["ID"]["output"];
|
|
2639
|
+
readonly id: Scalars["ID"]["output"];
|
|
2640
|
+
readonly name: Scalars["String"]["output"];
|
|
2641
|
+
readonly parentFolder?: Maybe<Scalars["ID"]["output"]>;
|
|
2642
|
+
};
|
|
2643
|
+
export type DriveFolderNode = {
|
|
2644
|
+
readonly driveId: Scalars["ID"]["output"];
|
|
2645
|
+
readonly id: Scalars["ID"]["output"];
|
|
2646
|
+
readonly name: Scalars["String"]["output"];
|
|
2647
|
+
readonly parentFolder?: Maybe<Scalars["ID"]["output"]>;
|
|
2648
|
+
};
|
|
2649
|
+
export type DriveNode = DriveFileNode | DriveFolderNode;
|
|
2650
|
+
export declare enum DriveNodeKind {
|
|
2651
|
+
File = "FILE",
|
|
2652
|
+
Folder = "FOLDER"
|
|
2653
|
+
}
|
|
2654
|
+
export type DriveNodePage = {
|
|
2655
|
+
readonly hasMore: Scalars["Boolean"]["output"];
|
|
2656
|
+
readonly nextCursor?: Maybe<Scalars["String"]["output"]>;
|
|
2657
|
+
readonly results: ReadonlyArray<DriveNode>;
|
|
2658
|
+
};
|
|
2583
2659
|
/**
|
|
2584
2660
|
* One mutation job of a batch, mirroring the reactor's `ExecutionJobPlan`
|
|
2585
2661
|
* (packages/reactor/src/core/types.ts). The batch runs its jobs in dependency
|
|
@@ -2913,6 +2989,9 @@ export type Query = {
|
|
|
2913
2989
|
readonly documentOutgoingRelationshipEdges: DocumentRelationshipResultPage;
|
|
2914
2990
|
readonly documentOutgoingRelationships: PhDocumentResultPage;
|
|
2915
2991
|
readonly documentServed: Scalars["Boolean"]["output"];
|
|
2992
|
+
readonly driveDescendants: ReadonlyArray<DriveNode>;
|
|
2993
|
+
readonly driveNode?: Maybe<DriveNode>;
|
|
2994
|
+
readonly driveNodes: DriveNodePage;
|
|
2916
2995
|
/**
|
|
2917
2996
|
* Predicts whether the calling subject would be admitted to execute each of a
|
|
2918
2997
|
* set of candidate operations, without submitting any of them. A UI asks this to
|
|
@@ -2959,6 +3038,7 @@ export type Query = {
|
|
|
2959
3038
|
readonly syncHolds: ReadonlyArray<SyncHold>;
|
|
2960
3039
|
};
|
|
2961
3040
|
export type QueryCreateDefaultsArgs = {
|
|
3041
|
+
documentType?: InputMaybe<Scalars["String"]["input"]>;
|
|
2962
3042
|
parentIdOrSlug?: InputMaybe<Scalars["String"]["input"]>;
|
|
2963
3043
|
};
|
|
2964
3044
|
export type QueryDocumentArgs = {
|
|
@@ -3011,6 +3091,20 @@ export type QueryDocumentServedArgs = {
|
|
|
3011
3091
|
idOrSlug: Scalars["String"]["input"];
|
|
3012
3092
|
view?: InputMaybe<ViewFilterInput>;
|
|
3013
3093
|
};
|
|
3094
|
+
export type QueryDriveDescendantsArgs = {
|
|
3095
|
+
driveId: Scalars["ID"]["input"];
|
|
3096
|
+
root: Scalars["ID"]["input"];
|
|
3097
|
+
};
|
|
3098
|
+
export type QueryDriveNodeArgs = {
|
|
3099
|
+
driveId: Scalars["ID"]["input"];
|
|
3100
|
+
id: Scalars["ID"]["input"];
|
|
3101
|
+
};
|
|
3102
|
+
export type QueryDriveNodesArgs = {
|
|
3103
|
+
driveId: Scalars["ID"]["input"];
|
|
3104
|
+
kind?: InputMaybe<DriveNodeKind>;
|
|
3105
|
+
paging?: InputMaybe<PagingInput>;
|
|
3106
|
+
parentFolder?: InputMaybe<Scalars["ID"]["input"]>;
|
|
3107
|
+
};
|
|
3014
3108
|
export type QueryEvaluateActionsArgs = {
|
|
3015
3109
|
branch?: InputMaybe<Scalars["String"]["input"]>;
|
|
3016
3110
|
candidates: ReadonlyArray<ActionCandidateInput>;
|
|
@@ -3535,6 +3629,89 @@ export type GetCreateDefaultsQuery = {
|
|
|
3535
3629
|
readonly protocolVersions: NonNullable<unknown>;
|
|
3536
3630
|
};
|
|
3537
3631
|
};
|
|
3632
|
+
export type GetCreateProtocolVersionsQueryVariables = Exact<{
|
|
3633
|
+
parentIdOrSlug?: InputMaybe<Scalars["String"]["input"]>;
|
|
3634
|
+
documentType: Scalars["String"]["input"];
|
|
3635
|
+
}>;
|
|
3636
|
+
export type GetCreateProtocolVersionsQuery = {
|
|
3637
|
+
readonly createDefaults: {
|
|
3638
|
+
readonly protocolVersions: NonNullable<unknown>;
|
|
3639
|
+
};
|
|
3640
|
+
};
|
|
3641
|
+
type DriveNodeFields_DriveFileNode_Fragment = {
|
|
3642
|
+
readonly id: string;
|
|
3643
|
+
readonly driveId: string;
|
|
3644
|
+
readonly name: string;
|
|
3645
|
+
readonly parentFolder?: string | null | undefined;
|
|
3646
|
+
readonly documentType: string;
|
|
3647
|
+
};
|
|
3648
|
+
type DriveNodeFields_DriveFolderNode_Fragment = {
|
|
3649
|
+
readonly id: string;
|
|
3650
|
+
readonly driveId: string;
|
|
3651
|
+
readonly name: string;
|
|
3652
|
+
readonly parentFolder?: string | null | undefined;
|
|
3653
|
+
};
|
|
3654
|
+
export type DriveNodeFieldsFragment = DriveNodeFields_DriveFileNode_Fragment | DriveNodeFields_DriveFolderNode_Fragment;
|
|
3655
|
+
export type GetDriveNodesQueryVariables = Exact<{
|
|
3656
|
+
driveId: Scalars["ID"]["input"];
|
|
3657
|
+
parentFolder?: InputMaybe<Scalars["ID"]["input"]>;
|
|
3658
|
+
paging?: InputMaybe<PagingInput>;
|
|
3659
|
+
kind?: InputMaybe<DriveNodeKind>;
|
|
3660
|
+
}>;
|
|
3661
|
+
export type GetDriveNodesQuery = {
|
|
3662
|
+
readonly driveNodes: {
|
|
3663
|
+
readonly nextCursor?: string | null | undefined;
|
|
3664
|
+
readonly hasMore: boolean;
|
|
3665
|
+
readonly results: ReadonlyArray<{
|
|
3666
|
+
readonly id: string;
|
|
3667
|
+
readonly driveId: string;
|
|
3668
|
+
readonly name: string;
|
|
3669
|
+
readonly parentFolder?: string | null | undefined;
|
|
3670
|
+
readonly documentType: string;
|
|
3671
|
+
} | {
|
|
3672
|
+
readonly id: string;
|
|
3673
|
+
readonly driveId: string;
|
|
3674
|
+
readonly name: string;
|
|
3675
|
+
readonly parentFolder?: string | null | undefined;
|
|
3676
|
+
}>;
|
|
3677
|
+
};
|
|
3678
|
+
};
|
|
3679
|
+
export type GetDriveNodeQueryVariables = Exact<{
|
|
3680
|
+
driveId: Scalars["ID"]["input"];
|
|
3681
|
+
id: Scalars["ID"]["input"];
|
|
3682
|
+
}>;
|
|
3683
|
+
export type GetDriveNodeQuery = {
|
|
3684
|
+
readonly driveNode?: {
|
|
3685
|
+
readonly id: string;
|
|
3686
|
+
readonly driveId: string;
|
|
3687
|
+
readonly name: string;
|
|
3688
|
+
readonly parentFolder?: string | null | undefined;
|
|
3689
|
+
readonly documentType: string;
|
|
3690
|
+
} | {
|
|
3691
|
+
readonly id: string;
|
|
3692
|
+
readonly driveId: string;
|
|
3693
|
+
readonly name: string;
|
|
3694
|
+
readonly parentFolder?: string | null | undefined;
|
|
3695
|
+
} | null | undefined;
|
|
3696
|
+
};
|
|
3697
|
+
export type GetDriveDescendantsQueryVariables = Exact<{
|
|
3698
|
+
driveId: Scalars["ID"]["input"];
|
|
3699
|
+
root: Scalars["ID"]["input"];
|
|
3700
|
+
}>;
|
|
3701
|
+
export type GetDriveDescendantsQuery = {
|
|
3702
|
+
readonly driveDescendants: ReadonlyArray<{
|
|
3703
|
+
readonly id: string;
|
|
3704
|
+
readonly driveId: string;
|
|
3705
|
+
readonly name: string;
|
|
3706
|
+
readonly parentFolder?: string | null | undefined;
|
|
3707
|
+
readonly documentType: string;
|
|
3708
|
+
} | {
|
|
3709
|
+
readonly id: string;
|
|
3710
|
+
readonly driveId: string;
|
|
3711
|
+
readonly name: string;
|
|
3712
|
+
readonly parentFolder?: string | null | undefined;
|
|
3713
|
+
}>;
|
|
3714
|
+
};
|
|
3538
3715
|
export type EvaluateActionsQueryVariables = Exact<{
|
|
3539
3716
|
documentIdentifier: Scalars["String"]["input"];
|
|
3540
3717
|
branch?: InputMaybe<Scalars["String"]["input"]>;
|
|
@@ -4002,6 +4179,10 @@ export type TypeResolveFn<TTypes, TParent = Record<PropertyKey, never>, TContext
|
|
|
4002
4179
|
export type IsTypeOfResolverFn<T = Record<PropertyKey, never>, TContext = Record<PropertyKey, never>> = (obj: T, context: TContext, info: GraphQLResolveInfo) => boolean | Promise<boolean>;
|
|
4003
4180
|
export type NextResolverFn<T> = () => Promise<T>;
|
|
4004
4181
|
export type DirectiveResolverFn<TResult = Record<PropertyKey, never>, TParent = Record<PropertyKey, never>, TContext = Record<PropertyKey, never>, TArgs = Record<PropertyKey, never>> = (next: NextResolverFn<TResult>, parent: TParent, args: TArgs, context: TContext, info: GraphQLResolveInfo) => TResult | Promise<TResult>;
|
|
4182
|
+
/** Mapping of union types */
|
|
4183
|
+
export type ResolversUnionTypes<_RefType extends Record<string, unknown>> = ResolversObject<{
|
|
4184
|
+
DriveNode: DriveFileNode | DriveFolderNode;
|
|
4185
|
+
}>;
|
|
4005
4186
|
/** Mapping between all available schema types and the resolvers types */
|
|
4006
4187
|
export type ResolversTypes = ResolversObject<{
|
|
4007
4188
|
Action: ResolverTypeWrapper<Action>;
|
|
@@ -4033,7 +4214,15 @@ export type ResolversTypes = ResolversObject<{
|
|
|
4033
4214
|
DocumentRelationship: ResolverTypeWrapper<DocumentRelationship>;
|
|
4034
4215
|
DocumentRelationshipResultPage: ResolverTypeWrapper<DocumentRelationshipResultPage>;
|
|
4035
4216
|
DocumentWithChildren: ResolverTypeWrapper<DocumentWithChildren>;
|
|
4217
|
+
DriveFileNode: ResolverTypeWrapper<DriveFileNode>;
|
|
4218
|
+
DriveFolderNode: ResolverTypeWrapper<DriveFolderNode>;
|
|
4219
|
+
DriveNode: ResolverTypeWrapper<ResolversUnionTypes<ResolversTypes>["DriveNode"]>;
|
|
4220
|
+
DriveNodeKind: DriveNodeKind;
|
|
4221
|
+
DriveNodePage: ResolverTypeWrapper<Omit<DriveNodePage, "results"> & {
|
|
4222
|
+
results: ReadonlyArray<ResolversTypes["DriveNode"]>;
|
|
4223
|
+
}>;
|
|
4036
4224
|
ExecutionJobInput: ExecutionJobInput;
|
|
4225
|
+
ID: ResolverTypeWrapper<Scalars["ID"]["output"]>;
|
|
4037
4226
|
Int: ResolverTypeWrapper<Scalars["Int"]["output"]>;
|
|
4038
4227
|
JSONObject: ResolverTypeWrapper<Scalars["JSONObject"]["output"]>;
|
|
4039
4228
|
JobBatchMeta: ResolverTypeWrapper<JobBatchMeta>;
|
|
@@ -4110,7 +4299,14 @@ export type ResolversParentTypes = ResolversObject<{
|
|
|
4110
4299
|
DocumentRelationship: DocumentRelationship;
|
|
4111
4300
|
DocumentRelationshipResultPage: DocumentRelationshipResultPage;
|
|
4112
4301
|
DocumentWithChildren: DocumentWithChildren;
|
|
4302
|
+
DriveFileNode: DriveFileNode;
|
|
4303
|
+
DriveFolderNode: DriveFolderNode;
|
|
4304
|
+
DriveNode: ResolversUnionTypes<ResolversParentTypes>["DriveNode"];
|
|
4305
|
+
DriveNodePage: Omit<DriveNodePage, "results"> & {
|
|
4306
|
+
results: ReadonlyArray<ResolversParentTypes["DriveNode"]>;
|
|
4307
|
+
};
|
|
4113
4308
|
ExecutionJobInput: ExecutionJobInput;
|
|
4309
|
+
ID: Scalars["ID"]["output"];
|
|
4114
4310
|
Int: Scalars["Int"]["output"];
|
|
4115
4311
|
JSONObject: Scalars["JSONObject"]["output"];
|
|
4116
4312
|
JobBatchMeta: JobBatchMeta;
|
|
@@ -4255,6 +4451,29 @@ export type DocumentWithChildrenResolvers<ContextType = Context, ParentType exte
|
|
|
4255
4451
|
childIds?: Resolver<ReadonlyArray<ResolversTypes["String"]>, ParentType, ContextType>;
|
|
4256
4452
|
document?: Resolver<ResolversTypes["PHDocument"], ParentType, ContextType>;
|
|
4257
4453
|
}>;
|
|
4454
|
+
export type DriveFileNodeResolvers<ContextType = Context, ParentType extends ResolversParentTypes["DriveFileNode"] = ResolversParentTypes["DriveFileNode"]> = ResolversObject<{
|
|
4455
|
+
documentType?: Resolver<ResolversTypes["String"], ParentType, ContextType>;
|
|
4456
|
+
driveId?: Resolver<ResolversTypes["ID"], ParentType, ContextType>;
|
|
4457
|
+
id?: Resolver<ResolversTypes["ID"], ParentType, ContextType>;
|
|
4458
|
+
name?: Resolver<ResolversTypes["String"], ParentType, ContextType>;
|
|
4459
|
+
parentFolder?: Resolver<Maybe<ResolversTypes["ID"]>, ParentType, ContextType>;
|
|
4460
|
+
__isTypeOf?: IsTypeOfResolverFn<ParentType, ContextType>;
|
|
4461
|
+
}>;
|
|
4462
|
+
export type DriveFolderNodeResolvers<ContextType = Context, ParentType extends ResolversParentTypes["DriveFolderNode"] = ResolversParentTypes["DriveFolderNode"]> = ResolversObject<{
|
|
4463
|
+
driveId?: Resolver<ResolversTypes["ID"], ParentType, ContextType>;
|
|
4464
|
+
id?: Resolver<ResolversTypes["ID"], ParentType, ContextType>;
|
|
4465
|
+
name?: Resolver<ResolversTypes["String"], ParentType, ContextType>;
|
|
4466
|
+
parentFolder?: Resolver<Maybe<ResolversTypes["ID"]>, ParentType, ContextType>;
|
|
4467
|
+
__isTypeOf?: IsTypeOfResolverFn<ParentType, ContextType>;
|
|
4468
|
+
}>;
|
|
4469
|
+
export type DriveNodeResolvers<ContextType = Context, ParentType extends ResolversParentTypes["DriveNode"] = ResolversParentTypes["DriveNode"]> = ResolversObject<{
|
|
4470
|
+
__resolveType: TypeResolveFn<"DriveFileNode" | "DriveFolderNode", ParentType, ContextType>;
|
|
4471
|
+
}>;
|
|
4472
|
+
export type DriveNodePageResolvers<ContextType = Context, ParentType extends ResolversParentTypes["DriveNodePage"] = ResolversParentTypes["DriveNodePage"]> = ResolversObject<{
|
|
4473
|
+
hasMore?: Resolver<ResolversTypes["Boolean"], ParentType, ContextType>;
|
|
4474
|
+
nextCursor?: Resolver<Maybe<ResolversTypes["String"]>, ParentType, ContextType>;
|
|
4475
|
+
results?: Resolver<ReadonlyArray<ResolversTypes["DriveNode"]>, ParentType, ContextType>;
|
|
4476
|
+
}>;
|
|
4258
4477
|
export interface JsonObjectScalarConfig extends GraphQLScalarTypeConfig<ResolversTypes["JSONObject"], any> {
|
|
4259
4478
|
name: "JSONObject";
|
|
4260
4479
|
}
|
|
@@ -4368,6 +4587,9 @@ export type QueryResolvers<ContextType = Context, ParentType extends ResolversPa
|
|
|
4368
4587
|
documentOutgoingRelationshipEdges?: Resolver<ResolversTypes["DocumentRelationshipResultPage"], ParentType, ContextType, Partial<QueryDocumentOutgoingRelationshipEdgesArgs>>;
|
|
4369
4588
|
documentOutgoingRelationships?: Resolver<ResolversTypes["PHDocumentResultPage"], ParentType, ContextType, RequireFields<QueryDocumentOutgoingRelationshipsArgs, "relationshipType">>;
|
|
4370
4589
|
documentServed?: Resolver<ResolversTypes["Boolean"], ParentType, ContextType, RequireFields<QueryDocumentServedArgs, "idOrSlug">>;
|
|
4590
|
+
driveDescendants?: Resolver<ReadonlyArray<ResolversTypes["DriveNode"]>, ParentType, ContextType, RequireFields<QueryDriveDescendantsArgs, "driveId" | "root">>;
|
|
4591
|
+
driveNode?: Resolver<Maybe<ResolversTypes["DriveNode"]>, ParentType, ContextType, RequireFields<QueryDriveNodeArgs, "driveId" | "id">>;
|
|
4592
|
+
driveNodes?: Resolver<ResolversTypes["DriveNodePage"], ParentType, ContextType, RequireFields<QueryDriveNodesArgs, "driveId">>;
|
|
4371
4593
|
evaluateActions?: Resolver<ResolversTypes["ActionEvaluations"], ParentType, ContextType, RequireFields<QueryEvaluateActionsArgs, "candidates">>;
|
|
4372
4594
|
findDocuments?: Resolver<ResolversTypes["PHDocumentResultPage"], ParentType, ContextType, Partial<QueryFindDocumentsArgs>>;
|
|
4373
4595
|
jobStatus?: Resolver<Maybe<ResolversTypes["JobInfo"]>, ParentType, ContextType, RequireFields<QueryJobStatusArgs, "jobId">>;
|
|
@@ -4463,6 +4685,10 @@ export type Resolvers<ContextType = Context> = ResolversObject<{
|
|
|
4463
4685
|
DocumentRelationship?: DocumentRelationshipResolvers<ContextType>;
|
|
4464
4686
|
DocumentRelationshipResultPage?: DocumentRelationshipResultPageResolvers<ContextType>;
|
|
4465
4687
|
DocumentWithChildren?: DocumentWithChildrenResolvers<ContextType>;
|
|
4688
|
+
DriveFileNode?: DriveFileNodeResolvers<ContextType>;
|
|
4689
|
+
DriveFolderNode?: DriveFolderNodeResolvers<ContextType>;
|
|
4690
|
+
DriveNode?: DriveNodeResolvers<ContextType>;
|
|
4691
|
+
DriveNodePage?: DriveNodePageResolvers<ContextType>;
|
|
4466
4692
|
JSONObject?: GraphQLScalarType;
|
|
4467
4693
|
JobBatchMeta?: JobBatchMetaResolvers<ContextType>;
|
|
4468
4694
|
JobChangeEvent?: JobChangeEventResolvers<ContextType>;
|
|
@@ -4497,6 +4723,7 @@ export declare const isDefinedNonNullAny: (v: any) => v is definedNonNullAny;
|
|
|
4497
4723
|
export declare const definedNonNullAnySchema: z$1.ZodAny & z$1.ZodType<definedNonNullAny, any, z$1.core.$ZodTypeInternals<definedNonNullAny, any>>;
|
|
4498
4724
|
export declare const AuthDecisionSchema: z$1.ZodEnum<typeof AuthDecision>;
|
|
4499
4725
|
export declare const DocumentChangeTypeSchema: z$1.ZodEnum<typeof DocumentChangeType>;
|
|
4726
|
+
export declare const DriveNodeKindSchema: z$1.ZodEnum<typeof DriveNodeKind>;
|
|
4500
4727
|
export declare const PropagationModeSchema: z$1.ZodEnum<typeof PropagationMode>;
|
|
4501
4728
|
export declare const SyncEnvelopeTypeSchema: z$1.ZodEnum<typeof SyncEnvelopeType>;
|
|
4502
4729
|
export declare function ActionCandidateInputSchema(): z$1.ZodObject<Properties<ActionCandidateInput>>;
|
|
@@ -4525,6 +4752,7 @@ export declare function ViewFilterInputSchema(): z$1.ZodObject<Properties<ViewFi
|
|
|
4525
4752
|
export declare const PhDocumentFieldsFragmentDoc: DocumentNode;
|
|
4526
4753
|
export declare const DocumentRelationshipFieldsFragmentDoc: DocumentNode;
|
|
4527
4754
|
export declare const JobInfoFieldsFragmentDoc: DocumentNode;
|
|
4755
|
+
export declare const DriveNodeFieldsFragmentDoc: DocumentNode;
|
|
4528
4756
|
export declare const GetDocumentModelsDocument: DocumentNode;
|
|
4529
4757
|
export declare const GetDocumentDocument: DocumentNode;
|
|
4530
4758
|
export declare const GetDocumentWithOperationsDocument: DocumentNode;
|
|
@@ -4537,6 +4765,10 @@ export declare const GetDocumentOperationsDocument: DocumentNode;
|
|
|
4537
4765
|
export declare const GetJobStatusDocument: DocumentNode;
|
|
4538
4766
|
export declare const GetDocumentServedDocument: DocumentNode;
|
|
4539
4767
|
export declare const GetCreateDefaultsDocument: DocumentNode;
|
|
4768
|
+
export declare const GetCreateProtocolVersionsDocument: DocumentNode;
|
|
4769
|
+
export declare const GetDriveNodesDocument: DocumentNode;
|
|
4770
|
+
export declare const GetDriveNodeDocument: DocumentNode;
|
|
4771
|
+
export declare const GetDriveDescendantsDocument: DocumentNode;
|
|
4540
4772
|
export declare const EvaluateActionsDocument: DocumentNode;
|
|
4541
4773
|
export declare const CreateDocumentDocument: DocumentNode;
|
|
4542
4774
|
export declare const CreateEmptyDocumentDocument: DocumentNode;
|
|
@@ -4570,6 +4802,10 @@ export declare function getSdk<C>(requester: Requester<C>): {
|
|
|
4570
4802
|
GetJobStatus(variables: GetJobStatusQueryVariables, options?: C): Promise<GetJobStatusQuery>;
|
|
4571
4803
|
GetDocumentServed(variables: GetDocumentServedQueryVariables, options?: C): Promise<GetDocumentServedQuery>;
|
|
4572
4804
|
GetCreateDefaults(variables?: GetCreateDefaultsQueryVariables, options?: C): Promise<GetCreateDefaultsQuery>;
|
|
4805
|
+
GetCreateProtocolVersions(variables: GetCreateProtocolVersionsQueryVariables, options?: C): Promise<GetCreateProtocolVersionsQuery>;
|
|
4806
|
+
GetDriveNodes(variables: GetDriveNodesQueryVariables, options?: C): Promise<GetDriveNodesQuery>;
|
|
4807
|
+
GetDriveNode(variables: GetDriveNodeQueryVariables, options?: C): Promise<GetDriveNodeQuery>;
|
|
4808
|
+
GetDriveDescendants(variables: GetDriveDescendantsQueryVariables, options?: C): Promise<GetDriveDescendantsQuery>;
|
|
4573
4809
|
EvaluateActions(variables: EvaluateActionsQueryVariables, options?: C): Promise<EvaluateActionsQuery>;
|
|
4574
4810
|
CreateDocument(variables: CreateDocumentMutationVariables, options?: C): Promise<CreateDocumentMutation>;
|
|
4575
4811
|
CreateEmptyDocument(variables: CreateEmptyDocumentMutationVariables, options?: C): Promise<CreateEmptyDocumentMutation>;
|
|
@@ -4654,6 +4890,24 @@ export declare function createReactorGraphQLClient(url: string, fetchImpl?: Fetc
|
|
|
4654
4890
|
GetCreateDefaults(variables?: Exact<{
|
|
4655
4891
|
parentIdOrSlug?: InputMaybe<Scalars["String"]["input"]>;
|
|
4656
4892
|
}> | undefined, options?: {} | undefined): Promise<GetCreateDefaultsQuery>;
|
|
4893
|
+
GetCreateProtocolVersions(variables: Exact<{
|
|
4894
|
+
parentIdOrSlug?: InputMaybe<Scalars["String"]["input"]>;
|
|
4895
|
+
documentType: Scalars["String"]["input"];
|
|
4896
|
+
}>, options?: {} | undefined): Promise<GetCreateProtocolVersionsQuery>;
|
|
4897
|
+
GetDriveNodes(variables: Exact<{
|
|
4898
|
+
driveId: Scalars["ID"]["input"];
|
|
4899
|
+
parentFolder?: InputMaybe<Scalars["ID"]["input"]>;
|
|
4900
|
+
paging?: InputMaybe<PagingInput>;
|
|
4901
|
+
kind?: InputMaybe<DriveNodeKind>;
|
|
4902
|
+
}>, options?: {} | undefined): Promise<GetDriveNodesQuery>;
|
|
4903
|
+
GetDriveNode(variables: Exact<{
|
|
4904
|
+
driveId: Scalars["ID"]["input"];
|
|
4905
|
+
id: Scalars["ID"]["input"];
|
|
4906
|
+
}>, options?: {} | undefined): Promise<GetDriveNodeQuery>;
|
|
4907
|
+
GetDriveDescendants(variables: Exact<{
|
|
4908
|
+
driveId: Scalars["ID"]["input"];
|
|
4909
|
+
root: Scalars["ID"]["input"];
|
|
4910
|
+
}>, options?: {} | undefined): Promise<GetDriveDescendantsQuery>;
|
|
4657
4911
|
EvaluateActions(variables: Exact<{
|
|
4658
4912
|
documentIdentifier: Scalars["String"]["input"];
|
|
4659
4913
|
branch?: InputMaybe<Scalars["String"]["input"]>;
|
|
@@ -4784,7 +5038,8 @@ export declare class ReactorSubgraph extends BaseSubgraph {
|
|
|
4784
5038
|
}
|
|
4785
5039
|
//#endregion
|
|
4786
5040
|
//#region src/graphql/system/env/index.d.ts
|
|
4787
|
-
|
|
5041
|
+
/** @deprecated Nothing reads it; read `ADMIN_USERS` at your own edge. Reads env on each access. */
|
|
5042
|
+
export declare const ADMIN_USERS: readonly string[];
|
|
4788
5043
|
//#endregion
|
|
4789
5044
|
//#region src/graphql/system/subgraph.d.ts
|
|
4790
5045
|
export declare class SystemSubgraph extends BaseSubgraph {
|
|
@@ -5038,32 +5293,42 @@ type Options = {
|
|
|
5038
5293
|
pgliteFactory?: PgliteFactory;
|
|
5039
5294
|
configFile?: string;
|
|
5040
5295
|
packages?: string[];
|
|
5296
|
+
/** Route prefix, gateway and public origin. Env is not read: map it at the
|
|
5297
|
+
* edge with `reactorApiConfigFromEnv`. */
|
|
5298
|
+
server?: ReactorApiConfig["server"];
|
|
5299
|
+
/** `enabled` and `admins` win over the `configFile`'s. Env is not read. */
|
|
5041
5300
|
auth?: {
|
|
5042
|
-
enabled
|
|
5043
|
-
admins
|
|
5301
|
+
enabled?: boolean;
|
|
5302
|
+
admins?: string[];
|
|
5044
5303
|
/** Read the bearer and populate `ctx.user` independently of `enabled`.
|
|
5045
|
-
* Defaults to `enabled
|
|
5304
|
+
* Defaults to `enabled`. */
|
|
5046
5305
|
resolveIdentity?: boolean;
|
|
5047
5306
|
/** Reject anonymous callers with a 401 before any subgraph sees the
|
|
5048
|
-
* request. Off by default
|
|
5049
|
-
*
|
|
5307
|
+
* request. Off by default. Requires identity resolution to be on —
|
|
5308
|
+
* refused at boot without it. */
|
|
5050
5309
|
requireAuthenticatedCaller?: boolean;
|
|
5051
5310
|
/** Mounted paths that stay reachable anonymously while
|
|
5052
5311
|
* `requireAuthenticatedCaller` is on, for a flow that runs before
|
|
5053
5312
|
* sign-in. Matched against the request's pathname in full, never as a
|
|
5054
|
-
* prefix.
|
|
5055
|
-
* comma-separated list. Each entry is a hole in the floor: only ever name
|
|
5313
|
+
* prefix. Each entry is a hole in the floor: only ever name
|
|
5056
5314
|
* a path serving operations that are safe without a caller. */
|
|
5057
5315
|
requireAuthenticatedCallerExemptPaths?: string[];
|
|
5058
5316
|
/** Decide an attachment read with the referencing document's own policy
|
|
5059
|
-
* instead of the host permission tables. Off by default
|
|
5060
|
-
* `ATTACHMENT_READS_FOLLOW_DOCUMENT_POLICY` overrides. Requires auth
|
|
5317
|
+
* instead of the host permission tables. Off by default. Requires auth
|
|
5061
5318
|
* enforcement, which is what supplies the model — refused at boot
|
|
5062
5319
|
* without it. */
|
|
5063
5320
|
attachmentReadsFollowDocumentPolicy?: boolean;
|
|
5321
|
+
defaultProtection?: boolean;
|
|
5322
|
+
documentPermissions?: {
|
|
5323
|
+
enabled?: boolean;
|
|
5324
|
+
cacheTtlMs?: number;
|
|
5325
|
+
};
|
|
5326
|
+
skipCredentialVerification?: boolean;
|
|
5327
|
+
credentialCacheTtlMs?: number;
|
|
5328
|
+
wsRecheckMs?: number;
|
|
5064
5329
|
};
|
|
5065
5330
|
/** Renown coordinates the host already resolved, used verbatim instead of
|
|
5066
|
-
* resolving `auth.renown`
|
|
5331
|
+
* resolving the config file's `auth.renown` again (which would warn twice). */
|
|
5067
5332
|
renown?: ResolvedRenownConfig;
|
|
5068
5333
|
/** Credential check replacing the built-in remote Renown one; required when
|
|
5069
5334
|
* the resolved source is "self" (see assertCredentialVerifierForSource). */
|
|
@@ -5080,8 +5345,7 @@ type Options = {
|
|
|
5080
5345
|
* Document permission service instance.
|
|
5081
5346
|
* When provided, the Auth subgraph is registered and document permission
|
|
5082
5347
|
* checks are enforced on document operations.
|
|
5083
|
-
* If not provided,
|
|
5084
|
-
* environment variable.
|
|
5348
|
+
* If not provided, `auth.documentPermissions.enabled` creates one.
|
|
5085
5349
|
*/
|
|
5086
5350
|
documentPermissionService?: DocumentPermissionService;
|
|
5087
5351
|
enableDocumentModelSubgraphs?: boolean;
|
|
@@ -5094,6 +5358,8 @@ type Options = {
|
|
|
5094
5358
|
* or os.tmpdir() for in-memory DB deployments.
|
|
5095
5359
|
*/
|
|
5096
5360
|
attachmentStoragePath?: string;
|
|
5361
|
+
/** Filesystem when unset. */
|
|
5362
|
+
attachments?: ReactorApiConfig["attachments"];
|
|
5097
5363
|
/** Storage health and workflow facts for the inspection subgraph; `false`
|
|
5098
5364
|
* leaves it unmounted and `api.inspection` undefined. On by default. */
|
|
5099
5365
|
inspection?: ReactorInspectionOptions | false;
|
|
@@ -5151,6 +5417,8 @@ export declare function getExplorerPrefix(basePath: string): string;
|
|
|
5151
5417
|
export interface ClientInitializerResult {
|
|
5152
5418
|
module: InProcessReactorClientModule;
|
|
5153
5419
|
reactorDriveClient?: IDriveClient;
|
|
5420
|
+
/** Type-neutral drive node reads for the reactor subgraph's node queries. */
|
|
5421
|
+
driveNodes?: IDriveNodeSource;
|
|
5154
5422
|
attachmentReferenceProjection?: AttachmentReferenceProjectionCapability;
|
|
5155
5423
|
/**
|
|
5156
5424
|
* The reactor store, bound to the schema its migrations ran in, where the
|
|
@@ -5166,12 +5434,6 @@ export interface ClientInitializerDependencies {
|
|
|
5166
5434
|
/** The read-model store, for moving data that used to live there. */
|
|
5167
5435
|
readModelDb: Kysely<unknown>;
|
|
5168
5436
|
}
|
|
5169
|
-
/**
|
|
5170
|
-
* The permission cache TTL from `DOCUMENT_PERMISSION_CACHE_TTL_MS`: a
|
|
5171
|
-
* non-negative integer of milliseconds, 0 disabling the cache. Anything else
|
|
5172
|
-
* falls back to the default with a warning.
|
|
5173
|
-
*/
|
|
5174
|
-
export declare function resolvePermissionCacheTtlMs(raw: string | undefined, logger: ILogger): number;
|
|
5175
5437
|
export declare function initializeAndStartAPI(clientInitializer: (documentModels: DocumentModelModule[], dependencies: ClientInitializerDependencies) => Promise<ClientInitializerResult>, options: Options, processorApp: ProcessorApp): Promise<API & {
|
|
5176
5438
|
/** @deprecated Use `read` and `write`. */
|
|
5177
5439
|
client: IReactorClient;
|
|
@@ -5212,6 +5474,6 @@ export declare class PrivacyPermissionAdapter {
|
|
|
5212
5474
|
erasePermissions(documentId: string): Promise<Record<string, number>>;
|
|
5213
5475
|
}
|
|
5214
5476
|
//#endregion
|
|
5215
|
-
export { type AttachmentReadGate, type AuthorizationConfig, type AuthorizerResult, type CanonicalDocumentId, DocumentModelSchema, DocumentModelSchemaCache, DocumentModelSchemaOptions, DocumentModelSource, GeneratedDocumentModelTypes, type HttpRouteServiceOptions, type IAuthorizationService, type IDocumentScopeGate, type IEventLoopDelaySource, type IHttpScope, type IPackageLoader, type IPackageLoaderOptions, type IPackagePieceSource, type IReactorInspectionSource, type IWebhookEndpoints, type IWebhookScope, type IWebhookStore, type InspectionCallerGate, type InspectionReadField, type InspectionThrottleConfig, type NodeRouteSpec, PGLITE_UTC_PARSERS, type PackagePiece, type PackagePieceEntry, type PackagesSubgraphArgs, type ParsedDriveUrl, type ReactorInspectionOptions, ReportError, type RequestClients, type RequestLoadRecorderOptions, ReservedTypeNames, ResolvedDocumentModelSchema, type RouteActor, type RouteAuth, type RouteAuthorizer, type RouteBody, type RouteContext, type RouteHandler, type RouteMethod, type RouteOptions, type RouteSpec, type RouteTransport, type RouteUser, RunDetachedOptions, type ScopedRouteHandle, SubgraphSchemaOptions, SubgraphTypeCollisionError, type WebhookEndpointInfo, type WebhookEndpointRow, type WebhookField, type WebhookHashAlgorithm, type WebhookPolicy, type WebhookReply, type WebhookRequest, type WebhookScheme, type WebhookSignatureEncoding, type WebhookSpec, type WebhookVerification, assembleSubgraphTypeDefs, buildDocumentModelSchema, buildSubgraphSchemaModule, createMergedSchema, createSchema, documentModelSubgraphTypes, driveIdFromUrl, findSubgraphTypeCollisions, generateDocumentModelSchema, generatedTypesOf, getDocumentModelSchemaName, getDocumentModelSubgraphName, getDocumentModelTypeDefs, getGeneratedDocumentModelTypes, hasOperationSchemas, parseDriveUrl, reportFailure, reservedTypeNames, reservedTypeNamesTaken, runDetached, typeDefinitionNames };
|
|
5477
|
+
export { type AttachmentReadGate, type AuthorizationConfig, type AuthorizerResult, type CanonicalDocumentId, DocumentModelSchema, DocumentModelSchemaCache, DocumentModelSchemaOptions, DocumentModelSource, GeneratedDocumentModelTypes, type HttpRouteServiceOptions, type IAuthorizationService, type IDocumentScopeGate, type IEventLoopDelaySource, type IHttpScope, type IPackageLoader, type IPackageLoaderOptions, type IPackagePieceSource, type IReactorInspectionSource, type IWebhookEndpoints, type IWebhookScope, type IWebhookStore, type InspectionCallerGate, type InspectionReadField, type InspectionThrottleConfig, type NodeRouteSpec, PGLITE_UTC_PARSERS, type PackagePiece, type PackagePieceEntry, type PackagesSubgraphArgs, type ParsedDriveUrl, type PublicOrigin, type ReactorInspectionOptions, ReportError, type RequestClients, type RequestLoadRecorderOptions, ReservedTypeNames, ResolvedDocumentModelSchema, type RouteActor, type RouteAuth, type RouteAuthorizer, type RouteBody, type RouteContext, type RouteHandler, type RouteMethod, type RouteOptions, type RouteSpec, type RouteTransport, type RouteUser, RunDetachedOptions, type ScopedRouteHandle, SubgraphSchemaOptions, SubgraphTypeCollisionError, type WebhookEndpointInfo, type WebhookEndpointRow, type WebhookField, type WebhookHashAlgorithm, type WebhookPolicy, type WebhookReply, type WebhookRequest, type WebhookScheme, type WebhookSignatureEncoding, type WebhookSpec, type WebhookVerification, assembleSubgraphTypeDefs, buildDocumentModelSchema, buildSubgraphSchemaModule, createMergedSchema, createSchema, documentModelSubgraphTypes, driveIdFromUrl, findSubgraphTypeCollisions, generateDocumentModelSchema, generatedTypesOf, getDocumentModelSchemaName, getDocumentModelSubgraphName, getDocumentModelTypeDefs, getGeneratedDocumentModelTypes, hasOperationSchemas, parseDriveUrl, reportFailure, reservedTypeNames, reservedTypeNamesTaken, runDetached, typeDefinitionNames };
|
|
5216
5478
|
export {};
|
|
5217
5479
|
//# sourceMappingURL=index.d.mts.map
|