@specverse/engines 6.33.1 → 6.35.0

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

@@ -0,0 +1,349 @@
+/**
+ * Library-runtime emitter — V2 Phase 3, Round 1.
+ *
+ * Handles `topology: 'library'` factories: providers that are consumed
+ * as in-process imports, with no deployment instance entry.
+ *
+ * For each `import:` entry the consumer declares, this emitter produces:
+ *   clients/<provider-name>.ts   — typed client module
+ *
+ * The typed client module:
+ *   - Exports a `<ProviderName>Client` TypeScript interface matching
+ *     the selected operations from `import.select`.
+ *   - Exports a `<providerName>Client` constant that implements the
+ *     interface by delegating to the resolved provider:
+ *       * source = 'local'  → relative import to the provider's module.
+ *       * source = 'npm'    → `import { X } from '<package-specifier>'`.
+ *       * source = 'registry-*' → TODO comment + runtime throw (Round 1).
+ *
+ * The consuming controller (SalesReportController.ts, emitted by the
+ * per-action-emitter's mechanical scaffold) imports this client module
+ * and receives the client via constructor injection.
+ *
+ * --- Select grammar ---
+ *
+ * `import.select` entries follow two forms (V2 D2 resolution):
+ *   - Dotted: `Charge.create`  → typed function for the specific operation.
+ *   - Bare:   `AuthService`    → re-export of the entity's interface.
+ *
+ * Both forms share the same file; the emitter deduplicates by head entity.
+ *
+ * --- Round 1 limitations ---
+ *
+ * - No actual operation signature lookup (operations are typed as
+ *   `(...args: unknown[]) => Promise<unknown>` unless the spec is provided
+ *   and the target operation can be located). Exact signatures land in
+ *   Round 2 when the resolver wires in full cross-spec type lookup.
+ * - Registry sources (`registry-component`, `registry-factory`) emit a
+ *   TODO comment and a `throw` for the client constant; they compile but
+ *   blow up at runtime until Round 2 fills in the registry resolver.
+ */
+/**
+ * Parse a select entry into head + optional tail.
+ *
+ * Dotted: `Charge.create`  → { head: 'Charge', tail: 'create' }
+ * Bare:   `AuthService`    → { head: 'AuthService', tail: undefined }
+ *
+ * The head is the entity/service name; the tail is the operation name.
+ * Dotted entries can have multiple tail segments (`A.B.C` → head A, tail 'B.C')
+ * but in practice V2 only uses one level (entity.operation).
+ */
+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),
+    };
+}
+/**
+ * Normalise a `from:` name into an array of words for identifier generation.
+ *
+ * Handles:
+ *   'ProfitCalculator'         → ['profit', 'calculator']
+ *   '@stripe/api'              → ['stripe', 'api']   (scope + package combined)
+ *   '@specverse/gitnexus-adapter' → ['specverse', 'gitnexus', 'adapter']
+ *   'gitnexus'                 → ['gitnexus']
+ */
+function toWords(fromName) {
+    // For scoped packages (@scope/pkg), replace the / with a space and strip @.
+    const normalised = fromName.replace(/^@/, '').replace(/\//g, '-');
+    // Split on camelCase boundaries and non-alphanumeric runs.
+    return normalised
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .replace(/[^a-zA-Z0-9]+/g, ' ')
+        .trim()
+        .split(' ')
+        .filter(Boolean)
+        .map((w) => w.toLowerCase());
+}
+/**
+ * Convert a from-name to a safe identifier prefix (lower-camelCase, no
+ * special characters). Used for the client constant name.
+ *
+ * Examples:
+ *   'ProfitCalculator'   → 'profitCalculator'
+ *   '@stripe/api'        → 'stripeApi'
+ *   'gitnexus'           → 'gitnexus'
+ */
+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(''));
+}
+/**
+ * Convert a from-name to a PascalCase interface name suffix.
+ *
+ * Examples:
+ *   'ProfitCalculator'   → 'ProfitCalculator'
+ *   '@stripe/api'        → 'StripeApi'
+ *   'gitnexus'           → 'Gitnexus'
+ */
+function toInterfaceName(fromName) {
+    const words = toWords(fromName);
+    return words.map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join('');
+}
+/**
+ * Convert a from-name to a filesystem-safe filename (kebab-case).
+ *
+ * Examples:
+ *   'ProfitCalculator'           → 'profit-calculator'
+ *   '@stripe/api'                → 'stripe-api'
+ *   '@specverse/gitnexus-adapter'→ 'specverse-gitnexus-adapter'
+ *   'gitnexus'                   → 'gitnexus'
+ */
+function toFileName(fromName) {
+    return toWords(fromName).join('-');
+}
+/**
+ * Generate the TypeScript interface for the client type.
+ * Uses a placeholder signature `(...args: unknown[]) => Promise<unknown>`
+ * in Round 1; Round 2 will wire in real operation signatures.
+ */
+function generateInterface(interfaceName, selectEntries) {
+    const lines = [];
+    lines.push(`export type ${interfaceName}Client = {`);
+    // Collect unique operations grouped by head entity for clarity.
+    // Bare entries produce a `<entity>: unknown` member (shape TBD by Round 2).
+    // Dotted entries produce a typed function.
+    const seen = new Set();
+    for (const entry of selectEntries) {
+        if (seen.has(entry))
+            continue;
+        seen.add(entry);
+        const { head, tail } = parseSelectEntry(entry);
+        if (tail === undefined) {
+            // Bare entity import — expose as an opaque type in Round 1.
+            // Round 2 will look up the entity interface and substitute the real type.
+            lines.push(`  /** Re-export of ${head} entity interface. Round 2: substitute real type. */`);
+            lines.push(`  ${head}: unknown;`);
+        }
+        else {
+            // Dotted operation import — typed function.
+            // Round 2 will substitute real input/output types from the spec.
+            lines.push(`  /** ${head}.${tail} — Round 2: substitute real input/output types. */`);
+            lines.push(`  ${tail}(...args: unknown[]): Promise<unknown>;`);
+        }
+    }
+    lines.push('};');
+    return lines.join('\n');
+}
+/**
+ * Generate the import statement block for the client implementation.
+ * Returns the import lines and the identifiers made available.
+ */
+function generateImportBlock(ctx, selectEntries) {
+    const { resolved } = ctx;
+    const importLines = [];
+    // Maps select entry → the identifier available in the module scope.
+    const availableIds = new Map();
+    if (resolved.source === 'local') {
+        // Relative import to the provider's module in the same spec's output tree.
+        const relativePath = resolved.localRelativePath ?? `../${toFileName(resolved.resolvedName)}`;
+        // Group dotted entries by head (entity) — one import per head.
+        const heads = new Set();
+        const bareEntries = [];
+        for (const entry of selectEntries) {
+            const { head, tail } = parseSelectEntry(entry);
+            if (tail !== undefined) {
+                heads.add(head);
+            }
+            else {
+                bareEntries.push(head);
+            }
+        }
+        const allImports = [...Array.from(heads), ...bareEntries];
+        if (allImports.length > 0) {
+            importLines.push(`import { ${allImports.join(', ')} } from '${relativePath}';`);
+            for (const id of allImports) {
+                availableIds.set(id, id);
+            }
+        }
+        // Map dotted entries: Charge.create → availableIds.get('Charge.create') = 'Charge'
+        for (const entry of selectEntries) {
+            const { head, tail } = parseSelectEntry(entry);
+            if (tail !== undefined) {
+                availableIds.set(entry, head);
+            }
+        }
+    }
+    else if (resolved.source === 'npm') {
+        // npm package import — use package specifier directly.
+        const pkg = resolved.packageSpecifier ?? resolved.resolvedName;
+        const heads = new Set();
+        const bareEntries = [];
+        for (const entry of selectEntries) {
+            const { head, tail } = parseSelectEntry(entry);
+            if (tail !== undefined) {
+                heads.add(head);
+            }
+            else {
+                bareEntries.push(head);
+            }
+        }
+        const allImports = [...Array.from(heads), ...bareEntries];
+        if (allImports.length > 0) {
+            importLines.push(`import { ${allImports.join(', ')} } from '${pkg}';`);
+            for (const id of allImports) {
+                availableIds.set(id, id);
+            }
+        }
+        for (const entry of selectEntries) {
+            const { head, tail } = parseSelectEntry(entry);
+            if (tail !== undefined) {
+                availableIds.set(entry, head);
+            }
+        }
+    }
+    else {
+        // registry-component or registry-factory — Round 1 TODO.
+        // No real import; the constant body will throw.
+    }
+    return { importLines, availableIds };
+}
+/**
+ * Generate the client constant — the exported object that implements the
+ * typed interface by delegating to the resolved provider.
+ */
+function generateClientConstant(clientName, interfaceName, selectEntries, resolved, availableIds) {
+    const lines = [];
+    lines.push(`export const ${clientName}Client: ${interfaceName}Client = {`);
+    if (resolved.source === 'registry-component' || resolved.source === 'registry-factory') {
+        // Round 1 placeholder — registry resolution not yet implemented.
+        lines.push('  // TODO (Round 2): wire in registry resolver for this provider.');
+        lines.push(`  // provider: '${resolved.resolvedName}' (source: ${resolved.source})`);
+        // Emit a throw for each member so the type is satisfied but blows up
+        // clearly at runtime rather than silently returning undefined.
+        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(`  get ${entry}(): never { throw new Error('${entry} (${resolved.resolvedName}): registry provider not yet wired — Round 2 TODO'); },`);
+            }
+            else {
+                lines.push(`  ${tail}(..._args: unknown[]): never { throw new Error('${tail} (${resolved.resolvedName}): registry provider not yet wired — Round 2 TODO'); },`);
+            }
+        }
+    }
+    else {
+        // local or npm — delegate to the imported identifiers.
+        const seen = new Set();
+        for (const entry of selectEntries) {
+            if (seen.has(entry))
+                continue;
+            seen.add(entry);
+            const { head, tail } = parseSelectEntry(entry);
+            const srcId = availableIds.get(entry) ?? availableIds.get(head) ?? head;
+            if (tail === undefined) {
+                // Bare entity — expose directly.
+                lines.push(`  ${head}: ${srcId},`);
+            }
+            else {
+                // Dotted operation — delegate as method.
+                lines.push(`  ${tail}: ${srcId}.${tail},`);
+            }
+        }
+    }
+    lines.push('};');
+    return lines.join('\n');
+}
+// ─── Library emitter ─────────────────────────────────────────────────────────
+/**
+ * Library-runtime emitter implementation.
+ *
+ * One call to `emit()` processes a single `import:` entry and produces
+ * one client file under `clients/<provider-filename>.ts`.
+ */
+export class LibraryRuntimeEmitter {
+    topology = 'library';
+    async emit(ctx) {
+        const { importEntry, resolved, factory, outputDir } = ctx;
+        const selectEntries = importEntry.select ?? [];
+        // Derive naming from the import's `from:` field, not the factory name.
+        const fileName = toFileName(importEntry.from);
+        const clientName = toClientName(importEntry.from);
+        const interfaceName = toInterfaceName(importEntry.from);
+        // File path relative to outputDir.
+        const relFilePath = `clients/${fileName}.ts`;
+        const absoluteFilePath = `${outputDir}/${relFilePath}`;
+        // Build file header.
+        const headerLines = [
+            '// FACTORY-EMITTED — DO NOT EDIT (R8)',
+            `// Generated by library-runtime emitter — V2 Phase 3`,
+            `// Provider: ${importEntry.from} (${resolved.source}) via factory: ${factory.name}`,
+        ];
+        if (resolved.source === 'local') {
+            headerLines.push(`// Local component: ${resolved.resolvedName}`);
+        }
+        else if (resolved.source === 'npm') {
+            const pkg = resolved.packageSpecifier ?? resolved.resolvedName;
+            headerLines.push(`// npm package: ${pkg}`);
+        }
+        else {
+            headerLines.push(`// Registry source: ${resolved.resolvedName} (Round 2 TODO)`);
+        }
+        headerLines.push('');
+        // Build import block.
+        const { importLines, availableIds } = generateImportBlock(ctx, selectEntries);
+        // Build interface + constant.
+        const interfaceBlock = generateInterface(interfaceName, selectEntries);
+        const constantBlock = generateClientConstant(clientName, interfaceName, selectEntries, resolved, availableIds);
+        // Assemble file.
+        const parts = [...headerLines];
+        if (importLines.length > 0) {
+            parts.push(...importLines, '');
+        }
+        parts.push(interfaceBlock, '', constantBlock, '');
+        const content = parts.join('\n');
+        // Build the import entry for the consumer's controller file.
+        const consumerImport = {
+            from: `./clients/${fileName}`,
+            specifier: `${clientName}Client`,
+        };
+        // Warnings for Round 1 limitations.
+        const notes = [];
+        if (selectEntries.length === 0) {
+            notes.push(`Warning: import entry from '${importEntry.from}' has empty select: — no client members emitted.`);
+        }
+        if (resolved.source === 'registry-component' ||
+            resolved.source === 'registry-factory') {
+            notes.push(`TODO (Round 2): registry provider '${resolved.resolvedName}' — client constant emits runtime throws until registry resolver is wired.`);
+        }
+        return {
+            files: [{ path: relFilePath, content }],
+            imports: [consumerImport],
+            notes: notes.length > 0 ? notes : undefined,
+        };
+    }
+}
+//# sourceMappingURL=library.js.map

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

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

