@prisma/param-graph-builder 7.6.0 → 7.7.0-dev.2

package/dist/index.d.mts

@@ -0,0 +1,110 @@
+import type * as DMMF from '@prisma/dmmf';
+import type { InputEdgeData } from '@prisma/param-graph';
+import type { OutputEdgeData } from '@prisma/param-graph';
+import type { ParamGraphData } from '@prisma/param-graph';
+import type { RootEntryData } from '@prisma/param-graph';
+import type { SerializedParamGraph } from '@prisma/param-graph';
+
+/**
+ * Builds and serializes a ParamGraph from DMMF schema.
+ *
+ * This is the primary API for generators - it returns the compact
+ * serialized format ready to be embedded in generated clients.
+ *
+ * @param dmmf - The DMMF document from the schema
+ * @returns The serialized param graph
+ */
+export declare function buildAndSerializeParamGraph(dmmf: DMMF.Document): SerializedParamGraph;
+
+/**
+ * Builds a ParamGraphData from DMMF schema.
+ *
+ * @param dmmf - The DMMF document from the schema
+ * @returns The param graph data structure
+ */
+export declare function buildParamGraph(dmmf: DMMF.Document): ParamGraphData;
+
+/**
+ * Traverses DMMF and populates a ParamGraphBuilder.
+ */
+export declare class DMMFTraverser {
+    #private;
+    constructor(builder: ParamGraphBuilder, dmmf: DMMF.Document);
+    /**
+     * Process all root operations from model mappings.
+     */
+    processRoots(mappings: readonly DMMF.ModelMapping[]): void;
+    /**
+     * Builds an input node from schema arguments.
+     */
+    buildInputNodeFromArgs(args: readonly DMMF.SchemaArg[]): NodeId | undefined;
+    /**
+     * Builds an input node for a named input type.
+     * Node allocation happens immediately, but field processing is deferred
+     * to avoid deep recursion.
+     */
+    buildInputTypeNode(typeName: string): NodeId | undefined;
+    /**
+     * Builds a union node for multiple input types.
+     * Node allocation happens immediately, but field processing is deferred
+     * to avoid deep recursion.
+     */
+    buildUnionNode(typeNames: string[]): NodeId | undefined;
+    /**
+     * Builds an output node for a named output type.
+     */
+    buildOutputTypeNode(typeName: string): NodeId | undefined;
+}
+
+export declare type NodeId = number;
+
+/**
+ * Builder class that accumulates graph data during construction.
+ */
+export declare class ParamGraphBuilder {
+    #private;
+    /**
+     * Interns a string into the string table, returning its index.
+     * Both field names and enum names go through this method.
+     */
+    internString(str: string): number;
+    /**
+     * Allocates a new input node and returns its ID.
+     */
+    allocateInputNode(): NodeId;
+    /**
+     * Sets edges on an input node.
+     */
+    setInputNodeEdges(nodeId: NodeId, edges: Record<number, InputEdgeData>): void;
+    /**
+     * Allocates a new output node and returns its ID.
+     */
+    allocateOutputNode(): NodeId;
+    /**
+     * Sets edges on an output node.
+     */
+    setOutputNodeEdges(nodeId: NodeId, edges: Record<number, OutputEdgeData>): void;
+    /**
+     * Records a root entry for an operation.
+     */
+    setRoot(key: string, entry: RootEntryData): void;
+    getInputTypeNode(typeName: string): NodeId | undefined;
+    setInputTypeNode(typeName: string, nodeId: NodeId | undefined): void;
+    hasInputTypeNode(typeName: string): boolean;
+    getUnionNode(key: string): NodeId | undefined;
+    setUnionNode(key: string, nodeId: NodeId | undefined): void;
+    hasUnionNode(key: string): boolean;
+    getOutputTypeNode(typeName: string): NodeId | undefined;
+    setOutputTypeNode(typeName: string, nodeId: NodeId | undefined): void;
+    hasOutputTypeNode(typeName: string): boolean;
+    /**
+     * Builds the final ParamGraphData structure.
+     */
+    build(): ParamGraphData;
+    /**
+     * Builds and serializes to the compact binary format.
+     */
+    buildAndSerialize(): SerializedParamGraph;
+}
+
+export { }

package/dist/index.d.ts

