@prisma-next/sql-runtime 0.3.0-dev.3 → 0.3.0-dev.30

package/dist/src/sql-context.d.ts

@@ -0,0 +1,130 @@
+import type { RuntimeAdapterDescriptor, RuntimeAdapterInstance, RuntimeExtensionDescriptor, RuntimeExtensionInstance, RuntimeTargetDescriptor } from '@prisma-next/core-execution-plane/types';
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+import type { SqlOperationSignature } from '@prisma-next/sql-operations';
+import type { Adapter, CodecRegistry, LoweredStatement, QueryAst } from '@prisma-next/sql-relational-core/ast';
+import type { QueryLaneContext, TypeHelperRegistry } from '@prisma-next/sql-relational-core/query-lane-context';
+import type { Type } from 'arktype';
+/**
+ * Runtime parameterized codec descriptor.
+ * Provides validation schema and optional init hook for codecs that support type parameters.
+ * Used at runtime to validate typeParams and create type helpers.
+ */
+export interface RuntimeParameterizedCodecDescriptor<TParams = Record<string, unknown>, THelper = unknown> {
+    /** The codec ID this descriptor applies to (e.g., 'pg/vector@1') */
+    readonly codecId: string;
+    /**
+     * Arktype schema for validating typeParams.
+     * The schema is used to validate both storage.types entries and inline column typeParams.
+     */
+    readonly paramsSchema: Type<TParams>;
+    /**
+     * Optional init hook called during runtime context creation.
+     * Receives validated params and returns a helper object to be stored in context.types.
+     * If not provided, the validated params are stored directly.
+     */
+    readonly init?: (params: TParams) => THelper;
+}
+/**
+ * SQL runtime extension instance.
+ * Extends the framework RuntimeExtensionInstance with SQL-specific hooks
+ * for contributing codecs and operations to the runtime context.
+ *
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ */
+export interface SqlRuntimeExtensionInstance<TTargetId extends string> extends RuntimeExtensionInstance<'sql', TTargetId> {
+    /** Returns codecs to register in the runtime context. */
+    codecs?(): CodecRegistry;
+    /** Returns operations to register in the runtime context. */
+    operations?(): ReadonlyArray<SqlOperationSignature>;
+    /**
+     * Returns parameterized codec descriptors for type validation and helper creation.
+     * Uses unknown for type parameters to allow any concrete descriptor types.
+     */
+    parameterizedCodecs?(): ReadonlyArray<RuntimeParameterizedCodecDescriptor<any, any>>;
+}
+/**
+ * SQL runtime extension descriptor.
+ * Extends the framework RuntimeExtensionDescriptor with SQL-specific instance type.
+ *
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ */
+export interface SqlRuntimeExtensionDescriptor<TTargetId extends string> extends RuntimeExtensionDescriptor<'sql', TTargetId, SqlRuntimeExtensionInstance<TTargetId>> {
+    create(): SqlRuntimeExtensionInstance<TTargetId>;
+}
+/**
+ * SQL runtime adapter instance interface.
+ * Combines RuntimeAdapterInstance identity with SQL Adapter behavior.
+ * The instance IS an Adapter (via intersection), not HAS an adapter property.
+ *
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ */
+export type SqlRuntimeAdapterInstance<TTargetId extends string = string> = RuntimeAdapterInstance<'sql', TTargetId> & Adapter<QueryAst, SqlContract<SqlStorage>, LoweredStatement>;
+export type { TypeHelperRegistry };
+export interface RuntimeContext<TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>> extends QueryLaneContext<TContract> {
+    readonly adapter: Adapter<QueryAst, TContract, LoweredStatement> | Adapter<QueryAst, SqlContract<SqlStorage>, LoweredStatement>;
+    /**
+     * Initialized type helpers from storage.types.
+     * Each entry corresponds to a named type instance in the contract's storage.types.
+     * The value is the result of calling the codec's init hook (if provided)
+     * or the validated typeParams (if no init hook).
+     */
+    readonly types?: TypeHelperRegistry;
+}
+/**
+ * Descriptor-first options for creating a SQL runtime context.
+ * Takes the same framework composition as control-plane: target, adapter, extensionPacks.
+ *
+ * @template TContract - The SQL contract type
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ */
+export interface CreateRuntimeContextOptions<TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>, TTargetId extends string = string> {
+    readonly contract: TContract;
+    readonly target: RuntimeTargetDescriptor<'sql', TTargetId>;
+    readonly adapter: RuntimeAdapterDescriptor<'sql', TTargetId, SqlRuntimeAdapterInstance<TTargetId>>;
+    readonly extensionPacks?: ReadonlyArray<SqlRuntimeExtensionDescriptor<TTargetId>>;
+}
+/**
+ * Structured error thrown by the SQL runtime.
+ *
+ * Aligns with the repository's error envelope convention:
+ * - `code`: Stable error code for programmatic handling (e.g., `RUNTIME.TYPE_PARAMS_INVALID`)
+ * - `category`: Error source category (`RUNTIME`)
+ * - `severity`: Error severity level (`error`)
+ * - `details`: Optional structured details for debugging
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   createRuntimeContext({ ... });
+ * } catch (e) {
+ *   if ((e as RuntimeError).code === 'RUNTIME.TYPE_PARAMS_INVALID') {
+ *     console.error('Invalid type parameters:', (e as RuntimeError).details);
+ *   }
+ * }
+ * ```
+ */
+export interface RuntimeError extends Error {
+    /** Stable error code for programmatic handling (e.g., `RUNTIME.TYPE_PARAMS_INVALID`) */
+    readonly code: string;
+    /** Error source category */
+    readonly category: 'RUNTIME';
+    /** Error severity level */
+    readonly severity: 'error';
+    /** Optional structured details for debugging */
+    readonly details?: Record<string, unknown>;
+}
+/**
+ * Creates a SQL runtime context from descriptor-first composition.
+ *
+ * The context includes:
+ * - The validated contract
+ * - The adapter instance (created from descriptor)
+ * - Codec registry (populated from adapter + extension instances)
+ * - Operation registry (populated from extension instances)
+ * - Types registry (initialized helpers from storage.types)
+ *
+ * @param options - Descriptor-first composition options
+ * @returns RuntimeContext with registries wired from all components
+ */
+export declare function createRuntimeContext<TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>, TTargetId extends string = string>(options: CreateRuntimeContextOptions<TContract, TTargetId>): RuntimeContext<TContract>;
+//# sourceMappingURL=sql-context.d.ts.map

