@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
|
@@ -1,30 +1,7 @@
|
|
|
1
|
-
var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
|
|
2
|
-
var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
|
|
3
|
-
if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
|
|
4
|
-
else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
|
|
5
|
-
return c > 3 && r && Object.defineProperty(target, key, r), r;
|
|
6
|
-
};
|
|
7
|
-
var __metadata = (this && this.__metadata) || function (k, v) {
|
|
8
|
-
if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
|
|
9
|
-
};
|
|
10
|
-
import { Field, ObjectType } from "type-graphql";
|
|
11
1
|
// Unique Language ID with option type
|
|
12
|
-
|
|
2
|
+
export class LanguageRef {
|
|
13
3
|
constructor(address, name) {
|
|
14
4
|
this.address = address;
|
|
15
5
|
this.name = name;
|
|
16
6
|
}
|
|
17
|
-
}
|
|
18
|
-
__decorate([
|
|
19
|
-
Field(),
|
|
20
|
-
__metadata("design:type", String)
|
|
21
|
-
], LanguageRef.prototype, "address", void 0);
|
|
22
|
-
__decorate([
|
|
23
|
-
Field(),
|
|
24
|
-
__metadata("design:type", String)
|
|
25
|
-
], LanguageRef.prototype, "name", void 0);
|
|
26
|
-
LanguageRef = __decorate([
|
|
27
|
-
ObjectType(),
|
|
28
|
-
__metadata("design:paramtypes", [String, String])
|
|
29
|
-
], LanguageRef);
|
|
30
|
-
export { LanguageRef };
|
|
7
|
+
}
|
package/lib/src/links/Links.js
CHANGED
|
@@ -1,90 +1,22 @@
|
|
|
1
|
-
var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
|
|
2
|
-
var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
|
|
3
|
-
if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
|
|
4
|
-
else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
|
|
5
|
-
return c > 3 && r && Object.defineProperty(target, key, r), r;
|
|
6
|
-
};
|
|
7
|
-
var __metadata = (this && this.__metadata) || function (k, v) {
|
|
8
|
-
if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
|
|
9
|
-
};
|
|
10
|
-
import { Field, InputType, ObjectType } from "type-graphql";
|
|
11
1
|
import { ExpressionGeneric, ExpressionGenericInput } from '../expression/Expression';
|
|
12
|
-
|
|
2
|
+
export class Link {
|
|
13
3
|
constructor(obj) {
|
|
14
4
|
this.source = obj.source ? obj.source : '';
|
|
15
5
|
this.target = obj.target ? obj.target : '';
|
|
16
6
|
this.predicate = obj.predicate ? obj.predicate : '';
|
|
17
7
|
}
|
|
18
|
-
}
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
], Link.prototype, "source", void 0);
|
|
23
|
-
__decorate([
|
|
24
|
-
Field(),
|
|
25
|
-
__metadata("design:type", String)
|
|
26
|
-
], Link.prototype, "target", void 0);
|
|
27
|
-
__decorate([
|
|
28
|
-
Field({ nullable: true }),
|
|
29
|
-
__metadata("design:type", String)
|
|
30
|
-
], Link.prototype, "predicate", void 0);
|
|
31
|
-
Link = __decorate([
|
|
32
|
-
ObjectType(),
|
|
33
|
-
__metadata("design:paramtypes", [Object])
|
|
34
|
-
], Link);
|
|
35
|
-
export { Link };
|
|
36
|
-
let LinkMutations = class LinkMutations {
|
|
37
|
-
};
|
|
38
|
-
__decorate([
|
|
39
|
-
Field(type => [LinkInput]),
|
|
40
|
-
__metadata("design:type", Array)
|
|
41
|
-
], LinkMutations.prototype, "additions", void 0);
|
|
42
|
-
__decorate([
|
|
43
|
-
Field(type => [LinkExpressionInput]),
|
|
44
|
-
__metadata("design:type", Array)
|
|
45
|
-
], LinkMutations.prototype, "removals", void 0);
|
|
46
|
-
LinkMutations = __decorate([
|
|
47
|
-
InputType()
|
|
48
|
-
], LinkMutations);
|
|
49
|
-
export { LinkMutations };
|
|
50
|
-
let LinkExpressionMutations = class LinkExpressionMutations {
|
|
8
|
+
}
|
|
9
|
+
export class LinkMutations {
|
|
10
|
+
}
|
|
11
|
+
export class LinkExpressionMutations {
|
|
51
12
|
constructor(additions, removals) {
|
|
52
13
|
this.additions = additions;
|
|
53
14
|
this.removals = removals;
|
|
54
15
|
}
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
], LinkExpressionMutations.prototype, "additions", void 0);
|
|
60
|
-
__decorate([
|
|
61
|
-
Field(type => [LinkExpression]),
|
|
62
|
-
__metadata("design:type", Array)
|
|
63
|
-
], LinkExpressionMutations.prototype, "removals", void 0);
|
|
64
|
-
LinkExpressionMutations = __decorate([
|
|
65
|
-
ObjectType(),
|
|
66
|
-
__metadata("design:paramtypes", [Array, Array])
|
|
67
|
-
], LinkExpressionMutations);
|
|
68
|
-
export { LinkExpressionMutations };
|
|
69
|
-
let LinkInput = class LinkInput {
|
|
70
|
-
};
|
|
71
|
-
__decorate([
|
|
72
|
-
Field(),
|
|
73
|
-
__metadata("design:type", String)
|
|
74
|
-
], LinkInput.prototype, "source", void 0);
|
|
75
|
-
__decorate([
|
|
76
|
-
Field(),
|
|
77
|
-
__metadata("design:type", String)
|
|
78
|
-
], LinkInput.prototype, "target", void 0);
|
|
79
|
-
__decorate([
|
|
80
|
-
Field({ nullable: true }),
|
|
81
|
-
__metadata("design:type", String)
|
|
82
|
-
], LinkInput.prototype, "predicate", void 0);
|
|
83
|
-
LinkInput = __decorate([
|
|
84
|
-
InputType()
|
|
85
|
-
], LinkInput);
|
|
86
|
-
export { LinkInput };
|
|
87
|
-
let LinkExpression = class LinkExpression extends ExpressionGeneric(Link) {
|
|
16
|
+
}
|
|
17
|
+
export class LinkInput {
|
|
18
|
+
}
|
|
19
|
+
export class LinkExpression extends ExpressionGeneric(Link) {
|
|
88
20
|
hash() {
|
|
89
21
|
const mash = JSON.stringify(this.data, Object.keys(this.data).sort()) +
|
|
90
22
|
JSON.stringify(this.author) + this.timestamp;
|
|
@@ -96,26 +28,10 @@ let LinkExpression = class LinkExpression extends ExpressionGeneric(Link) {
|
|
|
96
28
|
}
|
|
97
29
|
return hash;
|
|
98
30
|
}
|
|
99
|
-
}
|
|
100
|
-
__decorate([
|
|
101
|
-
Field({ nullable: true, defaultValue: 'shared' }),
|
|
102
|
-
__metadata("design:type", String)
|
|
103
|
-
], LinkExpression.prototype, "status", void 0);
|
|
104
|
-
LinkExpression = __decorate([
|
|
105
|
-
ObjectType()
|
|
106
|
-
], LinkExpression);
|
|
107
|
-
export { LinkExpression };
|
|
31
|
+
}
|
|
108
32
|
;
|
|
109
|
-
|
|
110
|
-
}
|
|
111
|
-
__decorate([
|
|
112
|
-
Field({ nullable: true, defaultValue: 'shared' }),
|
|
113
|
-
__metadata("design:type", String)
|
|
114
|
-
], LinkExpressionInput.prototype, "status", void 0);
|
|
115
|
-
LinkExpressionInput = __decorate([
|
|
116
|
-
InputType()
|
|
117
|
-
], LinkExpressionInput);
|
|
118
|
-
export { LinkExpressionInput };
|
|
33
|
+
export class LinkExpressionInput extends ExpressionGenericInput(LinkInput) {
|
|
34
|
+
}
|
|
119
35
|
;
|
|
120
36
|
export function linkEqual(l1, l2) {
|
|
121
37
|
return l1.author == l2.author &&
|
|
@@ -127,22 +43,9 @@ export function linkEqual(l1, l2) {
|
|
|
127
43
|
export function isLink(l) {
|
|
128
44
|
return l && l.source && l.target;
|
|
129
45
|
}
|
|
130
|
-
|
|
46
|
+
export class LinkExpressionUpdated {
|
|
131
47
|
constructor(oldLink, newLink) {
|
|
132
48
|
this.oldLink = oldLink;
|
|
133
49
|
this.newLink = newLink;
|
|
134
50
|
}
|
|
135
|
-
}
|
|
136
|
-
__decorate([
|
|
137
|
-
Field(type => LinkExpression),
|
|
138
|
-
__metadata("design:type", LinkExpression)
|
|
139
|
-
], LinkExpressionUpdated.prototype, "oldLink", void 0);
|
|
140
|
-
__decorate([
|
|
141
|
-
Field(type => LinkExpression),
|
|
142
|
-
__metadata("design:type", LinkExpression)
|
|
143
|
-
], LinkExpressionUpdated.prototype, "newLink", void 0);
|
|
144
|
-
LinkExpressionUpdated = __decorate([
|
|
145
|
-
ObjectType(),
|
|
146
|
-
__metadata("design:paramtypes", [LinkExpression, LinkExpression])
|
|
147
|
-
], LinkExpressionUpdated);
|
|
148
|
-
export { LinkExpressionUpdated };
|
|
51
|
+
}
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
import { PerspectiveProxy } from "../perspectives/PerspectiveProxy";
|
|
2
|
+
import type { SHACLShape } from "../shacl/SHACLShape";
|
|
2
3
|
import type { JSONSchema, JSONSchemaToModelOptions } from "./json-schema";
|
|
3
4
|
import { ModelQueryBuilder } from "./ModelQueryBuilder";
|
|
4
|
-
import type { ParentScope, IncludeMap, Query, GetOptions,
|
|
5
|
+
import type { ParentScope, IncludeMap, Query, GetOptions, ResultsWithTotalCount, PaginationResult, ModelMetadata } from "./types";
|
|
5
6
|
/**
|
|
6
7
|
* Base class for defining data models in AD4M.
|
|
7
8
|
*
|
|
@@ -105,6 +106,11 @@ export declare class Ad4mModel {
|
|
|
105
106
|
author: string;
|
|
106
107
|
createdAt: any;
|
|
107
108
|
updatedAt: any;
|
|
109
|
+
/**
|
|
110
|
+
* Backwards compatibility alias for createdAt.
|
|
111
|
+
* @deprecated Use createdAt instead. This will be removed in a future version.
|
|
112
|
+
*/
|
|
113
|
+
get timestamp(): any;
|
|
108
114
|
private static classNamesByClass;
|
|
109
115
|
/**
|
|
110
116
|
* Generates the SDNA (Subject DNA) Prolog rules for this model class.
|
|
@@ -126,11 +132,6 @@ export declare class Ad4mModel {
|
|
|
126
132
|
name: string;
|
|
127
133
|
};
|
|
128
134
|
static getClassName(perspective: PerspectiveProxy): Promise<string>;
|
|
129
|
-
/**
|
|
130
|
-
* Backwards compatibility alias for createdAt.
|
|
131
|
-
* @deprecated Use createdAt instead. This will be removed in a future version.
|
|
132
|
-
*/
|
|
133
|
-
get timestamp(): any;
|
|
134
135
|
/**
|
|
135
136
|
* Extracts metadata from decorators for query building.
|
|
136
137
|
*
|
|
@@ -184,7 +185,7 @@ export declare class Ad4mModel {
|
|
|
184
185
|
* const recipe = new Recipe(perspective);
|
|
185
186
|
*
|
|
186
187
|
* // Create with specific base expression
|
|
187
|
-
* const recipe = new Recipe(perspective, "literal
|
|
188
|
+
* const recipe = new Recipe(perspective, "literal:...");
|
|
188
189
|
* ```
|
|
189
190
|
*/
|
|
190
191
|
constructor(perspective: PerspectiveProxy, baseExpression?: string);
|
|
@@ -192,10 +193,6 @@ export declare class Ad4mModel {
|
|
|
192
193
|
* The unique identifier (expression URI) of this model instance.
|
|
193
194
|
*/
|
|
194
195
|
get id(): string;
|
|
195
|
-
/**
|
|
196
|
-
* @deprecated Use `.id` instead. Will be removed in a future version.
|
|
197
|
-
*/
|
|
198
|
-
get baseExpression(): string;
|
|
199
196
|
/**
|
|
200
197
|
* Protected getter for the perspective.
|
|
201
198
|
* Allows subclasses to access the perspective while keeping it private from external code.
|
|
@@ -221,11 +218,6 @@ export declare class Ad4mModel {
|
|
|
221
218
|
* @private
|
|
222
219
|
*/
|
|
223
220
|
private generateRelationAction;
|
|
224
|
-
/**
|
|
225
|
-
* Assigns decoded Prolog property values to an instance.
|
|
226
|
-
* Delegates to the standalone function in hydration.ts.
|
|
227
|
-
*/
|
|
228
|
-
static assignValuesToInstance(perspective: PerspectiveProxy, instance: Ad4mModel, values: ValueTuple[]): Promise<void>;
|
|
229
221
|
/**
|
|
230
222
|
* @param includedRelations Controls which relation fields are recorded
|
|
231
223
|
* in the snapshot for dirty-tracking:
|
|
@@ -237,7 +229,8 @@ export declare class Ad4mModel {
|
|
|
237
229
|
* • `null` / empty object — skip ALL relations (used by bare
|
|
238
230
|
* subscriptions that don't eagerly load relations).
|
|
239
231
|
*/
|
|
240
|
-
|
|
232
|
+
/** @internal */
|
|
233
|
+
protected takeSnapshot(includedRelations?: Record<string, any> | null): void;
|
|
241
234
|
/**
|
|
242
235
|
* Returns `true` if any tracked property or relation has changed
|
|
243
236
|
* since the last hydration (or since `takeSnapshot()` was last called).
|
|
@@ -268,15 +261,14 @@ export declare class Ad4mModel {
|
|
|
268
261
|
*/
|
|
269
262
|
changedFields(): string[];
|
|
270
263
|
private getData;
|
|
271
|
-
static queryToProlog(perspective: PerspectiveProxy, query: Query, modelClassName?: string | null): Promise<string>;
|
|
272
264
|
/**
|
|
273
|
-
* Generates a
|
|
265
|
+
* Generates a SPARQL query from a Query object.
|
|
274
266
|
*
|
|
275
267
|
* @description
|
|
276
|
-
* This method translates high-level query parameters into a
|
|
277
|
-
* that can be executed against the
|
|
278
|
-
* operate on SDNA-aware predicates,
|
|
279
|
-
* stored in
|
|
268
|
+
* This method translates high-level query parameters into a SPARQL query string
|
|
269
|
+
* that can be executed against the SPARQL backend. Unlike Prolog queries which
|
|
270
|
+
* operate on SDNA-aware predicates, SPARQL queries operate directly on raw links
|
|
271
|
+
* stored in SPARQL.
|
|
280
272
|
*
|
|
281
273
|
* The generated query uses a CTE (Common Table Expression) pattern:
|
|
282
274
|
* 1. First, identify candidate base expressions by filtering links based on where conditions
|
|
@@ -284,7 +276,7 @@ export declare class Ad4mModel {
|
|
|
284
276
|
* 3. Finally, apply ordering, pagination (LIMIT/START) at the SQL level
|
|
285
277
|
*
|
|
286
278
|
* Key architectural notes:
|
|
287
|
-
* -
|
|
279
|
+
* - SPARQL stores only raw links (source, predicate, target, author, timestamp)
|
|
288
280
|
* - No SDNA knowledge at the database level
|
|
289
281
|
* - Properties are resolved via subqueries that look for links with specific predicates
|
|
290
282
|
* - Relations are similar but return multiple values instead of one
|
|
@@ -292,11 +284,11 @@ export declare class Ad4mModel {
|
|
|
292
284
|
*
|
|
293
285
|
* @param perspective - The perspective to query (used for metadata extraction)
|
|
294
286
|
* @param query - Query parameters (where, order, limit, offset, properties, relations)
|
|
295
|
-
* @returns Complete
|
|
287
|
+
* @returns Complete SPARQL query string ready for execution
|
|
296
288
|
*
|
|
297
289
|
* @example
|
|
298
290
|
* ```typescript
|
|
299
|
-
* const query = Recipe.
|
|
291
|
+
* const query = Recipe.queryToSPARQL(perspective, {
|
|
300
292
|
* where: { name: "Pasta", rating: { gt: 4 } },
|
|
301
293
|
* order: { timestamp: "DESC" },
|
|
302
294
|
* limit: 10
|
|
@@ -305,33 +297,61 @@ export declare class Ad4mModel {
|
|
|
305
297
|
* // FROM link WHERE ... GROUP BY source ORDER BY timestamp DESC LIMIT 10
|
|
306
298
|
* ```
|
|
307
299
|
*/
|
|
308
|
-
static
|
|
309
|
-
static instancesFromPrologResult<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query: Query, result: AllInstancesResult): Promise<ResultsWithTotalCount<T>>;
|
|
300
|
+
static queryToSPARQL(perspective: PerspectiveProxy, query: Query): Promise<string>;
|
|
310
301
|
/**
|
|
311
|
-
*
|
|
302
|
+
* Build the JSON parameters needed for a model query/subscription endpoint.
|
|
303
|
+
* Returns the className, queryJson, and shapeJson that the Rust executor expects.
|
|
304
|
+
* @internal
|
|
305
|
+
*/
|
|
306
|
+
static prepareModelQueryParams(query?: Query, classNameOverride?: string | null): {
|
|
307
|
+
className: string;
|
|
308
|
+
queryJson: string;
|
|
309
|
+
shapeJson: string;
|
|
310
|
+
metadata: ModelMetadata;
|
|
311
|
+
};
|
|
312
|
+
/**
|
|
313
|
+
* Parse raw model query/subscription result JSON into typed model instances.
|
|
314
|
+
* Used by ModelQueryBuilder to convert subscription updates without circular imports.
|
|
315
|
+
* @internal
|
|
316
|
+
*/
|
|
317
|
+
static parseModelResult<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, raw: any, include?: IncludeMap, properties?: string[]): T[];
|
|
318
|
+
/**
|
|
319
|
+
* Resolve non-literal (file-language) properties on an array of already-constructed
|
|
320
|
+
* model instances. Handles two cases:
|
|
312
321
|
*
|
|
313
|
-
*
|
|
314
|
-
*
|
|
315
|
-
*
|
|
316
|
-
*
|
|
322
|
+
* 1. The Rust executor returned a raw URI string → fetch via `getExpression` then apply transform.
|
|
323
|
+
* 2. The Rust executor already resolved the expression and returned a `FileData` object
|
|
324
|
+
* (happens when the perspective backend eagerly fetches file content) → apply transform
|
|
325
|
+
* (or `defaultFileDecode` if no transform is registered on the class, e.g. for SHACL-
|
|
326
|
+
* synthesised model classes).
|
|
317
327
|
*
|
|
328
|
+
* Extracted as a public static so `ModelQueryBuilder.subscribe()` can reuse it without
|
|
329
|
+
* duplicating logic or introducing a circular dependency.
|
|
318
330
|
* @internal
|
|
319
331
|
*/
|
|
320
|
-
static
|
|
332
|
+
static resolveNonLiteralProps<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, instances: T[]): Promise<void>;
|
|
333
|
+
/**
|
|
334
|
+
* Execute a model query via the executor-side endpoint.
|
|
335
|
+
*
|
|
336
|
+
* This replaces the old SPARQL-build → hydrate → JS-filter → JS-sort → JS-paginate pipeline
|
|
337
|
+
* with a single RPC to the executor that handles everything in Rust.
|
|
338
|
+
*
|
|
339
|
+
* @internal
|
|
340
|
+
*/
|
|
341
|
+
private static executeModelQuery;
|
|
321
342
|
/**
|
|
322
343
|
* Gets all instances of the model in the perspective that match the query params.
|
|
323
344
|
*
|
|
324
345
|
* @param perspective - The perspective to search in
|
|
325
346
|
* @param query - Optional query parameters to filter results
|
|
326
|
-
* @param
|
|
347
|
+
* @param _engine - **Deprecated.** Accepted for backward compatibility but ignored.
|
|
348
|
+
* All queries now use the Rust SPARQL pipeline.
|
|
327
349
|
* @returns Array of matching models
|
|
328
350
|
*
|
|
329
351
|
* @example
|
|
330
352
|
* ```typescript
|
|
331
|
-
* // Get all recipes (uses SurrealDB by default)
|
|
332
353
|
* const allRecipes = await Recipe.findAll(perspective);
|
|
333
354
|
*
|
|
334
|
-
* // Get recipes with specific criteria (uses SurrealDB)
|
|
335
355
|
* const recipes = await Recipe.findAll(perspective, {
|
|
336
356
|
* where: {
|
|
337
357
|
* name: "Pasta",
|
|
@@ -340,12 +360,11 @@ export declare class Ad4mModel {
|
|
|
340
360
|
* order: { createdAt: "DESC" },
|
|
341
361
|
* limit: 10
|
|
342
362
|
* });
|
|
343
|
-
*
|
|
344
|
-
* // Explicitly use Prolog (legacy, for backward compatibility)
|
|
345
|
-
* const recipesProlog = await Recipe.findAll(perspective, {}, false);
|
|
346
363
|
* ```
|
|
347
364
|
*/
|
|
348
|
-
static findAll<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query,
|
|
365
|
+
static findAll<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query,
|
|
366
|
+
/** @deprecated Ignored — Prolog engine has been removed. */
|
|
367
|
+
_engine?: 'sparql' | 'prolog' | boolean): Promise<T[]>;
|
|
349
368
|
/**
|
|
350
369
|
* Finds the first instance matching the query, or `null` if none exists.
|
|
351
370
|
*
|
|
@@ -353,7 +372,7 @@ export declare class Ad4mModel {
|
|
|
353
372
|
*
|
|
354
373
|
* @param perspective - The perspective to search in
|
|
355
374
|
* @param query - Optional query parameters to filter results
|
|
356
|
-
* @param
|
|
375
|
+
* @param _engine - **Deprecated.** Accepted for backward compatibility but ignored.
|
|
357
376
|
* @returns The first matching instance, or `null`
|
|
358
377
|
*
|
|
359
378
|
* @example
|
|
@@ -366,13 +385,15 @@ export declare class Ad4mModel {
|
|
|
366
385
|
* }
|
|
367
386
|
* ```
|
|
368
387
|
*/
|
|
369
|
-
static findOne<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query,
|
|
388
|
+
static findOne<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query,
|
|
389
|
+
/** @deprecated Ignored — Prolog engine has been removed. */
|
|
390
|
+
_engine?: 'sparql' | 'prolog' | boolean): Promise<T | null>;
|
|
370
391
|
/**
|
|
371
392
|
* Gets all instances with count of total matches without offset & limit applied.
|
|
372
393
|
*
|
|
373
394
|
* @param perspective - The perspective to search in
|
|
374
395
|
* @param query - Optional query parameters to filter results
|
|
375
|
-
* @param
|
|
396
|
+
* @param _engine - **Deprecated.** Accepted for backward compatibility but ignored.
|
|
376
397
|
* @returns Object containing results array and total count
|
|
377
398
|
*
|
|
378
399
|
* @example
|
|
@@ -382,12 +403,11 @@ export declare class Ad4mModel {
|
|
|
382
403
|
* limit: 10
|
|
383
404
|
* });
|
|
384
405
|
* console.log(`Showing 10 of ${totalCount} dessert recipes`);
|
|
385
|
-
*
|
|
386
|
-
* // Use Prolog explicitly (legacy)
|
|
387
|
-
* const { results, totalCount } = await Recipe.findAllAndCount(perspective, {}, false);
|
|
388
406
|
* ```
|
|
389
407
|
*/
|
|
390
|
-
static findAllAndCount<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query,
|
|
408
|
+
static findAllAndCount<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query,
|
|
409
|
+
/** @deprecated Ignored — Prolog engine has been removed. */
|
|
410
|
+
_engine?: 'sparql' | 'prolog' | boolean): Promise<ResultsWithTotalCount<T>>;
|
|
391
411
|
/**
|
|
392
412
|
* Helper function for pagination with explicit page size and number.
|
|
393
413
|
*
|
|
@@ -395,7 +415,6 @@ export declare class Ad4mModel {
|
|
|
395
415
|
* @param pageSize - Number of items per page
|
|
396
416
|
* @param pageNumber - Which page to retrieve (1-based)
|
|
397
417
|
* @param query - Optional additional query parameters
|
|
398
|
-
* @param useSurrealDB - Whether to use SurrealDB (default: true, 10-100x faster) or Prolog (legacy)
|
|
399
418
|
* @returns Paginated results with metadata
|
|
400
419
|
*
|
|
401
420
|
* @example
|
|
@@ -404,29 +423,25 @@ export declare class Ad4mModel {
|
|
|
404
423
|
* where: { category: "Main Course" }
|
|
405
424
|
* });
|
|
406
425
|
* console.log(`Page ${page.pageNumber} of recipes, ${page.results.length} items`);
|
|
407
|
-
*
|
|
408
|
-
* // Use Prolog explicitly (legacy)
|
|
409
|
-
* const pageProlog = await Recipe.paginate(perspective, 10, 1, {}, false);
|
|
410
426
|
* ```
|
|
411
427
|
*/
|
|
412
|
-
static paginate<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, pageSize: number, pageNumber: number, query?: Query,
|
|
413
|
-
|
|
428
|
+
static paginate<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, pageSize: number, pageNumber: number, query?: Query,
|
|
429
|
+
/** @deprecated Ignored — Prolog engine has been removed. */
|
|
430
|
+
_engine?: 'sparql' | 'prolog' | boolean): Promise<PaginationResult<T>>;
|
|
414
431
|
/**
|
|
415
|
-
* Generates a
|
|
432
|
+
* Generates a SPARQL COUNT query for the model.
|
|
416
433
|
*
|
|
417
434
|
* @param perspective - The perspective context
|
|
418
435
|
* @param query - Query parameters to filter the count
|
|
419
|
-
* @returns
|
|
436
|
+
* @returns SPARQL COUNT query string
|
|
420
437
|
*
|
|
421
438
|
* @private
|
|
422
439
|
*/
|
|
423
|
-
static countQueryToSurrealQL(perspective: PerspectiveProxy, query: Query): Promise<string>;
|
|
424
440
|
/**
|
|
425
441
|
* Gets a count of all matching instances.
|
|
426
442
|
*
|
|
427
443
|
* @param perspective - The perspective to search in
|
|
428
444
|
* @param query - Optional query parameters to filter results
|
|
429
|
-
* @param useSurrealDB - Whether to use SurrealDB (default: true, 10-100x faster) or Prolog (legacy)
|
|
430
445
|
* @returns Total count of matching entities
|
|
431
446
|
*
|
|
432
447
|
* @example
|
|
@@ -435,12 +450,9 @@ export declare class Ad4mModel {
|
|
|
435
450
|
* const activeRecipes = await Recipe.count(perspective, {
|
|
436
451
|
* where: { status: "active" }
|
|
437
452
|
* });
|
|
438
|
-
*
|
|
439
|
-
* // Use Prolog explicitly (legacy)
|
|
440
|
-
* const countProlog = await Recipe.count(perspective, {}, false);
|
|
441
453
|
* ```
|
|
442
454
|
*/
|
|
443
|
-
static count(perspective: PerspectiveProxy, query?: Query
|
|
455
|
+
static count(perspective: PerspectiveProxy, query?: Query): Promise<number>;
|
|
444
456
|
private setProperty;
|
|
445
457
|
/** Resolve a relation argument to a plain string ID. Accepts either a raw
|
|
446
458
|
* string ID or an Ad4mModel instance (in which case `.id` is used). */
|
|
@@ -477,6 +489,30 @@ export declare class Ad4mModel {
|
|
|
477
489
|
save(batchId?: string): Promise<void>;
|
|
478
490
|
private cleanCopy;
|
|
479
491
|
private innerUpdate;
|
|
492
|
+
/**
|
|
493
|
+
* Evaluate SPARQL getters for a batch of instances on demand.
|
|
494
|
+
*
|
|
495
|
+
* Since deepQuery defaults to true, property getters are evaluated
|
|
496
|
+
* automatically during collection queries. Use this method when
|
|
497
|
+
* deepQuery was explicitly set to false and you want to lazily
|
|
498
|
+
* resolve getter-backed properties for a subset of instances.
|
|
499
|
+
*
|
|
500
|
+
* @param instances - Array of model instances to evaluate getters on
|
|
501
|
+
* @param perspective - The perspective to query against
|
|
502
|
+
* @param propertyNames - Optional list of getter-backed property names to evaluate.
|
|
503
|
+
* If omitted, all getters are evaluated.
|
|
504
|
+
*
|
|
505
|
+
* @example
|
|
506
|
+
* ```typescript
|
|
507
|
+
* const messages = await Message.query(perspective).deepQuery(false).limit(30).get();
|
|
508
|
+
* // messages[i].replyingTo is undefined (getter skipped)
|
|
509
|
+
*
|
|
510
|
+
* // Evaluate getters for the visible subset
|
|
511
|
+
* await Message.evaluateGetters(messages.slice(0, 10), perspective, ['replyingTo']);
|
|
512
|
+
* // messages[0..9].replyingTo is now populated
|
|
513
|
+
* ```
|
|
514
|
+
*/
|
|
515
|
+
static evaluateGetters<T extends Ad4mModel>(instances: T[], perspective: PerspectiveProxy, propertyNames?: string[]): Promise<void>;
|
|
480
516
|
/**
|
|
481
517
|
* Gets the model instance with all properties and relations populated.
|
|
482
518
|
*
|
|
@@ -618,6 +654,20 @@ export declare class Ad4mModel {
|
|
|
618
654
|
* ```
|
|
619
655
|
*/
|
|
620
656
|
static register(this: typeof Ad4mModel, perspective: PerspectiveProxy): Promise<void>;
|
|
657
|
+
/**
|
|
658
|
+
* Batch-registers multiple model classes on a perspective in a single RPC call.
|
|
659
|
+
* This is significantly faster than calling `register()` on each model individually
|
|
660
|
+
* because it eliminates N-1 round-trips and mutex acquisitions.
|
|
661
|
+
*
|
|
662
|
+
* @param perspective - The perspective to register the models on
|
|
663
|
+
* @param models - Array of Ad4mModel subclasses to register
|
|
664
|
+
*
|
|
665
|
+
* @example
|
|
666
|
+
* ```typescript
|
|
667
|
+
* await Ad4mModel.registerAll(perspective, [Community, Channel, Message, Task]);
|
|
668
|
+
* ```
|
|
669
|
+
*/
|
|
670
|
+
static registerAll(perspective: PerspectiveProxy, models: (typeof Ad4mModel)[]): Promise<void>;
|
|
621
671
|
/**
|
|
622
672
|
* Executes a set of model operations inside a single batch (transaction).
|
|
623
673
|
*
|
|
@@ -724,4 +774,42 @@ export declare class Ad4mModel {
|
|
|
724
774
|
* @throws Error when namespace cannot be inferred
|
|
725
775
|
*/
|
|
726
776
|
static fromJSONSchema(schema: JSONSchema, options: JSONSchemaToModelOptions): typeof Ad4mModel;
|
|
777
|
+
/**
|
|
778
|
+
* Creates a fully functional Ad4mModel subclass from a SHACL shape.
|
|
779
|
+
*
|
|
780
|
+
* Unlike `fromJSONSchema()`, no predicate inference is required —
|
|
781
|
+
* `SHACLShape` already contains the exact predicate URI in `path` for
|
|
782
|
+
* every property. The method reads each property's `path`, `maxCount`,
|
|
783
|
+
* `writable`, and `resolveLanguage` directly and writes them to the
|
|
784
|
+
* WeakMap metadata registries.
|
|
785
|
+
*
|
|
786
|
+
* Properties with `hasValue` (flag / type-discrimination markers) are
|
|
787
|
+
* registered as hidden flag entries so that the SPARQL query builder emits
|
|
788
|
+
* the fixed triple `?source <predicate> <value>` needed for type discrimination.
|
|
789
|
+
* Properties without a `name` field are skipped.
|
|
790
|
+
*
|
|
791
|
+
* **Backward-compat:** Old Flux SHACL shapes (created before `sh:hasValue`
|
|
792
|
+
* was persisted on property shapes) carry the flag value only in
|
|
793
|
+
* `shape.constructor_actions` as the `target` of an `addLink` action.
|
|
794
|
+
* This method recovers those values so that old perspectives are queried
|
|
795
|
+
* with the correct type-discriminator triple.
|
|
796
|
+
*
|
|
797
|
+
* @param shape - SHACL node shape (as returned by `PerspectiveProxy.getAllShacl()`)
|
|
798
|
+
* @param name - Class name to assign (e.g. "Channel")
|
|
799
|
+
* @returns Generated Ad4mModel subclass, ready for querying
|
|
800
|
+
*/
|
|
801
|
+
/**
|
|
802
|
+
* Synthesise an `Ad4mModel` subclass from a SHACL shape.
|
|
803
|
+
*
|
|
804
|
+
* @param shape - The SHACL shape to synthesise from.
|
|
805
|
+
* @param name - The model name (e.g. "Channel").
|
|
806
|
+
* @param classResolver - Optional thunk factory. When provided, any collection
|
|
807
|
+
* property that carries a `sh:class` URI will have its `target` wired up lazily:
|
|
808
|
+
* `target: () => classResolver(localName)`. Because `target` is only called at
|
|
809
|
+
* query time (inside `enrichShapeForIncludes` / `jsonToModelInstance`), the
|
|
810
|
+
* resolver just needs to return the correct class by the time a query runs —
|
|
811
|
+
* making it safe to pass a closure over a registry object that is still being
|
|
812
|
+
* populated (e.g. the `result` record inside `getModelClasses`).
|
|
813
|
+
*/
|
|
814
|
+
static fromSHACL(shape: SHACLShape, name: string, classResolver?: (localName: string) => typeof Ad4mModel | undefined): typeof Ad4mModel;
|
|
727
815
|
}
|