@coasys/ad4m 0.12.1-dev → 0.13.0-postmessage-ws-proxy.3
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 +8677 -15318
- package/lib/index.js +14507 -21223
- 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 -374
- 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 +8 -2
- package/lib/src/index.js +8 -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 +143 -63
- package/lib/src/model/Ad4mModel.js +583 -425
- package/lib/src/model/Ad4mModel.test.js +1434 -688
- package/lib/src/model/ModelQueryBuilder.d.ts +61 -45
- package/lib/src/model/ModelQueryBuilder.js +315 -157
- 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 +154 -57
- 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 +195 -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 +188 -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 +157 -78
- package/lib/src/perspectives/PerspectiveProxy.js +475 -389
- package/lib/src/perspectives/PerspectiveResolver.d.ts +0 -1
- package/lib/src/perspectives/PerspectiveResolver.js +0 -11
- package/lib/src/perspectives/SparqlBindings.d.ts +47 -0
- package/lib/src/perspectives/SparqlBindings.js +65 -0
- package/lib/src/perspectives/WakerSubscriptionManager.d.ts +3 -3
- package/lib/src/perspectives/WakerSubscriptionManager.js +12 -12
- package/lib/src/runtime/RuntimeClient.d.ts +8 -6
- package/lib/src/runtime/RuntimeClient.js +97 -454
- package/lib/src/runtime/RuntimeResolver.d.ts +14 -0
- package/lib/src/runtime/RuntimeResolver.js +84 -0
- package/lib/src/runtime/RuntimeTypes.d.ts +101 -0
- package/lib/src/runtime/RuntimeTypes.js +45 -0
- package/lib/src/schema.gql +14 -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 +26 -1
- package/lib/src/shacl/SHACLShape.js +140 -38
- package/lib/src/shacl/SHACLShape.test.js +82 -0
- package/lib/src/typeDefs.js +3 -615
- package/lib/src/utils.d.ts +6 -6
- package/lib/src/utils.js +6 -6
- package/package.json +9 -24
- 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 -467
- 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 +8 -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 +1664 -792
- package/src/model/Ad4mModel.ts +664 -499
- package/src/model/ModelQueryBuilder.ts +362 -183
- 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 +60 -53
- package/src/model/sdna.ts +1 -1
- package/src/model/shacl-gen.ts +163 -64
- package/src/model/shacl-roundtrip.test.ts +197 -0
- package/src/model/types-typed-query.test.ts +360 -0
- package/src/model/types.ts +256 -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 +252 -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/SparqlBindings.ts +79 -0
- package/src/perspectives/WakerSubscriptionManager.ts +13 -13
- package/src/runtime/RuntimeClient.ts +118 -461
- package/src/runtime/RuntimeTypes.ts +144 -0
- package/src/shacl/SHACLFlow.ts +9 -9
- package/src/shacl/SHACLShape.test.ts +204 -0
- package/src/shacl/SHACLShape.ts +191 -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 -691
- package/src/unwrapApolloResult.ts +0 -16
- package/tsconfig-browser.json +0 -82
|
@@ -1,85 +1,14 @@
|
|
|
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 } from "../expression/Expression";
|
|
12
|
-
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
Field(),
|
|
16
|
-
__metadata("design:type", String)
|
|
17
|
-
], LanguageMeta.prototype, "name", void 0);
|
|
18
|
-
__decorate([
|
|
19
|
-
Field(),
|
|
20
|
-
__metadata("design:type", String)
|
|
21
|
-
], LanguageMeta.prototype, "address", void 0);
|
|
22
|
-
__decorate([
|
|
23
|
-
Field({ nullable: true }),
|
|
24
|
-
__metadata("design:type", String)
|
|
25
|
-
], LanguageMeta.prototype, "description", void 0);
|
|
26
|
-
__decorate([
|
|
27
|
-
Field(),
|
|
28
|
-
__metadata("design:type", String)
|
|
29
|
-
], LanguageMeta.prototype, "author", void 0);
|
|
30
|
-
__decorate([
|
|
31
|
-
Field({ nullable: true }),
|
|
32
|
-
__metadata("design:type", Boolean)
|
|
33
|
-
], LanguageMeta.prototype, "templated", void 0);
|
|
34
|
-
__decorate([
|
|
35
|
-
Field({ nullable: true }),
|
|
36
|
-
__metadata("design:type", String)
|
|
37
|
-
], LanguageMeta.prototype, "templateSourceLanguageAddress", void 0);
|
|
38
|
-
__decorate([
|
|
39
|
-
Field({ nullable: true }),
|
|
40
|
-
__metadata("design:type", String)
|
|
41
|
-
], LanguageMeta.prototype, "templateAppliedParams", void 0);
|
|
42
|
-
__decorate([
|
|
43
|
-
Field(type => [String], { nullable: true }),
|
|
44
|
-
__metadata("design:type", Array)
|
|
45
|
-
], LanguageMeta.prototype, "possibleTemplateParams", void 0);
|
|
46
|
-
__decorate([
|
|
47
|
-
Field({ nullable: true }),
|
|
48
|
-
__metadata("design:type", String)
|
|
49
|
-
], LanguageMeta.prototype, "sourceCodeLink", void 0);
|
|
50
|
-
LanguageMeta = __decorate([
|
|
51
|
-
ObjectType()
|
|
52
|
-
], LanguageMeta);
|
|
53
|
-
export { LanguageMeta };
|
|
54
|
-
let LanguageMetaInput = class LanguageMetaInput {
|
|
2
|
+
export class LanguageMeta {
|
|
3
|
+
}
|
|
4
|
+
export class LanguageMetaInput {
|
|
55
5
|
constructor(name, description) {
|
|
56
6
|
this.name = name;
|
|
57
7
|
this.description = description;
|
|
58
8
|
if (!this.description)
|
|
59
9
|
this.description = "";
|
|
60
10
|
}
|
|
61
|
-
}
|
|
62
|
-
__decorate([
|
|
63
|
-
Field(),
|
|
64
|
-
__metadata("design:type", String)
|
|
65
|
-
], LanguageMetaInput.prototype, "name", void 0);
|
|
66
|
-
__decorate([
|
|
67
|
-
Field(),
|
|
68
|
-
__metadata("design:type", String)
|
|
69
|
-
], LanguageMetaInput.prototype, "description", void 0);
|
|
70
|
-
__decorate([
|
|
71
|
-
Field(type => [String], { nullable: true }),
|
|
72
|
-
__metadata("design:type", Array)
|
|
73
|
-
], LanguageMetaInput.prototype, "possibleTemplateParams", void 0);
|
|
74
|
-
__decorate([
|
|
75
|
-
Field({ nullable: true }),
|
|
76
|
-
__metadata("design:type", String)
|
|
77
|
-
], LanguageMetaInput.prototype, "sourceCodeLink", void 0);
|
|
78
|
-
LanguageMetaInput = __decorate([
|
|
79
|
-
InputType(),
|
|
80
|
-
__metadata("design:paramtypes", [String, String])
|
|
81
|
-
], LanguageMetaInput);
|
|
82
|
-
export { LanguageMetaInput };
|
|
11
|
+
}
|
|
83
12
|
export class LanguageMetaInternal {
|
|
84
13
|
}
|
|
85
14
|
export class LanguageExpression extends ExpressionGeneric(LanguageMetaInternal) {
|
|
@@ -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, TypedQuery, IncludeExtras, IncludeOf } 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 and queryJson that the Rust executor expects.
|
|
304
|
+
* Shape resolution happens server-side from the perspective's SHACL triples.
|
|
305
|
+
* @internal
|
|
306
|
+
*/
|
|
307
|
+
static prepareModelQueryParams(query?: Query, classNameOverride?: string | null): {
|
|
308
|
+
className: string;
|
|
309
|
+
queryJson: 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,9 @@ 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?:
|
|
365
|
+
static findAll<T extends Ad4mModel, Q extends TypedQuery<T> = {}>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Q): Promise<(T & IncludeExtras<T, IncludeOf<Q>>)[]>;
|
|
349
366
|
/**
|
|
350
367
|
* Finds the first instance matching the query, or `null` if none exists.
|
|
351
368
|
*
|
|
@@ -353,7 +370,7 @@ export declare class Ad4mModel {
|
|
|
353
370
|
*
|
|
354
371
|
* @param perspective - The perspective to search in
|
|
355
372
|
* @param query - Optional query parameters to filter results
|
|
356
|
-
* @param
|
|
373
|
+
* @param _engine - **Deprecated.** Accepted for backward compatibility but ignored.
|
|
357
374
|
* @returns The first matching instance, or `null`
|
|
358
375
|
*
|
|
359
376
|
* @example
|
|
@@ -366,13 +383,13 @@ export declare class Ad4mModel {
|
|
|
366
383
|
* }
|
|
367
384
|
* ```
|
|
368
385
|
*/
|
|
369
|
-
static findOne<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?:
|
|
386
|
+
static findOne<T extends Ad4mModel, Q extends TypedQuery<T> = {}>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Q): Promise<(T & IncludeExtras<T, IncludeOf<Q>>) | null>;
|
|
370
387
|
/**
|
|
371
388
|
* Gets all instances with count of total matches without offset & limit applied.
|
|
372
389
|
*
|
|
373
390
|
* @param perspective - The perspective to search in
|
|
374
391
|
* @param query - Optional query parameters to filter results
|
|
375
|
-
* @param
|
|
392
|
+
* @param _engine - **Deprecated.** Accepted for backward compatibility but ignored.
|
|
376
393
|
* @returns Object containing results array and total count
|
|
377
394
|
*
|
|
378
395
|
* @example
|
|
@@ -382,12 +399,9 @@ export declare class Ad4mModel {
|
|
|
382
399
|
* limit: 10
|
|
383
400
|
* });
|
|
384
401
|
* console.log(`Showing 10 of ${totalCount} dessert recipes`);
|
|
385
|
-
*
|
|
386
|
-
* // Use Prolog explicitly (legacy)
|
|
387
|
-
* const { results, totalCount } = await Recipe.findAllAndCount(perspective, {}, false);
|
|
388
402
|
* ```
|
|
389
403
|
*/
|
|
390
|
-
static findAllAndCount<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?:
|
|
404
|
+
static findAllAndCount<T extends Ad4mModel, Q extends TypedQuery<T> = {}>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Q): Promise<ResultsWithTotalCount<T & IncludeExtras<T, IncludeOf<Q>>>>;
|
|
391
405
|
/**
|
|
392
406
|
* Helper function for pagination with explicit page size and number.
|
|
393
407
|
*
|
|
@@ -395,7 +409,6 @@ export declare class Ad4mModel {
|
|
|
395
409
|
* @param pageSize - Number of items per page
|
|
396
410
|
* @param pageNumber - Which page to retrieve (1-based)
|
|
397
411
|
* @param query - Optional additional query parameters
|
|
398
|
-
* @param useSurrealDB - Whether to use SurrealDB (default: true, 10-100x faster) or Prolog (legacy)
|
|
399
412
|
* @returns Paginated results with metadata
|
|
400
413
|
*
|
|
401
414
|
* @example
|
|
@@ -404,29 +417,23 @@ export declare class Ad4mModel {
|
|
|
404
417
|
* where: { category: "Main Course" }
|
|
405
418
|
* });
|
|
406
419
|
* 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
420
|
* ```
|
|
411
421
|
*/
|
|
412
|
-
static paginate<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, pageSize: number, pageNumber: number, query?:
|
|
413
|
-
static countQueryToProlog(perspective: PerspectiveProxy, query?: Query, modelClassName?: string | null): Promise<string>;
|
|
422
|
+
static paginate<T extends Ad4mModel, Q extends TypedQuery<T> = {}>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, pageSize: number, pageNumber: number, query?: Q): Promise<PaginationResult<T & IncludeExtras<T, IncludeOf<Q>>>>;
|
|
414
423
|
/**
|
|
415
|
-
* Generates a
|
|
424
|
+
* Generates a SPARQL COUNT query for the model.
|
|
416
425
|
*
|
|
417
426
|
* @param perspective - The perspective context
|
|
418
427
|
* @param query - Query parameters to filter the count
|
|
419
|
-
* @returns
|
|
428
|
+
* @returns SPARQL COUNT query string
|
|
420
429
|
*
|
|
421
430
|
* @private
|
|
422
431
|
*/
|
|
423
|
-
static countQueryToSurrealQL(perspective: PerspectiveProxy, query: Query): Promise<string>;
|
|
424
432
|
/**
|
|
425
433
|
* Gets a count of all matching instances.
|
|
426
434
|
*
|
|
427
435
|
* @param perspective - The perspective to search in
|
|
428
436
|
* @param query - Optional query parameters to filter results
|
|
429
|
-
* @param useSurrealDB - Whether to use SurrealDB (default: true, 10-100x faster) or Prolog (legacy)
|
|
430
437
|
* @returns Total count of matching entities
|
|
431
438
|
*
|
|
432
439
|
* @example
|
|
@@ -435,12 +442,9 @@ export declare class Ad4mModel {
|
|
|
435
442
|
* const activeRecipes = await Recipe.count(perspective, {
|
|
436
443
|
* where: { status: "active" }
|
|
437
444
|
* });
|
|
438
|
-
*
|
|
439
|
-
* // Use Prolog explicitly (legacy)
|
|
440
|
-
* const countProlog = await Recipe.count(perspective, {}, false);
|
|
441
445
|
* ```
|
|
442
446
|
*/
|
|
443
|
-
static count(perspective: PerspectiveProxy, query?:
|
|
447
|
+
static count<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: TypedQuery<T>): Promise<number>;
|
|
444
448
|
private setProperty;
|
|
445
449
|
/** Resolve a relation argument to a plain string ID. Accepts either a raw
|
|
446
450
|
* string ID or an Ad4mModel instance (in which case `.id` is used). */
|
|
@@ -477,6 +481,30 @@ export declare class Ad4mModel {
|
|
|
477
481
|
save(batchId?: string): Promise<void>;
|
|
478
482
|
private cleanCopy;
|
|
479
483
|
private innerUpdate;
|
|
484
|
+
/**
|
|
485
|
+
* Evaluate SPARQL getters for a batch of instances on demand.
|
|
486
|
+
*
|
|
487
|
+
* Since deepQuery defaults to true, property getters are evaluated
|
|
488
|
+
* automatically during collection queries. Use this method when
|
|
489
|
+
* deepQuery was explicitly set to false and you want to lazily
|
|
490
|
+
* resolve getter-backed properties for a subset of instances.
|
|
491
|
+
*
|
|
492
|
+
* @param instances - Array of model instances to evaluate getters on
|
|
493
|
+
* @param perspective - The perspective to query against
|
|
494
|
+
* @param propertyNames - Optional list of getter-backed property names to evaluate.
|
|
495
|
+
* If omitted, all getters are evaluated.
|
|
496
|
+
*
|
|
497
|
+
* @example
|
|
498
|
+
* ```typescript
|
|
499
|
+
* const messages = await Message.query(perspective).deepQuery(false).limit(30).get();
|
|
500
|
+
* // messages[i].replyingTo is undefined (getter skipped)
|
|
501
|
+
*
|
|
502
|
+
* // Evaluate getters for the visible subset
|
|
503
|
+
* await Message.evaluateGetters(messages.slice(0, 10), perspective, ['replyingTo']);
|
|
504
|
+
* // messages[0..9].replyingTo is now populated
|
|
505
|
+
* ```
|
|
506
|
+
*/
|
|
507
|
+
static evaluateGetters<T extends Ad4mModel>(instances: T[], perspective: PerspectiveProxy, propertyNames?: string[]): Promise<void>;
|
|
480
508
|
/**
|
|
481
509
|
* Gets the model instance with all properties and relations populated.
|
|
482
510
|
*
|
|
@@ -618,6 +646,20 @@ export declare class Ad4mModel {
|
|
|
618
646
|
* ```
|
|
619
647
|
*/
|
|
620
648
|
static register(this: typeof Ad4mModel, perspective: PerspectiveProxy): Promise<void>;
|
|
649
|
+
/**
|
|
650
|
+
* Batch-registers multiple model classes on a perspective in a single RPC call.
|
|
651
|
+
* This is significantly faster than calling `register()` on each model individually
|
|
652
|
+
* because it eliminates N-1 round-trips and mutex acquisitions.
|
|
653
|
+
*
|
|
654
|
+
* @param perspective - The perspective to register the models on
|
|
655
|
+
* @param models - Array of Ad4mModel subclasses to register
|
|
656
|
+
*
|
|
657
|
+
* @example
|
|
658
|
+
* ```typescript
|
|
659
|
+
* await Ad4mModel.registerAll(perspective, [Community, Channel, Message, Task]);
|
|
660
|
+
* ```
|
|
661
|
+
*/
|
|
662
|
+
static registerAll(perspective: PerspectiveProxy, models: (typeof Ad4mModel)[]): Promise<void>;
|
|
621
663
|
/**
|
|
622
664
|
* Executes a set of model operations inside a single batch (transaction).
|
|
623
665
|
*
|
|
@@ -671,7 +713,7 @@ export declare class Ad4mModel {
|
|
|
671
713
|
* });
|
|
672
714
|
* ```
|
|
673
715
|
*/
|
|
674
|
-
static query<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?:
|
|
716
|
+
static query<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: TypedQuery<T>): ModelQueryBuilder<T>;
|
|
675
717
|
/**
|
|
676
718
|
* Creates an Ad4mModel class from a JSON Schema definition.
|
|
677
719
|
*
|
|
@@ -724,4 +766,42 @@ export declare class Ad4mModel {
|
|
|
724
766
|
* @throws Error when namespace cannot be inferred
|
|
725
767
|
*/
|
|
726
768
|
static fromJSONSchema(schema: JSONSchema, options: JSONSchemaToModelOptions): typeof Ad4mModel;
|
|
769
|
+
/**
|
|
770
|
+
* Creates a fully functional Ad4mModel subclass from a SHACL shape.
|
|
771
|
+
*
|
|
772
|
+
* Unlike `fromJSONSchema()`, no predicate inference is required —
|
|
773
|
+
* `SHACLShape` already contains the exact predicate URI in `path` for
|
|
774
|
+
* every property. The method reads each property's `path`, `maxCount`,
|
|
775
|
+
* `writable`, and `resolveLanguage` directly and writes them to the
|
|
776
|
+
* WeakMap metadata registries.
|
|
777
|
+
*
|
|
778
|
+
* Properties with `hasValue` (flag / type-discrimination markers) are
|
|
779
|
+
* registered as hidden flag entries so that the SPARQL query builder emits
|
|
780
|
+
* the fixed triple `?source <predicate> <value>` needed for type discrimination.
|
|
781
|
+
* Properties without a `name` field are skipped.
|
|
782
|
+
*
|
|
783
|
+
* **Backward-compat:** Old Flux SHACL shapes (created before `sh:hasValue`
|
|
784
|
+
* was persisted on property shapes) carry the flag value only in
|
|
785
|
+
* `shape.constructor_actions` as the `target` of an `addLink` action.
|
|
786
|
+
* This method recovers those values so that old perspectives are queried
|
|
787
|
+
* with the correct type-discriminator triple.
|
|
788
|
+
*
|
|
789
|
+
* @param shape - SHACL node shape (as returned by `PerspectiveProxy.getAllShacl()`)
|
|
790
|
+
* @param name - Class name to assign (e.g. "Channel")
|
|
791
|
+
* @returns Generated Ad4mModel subclass, ready for querying
|
|
792
|
+
*/
|
|
793
|
+
/**
|
|
794
|
+
* Synthesise an `Ad4mModel` subclass from a SHACL shape.
|
|
795
|
+
*
|
|
796
|
+
* @param shape - The SHACL shape to synthesise from.
|
|
797
|
+
* @param name - The model name (e.g. "Channel").
|
|
798
|
+
* @param classResolver - Optional thunk factory. When provided, any collection
|
|
799
|
+
* property that carries a `sh:class` URI will have its `target` wired up lazily:
|
|
800
|
+
* `target: () => classResolver(localName)`. Because `target` is only called at
|
|
801
|
+
* query time (inside `enrichShapeForIncludes` / `jsonToModelInstance`), the
|
|
802
|
+
* resolver just needs to return the correct class by the time a query runs —
|
|
803
|
+
* making it safe to pass a closure over a registry object that is still being
|
|
804
|
+
* populated (e.g. the `result` record inside `getModelClasses`).
|
|
805
|
+
*/
|
|
806
|
+
static fromSHACL(shape: SHACLShape, name: string, classResolver?: (localName: string) => typeof Ad4mModel | undefined): typeof Ad4mModel;
|
|
727
807
|
}
|