@cwygoda/service-catalog-core 0.17.1

package/dist/schemas/use-case.schema.js

@@ -0,0 +1,38 @@
+import { Type } from '@sinclair/typebox';
+export const ParticipantSchema = Type.Object({
+    service: Type.String({ minLength: 1 }),
+    role: Type.String({ minLength: 1 }),
+});
+export const StepSchema = Type.Object({
+    sequence: Type.Number({ minimum: 1 }),
+    actor: Type.Optional(Type.String({ minLength: 1 })),
+    service: Type.Optional(Type.String({ minLength: 1 })),
+    action: Type.String({ minLength: 1 }),
+    endpoint: Type.Optional(Type.String()),
+});
+export const UseCaseSidecarSchema = Type.Object({
+    use_case: Type.Object({
+        id: Type.String({ minLength: 1 }),
+        name: Type.String({ minLength: 1 }),
+        description: Type.String(),
+        domain: Type.Optional(Type.String({ minLength: 1 })),
+        bpmn: Type.Optional(Type.String()),
+        participants: Type.Array(ParticipantSchema),
+        steps: Type.Array(StepSchema),
+    }),
+});
+export const DocLinkSchema = Type.Object({
+    elementId: Type.String({ minLength: 1 }),
+    anchor: Type.String({ minLength: 1 }),
+});
+export const ServiceRefSchema = Type.Object({
+    elementId: Type.String({ minLength: 1 }),
+    serviceId: Type.String({ minLength: 1 }),
+});
+export const UseCaseMarkdownFrontmatterSchema = Type.Object({
+    id: Type.String({ minLength: 1 }),
+    name: Type.String({ minLength: 1 }),
+    domain: Type.Optional(Type.String({ minLength: 1 })),
+    participants: Type.Optional(Type.Array(ParticipantSchema)),
+});
+//# sourceMappingURL=use-case.schema.js.map

package/dist/schemas/use-case.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-case.schema.js","sourceRoot":"","sources":["../../src/schemas/use-case.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAEtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACtC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;IACpC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACrC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IACnD,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IACrD,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;CACvC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC9C,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;QACpB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QACjC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QACnC,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE;QAC1B,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;QACpD,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAClC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC;QAC3C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;KAC9B,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACxC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;CACtC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1C,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACxC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;CACzC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1D,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACjC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACnC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IACpD,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;CAC3D,CAAC,CAAC"}

package/dist/schemas/use-case.schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use-case.schema.test.d.ts.map

package/dist/schemas/use-case.schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-case.schema.test.d.ts","sourceRoot":"","sources":["../../src/schemas/use-case.schema.test.ts"],"names":[],"mappings":""}

package/dist/schemas/use-case.schema.test.js