package/dist/src/sql-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-context.d.ts","sourceRoot":"","sources":["../../src/sql-context.ts"],"names":[],"mappings":"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"}

package/dist/src/sql-family-adapter.d.ts

@@ -0,0 +1,10 @@
+import type { ExecutionPlan } from '@prisma-next/contract/types';
+import type { MarkerReader, RuntimeFamilyAdapter } from '@prisma-next/runtime-executor';
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+export declare class SqlFamilyAdapter<TContract extends SqlContract<SqlStorage>> implements RuntimeFamilyAdapter<TContract> {
+    readonly contract: TContract;
+    readonly markerReader: MarkerReader;
+    constructor(contract: TContract);
+    validatePlan(plan: ExecutionPlan, contract: TContract): void;
+}
+//# sourceMappingURL=sql-family-adapter.d.ts.map

package/dist/src/sql-family-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-family-adapter.d.ts","sourceRoot":"","sources":["../../src/sql-family-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EACV,YAAY,EAEZ,oBAAoB,EACrB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAS/E,qBAAa,gBAAgB,CAAC,SAAS,SAAS,WAAW,CAAC,UAAU,CAAC,CACrE,YAAW,oBAAoB,CAAC,SAAS,CAAC;IAE1C,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;gBAExB,QAAQ,EAAE,SAAS;IAK/B,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,GAAG,IAAI;CAe7D"}

package/dist/src/sql-marker.d.ts

@@ -0,0 +1,22 @@
+import type { MarkerStatement } from '@prisma-next/runtime-executor';
+export interface SqlStatement {
+    readonly sql: string;
+    readonly params: readonly unknown[];
+}
+export interface WriteMarkerInput {
+    readonly coreHash: string;
+    readonly profileHash: string;
+    readonly contractJson?: unknown;
+    readonly canonicalVersion?: number;
+    readonly appTag?: string;
+    readonly meta?: Record<string, unknown>;
+}
+export declare const ensureSchemaStatement: SqlStatement;
+export declare const ensureTableStatement: SqlStatement;
+export declare function readContractMarker(): MarkerStatement;
+export interface WriteContractMarkerStatements {
+    readonly insert: SqlStatement;
+    readonly update: SqlStatement;
+}
+export declare function writeContractMarker(input: WriteMarkerInput): WriteContractMarkerStatements;
+//# sourceMappingURL=sql-marker.d.ts.map

