@coasys/ad4m 0.13.0-test-interpretation-2 → 0.13.0-test-model-layer

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 (254) hide show
  1. package/lib/index.cjs +1982 -498
  2. package/lib/index.js +1982 -499
  3. package/lib/src/ai/AIClient.js +6 -3
  4. package/lib/src/apiClient.d.ts +40 -4
  5. package/lib/src/apiClient.js +149 -9
  6. package/lib/src/index.d.ts +3 -1
  7. package/lib/src/index.js +2 -0
  8. package/lib/src/model/Ad4mModel.d.ts +6 -5
  9. package/lib/src/model/Ad4mModel.js +246 -29
  10. package/lib/src/model/Ad4mModel.test.js +480 -735
  11. package/lib/src/model/decorators.d.ts +147 -4
  12. package/lib/src/model/decorators.js +70 -24
  13. package/lib/src/model/model-manifest.d.ts +41 -0
  14. package/lib/src/model/model-manifest.js +11 -0
  15. package/lib/src/model/query-sparql.test.js +92 -10
  16. package/lib/src/model/shacl-gen.js +33 -0
  17. package/lib/src/model/types.d.ts +9 -0
  18. package/lib/src/neighbourhood/NeighbourhoodProxy.test.js +33 -33
  19. package/lib/src/perspectives/AutoProcessor.d.ts +90 -24
  20. package/lib/src/perspectives/FlowInstance.d.ts +187 -0
  21. package/lib/src/perspectives/FlowInstance.js +336 -0
  22. package/lib/src/perspectives/FlowModels.d.ts +94 -0
  23. package/lib/src/perspectives/FlowModels.js +182 -0
  24. package/lib/src/perspectives/InterpretationModels.d.ts +12 -22
  25. package/lib/src/perspectives/InterpretationModels.js +2 -6
  26. package/lib/src/perspectives/PerspectiveClient.d.ts +68 -7
  27. package/lib/src/perspectives/PerspectiveClient.js +105 -10
  28. package/lib/src/perspectives/PerspectiveProxy.d.ts +142 -57
  29. package/lib/src/perspectives/PerspectiveProxy.js +388 -274
  30. package/lib/src/shacl/SHACLFlow.d.ts +273 -47
  31. package/lib/src/shacl/SHACLFlow.js +397 -88
  32. package/lib/src/shacl/SHACLShape.d.ts +8 -0
  33. package/lib/src/shacl/SHACLShape.js +17 -0
  34. package/lib/src/shacl/SHACLShape.test.js +82 -0
  35. package/package.json +2 -2
  36. package/src/ai/AIClient.ts +6 -3
  37. package/src/apiClient.test.ts +227 -0
  38. package/src/apiClient.ts +185 -9
  39. package/src/index.ts +3 -1
  40. package/src/model/Ad4mModel.test.ts +645 -0
  41. package/src/model/Ad4mModel.ts +245 -26
  42. package/src/model/decorators.ts +216 -35
  43. package/src/model/relation-filtering.test.ts +70 -20
  44. package/src/model/shacl-gen.ts +36 -0
  45. package/src/model/shacl-roundtrip.test.ts +130 -0
  46. package/src/model/types.ts +7 -0
  47. package/src/perspectives/AutoProcessor.ts +94 -24
  48. package/src/perspectives/FlowInstance.ts +369 -0
  49. package/src/perspectives/FlowModels.ts +157 -0
  50. package/src/perspectives/InterpretationModels.ts +13 -25
  51. package/src/perspectives/PerspectiveClient.test.ts +67 -6
  52. package/src/perspectives/PerspectiveClient.ts +142 -12
  53. package/src/perspectives/PerspectiveProxy.test.ts +406 -0
  54. package/src/perspectives/PerspectiveProxy.ts +459 -289
  55. package/src/perspectives/shacl-rpc.test.ts +258 -0
  56. package/src/shacl/SHACLFlow.test.ts +762 -35
  57. package/src/shacl/SHACLFlow.ts +680 -112
  58. package/src/shacl/SHACLShape.ts +31 -0
  59. package/lib/src/generated/rest/AIModelLoadingStatus.d.ts +0 -7
  60. package/lib/src/generated/rest/AIModelLoadingStatus.js +0 -2
  61. package/lib/src/generated/rest/AddAgentInfosRequest.d.ts +0 -3
  62. package/lib/src/generated/rest/AddAgentInfosRequest.js +0 -2
  63. package/lib/src/generated/rest/AddLinkExpressionRequest.d.ts +0 -6
  64. package/lib/src/generated/rest/AddLinkExpressionRequest.js +0 -1
  65. package/lib/src/generated/rest/AddLinkRequest.d.ts +0 -6
  66. package/lib/src/generated/rest/AddLinkRequest.js +0 -1
  67. package/lib/src/generated/rest/AddLinksBulkRequest.d.ts +0 -6
  68. package/lib/src/generated/rest/AddLinksBulkRequest.js +0 -1
  69. package/lib/src/generated/rest/AddSdnaRequest.d.ts +0 -6
  70. package/lib/src/generated/rest/AddSdnaRequest.js +0 -2
  71. package/lib/src/generated/rest/ApplyTemplateRequest.d.ts +0 -4
  72. package/lib/src/generated/rest/ApplyTemplateRequest.js +0 -2
  73. package/lib/src/generated/rest/AuthInfoInput.d.ts +0 -10
  74. package/lib/src/generated/rest/AuthInfoInput.js +0 -1
  75. package/lib/src/generated/rest/BroadcastRequest.d.ts +0 -6
  76. package/lib/src/generated/rest/BroadcastRequest.js +0 -1
  77. package/lib/src/generated/rest/CapabilityInput.d.ts +0 -5
  78. package/lib/src/generated/rest/CapabilityInput.js +0 -1
  79. package/lib/src/generated/rest/CommitBatchRequest.d.ts +0 -3
  80. package/lib/src/generated/rest/CommitBatchRequest.js +0 -2
  81. package/lib/src/generated/rest/ComputeLogEntry.d.ts +0 -9
  82. package/lib/src/generated/rest/ComputeLogEntry.js +0 -2
  83. package/lib/src/generated/rest/CreateExpressionRequest.d.ts +0 -4
  84. package/lib/src/generated/rest/CreateExpressionRequest.js +0 -2
  85. package/lib/src/generated/rest/CreatePerspectiveRequest.d.ts +0 -3
  86. package/lib/src/generated/rest/CreatePerspectiveRequest.js +0 -2
  87. package/lib/src/generated/rest/CreateSubjectRequest.d.ts +0 -6
  88. package/lib/src/generated/rest/CreateSubjectRequest.js +0 -2
  89. package/lib/src/generated/rest/CreateUserRequest.d.ts +0 -4
  90. package/lib/src/generated/rest/CreateUserRequest.js +0 -2
  91. package/lib/src/generated/rest/CreateUserResponse.d.ts +0 -5
  92. package/lib/src/generated/rest/CreateUserResponse.js +0 -2
  93. package/lib/src/generated/rest/DecoratedExpressionProof.d.ts +0 -6
  94. package/lib/src/generated/rest/DecoratedExpressionProof.js +0 -2
  95. package/lib/src/generated/rest/DecoratedLinkExpression.d.ts +0 -10
  96. package/lib/src/generated/rest/DecoratedLinkExpression.js +0 -1
  97. package/lib/src/generated/rest/DisposeQueryRequest.d.ts +0 -3
  98. package/lib/src/generated/rest/DisposeQueryRequest.js +0 -2
  99. package/lib/src/generated/rest/EmailTestRequest.d.ts +0 -6
  100. package/lib/src/generated/rest/EmailTestRequest.js +0 -2
  101. package/lib/src/generated/rest/EmbedRequest.d.ts +0 -4
  102. package/lib/src/generated/rest/EmbedRequest.js +0 -2
  103. package/lib/src/generated/rest/EntanglementProofInput.d.ts +0 -6
  104. package/lib/src/generated/rest/EntanglementProofInput.js +0 -2
  105. package/lib/src/generated/rest/EntanglementProofPreflightRequest.d.ts +0 -4
  106. package/lib/src/generated/rest/EntanglementProofPreflightRequest.js +0 -2
  107. package/lib/src/generated/rest/ExecuteCommandsRequest.d.ts +0 -4
  108. package/lib/src/generated/rest/ExecuteCommandsRequest.js +0 -2
  109. package/lib/src/generated/rest/ExportRequest.d.ts +0 -5
  110. package/lib/src/generated/rest/ExportRequest.js +0 -2
  111. package/lib/src/generated/rest/ExpressionManyRequest.d.ts +0 -3
  112. package/lib/src/generated/rest/ExpressionManyRequest.js +0 -2
  113. package/lib/src/generated/rest/ExpressionProof.d.ts +0 -4
  114. package/lib/src/generated/rest/ExpressionProof.js +0 -2
  115. package/lib/src/generated/rest/ExpressionProofInput.d.ts +0 -6
  116. package/lib/src/generated/rest/ExpressionProofInput.js +0 -2
  117. package/lib/src/generated/rest/FriendSendMessageRequest.d.ts +0 -3
  118. package/lib/src/generated/rest/FriendSendMessageRequest.js +0 -2
  119. package/lib/src/generated/rest/FriendsListRequest.d.ts +0 -3
  120. package/lib/src/generated/rest/FriendsListRequest.js +0 -2
  121. package/lib/src/generated/rest/GenerateAgentRequest.d.ts +0 -3
  122. package/lib/src/generated/rest/GenerateAgentRequest.js +0 -2
  123. package/lib/src/generated/rest/GenerateJwtRequest.d.ts +0 -4
  124. package/lib/src/generated/rest/GenerateJwtRequest.js +0 -2
  125. package/lib/src/generated/rest/GetSubjectDataRequest.d.ts +0 -4
  126. package/lib/src/generated/rest/GetSubjectDataRequest.js +0 -2
  127. package/lib/src/generated/rest/HostingInfoResponse.d.ts +0 -5
  128. package/lib/src/generated/rest/HostingInfoResponse.js +0 -2
  129. package/lib/src/generated/rest/HostingWalletResponse.d.ts +0 -4
  130. package/lib/src/generated/rest/HostingWalletResponse.js +0 -2
  131. package/lib/src/generated/rest/ImportAgentRequest.d.ts +0 -6
  132. package/lib/src/generated/rest/ImportAgentRequest.js +0 -2
  133. package/lib/src/generated/rest/ImportRequest.d.ts +0 -4
  134. package/lib/src/generated/rest/ImportRequest.js +0 -2
  135. package/lib/src/generated/rest/JoinNeighbourhoodRequest.d.ts +0 -3
  136. package/lib/src/generated/rest/JoinNeighbourhoodRequest.js +0 -2
  137. package/lib/src/generated/rest/KeepAliveQueryRequest.d.ts +0 -3
  138. package/lib/src/generated/rest/KeepAliveQueryRequest.js +0 -2
  139. package/lib/src/generated/rest/LanguageMetaInput.d.ts +0 -6
  140. package/lib/src/generated/rest/LanguageMetaInput.js +0 -2
  141. package/lib/src/generated/rest/Link.d.ts +0 -5
  142. package/lib/src/generated/rest/Link.js +0 -2
  143. package/lib/src/generated/rest/LinkExpression.d.ts +0 -10
  144. package/lib/src/generated/rest/LinkExpression.js +0 -1
  145. package/lib/src/generated/rest/LinkExpressionInput.d.ts +0 -10
  146. package/lib/src/generated/rest/LinkExpressionInput.js +0 -1
  147. package/lib/src/generated/rest/LinkInput.d.ts +0 -5
  148. package/lib/src/generated/rest/LinkInput.js +0 -2
  149. package/lib/src/generated/rest/LinkLanguageTemplatesRequest.d.ts +0 -3
  150. package/lib/src/generated/rest/LinkLanguageTemplatesRequest.js +0 -2
  151. package/lib/src/generated/rest/LinkMutationRequest.d.ts +0 -12
  152. package/lib/src/generated/rest/LinkMutationRequest.js +0 -1
  153. package/lib/src/generated/rest/LinkMutationResponse.d.ts +0 -9
  154. package/lib/src/generated/rest/LinkMutationResponse.js +0 -1
  155. package/lib/src/generated/rest/LinkMutations.d.ts +0 -6
  156. package/lib/src/generated/rest/LinkMutations.js +0 -1
  157. package/lib/src/generated/rest/LinkMutationsRequest.d.ts +0 -5
  158. package/lib/src/generated/rest/LinkMutationsRequest.js +0 -1
  159. package/lib/src/generated/rest/LinkStatus.d.ts +0 -1
  160. package/lib/src/generated/rest/LinkStatus.js +0 -2
  161. package/lib/src/generated/rest/LinkUpdateInput.d.ts +0 -5
  162. package/lib/src/generated/rest/LinkUpdateInput.js +0 -1
  163. package/lib/src/generated/rest/LockAgentRequest.d.ts +0 -3
  164. package/lib/src/generated/rest/LockAgentRequest.js +0 -2
  165. package/lib/src/generated/rest/LoginUserRequest.d.ts +0 -5
  166. package/lib/src/generated/rest/LoginUserRequest.js +0 -2
  167. package/lib/src/generated/rest/ModelType.d.ts +0 -1
  168. package/lib/src/generated/rest/ModelType.js +0 -2
  169. package/lib/src/generated/rest/NotificationGrantRequest.d.ts +0 -3
  170. package/lib/src/generated/rest/NotificationGrantRequest.js +0 -2
  171. package/lib/src/generated/rest/NotificationInput.d.ts +0 -10
  172. package/lib/src/generated/rest/NotificationInput.js +0 -2
  173. package/lib/src/generated/rest/OpenLinkRequest.d.ts +0 -3
  174. package/lib/src/generated/rest/OpenLinkRequest.js +0 -2
  175. package/lib/src/generated/rest/PermitCapabilityRequest.d.ts +0 -3
  176. package/lib/src/generated/rest/PermitCapabilityRequest.js +0 -2
  177. package/lib/src/generated/rest/PerspectiveInput.d.ts +0 -4
  178. package/lib/src/generated/rest/PerspectiveInput.js +0 -1
  179. package/lib/src/generated/rest/PromptRequest.d.ts +0 -4
  180. package/lib/src/generated/rest/PromptRequest.js +0 -2
  181. package/lib/src/generated/rest/PublicPerspectiveInput.d.ts +0 -4
  182. package/lib/src/generated/rest/PublicPerspectiveInput.js +0 -1
  183. package/lib/src/generated/rest/PublishLanguageRequest.d.ts +0 -5
  184. package/lib/src/generated/rest/PublishLanguageRequest.js +0 -1
  185. package/lib/src/generated/rest/PublishNeighbourhoodRequest.d.ts +0 -6
  186. package/lib/src/generated/rest/PublishNeighbourhoodRequest.js +0 -1
  187. package/lib/src/generated/rest/QueryRequest.d.ts +0 -7
  188. package/lib/src/generated/rest/QueryRequest.js +0 -2
  189. package/lib/src/generated/rest/RemoveLinkRequest.d.ts +0 -5
  190. package/lib/src/generated/rest/RemoveLinkRequest.js +0 -1
  191. package/lib/src/generated/rest/RemoveLinksBulkRequest.d.ts +0 -5
  192. package/lib/src/generated/rest/RemoveLinksBulkRequest.js +0 -1
  193. package/lib/src/generated/rest/RequestCapabilityRequest.d.ts +0 -4
  194. package/lib/src/generated/rest/RequestCapabilityRequest.js +0 -1
  195. package/lib/src/generated/rest/RequestPaymentRequest.d.ts +0 -3
  196. package/lib/src/generated/rest/RequestPaymentRequest.js +0 -2
  197. package/lib/src/generated/rest/RequestVerificationRequest.d.ts +0 -4
  198. package/lib/src/generated/rest/RequestVerificationRequest.js +0 -2
  199. package/lib/src/generated/rest/ResourceInput.d.ts +0 -4
  200. package/lib/src/generated/rest/ResourceInput.js +0 -2
  201. package/lib/src/generated/rest/SetDefaultModelRequest.d.ts +0 -4
  202. package/lib/src/generated/rest/SetDefaultModelRequest.js +0 -1
  203. package/lib/src/generated/rest/SetFreeHostingEnabledRequest.d.ts +0 -3
  204. package/lib/src/generated/rest/SetFreeHostingEnabledRequest.js +0 -2
  205. package/lib/src/generated/rest/SetHotWalletAddressRequest.d.ts +0 -3
  206. package/lib/src/generated/rest/SetHotWalletAddressRequest.js +0 -2
  207. package/lib/src/generated/rest/SetMultiUserRequest.d.ts +0 -3
  208. package/lib/src/generated/rest/SetMultiUserRequest.js +0 -2
  209. package/lib/src/generated/rest/SetOnlineStatusRequest.d.ts +0 -5
  210. package/lib/src/generated/rest/SetOnlineStatusRequest.js +0 -1
  211. package/lib/src/generated/rest/SetStatusRequest.d.ts +0 -3
  212. package/lib/src/generated/rest/SetStatusRequest.js +0 -2
  213. package/lib/src/generated/rest/SetUserFreeAccessRequest.d.ts +0 -4
  214. package/lib/src/generated/rest/SetUserFreeAccessRequest.js +0 -2
  215. package/lib/src/generated/rest/SignMessageRequest.d.ts +0 -3
  216. package/lib/src/generated/rest/SignMessageRequest.js +0 -2
  217. package/lib/src/generated/rest/SignalRequest.d.ts +0 -6
  218. package/lib/src/generated/rest/SignalRequest.js +0 -1
  219. package/lib/src/generated/rest/SubscribeQueryRequest.d.ts +0 -3
  220. package/lib/src/generated/rest/SubscribeQueryRequest.js +0 -2
  221. package/lib/src/generated/rest/SubscribeQueryResponse.d.ts +0 -4
  222. package/lib/src/generated/rest/SubscribeQueryResponse.js +0 -2
  223. package/lib/src/generated/rest/TrustedAgentsRequest.d.ts +0 -3
  224. package/lib/src/generated/rest/TrustedAgentsRequest.js +0 -2
  225. package/lib/src/generated/rest/UnlockAgentRequest.d.ts +0 -4
  226. package/lib/src/generated/rest/UnlockAgentRequest.js +0 -2
  227. package/lib/src/generated/rest/UpdateLinkRequest.d.ts +0 -7
  228. package/lib/src/generated/rest/UpdateLinkRequest.js +0 -1
  229. package/lib/src/generated/rest/UpdatePerspectiveRequest.d.ts +0 -3
  230. package/lib/src/generated/rest/UpdatePerspectiveRequest.js +0 -2
  231. package/lib/src/generated/rest/UpdateProfileRequest.d.ts +0 -5
  232. package/lib/src/generated/rest/UpdateProfileRequest.js +0 -1
  233. package/lib/src/generated/rest/UserStatistics.d.ts +0 -9
  234. package/lib/src/generated/rest/UserStatistics.js +0 -2
  235. package/lib/src/generated/rest/VerificationRequestResult.d.ts +0 -6
  236. package/lib/src/generated/rest/VerificationRequestResult.js +0 -2
  237. package/lib/src/generated/rest/VerifyEmailRequest.d.ts +0 -6
  238. package/lib/src/generated/rest/VerifyEmailRequest.js +0 -2
  239. package/lib/src/generated/rest/VerifySignatureRequest.d.ts +0 -5
  240. package/lib/src/generated/rest/VerifySignatureRequest.js +0 -2
  241. package/lib/src/generated/rest/WriteSettingsRequest.d.ts +0 -3
  242. package/lib/src/generated/rest/WriteSettingsRequest.js +0 -2
  243. package/lib/src/generated/rest/index.d.ts +0 -73
  244. package/lib/src/generated/rest/index.js +0 -8
  245. package/lib/src/generated/rest/routes.d.ts +0 -587
  246. package/lib/src/generated/rest/routes.js +0 -3
  247. package/lib/src/model/query-surreal.d.ts +0 -44
  248. package/lib/src/model/query-surreal.js +0 -249
  249. package/lib/src/model/surreal-utils.d.ts +0 -42
  250. package/lib/src/model/surreal-utils.js +0 -128
  251. package/lib/src/perspectives/PerspectiveProxy.test.d.ts +0 -1
  252. package/lib/src/perspectives/PerspectiveProxy.test.js +0 -34
  253. package/lib/src/restClient.d.ts +0 -52
  254. package/lib/src/restClient.js +0 -227