@@ -0,0 +1,152 @@
+import { describe, expect, it } from 'vitest';
+import { Value } from '@sinclair/typebox/value';
+import { UseCaseSidecarSchema, ParticipantSchema, StepSchema, } from './use-case.schema.js';
+describe('ParticipantSchema', () => {
+    it('validates valid participant', () => {
+        const participant = { service: 'order-service', role: 'Creates orders' };
+        expect(Value.Check(ParticipantSchema, participant)).toBe(true);
+    });
+    it('rejects empty service', () => {
+        const participant = { service: '', role: 'Creates orders' };
+        expect(Value.Check(ParticipantSchema, participant)).toBe(false);
+    });
+    it('rejects empty role', () => {
+        const participant = { service: 'order-service', role: '' };
+        expect(Value.Check(ParticipantSchema, participant)).toBe(false);
+    });
+    it('rejects missing fields', () => {
+        expect(Value.Check(ParticipantSchema, { service: 'svc' })).toBe(false);
+        expect(Value.Check(ParticipantSchema, { role: 'role' })).toBe(false);
+        expect(Value.Check(ParticipantSchema, {})).toBe(false);
+    });
+});
+describe('StepSchema', () => {
+    it('validates minimal step with actor', () => {
+        const step = { sequence: 1, actor: 'Customer', action: 'Submit order' };
+        expect(Value.Check(StepSchema, step)).toBe(true);
+    });
+    it('validates step with service and endpoint', () => {
+        const step = {
+            sequence: 2,
+            service: 'order-service',
+            action: 'Validate order',
+            endpoint: 'POST /orders',
+        };
+        expect(Value.Check(StepSchema, step)).toBe(true);
+    });
+    it('validates step with all fields', () => {
+        const step = {
+            sequence: 1,
+            actor: 'Customer',
+            service: 'frontend',
+            action: 'Click submit',
+            endpoint: 'POST /submit',
+        };
+        expect(Value.Check(StepSchema, step)).toBe(true);
+    });
+    it('rejects sequence less than 1', () => {
+        const step = { sequence: 0, action: 'Submit' };
+        expect(Value.Check(StepSchema, step)).toBe(false);
+    });
+    it('rejects negative sequence', () => {
+        const step = { sequence: -1, action: 'Submit' };
+        expect(Value.Check(StepSchema, step)).toBe(false);
+    });
+    it('rejects missing sequence', () => {
+        const step = { action: 'Submit' };
+        expect(Value.Check(StepSchema, step)).toBe(false);
+    });
+    it('rejects missing action', () => {
+        const step = { sequence: 1 };
+        expect(Value.Check(StepSchema, step)).toBe(false);
+    });
+    it('rejects empty action', () => {
+        const step = { sequence: 1, action: '' };
+        expect(Value.Check(StepSchema, step)).toBe(false);
+    });
+});
+describe('UseCaseSidecarSchema', () => {
+    const validSidecar = {
+        use_case: {
+            id: 'checkout-flow',
+            name: 'Customer Checkout',
+            description: 'Handles customer checkout process',
+            participants: [
+                { service: 'order-service', role: 'Creates orders' },
+                { service: 'billing-service', role: 'Processes payment' },
+            ],
+            steps: [
+                { sequence: 1, actor: 'Customer', action: 'Submit order' },
+                { sequence: 2, service: 'order-service', action: 'Validate', endpoint: 'POST /orders' },
+            ],
+        },
+    };
+    it('validates complete use case sidecar', () => {
+        expect(Value.Check(UseCaseSidecarSchema, validSidecar)).toBe(true);
+    });
+    it('validates use case with bpmn path', () => {
+        const withBpmn = {
+            use_case: {
+                ...validSidecar.use_case,
+                bpmn: './checkout.bpmn.txt',
+            },
+        };
+        expect(Value.Check(UseCaseSidecarSchema, withBpmn)).toBe(true);
+    });
+    it('validates minimal use case with empty arrays', () => {
+        const minimal = {
+            use_case: {
+                id: 'simple',
+                name: 'Simple Flow',
+                description: 'A simple flow',
+                participants: [],
+                steps: [],
+            },
+        };
+        expect(Value.Check(UseCaseSidecarSchema, minimal)).toBe(true);
+    });
+    it('rejects empty id', () => {
+        const invalid = {
+            use_case: { ...validSidecar.use_case, id: '' },
+        };
+        expect(Value.Check(UseCaseSidecarSchema, invalid)).toBe(false);
+    });
+    it('rejects empty name', () => {
+        const invalid = {
+            use_case: { ...validSidecar.use_case, name: '' },
+        };
+        expect(Value.Check(UseCaseSidecarSchema, invalid)).toBe(false);
+    });
+    it('rejects missing participants array', () => {
+        const { participants: _, ...rest } = validSidecar.use_case;
+        const invalid = { use_case: { ...rest, steps: [] } };
+        expect(Value.Check(UseCaseSidecarSchema, invalid)).toBe(false);
+    });
+    it('rejects missing steps array', () => {
+        const { steps: _, ...rest } = validSidecar.use_case;
+        const invalid = { use_case: { ...rest, participants: [] } };
+        expect(Value.Check(UseCaseSidecarSchema, invalid)).toBe(false);
+    });
+    it('rejects invalid participant in array', () => {
+        const invalid = {
+            use_case: {
+                ...validSidecar.use_case,
+                participants: [{ service: '', role: 'role' }],
+            },
+        };
+        expect(Value.Check(UseCaseSidecarSchema, invalid)).toBe(false);
+    });
+    it('rejects invalid step in array', () => {
+        const invalid = {
+            use_case: {
+                ...validSidecar.use_case,
+                steps: [{ sequence: 0, action: 'Invalid' }],
+            },
+        };
+        expect(Value.Check(UseCaseSidecarSchema, invalid)).toBe(false);
+    });
+    it('rejects missing use_case wrapper', () => {
+        expect(Value.Check(UseCaseSidecarSchema, validSidecar.use_case)).toBe(false);
+    });
+});
+//# sourceMappingURL=use-case.schema.test.js.map

package/dist/schemas/use-case.schema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-case.schema.test.js","sourceRoot":"","sources":["../../src/schemas/use-case.schema.test.ts"],"names":[],"mappings":"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"}

package/dist/services/graph-builder.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Graph builder service - builds service connection graph from catalog data.
+ *
+ * Combines:
+ * 1. Explicit connections declared in service sidecars
+ * 2. Implicit connections derived from use case steps
+ */
+import type { Catalog } from '../domain/catalog.js';
+import type { Connection } from '../domain/connection.js';
+import type { GraphNode, GraphEdge, ServiceGraph } from '../domain/graph.js';
+export type { GraphNode, GraphEdge, ServiceGraph };
+/**
+ * Derives connections from use case steps.
+ * When step N has service A and step N+1 has service B, that implies A -> B connection.
+ */
+export declare function deriveConnectionsFromUseCases(catalog: Catalog): Map<string, Connection[]>;
+/**
+ * Builds a service graph from catalog data.
+ */
+export declare function buildServiceGraph(catalog: Catalog): ServiceGraph;
+//# sourceMappingURL=graph-builder.d.ts.map

package/dist/services/graph-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-builder.d.ts","sourceRoot":"","sources":["../../src/services/graph-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,yBAAyB,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE7E,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAuDzF;AAuCD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CA4ChE"}

