@sungen/driver-api 3.1.2-beta.111 → 3.1.2-beta.112

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sungen/driver-api",
-  "version": "3.1.2-beta.111",
+  "version": "3.1.2-beta.112",
   "description": "Sungen API capability — the @api annotation, API catalog, OpenAPI import + `sungen api import`, and the specs/api.ts runtime template. Plugs into @sun-asterisk/sungen via the capability SPI.",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -13,7 +13,7 @@
   "author": "eqe team (engineer & quality) — Sun Asterisk",
   "license": "MIT",
   "dependencies": {
-    "@sun-asterisk/sungen": "3.1.2-beta.111",
+    "@sun-asterisk/sungen": "3.1.2-beta.112",
     "commander": "^14.0.2",
     "yaml": "^2.8.2"
   },

package/src/index.ts

@@ -55,6 +55,11 @@ export { importCsv, parseCsv } from './csv-import';
 function apiPreconditionCodegen(input: { tags: string[]; screenName: string; cwd: string }): Array<{ comment?: string; code: string; boundVars?: string[] }> {
   const out: Array<{ comment?: string; code: string; boundVars?: string[] }> = [];
   const TAG = /^@api:([A-Za-z_][A-Za-z0-9_]*)(?:\((.*)\))?$/;
+  // @concurrent:N (AP-5): fire each @api call N times in parallel and bind aggregates
+  // ({{name.ok_count}}, {{name.status_counts}}) — the idempotency/race oracle. Applies to the
+  // scenario's @api call(s); pair with @query to cross-check the DB ("exactly one charge").
+  const concMatch = input.tags.map((t) => t.match(/^@concurrent:(\d+)$/)).find(Boolean);
+  const concurrent = concMatch ? Math.max(1, parseInt(concMatch[1], 10)) : 0;
   for (const tag of input.tags) {
     const m = tag.match(TAG);
     if (!m) continue;
@@ -71,9 +76,15 @@ function apiPreconditionCodegen(input: { tags: string[]; screenName: string; cwd
     // mechanism (the dynamic value comes via an override like `token={{login.body.token}}`).
     const hdr = entry.headers && Object.keys(entry.headers).length ? `, headers: ${JSON.stringify(entry.headers)}` : '';
     const req = `{ method: ${JSON.stringify(entry.method)}, path: ${JSON.stringify(entry.path)}${entry.body !== undefined ? `, body: ${JSON.stringify(entry.body)}` : ''}${hdr}, datasource: ${ds} }`;
+    // @concurrent:N → callN (N parallel calls, aggregate result); else a single call.
+    const callExpr = concurrent
+      ? `await api.callN(${label}, ${req}, { ${paramsObj} }, ${concurrent})`
+      : `await api.call(${label}, ${req}, { ${paramsObj} })`;
     out.push({
-      comment: `@api:${name} → bind {{${name}}} (${entry.method} ${entry.path})`,
-      code: `testData.bind(${JSON.stringify(name)}, await api.call(${label}, ${req}, { ${paramsObj} }));`,
+      comment: concurrent
+        ? `@api:${name} ×${concurrent} (@concurrent) → bind {{${name}}} aggregates (${entry.method} ${entry.path})`
+        : `@api:${name} → bind {{${name}}} (${entry.method} ${entry.path})`,
+      code: `testData.bind(${JSON.stringify(name)}, ${callExpr});`,
       boundVars: [name],
     });
   }