@prisma-next/runtime-executor 0.2.0 → 0.3.0-dev.10

package/dist/async-iterable-result.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Custom async iterable result that extends AsyncIterable with a toArray() method.
+ * This provides a convenient way to collect all results from an async iterator.
+ */
+export 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[]>;
+}
+//# sourceMappingURL=async-iterable-result.d.ts.map

package/dist/async-iterable-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-iterable-result.d.ts","sourceRoot":"","sources":["../src/async-iterable-result.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,mBAAmB,CAAC,GAAG,CAAE,YAAW,aAAa,CAAC,GAAG,CAAC;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAqC;gBAE3C,SAAS,EAAE,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC;IAIzD,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC;IAmB5C;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;CAsBhC"}

package/dist/errors.d.ts

@@ -0,0 +1,8 @@
+export interface RuntimeErrorEnvelope extends Error {
+    readonly code: string;
+    readonly category: 'PLAN' | 'CONTRACT' | 'LINT' | 'BUDGET' | 'RUNTIME';
+    readonly severity: 'error';
+    readonly details?: Record<string, unknown>;
+}
+export declare function runtimeError(code: string, message: string, details?: Record<string, unknown>): RuntimeErrorEnvelope;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAqB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,oBAAoB,CActB"}

package/dist/exports/index.d.ts

@@ -0,0 +1,17 @@
+export { AsyncIterableResult } from '../async-iterable-result';
+export type { RuntimeErrorEnvelope } from '../errors';
+export { runtimeError } from '../errors';
+export { computeSqlFingerprint } from '../fingerprint';
+export type { BudgetFinding, LintFinding, RawGuardrailResult } from '../guardrails/raw';
+export { evaluateRawGuardrails } from '../guardrails/raw';
+export type { ContractMarkerRecord } from '../marker';
+export { parseContractMarkerRow } from '../marker';
+export type { BudgetsOptions } from '../plugins/budgets';
+export { budgets } from '../plugins/budgets';
+export type { LintsOptions } from '../plugins/lints';
+export { lints } from '../plugins/lints';
+export type { AfterExecuteResult, Log, Plugin, PluginContext, Severity, } from '../plugins/types';
+export type { RuntimeCore, RuntimeCoreOptions, RuntimeTelemetryEvent, RuntimeVerifyOptions, TelemetryOutcome, } from '../runtime-core';
+export { createRuntimeCore } from '../runtime-core';
+export type { MarkerReader, MarkerStatement, RuntimeFamilyAdapter } from '../runtime-spi';
+//# sourceMappingURL=index.d.ts.map

package/dist/exports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exports/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,YAAY,EACV,kBAAkB,EAClB,GAAG,EACH,MAAM,EACN,aAAa,EACb,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/fingerprint.d.ts

@@ -0,0 +1,2 @@
+export declare function computeSqlFingerprint(sql: string): string;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAMA,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOzD"}

package/dist/guardrails/raw.d.ts

@@ -0,0 +1,28 @@
+import type { ExecutionPlan } from '@prisma-next/contract/types';
+export type LintSeverity = 'error' | 'warn';
+export type BudgetSeverity = 'error' | 'warn';
+export interface LintFinding {
+    readonly code: `LINT.${string}`;
+    readonly severity: LintSeverity;
+    readonly message: string;
+    readonly details?: Record<string, unknown>;
+}
+export interface BudgetFinding {
+    readonly code: `BUDGET.${string}`;
+    readonly severity: BudgetSeverity;
+    readonly message: string;
+    readonly details?: Record<string, unknown>;
+}
+export interface RawGuardrailConfig {
+    readonly budgets?: {
+        readonly unboundedSelectSeverity?: BudgetSeverity;
+        readonly estimatedRows?: number;
+    };
+}
+export interface RawGuardrailResult {
+    readonly lints: LintFinding[];
+    readonly budgets: BudgetFinding[];
+    readonly statement: 'select' | 'mutation' | 'other';
+}
+export declare function evaluateRawGuardrails(plan: ExecutionPlan, config?: RawGuardrailConfig): RawGuardrailResult;
+//# sourceMappingURL=raw.d.ts.map

package/dist/guardrails/raw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../../src/guardrails/raw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,6BAA6B,CAAC;AAErF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;AAC5C,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,QAAQ,CAAC,uBAAuB,CAAC,EAAE,cAAc,CAAC;QAClD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;CACrD;AAQD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,aAAa,EACnB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,kBAAkB,CA4DpB"}