@@ -1,4 +1,110 @@
-export { buildAndSerializeParamGraph, buildParamGraph } from './build-param-graph';
-export { DMMFTraverser } from './dmmf-traverser';
-export type { NodeId } from './param-graph-builder';
-export { ParamGraphBuilder } from './param-graph-builder';
+import type * as DMMF from '@prisma/dmmf';
+import type { InputEdgeData } from '@prisma/param-graph';
+import type { OutputEdgeData } from '@prisma/param-graph';
+import type { ParamGraphData } from '@prisma/param-graph';
+import type { RootEntryData } from '@prisma/param-graph';
+import type { SerializedParamGraph } from '@prisma/param-graph';
+
+/**
+ * Builds and serializes a ParamGraph from DMMF schema.
+ *
+ * This is the primary API for generators - it returns the compact
+ * serialized format ready to be embedded in generated clients.
+ *
+ * @param dmmf - The DMMF document from the schema
+ * @returns The serialized param graph
+ */
+export declare function buildAndSerializeParamGraph(dmmf: DMMF.Document): SerializedParamGraph;
+
+/**
+ * Builds a ParamGraphData from DMMF schema.
+ *
+ * @param dmmf - The DMMF document from the schema
+ * @returns The param graph data structure
+ */
+export declare function buildParamGraph(dmmf: DMMF.Document): ParamGraphData;
+
+/**
+ * Traverses DMMF and populates a ParamGraphBuilder.
+ */
+export declare class DMMFTraverser {
+    #private;
+    constructor(builder: ParamGraphBuilder, dmmf: DMMF.Document);
+    /**
+     * Process all root operations from model mappings.
+     */
+    processRoots(mappings: readonly DMMF.ModelMapping[]): void;
+    /**
+     * Builds an input node from schema arguments.
+     */
+    buildInputNodeFromArgs(args: readonly DMMF.SchemaArg[]): NodeId | undefined;
+    /**
+     * Builds an input node for a named input type.
+     * Node allocation happens immediately, but field processing is deferred
+     * to avoid deep recursion.
+     */
+    buildInputTypeNode(typeName: string): NodeId | undefined;
+    /**
+     * Builds a union node for multiple input types.
+     * Node allocation happens immediately, but field processing is deferred
+     * to avoid deep recursion.
+     */
+    buildUnionNode(typeNames: string[]): NodeId | undefined;
+    /**
+     * Builds an output node for a named output type.
+     */
+    buildOutputTypeNode(typeName: string): NodeId | undefined;
+}
+
+export declare type NodeId = number;
+
+/**
+ * Builder class that accumulates graph data during construction.
+ */
+export declare class ParamGraphBuilder {
+    #private;
+    /**
+     * Interns a string into the string table, returning its index.
+     * Both field names and enum names go through this method.
+     */
+    internString(str: string): number;
+    /**
+     * Allocates a new input node and returns its ID.
+     */
+    allocateInputNode(): NodeId;
+    /**
+     * Sets edges on an input node.
+     */
+    setInputNodeEdges(nodeId: NodeId, edges: Record<number, InputEdgeData>): void;
+    /**
+     * Allocates a new output node and returns its ID.
+     */
+    allocateOutputNode(): NodeId;
+    /**
+     * Sets edges on an output node.
+     */
+    setOutputNodeEdges(nodeId: NodeId, edges: Record<number, OutputEdgeData>): void;
+    /**
+     * Records a root entry for an operation.
+     */
+    setRoot(key: string, entry: RootEntryData): void;
+    getInputTypeNode(typeName: string): NodeId | undefined;
+    setInputTypeNode(typeName: string, nodeId: NodeId | undefined): void;
+    hasInputTypeNode(typeName: string): boolean;
+    getUnionNode(key: string): NodeId | undefined;
+    setUnionNode(key: string, nodeId: NodeId | undefined): void;
+    hasUnionNode(key: string): boolean;
+    getOutputTypeNode(typeName: string): NodeId | undefined;
+    setOutputTypeNode(typeName: string, nodeId: NodeId | undefined): void;
+    hasOutputTypeNode(typeName: string): boolean;
+    /**
+     * Builds the final ParamGraphData structure.
+     */
+    build(): ParamGraphData;
+    /**
+     * Builds and serializes to the compact binary format.
+     */
+    buildAndSerialize(): SerializedParamGraph;
+}
+
+export { }