@prisma-next/sql-operations 0.5.0-dev.9 → 0.5.0

package/README.md

@@ -16,7 +16,8 @@ This package provides SQL-specific operation types that extend the generic `Oper
 
 - **SQL Operation Types**: SQL-specific operation entry and descriptor types
   - `SqlOperationEntry`: Extends `OperationEntry` with a `lowering` field (`SqlLoweringSpec`)
-  - `SqlOperationDescriptor`: Extends `OperationDescriptor<SqlOperationEntry>` (entry plus `method` name)
+  - `SqlOperationDescriptor`: Alias for `SqlOperationEntry` used at registration sites
+  - `SqlOperationDescriptors`: `Readonly<Record<string, SqlOperationDescriptor>>` — the keyed-record shape adapter/extension `queryOperations()` factories return
   - `SqlLoweringSpec`: SQL-specific lowering specification (`targetFamily`, `strategy`, `template`)
   - `SqlOperationRegistry`: Typed registry alias (`OperationRegistry<SqlOperationEntry>`)
 
@@ -72,17 +73,11 @@ import {
 const registry = createSqlOperationRegistry();
 
 const descriptor: SqlOperationDescriptor = {
-  method: 'cosineDistance',
-  args: [{ codecId: 'pg/vector@1', nullable: false }],
-  returns: { codecId: 'pg/float8@1', nullable: false },
-  lowering: {
-    targetFamily: 'sql',
-    strategy: 'infix',
-    template: '{{self}} <=> {{arg0}}',
-  },
+  self: { codecId: 'pg/vector@1' },
+  impl: () => ({ returnType: { codecId: 'pg/float8@1', nullable: false } }),
 };
 
-registry.register(descriptor);
+registry.register('cosineDistance', descriptor);
 
 const entries = registry.entries(); // Record<string, SqlOperationEntry>
 ```

package/dist/index.d.mts

@@ -1,4 +1,5 @@
-import { OperationDescriptor, OperationEntry, OperationRegistry } from "@prisma-next/operations";
+import { OperationDescriptor, OperationDescriptors, OperationRegistry } from "@prisma-next/operations";
+import { QueryOperationTypeEntry } from "@prisma-next/sql-contract/types";
 
 //#region src/index.d.ts
 interface SqlLoweringSpec {
@@ -6,12 +7,18 @@ interface SqlLoweringSpec {
   readonly strategy: 'infix' | 'function';
   readonly template: string;
 }
-interface SqlOperationEntry extends OperationEntry {
-  readonly lowering: SqlLoweringSpec;
-}
+/**
+ * Runtime shape of a SQL operation entry — tightened beyond the framework's
+ * target-agnostic `OperationEntry` so `impl` returns a codec-exact
+ * `QueryOperationReturn` instead of `unknown`. Consumers (ORM column helper,
+ * sql-builder `fns` dispatch) can read `result.returnType.codecId` without a
+ * cast.
+ */
+type SqlOperationEntry = QueryOperationTypeEntry;
 type SqlOperationDescriptor = OperationDescriptor<SqlOperationEntry>;
+type SqlOperationDescriptors = OperationDescriptors<SqlOperationEntry>;
 type SqlOperationRegistry = OperationRegistry<SqlOperationEntry>;
 declare function createSqlOperationRegistry(): SqlOperationRegistry;
 //#endregion
-export { SqlLoweringSpec, SqlOperationDescriptor, SqlOperationEntry, SqlOperationRegistry, createSqlOperationRegistry };
+export { SqlLoweringSpec, SqlOperationDescriptor, SqlOperationDescriptors, SqlOperationEntry, SqlOperationRegistry, createSqlOperationRegistry };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;UAOiB,eAAA;;EAAA,SAAA,QAAA,EAAe,OAAA,GAAA,UAAA;EAMf,SAAA,QAAA,EAAA,MAAkB;AAInC;AAEY,UANK,iBAAA,SAA0B,cAMR,CAAA;EAEnB,SAAA,QAAA,EAPK,eAOqB;;KAJ9B,sBAAA,GAAyB,oBAAoB;KAE7C,oBAAA,GAAuB,kBAAkB;iBAErC,0BAAA,CAAA,GAA8B"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;UAQiB,eAAA;EAAA,SACN,YAAA;EAAA,SACA,QAAA;EAAA,SACA,QAAA;AAAA;;;;;;;AAUX;KAAY,iBAAA,GAAoB,uBAAA;AAAA,KAEpB,sBAAA,GAAyB,mBAAA,CAAoB,iBAAA;AAAA,KAE7C,uBAAA,GAA0B,oBAAA,CAAqB,iBAAA;AAAA,KAE/C,oBAAA,GAAuB,iBAAA,CAAkB,iBAAA;AAAA,iBAErC,0BAAA,CAAA,GAA8B,oBAAA"}

package/dist/index.mjs

@@ -1,10 +1,9 @@
 import { createOperationRegistry } from "@prisma-next/operations";
-
 //#region src/index.ts
 function createSqlOperationRegistry() {
 	return createOperationRegistry();
 }
-
 //#endregion
 export { createSqlOperationRegistry };
