@prisma-next/sql-runtime 0.3.0-dev.12 → 0.3.0-dev.123

package/test/sql-context.test.ts

@@ -1,20 +1,25 @@
+import { coreHash } from '@prisma-next/contract/types';
 import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
 import type { SqlOperationSignature } from '@prisma-next/sql-operations';
-import type { CodecRegistry, SelectAst } from '@prisma-next/sql-relational-core/ast';
 import { codec, createCodecRegistry } from '@prisma-next/sql-relational-core/ast';
 import { describe, expect, it } from 'vitest';
 import {
-  createRuntimeContext,
+  createExecutionContext,
+  type SqlExecutionStack,
   type SqlRuntimeExtensionDescriptor,
-  type SqlRuntimeExtensionInstance,
+  type SqlRuntimeTargetDescriptor,
 } from '../src/sql-context';
+import {
+  createStubAdapter,
+  createTestAdapterDescriptor,
+  createTestTargetDescriptor,
+} from './utils';
 
-// Minimal test contract
 const testContract: SqlContract<SqlStorage> = {
   schemaVersion: '1',
   targetFamily: 'sql',
   target: 'postgres',
-  coreHash: 'sha256:test',
+  storageHash: coreHash('sha256:test'),
   models: {},
   relations: {},
   storage: { tables: {} },
@@ -22,82 +27,17 @@ const testContract: SqlContract<SqlStorage> = {
   capabilities: {},
   meta: {},
   sources: {},
-  mappings: {
-    codecTypes: {},
-    operationTypes: {},
-  },
+  mappings: {},
 };
 
-// Stub adapter codecs
-function createStubCodecs(): CodecRegistry {
-  const registry = createCodecRegistry();
-  registry.register(
-    codec({
-      typeId: 'pg/int4@1',
-      targetTypes: ['int4'],
-      encode: (v: number) => v,
-      decode: (w: number) => w,
-    }),
-  );
-  return registry;
-}
-
-// Create a test adapter descriptor
-function createTestAdapterDescriptor() {
-  const codecs = createStubCodecs();
-  return {
-    kind: 'adapter' as const,
-    id: 'test-adapter',
-    version: '0.0.1',
-    familyId: 'sql' as const,
-    targetId: 'postgres' as const,
-    create() {
-      return {
-        familyId: 'sql' as const,
-        targetId: 'postgres' as const,
-        profile: {
-          id: 'test-profile',
-          target: 'postgres',
-          capabilities: {},
-          codecs() {
-            return codecs;
-          },
-        },
-        lower(ast: SelectAst) {
-          return {
-            profileId: 'test-profile',
-            body: Object.freeze({ sql: JSON.stringify(ast), params: [] }),
-          };
-        },
-      };
-    },
-  };
-}
-
-// Create a test target descriptor
-function createTestTargetDescriptor() {
-  return {
-    kind: 'target' as const,
-    id: 'postgres',
-    version: '0.0.1',
-    familyId: 'sql' as const,
-    targetId: 'postgres' as const,
-    create() {
-      return { familyId: 'sql' as const, targetId: 'postgres' as const };
-    },
-  };
-}
-
-// Create a test extension descriptor
 function createTestExtensionDescriptor(options?: {
   hasCodecs?: boolean;
   hasOperations?: boolean;
 }): SqlRuntimeExtensionDescriptor<'postgres'> {
   const { hasCodecs = false, hasOperations = false } = options ?? {};
 
-  // Build the codecs function if needed
-  const codecsFn = hasCodecs
-    ? () => {
+  const codecRegistry = hasCodecs
+    ? (() => {
         const registry = createCodecRegistry();
         registry.register(
           codec({
@@ -108,21 +48,24 @@ function createTestExtensionDescriptor(options?: {
           }),
         );
         return registry;
-      }
-    : undefined;
+      })()
+    : createCodecRegistry();
 
-  // Build the operations function if needed
-  const operationsFn = hasOperations
-    ? (): ReadonlyArray<SqlOperationSignature> => [
+  const operationsArray: ReadonlyArray<SqlOperationSignature> = hasOperations
+    ? [
         {
           forTypeId: 'test/ext@1',
           method: 'testOp',
           args: [],
-          returns: { kind: 'builtin', type: 'number' },
-          lowering: { targetFamily: 'sql', strategy: 'function', template: 'test()' },
+          returns: { kind: 'builtin' as const, type: 'number' as const },
+          lowering: {
+            targetFamily: 'sql' as const,
+            strategy: 'function' as const,
+            template: 'test()',
+          },
         },
       ]
-    : undefined;
+    : [];
 
   return {
     kind: 'extension' as const,
@@ -130,71 +73,68 @@ function createTestExtensionDescriptor(options?: {
     version: '0.0.1',
     familyId: 'sql' as const,
     targetId: 'postgres' as const,
-    create(): SqlRuntimeExtensionInstance<'postgres'> {
-      // Return object with optional methods only if they exist
-      const instance: SqlRuntimeExtensionInstance<'postgres'> = {
+    codecs: () => codecRegistry,
+    operationSignatures: () => operationsArray,
+    parameterizedCodecs: () => [],
+    create() {
+      return {
         familyId: 'sql' as const,
         targetId: 'postgres' as const,
       };
-      if (codecsFn) {
-        (instance as { codecs?: () => CodecRegistry }).codecs = codecsFn;
-      }
-      if (operationsFn) {
-        (instance as { operations?: () => ReadonlyArray<SqlOperationSignature> }).operations =
-          operationsFn;
-      }
-      return instance;
     },
   };
 }
 
-describe('createRuntimeContext', () => {
-  it('creates context with adapter codecs', () => {
-    const context = createRuntimeContext({
+function createStack(options?: {
+  extensionPacks?: ReadonlyArray<SqlRuntimeExtensionDescriptor<'postgres'>>;
+}): SqlExecutionStack<'postgres'> {
+  return {
+    target: createTestTargetDescriptor(),
+    adapter: createTestAdapterDescriptor(createStubAdapter()),
+    extensionPacks: options?.extensionPacks ?? [],
+  };
+}
+
+describe('createExecutionContext', () => {
+  it('creates context with adapter codecs from descriptor', () => {
+    const context = createExecutionContext({
       contract: testContract,
-      target: createTestTargetDescriptor(),
-      adapter: createTestAdapterDescriptor(),
+      stack: createStack(),
     });
 
     expect(context.contract).toBe(testContract);
-    expect(context.adapter).toBeDefined();
     expect(context.codecs.has('pg/int4@1')).toBe(true);
     expect(context.operations).toBeDefined();
   });
 
   it('creates context with empty extension packs', () => {
-    const context = createRuntimeContext({
+    const context = createExecutionContext({
       contract: testContract,
-      target: createTestTargetDescriptor(),
-      adapter: createTestAdapterDescriptor(),
-      extensionPacks: [],
+      stack: createStack({ extensionPacks: [] }),
     });
 
     expect(context.codecs.has('pg/int4@1')).toBe(true);
-    // No extension codecs registered
     expect(context.codecs.has('test/ext@1')).toBe(false);
   });
 
-  it('registers extension codecs', () => {
-    const context = createRuntimeContext({
+  it('registers extension codecs from descriptors', () => {
+    const context = createExecutionContext({
       contract: testContract,
-      target: createTestTargetDescriptor(),
-      adapter: createTestAdapterDescriptor(),
-      extensionPacks: [createTestExtensionDescriptor({ hasCodecs: true })],
+      stack: createStack({
+        extensionPacks: [createTestExtensionDescriptor({ hasCodecs: true })],
+      }),
     });
 
-    // Adapter codec
     expect(context.codecs.has('pg/int4@1')).toBe(true);
-    // Extension codec
     expect(context.codecs.has('test/ext@1')).toBe(true);
   });
 
-  it('registers extension operations', () => {
-    const context = createRuntimeContext({
+  it('registers extension operations from descriptors', () => {
+    const context = createExecutionContext({
       contract: testContract,
-      target: createTestTargetDescriptor(),
-      adapter: createTestAdapterDescriptor(),
-      extensionPacks: [createTestExtensionDescriptor({ hasOperations: true })],
+      stack: createStack({
+        extensionPacks: [createTestExtensionDescriptor({ hasOperations: true })],
+      }),
     });
 
     const ops = context.operations.byType('test/ext@1');
@@ -202,16 +142,248 @@ describe('createRuntimeContext', () => {
     expect(ops[0]?.method).toBe('testOp');
   });
 
-  it('handles extension without codecs or operations', () => {
-    const context = createRuntimeContext({
+  it('handles extension with no contributions', () => {
+    const context = createExecutionContext({
       contract: testContract,
-      target: createTestTargetDescriptor(),
-      adapter: createTestAdapterDescriptor(),
-      extensionPacks: [createTestExtensionDescriptor({ hasCodecs: false, hasOperations: false })],
+      stack: createStack({
+        extensionPacks: [createTestExtensionDescriptor({ hasCodecs: false, hasOperations: false })],
+      }),
     });
 
-    // Only adapter codec
     expect(context.codecs.has('pg/int4@1')).toBe(true);
     expect(context.codecs.has('test/ext@1')).toBe(false);
   });
 });
+
+describe('comprehensive descriptor-based derivation', () => {
+  it('includes all expected codec IDs and operations from target, adapter, and extensions', () => {
+    const targetCodecRegistry = createCodecRegistry();
+    targetCodecRegistry.register(
+      codec({
+        typeId: 'target/special@1',
+        targetTypes: ['special'],
+        encode: (v: string) => v,
+        decode: (w: string) => w,
+      }),
+    );
+
+    const targetOps: SqlOperationSignature[] = [
+      {
+        forTypeId: 'target/special@1',
+        method: 'targetOp',
+        args: [],
+        returns: { kind: 'builtin' as const, type: 'string' as const },
+        lowering: {
+          targetFamily: 'sql' as const,
+          strategy: 'function' as const,
+          template: 'target_fn()',
+        },
+      },
+    ];
+
+    const target: SqlRuntimeTargetDescriptor<'postgres'> = {
+      kind: 'target' as const,
+      id: 'postgres',
+      version: '0.0.1',
+      familyId: 'sql' as const,
+      targetId: 'postgres' as const,
+      codecs: () => targetCodecRegistry,
+      operationSignatures: () => targetOps,
+      parameterizedCodecs: () => [],
+      create() {
+        return { familyId: 'sql' as const, targetId: 'postgres' as const };
+      },
+    };
+
+    const stack: SqlExecutionStack<'postgres'> = {
+      target,
+      adapter: createTestAdapterDescriptor(createStubAdapter()),
+      extensionPacks: [createTestExtensionDescriptor({ hasCodecs: true, hasOperations: true })],
+    };
+
+    const context = createExecutionContext({ contract: testContract, stack });
+
+    expect(context.codecs.has('target/special@1')).toBe(true);
+    expect(context.codecs.has('pg/int4@1')).toBe(true);
+    expect(context.codecs.has('test/ext@1')).toBe(true);
+
+    expect(context.operations.byType('target/special@1').length).toBe(1);
+    expect(context.operations.byType('target/special@1')[0]?.method).toBe('targetOp');
+    expect(context.operations.byType('test/ext@1').length).toBe(1);
+    expect(context.operations.byType('test/ext@1')[0]?.method).toBe('testOp');
+  });
+});
+
+describe('context.types presence', () => {
+  it('exists as empty object when no parameterized codecs are registered', () => {
+    const context = createExecutionContext({
+      contract: testContract,
+      stack: createStack(),
+    });
+
+    expect(context.types).toBeDefined();
+    expect(context.types).toEqual({});
+  });
+});
+
+describe('contract/stack validation errors', () => {
+  it('throws RUNTIME.CONTRACT_FAMILY_MISMATCH when contract targetFamily differs from stack', () => {
+    const mismatchedFamilyContract = {
+      ...testContract,
+      targetFamily: 'document',
+    } as unknown as SqlContract<SqlStorage>;
+
+    expect(() =>
+      createExecutionContext({ contract: mismatchedFamilyContract, stack: createStack() }),
+    ).toThrow(
+      expect.objectContaining({
+        code: 'RUNTIME.CONTRACT_FAMILY_MISMATCH',
+        category: 'RUNTIME',
+        severity: 'error',
+        details: {
+          actual: 'document',
+          expected: 'sql',
+        },
+      }),
+    );
+  });
+
+  it('throws RUNTIME.CONTRACT_TARGET_MISMATCH when contract target differs from stack', () => {
+    const mismatchedContract: SqlContract<SqlStorage> = {
+      ...testContract,
+      target: 'mysql',
+    };
+
+    expect(() =>
+      createExecutionContext({ contract: mismatchedContract, stack: createStack() }),
+    ).toThrow(
+      expect.objectContaining({
+        code: 'RUNTIME.CONTRACT_TARGET_MISMATCH',
+        category: 'RUNTIME',
+        severity: 'error',
+        details: {
+          actual: 'mysql',
+          expected: 'postgres',
+        },
+      }),
+    );
+  });
+
+  it('throws RUNTIME.MISSING_EXTENSION_PACK when contract requires extension not in stack', () => {
+    const contractWithExtension: SqlContract<SqlStorage> = {
+      ...testContract,
+      extensionPacks: {
+        'required-extension': { id: 'required-extension', version: '1.0.0', capabilities: {} },
+      },
+    };
+
+    expect(() =>
+      createExecutionContext({ contract: contractWithExtension, stack: createStack() }),
+    ).toThrow(
+      expect.objectContaining({
+        code: 'RUNTIME.MISSING_EXTENSION_PACK',
+        category: 'RUNTIME',
+        severity: 'error',
+        details: {
+          packIds: ['required-extension'],
+        },
+      }),
+    );
+  });
+
+  it('lists all missing extension packs in a single error', () => {
+    const contractWithExtensions: SqlContract<SqlStorage> = {
+      ...testContract,
+      extensionPacks: {
+        'ext-a': { id: 'ext-a', version: '1.0.0', capabilities: {} },
+        'ext-b': { id: 'ext-b', version: '1.0.0', capabilities: {} },
+      },
+    };
+
+    expect(() =>
+      createExecutionContext({ contract: contractWithExtensions, stack: createStack() }),
+    ).toThrow(
+      expect.objectContaining({
+        code: 'RUNTIME.MISSING_EXTENSION_PACK',
+        details: {
+          packIds: expect.arrayContaining(['ext-a', 'ext-b']),
+        },
+      }),
+    );
+  });
+});
+
+describe('applyMutationDefaults', () => {
+  const contractWithDefaults: SqlContract<SqlStorage> = {
+    ...testContract,
+    storage: {
+      tables: {
+        user: {
+          columns: {
+            id: { nativeType: 'text', codecId: 'pg/text@1', nullable: false },
+            slug: { nativeType: 'text', codecId: 'pg/text@1', nullable: false },
+          },
+          uniques: [],
+          indexes: [],
+          foreignKeys: [],
+        },
+      },
+    },
+    execution: {
+      mutations: {
+        defaults: [
+          {
+            ref: { table: 'user', column: 'id' },
+            onCreate: { kind: 'generator', id: 'nanoid', params: { size: 8 } },
+          },
+          {
+            ref: { table: 'user', column: 'slug' },
+            onUpdate: { kind: 'generator', id: 'nanoid', params: { size: 6 } },
+          },
+        ],
+      },
+    },
+  };
+
+  it('applies create defaults with generator params', () => {
+    const context = createExecutionContext({
+      contract: contractWithDefaults,
+      stack: createStack(),
+    });
+
+    const applied = context.applyMutationDefaults({
+      op: 'create',
+      table: 'user',
+      values: {},
+    });
+
+    expect(applied).toEqual([
+      {
+        column: 'id',
+        value: expect.any(String),
+      },
+    ]);
+    expect((applied[0]?.value as string).length).toBe(8);
+  });
+
+  it('applies update defaults from onUpdate', () => {
+    const context = createExecutionContext({
+      contract: contractWithDefaults,
+      stack: createStack(),
+    });
+
+    const applied = context.applyMutationDefaults({
+      op: 'update',
+      table: 'user',
+      values: {},
+    });
+
+    expect(applied).toEqual([
+      {
+        column: 'slug',
+        value: expect.any(String),
+      },
+    ]);
+    expect((applied[0]?.value as string).length).toBe(6);
+  });
+});

package/test/sql-family-adapter.test.ts

@@ -1,4 +1,5 @@
 import type { ExecutionPlan } from '@prisma-next/contract/types';
+import { coreHash } from '@prisma-next/contract/types';
 import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
 import { describe, expect, it } from 'vitest';
 import { SqlFamilyAdapter } from '../src/sql-family-adapter';
@@ -8,7 +9,7 @@ const testContract: SqlContract<SqlStorage> = {
   schemaVersion: '1',
   targetFamily: 'sql',
   target: 'postgres',
-  coreHash: 'sha256:test-hash',
+  storageHash: coreHash('sha256:test-hash'),
   models: {},
   relations: {},
   storage: { tables: {} },
@@ -16,10 +17,7 @@ const testContract: SqlContract<SqlStorage> = {
   capabilities: {},
   meta: {},
   sources: {},
-  mappings: {
-    codecTypes: {},
-    operationTypes: {},
-  },
+  mappings: {},
 };
 
 describe('SqlFamilyAdapter', () => {
@@ -36,7 +34,7 @@ describe('SqlFamilyAdapter', () => {
     const plan: ExecutionPlan = {
       meta: {
         target: 'postgres',
-        coreHash: 'sha256:test-hash',
+        storageHash: 'sha256:test-hash',
         lane: 'sql',
         paramDescriptors: [],
       },
@@ -53,7 +51,7 @@ describe('SqlFamilyAdapter', () => {
     const plan: ExecutionPlan = {
       meta: {
         target: 'mysql', // Wrong target
-        coreHash: 'sha256:test-hash',
+        storageHash: 'sha256:test-hash',
         lane: 'sql',
         paramDescriptors: [],
       },
@@ -66,12 +64,12 @@ describe('SqlFamilyAdapter', () => {
     );
   });
 
-  it('throws on plan coreHash mismatch', () => {
+  it('throws on plan storageHash mismatch', () => {
     const adapter = new SqlFamilyAdapter(testContract);
     const plan: ExecutionPlan = {
       meta: {
         target: 'postgres',
-        coreHash: 'sha256:different-hash', // Wrong hash
+        storageHash: 'sha256:different-hash', // Wrong hash
         lane: 'sql',
         paramDescriptors: [],
       },
@@ -80,7 +78,7 @@ describe('SqlFamilyAdapter', () => {
     };
 
     expect(() => adapter.validatePlan(plan, testContract)).toThrow(
-      'Plan core hash does not match runtime contract',
+      'Plan storage hash does not match runtime contract',
     );
   });
 });