prisma-generator-express 1.54.0 → 1.55.0

package/dist/index.js

@@ -28,6 +28,21 @@ function getTarget(options) {
         return raw;
     throw new Error(`Invalid target "${raw}". Expected "express", "fastify", or "hono".`);
 }
+function getWriteStrategy(options) {
+    const raw = String(options.generator.config.writeStrategy ?? 'regular');
+    const lower = raw.toLowerCase();
+    if (lower === 'regular')
+        return 'regular';
+    if (lower === 'throwonnonreturning')
+        return 'throwOnNonReturning';
+    if (lower === 'throwonregular') {
+        console.warn('[prisma-generator-express] writeStrategy="throwOnRegular" is deprecated. Use "throwOnNonReturning" instead.');
+        return 'throwOnNonReturning';
+    }
+    if (lower === 'forcereturn')
+        return 'forceReturn';
+    throw new Error(`Invalid writeStrategy "${raw}". Expected "regular", "throwOnNonReturning", or "forceReturn".`);
+}
 function validateClientGeneratorPresent(options) {
     (0, generateImportPrismaStatement_1.getRelativeClientPath)(options, options.dmmf.datamodel.models[0]?.name ?? 'Model');
 }
@@ -41,6 +56,7 @@ function validateClientGeneratorPresent(options) {
     },
     async onGenerate(options) {
         const target = getTarget(options);
+        const writeStrategy = getWriteStrategy(options);
         const hasExplicitOutput = !!options.generator.output?.fromEnvVar ||
             options.generator.config.output !== undefined;
         if (!hasExplicitOutput) {
@@ -53,6 +69,7 @@ function validateClientGeneratorPresent(options) {
         console.log(`  Target: ${target}`);
         console.log(`  Output: ${options.generator.output?.value}`);
         console.log(`  Import style: ${importStyle}`);
+        console.log(`  Write strategy: ${writeStrategy}`);
         if (options.dmmf.datamodel.models.length > 0) {
             validateClientGeneratorPresent(options);
         }
@@ -65,15 +82,14 @@ function validateClientGeneratorPresent(options) {
                 : generateUnifiedHandler_1.generateUnifiedHandler;
         const allModels = options.dmmf.datamodel.models;
         for (const model of options.dmmf.datamodel.models) {
-            if (model.documentation &&
-                GENERATOR_OFF_RE.test(model.documentation)) {
+            if (model.documentation && GENERATOR_OFF_RE.test(model.documentation)) {
                 console.log(`  Skipping: ${model.name} (generator off)`);
                 continue;
             }
             modelNames.push(model.name);
             const guardShapesImport = (0, generateImportPrismaStatement_1.getGuardShapesImport)(options, model.name);
             await (0, writeFileSafely_1.writeFileSafely)({
-                content: (0, generateOperationCore_1.generateModelCore)({ model: model, importStyle }),
+                content: (0, generateOperationCore_1.generateModelCore)({ model: model, importStyle, writeStrategy }),
                 options,
                 model: model,
                 operation: 'Core',
@@ -90,6 +106,7 @@ function validateClientGeneratorPresent(options) {
                     enums: options.dmmf.datamodel.enums,
                     guardShapesImport,
                     importStyle,
+                    writeStrategy,
                 })
                 : target === 'hono'
                     ? (0, generateRouterHono_1.generateHonoRouterFunction)({
@@ -97,12 +114,14 @@ function validateClientGeneratorPresent(options) {
                         enums: options.dmmf.datamodel.enums,
                         guardShapesImport,
                         importStyle,
+                        writeStrategy,
                     })
                     : (0, generateRouter_1.generateRouterFunction)({
                         model: model,
                         enums: options.dmmf.datamodel.enums,
                         guardShapesImport,
                         importStyle,
+                        writeStrategy,
                     });
             await (0, writeFileSafely_1.writeFileSafely)({
                 content: routerContent,
@@ -116,6 +135,7 @@ function validateClientGeneratorPresent(options) {
                     enums: options.dmmf.datamodel.enums,
                     target,
                     importStyle,
+                    writeStrategy,
                 }),
                 options,
                 model: model,

package/dist/index.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "prisma-generator-express",
   "description": "Prisma generator for Express, Fastify, and Hono CRUD APIs with OpenAPI documentation",
-  "version": "1.54.0",
+  "version": "1.55.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "license": "MIT",

package/src/constants.ts

@@ -1,3 +1,5 @@
 export const GENERATOR_NAME = 'prisma-generator-express'
 
-export type Target = 'express' | 'fastify' | 'hono'
+export type Target = 'express' | 'fastify' | 'hono'
+
+export type WriteStrategy = 'regular' | 'throwOnNonReturning' | 'forceReturn'

package/src/copy/buildModelOpenApi.ts

@@ -1,4 +1,4 @@
-import type { RouteConfig } from './routeConfig'
+import type { RouteConfig, WriteStrategy } from './routeConfig'
 import { OPERATION_DEFS, isOperationEnabled } from './operationDefinitions'
 import { normalizePrefix, removeTrailingSlash } from './misc'
 
@@ -51,6 +51,7 @@ type BuildOptions = {
   title?: string
   description?: string
   version?: string
+  writeStrategy?: WriteStrategy
 }
 
 const OP_MAP = new Map(OPERATION_DEFS.map((d) => [d.name, d]))
@@ -130,10 +131,7 @@ function scalarUpdateOperations(
   }
 
   return {
-    oneOf: [
-      baseSchema,
-      { type: 'object', properties: ops },
-    ],
+    oneOf: [baseSchema, { type: 'object', properties: ops }],
   }
 }
 
@@ -193,7 +191,10 @@ function countBodySchema(): SchemaObject {
       take: { type: 'integer', description: 'Limit results' },
       skip: { type: 'integer', description: 'Skip results' },
       cursor: { type: 'object', description: 'Cursor for pagination' },
-      select: { description: 'Count specific fields. When provided, returns per-field counts as an object instead of a single integer.' },
+      select: {
+        description:
+          'Count specific fields. When provided, returns per-field counts as an object instead of a single integer.',
+      },
     },
   }
 }
@@ -207,11 +208,25 @@ function aggregateBodySchema(): SchemaObject {
       cursor: { type: 'object', description: 'Cursor for pagination' },
       take: { type: 'integer', description: 'Limit results' },
       skip: { type: 'integer', description: 'Skip results' },
-      _count: { description: 'Count aggregate (true or field selection object)' },
-      _avg: { type: 'object', description: 'Average aggregate (field selection object)' },
-      _sum: { type: 'object', description: 'Sum aggregate (field selection object)' },
-      _min: { type: 'object', description: 'Min aggregate (field selection object)' },
-      _max: { type: 'object', description: 'Max aggregate (field selection object)' },
+      _count: {
+        description: 'Count aggregate (true or field selection object)',
+      },
+      _avg: {
+        type: 'object',
+        description: 'Average aggregate (field selection object)',
+      },
+      _sum: {
+        type: 'object',
+        description: 'Sum aggregate (field selection object)',
+      },
+      _min: {
+        type: 'object',
+        description: 'Min aggregate (field selection object)',
+      },
+      _max: {
+        type: 'object',
+        description: 'Max aggregate (field selection object)',
+      },
     },
   }
 }
@@ -220,17 +235,38 @@ function groupByBodySchema(): SchemaObject {
   return {
     type: 'object',
     properties: {
-      by: { type: 'array', items: { type: 'string' }, description: 'Fields to group by' },
+      by: {
+        type: 'array',
+        items: { type: 'string' },
+        description: 'Fields to group by',
+      },
       where: { type: 'object', description: 'Filter conditions' },
       orderBy: { description: 'Sort order. Required when using skip or take.' },
-      having: { type: 'object', description: 'Having conditions (filter object)' },
+      having: {
+        type: 'object',
+        description: 'Having conditions (filter object)',
+      },
       take: { type: 'integer', description: 'Limit results' },
       skip: { type: 'integer', description: 'Skip results' },
-      _count: { description: 'Count aggregate (true or field selection object)' },
-      _avg: { type: 'object', description: 'Average aggregate (field selection object)' },
-      _sum: { type: 'object', description: 'Sum aggregate (field selection object)' },
-      _min: { type: 'object', description: 'Min aggregate (field selection object)' },
-      _max: { type: 'object', description: 'Max aggregate (field selection object)' },
+      _count: {
+        description: 'Count aggregate (true or field selection object)',
+      },
+      _avg: {
+        type: 'object',
+        description: 'Average aggregate (field selection object)',
+      },
+      _sum: {
+        type: 'object',
+        description: 'Sum aggregate (field selection object)',
+      },
+      _min: {
+        type: 'object',
+        description: 'Min aggregate (field selection object)',
+      },
+      _max: {
+        type: 'object',
+        description: 'Max aggregate (field selection object)',
+      },
     },
     required: ['by'],
   }
@@ -257,6 +293,82 @@ function getPostReadBodySchema(opName: string): SchemaObject {
   }
 }
 
+function applyWriteStrategy(
+  spec: OpenApiSpec,
+  modelName: string,
+  basePath: string,
+  writeStrategy: WriteStrategy | undefined,
+): void {
+  if (!writeStrategy || writeStrategy === 'regular') return
+
+  const manyPath = basePath + '/many'
+  const node = spec.paths[manyPath]
+  if (!node) return
+
+  if (writeStrategy === 'throwOnNonReturning') {
+    delete node.post
+    delete node.put
+    if (Object.keys(node).length === 0) {
+      delete spec.paths[manyPath]
+    }
+    return
+  }
+
+  const responseRef: RefObject = {
+    $ref: '#/components/schemas/' + modelName + 'Response',
+  }
+
+  const injectProjectionAndArrayResponse = (
+    op: any,
+    successCode: '200' | '201',
+    summary: string,
+    description: string,
+  ): void => {
+    op.summary = summary
+    op.description = description
+    const r = op.responses?.[successCode]
+    if (r?.content?.['application/json']) {
+      r.content['application/json'].schema = {
+        type: 'array',
+        items: responseRef,
+      }
+    }
+    const reqSchema = op.requestBody?.content?.['application/json']?.schema
+    if (reqSchema && reqSchema.properties) {
+      reqSchema.properties.select = {
+        type: 'object',
+        description: 'Select fields to return',
+      }
+      reqSchema.properties.include = {
+        type: 'object',
+        description: 'Include relations to return',
+      }
+      reqSchema.properties.omit = {
+        type: 'object',
+        description: 'Omit fields from response',
+      }
+    }
+  }
+
+  if (node.post) {
+    injectProjectionAndArrayResponse(
+      node.post,
+      '201',
+      'Create many ' + modelName + ' (forceReturn)',
+      'writeStrategy="forceReturn": this endpoint silently invokes createManyAndReturn and returns the created records instead of { count }.',
+    )
+  }
+
+  if (node.put) {
+    injectProjectionAndArrayResponse(
+      node.put,
+      '200',
+      'Update many ' + modelName + ' (forceReturn)',
+      'writeStrategy="forceReturn": this endpoint silently invokes updateManyAndReturn and returns the updated records instead of { count }.',
+    )
+  }
+}
+
 export function buildModelOpenApi(
   modelName: string,
   modelFields: ModelField[],
@@ -321,6 +433,8 @@ export function buildModelOpenApi(
 
   generatePaths(spec, modelName, basePath, config, modelFields)
 
+  applyWriteStrategy(spec, modelName, basePath, options.writeStrategy)
+
   if (options.format === 'yaml') {
     return toYaml(spec)
   }
@@ -644,7 +758,8 @@ function addPostReadOperation(
     tags: [modelName],
     summary: summary + ' (POST)',
     operationId: `${modelName}${opName.charAt(0).toUpperCase() + opName.slice(1)}Post`,
-    description: (description ? description + ' ' : '') +
+    description:
+      (description ? description + ' ' : '') +
       'POST alternative for requests with complex query parameters that may exceed URL length limits. Accepts the same arguments as the GET endpoint but as a JSON request body instead of query parameters.',
     requestBody: {
       required: true,
@@ -1291,8 +1406,14 @@ function generatePaths(
         `Count ${modelName}`,
         {
           oneOf: [
-            { type: 'integer', description: 'Total count when select is not provided' },
-            { type: 'object', description: 'Per-field count object when select is provided' },
+            {
+              type: 'integer',
+              description: 'Total count when select is not provided',
+            },
+            {
+              type: 'object',
+              description: 'Per-field count object when select is provided',
+            },
           ],
         },
         [400, 403, 500, 501, 503],
@@ -1730,7 +1851,7 @@ function mapFieldToWriteSchema(
         description: field.documentation,
       }
     } else if (!('$ref' in schema)) {
-      (schema as SchemaObject).description = field.documentation
+      ;(schema as SchemaObject).description = field.documentation
     }
   }
 
@@ -1896,4 +2017,4 @@ function toYaml(obj: any, indent = 0): string {
   }
 
   return yaml
-}
+}