@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
package/src/model/decorators.ts
CHANGED
|
@@ -2,7 +2,7 @@ import { capitalize } from "./util";
|
|
|
2
2
|
import type { Where } from "./types";
|
|
3
3
|
import { buildSDNA } from "./sdna";
|
|
4
4
|
import { buildSHACL } from "./shacl-gen";
|
|
5
|
-
import {
|
|
5
|
+
import { escapeQueryString } from "../utils";
|
|
6
6
|
import type { ConformanceCondition } from "../shacl/SHACLShape";
|
|
7
7
|
|
|
8
8
|
// ============================================================================
|
|
@@ -32,7 +32,7 @@ export interface RelationMetadataEntry {
|
|
|
32
32
|
maxCount?: number;
|
|
33
33
|
local?: boolean;
|
|
34
34
|
/**
|
|
35
|
-
* Custom
|
|
35
|
+
* Custom getter to resolve the relation values.
|
|
36
36
|
* The expression can reference 'Base' which will be replaced with the instance's base expression.
|
|
37
37
|
*/
|
|
38
38
|
getter?: string;
|
|
@@ -56,12 +56,24 @@ const propertyRegistry = new WeakMap<Function, Record<string, PropertyMetadataEn
|
|
|
56
56
|
/** Registry of relation metadata keyed by constructor → { propName → metadata } */
|
|
57
57
|
const relationRegistry = new WeakMap<Function, Record<string, RelationMetadataEntry>>();
|
|
58
58
|
|
|
59
|
+
/** Memoisation cache for getPropertiesMetadata — avoids repeated prototype-chain walks */
|
|
60
|
+
const propertiesMetadataCache = new WeakMap<Function, Record<string, PropertyMetadataEntry>>();
|
|
61
|
+
|
|
62
|
+
/** Memoisation cache for getRelationsMetadata — avoids repeated prototype-chain walks */
|
|
63
|
+
const relationsMetadataCache = new WeakMap<Function, Record<string, RelationMetadataEntry>>();
|
|
64
|
+
|
|
65
|
+
/** Memoisation cache for generateSHACL — avoids recomputing SHACL shapes */
|
|
66
|
+
const shaclCache = new WeakMap<Function, any>();
|
|
59
67
|
|
|
60
68
|
/**
|
|
61
69
|
* Retrieve property metadata for a given class constructor.
|
|
62
70
|
* Walks the prototype chain so subclass decorators compose with parent decorators.
|
|
71
|
+
* Results are memoised per class constructor.
|
|
63
72
|
*/
|
|
64
73
|
export function getPropertiesMetadata(ctor: Function): Record<string, PropertyMetadataEntry> {
|
|
74
|
+
const cached = propertiesMetadataCache.get(ctor);
|
|
75
|
+
if (cached) return cached;
|
|
76
|
+
|
|
65
77
|
const result: Record<string, PropertyMetadataEntry> = {};
|
|
66
78
|
const chain: Function[] = [];
|
|
67
79
|
let current = ctor;
|
|
@@ -73,14 +85,19 @@ export function getPropertiesMetadata(ctor: Function): Record<string, PropertyMe
|
|
|
73
85
|
const meta = propertyRegistry.get(c);
|
|
74
86
|
if (meta) Object.assign(result, meta);
|
|
75
87
|
}
|
|
88
|
+
propertiesMetadataCache.set(ctor, result);
|
|
76
89
|
return result;
|
|
77
90
|
}
|
|
78
91
|
|
|
79
92
|
/**
|
|
80
93
|
* Retrieve relation metadata for a given class constructor.
|
|
81
94
|
* Walks the prototype chain so subclass decorators compose with parent decorators.
|
|
95
|
+
* Results are memoised per class constructor.
|
|
82
96
|
*/
|
|
83
97
|
export function getRelationsMetadata(ctor: Function): Record<string, RelationMetadataEntry> {
|
|
98
|
+
const cached = relationsMetadataCache.get(ctor);
|
|
99
|
+
if (cached) return cached;
|
|
100
|
+
|
|
84
101
|
const result: Record<string, RelationMetadataEntry> = {};
|
|
85
102
|
const chain: Function[] = [];
|
|
86
103
|
let current = ctor;
|
|
@@ -92,6 +109,18 @@ export function getRelationsMetadata(ctor: Function): Record<string, RelationMet
|
|
|
92
109
|
const meta = relationRegistry.get(c);
|
|
93
110
|
if (meta) Object.assign(result, meta);
|
|
94
111
|
}
|
|
112
|
+
relationsMetadataCache.set(ctor, result);
|
|
113
|
+
return result;
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/**
|
|
117
|
+
* Get or compute memoised SHACL for a class. Used by @Model decorator.
|
|
118
|
+
*/
|
|
119
|
+
export function getMemoizedSHACL(target: Function, compute: () => any): any {
|
|
120
|
+
const cached = shaclCache.get(target);
|
|
121
|
+
if (cached) return cached;
|
|
122
|
+
const result = compute();
|
|
123
|
+
shaclCache.set(target, result);
|
|
95
124
|
return result;
|
|
96
125
|
}
|
|
97
126
|
|
|
@@ -137,7 +166,7 @@ export interface Ad4mModelLike {
|
|
|
137
166
|
*
|
|
138
167
|
* Inspects the target class's property metadata to derive:
|
|
139
168
|
* - `conformanceConditions`: Structured, DB-agnostic conditions (flag & required checks)
|
|
140
|
-
* - `getter`: Pre-computed
|
|
169
|
+
* - `getter`: Pre-computed graph traversal expression that traverses outgoing links and filters
|
|
141
170
|
* target nodes to only those conforming to the target shape.
|
|
142
171
|
*
|
|
143
172
|
* @param relationPredicate - The relation's predicate URI (e.g. "flux://entry_type")
|
|
@@ -151,7 +180,8 @@ export function buildConformanceFilter(
|
|
|
151
180
|
try {
|
|
152
181
|
const targetProps = getPropertiesMetadata(targetClass);
|
|
153
182
|
const conditions: ConformanceCondition[] = [];
|
|
154
|
-
const
|
|
183
|
+
const sparqlConditions: string[] = [];
|
|
184
|
+
let varIdx = 0;
|
|
155
185
|
|
|
156
186
|
// 1. Flags — check predicate + value
|
|
157
187
|
for (const [_propName, propMeta] of Object.entries(targetProps)) {
|
|
@@ -161,8 +191,8 @@ export function buildConformanceFilter(
|
|
|
161
191
|
predicate: propMeta.through,
|
|
162
192
|
value: propMeta.initial,
|
|
163
193
|
});
|
|
164
|
-
|
|
165
|
-
|
|
194
|
+
sparqlConditions.push(
|
|
195
|
+
`?target <${escapeQueryString(propMeta.through)}> <${escapeQueryString(propMeta.initial)}> .`
|
|
166
196
|
);
|
|
167
197
|
}
|
|
168
198
|
}
|
|
@@ -175,8 +205,8 @@ export function buildConformanceFilter(
|
|
|
175
205
|
type: 'required',
|
|
176
206
|
predicate: propMeta.through,
|
|
177
207
|
});
|
|
178
|
-
|
|
179
|
-
|
|
208
|
+
sparqlConditions.push(
|
|
209
|
+
`?target <${escapeQueryString(propMeta.through)}> ?_v${varIdx++} .`
|
|
180
210
|
);
|
|
181
211
|
}
|
|
182
212
|
}
|
|
@@ -185,8 +215,7 @@ export function buildConformanceFilter(
|
|
|
185
215
|
return undefined;
|
|
186
216
|
}
|
|
187
217
|
|
|
188
|
-
const
|
|
189
|
-
const getter = `(->link[WHERE predicate = '${escapedPredicate}'].out[WHERE ${surrealConditions.join(' AND ')}].uri)`;
|
|
218
|
+
const getter = `SELECT ?target WHERE { <Base> <${escapeQueryString(relationPredicate)}> ?target . ${sparqlConditions.join(' ')} }`;
|
|
190
219
|
|
|
191
220
|
return { getter, conformanceConditions: conditions };
|
|
192
221
|
} catch (e) {
|
|
@@ -233,9 +262,9 @@ export interface PropertyOptions {
|
|
|
233
262
|
prologSetter?: string;
|
|
234
263
|
|
|
235
264
|
/**
|
|
236
|
-
* Custom
|
|
265
|
+
* Custom getter to resolve the property value. Use this for custom graph traversals.
|
|
237
266
|
* The expression can reference 'Base' which will be replaced with the instance's base expression.
|
|
238
|
-
* Example: "
|
|
267
|
+
* Example: "SELECT ?target WHERE { <Base> <flux://has_reply> ?target . } LIMIT 1"
|
|
239
268
|
*/
|
|
240
269
|
getter?: string;
|
|
241
270
|
|
|
@@ -250,6 +279,26 @@ export interface PropertyOptions {
|
|
|
250
279
|
* The function takes the raw value as input and returns the transformed value.
|
|
251
280
|
*/
|
|
252
281
|
transform?: (value: any) => any;
|
|
282
|
+
|
|
283
|
+
/**
|
|
284
|
+
* Allowed values for this property (enum constraint).
|
|
285
|
+
* Maps to SHACL `sh:in`. Each entry has a `value` (the stored RDF term)
|
|
286
|
+
* and an optional `label` (human-readable display name).
|
|
287
|
+
*
|
|
288
|
+
* @example
|
|
289
|
+
* ```typescript
|
|
290
|
+
* @Property({
|
|
291
|
+
* through: "task://status",
|
|
292
|
+
* options: [
|
|
293
|
+
* { value: "task://todo", label: "To Do" },
|
|
294
|
+
* { value: "task://doing", label: "Doing" },
|
|
295
|
+
* { value: "task://done", label: "Done" },
|
|
296
|
+
* ]
|
|
297
|
+
* })
|
|
298
|
+
* status: string = "task://todo";
|
|
299
|
+
* ```
|
|
300
|
+
*/
|
|
301
|
+
options?: Array<{ value: string; label?: string }>;
|
|
253
302
|
}
|
|
254
303
|
|
|
255
304
|
|
|
@@ -268,8 +317,8 @@ function applyPropertyMetadata(opts: PropertyOptions) {
|
|
|
268
317
|
throw new Error("SubjectProperty requires an 'initial' option if 'required' is true");
|
|
269
318
|
}
|
|
270
319
|
|
|
271
|
-
if (!opts.through && !opts.prologGetter) {
|
|
272
|
-
throw new Error("SubjectProperty requires either 'through' or 'prologGetter' option")
|
|
320
|
+
if (!opts.through && !opts.prologGetter && !opts.getter) {
|
|
321
|
+
throw new Error("SubjectProperty requires either 'through' or 'prologGetter' or 'getter' option")
|
|
273
322
|
}
|
|
274
323
|
|
|
275
324
|
// Write to WeakMap registry (keyed by constructor)
|
|
@@ -492,13 +541,13 @@ export function Model(opts: ModelConfig) {
|
|
|
492
541
|
}
|
|
493
542
|
|
|
494
543
|
target.generateSHACL = function() {
|
|
495
|
-
return buildSHACL(
|
|
544
|
+
return getMemoizedSHACL(target, () => buildSHACL(
|
|
496
545
|
opts.name,
|
|
497
546
|
target,
|
|
498
547
|
getPropertiesMetadata(target),
|
|
499
548
|
getRelationsMetadata(target),
|
|
500
549
|
buildConformanceFilter,
|
|
501
|
-
);
|
|
550
|
+
));
|
|
502
551
|
}
|
|
503
552
|
|
|
504
553
|
Object.defineProperty(target, 'type', {configurable: true});
|
|
@@ -523,7 +572,7 @@ export function Model(opts: ModelConfig) {
|
|
|
523
572
|
* Properties are optional by default. When a model instance is created without
|
|
524
573
|
* providing a value for an optional property, no link is added to the graph.
|
|
525
574
|
* Set `required: true` explicitly when a property must always be present (this
|
|
526
|
-
* also adds a `"literal
|
|
575
|
+
* also adds a `"literal:string:uninitialized"` sentinel as the initial value
|
|
527
576
|
* so that the SDNA constructor creates a placeholder link).
|
|
528
577
|
*
|
|
529
578
|
* @example
|
|
@@ -562,7 +611,7 @@ export function Model(opts: ModelConfig) {
|
|
|
562
611
|
* @param {PropertyOptions} opts - Property configuration
|
|
563
612
|
* @param {string} opts.through - The predicate URI for the property
|
|
564
613
|
* @param {boolean} [opts.required=false] - Whether the property is required (adds query filters and sentinel initial value)
|
|
565
|
-
* @param {string} [opts.initial] - Initial value (defaults to "literal
|
|
614
|
+
* @param {string} [opts.initial] - Initial value (defaults to "literal:string:uninitialized" when required)
|
|
566
615
|
* @param {string} [opts.resolveLanguage] - Language to use for value resolution (e.g. "literal")
|
|
567
616
|
* @param {string} [opts.prologGetter] - Custom Prolog code for getting the property value
|
|
568
617
|
* @param {string} [opts.prologSetter] - Custom Prolog code for setting the property value
|
|
@@ -575,7 +624,7 @@ export function Property(opts: PropertyOptions) {
|
|
|
575
624
|
required,
|
|
576
625
|
readOnly: opts.readOnly ?? false,
|
|
577
626
|
resolveLanguage: opts.resolveLanguage ?? "literal",
|
|
578
|
-
initial: opts.initial ?? (required ? "literal
|
|
627
|
+
initial: opts.initial ?? (required ? "literal:string:uninitialized" : undefined),
|
|
579
628
|
});
|
|
580
629
|
}
|
|
581
630
|
|
|
@@ -659,9 +708,9 @@ export interface RelationOptions {
|
|
|
659
708
|
* Cannot be combined with `getter`. */
|
|
660
709
|
target?: () => Ad4mModelLike;
|
|
661
710
|
/**
|
|
662
|
-
* Custom
|
|
711
|
+
* Custom getter to resolve the relation values. Use this for custom graph traversals.
|
|
663
712
|
* The expression can reference 'Base' which will be replaced with the instance's base expression.
|
|
664
|
-
* Example: "
|
|
713
|
+
* Example: "SELECT ?target WHERE { ?target <flux://has_reply> <Base> . }"
|
|
665
714
|
*
|
|
666
715
|
* Mutually exclusive with `through` and `target`. When `getter` is provided the
|
|
667
716
|
* relation is read-only (no adder/remover actions are generated).
|
|
@@ -750,7 +799,7 @@ function resolveRelationArgs(
|
|
|
750
799
|
if (opts.where) {
|
|
751
800
|
throw new Error(
|
|
752
801
|
'Relation decorator: `where` and `getter` are mutually exclusive. ' +
|
|
753
|
-
'Use `where` for DSL-based filtering, or `getter` for raw
|
|
802
|
+
'Use `where` for DSL-based filtering, or `getter` for raw getter expression.'
|
|
754
803
|
);
|
|
755
804
|
}
|
|
756
805
|
return opts;
|