+
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type {\n  OperationDescriptor,\n  OperationEntry,\n  OperationRegistry,\n} from '@prisma-next/operations';\nimport { createOperationRegistry } from '@prisma-next/operations';\n\nexport interface SqlLoweringSpec {\n  readonly targetFamily: 'sql';\n  readonly strategy: 'infix' | 'function';\n  readonly template: string;\n}\n\nexport interface SqlOperationEntry extends OperationEntry {\n  readonly lowering: SqlLoweringSpec;\n}\n\nexport type SqlOperationDescriptor = OperationDescriptor<SqlOperationEntry>;\n\nexport type SqlOperationRegistry = OperationRegistry<SqlOperationEntry>;\n\nexport function createSqlOperationRegistry(): SqlOperationRegistry {\n  return createOperationRegistry<SqlOperationEntry>();\n}\n"],"mappings":";;;AAqBA,SAAgB,6BAAmD;AACjE,QAAO,yBAA4C"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type {\n  OperationDescriptor,\n  OperationDescriptors,\n  OperationRegistry,\n} from '@prisma-next/operations';\nimport { createOperationRegistry } from '@prisma-next/operations';\nimport type { QueryOperationTypeEntry } from '@prisma-next/sql-contract/types';\n\nexport interface SqlLoweringSpec {\n  readonly targetFamily: 'sql';\n  readonly strategy: 'infix' | 'function';\n  readonly template: string;\n}\n\n/**\n * Runtime shape of a SQL operation entry — tightened beyond the framework's\n * target-agnostic `OperationEntry` so `impl` returns a codec-exact\n * `QueryOperationReturn` instead of `unknown`. Consumers (ORM column helper,\n * sql-builder `fns` dispatch) can read `result.returnType.codecId` without a\n * cast.\n */\nexport type SqlOperationEntry = QueryOperationTypeEntry;\n\nexport type SqlOperationDescriptor = OperationDescriptor<SqlOperationEntry>;\n\nexport type SqlOperationDescriptors = OperationDescriptors<SqlOperationEntry>;\n\nexport type SqlOperationRegistry = OperationRegistry<SqlOperationEntry>;\n\nexport function createSqlOperationRegistry(): SqlOperationRegistry {\n  return createOperationRegistry<SqlOperationEntry>();\n}\n"],"mappings":";;AA6BA,SAAgB,6BAAmD;CACjE,OAAO,yBAA4C"}

package/package.json

@@ -1,21 +1,23 @@
 {
   "name": "@prisma-next/sql-operations",
-  "version": "0.5.0-dev.9",
+  "version": "0.5.0",
+  "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
   "description": "SQL-specific operations for Prisma Next",
   "dependencies": {
-    "arktype": "^2.1.26",
-    "@prisma-next/operations": "0.5.0-dev.9"
+    "arktype": "^2.1.29",
+    "@prisma-next/operations": "0.5.0",
+    "@prisma-next/sql-contract": "0.5.0"
   },
   "devDependencies": {
-    "tsdown": "0.18.4",
+    "tsdown": "0.22.0",
     "typescript": "5.9.3",
-    "vitest": "4.0.17",
+    "vitest": "4.1.5",
+    "@prisma-next/emitter": "0.5.0",
     "@prisma-next/test-utils": "0.0.1",
-    "@prisma-next/tsdown": "0.0.0",
-    "@prisma-next/emitter": "0.5.0-dev.9",
-    "@prisma-next/tsconfig": "0.0.0"
+    "@prisma-next/tsconfig": "0.0.0",
+    "@prisma-next/tsdown": "0.0.0"
   },
   "files": [
     "dist",

package/src/index.ts

@@ -1,9 +1,10 @@
 import type {
   OperationDescriptor,
-  OperationEntry,
+  OperationDescriptors,
   OperationRegistry,
 } from '@prisma-next/operations';
 import { createOperationRegistry } from '@prisma-next/operations';
+import type { QueryOperationTypeEntry } from '@prisma-next/sql-contract/types';
 
 export interface SqlLoweringSpec {
   readonly targetFamily: 'sql';
@@ -11,12 +12,19 @@ export interface SqlLoweringSpec {
   readonly template: string;
 }
 
-export interface SqlOperationEntry extends OperationEntry {
-  readonly lowering: SqlLoweringSpec;
-}
+/**
+ * Runtime shape of a SQL operation entry — tightened beyond the framework's
+ * target-agnostic `OperationEntry` so `impl` returns a codec-exact
+ * `QueryOperationReturn` instead of `unknown`. Consumers (ORM column helper,
+ * sql-builder `fns` dispatch) can read `result.returnType.codecId` without a
+ * cast.
+ */
+export type SqlOperationEntry = QueryOperationTypeEntry;
 
 export type SqlOperationDescriptor = OperationDescriptor<SqlOperationEntry>;
 
+export type SqlOperationDescriptors = OperationDescriptors<SqlOperationEntry>;
+
 export type SqlOperationRegistry = OperationRegistry<SqlOperationEntry>;
 
 export function createSqlOperationRegistry(): SqlOperationRegistry {