package/dist/src/sql-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-marker.d.ts","sourceRoot":"","sources":["../../src/sql-marker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,eAAO,MAAM,qBAAqB,EAAE,YAGnC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,YAYlC,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,eAAe,CAcpD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,6BAA6B,CAgD1F"}

package/dist/src/sql-runtime.d.ts

@@ -0,0 +1,25 @@
+import type { ExecutionPlan } from '@prisma-next/contract/types';
+import type { OperationRegistry } from '@prisma-next/operations';
+import type { Log, Plugin, RuntimeTelemetryEvent, RuntimeVerifyOptions, TelemetryOutcome } from '@prisma-next/runtime-executor';
+import { AsyncIterableResult } from '@prisma-next/runtime-executor';
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+import type { Adapter, LoweredStatement, SelectAst, SqlDriver } from '@prisma-next/sql-relational-core/ast';
+import type { SqlQueryPlan } from '@prisma-next/sql-relational-core/plan';
+import type { RuntimeContext } from './sql-context';
+export interface RuntimeOptions<TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>> {
+    readonly driver: SqlDriver;
+    readonly verify: RuntimeVerifyOptions;
+    readonly context: RuntimeContext<TContract>;
+    readonly plugins?: readonly Plugin<TContract, Adapter<SelectAst, SqlContract<SqlStorage>, LoweredStatement>, SqlDriver>[];
+    readonly mode?: 'strict' | 'permissive';
+    readonly log?: Log;
+}
+export interface Runtime {
+    execute<Row = Record<string, unknown>>(plan: ExecutionPlan<Row> | SqlQueryPlan<Row>): AsyncIterableResult<Row>;
+    telemetry(): RuntimeTelemetryEvent | null;
+    close(): Promise<void>;
+    operations(): OperationRegistry;
+}
+export type { RuntimeTelemetryEvent, RuntimeVerifyOptions, TelemetryOutcome };
+export declare function createRuntime<TContract extends SqlContract<SqlStorage>>(options: RuntimeOptions<TContract>): Runtime;
+//# sourceMappingURL=sql-runtime.d.ts.map

package/dist/src/sql-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-runtime.d.ts","sourceRoot":"","sources":["../../src/sql-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EACV,GAAG,EACH,MAAM,EAGN,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAqB,MAAM,+BAA+B,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EACV,OAAO,EAEP,gBAAgB,EAChB,SAAS,EACT,SAAS,EACV,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAK1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,MAAM,WAAW,cAAc,CAC7B,SAAS,SAAS,WAAW,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC;IAEnE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,CAChC,SAAS,EACT,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,EAC7D,SAAS,CACV,EAAE,CAAC;IACJ,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,GAC3C,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC5B,SAAS,IAAI,qBAAqB,GAAG,IAAI,CAAC;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,UAAU,IAAI,iBAAiB,CAAC;CACjC;AAED,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,CAAC;AA6G9E,wBAAgB,aAAa,CAAC,SAAS,SAAS,WAAW,CAAC,UAAU,CAAC,EACrE,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,GACjC,OAAO,CAET"}

package/dist/test/utils.d.ts

