@things-factory/headless-twin 10.1.7 → 10.1.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/README.md +19 -0
  2. package/dist-server/migrations/1786800000000-CreateTwinReferenceReconciliations.d.ts +5 -0
  3. package/dist-server/migrations/1786800000000-CreateTwinReferenceReconciliations.js +44 -0
  4. package/dist-server/migrations/1786800000000-CreateTwinReferenceReconciliations.js.map +1 -0
  5. package/dist-server/migrations/index.js +3 -1
  6. package/dist-server/migrations/index.js.map +1 -1
  7. package/dist-server/routes.js +4 -1
  8. package/dist-server/routes.js.map +1 -1
  9. package/dist-server/service/index.d.ts +4 -2
  10. package/dist-server/service/index.js +2 -0
  11. package/dist-server/service/index.js.map +1 -1
  12. package/dist-server/service/reference/attention-lane.d.ts +12 -0
  13. package/dist-server/service/reference/attention-lane.js +15 -0
  14. package/dist-server/service/reference/attention-lane.js.map +1 -0
  15. package/dist-server/service/reference/index.d.ts +5 -2
  16. package/dist-server/service/reference/index.js +5 -2
  17. package/dist-server/service/reference/index.js.map +1 -1
  18. package/dist-server/service/reference/reference-adapter.d.ts +6 -0
  19. package/dist-server/service/reference/reference-adapter.js.map +1 -1
  20. package/dist-server/service/reference/reference-fill-run.js +13 -0
  21. package/dist-server/service/reference/reference-fill-run.js.map +1 -1
  22. package/dist-server/service/reference/reference-hook.d.ts +2 -1
  23. package/dist-server/service/reference/reference-hook.js +8 -1
  24. package/dist-server/service/reference/reference-hook.js.map +1 -1
  25. package/dist-server/service/reference/reference-reconciliation-query.d.ts +5 -0
  26. package/dist-server/service/reference/reference-reconciliation-query.js +42 -0
  27. package/dist-server/service/reference/reference-reconciliation-query.js.map +1 -0
  28. package/dist-server/service/reference/reference-reconciliation-writer.d.ts +10 -0
  29. package/dist-server/service/reference/reference-reconciliation-writer.js +33 -0
  30. package/dist-server/service/reference/reference-reconciliation-writer.js.map +1 -0
  31. package/dist-server/service/reference/reference-reconciliation.d.ts +19 -0
  32. package/dist-server/service/reference/reference-reconciliation.js +33 -0
  33. package/dist-server/service/reference/reference-reconciliation.js.map +1 -0
  34. package/dist-server/service/reference/twin-reference-reconciliation.d.ts +19 -0
  35. package/dist-server/service/reference/twin-reference-reconciliation.js +95 -0
  36. package/dist-server/service/reference/twin-reference-reconciliation.js.map +1 -0
  37. package/dist-server/service/twin-lifecycle/twin-lifecycle-mutation.d.ts +13 -1
  38. package/dist-server/service/twin-lifecycle/twin-lifecycle-mutation.js +45 -3
  39. package/dist-server/service/twin-lifecycle/twin-lifecycle-mutation.js.map +1 -1
  40. package/package.json +2 -2
  41. package/server/migrations/1786800000000-CreateTwinReferenceReconciliations.ts +39 -0
  42. package/server/migrations/index.ts +3 -1
  43. package/server/routes.ts +4 -1
  44. package/server/service/index.ts +2 -0
  45. package/server/service/reference/attention-lane.ts +21 -0
  46. package/server/service/reference/index.ts +5 -2
  47. package/server/service/reference/reference-adapter.ts +6 -0
  48. package/server/service/reference/reference-fill-run.ts +15 -1
  49. package/server/service/reference/reference-hook.ts +11 -3
  50. package/server/service/reference/reference-reconciliation-query.ts +28 -0
  51. package/server/service/reference/reference-reconciliation-writer.ts +38 -0
  52. package/server/service/reference/reference-reconciliation.ts +55 -0
  53. package/server/service/reference/twin-reference-reconciliation.ts +27 -0
  54. package/server/service/twin-lifecycle/twin-lifecycle-mutation.ts +43 -2
  55. package/test/reference-reconciliation.test.ts +39 -0
  56. package/tsconfig.tsbuildinfo +1 -1
@@ -0,0 +1,39 @@
1
+ import assert from 'node:assert/strict'
2
+ import test from 'node:test'
3
+ import { readFileSync } from 'node:fs'
4
+ import { join } from 'node:path'
5
+ import { reconcileReferenceSequence } from '../server/service/reference/reference-reconciliation.ts'
6
+
7
+ test('reports work waiting after the Twin cursor', () => {
8
+ const got = reconcileReferenceSequence({ source: { first: 1, last: 48 }, cursorSeq: 30, firstSeqSeen: 1 })
9
+ assert.equal(got.status, 'gap')
10
+ assert.equal(got.behind, 18)
11
+ assert.equal(got.headMissing, undefined)
12
+ })
13
+
14
+ test('reports the leading range only when the first received sequence proves it', () => {
15
+ const got = reconcileReferenceSequence({ source: { first: 1, last: 48 }, cursorSeq: 48, firstSeqSeen: 21 })
16
+ assert.equal(got.status, 'gap')
17
+ assert.equal(got.headMissing, 20)
18
+ })
19
+
20
+ test('does not claim alignment when the source range or first received sequence is unknown', () => {
21
+ assert.equal(reconcileReferenceSequence({ source: { first: 1 }, cursorSeq: 1, firstSeqSeen: 1 }).status, 'unknown')
22
+ assert.equal(reconcileReferenceSequence({ source: { first: 1, last: 1 }, cursorSeq: 1 }).status, 'unknown')
23
+ })
24
+
25
+ test('reports alignment only with both source bounds and a recorded first sequence', () => {
26
+ const got = reconcileReferenceSequence({ source: { first: 1, last: 48 }, cursorSeq: 48, firstSeqSeen: 1 })
27
+ assert.equal(got.status, 'aligned')
28
+ })
29
+
30
+ test('registers the durable reconciliation table and its migration', () => {
31
+ const root = join(import.meta.dirname, '..', 'server')
32
+ const migration = readFileSync(join(root, 'migrations', '1786800000000-CreateTwinReferenceReconciliations.ts'), 'utf8')
33
+ const list = readFileSync(join(root, 'migrations', 'index.ts'), 'utf8')
34
+ const referenceIndex = readFileSync(join(root, 'service', 'reference', 'index.ts'), 'utf8')
35
+ assert.match(migration, /twin_reference_reconciliations/)
36
+ assert.match(migration, /uq_twin_reference_reconciliation_0/)
37
+ assert.match(list, /CreateTwinReferenceReconciliations1786800000000/)
38
+ assert.match(referenceIndex, /TwinReferenceReconciliation/)
39
+ })