@@ -2494,3 +2494,648 @@ describe("Ad4mModel instance identity (uniqueness without envelopes)", () => {
2494
2494
  expect(instance.id).toBe("flux://existing-instance");
2495
2495
  });
2496
2496
  });
2497
+
2498
+ describe("Relation writes: to-one batching and scalar coercion", () => {
2499
+ // `Relationship` is the shape that made both of these visible: a record whose
2500
+ // two to-one relations name the things it connects, so it is worthless until
2501
+ // both endpoints are linked, and it is created and pointed in one gesture.
2502
+ @Model({ name: "TestRelationship" })
2503
+ class TestRelationship extends Ad4mModel {
2504
+ @Flag({ through: "we://flag", value: "we://relationship" })
2505
+ flag: string = "";
2506
+
2507
+ @Property({ through: "we://title", required: true })
2508
+ label: string = "";
2509
+
2510
+ @HasOne({ through: "we://relationship_source" })
2511
+ source?: string;
2512
+
2513
+ @HasOne({ through: "we://relationship_target" })
2514
+ target?: string;
2515
+ }
2516
+
2517
+ // A coverage fixture for a branch that already exists in `save()`, not a
2518
+ // modelling pattern being endorsed. No required property, no flag and no
2519
+ // initial value means `buildSHACL` emits the node shape and its property
2520
+ // shapes as normal but with an *empty* constructor-action list, which the
2521
+ // Rust side rejects as "No SHACL constructor found" — so `save()` skips
2522
+ // `createSubject` and calls `innerUpdate(true)` instead. The base expression
2523
+ // exists either way: the `Ad4mModel` constructor mints one, and
2524
+ // `createSubject` writes onto a base rather than creating it.
2525
+ //
2526
+ // Worth naming the real caveat, which is about conformance rather than
2527
+ // writes: a class with no required property and no flag states no criteria,
2528
+ // so nothing structurally distinguishes an instance of it from any other
2529
+ // base expression. That makes it an overlay rather than a class, and it is a
2530
+ // question about SDNA modelling generally rather than about this file.
2531
+ @Model({ name: "TestNoConstructor" })
2532
+ class TestNoConstructor extends Ad4mModel {
2533
+ @HasOne({ through: "we://placed_node" })
2534
+ node?: string;
2535
+ }
2536
+
2537
+ const makePerspective = () =>
2538
+ ({
2539
+ executeAction: jest.fn().mockResolvedValue(undefined),
2540
+ createSubject: jest.fn().mockResolvedValue(undefined),
2541
+ createBatch: jest.fn().mockResolvedValue("batch-generated"),
2542
+ commitBatch: jest.fn().mockResolvedValue(undefined),
2543
+ stringOrTemplateObjectToSubjectClassName: jest
2544
+ .fn()
2545
+ .mockResolvedValue("TestRelationship"),
2546
+ uuid: "test-perspective-uuid",
2547
+ }) as any;
2548
+
2549
+ /** Targets written by `executeAction`, across every call. */
2550
+ const writtenTargets = (perspective: any): string[] =>
2551
+ perspective.executeAction.mock.calls.flatMap((call: any[]) =>
2552
+ (call[2] ?? []).map((param: any) => param.value)
2553
+ );
2554
+
2555
+ /** The batchId argument of each `executeAction` call. */
2556
+ const batchIds = (perspective: any): unknown[] =>
2557
+ perspective.executeAction.mock.calls.map((call: any[]) => call[3]);
2558
+
2559
+ describe("a scalar handed to a relation field", () => {
2560
+ it("writes a link instead of being silently dropped", async () => {
2561
+ // The failure this closes: this call typechecked, ran, resolved, and
2562
+ // wrote no link — leaving a relationship with no endpoints, which only
2563
+ // surfaces later as a reader calling the record malformed.
2564
+ const perspective = makePerspective();
2565
+
2566
+ await TestRelationship.create(
2567
+ perspective,
2568
+ { label: "contradicts", source: "we://block/a", target: "we://block/b" },
2569
+ { batchId: "batch-1" }
2570
+ );
2571
+
2572
+ expect(writtenTargets(perspective)).toEqual(
2573
+ expect.arrayContaining(["we://block/a", "we://block/b"])
2574
+ );
2575
+ });
2576
+
2577
+ it("writes it even when a constructor consumed the properties", async () => {
2578
+ // `create` passes `setProperties: false` when the class has a SHACL
2579
+ // constructor, because `createSubject` writes the values map. A relation
2580
+ // carries `ad4m://adder` rather than `ad4m://setter`, so `createSubject`
2581
+ // drops it — meaning the relation write has to happen here regardless of
2582
+ // that flag, or both paths discard it at once.
2583
+ const perspective = makePerspective();
2584
+
2585
+ await TestRelationship.create(
2586
+ perspective,
2587
+ { label: "contradicts", source: "we://block/a" },
2588
+ { batchId: "batch-1" }
2589
+ );
2590
+
2591
+ expect(perspective.createSubject).toHaveBeenCalled();
2592
+ expect(writtenTargets(perspective)).toContain("we://block/a");
2593
+ });
2594
+
2595
+ it("agrees with the documented array form", async () => {
2596
+ const scalar = makePerspective();
2597
+ await TestRelationship.create(
2598
+ scalar,
2599
+ { label: "x", source: "we://block/a" },
2600
+ { batchId: "b" }
2601
+ );
2602
+
2603
+ const array = makePerspective();
2604
+ await TestRelationship.create(
2605
+ array,
2606
+ { label: "x", source: ["we://block/a"] as any },
2607
+ { batchId: "b" }
2608
+ );
2609
+
2610
+ expect(writtenTargets(scalar)).toEqual(writtenTargets(array));
2611
+ });
2612
+
2613
+ it("still writes the relation when there is no SHACL constructor", async () => {
2614
+ const perspective = makePerspective();
2615
+
2616
+ await TestNoConstructor.create(
2617
+ perspective,
2618
+ { node: "we://block/a" },
2619
+ { batchId: "batch-1" }
2620
+ );
2621
+
2622
+ expect(perspective.createSubject).not.toHaveBeenCalled();
2623
+ expect(writtenTargets(perspective)).toContain("we://block/a");
2624
+ });
2625
+ });
2626
+
2627
+ // The failure this closes: every `save()` of a new instance logged one
2628
+ // Rust-side "declares no setter" warning per ORM-internal field, per flag,
2629
+ // and per empty HasMany relation — none of which are real model data, so
2630
+ // none of them should ever have been offered to `createSubject` at all.
2631
+ describe("initialValues sent to createSubject", () => {
2632
+ @Model({ name: "TestNoisyPost" })
2633
+ class TestNoisyPost extends Ad4mModel {
2634
+ @Flag({ through: "test://post_type", value: "test://post" })
2635
+ type: string = "test://post";
2636
+
2637
+ @Property({ through: "test://title", required: true })
2638
+ title: string = "";
2639
+
2640
+ @HasMany({ through: "test://has_tag" })
2641
+ tags: string[] = [];
2642
+ }
2643
+
2644
+ it("excludes ORM bookkeeping fields, flags, and empty relations", async () => {
2645
+ const perspective = makePerspective();
2646
+
2647
+ await TestNoisyPost.create(perspective, { title: "hello" }, { batchId: "batch-1" });
2648
+
2649
+ expect(perspective.createSubject).toHaveBeenCalled();
2650
+ const initialValues = perspective.createSubject.mock.calls[0][2];
2651
+ expect(initialValues).toEqual({ title: "hello" });
2652
+ expect(initialValues).not.toHaveProperty("_baseExpression");
2653
+ expect(initialValues).not.toHaveProperty("_perspective");
2654
+ expect(initialValues).not.toHaveProperty("type");
2655
+ expect(initialValues).not.toHaveProperty("tags");
2656
+ });
2657
+ });
2658
+
2659
+ describe("generated @HasOne accessors", () => {
2660
+ it("forward batchId, so a to-one link can join a write group", async () => {
2661
+ // Without this the link commits on its own, so every subscriber sees the
2662
+ // record with its relation still empty — a card before its placement.
2663
+ const perspective = makePerspective();
2664
+ const rel = new TestRelationship(perspective, "we://rel/1") as any;
2665
+
2666
+ await rel.setSource("we://block/a", "batch-1");
2667
+ await rel.addTarget("we://block/b", "batch-1");
2668
+ await rel.removeTarget("we://block/b", "batch-1");
2669
+
2670
+ expect(batchIds(perspective)).toEqual(["batch-1", "batch-1", "batch-1"]);
2671
+ });
2672
+
2673
+ it("still work without one", async () => {
2674
+ const perspective = makePerspective();
2675
+ const rel = new TestRelationship(perspective, "we://rel/1") as any;
2676
+
2677
+ await rel.setSource("we://block/a");
2678
+
2679
+ expect(batchIds(perspective)).toEqual([undefined]);
2680
+ });
2681
+ });
2682
+ });
2683
+
2684
+ describe("Polymorphic relations", () => {
2685
+ @Model({ name: "PolyTextBlock" })
2686
+ class PolyTextBlock extends Ad4mModel {
2687
+ @Flag({ through: "we://flag", value: "we://text_block" })
2688
+ flag: string = "";
2689
+ @Property({ through: "we://text" })
2690
+ text: string = "";
2691
+ }
2692
+
2693
+ @Model({ name: "PolyImageBlock" })
2694
+ class PolyImageBlock extends Ad4mModel {
2695
+ @Flag({ through: "we://flag", value: "we://image_block" })
2696
+ flag: string = "";
2697
+ @Property({ through: "we://src" })
2698
+ src: string = "";
2699
+ }
2700
+
2701
+ @Model({ name: "PolyCollection" })
2702
+ class PolyCollection extends Ad4mModel {
2703
+ // No target class — the members are of genuinely different types, which is
2704
+ // the situation `polymorphic` exists for.
2705
+ @HasMany({
2706
+ through: "we://children",
2707
+ polymorphic: true,
2708
+ instantiateAs: () => [PolyTextBlock, PolyImageBlock],
2709
+ })
2710
+ children: string[] = [];
2711
+ }
2712
+
2713
+ const mockPerspective = { uuid: "test" } as any;
2714
+
2715
+ it("constructs each child as the class the executor says it is", () => {
2716
+ const raw = {
2717
+ instances: [
2718
+ {
2719
+ id: "we://c/1",
2720
+ children: [
2721
+ { id: "we://t/1", __subjectClass: "PolyTextBlock", text: "hello" },
2722
+ { id: "we://i/1", __subjectClass: "PolyImageBlock", src: "cat.png" },
2723
+ ],
2724
+ },
2725
+ ],
2726
+ };
2727
+
2728
+ const [collection] = PolyCollection.parseModelResult(mockPerspective, raw, {
2729
+ children: true,
2730
+ }) as any[];
2731
+
2732
+ expect(collection.children[0]).toBeInstanceOf(PolyTextBlock);
2733
+ expect(collection.children[1]).toBeInstanceOf(PolyImageBlock);
2734
+ // The property that only exists on the concrete class — what a base-class
2735
+ // hydration would have dropped before the value ever reached here.
2736
+ expect(collection.children[0].text).toBe("hello");
2737
+ expect(collection.children[1].src).toBe("cat.png");
2738
+ });
2739
+
2740
+ it("maps a child to its class by the name the class itself declares", () => {
2741
+ // The mapping is derived from `@Model({ name })`, not restated beside the
2742
+ // class list — the two cannot drift apart because there is only one of them.
2743
+ expect((PolyTextBlock as any).className).toBe("PolyTextBlock");
2744
+
2745
+ const raw = {
2746
+ instances: [
2747
+ {
2748
+ id: "we://c/1",
2749
+ children: [{ id: "we://t/1", __subjectClass: "PolyTextBlock", text: "hello" }],
2750
+ },
2751
+ ],
2752
+ };
2753
+
2754
+ const [collection] = PolyCollection.parseModelResult(mockPerspective, raw, {
2755
+ children: true,
2756
+ }) as any[];
2757
+
2758
+ expect(collection.children[0]).toBeInstanceOf(PolyTextBlock);
2759
+ });
2760
+
2761
+ it("carries the readings a child was chosen over onto the typed instance", () => {
2762
+ // A base expression can conform to two unrelated classes at once, and the
2763
+ // executor has to pick one to hydrate against. The set it picked from rides
2764
+ // back with the child, so a caller can see there was a choice — and fetch
2765
+ // the other reading by asking that class for this id.
2766
+ const raw = {
2767
+ instances: [
2768
+ {
2769
+ id: "we://c/1",
2770
+ children: [
2771
+ {
2772
+ id: "we://b/1",
2773
+ __subjectClass: "PolyTextBlock",
2774
+ __subjectClasses: ["PolyTextBlock", "PolyBookmark"],
2775
+ text: "hello",
2776
+ },
2777
+ ],
2778
+ },
2779
+ ],
2780
+ };
2781
+
2782
+ const [collection] = PolyCollection.parseModelResult(mockPerspective, raw, {
2783
+ children: true,
2784
+ }) as any[];
2785
+
2786
+ const child = collection.children[0];
2787
+ expect(child).toBeInstanceOf(PolyTextBlock);
2788
+ expect(child.__subjectClasses).toEqual(["PolyTextBlock", "PolyBookmark"]);
2789
+ });
2790
+
2791
+ it("leaves children as data when no instantiateAs is given", () => {
2792
+ @Model({ name: "PolyCollectionNoClasses" })
2793
+ class PolyCollectionNoClasses extends Ad4mModel {
2794
+ @HasMany({ through: "we://children", polymorphic: true })
2795
+ children: string[] = [];
2796
+ }
2797
+
2798
+ const raw = {
2799
+ instances: [
2800
+ {
2801
+ id: "we://c/1",
2802
+ children: [{ id: "we://t/1", __subjectClass: "PolyTextBlock", text: "hello" }],
2803
+ },
2804
+ ],
2805
+ };
2806
+
2807
+ const [collection] = PolyCollectionNoClasses.parseModelResult(mockPerspective, raw, {
2808
+ children: true,
2809
+ }) as any[];
2810
+
2811
+ // Still correct data, just untyped — the concrete class name is present for
2812
+ // a caller that wants to do its own dispatch.
2813
+ expect(collection.children[0].text).toBe("hello");
2814
+ expect(collection.children[0].__subjectClass).toBe("PolyTextBlock");
2815
+ });
2816
+
2817
+ it("keeps a child whose class is not listed, rather than dropping it", () => {
2818
+ // `instantiateAs` says what this call site can construct, not what the
2819
+ // relation may contain. A heterogeneous relation is open by definition, so
2820
+ // an unlisted class must arrive as data — narrowing a read to particular
2821
+ // classes is a thing to ask for in the query, never a side effect of
2822
+ // declaring which constructors happen to be in scope.
2823
+ const raw = {
2824
+ instances: [
2825
+ {
2826
+ id: "we://c/1",
2827
+ children: [
2828
+ { id: "we://t/1", __subjectClass: "PolyTextBlock", text: "hello" },
2829
+ { id: "we://k/1", __subjectClass: "PolyTaskBlock", done: true },
2830
+ ],
2831
+ },
2832
+ ],
2833
+ };
2834
+
2835
+ const [collection] = PolyCollection.parseModelResult(mockPerspective, raw, {
2836
+ children: true,
2837
+ }) as any[];
2838
+
2839
+ expect(collection.children).toHaveLength(2);
2840
+ expect(collection.children[0]).toBeInstanceOf(PolyTextBlock);
2841
+ expect(collection.children[1].done).toBe(true);
2842
+ expect(collection.children[1].__subjectClass).toBe("PolyTaskBlock");
2843
+ });
2844
+
2845
+ it("does not construct an unlisted child as the relation's declared target", () => {
2846
+ // A relation may declare a target *and* read polymorphically — the target
2847
+ // says what the members usually are, not what they must be. A child of some
2848
+ // third class was hydrated against its own shape, so building the declared
2849
+ // class over that JSON would answer `instanceof` for a class it is not,
2850
+ // carrying fields that class never declares.
2851
+ @Model({ name: "PolyBaseBlock" })
2852
+ class PolyBaseBlock extends Ad4mModel {
2853
+ @Property({ through: "we://base" })
2854
+ base: string = "";
2855
+ }
2856
+
2857
+ @Model({ name: "PolyTypedCollection" })
2858
+ class PolyTypedCollection extends Ad4mModel {
2859
+ @HasMany(() => PolyBaseBlock, {
2860
+ through: "we://children",
2861
+ polymorphic: true,
2862
+ instantiateAs: () => [PolyTextBlock],
2863
+ })
2864
+ children: any[] = [];
2865
+ }
2866
+
2867
+ const raw = {
2868
+ instances: [
2869
+ {
2870
+ id: "we://c/1",
2871
+ children: [
2872
+ { id: "we://k/1", __subjectClass: "PolyTaskBlock", done: true },
2873
+ { id: "we://b/1", __subjectClass: "PolyBaseBlock", base: "declared" },
2874
+ ],
2875
+ },
2876
+ ],
2877
+ };
2878
+
2879
+ const [collection] = PolyTypedCollection.parseModelResult(mockPerspective, raw, {
2880
+ children: true,
2881
+ }) as any[];
2882
+
2883
+ const [unlisted, declared] = collection.children;
2884
+ expect(unlisted).toBeDefined();
2885
+ expect(unlisted).not.toBeInstanceOf(PolyBaseBlock);
2886
+ expect(unlisted.done).toBe(true);
2887
+ expect(unlisted.__subjectClass).toBe("PolyTaskBlock");
2888
+ // The declared target is still right when it is the class the executor named.
2889
+ expect(declared).toBeInstanceOf(PolyBaseBlock);
2890
+ expect(declared.base).toBe("declared");
2891
+ });
2892
+
2893
+ it("does not use the declared target for another class when no classes are named", () => {
2894
+ // Naming no classes to build is not the same as authorising the declared
2895
+ // target to stand in for all of them. Without `instantiateAs` there is
2896
+ // simply nothing this side can construct for a class it was not told about.
2897
+ @Model({ name: "PolyBaseOnlyBlock" })
2898
+ class PolyBaseOnlyBlock extends Ad4mModel {
2899
+ @Property({ through: "we://base" })
2900
+ base: string = "";
2901
+ }
2902
+
2903
+ @Model({ name: "PolyTypedNoClasses" })
2904
+ class PolyTypedNoClasses extends Ad4mModel {
2905
+ @HasMany(() => PolyBaseOnlyBlock, { through: "we://children", polymorphic: true })
2906
+ children: any[] = [];
2907
+ }
2908
+
2909
+ const raw = {
2910
+ instances: [
2911
+ {
2912
+ id: "we://c/1",
2913
+ children: [
2914
+ { id: "we://k/1", __subjectClass: "PolyTaskBlock", done: true },
2915
+ { id: "we://b/1", __subjectClass: "PolyBaseOnlyBlock", base: "declared" },
2916
+ ],
2917
+ },
2918
+ ],
2919
+ };
2920
+
2921
+ const [collection] = PolyTypedNoClasses.parseModelResult(mockPerspective, raw, {
2922
+ children: true,
2923
+ }) as any[];
2924
+
2925
+ const [unlisted, declared] = collection.children;
2926
+ expect(unlisted).not.toBeInstanceOf(PolyBaseOnlyBlock);
2927
+ expect(unlisted.done).toBe(true);
2928
+ expect(unlisted.__subjectClass).toBe("PolyTaskBlock");
2929
+ expect(declared).toBeInstanceOf(PolyBaseOnlyBlock);
2930
+ expect(declared.base).toBe("declared");
2931
+ });
2932
+
2933
+ it("calls instantiateAs late, so a circular import can still resolve", () => {
2934
+ let defined = false;
2935
+ @Model({ name: "PolyLateCollection" })
2936
+ class PolyLateCollection extends Ad4mModel {
2937
+ // Evaluated at decoration time this would throw, the way an array literal
2938
+ // naming a class from further round an import cycle would.
2939
+ @HasMany({
2940
+ through: "we://children",
2941
+ polymorphic: true,
2942
+ instantiateAs: () => {
2943
+ if (!defined) throw new ReferenceError("class not defined yet");
2944
+ return [PolyTextBlock];
2945
+ },
2946
+ })
2947
+ children: string[] = [];
2948
+ }
2949
+
2950
+ defined = true;
2951
+ const raw = {
2952
+ instances: [
2953
+ {
2954
+ id: "we://c/1",
2955
+ children: [{ id: "we://t/1", __subjectClass: "PolyTextBlock", text: "hello" }],
2956
+ },
2957
+ ],
2958
+ };
2959
+
2960
+ const [collection] = PolyLateCollection.parseModelResult(mockPerspective, raw, {
2961
+ children: true,
2962
+ }) as any[];
2963
+
2964
+ expect(collection.children[0]).toBeInstanceOf(PolyTextBlock);
2965
+ });
2966
+
2967
+ it("asks the executor for polymorphic hydration without the caller repeating it", () => {
2968
+ // The relation being heterogeneous is a fact about the data, so declaring it
2969
+ // on the model should be enough — `include: { children: true }` must still
2970
+ // arrive at the executor as a polymorphic read.
2971
+ const { queryJson } = (PolyCollection as any).prepareModelQueryParams({
2972
+ include: { children: true },
2973
+ });
2974
+
2975
+ expect(JSON.parse(queryJson).include.children).toEqual({
2976
+ polymorphic: true,
2977
+ preferClasses: ["PolyTextBlock", "PolyImageBlock"],
2978
+ });
2979
+ });
2980
+
2981
+ it("sends the classes it can build as the classes it wants, in declaration order", () => {
2982
+ // The two questions have one answer: what this call site can construct is
2983
+ // what it wants its targets read as. Sent with the query rather than applied
2984
+ // to the results, so the same request gives the same reading to anyone.
2985
+ const { queryJson } = (PolyCollection as any).prepareModelQueryParams({
2986
+ include: { children: true },
2987
+ });
2988
+
2989
+ // Declaration order is the preference order — a target conforming to two of
2990
+ // them is read as whichever was named first.
2991
+ expect(JSON.parse(queryJson).include.children.preferClasses).toEqual([
2992
+ "PolyTextBlock",
2993
+ "PolyImageBlock",
2994
+ ]);
2995
+ });
2996
+
2997
+ it("lets an explicit preference at the call site win over the declaration", () => {
2998
+ const { queryJson } = (PolyCollection as any).prepareModelQueryParams({
2999
+ include: { children: { preferClasses: ["PolyBookmark"] } },
3000
+ });
3001
+
3002
+ expect(JSON.parse(queryJson).include.children.preferClasses).toEqual(["PolyBookmark"]);
3003
+ });
3004
+
3005
+ it("sends no preference for a polymorphic relation that names no classes", () => {
3006
+ @Model({ name: "PolyCollectionUndeclared" })
3007
+ class PolyCollectionUndeclared extends Ad4mModel {
3008
+ @HasMany({ through: "we://children", polymorphic: true })
3009
+ children: string[] = [];
3010
+ }
3011
+
3012
+ const { queryJson } = (PolyCollectionUndeclared as any).prepareModelQueryParams({
3013
+ include: { children: true },
3014
+ });
3015
+
3016
+ // Nothing to prefer, so nothing is sent and the executor ranks by
3017
+ // specificity exactly as it did before any of this existed.
3018
+ expect(JSON.parse(queryJson).include.children).toEqual({ polymorphic: true });
3019
+ });
3020
+
3021
+ it("lets an explicit false at the call site win", () => {
3022
+ const { queryJson } = (PolyCollection as any).prepareModelQueryParams({
3023
+ include: { children: { polymorphic: false } },
3024
+ });
3025
+
3026
+ expect(JSON.parse(queryJson).include.children.polymorphic).toBe(false);
3027
+ });
3028
+
3029
+ it("applies the default at every depth of a nested include", () => {
3030
+ // `sections` is a plain typed relation, so the nested `children` is read off
3031
+ // PolyCollection rather than off the class being queried. Left to the top
3032
+ // level, the default would never reach it and the include would arrive at
3033
+ // the executor with no shape to resolve — the query fails outright.
3034
+ @Model({ name: "PolyPage" })
3035
+ class PolyPage extends Ad4mModel {
3036
+ @HasMany(() => PolyCollection, { through: "we://sections" })
3037
+ sections: any[] = [];
3038
+ }
3039
+
3040
+ const { queryJson } = (PolyPage as any).prepareModelQueryParams({
3041
+ include: { sections: { include: { children: true } } },
3042
+ });
3043
+
3044
+ const include = JSON.parse(queryJson).include;
3045
+ expect(include.sections.include.children).toEqual({
3046
+ polymorphic: true,
3047
+ preferClasses: ["PolyTextBlock", "PolyImageBlock"],
3048
+ });
3049
+ });
3050
+
3051
+ it("lets an explicit false win at depth too", () => {
3052
+ @Model({ name: "PolyPageExplicit" })
3053
+ class PolyPageExplicit extends Ad4mModel {
3054
+ @HasMany(() => PolyCollection, { through: "we://sections" })
3055
+ sections: any[] = [];
3056
+ }
3057
+
3058
+ const { queryJson } = (PolyPageExplicit as any).prepareModelQueryParams({
3059
+ include: { sections: { include: { children: { polymorphic: false } } } },
3060
+ });
3061
+
3062
+ expect(JSON.parse(queryJson).include.sections.include.children.polymorphic).toBe(false);
3063
+ });
3064
+ });
3065
+
3066
+ describe("Ordered relations", () => {
3067
+ @Model({ name: "OrderedColumn" })
3068
+ class OrderedColumn extends Ad4mModel {
3069
+ @HasMany({ through: "kanban://has_task", ordering: { strategy: "linkedList" } })
3070
+ tasks: string[] = [];
3071
+
3072
+ @HasMany({ through: "kanban://archived" })
3073
+ archived: string[] = [];
3074
+ }
3075
+
3076
+ const mockPerspective = { uuid: "test" } as any;
3077
+
3078
+ it("declares its ordering in SHACL", () => {
3079
+ const { shape } = (OrderedColumn as any).generateSHACL();
3080
+ const tasks = shape.properties.find((p: any) => p.name === "tasks");
3081
+ expect(tasks.ordering).toBe("linkedList");
3082
+ });
3083
+
3084
+ it("declares the predicate the ordering entries are stored under", () => {
3085
+ // Entries live on the parent under one shared predicate. The instance query
3086
+ // builds its predicate filter from the shape's declared paths, so without
3087
+ // this the read that needs the ordering links filters them out.
3088
+ const { shape } = (OrderedColumn as any).generateSHACL();
3089
+ const orderProp = shape.properties.find(
3090
+ (p: any) => p.path === "ad4m://collection_order"
3091
+ );
3092
+ expect(orderProp).toBeDefined();
3093
+ });
3094
+
3095
+ it("omits that predicate when nothing on the class is ordered", () => {
3096
+ @Model({ name: "UnorderedOnly" })
3097
+ class UnorderedOnly extends Ad4mModel {
3098
+ @HasMany({ through: "kanban://archived" })
3099
+ archived: string[] = [];
3100
+ }
3101
+ const { shape } = (UnorderedOnly as any).generateSHACL();
3102
+ expect(
3103
+ shape.properties.find((p: any) => p.path === "ad4m://collection_order")
3104
+ ).toBeUndefined();
3105
+ });
3106
+
3107
+ it("treats a reorder as a change", () => {
3108
+ // The whole point: for an ordered relation the sequence *is* the state, so
3109
+ // sorting before comparing would make save() a no-op for the one edit this
3110
+ // feature exists to support.
3111
+ const column = new OrderedColumn(mockPerspective, "kanban://col/1") as any;
3112
+ column.tasks = ["a", "b", "c"];
3113
+ column.takeSnapshot();
3114
+
3115
+ column.tasks = ["c", "a", "b"];
3116
+ expect(column.changedFields()).toContain("tasks");
3117
+ });
3118
+
3119
+ it("still treats a reorder of an unordered relation as no change", () => {
3120
+ // An unordered relation is a set — the executor returns it by link
3121
+ // timestamp, so assigning the same members in another order changed nothing.
3122
+ const column = new OrderedColumn(mockPerspective, "kanban://col/1") as any;
3123
+ column.archived = ["a", "b", "c"];
3124
+ column.takeSnapshot();
3125
+
3126
+ column.archived = ["c", "a", "b"];
3127
+ expect(column.changedFields()).not.toContain("archived");
3128
+ });
3129
+
3130
+ it("round-trips ordering through SHACL links", () => {
3131
+ const { shape } = (OrderedColumn as any).generateSHACL();
3132
+ const links = shape.toLinks().map((l: any) => ({
3133
+ source: l.source,
3134
+ predicate: l.predicate,
3135
+ target: l.target,
3136
+ }));
3137
+ const reconstructed = SHACLShape.fromLinks(links as any, shape.nodeShapeUri);
3138
+ const tasks = reconstructed.properties.find((p: any) => p.name === "tasks");
3139
+ expect(tasks!.ordering).toBe("linkedList");
3140
+ });
3141
+ });