package/dist/realize/runtime-emitters/managed.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Managed-runtime emitter — V2 Phase 3, Round 2.
+ *
+ * Handles `topology: 'managed'` factories: external SaaS providers reached
+ * via vendor-specific SDKs (Stripe, OpenAI, Anthropic, Twilio, AWS, etc.).
+ *
+ * For each `import:` entry the consumer declares, this emitter produces:
+ *   clients/<provider-name>.ts   — SDK init + typed client
+ *
+ * No server-bind file — managed providers ship their own server.
+ *
+ * Auth dispatch (factory.v2metadata?.authentication?.kind):
+ *   'api-key'  → `new SDK(process.env.<ENV>!)` constructor pattern (Stripe-shape)
+ *   'bearer'   → header-based init reading token from env
+ *   'oauth2'   → TODO scaffolding; init throws at call-time (Round 3)
+ *   'mtls'     → env-driven cert paths
+ *   'none'     → bare SDK init, no auth wiring
+ *
+ * Env var name: factory.v2metadata?.authentication?.env if present, else
+ * derived from provider (STRIPE_API_KEY, OPENAI_API_KEY, etc.). Suffix
+ * varies by auth.kind (_API_KEY / _TOKEN / _BEARER / _CERT).
+ *
+ * Operation routing: dotted ops like `Charge.create` route to
+ * `sdk.charges.create(...)` — entity head is lowercased + naively
+ * pluralised; tail becomes the SDK method. Exact mapping varies per
+ * SDK; Round 3 enhancement allows spec authors to override.
+ *
+ * Deployment hint: realize emits a `deployments.<env>.instances.infrastructure.<provider>`
+ * entry with `config: { provider: <hostname>, authEnv: <ENV_NAME> }` —
+ * mentioned in result.notes.
+ */
+import type { RuntimeEmitter, RuntimeEmitterContext, RuntimeEmitterResult } from './dispatcher.js';
+/**
+ * Managed-runtime emitter implementation.
+ *
+ * One call to `emit()` processes a single `import:` entry. Produces:
+ *   - 1 client file under `clients/<provider-filename>.ts`
+ *   - NO server-bind file (managed providers ship their own server).
+ */
+export declare class ManagedRuntimeEmitter implements RuntimeEmitter {
+    readonly topology: "managed";
+    emit(ctx: RuntimeEmitterContext): Promise<RuntimeEmitterResult>;
+}
+//# sourceMappingURL=managed.d.ts.map

package/dist/realize/runtime-emitters/managed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed.d.ts","sourceRoot":"","sources":["../../../src/realize/runtime-emitters/managed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAgNzB;;;;;;GAMG;AACH,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,QAAQ,CAAC,QAAQ,EAAG,SAAS,CAAU;IAEjC,IAAI,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA+EtE"}