@prisma-next/runtime-executor 0.3.0-dev.1 → 0.3.0-dev.100

package/src/runtime-spi.ts

@@ -0,0 +1,16 @@
+import type { ExecutionPlan } from '@prisma-next/contract/types';
+
+export interface MarkerStatement {
+  readonly sql: string;
+  readonly params: readonly unknown[];
+}
+
+export interface MarkerReader {
+  readMarkerStatement(): MarkerStatement;
+}
+
+export interface RuntimeFamilyAdapter<TContract = unknown> {
+  readonly contract: TContract;
+  readonly markerReader: MarkerReader;
+  validatePlan(plan: ExecutionPlan, contract: TContract): void;
+}

package/dist/index.d.ts

@@ -1,157 +0,0 @@
-import { ExecutionPlan, ContractMarkerRecord } from '@prisma-next/contract/types';
-export { ContractMarkerRecord } from '@prisma-next/contract/types';
-import { OperationRegistry } from '@prisma-next/operations';
-
-/**
- * Custom async iterable result that extends AsyncIterable with a toArray() method.
- * This provides a convenient way to collect all results from an async iterator.
- */
-declare class AsyncIterableResult<Row> implements AsyncIterable<Row> {
-    private readonly generator;
-    private consumed;
-    private consumedBy;
-    constructor(generator: AsyncGenerator<Row, void, unknown>);
-    [Symbol.asyncIterator](): AsyncIterator<Row>;
-    /**
-     * Collects all values from the async iterator into an array.
-     * Once called, the iterator is consumed and cannot be reused.
-     */
-    toArray(): Promise<Row[]>;
-}
-
-interface RuntimeErrorEnvelope extends Error {
-    readonly code: string;
-    readonly category: 'PLAN' | 'CONTRACT' | 'LINT' | 'BUDGET' | 'RUNTIME';
-    readonly severity: 'error';
-    readonly details?: Record<string, unknown>;
-}
-declare function runtimeError(code: string, message: string, details?: Record<string, unknown>): RuntimeErrorEnvelope;
-
-declare function computeSqlFingerprint(sql: string): string;
-
-type LintSeverity = 'error' | 'warn';
-type BudgetSeverity = 'error' | 'warn';
-interface LintFinding {
-    readonly code: `LINT.${string}`;
-    readonly severity: LintSeverity;
-    readonly message: string;
-    readonly details?: Record<string, unknown>;
-}
-interface BudgetFinding {
-    readonly code: `BUDGET.${string}`;
-    readonly severity: BudgetSeverity;
-    readonly message: string;
-    readonly details?: Record<string, unknown>;
-}
-interface RawGuardrailConfig {
-    readonly budgets?: {
-        readonly unboundedSelectSeverity?: BudgetSeverity;
-        readonly estimatedRows?: number;
-    };
-}
-interface RawGuardrailResult {
-    readonly lints: LintFinding[];
-    readonly budgets: BudgetFinding[];
-    readonly statement: 'select' | 'mutation' | 'other';
-}
-declare function evaluateRawGuardrails(plan: ExecutionPlan, config?: RawGuardrailConfig): RawGuardrailResult;
-
-declare function parseContractMarkerRow(row: unknown): ContractMarkerRecord;
-
-type Severity = 'error' | 'warn' | 'info';
-interface Log {
-    info(event: unknown): void;
-    warn(event: unknown): void;
-    error(event: unknown): void;
-}
-interface PluginContext<TContract = unknown, TAdapter = unknown, TDriver = unknown> {
-    readonly contract: TContract;
-    readonly adapter: TAdapter;
-    readonly driver: TDriver;
-    readonly mode: 'strict' | 'permissive';
-    readonly now: () => number;
-    readonly log: Log;
-}
-interface AfterExecuteResult {
-    readonly rowCount: number;
-    readonly latencyMs: number;
-    readonly completed: boolean;
-}
-interface Plugin<TContract = unknown, TAdapter = unknown, TDriver = unknown> {
-    readonly name: string;
-    beforeExecute?(plan: ExecutionPlan, ctx: PluginContext<TContract, TAdapter, TDriver>): Promise<void>;
-    onRow?(row: Record<string, unknown>, plan: ExecutionPlan, ctx: PluginContext<TContract, TAdapter, TDriver>): Promise<void>;
-    afterExecute?(plan: ExecutionPlan, result: AfterExecuteResult, ctx: PluginContext<TContract, TAdapter, TDriver>): Promise<void>;
-}
-
-interface BudgetsOptions {
-    readonly maxRows?: number;
-    readonly defaultTableRows?: number;
-    readonly tableRows?: Record<string, number>;
-    readonly maxLatencyMs?: number;
-    readonly severities?: {
-        readonly rowCount?: 'warn' | 'error';
-        readonly latency?: 'warn' | 'error';
-    };
-    readonly explain?: {
-        readonly enabled?: boolean;
-    };
-}
-declare function budgets<TContract = unknown, TAdapter = unknown, TDriver = unknown>(options?: BudgetsOptions): Plugin<TContract, TAdapter, TDriver>;
-
-interface LintsOptions {
-    readonly severities?: {
-        readonly selectStar?: 'warn' | 'error';
-        readonly noLimit?: 'warn' | 'error';
-        readonly readOnlyMutation?: 'warn' | 'error';
-        readonly unindexedPredicate?: 'warn' | 'error';
-    };
-}
-declare function lints<TContract = unknown, TAdapter = unknown, TDriver = unknown>(options?: LintsOptions): Plugin<TContract, TAdapter, TDriver>;
-
-interface MarkerStatement {
-    readonly sql: string;
-    readonly params: readonly unknown[];
-}
-interface MarkerReader {
-    readMarkerStatement(): MarkerStatement;
-}
-interface RuntimeFamilyAdapter<TContract = unknown> {
-    readonly contract: TContract;
-    readonly markerReader: MarkerReader;
-    validatePlan(plan: ExecutionPlan, contract: TContract): void;
-}
-
-interface RuntimeVerifyOptions {
-    readonly mode: 'onFirstUse' | 'startup' | 'always';
-    readonly requireMarker: boolean;
-}
-type TelemetryOutcome = 'success' | 'runtime-error';
-interface RuntimeTelemetryEvent {
-    readonly lane: string;
-    readonly target: string;
-    readonly fingerprint: string;
-    readonly outcome: TelemetryOutcome;
-    readonly durationMs?: number;
-}
-interface RuntimeCoreOptions<TContract = unknown, TAdapter = unknown, TDriver = unknown> {
-    readonly familyAdapter: RuntimeFamilyAdapter<TContract>;
-    readonly driver: TDriver;
-    readonly verify: RuntimeVerifyOptions;
-    readonly plugins?: readonly Plugin<TContract, TAdapter, TDriver>[];
-    readonly mode?: 'strict' | 'permissive';
-    readonly log?: Log;
-    readonly operationRegistry: OperationRegistry;
-}
-interface RuntimeCore<TContract = unknown, TAdapter = unknown, TDriver = unknown> {
-    readonly _typeContract?: TContract;
-    readonly _typeAdapter?: TAdapter;
-    readonly _typeDriver?: TDriver;
-    execute<Row = Record<string, unknown>>(plan: ExecutionPlan<Row>): AsyncIterableResult<Row>;
-    telemetry(): RuntimeTelemetryEvent | null;
-    close(): Promise<void>;
-    operations(): OperationRegistry;
-}
-declare function createRuntimeCore<TContract = unknown, TAdapter = unknown, TDriver = unknown>(options: RuntimeCoreOptions<TContract, TAdapter, TDriver>): RuntimeCore<TContract, TAdapter, TDriver>;
-
-export { type AfterExecuteResult, AsyncIterableResult, type BudgetFinding, type BudgetsOptions, type LintFinding, type LintsOptions, type Log, type MarkerReader, type MarkerStatement, type Plugin, type PluginContext, type RawGuardrailResult, type RuntimeCore, type RuntimeCoreOptions, type RuntimeErrorEnvelope, type RuntimeFamilyAdapter, type RuntimeTelemetryEvent, type RuntimeVerifyOptions, type Severity, type TelemetryOutcome, budgets, computeSqlFingerprint, createRuntimeCore, evaluateRawGuardrails, lints, parseContractMarkerRow, runtimeError };