@specverse/engines 4.3.2 → 4.3.3

package/dist/libs/instance-factories/applications/templates/react/api-client-generator.js

@@ -30,6 +30,19 @@ function generateApiClient(pattern) {
 
 import type { ApiResponse, RuntimeInfo, ModelSchema, View, Service, Behavior, Entity, Operation } from '../types/api';
 
+/**
+ * English pluralizer, matches \`deriveBasePath\` in
+ * @specverse/types/spec-rules \u2014 the source of truth for how the
+ * backend pluralizes REST paths. Keep in sync: Category \u2192
+ * categories (not \`categorys\`), Box \u2192 boxes, Child \u2192 childs (yes,
+ * naive \u2014 irregulars not supported).
+ */
+function pluralize(s: string): string {
+  if (/[^aeiou]y$/i.test(s)) return s.slice(0, -1) + 'ies';
+  if (/(s|x|z|ch|sh)$/i.test(s)) return s + 'es';
+  return s + 's';
+}
+
 // Get API URL from query parameter or default to proxy
 const urlParams = new URLSearchParams(window.location.search);
 const apiUrl = urlParams.get('api');
@@ -225,10 +238,8 @@ export async function getModelSchema(modelName: string): Promise<ModelSchema> {
  */
 export async function listEntities(controllerName: string): Promise<Entity[]> {
   try {
-    // Extract model name from controller name (e.g., "AuthorController" -> "authors")
-    const modelName = controllerName
-      .replace(/Controller$/, '')
-      .toLowerCase() + 's';
+    // Derive REST path \u2014 matches \`deriveBasePath\` in the backend.
+    const modelName = pluralize(controllerName.replace(/Controller$/, '').toLowerCase());
 
     const entities = await apiRequest<Entity[]>('GET', \`/\${modelName}\`);
     return entities || [];
@@ -247,10 +258,8 @@ export async function executeOperation(
   operationName: string,
   params: Record<string, any>
 ): Promise<ApiResponse> {
-  // Extract model name from controller name (e.g., "AuthorController" -> "authors")
-  const modelName = controllerName
-    .replace(/Controller$/, '')
-    .toLowerCase() + 's';
+  // Derive REST path \u2014 matches \`deriveBasePath\` in the backend.
+  const modelName = pluralize(controllerName.replace(/Controller$/, '').toLowerCase());
 
   let method: string;
   let path: string;
@@ -344,7 +353,7 @@ export async function transitionState(
     body.lifecycleName = lifecycleName;
   }
 
-  const resource = modelName.toLowerCase() + 's';
+  const resource = pluralize(modelName.toLowerCase());
   return apiRequest<ApiResponse>(
     'PATCH',
     \`/\${resource}/\${entityId}/evolve\`,
@@ -360,7 +369,7 @@ export async function getAvailableTransitions(
   entityId: string,
   lifecycleName?: string
 ): Promise<string[]> {
-  const resource = modelName.toLowerCase() + 's';
+  const resource = pluralize(modelName.toLowerCase());
   const url = lifecycleName
     ? \`/\${resource}/\${entityId}/transitions?lifecycleName=\${lifecycleName}\`
     : \`/\${resource}/\${entityId}/transitions\`;
@@ -453,7 +462,7 @@ export async function transitionState(
     body.lifecycleName = lifecycleName;
   }
 
-  const resource = modelName.toLowerCase() + 's';
+  const resource = pluralize(modelName.toLowerCase());
   return apiRequest<ApiResponse>(
     'PATCH',
     \`/\${resource}/\${entityId}/evolve\`,

package/libs/instance-factories/applications/templates/react/api-client-generator.ts

@@ -63,6 +63,19 @@ function generateApiClient(pattern: 'rest' | 'controller'): string {
 
 import type { ApiResponse, RuntimeInfo, ModelSchema, View, Service, Behavior, Entity, Operation } from '../types/api';
 
+/**
+ * English pluralizer, matches \`deriveBasePath\` in
+ * @specverse/types/spec-rules — the source of truth for how the
+ * backend pluralizes REST paths. Keep in sync: Category →
+ * categories (not \`categorys\`), Box → boxes, Child → childs (yes,
+ * naive — irregulars not supported).
+ */
+function pluralize(s: string): string {
+  if (/[^aeiou]y$/i.test(s)) return s.slice(0, -1) + 'ies';
+  if (/(s|x|z|ch|sh)$/i.test(s)) return s + 'es';
+  return s + 's';
+}
+
 // Get API URL from query parameter or default to proxy
 const urlParams = new URLSearchParams(window.location.search);
 const apiUrl = urlParams.get('api');
@@ -261,10 +274,8 @@ export async function getModelSchema(modelName: string): Promise<ModelSchema> {
  */
 export async function listEntities(controllerName: string): Promise<Entity[]> {
   try {
-    // Extract model name from controller name (e.g., "AuthorController" -> "authors")
-    const modelName = controllerName
-      .replace(/Controller$/, '')
-      .toLowerCase() + 's';
+    // Derive REST path — matches \`deriveBasePath\` in the backend.
+    const modelName = pluralize(controllerName.replace(/Controller$/, '').toLowerCase());
 
     const entities = await apiRequest<Entity[]>('GET', \`/\${modelName}\`);
     return entities || [];
@@ -283,10 +294,8 @@ export async function executeOperation(
   operationName: string,
   params: Record<string, any>
 ): Promise<ApiResponse> {
-  // Extract model name from controller name (e.g., "AuthorController" -> "authors")
-  const modelName = controllerName
-    .replace(/Controller$/, '')
-    .toLowerCase() + 's';
+  // Derive REST path — matches \`deriveBasePath\` in the backend.
+  const modelName = pluralize(controllerName.replace(/Controller$/, '').toLowerCase());
 
   let method: string;
   let path: string;
@@ -380,7 +389,7 @@ export async function transitionState(
     body.lifecycleName = lifecycleName;
   }
 
-  const resource = modelName.toLowerCase() + 's';
+  const resource = pluralize(modelName.toLowerCase());
   return apiRequest<ApiResponse>(
     'PATCH',
     \`/\${resource}/\${entityId}/evolve\`,
@@ -396,7 +405,7 @@ export async function getAvailableTransitions(
   entityId: string,
   lifecycleName?: string
 ): Promise<string[]> {
-  const resource = modelName.toLowerCase() + 's';
+  const resource = pluralize(modelName.toLowerCase());
   const url = lifecycleName
     ? \`/\${resource}/\${entityId}/transitions?lifecycleName=\${lifecycleName}\`
     : \`/\${resource}/\${entityId}/transitions\`;
@@ -490,7 +499,7 @@ export async function transitionState(
     body.lifecycleName = lifecycleName;
   }
 
-  const resource = modelName.toLowerCase() + 's';
+  const resource = pluralize(modelName.toLowerCase());
   return apiRequest<ApiResponse>(
     'PATCH',
     \`/\${resource}/\${entityId}/evolve\`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specverse/engines",
-  "version": "4.3.2",
+  "version": "4.3.3",
   "description": "SpecVerse toolchain — parser, inference, realize, generators, AI, registry",
   "type": "module",
   "main": "dist/index.js",