package/dist/services/graph-builder.js

@@ -0,0 +1,138 @@
+/**
+ * Graph builder service - builds service connection graph from catalog data.
+ *
+ * Combines:
+ * 1. Explicit connections declared in service sidecars
+ * 2. Implicit connections derived from use case steps
+ */
+/**
+ * Derives connections from use case steps.
+ * When step N has service A and step N+1 has service B, that implies A -> B connection.
+ */
+export function deriveConnectionsFromUseCases(catalog) {
+    const connectionMap = new Map();
+    for (const useCase of catalog.useCases) {
+        const steps = useCase.steps;
+        for (let i = 0; i < steps.length - 1; i++) {
+            const current = steps[i];
+            const next = steps[i + 1];
+            // Both steps must exist and have services and they must be different
+            if (!current || !next)
+                continue;
+            if (!current.service || !next.service)
+                continue;
+            if (current.service === next.service)
+                continue;
+            const sourceId = current.service;
+            const targetId = next.service;
+            const nextEndpoint = next.endpoint;
+            // Determine connection type from the next step
+            const type = nextEndpoint ? 'http' : 'event';
+            // Get or create connection list for this source
+            let connections = connectionMap.get(sourceId);
+            if (!connections) {
+                connections = [];
+                connectionMap.set(sourceId, connections);
+            }
+            // Check if this connection already exists
+            const existing = connections.find((c) => c.target === targetId && c.type === type);
+            if (existing) {
+                // Merge endpoint/event info
+                if (type === 'http' && nextEndpoint) {
+                    existing.endpoints = existing.endpoints ?? [];
+                    if (!existing.endpoints.includes(nextEndpoint)) {
+                        existing.endpoints.push(nextEndpoint);
+                    }
+                }
+            }
+            else {
+                // Create new connection
+                const conn = {
+                    target: targetId,
+                    type,
+                };
+                if (type === 'http' && nextEndpoint) {
+                    conn.endpoints = [nextEndpoint];
+                }
+                connections.push(conn);
+            }
+        }
+    }
+    return connectionMap;
+}
+/**
+ * Merges explicit connections with derived connections.
+ * Explicit connections take precedence.
+ */
+function mergeConnections(explicit, derived) {
+    const merged = new Map();
+    // Add explicit connections first (they take precedence)
+    for (const conn of explicit ?? []) {
+        const key = `${conn.target}:${conn.type}`;
+        merged.set(key, { ...conn });
+    }
+    // Add derived connections if not already present
+    for (const conn of derived ?? []) {
+        const key = `${conn.target}:${conn.type}`;
+        if (!merged.has(key)) {
+            merged.set(key, { ...conn });
+        }
+        else {
+            // Merge endpoints/events from derived into explicit
+            const existing = merged.get(key);
+            if (!existing)
+                continue; // Should never happen since we checked has()
+            if (conn.endpoints) {
+                existing.endpoints = [...new Set([...(existing.endpoints ?? []), ...conn.endpoints])];
+            }
+            if (conn.events) {
+                existing.events = [...new Set([...(existing.events ?? []), ...conn.events])];
+            }
+        }
+    }
+    return Array.from(merged.values());
+}
+/**
+ * Builds a service graph from catalog data.
+ */
+export function buildServiceGraph(catalog) {
+    // Create nodes from services
+    const nodes = catalog.services.map((s) => ({
+        id: s.id,
+        name: s.name,
+        ...(s.domain && { domain: s.domain }),
+        type: s.type,
+        lifecycle: s.lifecycle,
+    }));
+    // Derive connections from use cases
+    const derivedConnections = deriveConnectionsFromUseCases(catalog);
+    // Build edges combining explicit and derived connections
+    const edgeMap = new Map();
+    for (const service of catalog.services) {
+        const derived = derivedConnections.get(service.id);
+        const merged = mergeConnections(service.connections, derived);
+        for (const conn of merged) {
+            // Only add edge if target service exists
+            const targetExists = catalog.services.some((s) => s.id === conn.target);
+            if (!targetExists)
+                continue;
+            const key = `${service.id}->${conn.target}:${conn.type}`;
+            if (!edgeMap.has(key)) {
+                edgeMap.set(key, {
+                    source: service.id,
+                    target: conn.target,
+                    type: conn.type,
+                    ...(conn.role && { role: conn.role }),
+                    ...(conn.endpoints && { endpoints: conn.endpoints }),
+                    ...(conn.events && { events: conn.events }),
+                    ...(conn.description && { description: conn.description }),
+                });
+            }
+        }
+    }
+    return {
+        nodes,
+        edges: Array.from(edgeMap.values()),
+    };
+}
+//# sourceMappingURL=graph-builder.js.map

package/dist/services/graph-builder.js.map

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

package/dist/services/graph-builder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=graph-builder.test.d.ts.map

package/dist/services/graph-builder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-builder.test.d.ts","sourceRoot":"","sources":["../../src/services/graph-builder.test.ts"],"names":[],"mappings":""}