@peers-app/peers-sdk 0.27.3 → 0.27.4

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 (258) hide show
  1. package/dist/contracts/contract-proxy.d.ts +7 -0
  2. package/dist/contracts/contract-proxy.js +19 -2
  3. package/dist/contracts/create-local-consumer.js +16 -1
  4. package/dist/contracts/index.d.ts +2 -0
  5. package/dist/contracts/index.js +2 -0
  6. package/dist/contracts/system/index.d.ts +2 -0
  7. package/dist/contracts/system/index.js +2 -0
  8. package/dist/contracts/system/invites-contract.js +2 -1
  9. package/dist/contracts/system/sync-check-contract.d.ts +97 -0
  10. package/dist/contracts/system/sync-check-contract.js +115 -0
  11. package/dist/contracts/tool-arguments.d.ts +15 -0
  12. package/dist/contracts/tool-arguments.js +41 -0
  13. package/dist/contracts/tool-catalog-service.js +2 -12
  14. package/dist/data/change-tracking.d.ts +40 -0
  15. package/dist/data/change-tracking.js +89 -0
  16. package/dist/data/orm/types.d.ts +24 -7
  17. package/dist/data/orm/types.js +97 -24
  18. package/dist/define/manifest.js +6 -34
  19. package/dist/package-loader/package-loader.js +27 -22
  20. package/dist/system-ids.d.ts +5 -0
  21. package/dist/system-ids.js +6 -1
  22. package/package.json +4 -2
  23. package/dist/context/user-context-identity.test.d.ts +0 -1
  24. package/dist/context/user-context-identity.test.js +0 -220
  25. package/dist/contracts/__tests__/action-dispatch.test.d.ts +0 -1
  26. package/dist/contracts/__tests__/action-dispatch.test.js +0 -319
  27. package/dist/contracts/__tests__/also-implements.test.d.ts +0 -1
  28. package/dist/contracts/__tests__/also-implements.test.js +0 -110
  29. package/dist/contracts/__tests__/builder.test.d.ts +0 -1
  30. package/dist/contracts/__tests__/builder.test.js +0 -669
  31. package/dist/contracts/__tests__/contract-events.test.d.ts +0 -1
  32. package/dist/contracts/__tests__/contract-events.test.js +0 -199
  33. package/dist/contracts/__tests__/contract-observables.test.d.ts +0 -1
  34. package/dist/contracts/__tests__/contract-observables.test.js +0 -290
  35. package/dist/contracts/__tests__/contract-provider-router.test.d.ts +0 -1
  36. package/dist/contracts/__tests__/contract-provider-router.test.js +0 -315
  37. package/dist/contracts/__tests__/contract-proxy.test.d.ts +0 -1
  38. package/dist/contracts/__tests__/contract-proxy.test.js +0 -657
  39. package/dist/contracts/__tests__/contract-resolvers.test.d.ts +0 -1
  40. package/dist/contracts/__tests__/contract-resolvers.test.js +0 -758
  41. package/dist/contracts/__tests__/contract-subscription-lifecycle.test.d.ts +0 -1
  42. package/dist/contracts/__tests__/contract-subscription-lifecycle.test.js +0 -353
  43. package/dist/contracts/__tests__/contract-table-events.test.d.ts +0 -1
  44. package/dist/contracts/__tests__/contract-table-events.test.js +0 -209
  45. package/dist/contracts/__tests__/contract-transport.test.d.ts +0 -1
  46. package/dist/contracts/__tests__/contract-transport.test.js +0 -163
  47. package/dist/contracts/__tests__/extract.test.d.ts +0 -1
  48. package/dist/contracts/__tests__/extract.test.js +0 -145
  49. package/dist/contracts/__tests__/frozen-contracts.test.d.ts +0 -1
  50. package/dist/contracts/__tests__/frozen-contracts.test.js +0 -191
  51. package/dist/contracts/__tests__/generic-tool-dispatch.test.d.ts +0 -1
  52. package/dist/contracts/__tests__/generic-tool-dispatch.test.js +0 -130
  53. package/dist/contracts/__tests__/host-contract-client.test.d.ts +0 -1
  54. package/dist/contracts/__tests__/host-contract-client.test.js +0 -793
  55. package/dist/contracts/__tests__/host-contract-consumer.test.d.ts +0 -1
  56. package/dist/contracts/__tests__/host-contract-consumer.test.js +0 -163
  57. package/dist/contracts/__tests__/host-contract-transport.test.d.ts +0 -1
  58. package/dist/contracts/__tests__/host-contract-transport.test.js +0 -66
  59. package/dist/contracts/__tests__/integration.test.d.ts +0 -1
  60. package/dist/contracts/__tests__/integration.test.js +0 -348
  61. package/dist/contracts/__tests__/legacy-removal.test.d.ts +0 -1
  62. package/dist/contracts/__tests__/legacy-removal.test.js +0 -128
  63. package/dist/contracts/__tests__/persistent-registry.test.d.ts +0 -1
  64. package/dist/contracts/__tests__/persistent-registry.test.js +0 -109
  65. package/dist/contracts/__tests__/playground.test.d.ts +0 -1
  66. package/dist/contracts/__tests__/playground.test.js +0 -216
  67. package/dist/contracts/__tests__/registry.test.d.ts +0 -1
  68. package/dist/contracts/__tests__/registry.test.js +0 -238
  69. package/dist/contracts/__tests__/remote-contract-transport.test.d.ts +0 -1
  70. package/dist/contracts/__tests__/remote-contract-transport.test.js +0 -119
  71. package/dist/contracts/__tests__/system-contracts.test.d.ts +0 -1
  72. package/dist/contracts/__tests__/system-contracts.test.js +0 -247
  73. package/dist/contracts/__tests__/target-dispatch.d.ts +0 -11
  74. package/dist/contracts/__tests__/target-dispatch.js +0 -24
  75. package/dist/contracts/__tests__/tool-catalog-inventory.test.d.ts +0 -1
  76. package/dist/contracts/__tests__/tool-catalog-inventory.test.js +0 -44
  77. package/dist/contracts/__tests__/tool-catalog-service.test.d.ts +0 -1
  78. package/dist/contracts/__tests__/tool-catalog-service.test.js +0 -482
  79. package/dist/contracts/__tests__/tool-catalog.test.d.ts +0 -1
  80. package/dist/contracts/__tests__/tool-catalog.test.js +0 -1199
  81. package/dist/contracts/__tests__/validate.test.d.ts +0 -1
  82. package/dist/contracts/__tests__/validate.test.js +0 -991
  83. package/dist/contracts/__tests__/workflow-context.test.d.ts +0 -1
  84. package/dist/contracts/__tests__/workflow-context.test.js +0 -50
  85. package/dist/data/access-level.test.d.ts +0 -1
  86. package/dist/data/access-level.test.js +0 -53
  87. package/dist/data/change-tracking.test.d.ts +0 -1
  88. package/dist/data/change-tracking.test.js +0 -62
  89. package/dist/data/files/files.test.d.ts +0 -1
  90. package/dist/data/files/files.test.js +0 -770
  91. package/dist/data/group-members.test.d.ts +0 -1
  92. package/dist/data/group-members.test.js +0 -336
  93. package/dist/data/group-share.test.d.ts +0 -1
  94. package/dist/data/group-share.test.js +0 -110
  95. package/dist/data/groups.test.d.ts +0 -1
  96. package/dist/data/groups.test.js +0 -153
  97. package/dist/data/orm/cursor.test.d.ts +0 -1
  98. package/dist/data/orm/cursor.test.js +0 -314
  99. package/dist/data/orm/data-query.mongo.test.d.ts +0 -1
  100. package/dist/data/orm/data-query.mongo.test.js +0 -367
  101. package/dist/data/orm/data-query.sqlite.test.d.ts +0 -1
  102. package/dist/data/orm/data-query.sqlite.test.js +0 -365
  103. package/dist/data/orm/data-query.test.d.ts +0 -1
  104. package/dist/data/orm/data-query.test.js +0 -545
  105. package/dist/data/orm/dependency-injection.test.d.ts +0 -1
  106. package/dist/data/orm/dependency-injection.test.js +0 -171
  107. package/dist/data/orm/event-registry.test.d.ts +0 -1
  108. package/dist/data/orm/event-registry.test.js +0 -44
  109. package/dist/data/orm/multi-cursors.test.d.ts +0 -1
  110. package/dist/data/orm/multi-cursors.test.js +0 -463
  111. package/dist/data/orm/sql.data-source.test.d.ts +0 -1
  112. package/dist/data/orm/sql.data-source.test.js +0 -731
  113. package/dist/data/orm/table-container-events.test.d.ts +0 -1
  114. package/dist/data/orm/table-container-events.test.js +0 -101
  115. package/dist/data/orm/table-container.test.d.ts +0 -1
  116. package/dist/data/orm/table-container.test.js +0 -273
  117. package/dist/data/orm/table.event-source.test.d.ts +0 -1
  118. package/dist/data/orm/table.event-source.test.js +0 -331
  119. package/dist/data/orm/types.test.d.ts +0 -1
  120. package/dist/data/orm/types.test.js +0 -409
  121. package/dist/data/package-table-identity.test.d.ts +0 -1
  122. package/dist/data/package-table-identity.test.js +0 -46
  123. package/dist/data/package-version-permissions.test.d.ts +0 -1
  124. package/dist/data/package-version-permissions.test.js +0 -107
  125. package/dist/data/package-version-resolver.test.d.ts +0 -4
  126. package/dist/data/package-version-resolver.test.js +0 -543
  127. package/dist/data/package-versions.test.d.ts +0 -1
  128. package/dist/data/package-versions.test.js +0 -227
  129. package/dist/data/persistent-vars.conflict.test.d.ts +0 -1
  130. package/dist/data/persistent-vars.conflict.test.js +0 -126
  131. package/dist/data/persistent-vars.migration.test.d.ts +0 -1
  132. package/dist/data/persistent-vars.migration.test.js +0 -133
  133. package/dist/data/persistent-vars.package-scope.test.d.ts +0 -1
  134. package/dist/data/persistent-vars.package-scope.test.js +0 -27
  135. package/dist/data/sync-recovery-queue.test.d.ts +0 -1
  136. package/dist/data/sync-recovery-queue.test.js +0 -215
  137. package/dist/data/table-signing.test.d.ts +0 -1
  138. package/dist/data/table-signing.test.js +0 -118
  139. package/dist/data/tool-access.test.d.ts +0 -1
  140. package/dist/data/tool-access.test.js +0 -166
  141. package/dist/data/user-permissions.test.d.ts +0 -1
  142. package/dist/data/user-permissions.test.js +0 -305
  143. package/dist/data/user-trust-levels.test.d.ts +0 -1
  144. package/dist/data/user-trust-levels.test.js +0 -37
  145. package/dist/define/also-implements.test.d.ts +0 -1
  146. package/dist/define/also-implements.test.js +0 -123
  147. package/dist/define/declare-contract.test.d.ts +0 -1
  148. package/dist/define/declare-contract.test.js +0 -573
  149. package/dist/define/define.test.d.ts +0 -1
  150. package/dist/define/define.test.js +0 -1010
  151. package/dist/define/empty-fields.test.d.ts +0 -1
  152. package/dist/define/empty-fields.test.js +0 -55
  153. package/dist/define/events-observables.test.d.ts +0 -1
  154. package/dist/define/events-observables.test.js +0 -1013
  155. package/dist/define/serve-members.test.d.ts +0 -1
  156. package/dist/define/serve-members.test.js +0 -630
  157. package/dist/define/vars.test.d.ts +0 -1
  158. package/dist/define/vars.test.js +0 -39
  159. package/dist/device/binary-peer-connection-v2.test.d.ts +0 -1
  160. package/dist/device/binary-peer-connection-v2.test.js +0 -730
  161. package/dist/device/binary-peer-connection.test.d.ts +0 -1
  162. package/dist/device/binary-peer-connection.test.js +0 -184
  163. package/dist/device/connection.test.d.ts +0 -1
  164. package/dist/device/connection.test.js +0 -613
  165. package/dist/device/device-election.test.d.ts +0 -1
  166. package/dist/device/device-election.test.js +0 -516
  167. package/dist/device/device.test.d.ts +0 -1
  168. package/dist/device/device.test.js +0 -243
  169. package/dist/device/frame-cipher.test.d.ts +0 -1
  170. package/dist/device/frame-cipher.test.js +0 -219
  171. package/dist/device/get-trust-level-fn.test.d.ts +0 -1
  172. package/dist/device/get-trust-level-fn.test.js +0 -685
  173. package/dist/device/streamed-socket.test.d.ts +0 -1
  174. package/dist/device/streamed-socket.test.js +0 -216
  175. package/dist/device/tx-encoding.test.d.ts +0 -1
  176. package/dist/device/tx-encoding.test.js +0 -295
  177. package/dist/device-pairing/cpace.test.d.ts +0 -1
  178. package/dist/device-pairing/cpace.test.js +0 -116
  179. package/dist/device-pairing/device-pairing.test.d.ts +0 -1
  180. package/dist/device-pairing/device-pairing.test.js +0 -211
  181. package/dist/hlc.test.d.ts +0 -1
  182. package/dist/hlc.test.js +0 -45
  183. package/dist/host-credentials.test.d.ts +0 -1
  184. package/dist/host-credentials.test.js +0 -88
  185. package/dist/identity/account-email.test.d.ts +0 -1
  186. package/dist/identity/account-email.test.js +0 -59
  187. package/dist/identity/anchor-document.test.d.ts +0 -1
  188. package/dist/identity/anchor-document.test.js +0 -16
  189. package/dist/identity/anchor-resolution.test.d.ts +0 -1
  190. package/dist/identity/anchor-resolution.test.js +0 -130
  191. package/dist/identity/key-change.test.d.ts +0 -1
  192. package/dist/identity/key-change.test.js +0 -811
  193. package/dist/invites/group-approval.test.d.ts +0 -1
  194. package/dist/invites/group-approval.test.js +0 -223
  195. package/dist/invites/invite-token.test.d.ts +0 -1
  196. package/dist/invites/invite-token.test.js +0 -123
  197. package/dist/keys.test.d.ts +0 -1
  198. package/dist/keys.test.js +0 -336
  199. package/dist/logging/console-logger.test.d.ts +0 -1
  200. package/dist/logging/console-logger.test.js +0 -300
  201. package/dist/logging/console-logs.table.test.d.ts +0 -1
  202. package/dist/logging/console-logs.table.test.js +0 -156
  203. package/dist/observable.test.d.ts +0 -1
  204. package/dist/observable.test.js +0 -309
  205. package/dist/package-build/build-package.test.d.ts +0 -1
  206. package/dist/package-build/build-package.test.js +0 -204
  207. package/dist/package-build/contract-add.test.d.ts +0 -1
  208. package/dist/package-build/contract-add.test.js +0 -467
  209. package/dist/package-build/freeze-contracts.test.d.ts +0 -1
  210. package/dist/package-build/freeze-contracts.test.js +0 -355
  211. package/dist/package-installer/package-author-signing.test.d.ts +0 -1
  212. package/dist/package-installer/package-author-signing.test.js +0 -200
  213. package/dist/package-installer/package-cloner.test.d.ts +0 -1
  214. package/dist/package-installer/package-cloner.test.js +0 -278
  215. package/dist/package-installer/package-creator.test.d.ts +0 -1
  216. package/dist/package-installer/package-creator.test.js +0 -908
  217. package/dist/package-installer/package-dev-tools.test.d.ts +0 -1
  218. package/dist/package-installer/package-dev-tools.test.js +0 -64
  219. package/dist/package-installer/package-installer.test.d.ts +0 -1
  220. package/dist/package-installer/package-installer.test.js +0 -882
  221. package/dist/package-installer/package-propagation.test.d.ts +0 -1
  222. package/dist/package-installer/package-propagation.test.js +0 -1269
  223. package/dist/package-installer/package-publisher.test.d.ts +0 -1
  224. package/dist/package-installer/package-publisher.test.js +0 -153
  225. package/dist/package-installer/package-remote-checker.test.d.ts +0 -1
  226. package/dist/package-installer/package-remote-checker.test.js +0 -334
  227. package/dist/package-installer/package-seed-installer.test.d.ts +0 -1
  228. package/dist/package-installer/package-seed-installer.test.js +0 -123
  229. package/dist/package-installer/package-tarball.test.d.ts +0 -1
  230. package/dist/package-installer/package-tarball.test.js +0 -75
  231. package/dist/package-installer/peers-core-installer.test.d.ts +0 -1
  232. package/dist/package-installer/peers-core-installer.test.js +0 -49
  233. package/dist/package-installer/peers-core-trust-anchor.test.d.ts +0 -1
  234. package/dist/package-installer/peers-core-trust-anchor.test.js +0 -155
  235. package/dist/package-loader/contract-package-loader.test.d.ts +0 -1
  236. package/dist/package-loader/contract-package-loader.test.js +0 -274
  237. package/dist/package-loader/host-authority-loading.test.d.ts +0 -1
  238. package/dist/package-loader/host-authority-loading.test.js +0 -104
  239. package/dist/package-loader/host-dispatch-policy.test.d.ts +0 -1
  240. package/dist/package-loader/host-dispatch-policy.test.js +0 -56
  241. package/dist/package-loader/isolated-artifact.test.d.ts +0 -1
  242. package/dist/package-loader/isolated-artifact.test.js +0 -688
  243. package/dist/package-loader/isolated-persistent-var-gateway.test.d.ts +0 -1
  244. package/dist/package-loader/isolated-persistent-var-gateway.test.js +0 -56
  245. package/dist/package-loader/isolated-table-gateway.test.d.ts +0 -1
  246. package/dist/package-loader/isolated-table-gateway.test.js +0 -633
  247. package/dist/package-loader/package-loader.test.d.ts +0 -1
  248. package/dist/package-loader/package-loader.test.js +0 -1764
  249. package/dist/package-loader/resolve-consumed-contracts.test.d.ts +0 -1
  250. package/dist/package-loader/resolve-consumed-contracts.test.js +0 -166
  251. package/dist/serial-json.compat.test.d.ts +0 -1
  252. package/dist/serial-json.compat.test.js +0 -369
  253. package/dist/serial-json.test.d.ts +0 -1
  254. package/dist/serial-json.test.js +0 -401
  255. package/dist/testing/mock-host-contract.test.d.ts +0 -1
  256. package/dist/testing/mock-host-contract.test.js +0 -782
  257. package/dist/utils.test.d.ts +0 -1
  258. package/dist/utils.test.js +0 -232
