@ibgib/core-gib 0.1.54 → 0.1.57

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 (190) hide show
  1. package/CHANGELOG.md +11 -3
  2. package/README.md +12 -15
  3. package/dist/keystone/aggregate-details.respec.d.mts +2 -0
  4. package/dist/keystone/aggregate-details.respec.d.mts.map +1 -0
  5. package/dist/keystone/aggregate-details.respec.mjs +118 -0
  6. package/dist/keystone/aggregate-details.respec.mjs.map +1 -0
  7. package/dist/keystone/keystone-constants.d.mts +5 -0
  8. package/dist/keystone/keystone-constants.d.mts.map +1 -1
  9. package/dist/keystone/keystone-constants.mjs +6 -1
  10. package/dist/keystone/keystone-constants.mjs.map +1 -1
  11. package/dist/keystone/keystone-helpers.d.mts +7 -1
  12. package/dist/keystone/keystone-helpers.d.mts.map +1 -1
  13. package/dist/keystone/keystone-helpers.mjs +5 -2
  14. package/dist/keystone/keystone-helpers.mjs.map +1 -1
  15. package/dist/keystone/keystone-service-v1.d.mts +51 -0
  16. package/dist/keystone/keystone-service-v1.d.mts.map +1 -1
  17. package/dist/keystone/keystone-service-v1.mjs +176 -9
  18. package/dist/keystone/keystone-service-v1.mjs.map +1 -1
  19. package/dist/keystone/keystone-service-v1.respec.mjs +40 -98
  20. package/dist/keystone/keystone-service-v1.respec.mjs.map +1 -1
  21. package/dist/keystone/keystone-types.d.mts +5 -0
  22. package/dist/keystone/keystone-types.d.mts.map +1 -1
  23. package/dist/sync/graft-info/graft-info-helpers.respec.mjs +8 -8
  24. package/dist/sync/graft-info/graft-info-helpers.respec.mjs.map +1 -1
  25. package/dist/sync/sync-conflict-adv-multitimelines.respec.mjs +26 -30
  26. package/dist/sync/sync-conflict-adv-multitimelines.respec.mjs.map +1 -1
  27. package/dist/sync/sync-conflict-basic-divergence.respec.mjs +7 -8
  28. package/dist/sync/sync-conflict-basic-divergence.respec.mjs.map +1 -1
  29. package/dist/sync/sync-conflict-basic-multitimelines.respec.mjs +10 -11
  30. package/dist/sync/sync-conflict-basic-multitimelines.respec.mjs.map +1 -1
  31. package/dist/sync/sync-conflict-text-merge.respec.mjs +30 -33
  32. package/dist/sync/sync-conflict-text-merge.respec.mjs.map +1 -1
  33. package/dist/sync/sync-constants.d.mts +1 -56
  34. package/dist/sync/sync-constants.d.mts.map +1 -1
  35. package/dist/sync/sync-constants.mjs +2 -59
  36. package/dist/sync/sync-constants.mjs.map +1 -1
  37. package/dist/sync/sync-helpers.d.mts +0 -1
  38. package/dist/sync/sync-helpers.d.mts.map +1 -1
  39. package/dist/sync/sync-helpers.mjs +1 -6
  40. package/dist/sync/sync-helpers.mjs.map +1 -1
  41. package/dist/sync/sync-innerspace-constants.respec.mjs +5 -9
  42. package/dist/sync/sync-innerspace-constants.respec.mjs.map +1 -1
  43. package/dist/sync/sync-innerspace-deep-updates.respec.mjs +6 -7
  44. package/dist/sync/sync-innerspace-deep-updates.respec.mjs.map +1 -1
  45. package/dist/sync/sync-innerspace-dest-ahead-withid.respec.mjs +22 -22
  46. package/dist/sync/sync-innerspace-dest-ahead-withid.respec.mjs.map +1 -1
  47. package/dist/sync/sync-innerspace-dest-ahead.respec.mjs +8 -9
  48. package/dist/sync/sync-innerspace-dest-ahead.respec.mjs.map +1 -1
  49. package/dist/sync/sync-innerspace-multiple-timelines.respec.mjs +6 -7
  50. package/dist/sync/sync-innerspace-multiple-timelines.respec.mjs.map +1 -1
  51. package/dist/sync/sync-innerspace-partial-update.respec.mjs +7 -8
  52. package/dist/sync/sync-innerspace-partial-update.respec.mjs.map +1 -1
  53. package/dist/sync/sync-innerspace.respec.mjs +8 -11
  54. package/dist/sync/sync-innerspace.respec.mjs.map +1 -1
  55. package/dist/sync/sync-peer/sync-peer-http-receiver/sync-http-node-adapter.mjs +10 -5
  56. package/dist/sync/sync-peer/sync-peer-http-receiver/sync-http-node-adapter.mjs.map +1 -1
  57. package/dist/sync/sync-peer/sync-peer-http-receiver/sync-peer-http-receiver-types.d.mts +3 -1
  58. package/dist/sync/sync-peer/sync-peer-http-receiver/sync-peer-http-receiver-types.d.mts.map +1 -1
  59. package/dist/sync/sync-peer/sync-peer-http-receiver/sync-peer-http-receiver-v1.d.mts +4 -2
  60. package/dist/sync/sync-peer/sync-peer-http-receiver/sync-peer-http-receiver-v1.d.mts.map +1 -1
  61. package/dist/sync/sync-peer/sync-peer-http-receiver/sync-peer-http-receiver-v1.mjs +37 -6
  62. package/dist/sync/sync-peer/sync-peer-http-receiver/sync-peer-http-receiver-v1.mjs.map +1 -1
  63. package/dist/sync/sync-peer/sync-peer-http-sender/sync-peer-http-sender-types.d.mts +3 -1
  64. package/dist/sync/sync-peer/sync-peer-http-sender/sync-peer-http-sender-types.d.mts.map +1 -1
  65. package/dist/sync/sync-peer/sync-peer-http-sender/sync-peer-http-sender-v1.d.mts +4 -2
  66. package/dist/sync/sync-peer/sync-peer-http-sender/sync-peer-http-sender-v1.d.mts.map +1 -1
  67. package/dist/sync/sync-peer/sync-peer-http-sender/sync-peer-http-sender-v1.mjs +37 -0
  68. package/dist/sync/sync-peer/sync-peer-http-sender/sync-peer-http-sender-v1.mjs.map +1 -1
  69. package/dist/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-types.d.mts +7 -1
  70. package/dist/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-types.d.mts.map +1 -1
  71. package/dist/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.d.mts +10 -2
  72. package/dist/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.d.mts.map +1 -1
  73. package/dist/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs +50 -38
  74. package/dist/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs.map +1 -1
  75. package/dist/sync/sync-peer/sync-peer-types.d.mts +21 -5
  76. package/dist/sync/sync-peer/sync-peer-types.d.mts.map +1 -1
  77. package/dist/sync/sync-peer/sync-peer-v1.d.mts +30 -5
  78. package/dist/sync/sync-peer/sync-peer-v1.d.mts.map +1 -1
  79. package/dist/sync/sync-peer/sync-peer-v1.mjs +41 -25
  80. package/dist/sync/sync-peer/sync-peer-v1.mjs.map +1 -1
  81. package/dist/sync/sync-saga-context/sync-saga-context-helpers.d.mts +2 -11
  82. package/dist/sync/sync-saga-context/sync-saga-context-helpers.d.mts.map +1 -1
  83. package/dist/sync/sync-saga-context/sync-saga-context-helpers.mjs +7 -51
  84. package/dist/sync/sync-saga-context/sync-saga-context-helpers.mjs.map +1 -1
  85. package/dist/sync/sync-saga-context/sync-saga-context-types.d.mts +1 -47
  86. package/dist/sync/sync-saga-context/sync-saga-context-types.d.mts.map +1 -1
  87. package/dist/sync/sync-saga-coordinator.d.mts +6 -58
  88. package/dist/sync/sync-saga-coordinator.d.mts.map +1 -1
  89. package/dist/sync/sync-saga-coordinator.mjs +23 -425
  90. package/dist/sync/sync-saga-coordinator.mjs.map +1 -1
  91. package/dist/sync/sync-saga-message/sync-saga-message-types.d.mts +2 -2
  92. package/dist/sync/sync-saga-message/sync-saga-message-types.d.mts.map +1 -1
  93. package/dist/sync/sync-types.d.mts +2 -19
  94. package/dist/sync/sync-types.d.mts.map +1 -1
  95. package/dist/sync/sync-types.mjs.map +1 -1
  96. package/dist/test/mock-space.mjs +1 -1
  97. package/dist/test/mock-space.mjs.map +1 -1
  98. package/dist/test-helpers.d.mts +0 -6
  99. package/dist/test-helpers.d.mts.map +1 -1
  100. package/dist/test-helpers.mjs +2 -25
  101. package/dist/test-helpers.mjs.map +1 -1
  102. package/package.json +10 -34
  103. package/src/keystone/aggregate-details.respec.mts +137 -0
  104. package/src/keystone/docs/architecture.md +16 -0
  105. package/src/keystone/keystone-constants.mts +6 -1
  106. package/src/keystone/keystone-helpers.mts +9 -1
  107. package/src/keystone/keystone-service-v1.mts +216 -8
  108. package/src/keystone/keystone-service-v1.respec.mts +39 -103
  109. package/src/keystone/keystone-types.mts +6 -0
  110. package/src/sync/README.md +2 -87
  111. package/src/sync/docs/architecture.md +26 -5
  112. package/src/sync/docs/security.md +176 -0
  113. package/src/sync/graft-info/graft-info-helpers.respec.mts +7 -7
  114. package/src/sync/sync-conflict-adv-multitimelines.respec.mts +25 -29
  115. package/src/sync/sync-conflict-basic-divergence.respec.mts +6 -7
  116. package/src/sync/sync-conflict-basic-multitimelines.respec.mts +9 -10
  117. package/src/sync/sync-conflict-text-merge.respec.mts +29 -32
  118. package/src/sync/sync-constants.mts +2 -62
  119. package/src/sync/sync-helpers.mts +1 -8
  120. package/src/sync/sync-id-testlog.txt +421 -0
  121. package/src/sync/sync-innerspace-constants.respec.mts +4 -8
  122. package/src/sync/sync-innerspace-deep-updates.respec.mts +5 -6
  123. package/src/sync/sync-innerspace-dest-ahead-withid.respec.mts +23 -25
  124. package/src/sync/sync-innerspace-dest-ahead.respec.mts +7 -8
  125. package/src/sync/sync-innerspace-multiple-timelines.respec.mts +5 -6
  126. package/src/sync/sync-innerspace-partial-update.respec.mts +6 -7
  127. package/src/sync/sync-innerspace.respec.mts +7 -10
  128. package/src/sync/sync-peer/sync-peer-http-receiver/sync-http-node-adapter.mts +5 -5
  129. package/src/sync/sync-peer/sync-peer-http-receiver/sync-peer-http-receiver-types.mts +5 -1
  130. package/src/sync/sync-peer/sync-peer-http-receiver/sync-peer-http-receiver-v1.mts +30 -9
  131. package/src/sync/sync-peer/sync-peer-http-sender/sync-peer-http-sender-types.mts +3 -1
  132. package/src/sync/sync-peer/sync-peer-http-sender/sync-peer-http-sender-v1.mts +29 -2
  133. package/src/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-types.mts +7 -1
  134. package/src/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mts +51 -38
  135. package/src/sync/sync-peer/sync-peer-types.mts +23 -6
  136. package/src/sync/sync-peer/sync-peer-v1.mts +68 -28
  137. package/src/sync/sync-saga-context/sync-saga-context-helpers.mts +6 -66
  138. package/src/sync/sync-saga-context/sync-saga-context-types.mts +1 -48
  139. package/src/sync/sync-saga-coordinator.mts +12 -552
  140. package/src/sync/sync-saga-message/sync-saga-message-types.mts +2 -3
  141. package/src/sync/sync-types.mts +2 -22
  142. package/src/sync/unused-identity-backup.mts.md +311 -0
  143. package/src/test/mock-space.mts +1 -1
  144. package/src/test-helpers.mts +1 -26
  145. package/test_output.log +0 -0
  146. package/test_output_utf8.txt +398 -0
  147. package/.vscode/core-gib-snippets.code-snippets +0 -293
  148. package/.vscode/launch.json +0 -40
  149. package/.vscode/settings.json +0 -58
  150. package/.vscode/tasks.json +0 -37
  151. package/dist/sync/sync-peer/sync-peer-http.respec.d.mts +0 -2
  152. package/dist/sync/sync-peer/sync-peer-http.respec.d.mts.map +0 -1
  153. package/dist/sync/sync-peer/sync-peer-http.respec.mjs +0 -340
  154. package/dist/sync/sync-peer/sync-peer-http.respec.mjs.map +0 -1
  155. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-helper.d.mts +0 -42
  156. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-helper.d.mts.map +0 -1
  157. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-helper.mjs +0 -312
  158. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-helper.mjs.map +0 -1
  159. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-types.d.mts +0 -84
  160. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-types.d.mts.map +0 -1
  161. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-types.mjs +0 -65
  162. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-types.mjs.map +0 -1
  163. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-v1.d.mts +0 -73
  164. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-v1.d.mts.map +0 -1
  165. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-v1.mjs +0 -667
  166. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-v1.mjs.map +0 -1
  167. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_createAndInit.node-filesystem-space-v1.respec.d.mts +0 -2
  168. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_createAndInit.node-filesystem-space-v1.respec.d.mts.map +0 -1
  169. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_createAndInit.node-filesystem-space-v1.respec.mjs +0 -67
  170. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_createAndInit.node-filesystem-space-v1.respec.mjs.map +0 -1
  171. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_persistTransformResult.node-filesystem-space-v1.respec.d.mts +0 -2
  172. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_persistTransformResult.node-filesystem-space-v1.respec.d.mts.map +0 -1
  173. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_persistTransformResult.node-filesystem-space-v1.respec.mjs +0 -67
  174. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_persistTransformResult.node-filesystem-space-v1.respec.mjs.map +0 -1
  175. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_putGetDelete.node-filesystem-space-v1.respec.d.mts +0 -2
  176. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_putGetDelete.node-filesystem-space-v1.respec.d.mts.map +0 -1
  177. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_putGetDelete.node-filesystem-space-v1.respec.mjs +0 -68
  178. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_putGetDelete.node-filesystem-space-v1.respec.mjs.map +0 -1
  179. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_registerNewIbGib_GetLatest.node-filesystem-space-v1.respec.d.mts +0 -2
  180. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_registerNewIbGib_GetLatest.node-filesystem-space-v1.respec.d.mts.map +0 -1
  181. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_registerNewIbGib_GetLatest.node-filesystem-space-v1.respec.mjs +0 -69
  182. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_registerNewIbGib_GetLatest.node-filesystem-space-v1.respec.mjs.map +0 -1
  183. package/src/sync/sync-peer/sync-peer-http.respec.mts +0 -396
  184. package/src/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-helper.mts +0 -298
  185. package/src/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-types.mts +0 -150
  186. package/src/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-v1.mts +0 -666
  187. package/src/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_createAndInit.node-filesystem-space-v1.respec.mts +0 -87
  188. package/src/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_persistTransformResult.node-filesystem-space-v1.respec.mts +0 -88
  189. package/src/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_putGetDelete.node-filesystem-space-v1.respec.mts +0 -88
  190. package/src/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_registerNewIbGib_GetLatest.node-filesystem-space-v1.respec.mts +0 -90
