openworkgraph 0.2.12

package/dist/graphs.d.ts

@@ -0,0 +1,68 @@
+import { GraphDocumentVersions } from './graph-document-history.js';
+import type { DatabaseSync } from 'node:sqlite';
+import type { DeleteGraph, Edge, GraphCommand, GraphScope, GraphSnapshot, Json, Node } from "./vendor/protocol/index.js";
+import { Repositories } from './persistence/repositories.js';
+import type { Resources } from './resources.js';
+export declare function assertProjectWritable(db: DatabaseSync, id: string): void;
+export declare function nodeDimension(value: unknown): asserts value is number;
+export declare function resourceLinks(content: Json): {
+    resourceId: string;
+    version: number;
+}[];
+export declare class Graphs {
+    readonly db: DatabaseSync;
+    readonly serviceId: string;
+    readonly repo: Repositories;
+    readonly history: GraphDocumentVersions;
+    private readonly pageKey;
+    private readonly pageEpoch;
+    constructor(db: DatabaseSync, serviceId: string);
+    scope(scope: GraphScope): Record<string, unknown>;
+    writable(scope: GraphScope, allowArchived?: boolean): Record<string, unknown>;
+    snapshot(scope: GraphScope): GraphSnapshot;
+    list(projectId: string, includeArchived?: boolean, includeInactive?: boolean, trashed?: boolean): GraphSnapshot[];
+    /** Read-only pagination; no saved snapshots, idempotency records or GC work.
+     * One transaction fingerprints and reads the list. Cursors survive unrelated
+     * service events, but not project graph changes or a service restart. */
+    page(projectId: string, request: Record<string, unknown>, principal: string): {
+        items: GraphSnapshot[];
+        nextCursor: string | null;
+        snapshotId: string;
+        eventCursor: string;
+    };
+    create(projectId: string, name: string, key: string, principal?: string): GraphSnapshot;
+    event(scope: GraphScope): void;
+    activeNode(nodeId: string): boolean;
+    private activeExecutionChainNodeIds;
+    activeExecutionChain(scope: GraphScope): boolean;
+    private assertChainTopologyEditable;
+    assertSettled(scope: GraphScope): void;
+    /** A lifecycle operation is never mixed with edits, even if it restores writability. */
+    private lifecycle;
+    permanentDelete(request: DeleteGraph, resources: Resources, principal?: string): {
+        graphId: string;
+        deleted: true;
+    };
+    /** Submit owns the transaction; retirement never edits frozen snapshots or Run files. */
+    retireExecutionOutputs(scope: GraphScope, executionNodeId: string): void;
+    private restoreOutput;
+    assertNodeEditable(nodeId: string): void;
+    private assertContentEditable;
+    private validateContent;
+    private node;
+    private group;
+    private members;
+    private assertLayoutEditable;
+    private assertGeometryEditable;
+    /** Membership is layout metadata, never a node content/resource revision. */
+    setGroupMembers(scope: GraphScope, groupId: string, memberIds: string[]): void;
+    private move;
+    private resize;
+    /** All retained node content versions protect resources independently of live node references. */
+    retainResources(scope: GraphScope, nodeId: string, version: number, content: Json): void;
+    private validateFileNode;
+    /** Trusted publication/import only. Public commands cannot create delivery edges/read-only nodes. */
+    insertNode(scope: GraphScope, node: Node, trusted?: boolean): void;
+    validateEdge(scope: GraphScope, edge: Edge, trusted?: boolean): void;
+    command(command: GraphCommand, principal?: string): GraphSnapshot;
+}