@@ -1,163 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- const field_type_1 = require("../../types/field-type");
4
- const contract_transport_1 = require("../contract-transport");
5
- const index_1 = require("../index");
6
- const definition = {
7
- contractId: "hostconsumercontract00001",
8
- version: 1,
9
- devTag: "dev",
10
- name: "Host consumer test",
11
- description: "Exercises hostContractConsumer caching.",
12
- tables: [],
13
- tools: [
14
- {
15
- name: "ping",
16
- usageDescription: "Echo the provider label.",
17
- inputFields: [],
18
- outputFields: [{ name: "label", type: field_type_1.FieldType.string, description: "Provider label." }],
19
- },
20
- ],
21
- observables: [
22
- {
23
- name: "state",
24
- description: "Snapshot withheld until the test releases it.",
25
- valueType: field_type_1.FieldType.object,
26
- writable: false,
27
- },
28
- ],
29
- events: [],
30
- };
31
- function setupHost(label, opts = {}) {
32
- const [consumerTransport, providerTransport] = (0, index_1.inProcessTransportPair)();
33
- let releaseSnapshot;
34
- const snapshot = opts.holdSnapshot
35
- ? new Promise((resolve) => {
36
- releaseSnapshot = resolve;
37
- })
38
- : Promise.resolve({ phase: "idle" });
39
- const calls = [];
40
- providerTransport.on(contract_transport_1.CONTRACT_REQUEST_CHANNEL, (call) => {
41
- calls.push(call);
42
- if (call.member === "observable" && call.operation === "get") {
43
- return snapshot;
44
- }
45
- if (call.member === "tool" && call.name === "ping") {
46
- return { label };
47
- }
48
- return undefined;
49
- });
50
- return {
51
- transport: consumerTransport,
52
- calls,
53
- release: () => releaseSnapshot?.({ phase: "idle" }),
54
- dispose: (0, index_1.registerHostContractTransport)(consumerTransport),
55
- };
56
- }
57
- function waitForCall(host, match) {
58
- return new Promise((resolve, reject) => {
59
- const started = Date.now();
60
- const timer = setInterval(() => {
61
- if (host.calls.some(match)) {
62
- clearInterval(timer);
63
- resolve();
64
- return;
65
- }
66
- if (Date.now() - started > 1000) {
67
- clearInterval(timer);
68
- reject(new Error(`timed out waiting for a host call; saw ${JSON.stringify(host.calls)}`));
69
- }
70
- }, 5);
71
- });
72
- }
73
- describe("hostContractConsumer", () => {
74
- const handles = [];
75
- const hosts = [];
76
- afterEach(() => {
77
- while (handles.length > 0) {
78
- handles.pop()?.dispose();
79
- }
80
- while (hosts.length > 0) {
81
- hosts.pop()?.dispose();
82
- }
83
- });
84
- function open() {
85
- const handle = (0, index_1.hostContractConsumer)(definition, {
86
- dataContextId: async () => "user-context",
87
- });
88
- handles.push(handle);
89
- return handle;
90
- }
91
- it("waits for a transport, then returns the same consumer", async () => {
92
- const handle = open();
93
- const pending = handle.get();
94
- const host = setupHost("first");
95
- hosts.push(host);
96
- const consumer = await pending;
97
- expect(await handle.get()).toBe(consumer);
98
- await expect(consumer.tools.ping()).resolves.toEqual({ label: "first" });
99
- expect(host.calls).toContainEqual(expect.objectContaining({
100
- member: "tool",
101
- name: "ping",
102
- dataContextId: "user-context",
103
- }));
104
- });
105
- it("shares one in-flight load across concurrent callers", async () => {
106
- const host = setupHost("shared");
107
- hosts.push(host);
108
- const handle = open();
109
- const [first, second] = await Promise.all([handle.get(), handle.get()]);
110
- expect(second).toBe(first);
111
- const snapshots = host.calls.filter((call) => call.member === "observable" && call.operation === "get");
112
- expect(snapshots).toHaveLength(1);
113
- });
114
- it("disposes the cached consumer when the transport is replaced", async () => {
115
- const first = setupHost("first");
116
- hosts.push(first);
117
- const handle = open();
118
- const firstConsumer = await handle.get();
119
- const second = setupHost("second");
120
- hosts.push(second);
121
- const secondConsumer = await handle.get();
122
- expect(secondConsumer).not.toBe(firstConsumer);
123
- await expect(firstConsumer.tools.ping()).rejects.toThrow("disposed");
124
- await expect(secondConsumer.tools.ping()).resolves.toEqual({ label: "second" });
125
- });
126
- it("drops an in-flight consumer when the transport changes during load", async () => {
127
- const first = setupHost("first", { holdSnapshot: true });
128
- hosts.push(first);
129
- const handle = open();
130
- const pending = handle.get();
131
- await waitForCall(first, (call) => call.member === "observable" && call.operation === "get");
132
- const second = setupHost("second");
133
- hosts.push(second);
134
- first.release();
135
- const consumer = await pending;
136
- await expect(consumer.tools.ping()).resolves.toEqual({ label: "second" });
137
- await waitForCall(first, (call) => call.operation === "unsubscribe");
138
- });
139
- it("rejects get after dispose and disposes the cached consumer", async () => {
140
- const host = setupHost("first");
141
- hosts.push(host);
142
- const handle = open();
143
- const consumer = await handle.get();
144
- handle.dispose();
145
- handle.dispose();
146
- await expect(consumer.tools.ping()).rejects.toThrow("disposed");
147
- await expect(handle.get()).rejects.toThrow("is disposed");
148
- });
149
- it("rejects when no transport arrives before timeoutMs", async () => {
150
- jest.useFakeTimers();
151
- try {
152
- const handle = (0, index_1.hostContractConsumer)(definition, { timeoutMs: 25 });
153
- handles.push(handle);
154
- const pending = handle.get();
155
- const expectation = expect(pending).rejects.toThrow("Timed out waiting for host contract transport after 25ms");
156
- await jest.advanceTimersByTimeAsync(25);
157
- await expectation;
158
- }
159
- finally {
160
- jest.useRealTimers();
161
- }
162
- });
163
- });
@@ -1,66 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- const index_1 = require("../index");
4
- describe("host contract transport", () => {
5
- const disposers = [];
6
- afterEach(() => {
7
- while (disposers.length > 0) {
8
- disposers.pop()?.();
9
- }
10
- });
11
- it("publishes registration lifecycle and clears the active transport", () => {
12
- const [transport] = (0, index_1.inProcessTransportPair)();
13
- const values = [];
14
- const unsubscribe = (0, index_1.subscribeHostContractTransport)((value) => values.push(value));
15
- const dispose = (0, index_1.registerHostContractTransport)(transport);
16
- disposers.push(dispose);
17
- expect((0, index_1.getHostContractTransport)()).toBe(transport);
18
- dispose();
19
- unsubscribe();
20
- expect((0, index_1.getHostContractTransport)()).toBeUndefined();
21
- expect(values).toEqual([undefined, transport, undefined]);
22
- });
23
- it("does not let a stale registration disposer clear its replacement", () => {
24
- const [first] = (0, index_1.inProcessTransportPair)();
25
- const [second] = (0, index_1.inProcessTransportPair)();
26
- const disposeFirst = (0, index_1.registerHostContractTransport)(first);
27
- const disposeSecond = (0, index_1.registerHostContractTransport)(second);
28
- disposers.push(disposeFirst, disposeSecond);
29
- disposeFirst();
30
- expect((0, index_1.getHostContractTransport)()).toBe(second);
31
- });
32
- it("waits for a transport registered after startup", async () => {
33
- const pending = (0, index_1.waitForHostContractTransport)();
34
- const [transport] = (0, index_1.inProcessTransportPair)();
35
- const dispose = (0, index_1.registerHostContractTransport)(transport);
36
- disposers.push(dispose);
37
- await expect(pending).resolves.toBe(transport);
38
- });
39
- it("cancels waits and clears their deadline", async () => {
40
- jest.useFakeTimers();
41
- try {
42
- const controller = new AbortController();
43
- const pending = (0, index_1.waitForHostContractTransport)({ signal: controller.signal, timeoutMs: 25 });
44
- const rejected = expect(pending).rejects.toThrow("cancelled");
45
- controller.abort(new Error("cancelled"));
46
- await rejected;
47
- expect(jest.getTimerCount()).toBe(0);
48
- await expect((0, index_1.waitForHostContractTransport)({ signal: controller.signal })).rejects.toThrow("cancelled");
49
- }
50
- finally {
51
- jest.useRealTimers();
52
- }
53
- });
54
- it("rejects when no transport arrives before timeoutMs", async () => {
55
- jest.useFakeTimers();
56
- try {
57
- const pending = (0, index_1.waitForHostContractTransport)({ timeoutMs: 25 });
58
- const expectation = expect(pending).rejects.toThrow("Timed out waiting for host contract transport after 25ms");
59
- await jest.advanceTimersByTimeAsync(25);
60
- await expectation;
61
- }
62
- finally {
63
- jest.useRealTimers();
64
- }
65
- });
66
- });
@@ -1 +0,0 @@
1
- export {};
@@ -1,348 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- const zod_1 = require("zod");
4
- const types_1 = require("../../data/orm/types");
5
- const field_type_1 = require("../../types/field-type");
6
- const utils_1 = require("../../utils");
7
- const builder_1 = require("../builder");
8
- const extract_1 = require("../extract");
9
- const registry_1 = require("../registry");
10
- const types_2 = require("../types");
11
- beforeAll(() => {
12
- (0, extract_1.setSchemaToFieldsFn)(types_1.schemaToFields);
13
- });
14
- /**
15
- * End-to-end integration tests that exercise the full flow:
16
- * definePackage -> register in registry -> check dependencies -> resolve -> swap provider.
17
- */
18
- describe("Package Contracts — integration", () => {
19
- let registry;
20
- beforeEach(() => {
21
- registry = new registry_1.ContractRegistry();
22
- });
23
- const TASKS_CONTRACT_ID = (0, utils_1.newid)();
24
- const PROJECTS_CONTRACT_ID = (0, utils_1.newid)();
25
- const FANCY_TASKS_CONTRACT_ID = (0, utils_1.newid)();
26
- function defineTasksPackage() {
27
- return (0, builder_1.definePackage)((pkg) => {
28
- pkg.packageId = (0, utils_1.newid)();
29
- const tasks = pkg.contract(TASKS_CONTRACT_ID, 1, "Tasks");
30
- tasks.tables = [
31
- {
32
- metaData: {
33
- name: "Tasks",
34
- description: "Task management table",
35
- primaryKeyName: "taskId",
36
- fields: [],
37
- },
38
- schema: zod_1.z.object({
39
- taskId: zod_1.z.string().describe("Primary key"),
40
- title: zod_1.z.string().describe("Task title"),
41
- status: zod_1.z.string().describe("Task status"),
42
- sortOrder: zod_1.z.number().describe("Sort order"),
43
- }),
44
- },
45
- ];
46
- tasks.tools = [
47
- {
48
- tool: {
49
- name: "create-task",
50
- usageDescription: "Creates a new task",
51
- inputSchema: {
52
- fields: [
53
- { name: "title", type: field_type_1.FieldType.string, description: "Task title" },
54
- {
55
- name: "status",
56
- type: field_type_1.FieldType.string,
57
- description: "Initial status",
58
- optional: true,
59
- },
60
- ],
61
- },
62
- outputSchema: {
63
- fields: [{ name: "taskId", type: field_type_1.FieldType.id, description: "Created task ID" }],
64
- },
65
- },
66
- },
67
- ];
68
- tasks.observables = [
69
- {
70
- name: "taskCount",
71
- description: "Total task count",
72
- valueType: field_type_1.FieldType.number,
73
- writable: false,
74
- },
75
- ];
76
- });
77
- }
78
- function defineProjectsPackage() {
79
- return (0, builder_1.definePackage)((pkg) => {
80
- pkg.packageId = (0, utils_1.newid)();
81
- pkg.consumes(TASKS_CONTRACT_ID, 1);
82
- const projects = pkg.contract(PROJECTS_CONTRACT_ID, 1, "Projects");
83
- projects.tables = [
84
- {
85
- metaData: {
86
- name: "Projects",
87
- description: "Project management",
88
- primaryKeyName: "projectId",
89
- fields: [],
90
- },
91
- schema: zod_1.z.object({
92
- projectId: zod_1.z.string().describe("PK"),
93
- name: zod_1.z.string().describe("Project name"),
94
- }),
95
- },
96
- ];
97
- });
98
- }
99
- function defineFancyTasksPackage() {
100
- return (0, builder_1.definePackage)((pkg) => {
101
- pkg.packageId = (0, utils_1.newid)();
102
- const fancy = pkg.contract(FANCY_TASKS_CONTRACT_ID, 1, "Fancy Tasks");
103
- fancy.alsoImplements(TASKS_CONTRACT_ID, 1);
104
- fancy.tables = [
105
- {
106
- metaData: {
107
- name: "Tasks",
108
- description: "Enhanced task table",
109
- primaryKeyName: "taskId",
110
- fields: [],
111
- },
112
- schema: zod_1.z.object({
113
- taskId: zod_1.z.string().describe("Primary key"),
114
- title: zod_1.z.string().describe("Task title"),
115
- status: zod_1.z.string().describe("Task status"),
116
- sortOrder: zod_1.z.number().describe("Sort order"),
117
- priority: zod_1.z.number().optional().describe("Priority level"),
118
- tags: zod_1.z.string().array().optional().describe("Tags"),
119
- }),
120
- },
121
- ];
122
- fancy.tools = [
123
- {
124
- tool: {
125
- name: "create-task",
126
- usageDescription: "Creates a fancy task",
127
- inputSchema: {
128
- fields: [
129
- { name: "title", type: field_type_1.FieldType.string, description: "Task title" },
130
- {
131
- name: "status",
132
- type: field_type_1.FieldType.string,
133
- description: "Initial status",
134
- optional: true,
135
- },
136
- {
137
- name: "priority",
138
- type: field_type_1.FieldType.number,
139
- description: "Priority",
140
- optional: true,
141
- },
142
- ],
143
- },
144
- outputSchema: {
145
- fields: [{ name: "taskId", type: field_type_1.FieldType.id, description: "Created task ID" }],
146
- },
147
- },
148
- },
149
- ];
150
- fancy.observables = [
151
- {
152
- name: "taskCount",
153
- description: "Total task count",
154
- valueType: field_type_1.FieldType.number,
155
- writable: false,
156
- },
157
- ];
158
- });
159
- }
160
- it("defines a Tasks package and registers it as a provider", () => {
161
- const tasksPkg = defineTasksPackage();
162
- expect(tasksPkg.contracts).toHaveLength(1);
163
- const pkgId = (0, utils_1.newid)();
164
- const result = registry.register(pkgId, tasksPkg.contracts[0]);
165
- expect(result.valid).toBe(true);
166
- const resolved = registry.resolve(TASKS_CONTRACT_ID, 1);
167
- expect(resolved).toBeDefined();
168
- expect(resolved?.tables[0].name).toBe("Tasks");
169
- expect(resolved?.tools[0].name).toBe("create-task");
170
- expect(resolved?.observables[0].name).toBe("taskCount");
171
- });
172
- it("defines a Projects package that consumes Tasks, and verifies dependencies", () => {
173
- const tasksPkg = defineTasksPackage();
174
- const tasksPkgId = (0, utils_1.newid)();
175
- registry.register(tasksPkgId, tasksPkg.contracts[0]);
176
- const projectsPkg = defineProjectsPackage();
177
- const projectsPkgId = (0, utils_1.newid)();
178
- registry.register(projectsPkgId, projectsPkg.contracts[0]);
179
- // Projects consumes Tasks — check that the dependency is satisfied
180
- const deps = registry.checkConsumerDependencies(projectsPkg.consumes);
181
- expect(deps.satisfied).toHaveLength(1);
182
- expect(deps.satisfied[0].contractId).toBe(TASKS_CONTRACT_ID);
183
- expect(deps.missing).toHaveLength(0);
184
- });
185
- it("rejects Projects installation when Tasks provider is missing", () => {
186
- const projectsPkg = defineProjectsPackage();
187
- const projectsPkgId = (0, utils_1.newid)();
188
- registry.register(projectsPkgId, projectsPkg.contracts[0]);
189
- const deps = registry.checkConsumerDependencies(projectsPkg.consumes);
190
- expect(deps.missing).toHaveLength(1);
191
- expect(deps.missing[0].contractId).toBe(TASKS_CONTRACT_ID);
192
- });
193
- it("FancyTasks provides alsoImplements(tasks:v1) and passes validation", () => {
194
- // Register the original tasks contract first (so alsoImplements can find it)
195
- const tasksPkg = defineTasksPackage();
196
- const tasksPkgId = (0, utils_1.newid)();
197
- registry.register(tasksPkgId, tasksPkg.contracts[0]);
198
- // Now register the fancy tasks package with alsoImplements
199
- const fancyPkg = defineFancyTasksPackage();
200
- const fancyContract = fancyPkg.contracts[0];
201
- const key = (0, types_2.contractKey)(FANCY_TASKS_CONTRACT_ID, 1);
202
- const alsoImpl = fancyPkg.alsoImplements.get(key) ?? [];
203
- const fancyPkgId = (0, utils_1.newid)();
204
- const result = registry.register(fancyPkgId, fancyContract, alsoImpl);
205
- expect(result.valid).toBe(true);
206
- });
207
- it("swaps Tasks provider from original to FancyTasks", () => {
208
- // Register both providers for the tasks contract
209
- const tasksPkg = defineTasksPackage();
210
- const tasksPkgId = (0, utils_1.newid)();
211
- const fancyPkgId = (0, utils_1.newid)();
212
- registry.register(tasksPkgId, tasksPkg.contracts[0]);
213
- // Register FancyTasks as an additional provider for the TASKS contract
214
- const fancyPkg = defineFancyTasksPackage();
215
- const fancyContract = fancyPkg.contracts[0];
216
- // Register the fancy tasks contract under its own ID
217
- const key = (0, types_2.contractKey)(FANCY_TASKS_CONTRACT_ID, 1);
218
- const alsoImpl = fancyPkg.alsoImplements.get(key) ?? [];
219
- registry.register(fancyPkgId, fancyContract, alsoImpl);
220
- // Also register it as a provider for the original tasks contract
221
- registry.register(fancyPkgId, tasksPkg.contracts[0]);
222
- // Verify original is still active
223
- expect(registry.getProviderPackageId(TASKS_CONTRACT_ID, 1)).toBe(tasksPkgId);
224
- // Swap to fancy
225
- const switched = registry.setActiveProvider(TASKS_CONTRACT_ID, 1, fancyPkgId);
226
- expect(switched).toBe(true);
227
- expect(registry.getProviderPackageId(TASKS_CONTRACT_ID, 1)).toBe(fancyPkgId);
228
- // Projects still resolves — it doesn't care which provider is active
229
- const projectsPkg = defineProjectsPackage();
230
- const deps = registry.checkConsumerDependencies(projectsPkg.consumes);
231
- expect(deps.satisfied).toHaveLength(1);
232
- expect(deps.missing).toHaveLength(0);
233
- });
234
- it("removing the active provider falls back to the alternative", () => {
235
- const tasksPkg = defineTasksPackage();
236
- const tasksPkgId = (0, utils_1.newid)();
237
- const backupPkgId = (0, utils_1.newid)();
238
- registry.register(tasksPkgId, tasksPkg.contracts[0]);
239
- registry.register(backupPkgId, tasksPkg.contracts[0]);
240
- expect(registry.getProviderPackageId(TASKS_CONTRACT_ID, 1)).toBe(tasksPkgId);
241
- registry.unregister(tasksPkgId);
242
- expect(registry.getProviderPackageId(TASKS_CONTRACT_ID, 1)).toBe(backupPkgId);
243
- // Consumer dependency still satisfied
244
- const projectsPkg = defineProjectsPackage();
245
- const deps = registry.checkConsumerDependencies(projectsPkg.consumes);
246
- expect(deps.missing).toHaveLength(0);
247
- });
248
- it("removing the only provider makes consumer dependencies unsatisfied", () => {
249
- const tasksPkg = defineTasksPackage();
250
- const tasksPkgId = (0, utils_1.newid)();
251
- registry.register(tasksPkgId, tasksPkg.contracts[0]);
252
- const projectsPkg = defineProjectsPackage();
253
- // Satisfied before removal
254
- let deps = registry.checkConsumerDependencies(projectsPkg.consumes);
255
- expect(deps.missing).toHaveLength(0);
256
- registry.unregister(tasksPkgId);
257
- // Now unsatisfied
258
- deps = registry.checkConsumerDependencies(projectsPkg.consumes);
259
- expect(deps.missing).toHaveLength(1);
260
- });
261
- it("FancyTasks alsoImplements validation fails when it is missing an observable", () => {
262
- // Register original tasks with an observable
263
- const tasksPkg = defineTasksPackage();
264
- const tasksPkgId = (0, utils_1.newid)();
265
- registry.register(tasksPkgId, tasksPkg.contracts[0]);
266
- // Define a broken fancy tasks that is missing the taskCount observable
267
- const brokenFancy = (0, builder_1.definePackage)((pkg) => {
268
- pkg.packageId = (0, utils_1.newid)();
269
- const fancy = pkg.contract(FANCY_TASKS_CONTRACT_ID, 1, "Broken Fancy Tasks");
270
- fancy.alsoImplements(TASKS_CONTRACT_ID, 1);
271
- fancy.tables = [
272
- {
273
- metaData: {
274
- name: "Tasks",
275
- description: "d",
276
- primaryKeyName: "taskId",
277
- fields: [],
278
- },
279
- schema: zod_1.z.object({
280
- taskId: zod_1.z.string().describe("PK"),
281
- title: zod_1.z.string().describe("Title"),
282
- status: zod_1.z.string().describe("Status"),
283
- sortOrder: zod_1.z.number().describe("Sort"),
284
- }),
285
- },
286
- ];
287
- fancy.tools = [
288
- {
289
- tool: {
290
- name: "create-task",
291
- usageDescription: "Creates a task",
292
- inputSchema: {
293
- fields: [
294
- { name: "title", type: field_type_1.FieldType.string, description: "Title" },
295
- { name: "status", type: field_type_1.FieldType.string, description: "Status", optional: true },
296
- ],
297
- },
298
- outputSchema: {
299
- fields: [{ name: "taskId", type: field_type_1.FieldType.id, description: "ID" }],
300
- },
301
- },
302
- },
303
- ];
304
- // Deliberately omit observables
305
- });
306
- const brokenContract = brokenFancy.contracts[0];
307
- const key = (0, types_2.contractKey)(FANCY_TASKS_CONTRACT_ID, 1);
308
- const alsoImpl = brokenFancy.alsoImplements.get(key) ?? [];
309
- const brokenPkgId = (0, utils_1.newid)();
310
- const result = registry.register(brokenPkgId, brokenContract, alsoImpl);
311
- expect(result.valid).toBe(false);
312
- expect(result.errors.some((e) => e.message.includes("taskCount"))).toBe(true);
313
- });
314
- it("full lifecycle: define, register, consume, upgrade, swap, remove", () => {
315
- const tasksPkgId = (0, utils_1.newid)();
316
- const projectsPkgId = (0, utils_1.newid)();
317
- const fancyPkgId = (0, utils_1.newid)();
318
- // 1. Register Tasks v1
319
- const tasksPkg = defineTasksPackage();
320
- registry.register(tasksPkgId, tasksPkg.contracts[0]);
321
- // 2. Register Projects (consumes tasks:v1)
322
- const projectsPkg = defineProjectsPackage();
323
- registry.register(projectsPkgId, projectsPkg.contracts[0]);
324
- let deps = registry.checkConsumerDependencies(projectsPkg.consumes);
325
- expect(deps.missing).toHaveLength(0);
326
- // 3. Register FancyTasks (provides its own contract + alsoImplements tasks:v1)
327
- const fancyPkg = defineFancyTasksPackage();
328
- const fancyKey = (0, types_2.contractKey)(FANCY_TASKS_CONTRACT_ID, 1);
329
- registry.register(fancyPkgId, fancyPkg.contracts[0], fancyPkg.alsoImplements.get(fancyKey) ?? []);
330
- // 4. Also register FancyTasks as a provider of the original tasks contract
331
- registry.register(fancyPkgId, tasksPkg.contracts[0]);
332
- // 5. Swap tasks:v1 active provider to FancyTasks
333
- registry.setActiveProvider(TASKS_CONTRACT_ID, 1, fancyPkgId);
334
- expect(registry.getProviderPackageId(TASKS_CONTRACT_ID, 1)).toBe(fancyPkgId);
335
- // 6. Projects' dependencies still satisfied
336
- deps = registry.checkConsumerDependencies(projectsPkg.consumes);
337
- expect(deps.missing).toHaveLength(0);
338
- // 7. Remove original tasks package — fancy is still providing
339
- registry.unregister(tasksPkgId);
340
- deps = registry.checkConsumerDependencies(projectsPkg.consumes);
341
- expect(deps.missing).toHaveLength(0);
342
- expect(registry.getProviderPackageId(TASKS_CONTRACT_ID, 1)).toBe(fancyPkgId);
343
- // 8. Remove fancy — now projects' dependency is unsatisfied
344
- registry.unregister(fancyPkgId);
345
- deps = registry.checkConsumerDependencies(projectsPkg.consumes);
346
- expect(deps.missing).toHaveLength(1);
347
- });
348
- });
@@ -1 +0,0 @@
1
- export {};