@@ -1,340 +0,0 @@
1
- // /**
2
- // * @module sync-peer-http.respec
3
- // *
4
- // * Verifies SyncSagaCoordinator using a mock HTTP/SSE "thin layer".
5
- // * This utilizes SyncPeerHttpSender_V1 and SyncPeerHttpReceiver_V1 for network synchronization simulations.
6
- // */
7
- export {};
8
- // import * as cp from 'child_process';
9
- // import * as fs from 'fs';
10
- // import * as path from 'path';
11
- // import {
12
- // respecfully, lastOfAll, iReckon, ifWe, ifWeMight
13
- // } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
14
- // const maam = `[${import.meta.url}]`, sir = maam;
15
- // import { clone, delay, extractErrorMsg, pretty } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
16
- // import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
17
- // import { GLOBAL_LOG_A_LOT } from '../../core-constants.mjs';
18
- // import { SyncSagaCoordinator } from '../sync-saga-coordinator.mjs';
19
- // import { getFromSpace, putInSpace, registerNewIbGib } from '../../witness/space/space-helper.mjs';
20
- // import { Metaspace_Innerspace } from '../../witness/space/metaspace/metaspace-innerspace/metaspace-innerspace.mjs';
21
- // import { InnerSpace_V1 } from '../../witness/space/inner-space/inner-space-v1.mjs';
22
- // import { createTimelineRootTestHelper, getTestKeystoneServiceHelper } from '../../test-helpers.mjs';
23
- // import { mut8Timeline, } from '../../timeline/timeline-api.mjs';
24
- // import { DEFAULT_INNER_SPACE_DATA_V1 } from '../../witness/space/inner-space/inner-space-types.mjs';
25
- // import { toDto } from '../../common/other/ibgib-helper.mjs';
26
- // import { getSyncSagaFrameDependencyGraph } from '../sync-helpers.mjs';
27
- // import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
28
- // import { SyncIbGib_V1 } from '../sync-types.mjs';
29
- // import { SyncStage } from '../sync-constants.mjs';
30
- // import { getDependencyGraph } from '../../common/other/graph-helper.mjs';
31
- // import { SyncPeerHttpSender_V1 } from './sync-peer-http-sender/sync-peer-http-sender-v1.mjs';
32
- // import { SyncPeerHttpReceiver_V1 } from './sync-peer-http-receiver/sync-peer-http-receiver-v1.mjs';
33
- // import { SyncPeerHttpSenderData_V1 } from './sync-peer-http-sender/sync-peer-http-sender-types.mjs';
34
- // import { SyncPeerHttpReceiverData_V1 } from './sync-peer-http-receiver/sync-peer-http-receiver-types.mjs';
35
- // import { SyncSagaContextIbGib_V1 } from '../sync-saga-context/sync-saga-context-types.mjs';
36
- // import { SyncHttpNodeAdapter_V1 } from './sync-peer-http-receiver/sync-http-node-adapter.mjs';
37
- // const logalot = GLOBAL_LOG_A_LOT;
38
- // const lc = `[sync-peer-http.respec]`;
39
- // await respecfully(sir, `Sync HTTP Peers`, async () => {
40
- // let metaspace: Metaspace_Innerspace;
41
- // let sourceSpace: InnerSpace_V1;
42
- // let destSpace: InnerSpace_V1;
43
- // // We focus this test initially for development
44
- // await ifWe(sir, `Basic Push Sync over Mocked HTTP/SSE`, async () => {
45
- // // 1. Setup Spaces
46
- // metaspace = new Metaspace_Innerspace(undefined);
47
- // await metaspace.initialize({
48
- // getFnAlert: () => async ({ title, msg }) => { console.log(`[Alert] ${title}: ${msg}`); },
49
- // getFnPrompt: () => async ({ title, msg }) => { console.log(`[Prompt] ${title}: ${msg}`); return ''; },
50
- // getFnPromptPassword: () => async (title, msg) => { console.log(`[PromptPwd] ${title}: ${msg}`); return null; },
51
- // });
52
- // while (!metaspace.initialized) { await delay(10); }
53
- // const defaultLocalUserSpace = await metaspace.getLocalUserSpace({ lock: false });
54
- // if (!defaultLocalUserSpace) { throw new Error(`(UNEXPECTED) defaultLocalUserSpace falsy?`); }
55
- // await defaultLocalUserSpace.initialized;
56
- // sourceSpace = new InnerSpace_V1({
57
- // ...DEFAULT_INNER_SPACE_DATA_V1,
58
- // name: 'source',
59
- // uuid: 'source_uuid',
60
- // description: 'source test space',
61
- // });
62
- // await sourceSpace.initialized;
63
- // destSpace = new InnerSpace_V1({
64
- // ...DEFAULT_INNER_SPACE_DATA_V1,
65
- // name: 'dest',
66
- // uuid: 'dest_uuid',
67
- // description: 'dest test space',
68
- // });
69
- // await destSpace.initialized;
70
- // // 2. Seed Source Data
71
- // if (logalot) { console.log(`${lc} Creating data in Source...`); }
72
- // const root = await createTimelineRootTestHelper({
73
- // ib: 'timeline_root',
74
- // data: { type: 'root', },
75
- // space: sourceSpace,
76
- // });
77
- // const child = await mut8Timeline({
78
- // timeline: root,
79
- // mut8Opts: {
80
- // dataToAddOrPatch: { type: 'child', },
81
- // },
82
- // metaspace,
83
- // space: sourceSpace,
84
- // });
85
- // const childAddr = getIbGibAddr({ ibGib: child });
86
- // // 3. Setup Coordinators & Peer
87
- // if (logalot) { console.log(`${lc} Setting up Coordinators...`); }
88
- // const mockKeystone = await getTestKeystoneServiceHelper();
89
- // const senderCoordinator = new SyncSagaCoordinator(mockKeystone);
90
- // const receiverCoordinator = new SyncSagaCoordinator(mockKeystone);
91
- // // --- Mocking the HTTP "Network" ---
92
- // // Instead of real fetch and EventSource, we wire the Sender's outgoing HTTP
93
- // // calls directly to the Receiver's incoming endpoints.
94
- // const receiverPeerData: SyncPeerHttpReceiverData_V1 = { classname: SyncPeerHttpReceiver_V1.name };
95
- // const receiverPeer = new SyncPeerHttpReceiver_V1(receiverPeerData);
96
- // await receiverPeer.initialized;
97
- // await receiverPeer.initializeOpts({
98
- // localCoordinator: receiverCoordinator,
99
- // localMetaspace: metaspace,
100
- // localSpace: destSpace,
101
- // keystoneSvc: mockKeystone
102
- // });
103
- // // We'll subclass/monkey-patch the Sender peer to use mock fetching
104
- // class MockSyncPeerHttpSender extends SyncPeerHttpSender_V1 {
105
- // override async sendContextRequest(context: SyncSagaContextIbGib_V1): Promise<SyncSagaContextIbGib_V1 | undefined> {
106
- // // Mock POST /sync/frame
107
- // // Real sender would serialize and POST. Here we just hand it to receiver:
108
- // const responsePromise = new Promise<SyncSagaContextIbGib_V1 | undefined>(async (resolve, reject) => {
109
- // try {
110
- // const rel8ns = context.rel8ns;
111
- // if (!rel8ns || (rel8ns.sagaFrame || []).length !== 1) { throw new Error(`(UNEXPECTED) context.rel8ns.sagaFrame missing?`); }
112
- // const sagaAddr = rel8ns.sagaFrame![0];
113
- // const getSagaRes = await getFromSpace({ addr: sagaAddr, space: sourceSpace });
114
- // const sagaFrame = getSagaRes.ibGibs![0] as SyncIbGib_V1;
115
- // const { msgStones, identities } = await getSyncSagaFrameDependencyGraph({
116
- // sagaIbGib: sagaFrame,
117
- // localSpace: sourceSpace,
118
- // });
119
- // const msg = msgStones[0];
120
- // // Identity transportation logic (Bill Architecture)
121
- // const identityIbGibs: IbGib_V1[] = [];
122
- // const { signedSessionKeystone } = context;
123
- // if (signedSessionKeystone) {
124
- // if (msg.data!.stage === SyncStage.init) {
125
- // // transmit full keystone graph on the first handshake
126
- // const keystoneGraph = await getDependencyGraph({
127
- // ibGib: signedSessionKeystone,
128
- // space: sourceSpace,
129
- // });
130
- // identityIbGibs.push(...Object.values(keystoneGraph));
131
- // } else {
132
- // // transmit only the latest evolution for subsequent turns
133
- // identityIbGibs.push(signedSessionKeystone);
134
- // }
135
- // }
136
- // const payloadIbGibsControl = [...identities, ...identityIbGibs, msg, sagaFrame, context].filter(x => !!x).map(x => toDto({ ibGib: x }));
137
- // // The Server Adapter calls receiverPeer.handleIncomingSyncRequest
138
- // const responseContext = await receiverPeer.handleIncomingSyncRequest({
139
- // context,
140
- // payloadIbGibsControl
141
- // });
142
- // if (!responseContext) {
143
- // resolve(undefined);
144
- // return;
145
- // }
146
- // // **Mock the Server Adapter returning data**
147
- // // Real server would stream the newly evolved Control Context ibgibs to SSE,
148
- // // followed by the response domain payload ibgibs.
149
- // // We must MANUALLY persist the control ibgibs to the sender space FIRST,
150
- // // to simulate the client downloading and validating them from the SSE connection.
151
- // await delay(100);
152
- // const responseSagaAddr = responseContext.rel8ns!.sagaFrame![0];
153
- // const getResponseSagaRes = await getFromSpace({ addr: responseSagaAddr, space: destSpace });
154
- // const responseSagaFrame = getResponseSagaRes.ibGibs![0] as SyncIbGib_V1;
155
- // const depGraphResponse = await getSyncSagaFrameDependencyGraph({
156
- // sagaIbGib: responseSagaFrame,
157
- // localSpace: destSpace,
158
- // });
159
- // const responseIdentityIbGibs: IbGib_V1[] = [];
160
- // if (responseContext.signedSessionKeystone) {
161
- // responseIdentityIbGibs.push(responseContext.signedSessionKeystone);
162
- // }
163
- // const responsePayloadIbGibsControl = [
164
- // ...depGraphResponse.identities,
165
- // ...responseIdentityIbGibs,
166
- // depGraphResponse.msgStones[0],
167
- // responseSagaFrame,
168
- // context
169
- // ].filter(x => !!x).map(x => toDto({ ibGib: x }));
170
- // for (const ibGib of responsePayloadIbGibsControl) {
171
- // await putInSpace({ space: sourceSpace, ibGibs: [ibGib] });
172
- // await registerNewIbGib({ ibGib, space: sourceSpace, fnBroadcast: undefined });
173
- // }
174
- // await delay(5); // Simulate end of SSE task event
175
- // // Resolve with the responseContext
176
- // resolve(responseContext);
177
- // // THEN simulate streaming the domain payload ibgibs to the local subject
178
- // if (responseContext.payloadIbGibsDomain) {
179
- // new Promise<void>(async (resDom) => {
180
- // for (const domainIbGib of responseContext.payloadIbGibsDomain!) {
181
- // await delay(1); // emulate network gap between SSE events
182
- // await this.payloadIbGibsDomainReceived$.next(domainIbGib);
183
- // }
184
- // resDom();
185
- // });
186
- // }
187
- // } catch (e) {
188
- // reject(e);
189
- // }
190
- // });
191
- // return responsePromise;
192
- // }
193
- // }
194
- // const senderPeerData: SyncPeerHttpSenderData_V1 = {
195
- // classname: SyncPeerHttpSender_V1.name,
196
- // syncRoute: 'http://mock/sync/frame',
197
- // syncEventsRoute: 'http://mock/sync/events'
198
- // };
199
- // // Use the already created senderCoordinator
200
- // const testKeystoneSvc = mockKeystone;
201
- // const senderPeer = new MockSyncPeerHttpSender(senderPeerData);
202
- // await senderPeer.initialized;
203
- // // We configure localSpace and a senderTempSpace for the mock:
204
- // const senderTempSpace = new InnerSpace_V1({
205
- // ...DEFAULT_INNER_SPACE_DATA_V1, name: 'sender_temp', uuid: 'sender_temp_uuid'
206
- // });
207
- // await senderTempSpace.initialized;
208
- // await senderPeer.initializeOpts({
209
- // localSpace: sourceSpace,
210
- // localTempSpace: senderTempSpace,
211
- // keystoneSvc: testKeystoneSvc
212
- // });
213
- // // 4. Run Sync
214
- // if (logalot) { console.log(`${lc} Running Sync...`); }
215
- // try {
216
- // const resSync = await senderCoordinator.sync({
217
- // peer: senderPeer,
218
- // localSpace: sourceSpace,
219
- // metaspace: metaspace,
220
- // domainIbGibs: [child], // Sync the child
221
- // useSessionIdentity: false, // Testing logic only
222
- // });
223
- // await resSync.done;
224
- // iReckon(sir, true).asTo('Mocked request ran').isGonnaBeTrue();
225
- // // We now expect the entire saga to complete because handleIncomingSyncRequest works
226
- // let childInDest = await getFromSpace({ addr: childAddr, space: destSpace });
227
- // iReckon(sir, childInDest.success).asTo('Child is correctly pushed to destination space').isGonnaBeTrue();
228
- // } catch (error: any) {
229
- // console.error(`${lc}[senderCoordinator.sync] FULL ERROR:`, error.stack || error.message || error);
230
- // // Will fail initially because handleIncomingSyncRequest is not implemented
231
- // iReckon(sir, false).asTo(`Unexpected error: ${extractErrorMsg(error)}`).isGonnaBeTrue();
232
- // }
233
- // });
234
- // await respecfully(sir, `Real Sync via Local HTTP/2 Node Adapter with Self-Signed Certs`, async () => {
235
- // // 1. Generate Self-Signed Certs via OpenSSL or PowerShell
236
- // const tmpDir = path.join(process.cwd(), 'tmp-certs');
237
- // const keyPath = path.join(tmpDir, 'server.key');
238
- // const certPath = path.join(tmpDir, 'server.cert');
239
- // const pfxPath = path.join(tmpDir, 'server.pfx');
240
- // let hasTlsGenerator = false;
241
- // let isWin = process.platform === 'win32';
242
- // if (isWin) {
243
- // hasTlsGenerator = true;
244
- // } else {
245
- // try {
246
- // cp.execSync('openssl version', { stdio: 'ignore' });
247
- // hasTlsGenerator = true;
248
- // } catch (e) {
249
- // console.warn(`${lc} OpenSSL not found in PATH. Skipping HTTP/2 Native test.`);
250
- // }
251
- // }
252
- // if (hasTlsGenerator) {
253
- // if (!fs.existsSync(tmpDir)) { fs.mkdirSync(tmpDir, { recursive: true }); }
254
- // let keyInfo: Buffer | undefined;
255
- // let certInfo: Buffer | undefined;
256
- // let pfxInfo: Buffer | undefined;
257
- // if (isWin) {
258
- // if (!fs.existsSync(pfxPath)) {
259
- // if (logalot) { console.log(`${lc} Generating self-signed cert via PowerShell...`); }
260
- // const psScript = `
261
- // $cert = New-SelfSignedCertificate -CertStoreLocation "Cert:\\CurrentUser\\My" -Subject "localhost" -KeyExportPolicy Exportable -NotAfter (Get-Date).AddDays(1)
262
- // $pwd = ConvertTo-SecureString -String "testpass" -Force -AsPlainText
263
- // Export-PfxCertificate -Cert $cert -FilePath "${pfxPath.replace(/\\/g, '\\\\')}" -Password $pwd
264
- // Remove-Item -Path $cert.PSPath
265
- // `;
266
- // cp.execSync(`powershell -Command "${psScript.replace(/\n/g, '; ')}"`, { stdio: 'ignore' });
267
- // }
268
- // pfxInfo = fs.readFileSync(pfxPath);
269
- // } else {
270
- // if (!fs.existsSync(keyPath) || !fs.existsSync(certPath)) {
271
- // if (logalot) { console.log(`${lc} Generating self-signed cert...`); }
272
- // cp.execSync(`openssl req -x509 -newkey rsa:2048 -nodes -keyout ${keyPath} -out ${certPath} -days 1 -subj "/CN=localhost"`, { stdio: 'ignore' });
273
- // }
274
- // keyInfo = fs.readFileSync(keyPath);
275
- // certInfo = fs.readFileSync(certPath);
276
- // }
277
- // // Bypass self-signed cert rejection in Node fetch
278
- // process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';
279
- // // 2. Setup Spaces
280
- // metaspace = new Metaspace_Innerspace(undefined);
281
- // await metaspace.initialize({
282
- // getFnAlert: () => async () => { },
283
- // getFnPrompt: () => async () => '',
284
- // getFnPromptPassword: () => async () => null,
285
- // });
286
- // while (!metaspace.initialized) { await delay(10); }
287
- // const defaultLocalUserSpace = await metaspace.getLocalUserSpace({ lock: false });
288
- // await defaultLocalUserSpace?.initialized;
289
- // sourceSpace = new InnerSpace_V1({ ...DEFAULT_INNER_SPACE_DATA_V1, name: 'source_h2', uuid: 'source_h2_uuid' });
290
- // await sourceSpace.initialized;
291
- // destSpace = new InnerSpace_V1({ ...DEFAULT_INNER_SPACE_DATA_V1, name: 'dest_h2', uuid: 'dest_h2_uuid' });
292
- // await destSpace.initialized;
293
- // // 3. Setup Node Adapter & Receiver
294
- // const mockKeystone = await getTestKeystoneServiceHelper();
295
- // const receiverCoordinator = new SyncSagaCoordinator(mockKeystone);
296
- // const receiverPeer = new SyncPeerHttpReceiver_V1({ classname: SyncPeerHttpReceiver_V1.name });
297
- // await receiverPeer.initialized;
298
- // await receiverPeer.initializeOpts({
299
- // localCoordinator: receiverCoordinator,
300
- // localMetaspace: metaspace,
301
- // localSpace: destSpace,
302
- // keystoneSvc: mockKeystone
303
- // });
304
- // const port = 8443;
305
- // const adapter = new SyncHttpNodeAdapter_V1({
306
- // receiverPeer,
307
- // port,
308
- // key: keyInfo,
309
- // cert: certInfo,
310
- // pfx: pfxInfo,
311
- // passphrase: 'testpass',
312
- // basePath: '/sync'
313
- // });
314
- // await adapter.start();
315
- // // 4. Test the Adapter Connection
316
- // if (logalot) { console.log(`${lc} Pinging the HTTP/2 Adapter via POST...`); }
317
- // // Create a dummy context structure just to appease the parser and prove connection success
318
- // const testContext: any = { classname: 'SyncSagaContextIbGib_V1', rel8ns: {}, data: {} };
319
- // const payloadBody = JSON.stringify({ context: testContext, payloadIbGibsControl: [] });
320
- // try {
321
- // const res = await fetch(`https://localhost:${port}/sync/frame`, {
322
- // method: 'POST',
323
- // headers: { 'Content-Type': 'application/json', 'x-client-id': 'test-123' },
324
- // body: payloadBody
325
- // });
326
- // await ifWe(sir, 'check http2 adapter', async () => {
327
- // iReckon(sir, res.ok).asTo('Successfully reached HTTP/2 Adapter via POST').isGonnaBeTrue();
328
- // });
329
- // // The receiver peer inside the adapter will throw a normal logged warning about invalid saga formats from our dummy context,
330
- // // but the HTTP transport should respond 200 OK, verifying the http2 server is cleanly bound!
331
- // } catch (err) {
332
- // console.error(`${lc} HTTP/2 test failed:`, err);
333
- // iReckon(sir, false).asTo('HTTP/2 Adapter POST should not throw').isGonnaBeTrue();
334
- // } finally {
335
- // await adapter.stop();
336
- // }
337
- // }
338
- // });
339
- // });
340
- //# sourceMappingURL=sync-peer-http.respec.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"sync-peer-http.respec.mjs","sourceRoot":"","sources":["../../../src/sync/sync-peer/sync-peer-http.respec.mts"],"names":[],"mappings":"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"}
@@ -1,42 +0,0 @@
1
- /**
2
- * @module node-filesystem-space-helper
3
- *
4
- */
5
- import { NodeFilesystemSpace_V1 } from './node-filesystem-space-v1.mjs';
6
- import { FileDataInfo, FileEncoding } from './node-filesystem-space-types.mjs';
7
- /**
8
- * tries to read the given path. if fails **FOR ANY REASON**, @returns `null`.
9
- *
10
- * does not throw
11
- *
12
- * @returns file contents as string or `null`
13
- */
14
- export declare function tryRead({ path, directory, encoding, }: {
15
- path: string;
16
- directory: string;
17
- encoding: string;
18
- }): Promise<string | Uint8Array | null>;
19
- export declare function tryRead_bin({ path, directory, encoding, }: {
20
- path: string;
21
- directory: string;
22
- encoding: string;
23
- }): Promise<FileDataInfo | null>;
24
- /**
25
- * basic validation for a node fs space ibgib
26
- */
27
- export declare function validateNodeFilesystemSpace_V1Intrinsically({ space }: {
28
- space: NodeFilesystemSpace_V1<any, any>;
29
- }): Promise<string[] | null>;
30
- /**
31
- * gets the data and encoding of a given {@link inputPath} if that file exists.
32
- * if it doesn't exist, this will throw an ENOENT error, but this is not logged
33
- * as an error.
34
- *
35
- * this is because atow (03/2024) this is only used in a tryRead_bin function
36
- * where the file often does not exist.
37
- */
38
- export declare function getFileDataAndEncoding({ inputPath, encodingsToTry, }: {
39
- inputPath: string;
40
- encodingsToTry?: (FileEncoding | undefined)[];
41
- }): Promise<FileDataInfo>;
42
- //# sourceMappingURL=node-filesystem-space-helper.d.mts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"node-filesystem-space-helper.d.mts","sourceRoot":"","sources":["../../../../../src/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-helper.mts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAkD,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAK/H;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,EAC1B,IAAI,EACJ,SAAS,EACT,QAAQ,GACX,EAAE;IACC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC,CA2BtC;AAED,wBAAsB,WAAW,CAAC,EAC9B,IAAI,EACJ,SAAS,EACT,QAAQ,GACX,EAAE;IACC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAuC/B;AAED;;GAEG;AACH,wBAAsB,2CAA2C,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAyFlJ;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,EACzC,SAAS,EACT,cAA+C,GAClD,EAAE;IACC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,CAAC,YAAY,GAAG,SAAS,CAAC,EAAE,CAAC;CACjD,GAAG,OAAO,CAAC,YAAY,CAAC,CAwExB"}