@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,657 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- const groupPermissions = require("../../data/group-permissions");
4
- const decorators_1 = require("../../data/orm/decorators");
5
- const observable_1 = require("../../observable");
6
- const field_type_1 = require("../../types/field-type");
7
- const utils_1 = require("../../utils");
8
- const contract_proxy_1 = require("../contract-proxy");
9
- const contract_transport_1 = require("../contract-transport");
10
- const CONTRACT_ID = (0, utils_1.newid)();
11
- const cleanups = [];
12
- afterEach(() => {
13
- for (const cleanup of cleanups.splice(0).reverse()) {
14
- cleanup();
15
- }
16
- jest.restoreAllMocks();
17
- });
18
- /** A small contract with one table, one tool, and one observable. */
19
- function makeContract(opts = {}) {
20
- return {
21
- contractId: CONTRACT_ID,
22
- version: 1,
23
- devTag: "dev",
24
- name: "Test Contract",
25
- description: "For proxy tests",
26
- tables: [
27
- {
28
- name: "Widgets",
29
- description: "Widget table",
30
- primaryKeyName: "widgetId",
31
- fields: [{ name: "widgetId", type: field_type_1.FieldType.id, description: "PK" }],
32
- },
33
- ],
34
- tools: [
35
- {
36
- name: "make-widget",
37
- usageDescription: "Makes a widget",
38
- inputFields: [{ name: "color", type: field_type_1.FieldType.string, description: "Color" }],
39
- outputFields: [{ name: "widgetId", type: field_type_1.FieldType.id, description: "ID" }],
40
- },
41
- ],
42
- observables: opts.observable
43
- ? [
44
- {
45
- name: "widgetCount",
46
- description: "Count",
47
- valueType: field_type_1.FieldType.number,
48
- writable: true,
49
- },
50
- ]
51
- : [],
52
- };
53
- }
54
- /**
55
- * A fake resolution with an in-memory table (list/get/save), a tool fn, and an observable.
56
- * Tables in a real resolution are `Table` instances; for dispatch the provider only needs
57
- * indexable methods, so a plain object cast to the resolution type is sufficient here.
58
- */
59
- function makeResolution() {
60
- const rows = [];
61
- const table = {
62
- list: jest.fn(async (filter = {}) => rows.filter((r) => Object.entries(filter).every(([k, v]) => r[k] === v))),
63
- get: jest.fn(async (id) => rows.find((r) => r.widgetId === id)),
64
- save: jest.fn(async (record) => {
65
- rows.push(record);
66
- return record;
67
- }),
68
- };
69
- const makeWidget = jest.fn(async ({ color }) => ({
70
- widgetId: (0, utils_1.newid)(),
71
- color,
72
- }));
73
- const widgetCount = (0, observable_1.observable)(0);
74
- const resolution = {
75
- contractId: CONTRACT_ID,
76
- version: 1,
77
- tables: { Widgets: table },
78
- tools: {
79
- "make-widget": {
80
- tool: { toolId: (0, utils_1.newid)(), name: "make-widget", accessLevel: 0 },
81
- toolFn: makeWidget,
82
- },
83
- },
84
- observables: { widgetCount },
85
- observableWritability: { widgetCount: true },
86
- };
87
- return { resolution, table, makeWidget, widgetCount, rows };
88
- }
89
- /**
90
- * Build a consumer wired to a provider dispatch fn over an in-process transport pair:
91
- * the provider handler is registered on the provider end's request channel, and the
92
- * consumer is built on the other end.
93
- */
94
- function consumerVia(contract, provider, context = {}) {
95
- const [consumerTransport, providerTransport] = (0, contract_transport_1.inProcessTransportPair)();
96
- const offRequest = providerTransport.on(contract_transport_1.CONTRACT_REQUEST_CHANNEL, (call) => provider(call, context));
97
- const consumer = (0, contract_proxy_1.createContractConsumer)(contract, consumerTransport);
98
- cleanups.push(() => {
99
- consumer.dispose();
100
- offRequest();
101
- });
102
- return consumer;
103
- }
104
- /** Wire a request/response-only consumer directly to a stateless provider. */
105
- function wire(opts = {}) {
106
- const contract = makeContract();
107
- const { resolution, ...rest } = makeResolution();
108
- const provider = (0, contract_proxy_1.createContractProvider)(resolution, { permissionCheck: opts.permissionCheck });
109
- const consumer = consumerVia(contract, provider, opts.context ?? {});
110
- return { consumer, provider, contract, ...rest };
111
- }
112
- /** Wire an observable-bearing consumer to a stateful provider session. */
113
- function wireSession(opts = {}) {
114
- const contract = makeContract({ observable: true });
115
- const { resolution, ...rest } = makeResolution();
116
- const [consumerTransport, providerTransport] = (0, contract_transport_1.inProcessTransportPair)();
117
- const session = (0, contract_proxy_1.createContractProviderSession)(resolution, providerTransport, {
118
- permissionCheck: opts.permissionCheck,
119
- context: opts.context,
120
- });
121
- const consumer = (0, contract_proxy_1.createContractConsumer)(contract, consumerTransport);
122
- cleanups.push(() => {
123
- consumer.dispose();
124
- session.dispose();
125
- });
126
- return { consumer, session, contract, ...rest };
127
- }
128
- describe("contract proxy — consumer/provider round-trip", () => {
129
- it("proxies a table method (save then list) through to the live table", async () => {
130
- const { consumer, table } = wire();
131
- const saved = await consumer.tables.Widgets.save({ widgetId: "w1", color: "red" });
132
- expect(saved).toEqual({ widgetId: "w1", color: "red" });
133
- expect(table.save).toHaveBeenCalledWith({ widgetId: "w1", color: "red" });
134
- const listed = await consumer.tables.Widgets.list({ color: "red" });
135
- expect(listed).toEqual([{ widgetId: "w1", color: "red" }]);
136
- expect(table.list).toHaveBeenCalledWith({ color: "red" });
137
- });
138
- it("passes multiple positional args to a table method", async () => {
139
- const { consumer, table } = wire();
140
- const filter = { color: "blue" };
141
- const opts = { pageSize: 10 };
142
- await consumer.tables.Widgets.list(filter, opts);
143
- expect(table.list).toHaveBeenCalledWith(filter, opts);
144
- });
145
- it("proxies a tool call", async () => {
146
- const { consumer, makeWidget } = wire();
147
- const result = await consumer.tools["make-widget"]({ color: "blue" });
148
- expect(makeWidget).toHaveBeenCalledWith({ color: "blue" });
149
- expect(result.color).toBe("blue");
150
- });
151
- it("allows a classified tool when the provider data context grants access", async () => {
152
- const getUserAccessLevel = jest
153
- .spyOn(groupPermissions, "getUserAccessLevel")
154
- .mockResolvedValue(100);
155
- const contract = makeContract();
156
- const { resolution, makeWidget } = makeResolution();
157
- const makeWidgetTool = resolution.tools?.["make-widget"];
158
- if (!makeWidgetTool) {
159
- throw new Error("expected make-widget tool");
160
- }
161
- makeWidgetTool.tool.accessLevel = 80;
162
- const provider = (0, contract_proxy_1.createContractProvider)(resolution);
163
- const dataContext = { userContext: { userId: "u1" } };
164
- const consumer = consumerVia(contract, provider, {
165
- callerUserId: "u1",
166
- localUserId: "u1",
167
- dataContext,
168
- });
169
- await expect(consumer.tools["make-widget"]({ color: "blue" })).resolves.toEqual(expect.objectContaining({ color: "blue" }));
170
- expect(makeWidget).toHaveBeenCalledWith({ color: "blue" });
171
- expect(getUserAccessLevel).toHaveBeenCalledWith(dataContext, "u1");
172
- });
173
- it("fails closed quickly when a classified tool has no user context", async () => {
174
- const contract = makeContract();
175
- const { resolution } = makeResolution();
176
- const makeWidgetTool = resolution.tools?.["make-widget"];
177
- if (!makeWidgetTool) {
178
- throw new Error("expected make-widget tool");
179
- }
180
- makeWidgetTool.tool.accessLevel = 20;
181
- const provider = (0, contract_proxy_1.createContractProvider)(resolution);
182
- const consumer = consumerVia(contract, provider, {
183
- callerUserId: (0, utils_1.newid)(),
184
- localUserId: (0, utils_1.newid)(),
185
- });
186
- await expect(consumer.tools["make-widget"]({ color: "blue" })).rejects.toThrow("User context is not available");
187
- });
188
- it("denies unclassified tools when the caller identity is missing", async () => {
189
- const contract = makeContract();
190
- const { resolution } = makeResolution();
191
- const makeWidgetTool = resolution.tools?.["make-widget"];
192
- if (!makeWidgetTool) {
193
- throw new Error("expected make-widget tool");
194
- }
195
- makeWidgetTool.tool.accessLevel = undefined;
196
- const provider = (0, contract_proxy_1.createContractProvider)(resolution);
197
- const consumer = consumerVia(contract, provider, {});
198
- await expect(consumer.tools["make-widget"]({ color: "blue" })).rejects.toThrow("missing caller identity");
199
- });
200
- it("forwards dataContextId on methods, tools, observables, and subscriptions", async () => {
201
- const dataContextId = (0, utils_1.newid)();
202
- const calls = [];
203
- const transport = {
204
- emit: jest.fn(async (channel, call) => {
205
- expect(channel).toBe(contract_transport_1.CONTRACT_REQUEST_CHANNEL);
206
- calls.push(call);
207
- return call.member === "observable" && call.operation === "get" ? 0 : undefined;
208
- }),
209
- on: () => () => { },
210
- };
211
- const contract = {
212
- ...makeContract({ observable: true }),
213
- events: [
214
- {
215
- name: "changed",
216
- description: "Changed",
217
- payloadFields: [],
218
- },
219
- ],
220
- };
221
- const consumer = (0, contract_proxy_1.createContractConsumer)(contract, transport, { dataContextId });
222
- cleanups.push(() => consumer.dispose());
223
- await consumer.loadingPromise;
224
- await consumer.tables.Widgets.list();
225
- await consumer.tools["make-widget"]({ color: "blue" });
226
- consumer.events.changed.subscribe(() => { });
227
- consumer.tables.Widgets.dataChanged.subscribe(() => { });
228
- consumer.observables.widgetCount(2);
229
- await consumer.loadingPromise;
230
- expect(calls).toEqual(expect.arrayContaining([
231
- expect.objectContaining({ member: "table", operation: "list" }),
232
- expect.objectContaining({ member: "tool", operation: "run" }),
233
- expect.objectContaining({ member: "observable", operation: "subscribe" }),
234
- expect.objectContaining({ member: "observable", operation: "get" }),
235
- expect.objectContaining({ member: "observable", operation: "set" }),
236
- expect.objectContaining({ member: "event", operation: "subscribe" }),
237
- expect.objectContaining({
238
- member: "table",
239
- operation: "subscribe",
240
- event: "dataChanged",
241
- }),
242
- ]));
243
- expect(calls.every((call) => call.dataContextId === dataContextId)).toBe(true);
244
- });
245
- it("mirrors an observable snapshot and provider pushes through a session", async () => {
246
- const { consumer, widgetCount } = wireSession();
247
- await consumer.loadingPromise;
248
- expect(consumer.observables.widgetCount()).toBe(0);
249
- const pushed = new Promise((resolve) => {
250
- const sub = consumer.observables.widgetCount.subscribe((value) => {
251
- if (value === 4) {
252
- sub.dispose();
253
- resolve();
254
- }
255
- });
256
- });
257
- widgetCount(4);
258
- await pushed;
259
- expect(consumer.observables.widgetCount()).toBe(4);
260
- });
261
- it("forwards writable observable writes through a session", async () => {
262
- const { consumer, widgetCount } = wireSession();
263
- await consumer.loadingPromise;
264
- consumer.observables.widgetCount(7);
265
- await consumer.loadingPromise;
266
- expect(widgetCount()).toBe(7);
267
- expect(consumer.observables.widgetCount()).toBe(7);
268
- });
269
- it("dispatches stateless observable get and set calls directly", async () => {
270
- const { resolution, widgetCount } = makeResolution();
271
- const provider = (0, contract_proxy_1.createContractProvider)(resolution);
272
- await expect(provider({
273
- contractId: CONTRACT_ID,
274
- version: 1,
275
- member: "observable",
276
- name: "widgetCount",
277
- operation: "get",
278
- args: [],
279
- })).resolves.toBe(0);
280
- await expect(provider({
281
- contractId: CONTRACT_ID,
282
- version: 1,
283
- member: "observable",
284
- name: "widgetCount",
285
- operation: "set",
286
- args: [8],
287
- })).resolves.toBe(8);
288
- expect(widgetCount()).toBe(8);
289
- });
290
- it("unwraps a client-proxy (__original) table method", async () => {
291
- const contract = makeContract();
292
- const original = jest.fn(async () => "original-result");
293
- (0, decorators_1.ProxyClientTableMethodCalls)()(original, { kind: "method", name: "deleteOldLogs" });
294
- const proxied = jest.fn(async () => "proxied-result");
295
- proxied.__original = original;
296
- const resolution = {
297
- contractId: CONTRACT_ID,
298
- version: 1,
299
- tables: { Widgets: { deleteOldLogs: proxied } },
300
- };
301
- const provider = (0, contract_proxy_1.createContractProvider)(resolution);
302
- const consumer = consumerVia(contract, provider);
303
- const result = await consumer.tables.Widgets.deleteOldLogs();
304
- expect(result).toBe("original-result");
305
- expect(original).toHaveBeenCalled();
306
- expect(proxied).not.toHaveBeenCalled();
307
- });
308
- });
309
- describe("contract proxy — remote (device-targeted) consumers", () => {
310
- /** Wire a remote factory to a request handler that echoes the target device. */
311
- function wireRemote(contract = makeContract({ observable: true })) {
312
- const seen = [];
313
- const [consumerTransport, providerTransport] = (0, contract_transport_1.inProcessTransportPair)();
314
- const offRequest = providerTransport.on(contract_transport_1.CONTRACT_REQUEST_CHANNEL, async (call) => {
315
- seen.push(call);
316
- return { ok: call.targetDeviceId };
317
- });
318
- const remote = (0, contract_proxy_1.createRemoteContractConsumer)(contract, consumerTransport, {
319
- dataContextId: "group-1",
320
- });
321
- cleanups.push(() => {
322
- remote.dispose();
323
- offRequest();
324
- });
325
- return { remote, seen, contract };
326
- }
327
- it("stamps targetDeviceId and the data context on every tool call", async () => {
328
- const { remote, seen, contract } = wireRemote();
329
- const deviceB = remote.device("device-b");
330
- await expect(deviceB.tools["make-widget"]({ color: "red" })).resolves.toEqual({
331
- ok: "device-b",
332
- });
333
- expect(seen).toHaveLength(1);
334
- expect(seen[0]).toMatchObject({
335
- member: "tool",
336
- name: "make-widget",
337
- operation: "run",
338
- targetDeviceId: "device-b",
339
- dataContextId: "group-1",
340
- args: [{ color: "red" }],
341
- });
342
- // Nothing implicit hits the wire: no observable subscribe/get for remote consumers.
343
- expect(seen.filter((call) => call.member === "observable")).toHaveLength(0);
344
- expect(deviceB.contractId).toBe(contract.contractId);
345
- expect(remote.contractId).toBe(contract.contractId);
346
- await expect(deviceB.loadingPromise).resolves.toBeUndefined();
347
- });
348
- it("exposes only tools on a device consumer", () => {
349
- const { remote } = wireRemote();
350
- const deviceB = remote.device("device-b");
351
- expect(() => deviceB.tables.Widgets).toThrow("not remotely accessible");
352
- expect(() => deviceB.observables.widgetCount).toThrow("not remotely accessible");
353
- expect(() => deviceB.events.anything).toThrow("not remotely accessible");
354
- expect(Object.keys(deviceB.tools)).toEqual(["make-widget"]);
355
- });
356
- it("caches one consumer per device and rejects empty device ids", () => {
357
- const { remote } = wireRemote();
358
- expect(remote.device("device-b")).toBe(remote.device("device-b"));
359
- expect(remote.device("device-b")).not.toBe(remote.device("device-c"));
360
- expect(() => remote.device("")).toThrow("non-empty device id");
361
- });
362
- it("disposes device consumers with the factory and independently", async () => {
363
- const { remote } = wireRemote();
364
- const deviceA = remote.device("device-a");
365
- const deviceB = remote.device("device-b");
366
- deviceA.dispose();
367
- await expect(deviceA.tools["make-widget"]({ color: "x" })).rejects.toThrow("disposed");
368
- await expect(deviceB.tools["make-widget"]({ color: "x" })).resolves.toBeDefined();
369
- // A disposed device consumer is evicted so the next lookup gets a fresh one.
370
- expect(remote.device("device-a")).not.toBe(deviceA);
371
- remote.dispose();
372
- await expect(deviceB.tools["make-widget"]({ color: "x" })).rejects.toThrow("disposed");
373
- expect(() => remote.device("device-c")).toThrow("disposed");
374
- });
375
- });
376
- describe("contract proxy — error handling", () => {
377
- it("rejects an unknown table method", async () => {
378
- const { consumer } = wire();
379
- await expect(consumer.tables.Widgets.nope()).rejects.toThrow(/no method 'nope'/);
380
- });
381
- it.each([
382
- "getRecordId",
383
- "cursor",
384
- "initDoc",
385
- ])("rejects unmarked internal or non-serializable table method %s", async (operation) => {
386
- const contract = makeContract();
387
- const method = jest.fn();
388
- const resolution = {
389
- contractId: CONTRACT_ID,
390
- version: 1,
391
- tables: { Widgets: { [operation]: method } },
392
- };
393
- const provider = (0, contract_proxy_1.createContractProvider)(resolution);
394
- const consumer = consumerVia(contract, provider);
395
- await expect(consumer.tables.Widgets[operation]()).rejects.toThrow(/not remotely callable/);
396
- expect(method).not.toHaveBeenCalled();
397
- });
398
- it.each([
399
- "constructor",
400
- "__proto__",
401
- "dataChanged",
402
- "then",
403
- ])("rejects dangerous table property %s before reading it", async (operation) => {
404
- const table = Object.create(null);
405
- const getter = jest.fn();
406
- Object.defineProperty(table, operation, { get: getter });
407
- const provider = (0, contract_proxy_1.createContractProvider)({
408
- contractId: CONTRACT_ID,
409
- version: 1,
410
- tables: { Widgets: table },
411
- });
412
- await expect(provider({
413
- contractId: CONTRACT_ID,
414
- version: 1,
415
- member: "table",
416
- name: "Widgets",
417
- operation,
418
- args: [],
419
- })).rejects.toThrow(/not remotely callable/);
420
- expect(getter).not.toHaveBeenCalled();
421
- });
422
- it("rejects a call for a table not in the resolution", async () => {
423
- const contract = makeContract();
424
- const resolution = { contractId: CONTRACT_ID, version: 1, tables: {} };
425
- const provider = (0, contract_proxy_1.createContractProvider)(resolution);
426
- const consumer = consumerVia(contract, provider);
427
- await expect(consumer.tables.Widgets.list()).rejects.toThrow(/does not provide table 'Widgets'/);
428
- });
429
- it("forwards callerPackageId when the resolution opts into call context", async () => {
430
- const seen = [];
431
- const provider = (0, contract_proxy_1.createContractProvider)({
432
- contractId: CONTRACT_ID,
433
- version: 1,
434
- forwardCallContext: true,
435
- tools: {
436
- listGrants: {
437
- tool: { toolId: (0, utils_1.newid)(), name: "listGrants", accessLevel: 0 },
438
- toolFn: async (_input, host) => {
439
- seen.push(host.callerPackageId ?? null);
440
- return "ok";
441
- },
442
- },
443
- },
444
- });
445
- await provider({
446
- contractId: CONTRACT_ID,
447
- version: 1,
448
- member: "tool",
449
- name: "listGrants",
450
- operation: "run",
451
- args: [],
452
- }, { callerPackageId: "00pkg00000000000000000001" });
453
- expect(seen).toEqual(["00pkg00000000000000000001"]);
454
- });
455
- it("rejects extra arguments that could shadow forwarded call context", async () => {
456
- const toolFn = jest.fn(async (_input, host) => host.callerPackageId ?? null);
457
- const provider = (0, contract_proxy_1.createContractProvider)({
458
- contractId: CONTRACT_ID,
459
- version: 1,
460
- forwardCallContext: true,
461
- tools: {
462
- request: {
463
- tool: { toolId: (0, utils_1.newid)(), name: "request", accessLevel: 0 },
464
- toolFn,
465
- },
466
- },
467
- });
468
- await expect(provider({
469
- contractId: CONTRACT_ID,
470
- version: 1,
471
- member: "tool",
472
- name: "request",
473
- operation: "run",
474
- args: [{ url: "https://example.com" }, { callerPackageId: (0, utils_1.newid)() }],
475
- }, { callerPackageId: (0, utils_1.newid)() })).rejects.toThrow(/single argument when host context is forwarded/);
476
- expect(toolFn).not.toHaveBeenCalled();
477
- });
478
- it.each([
479
- ["tool", "missingTool"],
480
- ["observable", "missingObservable"],
481
- ])("rejects an unknown %s", async (member, name) => {
482
- const { resolution } = makeResolution();
483
- const provider = (0, contract_proxy_1.createContractProvider)(resolution);
484
- await expect(provider({
485
- contractId: CONTRACT_ID,
486
- version: 1,
487
- member,
488
- name,
489
- operation: member === "tool" ? "run" : "get",
490
- args: [],
491
- })).rejects.toThrow(new RegExp(`does not provide ${member} '${name}'`));
492
- });
493
- it("rejects a contract id/version mismatch", async () => {
494
- const { provider } = wire();
495
- const badCall = {
496
- contractId: (0, utils_1.newid)(),
497
- version: 1,
498
- member: "table",
499
- name: "Widgets",
500
- operation: "list",
501
- args: [],
502
- };
503
- await expect(provider(badCall)).rejects.toThrow(/Contract mismatch/);
504
- });
505
- it("rejects a version-only contract mismatch", async () => {
506
- const { provider } = wire();
507
- await expect(provider({
508
- contractId: CONTRACT_ID,
509
- version: 2,
510
- member: "table",
511
- name: "Widgets",
512
- operation: "list",
513
- args: [],
514
- })).rejects.toThrow(/Contract mismatch/);
515
- });
516
- it("rejects an unsupported observable operation", async () => {
517
- const { provider } = wire();
518
- const call = {
519
- contractId: CONTRACT_ID,
520
- version: 1,
521
- member: "observable",
522
- name: "widgetCount",
523
- operation: "increment",
524
- args: [],
525
- };
526
- await expect(provider(call)).rejects.toThrow(/Unsupported observable operation/);
527
- });
528
- it("rejects an unsupported tool operation without invoking the tool", async () => {
529
- const { provider, makeWidget } = wire();
530
- await expect(provider({
531
- contractId: CONTRACT_ID,
532
- version: 1,
533
- member: "tool",
534
- name: "make-widget",
535
- operation: "get",
536
- args: [],
537
- })).rejects.toThrow(/Unsupported tool operation/);
538
- expect(makeWidget).not.toHaveBeenCalled();
539
- });
540
- });
541
- describe("contract proxy — permission checks", () => {
542
- it("allows same-user calls and denies cross-user calls (stub)", async () => {
543
- const localUserId = (0, utils_1.newid)();
544
- const allowed = wire({
545
- permissionCheck: contract_proxy_1.sameUserContractPermissionCheck,
546
- context: { localUserId, callerUserId: localUserId },
547
- });
548
- await expect(allowed.consumer.tables.Widgets.list()).resolves.toEqual([]);
549
- const denied = wire({
550
- permissionCheck: contract_proxy_1.sameUserContractPermissionCheck,
551
- context: { localUserId, callerUserId: (0, utils_1.newid)() },
552
- });
553
- await expect(denied.consumer.tables.Widgets.list()).rejects.toThrow(/Permission denied/);
554
- });
555
- it("denies when the caller identity is unknown", async () => {
556
- const denied = wire({
557
- permissionCheck: contract_proxy_1.sameUserContractPermissionCheck,
558
- context: { localUserId: (0, utils_1.newid)() },
559
- });
560
- await expect(denied.consumer.tools["make-widget"]({ color: "x" })).rejects.toThrow(/Permission denied/);
561
- });
562
- it("does not dispatch to the table when permission is denied", async () => {
563
- const localUserId = (0, utils_1.newid)();
564
- const denied = wire({
565
- permissionCheck: contract_proxy_1.sameUserContractPermissionCheck,
566
- context: { localUserId, callerUserId: (0, utils_1.newid)() },
567
- });
568
- await expect(denied.consumer.tables.Widgets.save({ widgetId: "z" })).rejects.toThrow(/Permission denied/);
569
- expect(denied.table.save).not.toHaveBeenCalled();
570
- });
571
- });
572
- describe("contract provider endpoint event filter", () => {
573
- it("delivers a generic event only to subscribers the filter allows", async () => {
574
- const handlers = new Set();
575
- const changed = {
576
- eventName: () => "changed",
577
- subscribe: (handler) => {
578
- handlers.add(handler);
579
- return {
580
- unsubscribe: () => {
581
- handlers.delete(handler);
582
- return true;
583
- },
584
- };
585
- },
586
- };
587
- const resolution = {
588
- contractId: CONTRACT_ID,
589
- version: 1,
590
- events: { changed: changed },
591
- eventFilter: (_eventName, payload, context) => payload.owner === context.callerPackageId,
592
- };
593
- const delivered = [];
594
- const endpoint = (0, contract_proxy_1.createContractProviderEndpoint)(resolution, {
595
- notify: async (notification) => {
596
- delivered.push(notification.subscriptionId);
597
- },
598
- });
599
- const subscribe = (subscriptionId, callerPackageId) => endpoint.handleCall({
600
- contractId: CONTRACT_ID,
601
- version: 1,
602
- member: "event",
603
- name: "changed",
604
- operation: "subscribe",
605
- subscriptionId,
606
- args: [],
607
- }, { callerPackageId });
608
- await subscribe("allowed", "pkg-a");
609
- await subscribe("denied", "pkg-b");
610
- for (const handler of handlers) {
611
- handler({ owner: "pkg-a" });
612
- }
613
- await new Promise((resolve) => setImmediate(resolve));
614
- expect(delivered).toEqual(["allowed"]);
615
- endpoint.dispose();
616
- });
617
- });
618
- describe("connectionContractTransport", () => {
619
- it("emits on the request channel with the call and returns the response", async () => {
620
- const emit = jest.fn(async (_event, _call) => ["ok"]);
621
- const emitter = { emit, on: jest.fn() };
622
- const contract = makeContract();
623
- const consumer = (0, contract_proxy_1.createContractConsumer)(contract, (0, contract_transport_1.connectionContractTransport)(emitter));
624
- cleanups.push(() => consumer.dispose());
625
- const result = await consumer.tables.Widgets.list({ color: "red" });
626
- expect(result).toEqual(["ok"]);
627
- expect(emit).toHaveBeenCalledWith("contractCall", expect.objectContaining({
628
- contractId: CONTRACT_ID,
629
- version: 1,
630
- member: "table",
631
- name: "Widgets",
632
- operation: "list",
633
- args: [{ color: "red" }],
634
- }));
635
- });
636
- });
637
- test("a provider-local implementation needs no toolId and still enforces access", async () => {
638
- const toolFn = jest.fn(() => "bound");
639
- const dispatch = (0, contract_proxy_1.createContractProvider)({
640
- contractId: CONTRACT_ID,
641
- version: 1,
642
- tools: { run: { tool: { name: "run", usageDescription: "run", accessLevel: 40 }, toolFn } },
643
- });
644
- const call = {
645
- contractId: CONTRACT_ID,
646
- version: 1,
647
- member: "tool",
648
- name: "run",
649
- operation: "run",
650
- args: [{}],
651
- };
652
- jest.spyOn(groupPermissions, "getUserRole").mockResolvedValue(20);
653
- await expect(dispatch(call, { callerUserId: (0, utils_1.newid)() })).rejects.toThrow(/Permission denied/);
654
- jest.spyOn(groupPermissions, "getUserRole").mockResolvedValue(40);
655
- await expect(dispatch(call, { callerUserId: (0, utils_1.newid)() })).resolves.toBe("bound");
656
- expect(toolFn).toHaveBeenCalledTimes(1);
657
- });
@@ -1 +0,0 @@
1
- export {};