@open-operational-state/emitter 0.1.0

package/README.md

@@ -0,0 +1,72 @@
+# @open-operational-state/emitter
+
+Serialization emitters for [Open Operational State](https://github.com/open-operational-state). Convert core model `Snapshot` objects to spec-conformant wire formats.
+
+## Installation
+
+```bash
+bun add @open-operational-state/emitter
+```
+
+## API
+
+### `emitHealthResponse( snapshot )`
+
+Convert a `Snapshot` to an `application/health+json` payload.
+
+```js
+import { emitHealthResponse } from '@open-operational-state/emitter';
+
+const payload = emitHealthResponse( snapshot );
+// Serve as: Content-Type: application/health+json
+```
+
+### `emitServiceStatus( snapshot )`
+
+Convert a `Snapshot` to an `application/status+json` payload.
+
+```js
+import { emitServiceStatus } from '@open-operational-state/emitter';
+
+const payload = emitServiceStatus( snapshot );
+// Serve as: Content-Type: application/status+json
+```
+
+### `suggestHttpStatus( condition )`
+
+Get the recommended HTTP status code for a condition value.
+
+```js
+import { suggestHttpStatus } from '@open-operational-state/emitter';
+
+suggestHttpStatus( 'operational' ); // 200
+suggestHttpStatus( 'degraded' );    // 200
+suggestHttpStatus( 'down' );        // 503
+suggestHttpStatus( 'maintenance' ); // 503
+```
+
+### `suggestHeaders( snapshot, serialization )`
+
+Get recommended HTTP headers for a response.
+
+```js
+import { suggestHeaders } from '@open-operational-state/emitter';
+
+const headers = suggestHeaders( snapshot, 'application/health+json' );
+// { 'Content-Type': 'application/health+json', 'Cache-Control': 'no-cache, ...' }
+```
+
+### Round-Trip Guarantee
+
+The emitter maintains the round-trip invariant:
+
+```
+parse → normalize → emit → parse → normalize
+```
+
+No semantic drift, no loss of required data, no illegal state introduced. This is enforced by golden round-trip tests.
+
+## Dependencies
+
+- `@open-operational-state/types`
+- `@open-operational-state/core`

package/dist/__tests__/emitter.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Emitter Tests
+ *
+ * Round-trip tests: parse → emit → parse, verify structural identity.
+ */
+export {};
+//# sourceMappingURL=emitter.test.d.ts.map

package/dist/__tests__/emitter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/emitter.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/__tests__/emitter.test.js

@@ -0,0 +1,143 @@
+/**
+ * Emitter Tests
+ *
+ * Round-trip tests: parse → emit → parse, verify structural identity.
+ */
+import { describe, it, expect } from 'bun:test';
+import { resolve, join } from 'node:path';
+import { readFileSync, existsSync } from 'node:fs';
+import { normalizeSnapshot } from '@open-operational-state/core';
+import { emitHealthResponse } from '../health-response.js';
+import { emitServiceStatus } from '../service-status.js';
+import { suggestHttpStatus, suggestHeaders } from '../http.js';
+const FIXTURE_ROOT = process.env.OOS_FIXTURE_ROOT
+    || resolve(import.meta.dir, '../../../../..', 'status-conformance');
+function loadFixture(relPath) {
+    const fullPath = join(FIXTURE_ROOT, relPath);
+    if (!existsSync(fullPath)) {
+        throw new Error(`Fixture not found: ${fullPath}`);
+    }
+    return JSON.parse(readFileSync(fullPath, 'utf-8'));
+}
+// ---------------------------------------------------------------------------
+// Health response round-trip
+// ---------------------------------------------------------------------------
+describe('emitHealthResponse', () => {
+    it('emits a valid health response from a snapshot', () => {
+        const snapshot = {
+            condition: 'operational',
+            profiles: ['health'],
+            subject: { id: 'test-service', description: 'Test Service' },
+            timing: { observed: '2026-04-02T19:30:00Z' },
+            provenance: 'self-reported',
+        };
+        const payload = emitHealthResponse(snapshot);
+        expect(payload.condition).toBe('operational');
+        expect(payload.profiles).toEqual(['health']);
+        expect(payload.subject.id).toBe('test-service');
+        expect(payload.timing?.observed).toBe('2026-04-02T19:30:00Z');
+        expect(payload.provenance).toBe('self-reported');
+    });
+    it('round-trips a health fixture: emit → normalize', () => {
+        const fixture = loadFixture('fixtures/profiles/health/positive-degraded-with-components.json');
+        const input = fixture.input;
+        const snapshot = normalizeSnapshot(input);
+        // Emit
+        const payload = emitHealthResponse(snapshot);
+        // Re-normalize
+        const roundTripped = normalizeSnapshot(payload);
+        expect(roundTripped.condition).toBe(snapshot.condition);
+        expect(roundTripped.subject.id).toBe(snapshot.subject.id);
+        expect(roundTripped.provenance).toBe(snapshot.provenance);
+    });
+    it('includes checks from snapshot', () => {
+        const snapshot = {
+            condition: 'degraded',
+            profiles: ['health'],
+            subject: { id: 'test' },
+            checks: {
+                database: { condition: 'operational', role: 'dependency' },
+                cache: { condition: 'down', role: 'component' },
+            },
+        };
+        const payload = emitHealthResponse(snapshot);
+        expect(payload.checks).toBeDefined();
+        expect(Object.keys(payload.checks)).toEqual(['database', 'cache']);
+    });
+});
+// ---------------------------------------------------------------------------
+// Service status round-trip
+// ---------------------------------------------------------------------------
+describe('emitServiceStatus', () => {
+    it('emits a valid service-status payload', () => {
+        const snapshot = {
+            condition: 'degraded',
+            profiles: ['status'],
+            subject: { id: 'payment-platform', description: 'Payment Platform' },
+            timing: { observed: '2026-04-02T19:30:00Z' },
+            provenance: 'self-reported',
+            evidence: { type: 'error-rate', detail: '7.2% errors' },
+            components: [
+                { id: 'api', condition: 'operational' },
+                { id: 'cache', condition: 'down' },
+            ],
+            dependencies: [
+                { id: 'database', condition: 'operational' },
+            ],
+        };
+        const payload = emitServiceStatus(snapshot);
+        expect(payload.condition).toBe('degraded');
+        expect(payload.components?.length).toBe(2);
+        expect(payload.dependencies?.length).toBe(1);
+        expect(payload.evidence?.type).toBe('error-rate');
+    });
+    it('converts flat checks to components/dependencies', () => {
+        const snapshot = {
+            condition: 'operational',
+            profiles: ['status'],
+            subject: { id: 'test' },
+            checks: {
+                db: { condition: 'operational', role: 'dependency' },
+                worker: { condition: 'operational', role: 'component' },
+            },
+        };
+        const payload = emitServiceStatus(snapshot);
+        expect(payload.components?.length).toBe(1);
+        expect(payload.dependencies?.length).toBe(1);
+        expect(payload.components[0].id).toBe('worker');
+        expect(payload.dependencies[0].id).toBe('db');
+    });
+});
+// ---------------------------------------------------------------------------
+// HTTP helpers
+// ---------------------------------------------------------------------------
+describe('suggestHttpStatus', () => {
+    it('returns 200 for operational', () => {
+        expect(suggestHttpStatus('operational')).toBe(200);
+    });
+    it('returns 200 for degraded', () => {
+        expect(suggestHttpStatus('degraded')).toBe(200);
+    });
+    it('returns 503 for down', () => {
+        expect(suggestHttpStatus('down')).toBe(503);
+    });
+    it('returns 503 for maintenance', () => {
+        expect(suggestHttpStatus('maintenance')).toBe(503);
+    });
+    it('returns 200 for alive', () => {
+        expect(suggestHttpStatus('alive')).toBe(200);
+    });
+});
+describe('suggestHeaders', () => {
+    it('returns correct content type', () => {
+        const snapshot = {
+            condition: 'operational',
+            profiles: ['health'],
+            subject: { id: 'test' },
+        };
+        const headers = suggestHeaders(snapshot, 'application/health+json');
+        expect(headers['Content-Type']).toBe('application/health+json');
+        expect(headers['Cache-Control']).toContain('no-cache');
+    });
+});
+//# sourceMappingURL=emitter.test.js.map

package/dist/__tests__/emitter.test.js.map

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

package/dist/__tests__/round-trip.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Golden Round-Trip Invariant Tests
+ *
+ * Enforces the fundamental guarantee:
+ *   parse → normalize → emit → parse → normalize
+ *
+ * Must guarantee:
+ * - No semantic drift
+ * - No loss of required data
+ * - No illegal state introduced
+ *
+ * This is the long-term safety net. If these tests break,
+ * something fundamental has drifted.
+ */
+export {};
+//# sourceMappingURL=round-trip.test.d.ts.map

package/dist/__tests__/round-trip.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-trip.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/round-trip.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/__tests__/round-trip.test.js

@@ -0,0 +1,242 @@
+/**
+ * Golden Round-Trip Invariant Tests
+ *
+ * Enforces the fundamental guarantee:
+ *   parse → normalize → emit → parse → normalize
+ *
+ * Must guarantee:
+ * - No semantic drift
+ * - No loss of required data
+ * - No illegal state introduced
+ *
+ * This is the long-term safety net. If these tests break,
+ * something fundamental has drifted.
+ */
+import { describe, it, expect } from 'bun:test';
+import { resolve, join } from 'node:path';
+import { readFileSync, existsSync, readdirSync, statSync } from 'node:fs';
+import { normalizeSnapshot, validateSnapshot } from '@open-operational-state/core';
+import { parseHealthCheckDraft } from '@open-operational-state/parser';
+import { emitHealthResponse, emitServiceStatus } from '@open-operational-state/emitter';
+const FIXTURE_ROOT = process.env.OOS_FIXTURE_ROOT
+    || resolve(import.meta.dir, '../../../../..', 'status-conformance');
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function findFixtures(dirPath) {
+    if (!existsSync(dirPath)) {
+        return [];
+    }
+    const files = [];
+    for (const entry of readdirSync(dirPath)) {
+        const fullPath = join(dirPath, entry);
+        const stat = statSync(fullPath);
+        if (stat.isDirectory()) {
+            files.push(...findFixtures(fullPath));
+        }
+        else if (entry.endsWith('.json')) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+function loadJson(path) {
+    return JSON.parse(readFileSync(path, 'utf-8'));
+}
+/**
+ * Assert that two snapshots are semantically equivalent
+ * for the purposes of round-trip invariance.
+ *
+ * Checks required fields and structural shape.
+ * Timing is excluded from round-trip checks because emit
+ * may add/strip timing fields not present in the original.
+ */
+function assertSemanticEquivalence(original, roundTripped, label) {
+    // Condition must be preserved
+    expect(roundTripped.condition).toBe(original.condition);
+    // Subject identity must be preserved
+    expect(roundTripped.subject.id).toBe(original.subject.id);
+    // Subject description must be preserved if present
+    if (original.subject.description) {
+        expect(roundTripped.subject.description).toBe(original.subject.description);
+    }
+    // Profiles must be preserved
+    expect(roundTripped.profiles).toEqual(original.profiles);
+    // Provenance must be preserved if present
+    if (original.provenance) {
+        expect(roundTripped.provenance).toBe(original.provenance);
+    }
+    // Evidence type must be preserved if present
+    if (original.evidence) {
+        expect(roundTripped.evidence?.type).toBe(original.evidence.type);
+    }
+    // Check count must be preserved
+    if (original.checks) {
+        expect(Object.keys(roundTripped.checks || {}).length)
+            .toBe(Object.keys(original.checks).length);
+        // Each check's condition must be preserved
+        for (const [key, check] of Object.entries(original.checks)) {
+            expect(roundTripped.checks?.[key]?.condition).toBe(check.condition);
+        }
+    }
+    // The round-tripped snapshot must still be valid
+    const validation = validateSnapshot(roundTripped);
+    // If original was valid, round-trip must be valid
+    const originalValidation = validateSnapshot(original);
+    if (originalValidation.valid) {
+        expect(validation.valid).toBe(true);
+    }
+}
+// ---------------------------------------------------------------------------
+// Round-trip: health-response (parse → emit → parse)
+// ---------------------------------------------------------------------------
+describe('round-trip: health-response', () => {
+    // Core positive fixtures through health-response path
+    const corePositive = findFixtures(join(FIXTURE_ROOT, 'fixtures', 'core'))
+        .filter((f) => f.includes('positive'));
+    const profilePositive = findFixtures(join(FIXTURE_ROOT, 'fixtures', 'profiles'))
+        .filter((f) => f.includes('positive'));
+    const allPositive = [...corePositive, ...profilePositive];
+    for (const fixturePath of allPositive) {
+        const name = fixturePath.split('/').slice(-2).join('/');
+        it(`round-trips: ${name}`, () => {
+            const fixture = loadJson(fixturePath);
+            const input = fixture.input;
+            // Step 1: normalize input → Snapshot
+            const original = normalizeSnapshot(input);
+            // Step 2: emit health-response
+            const emitted = emitHealthResponse(original);
+            // Step 3: re-parse the emitted payload
+            const roundTripped = normalizeSnapshot(emitted);
+            // Step 4: verify semantic equivalence
+            assertSemanticEquivalence(original, roundTripped, name);
+        });
+    }
+});
+// ---------------------------------------------------------------------------
+// Round-trip: service-status (parse → emit → parse)
+// ---------------------------------------------------------------------------
+describe('round-trip: service-status', () => {
+    it('round-trips a rich snapshot through service-status format', () => {
+        const original = {
+            condition: 'degraded',
+            profiles: ['status'],
+            subject: { id: 'payment-platform', description: 'Payment Platform' },
+            timing: { observed: '2026-04-02T19:30:00Z' },
+            provenance: 'self-reported',
+            evidence: { type: 'error-rate', detail: '7.2% error rate' },
+            components: [
+                { id: 'api', condition: 'operational' },
+                { id: 'cache', condition: 'down', evidence: { type: 'connectivity', detail: 'Connection refused' } },
+            ],
+            dependencies: [
+                { id: 'database', condition: 'operational' },
+            ],
+        };
+        // Emit
+        const emitted = emitServiceStatus(original);
+        // Re-parse
+        const roundTripped = normalizeSnapshot(emitted);
+        // Verify
+        expect(roundTripped.condition).toBe('degraded');
+        expect(roundTripped.subject.id).toBe('payment-platform');
+        expect(roundTripped.provenance).toBe('self-reported');
+        expect(roundTripped.profiles).toEqual(['status']);
+    });
+    it('converts flat checks → components → flat checks without loss', () => {
+        const original = {
+            condition: 'operational',
+            profiles: ['health'],
+            subject: { id: 'test' },
+            checks: {
+                db: { condition: 'operational', role: 'dependency' },
+                worker: { condition: 'operational', role: 'component' },
+            },
+        };
+        // Emit as service-status (converts checks → components/dependencies)
+        const emitted = emitServiceStatus(original);
+        expect(emitted.components?.length).toBe(1);
+        expect(emitted.dependencies?.length).toBe(1);
+        // Emit as health-response (keeps checks flat)
+        const healthEmitted = emitHealthResponse(original);
+        const healthRoundTripped = normalizeSnapshot(healthEmitted);
+        expect(Object.keys(healthRoundTripped.checks || {}).length).toBe(2);
+    });
+});
+// ---------------------------------------------------------------------------
+// Round-trip: health-check-draft adapter → emit → parse
+// ---------------------------------------------------------------------------
+describe('round-trip: adapter → emit → re-parse', () => {
+    const adapterFixtures = findFixtures(join(FIXTURE_ROOT, 'adapters', 'health-check-draft')).filter((f) => f.includes('positive'));
+    for (const fixturePath of adapterFixtures) {
+        const name = fixturePath.split('/').slice(-1)[0];
+        it(`adapter round-trip: ${name}`, () => {
+            const fixture = loadJson(fixturePath);
+            const input = fixture.input;
+            // Step 1: parse through adapter
+            const adapted = parseHealthCheckDraft(input.body);
+            // Step 2: emit as health-response
+            const emitted = emitHealthResponse(adapted);
+            // Step 3: re-parse the emitted payload
+            const roundTripped = normalizeSnapshot(emitted);
+            // Step 4: verify the adapter output survived round-trip
+            expect(roundTripped.condition).toBe(adapted.condition);
+            expect(roundTripped.subject.id).toBe(adapted.subject.id);
+            expect(roundTripped.provenance).toBe(adapted.provenance);
+            // Must still validate — round-trip must not INTRODUCE new errors
+            const adaptedValidation = validateSnapshot(adapted);
+            const validation = validateSnapshot(roundTripped);
+            if (adaptedValidation.valid) {
+                expect(validation.valid).toBe(true);
+            }
+            else {
+                expect(validation.errors.length).toBeLessThanOrEqual(adaptedValidation.errors.length);
+            }
+        });
+    }
+});
+// ---------------------------------------------------------------------------
+// Illegal state detection
+// ---------------------------------------------------------------------------
+describe('round-trip: no illegal state introduced', () => {
+    it('emitting then re-parsing does not create empty required fields', () => {
+        const original = {
+            condition: 'operational',
+            profiles: ['health'],
+            subject: { id: 'svc-1' },
+            timing: { observed: '2026-04-02T19:30:00Z' },
+            provenance: 'self-reported',
+        };
+        const emitted = emitHealthResponse(original);
+        const roundTripped = normalizeSnapshot(emitted);
+        // Required fields must not become empty
+        expect(roundTripped.condition).toBeTruthy();
+        expect(roundTripped.subject.id).toBeTruthy();
+        expect(roundTripped.profiles.length).toBeGreaterThan(0);
+    });
+    it('does not silently coerce categorical to orderable', () => {
+        const original = {
+            condition: 'maintenance',
+            profiles: ['health'],
+            subject: { id: 'svc-1' },
+            timing: { observed: '2026-04-02T19:30:00Z' },
+        };
+        const emitted = emitHealthResponse(original);
+        const roundTripped = normalizeSnapshot(emitted);
+        // 'maintenance' must remain 'maintenance', not get coerced
+        expect(roundTripped.condition).toBe('maintenance');
+    });
+    it('does not silently coerce extension values', () => {
+        const original = {
+            condition: 'x-acme-draining',
+            profiles: ['health'],
+            subject: { id: 'svc-1' },
+            timing: { observed: '2026-04-02T19:30:00Z' },
+        };
+        const emitted = emitHealthResponse(original);
+        const roundTripped = normalizeSnapshot(emitted);
+        // Extension values must survive untouched
+        expect(roundTripped.condition).toBe('x-acme-draining');
+    });
+});
+//# sourceMappingURL=round-trip.test.js.map

package/dist/__tests__/round-trip.test.js.map

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

package/dist/health-response.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Health Response Emitter
+ *
+ * Converts a Snapshot → application/health+json wire format.
+ */
+import type { Snapshot } from '@open-operational-state/types';
+export interface HealthResponsePayload {
+    condition: string;
+    profiles: string[];
+    subject: {
+        id: string;
+        description?: string;
+    };
+    timing?: {
+        observed?: string;
+        reported?: string;
+        stateChanged?: string;
+    };
+    provenance?: string;
+    evidence?: {
+        type: string;
+        detail?: string;
+    };
+    checks?: Record<string, unknown>;
+    links?: Record<string, string>;
+}
+/**
+ * Emit a Snapshot as an application/health+json payload.
+ */
+export declare function emitHealthResponse(snapshot: Snapshot): HealthResponsePayload;
+//# sourceMappingURL=health-response.d.ts.map

package/dist/health-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-response.d.ts","sourceRoot":"","sources":["../src/health-response.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAgC,MAAM,+BAA+B,CAAC;AAM5F,MAAM,WAAW,qBAAqB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,MAAM,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAOD;;GAEG;AACH,wBAAgB,kBAAkB,CAC9B,QAAQ,EAAE,QAAQ,GACnB,qBAAqB,CAuCvB"}

package/dist/health-response.js

@@ -0,0 +1,117 @@
+/**
+ * Health Response Emitter
+ *
+ * Converts a Snapshot → application/health+json wire format.
+ */
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Emit a Snapshot as an application/health+json payload.
+ */
+export function emitHealthResponse(snapshot) {
+    const payload = {
+        condition: snapshot.condition,
+        profiles: [...snapshot.profiles],
+        subject: {
+            id: snapshot.subject.id,
+            ...(snapshot.subject.description ? { description: snapshot.subject.description } : {}),
+        },
+    };
+    // Timing
+    if (snapshot.timing) {
+        payload.timing = { ...snapshot.timing };
+    }
+    // Provenance
+    if (snapshot.provenance) {
+        payload.provenance = snapshot.provenance;
+    }
+    // Evidence
+    if (snapshot.evidence) {
+        const evidence = { type: snapshot.evidence.type };
+        if (snapshot.evidence.detail) {
+            evidence.detail = snapshot.evidence.detail;
+        }
+        payload.evidence = evidence;
+    }
+    // Checks — merge from flat checks or convert from nested arrays
+    const checks = buildChecks(snapshot);
+    if (checks && Object.keys(checks).length > 0) {
+        payload.checks = checks;
+    }
+    // Links
+    if (snapshot.links && Object.keys(snapshot.links).length > 0) {
+        payload.links = { ...snapshot.links };
+    }
+    return payload;
+}
+// ---------------------------------------------------------------------------
+// Internal
+// ---------------------------------------------------------------------------
+function buildChecks(snapshot) {
+    const result = {};
+    // Flat checks (native health-response format)
+    if (snapshot.checks) {
+        for (const [key, check] of Object.entries(snapshot.checks)) {
+            result[key] = buildCheckEntry(check);
+        }
+    }
+    // Nested components → flat checks
+    if (snapshot.components) {
+        for (const comp of snapshot.components) {
+            const entry = {
+                condition: comp.condition,
+                role: 'component',
+            };
+            if (comp.timing) {
+                entry.timing = comp.timing;
+            }
+            if (comp.provenance) {
+                entry.provenance = comp.provenance;
+            }
+            if (comp.evidence) {
+                entry.evidence = comp.evidence;
+            }
+            result[comp.id] = entry;
+        }
+    }
+    // Nested dependencies → flat checks
+    if (snapshot.dependencies) {
+        for (const dep of snapshot.dependencies) {
+            const entry = {
+                condition: dep.condition,
+                role: 'dependency',
+            };
+            if (dep.timing) {
+                entry.timing = dep.timing;
+            }
+            if (dep.provenance) {
+                entry.provenance = dep.provenance;
+            }
+            if (dep.evidence) {
+                entry.evidence = dep.evidence;
+            }
+            result[dep.id] = entry;
+        }
+    }
+    return Object.keys(result).length > 0 ? result : undefined;
+}
+function buildCheckEntry(check) {
+    const entry = {
+        condition: check.condition,
+    };
+    if (check.role) {
+        entry.role = check.role;
+    }
+    if (check.timing) {
+        entry.timing = check.timing;
+    }
+    if (check.provenance) {
+        entry.provenance = check.provenance;
+    }
+    if (check.evidence) {
+        entry.evidence = check.evidence;
+    }
+    return entry;
+}
+//# sourceMappingURL=health-response.js.map

package/dist/health-response.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,17 @@
+/**
+ * HTTP Response Helpers
+ *
+ * Suggest HTTP status codes and headers for operational-state responses
+ * per the serialization spec rules.
+ */
+import type { Snapshot } from '@open-operational-state/types';
+/**
+ * Returns the recommended HTTP status code for a given condition value,
+ * per the serialization spec HTTP Response Requirements.
+ */
+export declare function suggestHttpStatus(condition: string): number;
+/**
+ * Returns recommended HTTP headers for an operational-state response.
+ */
+export declare function suggestHeaders(snapshot: Snapshot, serialization: 'application/health+json' | 'application/status+json'): Record<string, string>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAM9D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAE,SAAS,EAAE,MAAM,GAAI,MAAM,CA2B7D;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAC1B,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,yBAAyB,GAAG,yBAAyB,GACrE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB"}

package/dist/http.js

@@ -0,0 +1,57 @@
+/**
+ * HTTP Response Helpers
+ *
+ * Suggest HTTP status codes and headers for operational-state responses
+ * per the serialization spec rules.
+ */
+// ---------------------------------------------------------------------------
+// HTTP status code suggestion
+// ---------------------------------------------------------------------------
+/**
+ * Returns the recommended HTTP status code for a given condition value,
+ * per the serialization spec HTTP Response Requirements.
+ */
+export function suggestHttpStatus(condition) {
+    switch (condition) {
+        // Good states → 200
+        case 'operational':
+        case 'alive':
+        case 'ready':
+        case 'degraded':
+        case 'partial-outage':
+        case 'major-outage':
+        case 'initializing':
+            return 200;
+        // Down / unreachable / not-ready → 503
+        case 'down':
+        case 'unreachable':
+        case 'not-ready':
+        case 'maintenance':
+            return 503;
+        // Unknown → 200 (service is responding)
+        case 'unknown':
+            return 200;
+        default:
+            // Extension values → 200 (service is responding)
+            return 200;
+    }
+}
+// ---------------------------------------------------------------------------
+// Header suggestion
+// ---------------------------------------------------------------------------
+/**
+ * Returns recommended HTTP headers for an operational-state response.
+ */
+export function suggestHeaders(snapshot, serialization) {
+    const headers = {
+        'Content-Type': serialization,
+        'Cache-Control': 'no-cache, no-store, must-revalidate',
+    };
+    // Retry-After for maintenance
+    if (snapshot.condition === 'maintenance' && snapshot.timing?.stateChanged) {
+        // If we know when maintenance started, suggest checking back in 5 minutes
+        headers['Retry-After'] = '300';
+    }
+    return headers;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAE,SAAiB;IAChD,QAAS,SAAS,EAAG,CAAC;QAClB,oBAAoB;QACpB,KAAK,aAAa,CAAC;QACnB,KAAK,OAAO,CAAC;QACb,KAAK,OAAO,CAAC;QACb,KAAK,UAAU,CAAC;QAChB,KAAK,gBAAgB,CAAC;QACtB,KAAK,cAAc,CAAC;QACpB,KAAK,cAAc;YACf,OAAO,GAAG,CAAC;QAEf,uCAAuC;QACvC,KAAK,MAAM,CAAC;QACZ,KAAK,aAAa,CAAC;QACnB,KAAK,WAAW,CAAC;QACjB,KAAK,aAAa;YACd,OAAO,GAAG,CAAC;QAEf,wCAAwC;QACxC,KAAK,SAAS;YACV,OAAO,GAAG,CAAC;QAEf;YACI,iDAAiD;YACjD,OAAO,GAAG,CAAC;IACnB,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,cAAc,CAC1B,QAAkB,EAClB,aAAoE;IAEpE,MAAM,OAAO,GAA2B;QACpC,cAAc,EAAE,aAAa;QAC7B,eAAe,EAAE,qCAAqC;KACzD,CAAC;IAEF,8BAA8B;IAC9B,IAAK,QAAQ,CAAC,SAAS,KAAK,aAAa,IAAI,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAG,CAAC;QAC1E,0EAA0E;QAC1E,OAAO,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC;IACnC,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @open-operational-state/emitter
+ *
+ * Serialization emitters — convert core model Snapshots to wire formats.
+ *
+ * Depends on @open-operational-state/types and @open-operational-state/core.
+ */
+export { emitHealthResponse } from './health-response.js';
+export type { HealthResponsePayload } from './health-response.js';
+export { emitServiceStatus } from './service-status.js';
+export type { ServiceStatusPayload } from './service-status.js';
+export { suggestHttpStatus, suggestHeaders } from './http.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * @open-operational-state/emitter
+ *
+ * Serialization emitters — convert core model Snapshots to wire formats.
+ *
+ * Depends on @open-operational-state/types and @open-operational-state/core.
+ */
+export { emitHealthResponse } from './health-response.js';
+export { emitServiceStatus } from './service-status.js';
+export { suggestHttpStatus, suggestHeaders } from './http.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/service-status.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Service Status Emitter
+ *
+ * Converts a Snapshot → application/status+json wire format.
+ */
+import type { Snapshot, ComponentEntry, DependencyEntry } from '@open-operational-state/types';
+export interface ServiceStatusPayload {
+    condition: string;
+    profiles: string[];
+    subject: {
+        id: string;
+        description?: string;
+        version?: string;
+        contact?: string;
+    };
+    timing?: {
+        observed?: string;
+        reported?: string;
+        stateChanged?: string;
+    };
+    provenance?: string;
+    evidence?: {
+        type: string;
+        detail?: string;
+    };
+    scope?: {
+        type: string;
+        identifier?: string;
+    };
+    components?: ComponentEntry[];
+    dependencies?: DependencyEntry[];
+    incidents?: unknown[];
+    links?: Record<string, string>;
+}
+/**
+ * Emit a Snapshot as an application/status+json payload.
+ */
+export declare function emitServiceStatus(snapshot: Snapshot): ServiceStatusPayload;
+//# sourceMappingURL=service-status.d.ts.map

package/dist/service-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-status.d.ts","sourceRoot":"","sources":["../src/service-status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAM/F,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,MAAM,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,KAAK,CAAC,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAE,QAAQ,EAAE,QAAQ,GAAI,oBAAoB,CA8E5E"}

package/dist/service-status.js

@@ -0,0 +1,112 @@
+/**
+ * Service Status Emitter
+ *
+ * Converts a Snapshot → application/status+json wire format.
+ */
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Emit a Snapshot as an application/status+json payload.
+ */
+export function emitServiceStatus(snapshot) {
+    const payload = {
+        condition: snapshot.condition,
+        profiles: [...snapshot.profiles],
+        subject: {
+            id: snapshot.subject.id,
+            ...(snapshot.subject.description ? { description: snapshot.subject.description } : {}),
+            ...(snapshot.subject.version ? { version: snapshot.subject.version } : {}),
+            ...(snapshot.subject.contact ? { contact: snapshot.subject.contact } : {}),
+        },
+    };
+    // Timing
+    if (snapshot.timing) {
+        payload.timing = { ...snapshot.timing };
+    }
+    // Provenance
+    if (snapshot.provenance) {
+        payload.provenance = snapshot.provenance;
+    }
+    // Evidence
+    if (snapshot.evidence) {
+        payload.evidence = {
+            type: snapshot.evidence.type,
+            ...(snapshot.evidence.detail ? { detail: snapshot.evidence.detail } : {}),
+        };
+    }
+    // Scope
+    if (snapshot.scope) {
+        payload.scope = { ...snapshot.scope };
+    }
+    // Components — from nested array or convert from flat checks
+    if (snapshot.components) {
+        payload.components = snapshot.components.map(cloneComponent);
+    }
+    else if (snapshot.checks) {
+        payload.components = [];
+        payload.dependencies = [];
+        for (const [key, check] of Object.entries(snapshot.checks)) {
+            if (check.role === 'dependency') {
+                payload.dependencies.push({
+                    id: key,
+                    condition: check.condition,
+                    ...(check.timing ? { timing: check.timing } : {}),
+                    ...(check.provenance ? { provenance: check.provenance } : {}),
+                    ...(check.evidence ? { evidence: check.evidence } : {}),
+                });
+            }
+            else {
+                payload.components.push({
+                    id: key,
+                    condition: check.condition,
+                    ...(check.timing ? { timing: check.timing } : {}),
+                    ...(check.provenance ? { provenance: check.provenance } : {}),
+                    ...(check.evidence ? { evidence: check.evidence } : {}),
+                });
+            }
+        }
+    }
+    // Dependencies (from nested array)
+    if (snapshot.dependencies) {
+        payload.dependencies = snapshot.dependencies.map((dep) => ({ ...dep }));
+    }
+    // Incidents
+    if (snapshot.incidents && snapshot.incidents.length > 0) {
+        payload.incidents = snapshot.incidents;
+    }
+    // Links
+    if (snapshot.links && Object.keys(snapshot.links).length > 0) {
+        payload.links = { ...snapshot.links };
+    }
+    return payload;
+}
+// ---------------------------------------------------------------------------
+// Internal
+// ---------------------------------------------------------------------------
+function cloneComponent(comp) {
+    const clone = {
+        id: comp.id,
+        condition: comp.condition,
+    };
+    if (comp.description) {
+        clone.description = comp.description;
+    }
+    if (comp.criticality) {
+        clone.criticality = comp.criticality;
+    }
+    if (comp.timing) {
+        clone.timing = { ...comp.timing };
+    }
+    if (comp.provenance) {
+        clone.provenance = comp.provenance;
+    }
+    if (comp.evidence) {
+        clone.evidence = { ...comp.evidence };
+    }
+    if (comp.components) {
+        clone.components = comp.components.map(cloneComponent);
+    }
+    return clone;
+}
+//# sourceMappingURL=service-status.js.map

package/dist/service-status.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@open-operational-state/emitter",
+  "version": "0.1.0",
+  "description": "Serialization emitters for Open Operational State wire formats",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/open-operational-state/status-tooling.git",
+    "directory": "packages/emitter"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@open-operational-state/types": "^0.1.0",
+    "@open-operational-state/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "@open-operational-state/parser": "^0.1.0",
+    "typescript": "^5.8.0"
+  }
+}