package/dist/index.d.ts

@@ -1,157 +1,2 @@
-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 };
+export * from './exports';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/marker.d.ts

@@ -0,0 +1,13 @@
+import type { ContractMarkerRecord } from '@prisma-next/contract/types';
+export type { ContractMarkerRecord } from '@prisma-next/contract/types';
+export interface ContractMarkerRow {
+    core_hash: string;
+    profile_hash: string;
+    contract_json: unknown | null;
+    canonical_version: number | null;
+    updated_at: Date;
+    app_tag: string | null;
+    meta: unknown | null;
+}
+export declare function parseContractMarkerRow(row: unknown): ContractMarkerRecord;
+//# sourceMappingURL=marker.d.ts.map

package/dist/marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker.d.ts","sourceRoot":"","sources":["../src/marker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAIxE,YAAY,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,IAAI,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CACtB;AAsCD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,CAgCzE"}

package/dist/plugins/budgets.d.ts

@@ -0,0 +1,16 @@
+import type { Plugin } from './types';
+export 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;
+    };
+}
+export declare function budgets<TContract = unknown, TAdapter = unknown, TDriver = unknown>(options?: BudgetsOptions): Plugin<TContract, TAdapter, TDriver>;
+//# sourceMappingURL=budgets.d.ts.map

package/dist/plugins/budgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgets.d.ts","sourceRoot":"","sources":["../../src/plugins/budgets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAsB,MAAM,EAAiB,MAAM,SAAS,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACrC,CAAC;IACF,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;KAC5B,CAAC;CACH;AAmJD,wBAAgB,OAAO,CAAC,SAAS,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAChF,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAmKtC"}

package/dist/plugins/lints.d.ts

@@ -0,0 +1,11 @@
+import type { Plugin } from './types';
+export interface LintsOptions {
+    readonly severities?: {
+        readonly selectStar?: 'warn' | 'error';
+        readonly noLimit?: 'warn' | 'error';
+        readonly readOnlyMutation?: 'warn' | 'error';
+        readonly unindexedPredicate?: 'warn' | 'error';
+    };
+}
+export declare function lints<TContract = unknown, TAdapter = unknown, TDriver = unknown>(options?: LintsOptions): Plugin<TContract, TAdapter, TDriver>;
+//# sourceMappingURL=lints.d.ts.map

package/dist/plugins/lints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lints.d.ts","sourceRoot":"","sources":["../../src/plugins/lints.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,SAAS,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KAChD,CAAC;CACH;AAqBD,wBAAgB,KAAK,CAAC,SAAS,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC9E,OAAO,CAAC,EAAE,YAAY,GACrB,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CA4BtC"}

package/dist/plugins/types.d.ts

@@ -0,0 +1,27 @@
+import type { ExecutionPlan } from '@prisma-next/contract/types';
+export type Severity = 'error' | 'warn' | 'info';
+export interface Log {
+    info(event: unknown): void;
+    warn(event: unknown): void;
+    error(event: unknown): void;
+}
+export 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;
+}
+export interface AfterExecuteResult {
+    readonly rowCount: number;
+    readonly latencyMs: number;
+    readonly completed: boolean;
+}
+export 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>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,GAAG;IAClB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa,CAAC,SAAS,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACvF,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,MAAM,CAAC,SAAS,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,CACZ,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,CAAC,CACJ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,YAAY,CAAC,CACX,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,kBAAkB,EAC1B,GAAG,EAAE,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}

package/dist/runtime-core.d.ts

@@ -0,0 +1,37 @@
+import type { ExecutionPlan } from '@prisma-next/contract/types';
+import type { OperationRegistry } from '@prisma-next/operations';
+import { AsyncIterableResult } from './async-iterable-result';
+import type { Log, Plugin } from './plugins/types';
+import type { RuntimeFamilyAdapter } from './runtime-spi';
+export interface RuntimeVerifyOptions {
+    readonly mode: 'onFirstUse' | 'startup' | 'always';
+    readonly requireMarker: boolean;
+}
+export type TelemetryOutcome = 'success' | 'runtime-error';
+export interface RuntimeTelemetryEvent {
+    readonly lane: string;
+    readonly target: string;
+    readonly fingerprint: string;
+    readonly outcome: TelemetryOutcome;
+    readonly durationMs?: number;
+}
+export 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;
+}
+export 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;
+}
+export declare function createRuntimeCore<TContract = unknown, TAdapter = unknown, TDriver = unknown>(options: RuntimeCoreOptions<TContract, TAdapter, TDriver>): RuntimeCore<TContract, TAdapter, TDriver>;
+//# sourceMappingURL=runtime-core.d.ts.map