@@ -1,41 +1,36 @@
-import { ExecutionPlan, ResultType } from '@prisma-next/contract/types';
-import { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
-import { Adapter, SelectAst, LoweredStatement } from '@prisma-next/sql-relational-core/ast';
-import { SqlQueryPlan } from '@prisma-next/sql-relational-core/plan';
-import { Client } from 'pg';
-import { i as createRuntime, d as SqlStatement, a as SqlRuntimeExtensionDescriptor, R as RuntimeContext } from '../sql-runtime-DgEbg2OP.js';
-export { DevDatabase, collectAsync, createDevDatabase, teardownTestDatabase, withClient } from '@prisma-next/test-utils';
-import '@prisma-next/runtime-executor';
-import '@prisma-next/operations';
-import '@prisma-next/core-execution-plane/types';
-import '@prisma-next/sql-operations';
-import '@prisma-next/sql-relational-core/query-lane-context';
-
+import type { ExecutionPlan, ResultType } from '@prisma-next/contract/types';
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+import type { Adapter, LoweredStatement, SelectAst } from '@prisma-next/sql-relational-core/ast';
+import type { SqlQueryPlan } from '@prisma-next/sql-relational-core/plan';
+import type { Client } from 'pg';
+import type { SqlStatement } from '../src/exports';
+import { type createRuntime } from '../src/exports';
+import type { RuntimeContext, SqlRuntimeExtensionDescriptor } from '../src/sql-context';
 /**
  * Executes a plan and collects all results into an array.
  * This helper DRYs up the common pattern of executing plans in tests.
  * The return type is inferred from the plan's type parameter.
  */
-declare function executePlanAndCollect<P extends ExecutionPlan<ResultType<P>> | SqlQueryPlan<ResultType<P>>>(runtime: ReturnType<typeof createRuntime>, plan: P): Promise<ResultType<P>[]>;
+export declare function executePlanAndCollect<P extends ExecutionPlan<ResultType<P>> | SqlQueryPlan<ResultType<P>>>(runtime: ReturnType<typeof createRuntime>, plan: P): Promise<ResultType<P>[]>;
 /**
  * Drains a plan execution, consuming all results without collecting them.
  * Useful for testing side effects without memory overhead.
  */
-declare function drainPlanExecution(runtime: ReturnType<typeof createRuntime>, plan: ExecutionPlan | SqlQueryPlan<unknown>): Promise<void>;
+export declare function drainPlanExecution(runtime: ReturnType<typeof createRuntime>, plan: ExecutionPlan | SqlQueryPlan<unknown>): Promise<void>;
 /**
  * Executes a SQL statement on a database client.
  */
-declare function executeStatement(client: Client, statement: SqlStatement): Promise<void>;
+export declare function executeStatement(client: Client, statement: SqlStatement): Promise<void>;
 /**
  * Sets up database schema and data, then writes the contract marker.
  * This helper DRYs up the common pattern of database setup in tests.
  */
-declare function setupTestDatabase(client: Client, contract: SqlContract<SqlStorage>, setupFn: (client: Client) => Promise<void>): Promise<void>;
+export declare function setupTestDatabase(client: Client, contract: SqlContract<SqlStorage>, setupFn: (client: Client) => Promise<void>): Promise<void>;
 /**
  * Writes a contract marker to the database.
  * This helper DRYs up the common pattern of writing contract markers in tests.
  */
-declare function writeTestContractMarker(client: Client, contract: SqlContract<SqlStorage>): Promise<void>;
+export declare function writeTestContractMarker(client: Client, contract: SqlContract<SqlStorage>): Promise<void>;
 /**
  * Creates a runtime context with standard test configuration.
  * This helper DRYs up the common pattern of context creation in tests.
@@ -43,7 +38,7 @@ declare function writeTestContractMarker(client: Client, contract: SqlContract<S
  * Accepts a raw adapter and optional extension descriptors, wrapping the
  * adapter in a descriptor internally for descriptor-first context creation.
  */
-declare function createTestContext<TContract extends SqlContract<SqlStorage>>(contract: TContract, adapter: Adapter<SelectAst, SqlContract<SqlStorage>, LoweredStatement>, options?: {
+export declare function createTestContext<TContract extends SqlContract<SqlStorage>>(contract: TContract, adapter: Adapter<SelectAst, SqlContract<SqlStorage>, LoweredStatement>, options?: {
     extensionPacks?: ReadonlyArray<SqlRuntimeExtensionDescriptor<'postgres'>>;
 }): RuntimeContext<TContract>;
 /**
@@ -53,12 +48,13 @@ declare function createTestContext<TContract extends SqlContract<SqlStorage>>(co
  * The stub adapter includes simple codecs for common test types (pg/int4@1, pg/text@1, pg/timestamptz@1)
  * to enable type inference in tests without requiring the postgres adapter package.
  */
-declare function createStubAdapter(): Adapter<SelectAst, SqlContract<SqlStorage>, LoweredStatement>;
+export declare function createStubAdapter(): Adapter<SelectAst, SqlContract<SqlStorage>, LoweredStatement>;
 /**
  * Creates a valid test contract without using validateContract.
- * Ensures mappings are present and returns the contract with proper typing.
+ * Ensures all required fields are present (mappings, capabilities, extensionPacks, meta, sources)
+ * and returns the contract with proper typing.
  * This helper allows tests to create contracts without depending on sql-query.
  */
-declare function createTestContract<T extends SqlContract<SqlStorage>>(contract: T): T;
-
-export { createStubAdapter, createTestContext, createTestContract, drainPlanExecution, executePlanAndCollect, executeStatement, setupTestDatabase, writeTestContractMarker };
+export declare function createTestContract<T extends SqlContract<SqlStorage>>(contract: Partial<T> & Omit<T, 'mappings' | 'capabilities' | 'extensionPacks' | 'meta' | 'sources'>): T;
+export { collectAsync, createDevDatabase, type DevDatabase, teardownTestDatabase, withClient, } from '@prisma-next/test-utils';
+//# sourceMappingURL=utils.d.ts.map

package/dist/test/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../test/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAEjG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAE1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EACL,KAAK,aAAa,EAKnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,cAAc,EAEd,6BAA6B,EAC9B,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,CAAC,SAAS,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EACpE,OAAO,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAG9E;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,EACzC,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAO7F;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,EACjC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAQf;AA4DD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,SAAS,WAAW,CAAC,UAAU,CAAC,EACzE,QAAQ,EAAE,SAAS,EACnB,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,EACtE,OAAO,CAAC,EAAE;IACR,cAAc,CAAC,EAAE,aAAa,CAAC,6BAA6B,CAAC,UAAU,CAAC,CAAC,CAAC;CAC3E,GACA,cAAc,CAAC,SAAS,CAAC,CAO3B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,CAmDjG;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,WAAW,CAAC,UAAU,CAAC,EAClE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAClB,IAAI,CAAC,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAAC,GAC7E,CAAC,CASH;AAGD,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,KAAK,WAAW,EAChB,oBAAoB,EACpB,UAAU,GACX,MAAM,yBAAyB,CAAC"}

package/dist/test/utils.js

@@ -26,7 +26,7 @@ import {
   ensureSchemaStatement,
   ensureTableStatement,
   writeContractMarker
-} from "../chunk-C6I3V3DM.js";
+} from "../chunk-APA6GHYY.js";
 import {
   __commonJS,
   __require,
@@ -454,8 +454,8 @@ var require_graceful_fs = __commonJS({
     var gracefulQueue;
     var previousSymbol;
     if (typeof Symbol === "function" && typeof Symbol.for === "function") {
-      gracefulQueue = Symbol.for("graceful-fs.queue");
-      previousSymbol = Symbol.for("graceful-fs.previous");
+      gracefulQueue = /* @__PURE__ */ Symbol.for("graceful-fs.queue");
+      previousSymbol = /* @__PURE__ */ Symbol.for("graceful-fs.previous");
     } else {
       gracefulQueue = "___graceful-fs.queue";
       previousSymbol = "___graceful-fs.previous";
@@ -1242,7 +1242,7 @@ var require_signal_exit = __commonJS({
 var require_mtime_precision = __commonJS({
   "../../../node_modules/.pnpm/proper-lockfile@4.1.2/node_modules/proper-lockfile/lib/mtime-precision.js"(exports, module) {
     "use strict";
-    var cacheSymbol = Symbol();
+    var cacheSymbol = /* @__PURE__ */ Symbol();
     function probe(file, fs, callback) {
       const cachedPrecision = fs[cacheSymbol];
       if (cachedPrecision) {
@@ -2024,8 +2024,8 @@ var require_chunk_7PMGXL6S = __commonJS({
     var import_promises3 = __toESM2(__require("fs/promises"));
     var import_os = __toESM2(__require("os"));
     var import_util2 = __require("util");
-    var t6 = Symbol.for("@ts-pattern/matcher");
-    var e2 = Symbol.for("@ts-pattern/isVariadic");
+    var t6 = /* @__PURE__ */ Symbol.for("@ts-pattern/matcher");
+    var e2 = /* @__PURE__ */ Symbol.for("@ts-pattern/isVariadic");
     var n3 = "@ts-pattern/anonymous-select-key";
     var r5 = (t22) => Boolean(t22 && "object" == typeof t22);
     var i3 = (e22) => e22 && !!e22[t6];
@@ -5013,7 +5013,7 @@ var require_chunk_3UEKS5W6 = __commonJS({
         module2.exports = minimatch;
         var path3 = require_path();
         minimatch.sep = path3.sep;
-        var GLOBSTAR = Symbol("globstar **");
+        var GLOBSTAR = /* @__PURE__ */ Symbol("globstar **");
         minimatch.GLOBSTAR = GLOBSTAR;
         var expand = require_brace_expansion();
         var plTypes = {
@@ -5077,7 +5077,7 @@ var require_chunk_3UEKS5W6 = __commonJS({
             throw new TypeError("pattern is too long");
           }
         };
-        var SUBPARSE = Symbol("subparse");
+        var SUBPARSE = /* @__PURE__ */ Symbol("subparse");
         minimatch.makeRe = (pattern, options) => new Minimatch(pattern, options || {}).makeRe();
         minimatch.match = (list, pattern, options = {}) => {
           const mm = new Minimatch(pattern, options);
@@ -6864,7 +6864,7 @@ var require_chunk_3UEKS5W6 = __commonJS({
         "use strict";
         var fs = (0, import_chunk_2ESYSVXG.__require)("fs");
         var os2 = (0, import_chunk_2ESYSVXG.__require)("os");
-        var tempDirectorySymbol = Symbol.for("__RESOLVED_TEMP_DIRECTORY__");
+        var tempDirectorySymbol = /* @__PURE__ */ Symbol.for("__RESOLVED_TEMP_DIRECTORY__");
         if (!global[tempDirectorySymbol]) {
           Object.defineProperty(global, tempDirectorySymbol, {
             value: fs.realpathSync(os2.tmpdir())
@@ -12337,7 +12337,7 @@ var require_chunk_3UEKS5W6 = __commonJS({
         var SLASH = "/";
         var TMP_KEY_IGNORE = "node-ignore";
         if (typeof Symbol !== "undefined") {
-          TMP_KEY_IGNORE = Symbol.for("node-ignore");
+          TMP_KEY_IGNORE = /* @__PURE__ */ Symbol.for("node-ignore");
         }
         var KEY_IGNORE = TMP_KEY_IGNORE;
         var define = (object2, key, value) => Object.defineProperty(object2, key, { value });
@@ -13389,8 +13389,8 @@ var require_chunk_3UEKS5W6 = __commonJS({
         var gracefulQueue;
         var previousSymbol;
         if (typeof Symbol === "function" && typeof Symbol.for === "function") {
-          gracefulQueue = Symbol.for("graceful-fs.queue");
-          previousSymbol = Symbol.for("graceful-fs.previous");
+          gracefulQueue = /* @__PURE__ */ Symbol.for("graceful-fs.queue");
+          previousSymbol = /* @__PURE__ */ Symbol.for("graceful-fs.previous");
         } else {
           gracefulQueue = "___graceful-fs.queue";
           previousSymbol = "___graceful-fs.previous";
@@ -17273,7 +17273,7 @@ ${error.message}` : execaMessage;
       signals.push("SIGIO", "SIGPOLL", "SIGPWR", "SIGSTKFLT");
     }
     var processOk = (process7) => !!process7 && typeof process7 === "object" && typeof process7.removeListener === "function" && typeof process7.emit === "function" && typeof process7.reallyExit === "function" && typeof process7.listeners === "function" && typeof process7.kill === "function" && typeof process7.pid === "number" && typeof process7.on === "function";
-    var kExitEmitter = Symbol.for("signal-exit emitter");
+    var kExitEmitter = /* @__PURE__ */ Symbol.for("signal-exit emitter");
     var global2 = globalThis;
     var ObjectDefineProperty = Object.defineProperty.bind(Object);
     var Emitter = class {
@@ -21703,8 +21703,8 @@ var require_split2 = __commonJS({
     "use strict";
     var { Transform } = __require("stream");
     var { StringDecoder } = __require("string_decoder");
-    var kLast = Symbol("last");
-    var kDecoder = Symbol("decoder");
+    var kLast = /* @__PURE__ */ Symbol("last");
+    var kDecoder = /* @__PURE__ */ Symbol("decoder");
     function transform(chunk, enc, cb) {
       let list;
       if (this.overflow) {
@@ -24028,7 +24028,6 @@ var isAbsolute = function(p3) {
 };
 
 // ../../../node_modules/.pnpm/pathe@2.0.3/node_modules/pathe/dist/utils.mjs
-var normalizedAliasSymbol = Symbol.for("pathe:normalizedAlias");
 var SLASH_RE = /[/\\]/;
 function filename(path) {
   const base = path.split(SLASH_RE).pop();
@@ -24159,7 +24158,7 @@ var J = object({ url: _2 });
 var M = pipe(number(), integer(), minValue(1));
 var ie = object({ database: L, http: J, ppg: J, shadowDatabase: L });
 var ne = object({ databasePort: M, exports: optional(ie), name: pipe(string(), minLength(1)), pid: optional(pipe(number(), integer(), minValue(0))), port: M, shadowDatabasePort: M, version: literal("1") });
-var E3 = Symbol("initialize");
+var E3 = /* @__PURE__ */ Symbol("initialize");
 var k2 = "default";
 var u = class {
   _databasePort;
@@ -24339,7 +24338,7 @@ import { promisify as R2 } from "util";
 async function y4(o2, e2) {
   let { port: r5 } = e2;
   if (e2.dryRun) return w2(r5, null);
-  let n3 = await D2(o2, e2), { promise: m, reject: l2, resolve: a } = O(), { serve: c } = await import("../dist-LCVVJCGI.js"), i3 = c({ createServer: A, fetch: n3.fetch, overrideGlobalObjects: false, port: r5 }, a);
+  let n3 = await D2(o2, e2), { promise: m, reject: l2, resolve: a } = O(), { serve: c } = await import("../dist-AQ3LWXOX.js"), i3 = c({ createServer: A, fetch: n3.fetch, overrideGlobalObjects: false, port: r5 }, a);
   i3.on("error", (s) => {
     if (typeof s == "object" && "code" in s && s.code === "EADDRINUSE") return l2(new f(r5));
     console.error("[Accelerate]", s);
@@ -24353,7 +24352,7 @@ function w2(o2, e2) {
   }, port: o2, url: `http://localhost:${o2}` };
 }
 async function D2(o2, e2) {
-  let { debug: r5 } = e2, [{ Hono: n3 }, { accelerateRoute: m }, { utilityRoute: l2 }] = await Promise.all([import("../tiny-CW6F4GX6.js"), import("../accelerate-EEKAFGN3-SHR4XFVV.js"), import("../utility-Q5A254LJ-J4HTKZPT.js")]), a = new n3(), c = await import_get_platform.default.getPlatformInfo();
+  let { debug: r5 } = e2, [{ Hono: n3 }, { accelerateRoute: m }, { utilityRoute: l2 }] = await Promise.all([import("../tiny-CW6F4GX6.js"), import("../accelerate-EEKAFGN3-P6A6XJWJ.js"), import("../utility-Q5A254LJ-J4HTKZPT.js")]), a = new n3(), c = await import_get_platform.default.getPlatformInfo();
   if (r5 && console.debug("[Accelerate] platform info: %s", JSON.stringify(c)), r5) {
     let { logger: t6 } = await import("../logger-WQ7SHNDD.js");
     a.use("*", t6((...s) => console.log("[Accelerate]", ...s)));
@@ -24558,13 +24557,14 @@ function createStubAdapter() {
   };
 }
 function createTestContract(contract) {
-  if (!contract.mappings) {
-    return {
-      ...contract,
-      mappings: { codecTypes: {}, operationTypes: {} }
-    };
-  }
-  return contract;
+  return {
+    ...contract,
+    mappings: contract.mappings ?? { codecTypes: {}, operationTypes: {} },
+    capabilities: contract.capabilities ?? {},
+    extensionPacks: contract.extensionPacks ?? {},
+    meta: contract.meta ?? {},
+    sources: contract.sources ?? {}
+  };
 }
 export {
   collectAsync,