@specverse/engines 6.33.1 → 6.35.0

package/dist/realize/runtime-emitters/service.js

@@ -0,0 +1,355 @@
+/**
+ * Service-runtime emitter — V2 Phase 3, Round 2.
+ *
+ * Handles `topology: 'service'` factories: providers that ship as
+ * network-attached services we deploy ourselves (REST / gRPC / MCP).
+ *
+ * For each `import:` entry the consumer declares, this emitter produces:
+ *   clients/<provider-name>.ts                — typed network client
+ *   servers/<provider-name>-server.ts (cond.) — Fastify route scaffold
+ *
+ * The server-bind file is emitted only when `factory.v2metadata?.serverTemplate`
+ * is non-null and non-empty. Managed/external providers (we don't host them)
+ * leave it null; we-host providers populate it.
+ *
+ * Protocol dispatch (factory.v2metadata?.protocol):
+ *   'rest' (default)   → fetch-based HTTP client; one POST per dotted op
+ *   'grpc'             → gRPC stub init (Round 2: TODO scaffolding)
+ *   'mcp'              → MCP client init (Round 2: TODO scaffolding)
+ *
+ * Endpoint env-var resolution:
+ *   1. factory.v2metadata?.config?.endpoint?.env if present
+ *   2. Convention <UPPERCASE_PROVIDER>_API_URL otherwise
+ *
+ * Deployment hint: realize emits a `deployments.<env>.instances.services.<provider>`
+ * entry with `config: { endpoint: { env: <ENV_NAME> } }` — mentioned in result.notes
+ * for the consumer's review. The actual instance emission is upstream of this
+ * emitter; here we just declare the convention.
+ */
+// ─── Naming helpers (shared shape with library.ts; intentionally duplicated
+// rather than extracted to keep each emitter file self-contained for review) ─
+function parseSelectEntry(entry) {
+    const dotIndex = entry.indexOf('.');
+    if (dotIndex === -1)
+        return { head: entry, tail: undefined };
+    return { head: entry.slice(0, dotIndex), tail: entry.slice(dotIndex + 1) };
+}
+function toWords(fromName) {
+    const normalised = fromName.replace(/^@/, '').replace(/\//g, '-');
+    return normalised
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .replace(/[^a-zA-Z0-9]+/g, ' ')
+        .trim()
+        .split(' ')
+        .filter(Boolean)
+        .map((w) => w.toLowerCase());
+}
+function toClientName(fromName) {
+    const words = toWords(fromName);
+    if (words.length === 0)
+        return 'unknownClient';
+    return (words[0] +
+        words.slice(1).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(''));
+}
+function toInterfaceName(fromName) {
+    return toWords(fromName)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join('');
+}
+function toFileName(fromName) {
+    return toWords(fromName).join('-');
+}
+function toEnvVarName(fromName, suffix = '_API_URL') {
+    return toWords(fromName).join('_').toUpperCase() + suffix;
+}
+function resolveProtocol(ctx) {
+    const p = ctx.factory.v2metadata?.protocol;
+    if (p === 'grpc' || p === 'mcp')
+        return p;
+    return 'rest';
+}
+function resolveEndpointEnv(ctx) {
+    const config = ctx.factory.v2metadata?.config;
+    return config?.endpoint?.env ?? toEnvVarName(ctx.importEntry.from, '_API_URL');
+}
+function resolveServerTemplate(ctx) {
+    return ctx.factory.v2metadata?.serverTemplate;
+}
+function shouldEmitServerBind(ctx) {
+    const t = resolveServerTemplate(ctx);
+    return typeof t === 'string' && t.length > 0;
+}
+// ─── REST client generator ────────────────────────────────────────────────────
+function generateRestClient(ctx, clientName, interfaceName) {
+    const { importEntry } = ctx;
+    const selectEntries = importEntry.select ?? [];
+    const envVar = resolveEndpointEnv(ctx);
+    const lines = [];
+    lines.push('// FACTORY-EMITTED — DO NOT EDIT (R8)');
+    lines.push(`// Generated by service-runtime emitter — V2 Phase 3`);
+    lines.push(`// Provider: ${importEntry.from} (protocol: rest)`);
+    lines.push(`// Endpoint: process.env.${envVar} (required at runtime)`);
+    lines.push('');
+    // Interface
+    lines.push(`export type ${interfaceName}Client = {`);
+    const seenIface = new Set();
+    for (const entry of selectEntries) {
+        if (seenIface.has(entry))
+            continue;
+        seenIface.add(entry);
+        const { head, tail } = parseSelectEntry(entry);
+        if (tail === undefined) {
+            lines.push(`  /** ${head} entity — passthrough HTTP slot. Round 3: substitute real type. */`);
+            lines.push(`  ${head}(...args: unknown[]): Promise<unknown>;`);
+        }
+        else {
+            lines.push(`  /** ${head}.${tail} — POST /${head.toLowerCase()}/${tail}. Round 3: substitute real input/output types. */`);
+            lines.push(`  ${tail}(input: unknown): Promise<unknown>;`);
+        }
+    }
+    lines.push('};');
+    lines.push('');
+    // Endpoint resolution helper
+    lines.push(`function resolveBaseUrl(): string {`);
+    lines.push(`  const url = process.env.${envVar};`);
+    lines.push(`  if (!url) throw new Error('${envVar} env var is not set; required for ${importEntry.from} client');`);
+    lines.push(`  return url.replace(/\\/+$/, '');`);
+    lines.push(`}`);
+    lines.push('');
+    // POST helper
+    lines.push(`async function postJson(path: string, body: unknown): Promise<unknown> {`);
+    lines.push(`  const baseUrl = resolveBaseUrl();`);
+    lines.push(`  const r = await fetch(\`\${baseUrl}\${path}\`, {`);
+    lines.push(`    method: 'POST',`);
+    lines.push(`    headers: { 'Content-Type': 'application/json' },`);
+    lines.push(`    body: JSON.stringify(body),`);
+    lines.push(`  });`);
+    lines.push(`  if (!r.ok) {`);
+    lines.push(`    const errText = await r.text().catch(() => '<no body>');`);
+    lines.push(`    throw new Error(\`\${path} failed: \${r.status} \${r.statusText} — \${errText}\`);`);
+    lines.push(`  }`);
+    lines.push(`  return r.json();`);
+    lines.push(`}`);
+    lines.push('');
+    // Constant
+    lines.push(`export const ${clientName}Client: ${interfaceName}Client = {`);
+    const seenConst = new Set();
+    for (const entry of selectEntries) {
+        if (seenConst.has(entry))
+            continue;
+        seenConst.add(entry);
+        const { head, tail } = parseSelectEntry(entry);
+        if (tail === undefined) {
+            lines.push(`  ${head}(...args: unknown[]): Promise<unknown> {`);
+            lines.push(`    return postJson('/${head.toLowerCase()}', args);`);
+            lines.push(`  },`);
+        }
+        else {
+            lines.push(`  ${tail}(input: unknown): Promise<unknown> {`);
+            lines.push(`    return postJson('/${head.toLowerCase()}/${tail}', input);`);
+            lines.push(`  },`);
+        }
+    }
+    lines.push('};');
+    lines.push('');
+    return lines.join('\n');
+}
+// ─── gRPC client generator (Round 2 stub) ─────────────────────────────────────
+function generateGrpcClient(ctx, clientName, interfaceName) {
+    const { importEntry } = ctx;
+    const selectEntries = importEntry.select ?? [];
+    const lines = [];
+    lines.push('// FACTORY-EMITTED — DO NOT EDIT (R8)');
+    lines.push(`// Generated by service-runtime emitter — V2 Phase 3`);
+    lines.push(`// Provider: ${importEntry.from} (protocol: grpc)`);
+    lines.push(`// TODO (Round 3): wire actual gRPC stub from .proto descriptor.`);
+    lines.push(`//   Until then methods throw at call-time. Interface compiles cleanly.`);
+    lines.push('');
+    lines.push(`export type ${interfaceName}Client = {`);
+    const seen = new Set();
+    for (const entry of selectEntries) {
+        if (seen.has(entry))
+            continue;
+        seen.add(entry);
+        const { tail } = parseSelectEntry(entry);
+        if (tail === undefined) {
+            lines.push(`  ${entry}(...args: unknown[]): Promise<unknown>;`);
+        }
+        else {
+            lines.push(`  ${tail}(...args: unknown[]): Promise<unknown>;`);
+        }
+    }
+    lines.push('};');
+    lines.push('');
+    lines.push(`export const ${clientName}Client: ${interfaceName}Client = {`);
+    const seen2 = new Set();
+    for (const entry of selectEntries) {
+        if (seen2.has(entry))
+            continue;
+        seen2.add(entry);
+        const { tail } = parseSelectEntry(entry);
+        const methodName = tail ?? entry;
+        lines.push(`  ${methodName}(..._args: unknown[]): Promise<unknown> {`);
+        lines.push(`    throw new Error('gRPC stub for ${importEntry.from}.${methodName}: proto wiring is Round 3 TODO');`);
+        lines.push(`  },`);
+    }
+    lines.push('};');
+    lines.push('');
+    return lines.join('\n');
+}
+// ─── MCP client generator (Round 2 stub) ──────────────────────────────────────
+function generateMcpClient(ctx, clientName, interfaceName) {
+    const { importEntry } = ctx;
+    const selectEntries = importEntry.select ?? [];
+    const lines = [];
+    lines.push('// FACTORY-EMITTED — DO NOT EDIT (R8)');
+    lines.push(`// Generated by service-runtime emitter — V2 Phase 3`);
+    lines.push(`// Provider: ${importEntry.from} (protocol: mcp)`);
+    lines.push(`// TODO (Round 3): wire @modelcontextprotocol/sdk client + stdio transport.`);
+    lines.push(`//   Until then methods throw at call-time. Interface compiles cleanly.`);
+    lines.push('');
+    lines.push(`export type ${interfaceName}Client = {`);
+    const seen = new Set();
+    for (const entry of selectEntries) {
+        if (seen.has(entry))
+            continue;
+        seen.add(entry);
+        const { tail } = parseSelectEntry(entry);
+        if (tail === undefined) {
+            lines.push(`  ${entry}(...args: unknown[]): Promise<unknown>;`);
+        }
+        else {
+            lines.push(`  ${tail}(...args: unknown[]): Promise<unknown>;`);
+        }
+    }
+    lines.push('};');
+    lines.push('');
+    lines.push(`export const ${clientName}Client: ${interfaceName}Client = {`);
+    const seen2 = new Set();
+    for (const entry of selectEntries) {
+        if (seen2.has(entry))
+            continue;
+        seen2.add(entry);
+        const { tail } = parseSelectEntry(entry);
+        const methodName = tail ?? entry;
+        lines.push(`  ${methodName}(..._args: unknown[]): Promise<unknown> {`);
+        lines.push(`    throw new Error('MCP stub for ${importEntry.from}.${methodName}: SDK wiring is Round 3 TODO');`);
+        lines.push(`  },`);
+    }
+    lines.push('};');
+    lines.push('');
+    return lines.join('\n');
+}
+// ─── Server-bind generator (Fastify route scaffold) ───────────────────────────
+function generateServerBind(ctx, interfaceName) {
+    const { importEntry } = ctx;
+    const selectEntries = importEntry.select ?? [];
+    const lines = [];
+    lines.push('// FACTORY-EMITTED — DO NOT EDIT (R8)');
+    lines.push(`// Server-bind scaffold for ${importEntry.from} — V2 Phase 3`);
+    lines.push(`// One Fastify route per dotted op. Route bodies throw a clear error;`);
+    lines.push(`// Round 3 wires the actual spec operations into each handler.`);
+    lines.push('');
+    lines.push(`import type { FastifyInstance, FastifyRequest, FastifyReply } from 'fastify';`);
+    lines.push('');
+    lines.push(`export function register${interfaceName}Routes(fastify: FastifyInstance): void {`);
+    const seen = new Set();
+    for (const entry of selectEntries) {
+        if (seen.has(entry))
+            continue;
+        seen.add(entry);
+        const { head, tail } = parseSelectEntry(entry);
+        const path = tail ? `/${head.toLowerCase()}/${tail}` : `/${head.toLowerCase()}`;
+        lines.push(`  fastify.post('${path}', async (req: FastifyRequest, _reply: FastifyReply) => {`);
+        lines.push(`    // TODO (Round 3): wire spec operation '${entry}' into this handler.`);
+        lines.push(`    throw new Error('handler not implemented — Round 3 wires the spec operation in: ${entry}');`);
+        lines.push(`  });`);
+    }
+    lines.push(`}`);
+    lines.push('');
+    return lines.join('\n');
+}
+// ─── Service emitter ──────────────────────────────────────────────────────────
+/**
+ * Service-runtime emitter implementation.
+ *
+ * One call to `emit()` processes a single `import:` entry. Produces:
+ *   - 1 client file under `clients/<provider-filename>.ts`
+ *   - 1 server-bind file under `servers/<provider-filename>-server.ts` (only
+ *     when factory.v2metadata.serverTemplate is non-null)
+ */
+export class ServiceRuntimeEmitter {
+    topology = 'service';
+    async emit(ctx) {
+        const { importEntry, factory } = ctx;
+        const selectEntries = importEntry.select ?? [];
+        const fileName = toFileName(importEntry.from);
+        const clientName = toClientName(importEntry.from);
+        const interfaceName = toInterfaceName(importEntry.from);
+        const protocol = resolveProtocol(ctx);
+        const envVar = resolveEndpointEnv(ctx);
+        // Generate client content based on protocol.
+        let clientContent;
+        if (protocol === 'grpc') {
+            clientContent = generateGrpcClient(ctx, clientName, interfaceName);
+        }
+        else if (protocol === 'mcp') {
+            clientContent = generateMcpClient(ctx, clientName, interfaceName);
+        }
+        else {
+            clientContent = generateRestClient(ctx, clientName, interfaceName);
+        }
+        const files = [
+            { path: `clients/${fileName}.ts`, content: clientContent },
+        ];
+        // Conditional server-bind file.
+        if (shouldEmitServerBind(ctx)) {
+            const serverContent = generateServerBind(ctx, interfaceName);
+            files.push({ path: `servers/${fileName}-server.ts`, content: serverContent });
+        }
+        // Consumer-side import entry.
+        const consumerImport = {
+            from: `./clients/${fileName}`,
+            specifier: `${clientName}Client`,
+        };
+        const notes = [
+            `Deployment hint: deployments.<env>.instances.services.${clientName} with config: { endpoint: { env: '${envVar}' } } (factory: ${factory.name}, protocol: ${protocol}).`,
+        ];
+        if (selectEntries.length === 0) {
+            notes.push(`Warning: import entry from '${importEntry.from}' has empty select: — no client members emitted.`);
+        }
+        if (protocol === 'grpc') {
+            notes.push(`TODO (Round 3): gRPC stub for ${importEntry.from} — proto wiring deferred. Methods throw at call-time.`);
+        }
+        else if (protocol === 'mcp') {
+            notes.push(`TODO (Round 3): MCP client for ${importEntry.from} — @modelcontextprotocol/sdk wiring deferred. Methods throw at call-time.`);
+        }
+        const reviewNotes = [];
+        if (protocol === 'grpc') {
+            reviewNotes.push(`gRPC stub for ${importEntry.from} — proto wiring deferred; methods throw at call-time.`);
+        }
+        else if (protocol === 'mcp') {
+            reviewNotes.push(`MCP client for ${importEntry.from} — @modelcontextprotocol/sdk wiring deferred; methods throw at call-time.`);
+        }
+        const deploymentSuggestion = {
+            provider: importEntry.from,
+            consumerComponent: ctx.consumerComponent?.name,
+            category: 'services',
+            key: clientName,
+            config: {
+                endpoint: { env: envVar },
+                protocol,
+            },
+            factory: factory.name,
+            topology: 'service',
+            ...(reviewNotes.length > 0 ? { reviewNotes } : {}),
+        };
+        return {
+            files,
+            imports: [consumerImport],
+            notes,
+            deploymentSuggestion,
+        };
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/realize/runtime-emitters/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/realize/runtime-emitters/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAQH,6EAA6E;AAC7E,+EAA+E;AAE/E,SAAS,gBAAgB,CAAC,KAAa;IACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,QAAQ,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC7D,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,SAAS,OAAO,CAAC,QAAgB;IAC/B,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAClE,OAAO,UAAU;SACd,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,IAAI,EAAE;SACN,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,eAAe,CAAC;IAC/C,OAAO,CACL,KAAK,CAAC,CAAC,CAAE;QACT,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,OAAO,OAAO,CAAC,QAAQ,CAAC;SACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB;IAClC,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB,EAAE,MAAM,GAAG,UAAU;IACzD,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC;AAC5D,CAAC;AAMD,SAAS,eAAe,CAAC,GAA0B;IACjD,MAAM,CAAC,GAAI,GAAG,CAAC,OAAO,CAAC,UAAgD,EAAE,QAAQ,CAAC;IAClF,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAC,GAA0B;IACpD,MAAM,MAAM,GAAI,GAAG,CAAC,OAAO,CAAC,UAAuE,EAAE,MAAM,CAAC;IAC5G,OAAO,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,qBAAqB,CAAC,GAA0B;IACvD,OAAQ,GAAG,CAAC,OAAO,CAAC,UAA6D,EAAE,cAAc,CAAC;AACpG,CAAC;AAED,SAAS,oBAAoB,CAAC,GAA0B;IACtD,MAAM,CAAC,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,iFAAiF;AAEjF,SAAS,kBAAkB,CACzB,GAA0B,EAC1B,UAAkB,EAClB,aAAqB;IAErB,MAAM,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;IAC5B,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAEvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IACnE,KAAK,CAAC,IAAI,CAAC,gBAAgB,WAAW,CAAC,IAAI,mBAAmB,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,4BAA4B,MAAM,wBAAwB,CAAC,CAAC;IACvE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,YAAY;IACZ,KAAK,CAAC,IAAI,CAAC,eAAe,aAAa,YAAY,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QACnC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,oEAAoE,CAAC,CAAC;YAC9F,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,yCAAyC,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,YAAY,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,mDAAmD,CAAC,CAAC;YAC3H,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,qCAAqC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,6BAA6B;IAC7B,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,6BAA6B,MAAM,GAAG,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,gCAAgC,MAAM,qCAAqC,WAAW,CAAC,IAAI,YAAY,CAAC,CAAC;IACpH,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,cAAc;IACd,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;IACvF,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IACnE,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IAC3E,KAAK,CAAC,IAAI,CAAC,wFAAwF,CAAC,CAAC;IACrG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,WAAW;IACX,KAAK,CAAC,IAAI,CAAC,gBAAgB,UAAU,WAAW,aAAa,YAAY,CAAC,CAAC;IAC3E,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QACnC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,0CAA0C,CAAC,CAAC;YAChE,KAAK,CAAC,IAAI,CAAC,yBAAyB,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YACnE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,sCAAsC,CAAC,CAAC;YAC5D,KAAK,CAAC,IAAI,CAAC,yBAAyB,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,YAAY,CAAC,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,iFAAiF;AAEjF,SAAS,kBAAkB,CACzB,GAA0B,EAC1B,UAAkB,EAClB,aAAqB;IAErB,MAAM,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;IAC5B,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC;IAE/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IACnE,KAAK,CAAC,IAAI,CAAC,gBAAgB,WAAW,CAAC,IAAI,mBAAmB,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;IAC/E,KAAK,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;IACtF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,eAAe,aAAa,YAAY,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,yCAAyC,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,yCAAyC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,gBAAgB,UAAU,WAAW,aAAa,YAAY,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAC/B,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjB,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,IAAI,IAAI,KAAK,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,2CAA2C,CAAC,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC,sCAAsC,WAAW,CAAC,IAAI,IAAI,UAAU,mCAAmC,CAAC,CAAC;QACpH,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,iFAAiF;AAEjF,SAAS,iBAAiB,CACxB,GAA0B,EAC1B,UAAkB,EAClB,aAAqB;IAErB,MAAM,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;IAC5B,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC;IAE/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IACnE,KAAK,CAAC,IAAI,CAAC,gBAAgB,WAAW,CAAC,IAAI,kBAAkB,CAAC,CAAC;IAC/D,KAAK,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAC;IAC1F,KAAK,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;IACtF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,eAAe,aAAa,YAAY,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,yCAAyC,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,yCAAyC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,gBAAgB,UAAU,WAAW,aAAa,YAAY,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAC/B,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjB,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,IAAI,IAAI,KAAK,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,2CAA2C,CAAC,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC,qCAAqC,WAAW,CAAC,IAAI,IAAI,UAAU,iCAAiC,CAAC,CAAC;QACjH,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,iFAAiF;AAEjF,SAAS,kBAAkB,CACzB,GAA0B,EAC1B,aAAqB;IAErB,MAAM,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;IAC5B,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC;IAE/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,+BAA+B,WAAW,CAAC,IAAI,eAAe,CAAC,CAAC;IAC3E,KAAK,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;IACpF,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IAC7E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;IAC5F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,aAAa,0CAA0C,CAAC,CAAC;IAE/F,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,2DAA2D,CAAC,CAAC;QAC/F,KAAK,CAAC,IAAI,CAAC,+CAA+C,KAAK,sBAAsB,CAAC,CAAC;QACvF,KAAK,CAAC,IAAI,CAAC,uFAAuF,KAAK,KAAK,CAAC,CAAC;QAC9G,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,iFAAiF;AAEjF;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAqB;IACvB,QAAQ,GAAG,SAAkB,CAAC;IAEvC,KAAK,CAAC,IAAI,CAAC,GAA0B;QACnC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;QACrC,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC;QAE/C,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,aAAa,GAAG,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAExD,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAEvC,6CAA6C;QAC7C,IAAI,aAAqB,CAAC;QAC1B,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,aAAa,GAAG,kBAAkB,CAAC,GAAG,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;QACrE,CAAC;aAAM,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC9B,aAAa,GAAG,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,aAAa,GAAG,kBAAkB,CAAC,GAAG,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,KAAK,GAA6C;YACtD,EAAE,IAAI,EAAE,WAAW,QAAQ,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE;SAC3D,CAAC;QAEF,gCAAgC;QAChC,IAAI,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,aAAa,GAAG,kBAAkB,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;YAC7D,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,QAAQ,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,8BAA8B;QAC9B,MAAM,cAAc,GAAG;YACrB,IAAI,EAAE,aAAa,QAAQ,EAAE;YAC7B,SAAS,EAAE,GAAG,UAAU,QAAQ;SACjC,CAAC;QAEF,MAAM,KAAK,GAAa;YACtB,yDAAyD,UAAU,qCAAqC,MAAM,mBAAmB,OAAO,CAAC,IAAI,eAAe,QAAQ,IAAI;SACzK,CAAC;QACF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CACR,+BAA+B,WAAW,CAAC,IAAI,kDAAkD,CAClG,CAAC;QACJ,CAAC;QACD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CACR,iCAAiC,WAAW,CAAC,IAAI,uDAAuD,CACzG,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CACR,kCAAkC,WAAW,CAAC,IAAI,2EAA2E,CAC9H,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,WAAW,CAAC,IAAI,CAAC,iBAAiB,WAAW,CAAC,IAAI,uDAAuD,CAAC,CAAC;QAC7G,CAAC;aAAM,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC9B,WAAW,CAAC,IAAI,CAAC,kBAAkB,WAAW,CAAC,IAAI,2EAA2E,CAAC,CAAC;QAClI,CAAC;QACD,MAAM,oBAAoB,GAAG;YAC3B,QAAQ,EAAE,WAAW,CAAC,IAAI;YAC1B,iBAAiB,EAAG,GAAG,CAAC,iBAAyB,EAAE,IAAI;YACvD,QAAQ,EAAE,UAAmB;YAC7B,GAAG,EAAE,UAAU;YACf,MAAM,EAAE;gBACN,QAAQ,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;gBACzB,QAAQ;aACT;YACD,OAAO,EAAE,OAAO,CAAC,IAAI;YACrB,QAAQ,EAAE,SAAkB;YAC5B,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnD,CAAC;QAEF,OAAO;YACL,KAAK;YACL,OAAO,EAAE,CAAC,cAAc,CAAC;YACzB,KAAK;YACL,oBAAoB;SACrB,CAAC;IACJ,CAAC;CACF"}

package/dist/realize/types/instance-factory.d.ts

@@ -3,5 +3,5 @@
  * The canonical source is @specverse/types.
  * This file exists for backward compatibility.
  */
-export { type Dependency, type CodeTemplate, type TechnologyStack, type CompatibilityRequirements, type Capabilities, type Dependencies, type InstanceFactoryMetadata, type InstanceFactory, type InstanceFactoryReference, type CapabilityMapping, type InstanceMapping, type DefaultMappings, type DeploymentReference, type ResolvedImplementation, type FactoryValidationResult, type FactoryValidationResult as ValidationResult, type TemplateContext, type TemplateEngine, type LibrarySource, type LibraryConfig, } from '@specverse/types';
+export { type Dependency, type CodeTemplate, type TechnologyStack, type CompatibilityRequirements, type Capabilities, type Dependencies, type InstanceFactoryMetadata, type InstanceFactory, type InstanceFactoryReference, type CapabilityMapping, type InstanceMapping, type DefaultMappings, type DeploymentReference, type ResolvedImplementation, type FactoryValidationResult, type FactoryValidationResult as ValidationResult, type TemplateContext, type TemplateEngine, type LibrarySource, type LibraryConfig, type FactoryTopology, type FactoryDeploymentCategory, type FactoryAuthentication, type FactoryV2Metadata, } from '@specverse/types';
 //# sourceMappingURL=instance-factory.d.ts.map

package/dist/realize/types/instance-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instance-factory.d.ts","sourceRoot":"","sources":["../../../src/realize/types/instance-factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,IAAI,gBAAgB,EAChD,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"instance-factory.d.ts","sourceRoot":"","sources":["../../../src/realize/types/instance-factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,IAAI,gBAAgB,EAChD,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAElB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC"}

package/libs/instance-factories/communication/rabbitmq-events.yaml

@@ -40,6 +40,17 @@ dependencies:
     - name: "typescript"
       version: "^5.2.0"
 
+# V2 factory metadata — Component Dependencies V2 proposal Section 4
+v2metadata:
+  topology: messaging                     # AMQP broker pub/sub; deploys as communications: instance
+  protocol: amqp                          # AMQP 0-9-1 (RabbitMQ)
+  authentication: { kind: bearer, mechanism: PLAIN }   # RabbitMQ credential pair (user/password)
+  supportedTopologies: [messaging]
+  serverTemplate: templates/rabbitmq/connection-generator.ts   # broker connection setup
+  clientTemplate: templates/rabbitmq/publisher-generator.ts    # publisher client for producers
+  emitsDeploymentInstance: true           # generates a communications: instance entry
+  deploymentCategory: communications      # lands in communications: category
+
 codeTemplates:
   publisher:
     engine: typescript

package/libs/instance-factories/controllers/fastify.yaml

@@ -52,6 +52,17 @@ dependencies:
     - name: "tsx"
       version: "^4.0.0"
 
+# V2 factory metadata — Component Dependencies V2 proposal Section 4
+v2metadata:
+  topology: service                       # generates a Fastify HTTP server; deploys as services: instance
+  protocol: rest                          # HTTP/REST transport
+  authentication: { kind: bearer }        # typical JWT bearer auth; overridable per deployment
+  supportedTopologies: [service]
+  serverTemplate: templates/fastify/server-generator.ts   # server bind code (main.ts / server.ts)
+  clientTemplate: null                    # clients generated from TypeScript SDK factory (separate concern)
+  emitsDeploymentInstance: true           # generates a services: instance entry in deployment
+  deploymentCategory: services            # lands in services: category
+
 codeTemplates:
   routes:
     engine: typescript

package/libs/instance-factories/managed/stripe-rest-sdk.yaml

@@ -0,0 +1,78 @@
+name: StripeRestSDK
+version: "1.0.0"
+category: infrastructure
+description: "Stripe payments SDK adapter — wraps the Stripe Node.js SDK with a typed SpecVerse client for managed payment processing"
+
+metadata:
+  author: "SpecVerse Team"
+  license: "MIT"
+  tags: [stripe, payments, managed, rest, sdk, infrastructure]
+
+compatibility:
+  specverse: ">=6.33.0"
+  node: ">=18.0.0"
+
+capabilities:
+  provides:
+    - "managed.payments"
+    - "managed.payments.stripe"
+  requires: []                            # external SaaS — no transitive SpecVerse deps
+
+technology:
+  runtime: "node"
+  language: "typescript"
+  framework: "stripe-sdk"
+  version: "^14.0.0"
+
+# V2 factory metadata — Component Dependencies V2 proposal Section 4
+# Forward-looking stub: Round 2 realize emitters will consume these fields.
+v2metadata:
+  topology: managed                       # external SaaS via SDK; deploys as infrastructure: instance
+  protocol: rest                          # Stripe API uses HTTPS/REST under the hood
+  sdk: "stripe"                           # npm package name: https://www.npmjs.com/package/stripe
+  authentication: { kind: api-key, envVar: STRIPE_SECRET_KEY }   # Stripe uses API keys
+  supportedTopologies: [managed]
+  clientTemplate: templates/stripe/stripe-client-generator.ts    # typed wrapper exposing Charge.create etc.
+  serverTemplate: null                    # external SaaS — no server bind code emitted
+  emitsDeploymentInstance: true           # generates an infrastructure: instance entry in deployment
+  deploymentCategory: infrastructure      # lands in infrastructure: category (external SaaS)
+
+dependencies:
+  runtime:
+    - name: "stripe"
+      version: "^14.0.0"
+
+  dev:
+    - name: "@types/node"
+      version: "^20.8.0"
+    - name: "typescript"
+      version: "^5.2.0"
+
+# Minimal stub: codeTemplates to be fleshed out in Round 2 (per-runtime emitters)
+codeTemplates:
+  client:
+    engine: typescript
+    generator: "libs/instance-factories/managed/templates/stripe/stripe-client-generator.ts"
+    outputPattern: "{backendDir}/src/clients/StripeClient.ts"
+
+configuration:
+  envVar: "STRIPE_SECRET_KEY"
+  apiVersion: "2024-06-20"
+  webhookSecret: null                     # optional: STRIPE_WEBHOOK_SECRET for signature verification
+
+requirements:
+  dependencies:
+    npm:
+      dependencies:
+        "stripe": "^14.0.0"
+  environment:
+    - name: "STRIPE_SECRET_KEY"
+      description: "Stripe secret API key"
+      example: "sk_live_..."
+      required: true
+      category: "Payments"
+    - name: "STRIPE_WEBHOOK_SECRET"
+      description: "Stripe webhook signing secret (required only if handling webhooks)"
+      example: "whsec_..."
+      required: false
+      category: "Payments"

package/libs/instance-factories/managed/templates/stripe/stripe-client-generator.ts

@@ -0,0 +1,26 @@
+/**
+ * Stripe REST SDK — Client Generator (Round 2 stub)
+ *
+ * FACTORY-EMITTED — DO NOT EDIT (R8)
+ *
+ * This template generator is a forward-looking stub for the V2 Round 2
+ * per-runtime emitter work. It will be fleshed out when the managed-runtime
+ * realize emitter is implemented (Phase 3 of the Component Dependencies V2 proposal).
+ *
+ * When complete, this generator will emit a typed StripeClient wrapper that:
+ *   - Initialises the Stripe SDK with the API key from env (STRIPE_SECRET_KEY)
+ *   - Exposes only the operations selected in the consumer's `import[].select:`
+ *   - Uses the `(deps, input) → result` pure-function shape for testability
+ *   - Matches the `clientTemplate` path declared in stripe-rest-sdk.yaml v2metadata
+ */
+
+import type { TemplateContext } from '@specverse/types';
+
+export async function generate(_context: TemplateContext): Promise<string> {
+  // Round 2 stub — throws so realize reports an actionable error rather than silently emitting empty code
+  throw new Error(
+    'StripeRestSDK client generator is a V2 Round 2 stub. ' +
+    'The managed-runtime realize emitter is not yet implemented. ' +
+    'See Component Dependencies V2 proposal Phase 3.'
+  );
+}

package/libs/instance-factories/orms/prisma.yaml

@@ -40,6 +40,17 @@ dependencies:
     - name: "typescript"
       version: "^5.2.0"
 
+# V2 factory metadata — Component Dependencies V2 proposal Section 4
+v2metadata:
+  topology: library                       # in-process ORM client; no deployment instance emitted
+                                          # protocol: omitted — not applicable for library topology
+  authentication: { kind: none }          # auth is the DB connection string, not a protocol-level scheme
+  supportedTopologies: [library]
+  clientTemplate: null                    # client is the generated Prisma client itself
+  serverTemplate: null                    # no server component
+  emitsDeploymentInstance: false          # library-shaped; consumer manages DB config via storage: instance
+  deploymentCategory: storage             # informational: if a storage: instance existed, it would land here
+
 codeTemplates:
   schema:
     engine: typescript

package/libs/instance-factories/services/templates/_shared/step-matching.ts

@@ -30,35 +30,17 @@ export function toVar(name: string): string {
   return name.charAt(0).toLowerCase() + name.slice(1);
 }
 
-export interface SharedStepContext {
-  modelName: string;
-  serviceName: string;
-  operationName: string;
-  stepNum: number;
-  parameterNames?: string[];
-  declaredVars?: Set<string>;
-  resultName?: string;
-}
-
-export interface SharedConvention<C extends SharedStepContext = SharedStepContext> {
-  name: string;
-  pattern: RegExp;
-  /** Emit inline code for this step. Return empty string to signal
-   * "regex matched but I can't safely emit" (caller falls through to AI). */
-  generateCall: (match: RegExpMatchArray, ctx: C) => string;
-  /** Optional helper-method body that some libraries (e.g. prisma's
-   * `check {condition}` convention) emit alongside the call site. */
-  generateMethod?: (match: RegExpMatchArray, ctx: C) => string;
-}
-
-export interface MatchResult {
-  matched: boolean;
-  call: string;
-  helperMethod?: string;
-  functionName?: string;
-  inputs?: string[];
-  resultVar?: string;
-}
+// #54 (2026-05-10): SharedStepContext, SharedConvention, MatchResult
+// and MatcherFn are now canonical in @specverse/types. Re-exported here
+// so existing dynamic-import call sites that grab types from this path
+// keep working. New code should import directly from @specverse/types.
+export type {
+  SharedStepContext,
+  SharedConvention,
+  MatchResult,
+  MatcherFn,
+} from '@specverse/types';
+import type { SharedStepContext, SharedConvention, MatchResult } from '@specverse/types';
 
 // ── Audit-trail recorder hook ──────────────────────────────────────────
 // Forward-logging discipline (engines 6.22.0+): the matcher records every