package/dist/runtime-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-core.d.ts","sourceRoot":"","sources":["../src/runtime-core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAI9D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;IACnD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,eAAe,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB,CAAC,SAAS,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC5F,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;IACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IACnB,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;CAC/C;AAED,MAAM,WAAW,WAAW,CAAC,SAAS,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAErF,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC3F,SAAS,IAAI,qBAAqB,GAAG,IAAI,CAAC;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,UAAU,IAAI,iBAAiB,CAAC;CACjC;AA6OD,wBAAgB,iBAAiB,CAAC,SAAS,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC1F,OAAO,EAAE,kBAAkB,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,GACxD,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAE3C"}

package/dist/runtime-spi.d.ts

@@ -0,0 +1,14 @@
+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;
+}
+//# sourceMappingURL=runtime-spi.d.ts.map

package/dist/runtime-spi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-spi.d.ts","sourceRoot":"","sources":["../src/runtime-spi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,mBAAmB,IAAI,eAAe,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB,CAAC,SAAS,GAAG,OAAO;IACvD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;CAC9D"}

package/package.json

@@ -1,24 +1,25 @@
 {
   "name": "@prisma-next/runtime-executor",
-  "version": "0.2.0",
+  "version": "0.3.0-dev.10",
   "type": "module",
   "sideEffects": false,
   "description": "Target-agnostic execution engine for Prisma Next",
   "dependencies": {
     "arktype": "^2.1.25",
-    "@prisma-next/contract": "0.2.0",
-    "@prisma-next/operations": "0.2.0"
+    "@prisma-next/operations": "0.3.0-dev.10",
+    "@prisma-next/contract": "0.3.0-dev.10"
   },
   "devDependencies": {
     "@prisma/dev": "0.19.1",
-    "@vitest/coverage-v8": "^4.0.0",
-    "tsup": "^8.3.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.16",
+    "@vitest/coverage-v8": "4.0.16",
+    "tsup": "8.5.1",
+    "typescript": "5.9.3",
+    "vitest": "4.0.16",
     "@prisma-next/test-utils": "0.0.1"
   },
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
   "exports": {
     ".": {
@@ -27,7 +28,7 @@
     }
   },
   "scripts": {
-    "build": "tsup --config tsup.config.ts",
+    "build": "tsup --config tsup.config.ts && tsc --project tsconfig.build.json",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --project tsconfig.json --noEmit",

package/src/async-iterable-result.ts

@@ -0,0 +1,61 @@
+import { runtimeError } from './errors';
+
+/**
+ * Custom async iterable result that extends AsyncIterable with a toArray() method.
+ * This provides a convenient way to collect all results from an async iterator.
+ */
+export class AsyncIterableResult<Row> implements AsyncIterable<Row> {
+  private readonly generator: AsyncGenerator<Row, void, unknown>;
+  private consumed = false;
+  private consumedBy: 'toArray' | 'iterator' | undefined;
+
+  constructor(generator: AsyncGenerator<Row, void, unknown>) {
+    this.generator = generator;
+  }
+
+  [Symbol.asyncIterator](): AsyncIterator<Row> {
+    if (this.consumed) {
+      throw runtimeError(
+        'RUNTIME.ITERATOR_CONSUMED',
+        `AsyncIterableResult iterator has already been consumed via ${this.consumedBy === 'toArray' ? 'toArray()' : 'for-await loop'}. Each AsyncIterableResult can only be iterated once.`,
+        {
+          consumedBy: this.consumedBy,
+          suggestion:
+            this.consumedBy === 'toArray'
+              ? 'If you need to iterate multiple times, store the results from toArray() in a variable and reuse that.'
+              : 'If you need to iterate multiple times, use toArray() to collect all results first.',
+        },
+      );
+    }
+    this.consumed = true;
+    this.consumedBy = 'iterator';
+    return this.generator;
+  }
+
+  /**
+   * Collects all values from the async iterator into an array.
+   * Once called, the iterator is consumed and cannot be reused.
+   */
+  async toArray(): Promise<Row[]> {
+    if (this.consumed) {
+      throw runtimeError(
+        'RUNTIME.ITERATOR_CONSUMED',
+        `AsyncIterableResult iterator has already been consumed via ${this.consumedBy === 'toArray' ? 'toArray()' : 'for-await loop'}. Each AsyncIterableResult can only be iterated once.`,
+        {
+          consumedBy: this.consumedBy,
+          suggestion:
+            this.consumedBy === 'toArray'
+              ? 'You cannot call toArray() twice on the same AsyncIterableResult. Store the result from the first call in a variable and reuse that.'
+              : 'The iterator was already consumed by a for-await loop. Use toArray() to collect all results before iterating.',
+        },
+      );
+    }
+    this.consumed = true;
+    this.consumedBy = 'toArray';
+    const out: Row[] = [];
+    for await (const item of this.generator) {
+      out.push(item);
+    }
+    return out;
+  }
+}

package/src/errors.ts

@@ -0,0 +1,39 @@
+export interface RuntimeErrorEnvelope extends Error {
+  readonly code: string;
+  readonly category: 'PLAN' | 'CONTRACT' | 'LINT' | 'BUDGET' | 'RUNTIME';
+  readonly severity: 'error';
+  readonly details?: Record<string, unknown>;
+}
+
+export function runtimeError(
+  code: string,
+  message: string,
+  details?: Record<string, unknown>,
+): RuntimeErrorEnvelope {
+  const error = new Error(message) as RuntimeErrorEnvelope;
+  Object.defineProperty(error, 'name', {
+    value: 'RuntimeError',
+    configurable: true,
+  });
+
+  return Object.assign(error, {
+    code,
+    category: resolveCategory(code),
+    severity: 'error' as const,
+    message,
+    details,
+  });
+}
+
+function resolveCategory(code: string): RuntimeErrorEnvelope['category'] {
+  const prefix = code.split('.')[0] ?? 'RUNTIME';
+  switch (prefix) {
+    case 'PLAN':
+    case 'CONTRACT':
+    case 'LINT':
+    case 'BUDGET':
+      return prefix;
+    default:
+      return 'RUNTIME';
+  }
+}

package/src/exports/index.ts

@@ -0,0 +1,28 @@
+export { AsyncIterableResult } from '../async-iterable-result';
+export type { RuntimeErrorEnvelope } from '../errors';
+export { runtimeError } from '../errors';
+export { computeSqlFingerprint } from '../fingerprint';
+export type { BudgetFinding, LintFinding, RawGuardrailResult } from '../guardrails/raw';
+export { evaluateRawGuardrails } from '../guardrails/raw';
+export type { ContractMarkerRecord } from '../marker';
+export { parseContractMarkerRow } from '../marker';
+export type { BudgetsOptions } from '../plugins/budgets';
+export { budgets } from '../plugins/budgets';
+export type { LintsOptions } from '../plugins/lints';
+export { lints } from '../plugins/lints';
+export type {
+  AfterExecuteResult,
+  Log,
+  Plugin,
+  PluginContext,
+  Severity,
+} from '../plugins/types';
+export type {
+  RuntimeCore,
+  RuntimeCoreOptions,
+  RuntimeTelemetryEvent,
+  RuntimeVerifyOptions,
+  TelemetryOutcome,
+} from '../runtime-core';
+export { createRuntimeCore } from '../runtime-core';
+export type { MarkerReader, MarkerStatement, RuntimeFamilyAdapter } from '../runtime-spi';

package/src/fingerprint.ts

@@ -0,0 +1,14 @@
+import { createHash } from 'node:crypto';
+
+const STRING_LITERAL_REGEX = /'(?:''|[^'])*'/g;
+const NUMERIC_LITERAL_REGEX = /\b\d+(?:\.\d+)?\b/g;
+const WHITESPACE_REGEX = /\s+/g;
+
+export function computeSqlFingerprint(sql: string): string {
+  const withoutStrings = sql.replace(STRING_LITERAL_REGEX, '?');
+  const withoutNumbers = withoutStrings.replace(NUMERIC_LITERAL_REGEX, '?');
+  const normalized = withoutNumbers.replace(WHITESPACE_REGEX, ' ').trim().toLowerCase();
+
+  const hash = createHash('sha256').update(normalized).digest('hex');
+  return `sha256:${hash}`;
+}