@prisma-next/operations 0.5.0-dev.3 → 0.5.0-dev.30

package/README.md

@@ -22,7 +22,7 @@ This package provides a generic, target-neutral operation registry. It's part of
 - **Depended on by**:
   - `@prisma-next/sql-operations` (extends with SQL-specific lowering specs)
   - `@prisma-next/sql-relational-core` (imports `ParamSpec` for AST and type definitions)
-  - `@prisma-next/runtime-executor` (uses for operation registry creation)
+  - `@prisma-next/sql-runtime`, `@prisma-next/framework-components`, and other packages that build on the operation registry
 
 ## Architecture
 

package/dist/index.d.mts

@@ -8,9 +8,16 @@ interface ReturnSpec {
   readonly codecId: string;
   readonly nullable: boolean;
 }
+type SelfSpec = {
+  readonly codecId: string;
+  readonly traits?: never;
+} | {
+  readonly traits: readonly string[];
+  readonly codecId?: never;
+};
 interface OperationEntry {
-  readonly args: readonly ParamSpec[];
-  readonly returns: ReturnSpec;
+  readonly self?: SelfSpec;
+  readonly impl: (...args: never[]) => unknown;
 }
 type OperationDescriptor<T extends OperationEntry = OperationEntry> = T & {
   readonly method: string;
@@ -21,5 +28,5 @@ interface OperationRegistry<T extends OperationEntry = OperationEntry> {
 }
 declare function createOperationRegistry<T extends OperationEntry = OperationEntry>(): OperationRegistry<T>;
 //#endregion
-export { OperationDescriptor, OperationEntry, OperationRegistry, ParamSpec, ReturnSpec, createOperationRegistry };
+export { OperationDescriptor, OperationEntry, OperationRegistry, ParamSpec, ReturnSpec, SelfSpec, createOperationRegistry };
 //# 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":";UAAiB,SAAA;EAAA,SAAA,OAAS,CAAA,EAAA,MAAA;EAMT,SAAA,MAAU,CAAA,EAAA,SAAA,MAAA,EAAA;EAKV,SAAA,QAAc,EAAA,OAAA;AAK/B;AAA0C,UAVzB,UAAA,CAUyB;EAAiB,SAAA,OAAA,EAAA,MAAA;EAAkB,SAAA,QAAA,EAAA,OAAA;;AAI5D,UATA,cAAA,CASiB;EAAW,SAAA,IAAA,EAAA,SARnB,SAQmB,EAAA;EAAiB,SAAA,OAAA,EAP1C,UAO0C;;AACvC,KALX,mBAKW,CAAA,UALmB,cAKnB,GALoC,cAKpC,CAAA,GALsD,CAKtD,GAAA;EACc,SAAA,MAAA,EAAA,MAAA;CAAf;AAAT,UAFI,iBAEJ,CAAA,UAFgC,cAEhC,GAFiD,cAEjD,CAAA,CAAA;EAAQ,QAAA,CAAA,UAAA,EADE,mBACF,CADsB,CACtB,CAAA,CAAA,EAAA,IAAA;EAGL,OAAA,EAAA,EAHH,QAGG,CAHM,MAGiB,CAAA,MAAA,EAHF,CAGE,CAAA,CAAA;;AACV,iBADb,uBACa,CAAA,UAAjB,cAAiB,GAAA,cAAA,CAAA,CAAA,CAAA,EACxB,iBADwB,CACN,CADM,CAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";UAAiB,SAAA;EAAA,SAAA,OAAS,CAAA,EAAA,MAAA;EAMT,SAAA,MAAU,CAAA,EAAA,SAAA,MAAA,EAAA;EAKf,SAAA,QAAQ,EAAA,OAAA;AAIpB;AAKY,UAdK,UAAA,CAcc;EAAW,SAAA,OAAA,EAAA,MAAA;EAAiB,SAAA,QAAA,EAAA,OAAA;;AAAmB,KATlE,QAAA,GASkE;EAI7D,SAAA,OAAA,EAAA,MAAiB;EAAW,SAAA,MAAA,CAAA,EAAA,KAAA;CAAiB,GAAA;EACnB,SAAA,MAAA,EAAA,SAAA,MAAA,EAAA;EAApB,SAAA,OAAA,CAAA,EAAA,KAAA;CACc;AAAf,UAXL,cAAA,CAWK;EAAT,SAAA,IAAA,CAAA,EAVK,QAUL;EAAQ,SAAA,IAAA,EAAA,CAAA,GAAA,IAAA,EAAA,KAAA,EAAA,EAAA,GAAA,OAAA;AAGrB;AACY,KAVA,mBAUA,CAAA,UAV8B,cAU9B,GAV+C,cAU/C,CAAA,GAViE,CAUjE,GAAA;EAAiB,SAAA,MAAA,EAAA,MAAA;CACN;AAAlB,UAPY,iBAOZ,CAAA,UAPwC,cAOxC,GAPyD,cAOzD,CAAA,CAAA;EAAiB,QAAA,CAAA,UAAA,EANC,mBAMD,CANqB,CAMrB,CAAA,CAAA,EAAA,IAAA;aALT,SAAS,eAAe;;iBAGrB,kCACJ,iBAAiB,mBACxB,kBAAkB"}

package/dist/index.mjs

@@ -4,12 +4,12 @@ function createOperationRegistry() {
 	return {
 		register(descriptor) {
 			if (descriptor.method in operations) throw new Error(`Operation "${descriptor.method}" is already registered`);
-			descriptor.args.forEach((arg, i) => {
-				const hasCodecId = arg.codecId !== void 0;
-				const hasTraits = arg.traits !== void 0 && arg.traits.length > 0;
-				if (!hasCodecId && !hasTraits) throw new Error(`Operation "${descriptor.method}" arg[${i}] has neither codecId nor traits`);
-				if (hasCodecId && hasTraits) throw new Error(`Operation "${descriptor.method}" arg[${i}] has both codecId and traits`);
-			});
+			if (descriptor.self) {
+				const hasCodecId = descriptor.self.codecId !== void 0;
+				const hasTraits = descriptor.self.traits !== void 0 && descriptor.self.traits.length > 0;
+				if (!hasCodecId && !hasTraits) throw new Error(`Operation "${descriptor.method}" self has neither codecId nor traits`);
+				if (hasCodecId && hasTraits) throw new Error(`Operation "${descriptor.method}" self has both codecId and traits`);
+			}
 			const { method: _method, ...entry } = descriptor;
 			operations[descriptor.method] = entry;
 		},

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["operations: Record<string, T>"],"sources":["../src/index.ts"],"sourcesContent":["export interface ParamSpec {\n  readonly codecId?: string;\n  readonly traits?: readonly string[];\n  readonly nullable: boolean;\n}\n\nexport interface ReturnSpec {\n  readonly codecId: string;\n  readonly nullable: boolean;\n}\n\nexport interface OperationEntry {\n  readonly args: readonly ParamSpec[];\n  readonly returns: ReturnSpec;\n}\n\nexport type OperationDescriptor<T extends OperationEntry = OperationEntry> = T & {\n  readonly method: string;\n};\n\nexport interface OperationRegistry<T extends OperationEntry = OperationEntry> {\n  register(descriptor: OperationDescriptor<T>): void;\n  entries(): Readonly<Record<string, T>>;\n}\n\nexport function createOperationRegistry<\n  T extends OperationEntry = OperationEntry,\n>(): OperationRegistry<T> {\n  const operations: Record<string, T> = Object.create(null);\n\n  return {\n    register(descriptor: OperationDescriptor<T>) {\n      if (descriptor.method in operations) {\n        throw new Error(`Operation \"${descriptor.method}\" is already registered`);\n      }\n      descriptor.args.forEach((arg, i) => {\n        const hasCodecId = arg.codecId !== undefined;\n        const hasTraits = arg.traits !== undefined && arg.traits.length > 0;\n        if (!hasCodecId && !hasTraits) {\n          throw new Error(\n            `Operation \"${descriptor.method}\" arg[${i}] has neither codecId nor traits`,\n          );\n        }\n        if (hasCodecId && hasTraits) {\n          throw new Error(`Operation \"${descriptor.method}\" arg[${i}] has both codecId and traits`);\n        }\n      });\n      const { method: _method, ...entry } = descriptor;\n      // OperationDescriptor<T> = T & { method }, so stripping method yields T.\n      // TypeScript can't prove Omit<T & { method }, 'method'> = T for generic T.\n      operations[descriptor.method] = entry as unknown as T;\n    },\n    entries() {\n      return Object.freeze({ ...operations });\n    },\n  };\n}\n"],"mappings":";AAyBA,SAAgB,0BAEU;CACxB,MAAMA,aAAgC,OAAO,OAAO,KAAK;AAEzD,QAAO;EACL,SAAS,YAAoC;AAC3C,OAAI,WAAW,UAAU,WACvB,OAAM,IAAI,MAAM,cAAc,WAAW,OAAO,yBAAyB;AAE3E,cAAW,KAAK,SAAS,KAAK,MAAM;IAClC,MAAM,aAAa,IAAI,YAAY;IACnC,MAAM,YAAY,IAAI,WAAW,UAAa,IAAI,OAAO,SAAS;AAClE,QAAI,CAAC,cAAc,CAAC,UAClB,OAAM,IAAI,MACR,cAAc,WAAW,OAAO,QAAQ,EAAE,kCAC3C;AAEH,QAAI,cAAc,UAChB,OAAM,IAAI,MAAM,cAAc,WAAW,OAAO,QAAQ,EAAE,+BAA+B;KAE3F;GACF,MAAM,EAAE,QAAQ,SAAS,GAAG,UAAU;AAGtC,cAAW,WAAW,UAAU;;EAElC,UAAU;AACR,UAAO,OAAO,OAAO,EAAE,GAAG,YAAY,CAAC;;EAE1C"}
+{"version":3,"file":"index.mjs","names":["operations: Record<string, T>"],"sources":["../src/index.ts"],"sourcesContent":["export interface ParamSpec {\n  readonly codecId?: string;\n  readonly traits?: readonly string[];\n  readonly nullable: boolean;\n}\n\nexport interface ReturnSpec {\n  readonly codecId: string;\n  readonly nullable: boolean;\n}\n\nexport type SelfSpec =\n  | { readonly codecId: string; readonly traits?: never }\n  | { readonly traits: readonly string[]; readonly codecId?: never };\n\nexport interface OperationEntry {\n  readonly self?: SelfSpec;\n  readonly impl: (...args: never[]) => unknown;\n}\n\nexport type OperationDescriptor<T extends OperationEntry = OperationEntry> = T & {\n  readonly method: string;\n};\n\nexport interface OperationRegistry<T extends OperationEntry = OperationEntry> {\n  register(descriptor: OperationDescriptor<T>): void;\n  entries(): Readonly<Record<string, T>>;\n}\n\nexport function createOperationRegistry<\n  T extends OperationEntry = OperationEntry,\n>(): OperationRegistry<T> {\n  const operations: Record<string, T> = Object.create(null);\n\n  return {\n    register(descriptor: OperationDescriptor<T>) {\n      if (descriptor.method in operations) {\n        throw new Error(`Operation \"${descriptor.method}\" is already registered`);\n      }\n      if (descriptor.self) {\n        const hasCodecId = descriptor.self.codecId !== undefined;\n        const hasTraits = descriptor.self.traits !== undefined && descriptor.self.traits.length > 0;\n        if (!hasCodecId && !hasTraits) {\n          throw new Error(`Operation \"${descriptor.method}\" self has neither codecId nor traits`);\n        }\n        if (hasCodecId && hasTraits) {\n          throw new Error(`Operation \"${descriptor.method}\" self has both codecId and traits`);\n        }\n      }\n      const { method: _method, ...entry } = descriptor;\n      // OperationDescriptor<T> = T & { method }, so stripping method yields T.\n      // TypeScript can't prove Omit<T & { method }, 'method'> = T for generic T.\n      operations[descriptor.method] = entry as unknown as T;\n    },\n    entries() {\n      return Object.freeze({ ...operations });\n    },\n  };\n}\n"],"mappings":";AA6BA,SAAgB,0BAEU;CACxB,MAAMA,aAAgC,OAAO,OAAO,KAAK;AAEzD,QAAO;EACL,SAAS,YAAoC;AAC3C,OAAI,WAAW,UAAU,WACvB,OAAM,IAAI,MAAM,cAAc,WAAW,OAAO,yBAAyB;AAE3E,OAAI,WAAW,MAAM;IACnB,MAAM,aAAa,WAAW,KAAK,YAAY;IAC/C,MAAM,YAAY,WAAW,KAAK,WAAW,UAAa,WAAW,KAAK,OAAO,SAAS;AAC1F,QAAI,CAAC,cAAc,CAAC,UAClB,OAAM,IAAI,MAAM,cAAc,WAAW,OAAO,uCAAuC;AAEzF,QAAI,cAAc,UAChB,OAAM,IAAI,MAAM,cAAc,WAAW,OAAO,oCAAoC;;GAGxF,MAAM,EAAE,QAAQ,SAAS,GAAG,UAAU;AAGtC,cAAW,WAAW,UAAU;;EAElC,UAAU;AACR,UAAO,OAAO,OAAO,EAAE,GAAG,YAAY,CAAC;;EAE1C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma-next/operations",
-  "version": "0.5.0-dev.3",
+  "version": "0.5.0-dev.30",
   "type": "module",
   "sideEffects": false,
   "description": "Target-neutral operation registry and capability helpers for Prisma Next",
@@ -9,9 +9,9 @@
     "tsdown": "0.18.4",
     "typescript": "5.9.3",
     "vitest": "4.0.17",
+    "@prisma-next/test-utils": "0.0.1",
     "@prisma-next/tsconfig": "0.0.0",
-    "@prisma-next/tsdown": "0.0.0",
-    "@prisma-next/test-utils": "0.0.1"
+    "@prisma-next/tsdown": "0.0.0"
   },
   "files": [
     "dist",

package/src/index.ts

@@ -9,9 +9,13 @@ export interface ReturnSpec {
   readonly nullable: boolean;
 }
 
+export type SelfSpec =
+  | { readonly codecId: string; readonly traits?: never }
+  | { readonly traits: readonly string[]; readonly codecId?: never };
+
 export interface OperationEntry {
-  readonly args: readonly ParamSpec[];
-  readonly returns: ReturnSpec;
+  readonly self?: SelfSpec;
+  readonly impl: (...args: never[]) => unknown;
 }
 
 export type OperationDescriptor<T extends OperationEntry = OperationEntry> = T & {
@@ -33,18 +37,16 @@ export function createOperationRegistry<
       if (descriptor.method in operations) {
         throw new Error(`Operation "${descriptor.method}" is already registered`);
       }
-      descriptor.args.forEach((arg, i) => {
-        const hasCodecId = arg.codecId !== undefined;
-        const hasTraits = arg.traits !== undefined && arg.traits.length > 0;
+      if (descriptor.self) {
+        const hasCodecId = descriptor.self.codecId !== undefined;
+        const hasTraits = descriptor.self.traits !== undefined && descriptor.self.traits.length > 0;
         if (!hasCodecId && !hasTraits) {
-          throw new Error(
-            `Operation "${descriptor.method}" arg[${i}] has neither codecId nor traits`,
-          );
+          throw new Error(`Operation "${descriptor.method}" self has neither codecId nor traits`);
         }
         if (hasCodecId && hasTraits) {
-          throw new Error(`Operation "${descriptor.method}" arg[${i}] has both codecId and traits`);
+          throw new Error(`Operation "${descriptor.method}" self has both codecId and traits`);
         }
-      });
+      }
       const { method: _method, ...entry } = descriptor;
       // OperationDescriptor<T> = T & { method }, so stripping method yields T.
       // TypeScript can't prove Omit<T & { method }, 'method'> = T for generic T.