@prisma-next/runtime-executor 0.3.0-pr.93.5 → 0.3.0-pr.94.2

package/dist/index.d.mts

@@ -0,0 +1,167 @@
+import { ContractMarkerRecord, ContractMarkerRecord as ContractMarkerRecord$1, ExecutionPlan } from "@prisma-next/contract/types";
+import { OperationRegistry } from "@prisma-next/operations";
+
+//#region src/async-iterable-result.d.ts
+/**
+ * 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[]>;
+}
+//#endregion
+//#region src/errors.d.ts
+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;
+//#endregion
+//#region src/fingerprint.d.ts
+declare function computeSqlFingerprint(sql: string): string;
+//#endregion
+//#region src/guardrails/raw.d.ts
+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;
+//#endregion
+//#region src/marker.d.ts
+declare function parseContractMarkerRow(row: unknown): ContractMarkerRecord$1;
+//#endregion
+//#region src/plugins/types.d.ts
+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>;
+}
+//#endregion
+//#region src/plugins/budgets.d.ts
+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>;
+//#endregion
+//#region src/plugins/lints.d.ts
+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>;
+//#endregion
+//#region src/runtime-spi.d.ts
+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;
+}
+//#endregion
+//#region src/runtime-core.d.ts
+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>;
+//#endregion
+export { AfterExecuteResult, AsyncIterableResult, BudgetFinding, BudgetsOptions, type ContractMarkerRecord, LintFinding, LintsOptions, Log, MarkerReader, MarkerStatement, Plugin, PluginContext, RawGuardrailResult, RuntimeCore, RuntimeCoreOptions, RuntimeErrorEnvelope, RuntimeFamilyAdapter, RuntimeTelemetryEvent, RuntimeVerifyOptions, Severity, TelemetryOutcome, budgets, computeSqlFingerprint, createRuntimeCore, evaluateRawGuardrails, lints, parseContractMarkerRow, runtimeError };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/async-iterable-result.ts","../src/errors.ts","../src/fingerprint.ts","../src/guardrails/raw.ts","../src/marker.ts","../src/plugins/types.ts","../src/plugins/budgets.ts","../src/plugins/lints.ts","../src/runtime-spi.ts","../src/runtime-core.ts"],"sourcesContent":[],"mappings":"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"}