@peers-app/peers-sdk 0.27.3 → 0.27.5

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 (272) 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/contract-transport.d.ts +2 -1
  4. package/dist/contracts/contract-transport.js +24 -2
  5. package/dist/contracts/create-local-consumer.js +16 -1
  6. package/dist/contracts/index.d.ts +2 -0
  7. package/dist/contracts/index.js +2 -0
  8. package/dist/contracts/system/index.d.ts +2 -0
  9. package/dist/contracts/system/index.js +2 -0
  10. package/dist/contracts/system/invites-contract.js +2 -1
  11. package/dist/contracts/system/sync-check-contract.d.ts +97 -0
  12. package/dist/contracts/system/sync-check-contract.js +115 -0
  13. package/dist/contracts/tool-arguments.d.ts +15 -0
  14. package/dist/contracts/tool-arguments.js +41 -0
  15. package/dist/contracts/tool-catalog-service.js +2 -12
  16. package/dist/contracts/tool-catalog.js +6 -2
  17. package/dist/data/change-tracking.d.ts +40 -0
  18. package/dist/data/change-tracking.js +89 -0
  19. package/dist/data/orm/types.d.ts +24 -7
  20. package/dist/data/orm/types.js +97 -24
  21. package/dist/define/manifest.js +6 -34
  22. package/dist/device/binary-peer-connection-v2.d.ts +7 -15
  23. package/dist/device/binary-peer-connection-v2.js +14 -30
  24. package/dist/device/connection.d.ts +34 -43
  25. package/dist/device/connection.js +188 -186
  26. package/dist/device/device.d.ts +1 -8
  27. package/dist/device/device.js +1 -30
  28. package/dist/device/socket.type.d.ts +6 -12
  29. package/dist/package-loader/package-loader.js +27 -22
  30. package/dist/system-ids.d.ts +5 -0
  31. package/dist/system-ids.js +6 -1
  32. package/package.json +4 -2
  33. package/dist/context/user-context-identity.test.d.ts +0 -1
  34. package/dist/context/user-context-identity.test.js +0 -220
  35. package/dist/contracts/__tests__/action-dispatch.test.d.ts +0 -1
  36. package/dist/contracts/__tests__/action-dispatch.test.js +0 -319
  37. package/dist/contracts/__tests__/also-implements.test.d.ts +0 -1
  38. package/dist/contracts/__tests__/also-implements.test.js +0 -110
  39. package/dist/contracts/__tests__/builder.test.d.ts +0 -1
  40. package/dist/contracts/__tests__/builder.test.js +0 -669
  41. package/dist/contracts/__tests__/contract-events.test.d.ts +0 -1
  42. package/dist/contracts/__tests__/contract-events.test.js +0 -199
  43. package/dist/contracts/__tests__/contract-observables.test.d.ts +0 -1
  44. package/dist/contracts/__tests__/contract-observables.test.js +0 -290
  45. package/dist/contracts/__tests__/contract-provider-router.test.d.ts +0 -1
  46. package/dist/contracts/__tests__/contract-provider-router.test.js +0 -315
  47. package/dist/contracts/__tests__/contract-proxy.test.d.ts +0 -1
  48. package/dist/contracts/__tests__/contract-proxy.test.js +0 -657
  49. package/dist/contracts/__tests__/contract-resolvers.test.d.ts +0 -1
  50. package/dist/contracts/__tests__/contract-resolvers.test.js +0 -758
  51. package/dist/contracts/__tests__/contract-subscription-lifecycle.test.d.ts +0 -1
  52. package/dist/contracts/__tests__/contract-subscription-lifecycle.test.js +0 -353
  53. package/dist/contracts/__tests__/contract-table-events.test.d.ts +0 -1
  54. package/dist/contracts/__tests__/contract-table-events.test.js +0 -209
  55. package/dist/contracts/__tests__/contract-transport.test.d.ts +0 -1
  56. package/dist/contracts/__tests__/contract-transport.test.js +0 -163
  57. package/dist/contracts/__tests__/extract.test.d.ts +0 -1
  58. package/dist/contracts/__tests__/extract.test.js +0 -145
  59. package/dist/contracts/__tests__/frozen-contracts.test.d.ts +0 -1
  60. package/dist/contracts/__tests__/frozen-contracts.test.js +0 -191
  61. package/dist/contracts/__tests__/generic-tool-dispatch.test.d.ts +0 -1
  62. package/dist/contracts/__tests__/generic-tool-dispatch.test.js +0 -130
  63. package/dist/contracts/__tests__/host-contract-client.test.d.ts +0 -1
  64. package/dist/contracts/__tests__/host-contract-client.test.js +0 -793
  65. package/dist/contracts/__tests__/host-contract-consumer.test.d.ts +0 -1
  66. package/dist/contracts/__tests__/host-contract-consumer.test.js +0 -163
  67. package/dist/contracts/__tests__/host-contract-transport.test.d.ts +0 -1
  68. package/dist/contracts/__tests__/host-contract-transport.test.js +0 -66
  69. package/dist/contracts/__tests__/integration.test.d.ts +0 -1
  70. package/dist/contracts/__tests__/integration.test.js +0 -348
  71. package/dist/contracts/__tests__/legacy-removal.test.d.ts +0 -1
  72. package/dist/contracts/__tests__/legacy-removal.test.js +0 -128
  73. package/dist/contracts/__tests__/persistent-registry.test.d.ts +0 -1
  74. package/dist/contracts/__tests__/persistent-registry.test.js +0 -109
  75. package/dist/contracts/__tests__/playground.test.d.ts +0 -1
  76. package/dist/contracts/__tests__/playground.test.js +0 -216
  77. package/dist/contracts/__tests__/registry.test.d.ts +0 -1
  78. package/dist/contracts/__tests__/registry.test.js +0 -238
  79. package/dist/contracts/__tests__/remote-contract-transport.test.d.ts +0 -1
  80. package/dist/contracts/__tests__/remote-contract-transport.test.js +0 -119
  81. package/dist/contracts/__tests__/system-contracts.test.d.ts +0 -1
  82. package/dist/contracts/__tests__/system-contracts.test.js +0 -247
  83. package/dist/contracts/__tests__/target-dispatch.d.ts +0 -11
  84. package/dist/contracts/__tests__/target-dispatch.js +0 -24
  85. package/dist/contracts/__tests__/tool-catalog-inventory.test.d.ts +0 -1
  86. package/dist/contracts/__tests__/tool-catalog-inventory.test.js +0 -44
  87. package/dist/contracts/__tests__/tool-catalog-service.test.d.ts +0 -1
  88. package/dist/contracts/__tests__/tool-catalog-service.test.js +0 -482
  89. package/dist/contracts/__tests__/tool-catalog.test.d.ts +0 -1
  90. package/dist/contracts/__tests__/tool-catalog.test.js +0 -1199
  91. package/dist/contracts/__tests__/validate.test.d.ts +0 -1
  92. package/dist/contracts/__tests__/validate.test.js +0 -991
  93. package/dist/contracts/__tests__/workflow-context.test.d.ts +0 -1
  94. package/dist/contracts/__tests__/workflow-context.test.js +0 -50
  95. package/dist/data/access-level.test.d.ts +0 -1
  96. package/dist/data/access-level.test.js +0 -53
  97. package/dist/data/change-tracking.test.d.ts +0 -1
  98. package/dist/data/change-tracking.test.js +0 -62
  99. package/dist/data/files/files.test.d.ts +0 -1
  100. package/dist/data/files/files.test.js +0 -770
  101. package/dist/data/group-members.test.d.ts +0 -1
  102. package/dist/data/group-members.test.js +0 -336
  103. package/dist/data/group-share.test.d.ts +0 -1
  104. package/dist/data/group-share.test.js +0 -110
  105. package/dist/data/groups.test.d.ts +0 -1
  106. package/dist/data/groups.test.js +0 -153
  107. package/dist/data/orm/cursor.test.d.ts +0 -1
  108. package/dist/data/orm/cursor.test.js +0 -314
  109. package/dist/data/orm/data-query.mongo.test.d.ts +0 -1
  110. package/dist/data/orm/data-query.mongo.test.js +0 -367
  111. package/dist/data/orm/data-query.sqlite.test.d.ts +0 -1
  112. package/dist/data/orm/data-query.sqlite.test.js +0 -365
  113. package/dist/data/orm/data-query.test.d.ts +0 -1
  114. package/dist/data/orm/data-query.test.js +0 -545
  115. package/dist/data/orm/dependency-injection.test.d.ts +0 -1
  116. package/dist/data/orm/dependency-injection.test.js +0 -171
  117. package/dist/data/orm/event-registry.test.d.ts +0 -1
  118. package/dist/data/orm/event-registry.test.js +0 -44
  119. package/dist/data/orm/multi-cursors.test.d.ts +0 -1
  120. package/dist/data/orm/multi-cursors.test.js +0 -463
  121. package/dist/data/orm/sql.data-source.test.d.ts +0 -1
  122. package/dist/data/orm/sql.data-source.test.js +0 -731
  123. package/dist/data/orm/table-container-events.test.d.ts +0 -1
  124. package/dist/data/orm/table-container-events.test.js +0 -101
  125. package/dist/data/orm/table-container.test.d.ts +0 -1
  126. package/dist/data/orm/table-container.test.js +0 -273
  127. package/dist/data/orm/table.event-source.test.d.ts +0 -1
  128. package/dist/data/orm/table.event-source.test.js +0 -331
  129. package/dist/data/orm/types.test.d.ts +0 -1
  130. package/dist/data/orm/types.test.js +0 -409
  131. package/dist/data/package-table-identity.test.d.ts +0 -1
  132. package/dist/data/package-table-identity.test.js +0 -46
  133. package/dist/data/package-version-permissions.test.d.ts +0 -1
  134. package/dist/data/package-version-permissions.test.js +0 -107
  135. package/dist/data/package-version-resolver.test.d.ts +0 -4
  136. package/dist/data/package-version-resolver.test.js +0 -543
  137. package/dist/data/package-versions.test.d.ts +0 -1
  138. package/dist/data/package-versions.test.js +0 -227
  139. package/dist/data/persistent-vars.conflict.test.d.ts +0 -1
  140. package/dist/data/persistent-vars.conflict.test.js +0 -126
  141. package/dist/data/persistent-vars.migration.test.d.ts +0 -1
  142. package/dist/data/persistent-vars.migration.test.js +0 -133
  143. package/dist/data/persistent-vars.package-scope.test.d.ts +0 -1
  144. package/dist/data/persistent-vars.package-scope.test.js +0 -27
  145. package/dist/data/sync-recovery-queue.test.d.ts +0 -1
  146. package/dist/data/sync-recovery-queue.test.js +0 -215
  147. package/dist/data/table-signing.test.d.ts +0 -1
  148. package/dist/data/table-signing.test.js +0 -118
  149. package/dist/data/tool-access.test.d.ts +0 -1
  150. package/dist/data/tool-access.test.js +0 -166
  151. package/dist/data/user-permissions.test.d.ts +0 -1
  152. package/dist/data/user-permissions.test.js +0 -305
  153. package/dist/data/user-trust-levels.test.d.ts +0 -1
  154. package/dist/data/user-trust-levels.test.js +0 -37
  155. package/dist/define/also-implements.test.d.ts +0 -1
  156. package/dist/define/also-implements.test.js +0 -123
  157. package/dist/define/declare-contract.test.d.ts +0 -1
  158. package/dist/define/declare-contract.test.js +0 -573
  159. package/dist/define/define.test.d.ts +0 -1
  160. package/dist/define/define.test.js +0 -1010
  161. package/dist/define/empty-fields.test.d.ts +0 -1
  162. package/dist/define/empty-fields.test.js +0 -55
  163. package/dist/define/events-observables.test.d.ts +0 -1
  164. package/dist/define/events-observables.test.js +0 -1013
  165. package/dist/define/serve-members.test.d.ts +0 -1
  166. package/dist/define/serve-members.test.js +0 -630
  167. package/dist/define/vars.test.d.ts +0 -1
  168. package/dist/define/vars.test.js +0 -39
  169. package/dist/device/binary-peer-connection-v2.test.d.ts +0 -1
  170. package/dist/device/binary-peer-connection-v2.test.js +0 -730
  171. package/dist/device/binary-peer-connection.d.ts +0 -58
  172. package/dist/device/binary-peer-connection.js +0 -516
  173. package/dist/device/binary-peer-connection.test.d.ts +0 -1
  174. package/dist/device/binary-peer-connection.test.js +0 -184
  175. package/dist/device/connection.test.d.ts +0 -1
  176. package/dist/device/connection.test.js +0 -613
  177. package/dist/device/device-election.test.d.ts +0 -1
  178. package/dist/device/device-election.test.js +0 -516
  179. package/dist/device/device.test.d.ts +0 -1
  180. package/dist/device/device.test.js +0 -243
  181. package/dist/device/frame-cipher.test.d.ts +0 -1
  182. package/dist/device/frame-cipher.test.js +0 -219
  183. package/dist/device/get-trust-level-fn.test.d.ts +0 -1
  184. package/dist/device/get-trust-level-fn.test.js +0 -685
  185. package/dist/device/streamed-socket.d.ts +0 -23
  186. package/dist/device/streamed-socket.js +0 -255
  187. package/dist/device/streamed-socket.test.d.ts +0 -1
  188. package/dist/device/streamed-socket.test.js +0 -216
  189. package/dist/device/tx-encoding.test.d.ts +0 -1
  190. package/dist/device/tx-encoding.test.js +0 -295
  191. package/dist/device-pairing/cpace.test.d.ts +0 -1
  192. package/dist/device-pairing/cpace.test.js +0 -116
  193. package/dist/device-pairing/device-pairing.test.d.ts +0 -1
  194. package/dist/device-pairing/device-pairing.test.js +0 -211
  195. package/dist/hlc.test.d.ts +0 -1
  196. package/dist/hlc.test.js +0 -45
  197. package/dist/host-credentials.test.d.ts +0 -1
  198. package/dist/host-credentials.test.js +0 -88
  199. package/dist/identity/account-email.test.d.ts +0 -1
  200. package/dist/identity/account-email.test.js +0 -59
  201. package/dist/identity/anchor-document.test.d.ts +0 -1
  202. package/dist/identity/anchor-document.test.js +0 -16
  203. package/dist/identity/anchor-resolution.test.d.ts +0 -1
  204. package/dist/identity/anchor-resolution.test.js +0 -130
  205. package/dist/identity/key-change.test.d.ts +0 -1
  206. package/dist/identity/key-change.test.js +0 -811
  207. package/dist/invites/group-approval.test.d.ts +0 -1
  208. package/dist/invites/group-approval.test.js +0 -223
  209. package/dist/invites/invite-token.test.d.ts +0 -1
  210. package/dist/invites/invite-token.test.js +0 -123
  211. package/dist/keys.test.d.ts +0 -1
  212. package/dist/keys.test.js +0 -336
  213. package/dist/logging/console-logger.test.d.ts +0 -1
  214. package/dist/logging/console-logger.test.js +0 -300
  215. package/dist/logging/console-logs.table.test.d.ts +0 -1
  216. package/dist/logging/console-logs.table.test.js +0 -156
  217. package/dist/observable.test.d.ts +0 -1
  218. package/dist/observable.test.js +0 -309
  219. package/dist/package-build/build-package.test.d.ts +0 -1
  220. package/dist/package-build/build-package.test.js +0 -204
  221. package/dist/package-build/contract-add.test.d.ts +0 -1
  222. package/dist/package-build/contract-add.test.js +0 -467
  223. package/dist/package-build/freeze-contracts.test.d.ts +0 -1
  224. package/dist/package-build/freeze-contracts.test.js +0 -355
  225. package/dist/package-installer/package-author-signing.test.d.ts +0 -1
  226. package/dist/package-installer/package-author-signing.test.js +0 -200
  227. package/dist/package-installer/package-cloner.test.d.ts +0 -1
  228. package/dist/package-installer/package-cloner.test.js +0 -278
  229. package/dist/package-installer/package-creator.test.d.ts +0 -1
  230. package/dist/package-installer/package-creator.test.js +0 -908
  231. package/dist/package-installer/package-dev-tools.test.d.ts +0 -1
  232. package/dist/package-installer/package-dev-tools.test.js +0 -64
  233. package/dist/package-installer/package-installer.test.d.ts +0 -1
  234. package/dist/package-installer/package-installer.test.js +0 -882
  235. package/dist/package-installer/package-propagation.test.d.ts +0 -1
  236. package/dist/package-installer/package-propagation.test.js +0 -1269
  237. package/dist/package-installer/package-publisher.test.d.ts +0 -1
  238. package/dist/package-installer/package-publisher.test.js +0 -153
  239. package/dist/package-installer/package-remote-checker.test.d.ts +0 -1
  240. package/dist/package-installer/package-remote-checker.test.js +0 -334
  241. package/dist/package-installer/package-seed-installer.test.d.ts +0 -1
  242. package/dist/package-installer/package-seed-installer.test.js +0 -123
  243. package/dist/package-installer/package-tarball.test.d.ts +0 -1
  244. package/dist/package-installer/package-tarball.test.js +0 -75
  245. package/dist/package-installer/peers-core-installer.test.d.ts +0 -1
  246. package/dist/package-installer/peers-core-installer.test.js +0 -49
  247. package/dist/package-installer/peers-core-trust-anchor.test.d.ts +0 -1
  248. package/dist/package-installer/peers-core-trust-anchor.test.js +0 -155
  249. package/dist/package-loader/contract-package-loader.test.d.ts +0 -1
  250. package/dist/package-loader/contract-package-loader.test.js +0 -274
  251. package/dist/package-loader/host-authority-loading.test.d.ts +0 -1
  252. package/dist/package-loader/host-authority-loading.test.js +0 -104
  253. package/dist/package-loader/host-dispatch-policy.test.d.ts +0 -1
  254. package/dist/package-loader/host-dispatch-policy.test.js +0 -56
  255. package/dist/package-loader/isolated-artifact.test.d.ts +0 -1
  256. package/dist/package-loader/isolated-artifact.test.js +0 -688
  257. package/dist/package-loader/isolated-persistent-var-gateway.test.d.ts +0 -1
  258. package/dist/package-loader/isolated-persistent-var-gateway.test.js +0 -56
  259. package/dist/package-loader/isolated-table-gateway.test.d.ts +0 -1
  260. package/dist/package-loader/isolated-table-gateway.test.js +0 -633
  261. package/dist/package-loader/package-loader.test.d.ts +0 -1
  262. package/dist/package-loader/package-loader.test.js +0 -1764
  263. package/dist/package-loader/resolve-consumed-contracts.test.d.ts +0 -1
  264. package/dist/package-loader/resolve-consumed-contracts.test.js +0 -166
  265. package/dist/serial-json.compat.test.d.ts +0 -1
  266. package/dist/serial-json.compat.test.js +0 -369
  267. package/dist/serial-json.test.d.ts +0 -1
  268. package/dist/serial-json.test.js +0 -401
  269. package/dist/testing/mock-host-contract.test.d.ts +0 -1
  270. package/dist/testing/mock-host-contract.test.js +0 -782
  271. package/dist/utils.test.d.ts +0 -1
  272. 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 {};