@specverse/engines 6.5.3 → 6.6.3

package/libs/instance-factories/services/templates/mongodb-native/service-generator.ts

@@ -0,0 +1,83 @@
+/**
+ * MongoDB Native Driver — Service Generator
+ *
+ * Generates abstract business-logic services that use `getCollection` /
+ * `getDb` directly. The service body is intentionally skeletal: each
+ * declared operation gets a typed method, but the body is a TODO stub
+ * containing the spec steps as comments. Real-implementation generation
+ * is a separate concern (#43 follow-up: behavior-step → driver-call
+ * conventions parity with the prisma step library).
+ */
+import type { TemplateContext } from '@specverse/types';
+
+export default function generateMongoNativeService(context: TemplateContext): string {
+  const { service } = context;
+  if (!service) throw new Error('Service is required in template context');
+
+  const serviceName = service.name;
+  const operationsCode = generateOperations(service);
+  const usesDb = /\bgetDb\b|\bgetCollection\b/.test(operationsCode);
+  const hasEvents = (service.publishes && service.publishes.length > 0) ||
+                    (service.subscribes && service.subscribes.length > 0);
+
+  return `/**
+ * ${serviceName}
+ * Abstract business logic service (MongoDB native driver)
+ * ${service.description || ''}
+ */
+${usesDb ? `import { getDb, getCollection } from '../db/mongoClient.js';` : ''}
+${hasEvents ? `import { eventBus } from '../events/eventBus.js';` : ''}
+
+export class ${serviceName} {
+${operationsCode}
+}
+
+const ${lowerFirst(serviceName)} = new ${serviceName}();
+export const ${lowerFirst(serviceName)}Instance = ${lowerFirst(serviceName)};
+export default ${lowerFirst(serviceName)};
+`;
+}
+
+function lowerFirst(s: string): string {
+  return s.charAt(0).toLowerCase() + s.slice(1);
+}
+
+function generateOperations(service: any): string {
+  const ops = service.operations;
+  if (!ops || (Array.isArray(ops) && ops.length === 0) || (!Array.isArray(ops) && Object.keys(ops).length === 0)) {
+    return `
+  /**
+   * Default service entrypoint — replace with real operations once declared
+   * on the service's spec.
+   */
+  public async execute(_params: any = {}): Promise<any> {
+    throw new Error('${service.name}.execute is not implemented');
+  }
+`;
+  }
+  const entries: [string, any][] = Array.isArray(ops)
+    ? ops.map((op: any) => [op.name, op])
+    : Object.entries(ops);
+  return entries.map(([name, op]) => generateOperation(name, op, service.name)).join('\n');
+}
+
+function generateOperation(operationName: string, operation: any, serviceName: string): string {
+  const stepsHeader = (operation.steps && operation.steps.length > 0)
+    ? operation.steps.map((s: any) => `   *   - ${typeof s === 'string' ? s : (s.action || JSON.stringify(s))}`).join('\n')
+    : '   *   (no spec steps declared)';
+  return `
+  /**
+   * ${operationName}
+   * ${operation.description || ''}
+   *
+   * Spec steps:
+${stepsHeader}
+   */
+  public async ${operationName}(_args: any = {}): Promise<any> {
+    // TODO (#43 follow-up): translate spec steps into native MongoDB driver
+    // calls. For now this is a stub so realize completes and the service
+    // surface is callable for parity tests.
+    throw new Error('${serviceName}.${operationName} is not implemented');
+  }
+`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specverse/engines",
-  "version": "6.5.3",
+  "version": "6.6.3",
   "description": "SpecVerse toolchain — parser, inference, realize, generators, AI, registry, bundles",
   "type": "module",
   "main": "dist/index.js",
@@ -62,7 +62,7 @@
     "@ai-sdk/openai-compatible": "^2.0.41",
     "@ai-sdk/provider": "^3.0.8",
     "@specverse/assets": "^1.6.0",
-    "@specverse/engines": "^6.4.0",
+    "@specverse/engines": "^6.6.1",
     "@specverse/entities": "^5.1.0",
     "@specverse/runtime": "^5.0.1",
     "@specverse/types": "^5.1.0",