@coasys/ad4m 0.12.0 → 0.13.0-postmessage-ws-proxy.0
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.
- package/README.md +2 -25
- package/jest-setup.ts +1 -1
- package/lib/index.cjs +7444 -13939
- package/lib/index.js +5322 -11888
- package/lib/src/Ad4mClient.d.ts +9 -3
- package/lib/src/Ad4mClient.js +40 -13
- package/lib/src/Literal.js +6 -5
- package/lib/src/agent/Agent.js +26 -272
- package/lib/src/agent/AgentClient.d.ts +33 -21
- package/lib/src/agent/AgentClient.js +180 -373
- package/lib/src/agent/AgentStatus.js +2 -37
- package/lib/src/ai/AIClient.d.ts +12 -4
- package/lib/src/ai/AIClient.js +81 -285
- package/lib/src/ai/AITypes.d.ts +55 -0
- package/lib/src/ai/AITypes.js +18 -0
- package/lib/src/ai/Tasks.js +10 -133
- package/lib/src/apiClient.d.ts +53 -0
- package/lib/src/apiClient.js +234 -0
- package/lib/src/cache/PersistentCache.d.ts +40 -0
- package/lib/src/cache/PersistentCache.js +139 -0
- package/lib/src/expression/Expression.d.ts +1 -1
- package/lib/src/expression/Expression.js +13 -122
- package/lib/src/expression/ExpressionClient.d.ts +11 -3
- package/lib/src/expression/ExpressionClient.js +120 -75
- package/lib/src/expression/ExpressionRef.js +4 -27
- package/lib/src/generated/api/AIModelLoadingStatus.d.ts +7 -0
- package/lib/src/generated/api/AIModelLoadingStatus.js +2 -0
- package/lib/src/generated/api/AddLinkExpressionRequest.d.ts +6 -0
- package/lib/src/generated/api/AddLinkExpressionRequest.js +1 -0
- package/lib/src/generated/api/AddLinkRequest.d.ts +6 -0
- package/lib/src/generated/api/AddLinkRequest.js +1 -0
- package/lib/src/generated/api/AddLinksBulkRequest.d.ts +6 -0
- package/lib/src/generated/api/AddLinksBulkRequest.js +1 -0
- package/lib/src/generated/api/AddSdnaRequest.d.ts +6 -0
- package/lib/src/generated/api/AddSdnaRequest.js +2 -0
- package/lib/src/generated/api/ApplyTemplateRequest.d.ts +4 -0
- package/lib/src/generated/api/ApplyTemplateRequest.js +2 -0
- package/lib/src/generated/api/AuthInfoInput.d.ts +10 -0
- package/lib/src/generated/api/AuthInfoInput.js +1 -0
- package/lib/src/generated/api/CapabilityInput.d.ts +5 -0
- package/lib/src/generated/api/CapabilityInput.js +1 -0
- package/lib/src/generated/api/CommitBatchRequest.d.ts +3 -0
- package/lib/src/generated/api/CommitBatchRequest.js +2 -0
- package/lib/src/generated/api/ComputeLogEntry.d.ts +9 -0
- package/lib/src/generated/api/ComputeLogEntry.js +2 -0
- package/lib/src/generated/api/CreateExpressionRequest.d.ts +4 -0
- package/lib/src/generated/api/CreateExpressionRequest.js +2 -0
- package/lib/src/generated/api/CreatePerspectiveRequest.d.ts +3 -0
- package/lib/src/generated/api/CreatePerspectiveRequest.js +2 -0
- package/lib/src/generated/api/CreateSubjectRequest.d.ts +6 -0
- package/lib/src/generated/api/CreateSubjectRequest.js +2 -0
- package/lib/src/generated/api/EmbedRequest.d.ts +4 -0
- package/lib/src/generated/api/EmbedRequest.js +2 -0
- package/lib/src/generated/api/EntanglementProofInput.d.ts +6 -0
- package/lib/src/generated/api/EntanglementProofInput.js +2 -0
- package/lib/src/generated/api/ExecuteCommandsRequest.d.ts +4 -0
- package/lib/src/generated/api/ExecuteCommandsRequest.js +2 -0
- package/lib/src/generated/api/ExportRequest.d.ts +5 -0
- package/lib/src/generated/api/ExportRequest.js +2 -0
- package/lib/src/generated/api/ExpressionManyRequest.d.ts +3 -0
- package/lib/src/generated/api/ExpressionManyRequest.js +2 -0
- package/lib/src/generated/api/ExpressionProof.d.ts +4 -0
- package/lib/src/generated/api/ExpressionProof.js +2 -0
- package/lib/src/generated/api/ExpressionProofInput.d.ts +6 -0
- package/lib/src/generated/api/ExpressionProofInput.js +2 -0
- package/lib/src/generated/api/FriendSendMessageRequest.d.ts +3 -0
- package/lib/src/generated/api/FriendSendMessageRequest.js +2 -0
- package/lib/src/generated/api/FriendsListRequest.d.ts +3 -0
- package/lib/src/generated/api/FriendsListRequest.js +2 -0
- package/lib/src/generated/api/GenerateAgentRequest.d.ts +3 -0
- package/lib/src/generated/api/GenerateAgentRequest.js +2 -0
- package/lib/src/generated/api/GenerateJwtRequest.d.ts +4 -0
- package/lib/src/generated/api/GenerateJwtRequest.js +2 -0
- package/lib/src/generated/api/GetSubjectDataRequest.d.ts +4 -0
- package/lib/src/generated/api/GetSubjectDataRequest.js +2 -0
- package/lib/src/generated/api/ImportAgentRequest.d.ts +6 -0
- package/lib/src/generated/api/ImportAgentRequest.js +2 -0
- package/lib/src/generated/api/ImportRequest.d.ts +4 -0
- package/lib/src/generated/api/ImportRequest.js +2 -0
- package/lib/src/generated/api/JoinNeighbourhoodRequest.d.ts +3 -0
- package/lib/src/generated/api/JoinNeighbourhoodRequest.js +2 -0
- package/lib/src/generated/api/LanguageMetaInput.d.ts +6 -0
- package/lib/src/generated/api/LanguageMetaInput.js +2 -0
- package/lib/src/generated/api/Link.d.ts +5 -0
- package/lib/src/generated/api/Link.js +2 -0
- package/lib/src/generated/api/LinkExpression.d.ts +10 -0
- package/lib/src/generated/api/LinkExpression.js +1 -0
- package/lib/src/generated/api/LinkExpressionInput.d.ts +10 -0
- package/lib/src/generated/api/LinkExpressionInput.js +1 -0
- package/lib/src/generated/api/LinkInput.d.ts +5 -0
- package/lib/src/generated/api/LinkInput.js +2 -0
- package/lib/src/generated/api/LinkLanguageTemplatesRequest.d.ts +3 -0
- package/lib/src/generated/api/LinkLanguageTemplatesRequest.js +2 -0
- package/lib/src/generated/api/LinkMutations.d.ts +6 -0
- package/lib/src/generated/api/LinkMutations.js +1 -0
- package/lib/src/generated/api/LinkStatus.d.ts +1 -0
- package/lib/src/generated/api/LinkStatus.js +2 -0
- package/lib/src/generated/api/LockAgentRequest.d.ts +3 -0
- package/lib/src/generated/api/LockAgentRequest.js +2 -0
- package/lib/src/generated/api/ModelType.d.ts +1 -0
- package/lib/src/generated/api/ModelType.js +2 -0
- package/lib/src/generated/api/NotificationInput.d.ts +10 -0
- package/lib/src/generated/api/NotificationInput.js +2 -0
- package/lib/src/generated/api/OpenLinkRequest.d.ts +3 -0
- package/lib/src/generated/api/OpenLinkRequest.js +2 -0
- package/lib/src/generated/api/PermitCapabilityRequest.d.ts +3 -0
- package/lib/src/generated/api/PermitCapabilityRequest.js +2 -0
- package/lib/src/generated/api/PerspectiveInput.d.ts +4 -0
- package/lib/src/generated/api/PerspectiveInput.js +1 -0
- package/lib/src/generated/api/PromptRequest.d.ts +4 -0
- package/lib/src/generated/api/PromptRequest.js +2 -0
- package/lib/src/generated/api/PublishLanguageRequest.d.ts +5 -0
- package/lib/src/generated/api/PublishLanguageRequest.js +1 -0
- package/lib/src/generated/api/PublishNeighbourhoodRequest.d.ts +6 -0
- package/lib/src/generated/api/PublishNeighbourhoodRequest.js +1 -0
- package/lib/src/generated/api/QueryRequest.d.ts +7 -0
- package/lib/src/generated/api/QueryRequest.js +2 -0
- package/lib/src/generated/api/RemoveLinkRequest.d.ts +5 -0
- package/lib/src/generated/api/RemoveLinkRequest.js +1 -0
- package/lib/src/generated/api/RemoveLinksBulkRequest.d.ts +5 -0
- package/lib/src/generated/api/RemoveLinksBulkRequest.js +1 -0
- package/lib/src/generated/api/ResourceInput.d.ts +4 -0
- package/lib/src/generated/api/ResourceInput.js +2 -0
- package/lib/src/generated/api/SetDefaultModelRequest.d.ts +4 -0
- package/lib/src/generated/api/SetDefaultModelRequest.js +1 -0
- package/lib/src/generated/api/SetFreeHostingEnabledRequest.d.ts +3 -0
- package/lib/src/generated/api/SetFreeHostingEnabledRequest.js +2 -0
- package/lib/src/generated/api/SetMultiUserRequest.d.ts +3 -0
- package/lib/src/generated/api/SetMultiUserRequest.js +2 -0
- package/lib/src/generated/api/SetStatusRequest.d.ts +3 -0
- package/lib/src/generated/api/SetStatusRequest.js +2 -0
- package/lib/src/generated/api/SignMessageRequest.d.ts +3 -0
- package/lib/src/generated/api/SignMessageRequest.js +2 -0
- package/lib/src/generated/api/TrustedAgentsRequest.d.ts +3 -0
- package/lib/src/generated/api/TrustedAgentsRequest.js +2 -0
- package/lib/src/generated/api/UnlockAgentRequest.d.ts +4 -0
- package/lib/src/generated/api/UnlockAgentRequest.js +2 -0
- package/lib/src/generated/api/UpdateLinkRequest.d.ts +7 -0
- package/lib/src/generated/api/UpdateLinkRequest.js +1 -0
- package/lib/src/generated/api/UpdatePerspectiveRequest.d.ts +3 -0
- package/lib/src/generated/api/UpdatePerspectiveRequest.js +2 -0
- package/lib/src/generated/api/UserStatistics.d.ts +9 -0
- package/lib/src/generated/api/UserStatistics.js +2 -0
- package/lib/src/generated/api/VerificationRequestResult.d.ts +6 -0
- package/lib/src/generated/api/VerificationRequestResult.js +2 -0
- package/lib/src/generated/api/VerifySignatureRequest.d.ts +5 -0
- package/lib/src/generated/api/VerifySignatureRequest.js +2 -0
- package/lib/src/generated/api/WriteSettingsRequest.d.ts +3 -0
- package/lib/src/generated/api/WriteSettingsRequest.js +2 -0
- package/lib/src/generated/api/index.d.ts +42 -0
- package/lib/src/generated/api/index.js +7 -0
- package/lib/src/index.d.ts +7 -2
- package/lib/src/index.js +7 -2
- package/lib/src/jestSetup.d.ts +0 -1
- package/lib/src/jestSetup.js +1 -1
- package/lib/src/language/Icon.js +2 -21
- package/lib/src/language/Language.d.ts +26 -176
- package/lib/src/language/Language.js +32 -72
- package/lib/src/language/LanguageClient.d.ts +2 -2
- package/lib/src/language/LanguageClient.js +15 -105
- package/lib/src/language/LanguageHandle.js +2 -41
- package/lib/src/language/LanguageMeta.js +4 -75
- package/lib/src/language/LanguageRef.js +2 -25
- package/lib/src/links/Links.js +14 -111
- package/lib/src/model/Ad4mModel.d.ts +150 -62
- package/lib/src/model/Ad4mModel.js +689 -417
- package/lib/src/model/Ad4mModel.test.js +1434 -688
- package/lib/src/model/ModelQueryBuilder.d.ts +59 -38
- package/lib/src/model/ModelQueryBuilder.js +317 -153
- package/lib/src/model/Subject.js +6 -6
- package/lib/src/model/decorators.d.ts +36 -8
- package/lib/src/model/decorators.js +41 -14
- package/lib/src/model/hydration-batch.d.ts +34 -0
- package/lib/src/model/hydration-batch.js +147 -0
- package/lib/src/model/hydration-batching.test.d.ts +7 -0
- package/lib/src/model/hydration-batching.test.js +456 -0
- package/lib/src/model/hydration.d.ts +3 -92
- package/lib/src/model/hydration.js +3 -691
- package/lib/src/model/index.d.ts +3 -4
- package/lib/src/model/index.js +3 -4
- package/lib/src/model/json-schema.js +2 -2
- package/lib/src/model/model-manifest.d.ts +41 -0
- package/lib/src/model/model-manifest.js +11 -0
- package/lib/src/model/query-cache.d.ts +30 -0
- package/lib/src/model/query-cache.js +66 -0
- package/lib/src/model/query-cache.test.d.ts +1 -0
- package/lib/src/model/query-cache.test.js +43 -0
- package/lib/src/model/query-common.d.ts +1 -1
- package/lib/src/model/query-common.js +1 -1
- package/lib/src/model/query-sparql-batch.d.ts +17 -0
- package/lib/src/model/query-sparql-batch.js +260 -0
- package/lib/src/model/query-sparql.d.ts +51 -0
- package/lib/src/model/query-sparql.js +466 -0
- package/lib/src/model/query-sparql.test.d.ts +1 -0
- package/lib/src/model/query-sparql.test.js +312 -0
- package/lib/src/model/{surreal-utils.d.ts → query-utils.d.ts} +13 -9
- package/lib/src/model/query-utils.js +189 -0
- package/lib/src/model/relation-filtering.test.js +15 -15
- package/lib/src/model/sdna.js +1 -1
- package/lib/src/model/shacl-gen.js +46 -18
- package/lib/src/model/subscription-delta.test.d.ts +24 -0
- package/lib/src/model/subscription-delta.test.js +180 -0
- package/lib/src/model/subscription-pool.d.ts +39 -0
- package/lib/src/model/subscription-pool.js +165 -0
- package/lib/src/model/types.d.ts +60 -5
- package/lib/src/model/types.js +5 -2
- package/lib/src/neighbourhood/Neighbourhood.js +4 -32
- package/lib/src/neighbourhood/NeighbourhoodClient.d.ts +3 -3
- package/lib/src/neighbourhood/NeighbourhoodClient.js +40 -203
- package/lib/src/perspectives/LinkQuery.js +2 -42
- package/lib/src/perspectives/Perspective.d.ts +1 -1
- package/lib/src/perspectives/Perspective.js +10 -52
- package/lib/src/perspectives/PerspectiveClient.d.ts +22 -32
- package/lib/src/perspectives/PerspectiveClient.js +189 -454
- package/lib/src/perspectives/PerspectiveClient.test.d.ts +1 -0
- package/lib/src/perspectives/PerspectiveClient.test.js +224 -0
- package/lib/src/perspectives/PerspectiveDiff.js +4 -31
- package/lib/src/perspectives/PerspectiveHandle.js +3 -43
- package/lib/src/perspectives/PerspectiveProxy.d.ts +156 -78
- package/lib/src/perspectives/PerspectiveProxy.js +474 -389
- package/lib/src/perspectives/PerspectiveResolver.d.ts +0 -1
- package/lib/src/perspectives/PerspectiveResolver.js +0 -11
- package/lib/src/perspectives/WakerSubscriptionManager.d.ts +3 -3
- package/lib/src/perspectives/WakerSubscriptionManager.js +12 -12
- package/lib/src/runtime/RuntimeClient.d.ts +34 -6
- package/lib/src/runtime/RuntimeClient.js +131 -362
- package/lib/src/runtime/RuntimeResolver.d.ts +28 -1
- package/lib/src/runtime/RuntimeResolver.js +197 -4
- package/lib/src/runtime/RuntimeTypes.d.ts +101 -0
- package/lib/src/runtime/RuntimeTypes.js +45 -0
- package/lib/src/schema.gql +27 -1
- package/lib/src/shacl/SHACLFlow.d.ts +1 -1
- package/lib/src/shacl/SHACLFlow.js +9 -9
- package/lib/src/shacl/SHACLShape.d.ts +8 -1
- package/lib/src/shacl/SHACLShape.js +57 -38
- package/lib/src/shacl/SHACLShape.test.js +82 -0
- package/lib/src/typeDefs.js +3 -602
- package/lib/src/utils.d.ts +6 -6
- package/lib/src/utils.js +6 -6
- package/package.json +6 -18
- package/rollup.config.js +0 -7
- package/src/Ad4mClient.test.ts +1192 -1288
- package/src/Ad4mClient.ts +46 -15
- package/src/Literal.test.ts +10 -5
- package/src/Literal.ts +6 -5
- package/src/agent/Agent.ts +0 -99
- package/src/agent/AgentClient.ts +238 -465
- package/src/agent/AgentStatus.ts +0 -12
- package/src/ai/AIClient.ts +96 -296
- package/src/ai/AITypes.ts +66 -0
- package/src/ai/Tasks.ts +0 -52
- package/src/apiClient.ts +287 -0
- package/src/cache/PersistentCache.ts +145 -0
- package/src/cache/cache.test.ts +713 -0
- package/src/expression/Expression.ts +3 -43
- package/src/expression/ExpressionClient.ts +148 -77
- package/src/expression/ExpressionRef.ts +2 -8
- package/src/generated/api/AIModelLoadingStatus.ts +3 -0
- package/src/generated/api/AddLinkExpressionRequest.ts +4 -0
- package/src/generated/api/AddLinkRequest.ts +4 -0
- package/src/generated/api/AddLinksBulkRequest.ts +4 -0
- package/src/generated/api/AddSdnaRequest.ts +3 -0
- package/src/generated/api/ApplyTemplateRequest.ts +3 -0
- package/src/generated/api/AuthInfoInput.ts +4 -0
- package/src/generated/api/CapabilityInput.ts +4 -0
- package/src/generated/api/CommitBatchRequest.ts +3 -0
- package/src/generated/api/ComputeLogEntry.ts +3 -0
- package/src/generated/api/CreateExpressionRequest.ts +3 -0
- package/src/generated/api/CreatePerspectiveRequest.ts +3 -0
- package/src/generated/api/CreateSubjectRequest.ts +3 -0
- package/src/generated/api/EmbedRequest.ts +3 -0
- package/src/generated/api/EntanglementProofInput.ts +3 -0
- package/src/generated/api/ExecuteCommandsRequest.ts +3 -0
- package/src/generated/api/ExportRequest.ts +3 -0
- package/src/generated/api/ExpressionManyRequest.ts +3 -0
- package/src/generated/api/ExpressionProof.ts +3 -0
- package/src/generated/api/ExpressionProofInput.ts +3 -0
- package/src/generated/api/FriendSendMessageRequest.ts +3 -0
- package/src/generated/api/FriendsListRequest.ts +3 -0
- package/src/generated/api/GenerateAgentRequest.ts +3 -0
- package/src/generated/api/GenerateJwtRequest.ts +3 -0
- package/src/generated/api/GetSubjectDataRequest.ts +3 -0
- package/src/generated/api/ImportAgentRequest.ts +3 -0
- package/src/generated/api/ImportRequest.ts +3 -0
- package/src/generated/api/JoinNeighbourhoodRequest.ts +3 -0
- package/src/generated/api/LanguageMetaInput.ts +3 -0
- package/src/generated/api/Link.ts +3 -0
- package/src/generated/api/LinkExpression.ts +6 -0
- package/src/generated/api/LinkExpressionInput.ts +6 -0
- package/src/generated/api/LinkInput.ts +3 -0
- package/src/generated/api/LinkLanguageTemplatesRequest.ts +3 -0
- package/src/generated/api/LinkMutations.ts +5 -0
- package/src/generated/api/LinkStatus.ts +3 -0
- package/src/generated/api/LockAgentRequest.ts +3 -0
- package/src/generated/api/ModelType.ts +3 -0
- package/src/generated/api/NotificationInput.ts +3 -0
- package/src/generated/api/OpenLinkRequest.ts +3 -0
- package/src/generated/api/PermitCapabilityRequest.ts +3 -0
- package/src/generated/api/PerspectiveInput.ts +4 -0
- package/src/generated/api/PromptRequest.ts +3 -0
- package/src/generated/api/PublishLanguageRequest.ts +4 -0
- package/src/generated/api/PublishNeighbourhoodRequest.ts +4 -0
- package/src/generated/api/QueryRequest.ts +6 -0
- package/src/generated/api/RemoveLinkRequest.ts +4 -0
- package/src/generated/api/RemoveLinksBulkRequest.ts +4 -0
- package/src/generated/api/ResourceInput.ts +3 -0
- package/src/generated/api/SetDefaultModelRequest.ts +4 -0
- package/src/generated/api/SetFreeHostingEnabledRequest.ts +3 -0
- package/src/generated/api/SetMultiUserRequest.ts +3 -0
- package/src/generated/api/SetStatusRequest.ts +3 -0
- package/src/generated/api/SignMessageRequest.ts +3 -0
- package/src/generated/api/TrustedAgentsRequest.ts +3 -0
- package/src/generated/api/UnlockAgentRequest.ts +3 -0
- package/src/generated/api/UpdateLinkRequest.ts +5 -0
- package/src/generated/api/UpdatePerspectiveRequest.ts +3 -0
- package/src/generated/api/UserStatistics.ts +3 -0
- package/src/generated/api/VerificationRequestResult.ts +3 -0
- package/src/generated/api/VerifySignatureRequest.ts +3 -0
- package/src/generated/api/WriteSettingsRequest.ts +3 -0
- package/src/generated/api/index.ts +49 -0
- package/src/index.ts +7 -2
- package/src/jestSetup.ts +1 -1
- package/src/language/Icon.ts +0 -4
- package/src/language/Language.ts +51 -248
- package/src/language/LanguageClient.ts +21 -132
- package/src/language/LanguageHandle.ts +0 -14
- package/src/language/LanguageMeta.ts +0 -29
- package/src/language/LanguageRef.ts +0 -7
- package/src/links/Links.ts +0 -37
- package/src/model/Ad4mModel.test.ts +1690 -777
- package/src/model/Ad4mModel.ts +749 -477
- package/src/model/ModelQueryBuilder.ts +356 -171
- package/src/model/decorators.ts +71 -22
- package/src/model/hydration.ts +3 -772
- package/src/model/index.ts +3 -4
- package/src/model/json-schema.ts +2 -2
- package/src/model/query-cache.test.ts +54 -0
- package/src/model/query-cache.ts +79 -0
- package/src/model/query-common.ts +1 -1
- package/src/model/query-sparql.test.ts +376 -0
- package/src/model/query-sparql.ts +504 -0
- package/src/model/query-utils.ts +209 -0
- package/src/model/relation-filtering.test.ts +15 -15
- package/src/model/sdna.ts +1 -1
- package/src/model/shacl-gen.ts +47 -17
- package/src/model/types.ts +65 -5
- package/src/neighbourhood/Neighbourhood.ts +0 -9
- package/src/neighbourhood/NeighbourhoodClient.ts +42 -207
- package/src/neighbourhood/NeighbourhoodProxy.test.ts +34 -36
- package/src/perspectives/LinkQuery.ts +0 -15
- package/src/perspectives/Perspective.ts +1 -12
- package/src/perspectives/PerspectiveClient.test.ts +262 -0
- package/src/perspectives/PerspectiveClient.ts +254 -468
- package/src/perspectives/PerspectiveDiff.ts +0 -8
- package/src/perspectives/PerspectiveHandle.ts +1 -12
- package/src/perspectives/PerspectiveProxy.test.ts +125 -0
- package/src/perspectives/PerspectiveProxy.ts +522 -434
- package/src/perspectives/WakerSubscriptionManager.ts +13 -13
- package/src/runtime/RuntimeClient.ts +166 -369
- package/src/runtime/RuntimeTypes.ts +144 -0
- package/src/shacl/SHACLFlow.ts +9 -9
- package/src/shacl/SHACLShape.test.ts +94 -0
- package/src/shacl/SHACLShape.ts +66 -39
- package/src/typeDefs.ts +3 -5
- package/src/utils.ts +6 -6
- package/tsconfig.json +3 -7
- package/lib/src/model/query-surreal.d.ts +0 -44
- package/lib/src/model/query-surreal.js +0 -249
- package/lib/src/model/surreal-utils.js +0 -128
- package/shims/reflect-metadata.ts +0 -0
- package/shims/type-graphql.ts +0 -75
- package/src/PubSub.ts +0 -17
- package/src/agent/AgentResolver.ts +0 -263
- package/src/ai/AIResolver.ts +0 -372
- package/src/buildSchema.ts +0 -43
- package/src/expression/ExpressionResolver.ts +0 -64
- package/src/language/LanguageContext.ts +0 -37
- package/src/language/LanguageResolver.ts +0 -98
- package/src/model/Subject.ts +0 -159
- package/src/model/prolog-facts.ts +0 -145
- package/src/model/query-prolog.ts +0 -148
- package/src/model/query-surreal.ts +0 -280
- package/src/model/surreal-utils.ts +0 -147
- package/src/neighbourhood/NeighbourhoodResolver.ts +0 -100
- package/src/perspectives/PerspectiveResolver.ts +0 -372
- package/src/runtime/RuntimeResolver.ts +0 -617
- package/src/unwrapApolloResult.ts +0 -16
- package/tsconfig-browser.json +0 -82
|
@@ -28,7 +28,6 @@ export class ModelQueryBuilder {
|
|
|
28
28
|
constructor(perspective, ctor, query) {
|
|
29
29
|
this.queryParams = {};
|
|
30
30
|
this.modelClassName = null;
|
|
31
|
-
this.useSurrealDBFlag = true;
|
|
32
31
|
this.perspective = perspective;
|
|
33
32
|
this.ctor = ctor;
|
|
34
33
|
if (query)
|
|
@@ -39,7 +38,7 @@ export class ModelQueryBuilder {
|
|
|
39
38
|
*
|
|
40
39
|
* This method:
|
|
41
40
|
* 1. Stops the keepalive signals to the subscription
|
|
42
|
-
* 2. Unsubscribes from
|
|
41
|
+
* 2. Unsubscribes from subscription updates
|
|
43
42
|
* 3. Notifies the backend to clean up subscription resources
|
|
44
43
|
* 4. Clears the subscription reference
|
|
45
44
|
*
|
|
@@ -201,6 +200,28 @@ export class ModelQueryBuilder {
|
|
|
201
200
|
this.queryParams.properties = properties;
|
|
202
201
|
return this;
|
|
203
202
|
}
|
|
203
|
+
/**
|
|
204
|
+
* Controls whether SPARQL property getters are evaluated during hydration.
|
|
205
|
+
*
|
|
206
|
+
* By default, collection queries evaluate property getters (deepQuery=true).
|
|
207
|
+
* Call `.deepQuery(false)` to skip getter evaluation for performance.
|
|
208
|
+
*
|
|
209
|
+
* @param enabled - Whether to evaluate property getters (default: true)
|
|
210
|
+
* @returns The query builder for chaining
|
|
211
|
+
*
|
|
212
|
+
* @example
|
|
213
|
+
* ```typescript
|
|
214
|
+
* const messages = await Message.query(perspective)
|
|
215
|
+
* .parent(channel)
|
|
216
|
+
* .deepQuery(false) // skip property getters for performance
|
|
217
|
+
* .limit(30)
|
|
218
|
+
* .get();
|
|
219
|
+
* ```
|
|
220
|
+
*/
|
|
221
|
+
deepQuery(enabled = true) {
|
|
222
|
+
this.queryParams.deepQuery = enabled;
|
|
223
|
+
return this;
|
|
224
|
+
}
|
|
204
225
|
/**
|
|
205
226
|
* Specifies which relations to eager-load (hydrate into model instances).
|
|
206
227
|
*
|
|
@@ -236,32 +257,10 @@ export class ModelQueryBuilder {
|
|
|
236
257
|
return this;
|
|
237
258
|
}
|
|
238
259
|
/**
|
|
239
|
-
*
|
|
240
|
-
*
|
|
241
|
-
* @param enabled - Whether to use SurrealDB (default: true, 10-100x faster) or Prolog (legacy)
|
|
242
|
-
* @returns The query builder for chaining
|
|
243
|
-
*
|
|
244
|
-
* @example
|
|
245
|
-
* ```typescript
|
|
246
|
-
* // Use SurrealDB (default)
|
|
247
|
-
* const recipes = await Recipe.query(perspective)
|
|
248
|
-
* .where({ category: "Dessert" })
|
|
249
|
-
* .useSurrealDB(true)
|
|
250
|
-
* .get();
|
|
251
|
-
*
|
|
252
|
-
* // Use Prolog (legacy)
|
|
253
|
-
* const recipesProlog = await Recipe.query(perspective)
|
|
254
|
-
* .where({ category: "Dessert" })
|
|
255
|
-
* .useSurrealDB(false)
|
|
256
|
-
* .get();
|
|
257
|
-
* ```
|
|
258
|
-
*
|
|
259
|
-
* @remarks
|
|
260
|
-
* Note: Subscriptions (subscribe(), countSubscribe(), paginateSubscribe()) default to SurrealDB live queries
|
|
261
|
-
* if useSurrealDB(true) is set (default).
|
|
260
|
+
* Sets the query engine to use.
|
|
261
|
+
* @deprecated Prolog engine has been removed. All queries use SPARQL/Rust.
|
|
262
262
|
*/
|
|
263
|
-
|
|
264
|
-
this.useSurrealDBFlag = enabled;
|
|
263
|
+
engine(_eng) {
|
|
265
264
|
return this;
|
|
266
265
|
}
|
|
267
266
|
/**
|
|
@@ -277,17 +276,19 @@ export class ModelQueryBuilder {
|
|
|
277
276
|
* ```
|
|
278
277
|
*/
|
|
279
278
|
async get() {
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
279
|
+
return await this.executeSparqlQuery();
|
|
280
|
+
}
|
|
281
|
+
/**
|
|
282
|
+
* Executes the query once using SPARQL and returns the results.
|
|
283
|
+
*/
|
|
284
|
+
async getSparql() {
|
|
285
|
+
return this.executeSparqlQuery();
|
|
286
|
+
}
|
|
287
|
+
/**
|
|
288
|
+
* Shared query execution logic — routes through the executor-side modelQuery endpoint.
|
|
289
|
+
*/
|
|
290
|
+
async executeSparqlQuery() {
|
|
291
|
+
const { results } = await this.ctor.executeModelQuery(this.perspective, this.queryParams, this.modelClassName);
|
|
291
292
|
return results;
|
|
292
293
|
}
|
|
293
294
|
/**
|
|
@@ -305,15 +306,17 @@ export class ModelQueryBuilder {
|
|
|
305
306
|
* ```
|
|
306
307
|
*/
|
|
307
308
|
async first() {
|
|
309
|
+
const savedLimit = this.queryParams.limit;
|
|
308
310
|
this.queryParams.limit = 1;
|
|
309
311
|
const results = await this.get();
|
|
312
|
+
this.queryParams.limit = savedLimit;
|
|
310
313
|
return results[0] ?? null;
|
|
311
314
|
}
|
|
312
315
|
/**
|
|
313
316
|
* Subscribes to the query and receives updates when results change.
|
|
314
317
|
*
|
|
315
318
|
* This method:
|
|
316
|
-
* 1. Creates and initializes a
|
|
319
|
+
* 1. Creates and initializes a SPARQL live query subscription (default)
|
|
317
320
|
* 2. Sets up the callback to process future updates
|
|
318
321
|
* 3. Returns the initial results immediately
|
|
319
322
|
*
|
|
@@ -336,41 +339,119 @@ export class ModelQueryBuilder {
|
|
|
336
339
|
* builder.dispose();
|
|
337
340
|
* ```
|
|
338
341
|
*
|
|
339
|
-
* @remarks
|
|
340
|
-
* By default, this uses SurrealDB live queries for real-time updates.
|
|
341
|
-
* Prolog subscriptions remain available via `.useSurrealDB(false)`.
|
|
342
342
|
*/
|
|
343
343
|
async subscribe(callback) {
|
|
344
344
|
// Clean up any existing subscription
|
|
345
345
|
this.dispose();
|
|
346
346
|
const ctor = this.ctor;
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
this.
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
347
|
+
// Build the model query params (className, queryJson, shapeJson)
|
|
348
|
+
const { className, queryJson, shapeJson } = ctor.prepareModelQueryParams(this.queryParams, this.modelClassName);
|
|
349
|
+
// Register model subscription via Rust — this builds trigger SPARQL internally,
|
|
350
|
+
// registers the subscription, and runs the initial query in one call.
|
|
351
|
+
const { subscriptionId, result: initialModelResult } = await this.perspective.modelSubscribe(className, queryJson, shapeJson);
|
|
352
|
+
// Convert JSON instances to model class instances
|
|
353
|
+
const parseResults = (raw) => {
|
|
354
|
+
return ctor.parseModelResult(this.perspective, raw, this.queryParams.include, this.queryParams.properties);
|
|
355
|
+
};
|
|
356
|
+
// Resolve non-literal (file-language) properties — handles both raw URI strings
|
|
357
|
+
// and already-resolved FileData objects returned by the Rust executor.
|
|
358
|
+
const resolveAndReturn = async (instances) => {
|
|
359
|
+
await ctor.resolveNonLiteralProps(this.perspective, instances);
|
|
360
|
+
return instances;
|
|
361
|
+
};
|
|
362
|
+
// Parse initial results (with non-literal resolution)
|
|
363
|
+
const initialResults = await resolveAndReturn(parseResults(initialModelResult));
|
|
364
|
+
// Track last emitted result fingerprint to suppress duplicate callbacks
|
|
365
|
+
let lastResultFingerprint = null;
|
|
366
|
+
const buildFingerprint = (results) => {
|
|
367
|
+
if (results.length === 0)
|
|
368
|
+
return '0:';
|
|
369
|
+
return JSON.stringify(results, (_, v) => typeof v === 'function' ? undefined : v);
|
|
370
|
+
};
|
|
371
|
+
lastResultFingerprint = buildFingerprint(initialResults);
|
|
372
|
+
// Listen for subscription updates via the same GraphQL subscription channel.
|
|
373
|
+
// When Rust re-runs the model query and finds changed results, it pushes them.
|
|
374
|
+
const unsubscribe = this.perspective.client.subscribeToQueryUpdates(subscriptionId, (rawResult) => {
|
|
375
|
+
try {
|
|
376
|
+
const parsed = parseResults(rawResult);
|
|
377
|
+
console.debug(`[ModelQueryBuilder.subscribe] Update received for ${subscriptionId}: ${parsed.length} instances`);
|
|
378
|
+
resolveAndReturn(parsed).then((results) => {
|
|
379
|
+
const fp = buildFingerprint(results);
|
|
380
|
+
if (fp === lastResultFingerprint) {
|
|
381
|
+
console.debug(`[ModelQueryBuilder.subscribe] Fingerprint unchanged, skipping callback`);
|
|
382
|
+
return;
|
|
383
|
+
}
|
|
384
|
+
console.debug(`[ModelQueryBuilder.subscribe] Fingerprint changed, calling callback with ${results.length} results`);
|
|
385
|
+
lastResultFingerprint = fp;
|
|
386
|
+
callback(results);
|
|
387
|
+
}).catch((e) => {
|
|
388
|
+
console.error('Model subscription update resolve error:', e);
|
|
389
|
+
});
|
|
390
|
+
}
|
|
391
|
+
catch (e) {
|
|
392
|
+
console.error('Model subscription update parse error:', e);
|
|
393
|
+
}
|
|
394
|
+
});
|
|
395
|
+
// Set up keepalive with recovery — uses setTimeout loop so we can
|
|
396
|
+
// break out and resubscribe when the server evicts the subscription.
|
|
397
|
+
let disposed = false;
|
|
398
|
+
let keepaliveTimer;
|
|
399
|
+
let resubscribeAttempts = 0;
|
|
400
|
+
const MAX_RESUBSCRIBE_ATTEMPTS = 5;
|
|
401
|
+
const keepaliveLoop = async () => {
|
|
402
|
+
if (disposed)
|
|
403
|
+
return;
|
|
404
|
+
try {
|
|
405
|
+
await this.perspective.client.keepAliveQuery(this.perspective.uuid, subscriptionId);
|
|
406
|
+
resubscribeAttempts = 0; // Reset on success
|
|
407
|
+
}
|
|
408
|
+
catch (e) {
|
|
409
|
+
console.warn(`Model subscription keepalive failed for ${subscriptionId}:`, e);
|
|
410
|
+
if (!disposed && resubscribeAttempts < MAX_RESUBSCRIBE_ATTEMPTS) {
|
|
411
|
+
resubscribeAttempts++;
|
|
412
|
+
const backoffMs = Math.min(1000 * Math.pow(2, resubscribeAttempts), 60000);
|
|
413
|
+
console.warn(`Resubscribing (attempt ${resubscribeAttempts}/${MAX_RESUBSCRIBE_ATTEMPTS}, backoff ${backoffMs}ms)...`);
|
|
414
|
+
await new Promise(r => setTimeout(r, backoffMs));
|
|
415
|
+
try {
|
|
416
|
+
unsubscribe();
|
|
417
|
+
await this.subscribe(callback);
|
|
418
|
+
}
|
|
419
|
+
catch (resubErr) {
|
|
420
|
+
console.error('Model subscription resubscribe failed:', resubErr);
|
|
421
|
+
}
|
|
422
|
+
}
|
|
423
|
+
else if (resubscribeAttempts >= MAX_RESUBSCRIBE_ATTEMPTS) {
|
|
424
|
+
console.error(`Model subscription ${subscriptionId}: max resubscribe attempts reached, giving up.`);
|
|
425
|
+
}
|
|
426
|
+
return; // new subscription owns its own keepalive loop
|
|
427
|
+
}
|
|
428
|
+
if (!disposed) {
|
|
429
|
+
keepaliveTimer = setTimeout(keepaliveLoop, 30000);
|
|
430
|
+
}
|
|
431
|
+
};
|
|
432
|
+
keepaliveTimer = setTimeout(keepaliveLoop, 30000);
|
|
433
|
+
// Store dispose function
|
|
434
|
+
this.currentSubscription = {
|
|
435
|
+
dispose: () => {
|
|
436
|
+
disposed = true;
|
|
437
|
+
if (keepaliveTimer)
|
|
438
|
+
clearTimeout(keepaliveTimer);
|
|
439
|
+
unsubscribe();
|
|
440
|
+
this.perspective.client.disposeQuerySubscription(this.perspective.uuid, subscriptionId).catch(() => { });
|
|
441
|
+
},
|
|
442
|
+
};
|
|
443
|
+
// Take snapshots for dirty tracking
|
|
444
|
+
for (const inst of initialResults) {
|
|
445
|
+
inst.takeSnapshot?.(this.queryParams.include);
|
|
373
446
|
}
|
|
447
|
+
return initialResults;
|
|
448
|
+
}
|
|
449
|
+
/**
|
|
450
|
+
* Subscribes to the query and receives updates using SPARQL.
|
|
451
|
+
* @deprecated Use subscribe() instead — now routes through Rust model subscription.
|
|
452
|
+
*/
|
|
453
|
+
async subscribeSparql(callback) {
|
|
454
|
+
return this.subscribe(callback);
|
|
374
455
|
}
|
|
375
456
|
/**
|
|
376
457
|
* Gets the total count of matching entities.
|
|
@@ -385,26 +466,21 @@ export class ModelQueryBuilder {
|
|
|
385
466
|
* ```
|
|
386
467
|
*/
|
|
387
468
|
async count() {
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
else {
|
|
398
|
-
const query = await this.ctor.countQueryToProlog(this.perspective, this.queryParams, this.modelClassName);
|
|
399
|
-
const result = await this.perspective.infer(query);
|
|
400
|
-
return result?.[0]?.TotalCount || 0;
|
|
401
|
-
}
|
|
469
|
+
const { totalCount } = await this.ctor.executeModelQuery(this.perspective, { ...this.queryParams, limit: 0 }, this.modelClassName);
|
|
470
|
+
return totalCount;
|
|
471
|
+
}
|
|
472
|
+
/**
|
|
473
|
+
* Gets the total count of matching entities using SPARQL.
|
|
474
|
+
* Delegates to count().
|
|
475
|
+
*/
|
|
476
|
+
async countSparql() {
|
|
477
|
+
return await this.count();
|
|
402
478
|
}
|
|
403
479
|
/**
|
|
404
480
|
* Subscribes to count updates for matching entities.
|
|
405
481
|
*
|
|
406
482
|
* This method:
|
|
407
|
-
* 1. Creates and initializes a
|
|
483
|
+
* 1. Creates and initializes a SPARQL live query subscription for the count (default)
|
|
408
484
|
* 2. Sets up the callback to process future count updates
|
|
409
485
|
* 3. Returns the initial count immediately
|
|
410
486
|
*
|
|
@@ -427,37 +503,79 @@ export class ModelQueryBuilder {
|
|
|
427
503
|
* builder.dispose();
|
|
428
504
|
* ```
|
|
429
505
|
*
|
|
430
|
-
* @remarks
|
|
431
|
-
* By default, this uses SurrealDB live queries for real-time updates.
|
|
432
|
-
* Prolog subscriptions remain available via `.useSurrealDB(false)`.
|
|
433
506
|
*/
|
|
434
507
|
async countSubscribe(callback) {
|
|
435
508
|
// Clean up any existing subscription
|
|
436
509
|
this.dispose();
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
510
|
+
const countParams = { ...this.queryParams, limit: 0 };
|
|
511
|
+
const { className, queryJson, shapeJson } = this.ctor.prepareModelQueryParams(countParams, this.modelClassName);
|
|
512
|
+
const { subscriptionId, result: initialModelResult } = await this.perspective.modelSubscribe(className, queryJson, shapeJson);
|
|
513
|
+
const parseCount = (raw) => {
|
|
514
|
+
const data = typeof raw === 'string' ? JSON.parse(raw) : raw;
|
|
515
|
+
return data.totalCount ?? 0;
|
|
516
|
+
};
|
|
517
|
+
const initialCount = parseCount(initialModelResult);
|
|
518
|
+
const unsubscribe = this.perspective.client.subscribeToQueryUpdates(subscriptionId, (rawResult) => {
|
|
519
|
+
try {
|
|
520
|
+
callback(parseCount(rawResult));
|
|
521
|
+
}
|
|
522
|
+
catch (e) {
|
|
523
|
+
console.error('Count subscription update parse error:', e);
|
|
524
|
+
}
|
|
525
|
+
});
|
|
526
|
+
let disposed = false;
|
|
527
|
+
let keepaliveTimer;
|
|
528
|
+
let resubscribeAttempts = 0;
|
|
529
|
+
const MAX_RESUBSCRIBE_ATTEMPTS = 5;
|
|
530
|
+
const keepaliveLoop = async () => {
|
|
531
|
+
if (disposed)
|
|
532
|
+
return;
|
|
533
|
+
try {
|
|
534
|
+
await this.perspective.client.keepAliveQuery(this.perspective.uuid, subscriptionId);
|
|
535
|
+
resubscribeAttempts = 0;
|
|
536
|
+
}
|
|
537
|
+
catch (e) {
|
|
538
|
+
console.warn(`Count subscription keepalive failed for ${subscriptionId}:`, e);
|
|
539
|
+
if (!disposed && resubscribeAttempts < MAX_RESUBSCRIBE_ATTEMPTS) {
|
|
540
|
+
resubscribeAttempts++;
|
|
541
|
+
const backoffMs = Math.min(1000 * Math.pow(2, resubscribeAttempts), 60000);
|
|
542
|
+
console.warn(`Count resubscribing (attempt ${resubscribeAttempts}/${MAX_RESUBSCRIBE_ATTEMPTS}, backoff ${backoffMs}ms)...`);
|
|
543
|
+
await new Promise(r => setTimeout(r, backoffMs));
|
|
544
|
+
try {
|
|
545
|
+
unsubscribe();
|
|
546
|
+
await this.countSubscribe(callback);
|
|
547
|
+
}
|
|
548
|
+
catch (resubErr) {
|
|
549
|
+
console.error('Count subscription resubscribe failed:', resubErr);
|
|
550
|
+
}
|
|
551
|
+
}
|
|
552
|
+
else if (resubscribeAttempts >= MAX_RESUBSCRIBE_ATTEMPTS) {
|
|
553
|
+
console.error(`Count subscription ${subscriptionId}: max resubscribe attempts reached, giving up.`);
|
|
554
|
+
}
|
|
555
|
+
return;
|
|
556
|
+
}
|
|
557
|
+
if (!disposed) {
|
|
558
|
+
keepaliveTimer = setTimeout(keepaliveLoop, 30000);
|
|
559
|
+
}
|
|
560
|
+
};
|
|
561
|
+
keepaliveTimer = setTimeout(keepaliveLoop, 30000);
|
|
562
|
+
this.currentSubscription = {
|
|
563
|
+
dispose: () => {
|
|
564
|
+
disposed = true;
|
|
565
|
+
if (keepaliveTimer)
|
|
566
|
+
clearTimeout(keepaliveTimer);
|
|
567
|
+
unsubscribe();
|
|
568
|
+
this.perspective.client.disposeQuerySubscription(this.perspective.uuid, subscriptionId).catch(() => { });
|
|
569
|
+
},
|
|
570
|
+
};
|
|
571
|
+
return initialCount;
|
|
572
|
+
}
|
|
573
|
+
/**
|
|
574
|
+
* Subscribes to count updates using SPARQL.
|
|
575
|
+
* @deprecated Use countSubscribe() instead — now routes through Rust model subscription.
|
|
576
|
+
*/
|
|
577
|
+
async countSubscribeSparql(callback) {
|
|
578
|
+
return this.countSubscribe(callback);
|
|
461
579
|
}
|
|
462
580
|
/**
|
|
463
581
|
* Gets a page of results with pagination metadata.
|
|
@@ -476,24 +594,21 @@ export class ModelQueryBuilder {
|
|
|
476
594
|
*/
|
|
477
595
|
async paginate(pageSize, pageNumber) {
|
|
478
596
|
const paginationQuery = { ...(this.queryParams || {}), limit: pageSize, offset: pageSize * (pageNumber - 1), count: true };
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
const { results, totalCount } = (await this.ctor.instancesFromPrologResult(this.perspective, paginationQuery, result));
|
|
489
|
-
return { results, totalCount, pageSize, pageNumber };
|
|
490
|
-
}
|
|
597
|
+
const { results, totalCount } = await this.ctor.executeModelQuery(this.perspective, paginationQuery, this.modelClassName);
|
|
598
|
+
return { results, totalCount, pageSize, pageNumber };
|
|
599
|
+
}
|
|
600
|
+
/**
|
|
601
|
+
* Gets a page of results using SPARQL.
|
|
602
|
+
* Delegates to paginate().
|
|
603
|
+
*/
|
|
604
|
+
async paginateSparql(pageSize, pageNumber) {
|
|
605
|
+
return await this.paginate(pageSize, pageNumber);
|
|
491
606
|
}
|
|
492
607
|
/**
|
|
493
608
|
* Subscribes to paginated results updates.
|
|
494
609
|
*
|
|
495
610
|
* This method:
|
|
496
|
-
* 1. Creates and initializes a
|
|
611
|
+
* 1. Creates and initializes a SPARQL live query subscription for the paginated results (default)
|
|
497
612
|
* 2. Sets up the callback to process future page updates
|
|
498
613
|
* 3. Returns the initial page immediately
|
|
499
614
|
*
|
|
@@ -518,39 +633,88 @@ export class ModelQueryBuilder {
|
|
|
518
633
|
* builder.dispose();
|
|
519
634
|
* ```
|
|
520
635
|
*
|
|
521
|
-
* @remarks
|
|
522
|
-
* By default, this uses SurrealDB live queries for real-time updates.
|
|
523
|
-
* Prolog subscriptions remain available via `.useSurrealDB(false)`.
|
|
524
636
|
*/
|
|
525
637
|
async paginateSubscribe(pageSize, pageNumber, callback) {
|
|
526
638
|
// Clean up any existing subscription
|
|
527
639
|
this.dispose();
|
|
528
|
-
const
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
|
|
536
|
-
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
|
|
540
|
-
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
|
|
545
|
-
const
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
|
|
549
|
-
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
|
|
640
|
+
const ctor = this.ctor;
|
|
641
|
+
// Subscribe to the full result set (no limit/offset) so the subscription
|
|
642
|
+
// detects changes anywhere in the dataset. Rust builds trigger SPARQL
|
|
643
|
+
// from the shape predicates.
|
|
644
|
+
const subscriptionParams = { ...(this.queryParams || {}) };
|
|
645
|
+
delete subscriptionParams.limit;
|
|
646
|
+
delete subscriptionParams.offset;
|
|
647
|
+
const { className, queryJson, shapeJson } = ctor.prepareModelQueryParams(subscriptionParams, this.modelClassName);
|
|
648
|
+
const { subscriptionId } = await this.perspective.modelSubscribe(className, queryJson, shapeJson);
|
|
649
|
+
// Build the paginated query for Rust endpoint (count: true fetches both results and totalCount in one call)
|
|
650
|
+
const paginatedQuery = {
|
|
651
|
+
...(this.queryParams || {}),
|
|
652
|
+
limit: pageSize,
|
|
653
|
+
offset: pageSize * (pageNumber - 1),
|
|
654
|
+
count: true,
|
|
655
|
+
};
|
|
656
|
+
const processResults = async () => {
|
|
657
|
+
const { results, totalCount } = await ctor.executeModelQuery(this.perspective, paginatedQuery, this.modelClassName);
|
|
658
|
+
callback({ results, totalCount, pageSize, pageNumber });
|
|
659
|
+
};
|
|
660
|
+
const unsubscribe = this.perspective.client.subscribeToQueryUpdates(subscriptionId, (rawResult) => {
|
|
661
|
+
console.debug(`[ModelQueryBuilder.paginateSubscribe] Update received for ${subscriptionId}, re-fetching paginated data...`);
|
|
662
|
+
processResults().catch(e => console.error('Paginate subscription error:', e));
|
|
663
|
+
});
|
|
664
|
+
let disposed = false;
|
|
665
|
+
let keepaliveTimer;
|
|
666
|
+
let resubscribeAttempts = 0;
|
|
667
|
+
const MAX_RESUBSCRIBE_ATTEMPTS = 5;
|
|
668
|
+
const keepaliveLoop = async () => {
|
|
669
|
+
if (disposed)
|
|
670
|
+
return;
|
|
671
|
+
try {
|
|
672
|
+
await this.perspective.client.keepAliveQuery(this.perspective.uuid, subscriptionId);
|
|
673
|
+
resubscribeAttempts = 0;
|
|
674
|
+
}
|
|
675
|
+
catch (e) {
|
|
676
|
+
console.warn(`Paginate subscription keepalive failed for ${subscriptionId}:`, e);
|
|
677
|
+
if (!disposed && resubscribeAttempts < MAX_RESUBSCRIBE_ATTEMPTS) {
|
|
678
|
+
resubscribeAttempts++;
|
|
679
|
+
const backoffMs = Math.min(1000 * Math.pow(2, resubscribeAttempts), 60000);
|
|
680
|
+
console.warn(`Paginate resubscribing (attempt ${resubscribeAttempts}/${MAX_RESUBSCRIBE_ATTEMPTS}, backoff ${backoffMs}ms)...`);
|
|
681
|
+
await new Promise(r => setTimeout(r, backoffMs));
|
|
682
|
+
try {
|
|
683
|
+
unsubscribe();
|
|
684
|
+
await this.paginateSubscribe(pageSize, pageNumber, callback);
|
|
685
|
+
}
|
|
686
|
+
catch (resubErr) {
|
|
687
|
+
console.error('Paginate subscription resubscribe failed:', resubErr);
|
|
688
|
+
}
|
|
689
|
+
}
|
|
690
|
+
else if (resubscribeAttempts >= MAX_RESUBSCRIBE_ATTEMPTS) {
|
|
691
|
+
console.error(`Paginate subscription ${subscriptionId}: max resubscribe attempts reached, giving up.`);
|
|
692
|
+
}
|
|
693
|
+
return;
|
|
694
|
+
}
|
|
695
|
+
if (!disposed) {
|
|
696
|
+
keepaliveTimer = setTimeout(keepaliveLoop, 30000);
|
|
697
|
+
}
|
|
698
|
+
};
|
|
699
|
+
keepaliveTimer = setTimeout(keepaliveLoop, 30000);
|
|
700
|
+
this.currentSubscription = {
|
|
701
|
+
dispose: () => {
|
|
702
|
+
disposed = true;
|
|
703
|
+
if (keepaliveTimer)
|
|
704
|
+
clearTimeout(keepaliveTimer);
|
|
705
|
+
unsubscribe();
|
|
706
|
+
this.perspective.client.disposeQuerySubscription(this.perspective.uuid, subscriptionId).catch(() => { });
|
|
707
|
+
},
|
|
708
|
+
};
|
|
709
|
+
// Initial fetch (single call with count: true)
|
|
710
|
+
const { results, totalCount } = await ctor.executeModelQuery(this.perspective, paginatedQuery, this.modelClassName);
|
|
711
|
+
return { results, totalCount, pageSize, pageNumber };
|
|
712
|
+
}
|
|
713
|
+
/**
|
|
714
|
+
* Subscribes to paginated results updates using SPARQL.
|
|
715
|
+
* Delegates to paginateSubscribe().
|
|
716
|
+
*/
|
|
717
|
+
async paginateSubscribeSparql(pageSize, pageNumber, callback) {
|
|
718
|
+
return await this.paginateSubscribe(pageSize, pageNumber, callback);
|
|
555
719
|
}
|
|
556
720
|
}
|
package/lib/src/model/Subject.js
CHANGED
|
@@ -55,12 +55,12 @@ export class Subject {
|
|
|
55
55
|
Object.defineProperty(this, p, {
|
|
56
56
|
configurable: true,
|
|
57
57
|
get: async () => {
|
|
58
|
-
// Use
|
|
58
|
+
// Use SPARQL for data queries
|
|
59
59
|
try {
|
|
60
|
-
return await __classPrivateFieldGet(this, _Subject_perspective, "f").
|
|
60
|
+
return await __classPrivateFieldGet(this, _Subject_perspective, "f").getPropertyValueViaSparql(__classPrivateFieldGet(this, _Subject_baseExpression, "f"), __classPrivateFieldGet(this, _Subject_subjectClassName, "f"), p);
|
|
61
61
|
}
|
|
62
62
|
catch (err) {
|
|
63
|
-
console.warn(`Failed to get property ${p} via
|
|
63
|
+
console.warn(`Failed to get property ${p} via SPARQL:`, err);
|
|
64
64
|
return undefined;
|
|
65
65
|
}
|
|
66
66
|
}
|
|
@@ -94,12 +94,12 @@ export class Subject {
|
|
|
94
94
|
Object.defineProperty(this, c, {
|
|
95
95
|
configurable: true,
|
|
96
96
|
get: async () => {
|
|
97
|
-
// Use
|
|
97
|
+
// Use SPARQL for data queries
|
|
98
98
|
try {
|
|
99
|
-
return await __classPrivateFieldGet(this, _Subject_perspective, "f").
|
|
99
|
+
return await __classPrivateFieldGet(this, _Subject_perspective, "f").getRelationValuesViaSparql(__classPrivateFieldGet(this, _Subject_baseExpression, "f"), __classPrivateFieldGet(this, _Subject_subjectClassName, "f"), c);
|
|
100
100
|
}
|
|
101
101
|
catch (err) {
|
|
102
|
-
console.warn(`Failed to get relation ${c} via
|
|
102
|
+
console.warn(`Failed to get relation ${c} via SPARQL:`, err);
|
|
103
103
|
return [];
|
|
104
104
|
}
|
|
105
105
|
}
|