@bespokeagentics/microdots-host 0.1.0 → 0.1.2

package/src/wireEngine.test.ts

@@ -6,6 +6,7 @@ import {
   type WireEngine,
   type WireEngineOptions,
   type WireTrace,
+  WIRE_TRACE_EVENT,
   applyTransform,
   attachWireEngine,
   planWires,
@@ -18,7 +19,7 @@ import {
 
 const w1: Wire = {
   id: 'w1',
-  from: 'price-ticker',
+  from: 'readout-view',
   event: 'quote-changed',
   field: 'symbol',
   fieldType: 'string',
@@ -36,11 +37,11 @@ const w1: Wire = {
 
 const w2: Wire = {
   id: 'w2',
-  from: 'bespoke-contact-form',
+  from: 'intake-form',
   event: 'submission-created',
   field: 'id',
   fieldType: 'string',
-  to: 'bespoke-contact-dashboard',
+  to: 'intake-backend',
   input: 'refresh-token',
   inputType: 'string',
   transform: { _tag: 'direct' },
@@ -50,11 +51,11 @@ const w2: Wire = {
 
 const w3: Wire = {
   id: 'w3',
-  from: 'bespoke-contact-dashboard',
+  from: 'intake-backend',
   event: 'definition-changed',
   field: 'version',
   fieldType: 'number',
-  to: 'bespoke-contact-form',
+  to: 'intake-form',
   input: 'definition-token',
   inputType: 'number',
   transform: { _tag: 'direct' },
@@ -107,7 +108,7 @@ const pg7: Wire = { ...pg6, id: 'pg7', to: 'pages-inspector' }
 /** A `json` wire — the one declared fieldType the demo records never use. */
 const wJson: Wire = {
   id: 'w-json',
-  from: 'bespoke-contact-dashboard',
+  from: 'intake-backend',
   event: 'snapshot-changed',
   field: 'snapshot',
   fieldType: 'json',
@@ -186,16 +187,39 @@ describe('attachWireEngine', () => {
     const fleet = mount('fleet-health')
     attach({ topology: { wires: DEMO_WIRES, watch: [] } })
 
-    dispatch('price-ticker', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
+    dispatch('readout-view', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
 
     expect(fleet.getAttribute('region')).toBe('eu-west')
   })
 
+  test('broadcasts every wire trace on document so Watch/Trace can listen without importing the host', () => {
+    const seen: Array<unknown> = []
+    const listener = (event: Event): void => {
+      if (event instanceof CustomEvent) seen.push(event.detail)
+    }
+    document.addEventListener(WIRE_TRACE_EVENT, listener)
+    mount('fleet-health')
+    attach({ topology: { wires: DEMO_WIRES, watch: [] } })
+    dispatch('readout-view', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
+    document.removeEventListener(WIRE_TRACE_EVENT, listener)
+    expect(seen).toEqual([
+      {
+        _tag: 'wire',
+        event: 'quote-changed',
+        wireId: 'w1',
+        delivery: {
+          _tag: 'written',
+          write: { toTag: 'fleet-health', input: 'region', value: 'eu-west' },
+        },
+      },
+    ])
+  })
+
   test('falls back to us-east for a symbol outside the lookup rows', () => {
     const fleet = mount('fleet-health')
     attach({ topology: { wires: DEMO_WIRES, watch: [] } })
 
-    dispatch('price-ticker', 'quote-changed', { symbol: 'ZZZZ', cents: 1 })
+    dispatch('readout-view', 'quote-changed', { symbol: 'ZZZZ', cents: 1 })
 
     expect(fleet.getAttribute('region')).toBe('us-east')
   })
@@ -209,7 +233,7 @@ describe('attachWireEngine', () => {
     })
 
     engine.setEnabled('w1', false)
-    dispatch('price-ticker', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
+    dispatch('readout-view', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
 
     expect(fleet.getAttribute('region')).toBeNull()
     expect(traces).toEqual([
@@ -223,15 +247,15 @@ describe('attachWireEngine', () => {
 
     // The kill switch is not a detach: flipping it back restores the wire.
     engine.setEnabled('w1', true)
-    dispatch('price-ticker', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
+    dispatch('readout-view', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
     expect(fleet.getAttribute('region')).toBe('eu-west')
   })
 
   test('encodes the numeric version 7 as the attribute string "7"', () => {
-    const form = mount('bespoke-contact-form')
+    const form = mount('intake-form')
     attach({ topology: { wires: DEMO_WIRES, watch: [] } })
 
-    dispatch('bespoke-contact-dashboard', 'definition-changed', { version: 7 })
+    dispatch('intake-backend', 'definition-changed', { version: 7 })
 
     expect(form.getAttribute('definition-token')).toBe('7')
   })
@@ -243,14 +267,14 @@ describe('attachWireEngine', () => {
    * it (apps/host/src/loader.test.ts pins the same guard directly).
    */
   test('two identical events produce exactly one setAttribute call', () => {
-    const form = mount('bespoke-contact-form')
+    const form = mount('intake-form')
     attach({ topology: { wires: DEMO_WIRES, watch: [] } })
 
-    dispatch('bespoke-contact-dashboard', 'definition-changed', { version: 7 })
+    dispatch('intake-backend', 'definition-changed', { version: 7 })
     expect(form.getAttribute('definition-token')).toBe('7')
 
     const spy = vi.spyOn(form, 'setAttribute')
-    dispatch('bespoke-contact-dashboard', 'definition-changed', { version: 7 })
+    dispatch('intake-backend', 'definition-changed', { version: 7 })
 
     expect(spy).not.toHaveBeenCalled()
     spy.mockRestore()
@@ -263,7 +287,7 @@ describe('attachWireEngine', () => {
     const fleet = mount('fleet-health')
     attach({ topology: { wires: DEMO_WIRES, watch: [] } })
 
-    dispatch('price-ticker', 'quote-changed', {
+    dispatch('readout-view', 'quote-changed', {
       symbol: 'constructor',
       cents: 1,
     })
@@ -272,14 +296,14 @@ describe('attachWireEngine', () => {
   })
 
   test('a payload that is not a record skips as no-field', () => {
-    const form = mount('bespoke-contact-form')
+    const form = mount('intake-form')
     const traces: Array<WireTrace> = []
     attach({
       topology: { wires: DEMO_WIRES, watch: [] },
       onTrace: trace => traces.push(trace),
     })
 
-    dispatch('bespoke-contact-dashboard', 'definition-changed', 'seven')
+    dispatch('intake-backend', 'definition-changed', 'seven')
 
     expect(form.getAttribute('definition-token')).toBeNull()
     expect(traces).toEqual([
@@ -293,14 +317,14 @@ describe('attachWireEngine', () => {
   })
 
   test("a payload missing the wire's field skips as no-field", () => {
-    const form = mount('bespoke-contact-form')
+    const form = mount('intake-form')
     const traces: Array<WireTrace> = []
     attach({
       topology: { wires: DEMO_WIRES, watch: [] },
       onTrace: trace => traces.push(trace),
     })
 
-    dispatch('bespoke-contact-dashboard', 'definition-changed', { revision: 7 })
+    dispatch('intake-backend', 'definition-changed', { revision: 7 })
 
     expect(form.getAttribute('definition-token')).toBeNull()
     expect(traces).toEqual([
@@ -314,14 +338,14 @@ describe('attachWireEngine', () => {
   })
 
   test('a value that fails its declared fieldType decode skips as no-field', () => {
-    const form = mount('bespoke-contact-form')
+    const form = mount('intake-form')
     const traces: Array<WireTrace> = []
     attach({
       topology: { wires: DEMO_WIRES, watch: [] },
       onTrace: trace => traces.push(trace),
     })
 
-    dispatch('bespoke-contact-dashboard', 'definition-changed', {
+    dispatch('intake-backend', 'definition-changed', {
       version: 'seven',
     })
 
@@ -340,7 +364,7 @@ describe('attachWireEngine', () => {
     const fleet = mount('fleet-health')
     attach({ topology: { wires: [wJson], watch: [] } })
 
-    dispatch('bespoke-contact-dashboard', 'snapshot-changed', {
+    dispatch('intake-backend', 'snapshot-changed', {
       snapshot: { id: 7, tags: ['a'] },
     })
 
@@ -368,7 +392,7 @@ describe('attachWireEngine', () => {
 
     const cyclic: Record<string, unknown> = {}
     cyclic['self'] = cyclic
-    dispatch('bespoke-contact-dashboard', 'snapshot-changed', {
+    dispatch('intake-backend', 'snapshot-changed', {
       snapshot: cyclic,
       label: 'ok',
     })
@@ -401,7 +425,7 @@ describe('attachWireEngine', () => {
     const second = mount('fleet-health')
     attach({ topology: { wires: DEMO_WIRES, watch: [] } })
 
-    dispatch('price-ticker', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
+    dispatch('readout-view', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
 
     expect(first.getAttribute('region')).toBe('eu-west')
     expect(second.getAttribute('region')).toBe('eu-west')
@@ -418,7 +442,7 @@ describe('attachWireEngine', () => {
       onTrace: trace => traces.push(trace),
     })
 
-    dispatch('price-ticker', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
+    dispatch('readout-view', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
 
     expect(fleet.getAttribute('region')).toBe('eu-west')
     expect(traces).toEqual([
@@ -455,7 +479,7 @@ describe('attachWireEngine', () => {
       onTrace: trace => traces.push(trace),
     })
 
-    dispatch('price-ticker', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
+    dispatch('readout-view', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
 
     expect(fleet.getAttribute('region')).toBe('eu-west')
     expect(traces).toEqual([
@@ -494,7 +518,7 @@ describe('attachWireEngine', () => {
       onTrace: trace => traces.push(trace),
     })
 
-    dispatch('price-ticker', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
+    dispatch('readout-view', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
 
     expect(traces.map(trace => trace._tag)).toEqual(['watch', 'wire'])
   })
@@ -517,7 +541,7 @@ describe('attachWireEngine', () => {
       onTrace: trace => traces.push(trace),
     })
 
-    dispatch('price-ticker', 'quote-changed', { symbol: 'EFCT', linked: false })
+    dispatch('readout-view', 'quote-changed', { symbol: 'EFCT', linked: false })
 
     expect(fleet.getAttribute('region')).toBeNull()
     expect(traces).toEqual([
@@ -530,7 +554,7 @@ describe('attachWireEngine', () => {
     ])
 
     // The condition holding is the whole difference: same event, one write.
-    dispatch('price-ticker', 'quote-changed', { symbol: 'EFCT', linked: true })
+    dispatch('readout-view', 'quote-changed', { symbol: 'EFCT', linked: true })
     expect(fleet.getAttribute('region')).toBe('EFCT')
   })
 
@@ -563,7 +587,7 @@ describe('attachWireEngine', () => {
       onTrace: trace => traces.push(trace),
     })
 
-    dispatch('bespoke-contact-form', 'submission-created', { id: 'sub-42' })
+    dispatch('intake-form', 'submission-created', { id: 'sub-42' })
 
     expect(traces).toEqual([
       {
@@ -573,7 +597,7 @@ describe('attachWireEngine', () => {
         delivery: {
           _tag: 'target-unmounted',
           write: {
-            toTag: 'bespoke-contact-dashboard',
+            toTag: 'intake-backend',
             input: 'refresh-token',
             value: 'sub-42',
           },
@@ -670,7 +694,7 @@ describe('attachWireEngine', () => {
     const engine = attach({ topology: { wires: DEMO_WIRES, watch: [] } })
 
     engine.detach()
-    dispatch('price-ticker', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
+    dispatch('readout-view', 'quote-changed', { symbol: 'EFCT', cents: 12345 })
 
     expect(fleet.getAttribute('region')).toBeNull()
   })
@@ -725,7 +749,7 @@ describe('planWires', () => {
     const envelope = {
       version: 1,
       type: 'submission-created',
-      from: 'bespoke-contact-form',
+      from: 'intake-form',
       submissionId: 'sub-42',
     }
     const bridgeWire: Wire = { ...w2, field: 'submissionId' }
@@ -742,7 +766,7 @@ describe('planWires', () => {
 
     expect(plan.writes).toEqual([
       {
-        toTag: 'bespoke-contact-dashboard',
+        toTag: 'intake-backend',
         input: 'refresh-token',
         value: 'sub-42',
       },
@@ -796,7 +820,7 @@ describe('planWires', () => {
       [devOnly],
       {
         name: 'submission-created',
-        sourceTag: Option.some('bespoke-contact-form'),
+        sourceTag: Option.some('intake-form'),
         payload: { id: 'sub-1' },
       },
       { env: 'prod', isEnabled: () => true },

package/src/wireEngine.ts

@@ -307,8 +307,12 @@ export type WireDelivery =
 /**
  * What `onTrace` surfaces: every wire firing with its delivery, and every
  * `watch[]` tap with the raw payload. The host's log formatter consumes the
- * taps; the Wiring screen's Watch mode will consume both.
+ * taps; the Wiring screen's Watch mode and Trace tab consume both via the
+ * document event below — they cannot share a module-level bus with the host
+ * because the MicroDot bundle is a separate module graph.
  */
+export const WIRE_TRACE_EVENT = 'microdots:wire-trace'
+
 export type WireTrace =
   | {
       readonly _tag: 'wire'
@@ -348,6 +352,12 @@ export type WireEngine = {
 export const attachWireEngine = (options: WireEngineOptions): WireEngine => {
   const { wires, watch } = options.topology
   const onTrace = options.onTrace ?? (() => undefined)
+  const publish = (trace: WireTrace): void => {
+    onTrace(trace)
+    document.dispatchEvent(
+      new CustomEvent(WIRE_TRACE_EVENT, { detail: trace }),
+    )
+  }
 
   // Target resolution is pinned: by tag name, among mounted elements, EVERY
   // instance — not an injection point. `wire.to` is record data the schema
@@ -431,7 +441,7 @@ export const attachWireEngine = (options: WireEngineOptions): WireEngine => {
       // HOST'S LOG, not a wire — it fires for every emitter of the name, and
       // an unidentifiable source does not silence it.
       if (watched.has(name)) {
-        onTrace({ _tag: 'watch', event: name, payload })
+        publish({ _tag: 'watch', event: name, payload })
       }
       const plan = planWires(
         wires,
@@ -439,7 +449,7 @@ export const attachWireEngine = (options: WireEngineOptions): WireEngine => {
         { env: options.env, isEnabled },
       )
       plan.outcomes.forEach(outcome => {
-        onTrace({
+        publish({
           _tag: 'wire',
           event: name,
           wireId: outcome.wireId,