@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
package/src/apiClient.ts
ADDED
|
@@ -0,0 +1,287 @@
|
|
|
1
|
+
/** Shape of event data pushed via WebSocket. Callers can narrow via generics. */
|
|
2
|
+
export interface WsEvent {
|
|
3
|
+
type: string
|
|
4
|
+
[key: string]: unknown
|
|
5
|
+
}
|
|
6
|
+
|
|
7
|
+
/** Error thrown by ApiClient when an RPC call fails. */
|
|
8
|
+
export class RpcError extends Error {
|
|
9
|
+
/** Error code (maps to HTTP status semantics: 400, 401, 403, 404, 500). */
|
|
10
|
+
readonly status: number
|
|
11
|
+
/** Raw error message from server. */
|
|
12
|
+
readonly body: string
|
|
13
|
+
|
|
14
|
+
constructor(status: number, body: string) {
|
|
15
|
+
super(`RPC error ${status}: ${body}`)
|
|
16
|
+
this.name = "RpcError"
|
|
17
|
+
this.status = status
|
|
18
|
+
this.body = body
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
/** Default RPC call timeout in milliseconds (30 seconds). */
|
|
23
|
+
const DEFAULT_TIMEOUT_MS = 30_000
|
|
24
|
+
|
|
25
|
+
/** Maximum reconnect delay in ms. */
|
|
26
|
+
const MAX_RECONNECT_DELAY_MS = 30_000
|
|
27
|
+
|
|
28
|
+
/** Initial reconnect delay in ms. */
|
|
29
|
+
const INITIAL_RECONNECT_DELAY_MS = 500
|
|
30
|
+
|
|
31
|
+
/** Counter for generating unique request IDs. */
|
|
32
|
+
let _idCounter = 0
|
|
33
|
+
function nextId(): string {
|
|
34
|
+
return String(++_idCounter)
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
interface PendingCall {
|
|
38
|
+
resolve: (value: unknown) => void
|
|
39
|
+
reject: (reason: unknown) => void
|
|
40
|
+
timer: ReturnType<typeof setTimeout>
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
export class ApiClient {
|
|
44
|
+
private baseUrl: string
|
|
45
|
+
private token?: string
|
|
46
|
+
private readonly _webSocketImpl?: new (url: string) => WebSocket
|
|
47
|
+
|
|
48
|
+
constructor(baseUrl: string, token?: string, webSocketImpl?: new (url: string) => WebSocket) {
|
|
49
|
+
this.baseUrl = baseUrl
|
|
50
|
+
this.token = token
|
|
51
|
+
this._webSocketImpl = webSocketImpl
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
getBaseUrl(): string { return this.baseUrl }
|
|
55
|
+
getToken(): string | undefined { return this.token }
|
|
56
|
+
|
|
57
|
+
setToken(token: string) {
|
|
58
|
+
this.token = token
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
// ── WebSocket RPC core ──────────────────────────────────────────────────
|
|
62
|
+
|
|
63
|
+
private _ws: WebSocket | null = null
|
|
64
|
+
private _wsCallbacks = new Set<(data: unknown) => void>()
|
|
65
|
+
private _pendingCalls = new Map<string, PendingCall>()
|
|
66
|
+
private _wsReady: Promise<void> | null = null
|
|
67
|
+
private _wsReadyResolve: (() => void) | null = null
|
|
68
|
+
private _wsReconnectTimer: ReturnType<typeof setTimeout> | null = null
|
|
69
|
+
private _wsReconnectDelay = INITIAL_RECONNECT_DELAY_MS
|
|
70
|
+
private _wsClosed = false
|
|
71
|
+
private _wsPingTimer: ReturnType<typeof setInterval> | null = null
|
|
72
|
+
|
|
73
|
+
private _getWsUrl(): string {
|
|
74
|
+
const wsBase = this.baseUrl
|
|
75
|
+
.replace(/^http:\/\//, 'ws://')
|
|
76
|
+
.replace(/^https:\/\//, 'wss://')
|
|
77
|
+
const tokenParam = this.token ? `token=${encodeURIComponent(this.token)}` : ''
|
|
78
|
+
const path = '/api/v1/ws'
|
|
79
|
+
return tokenParam ? `${wsBase}${path}?${tokenParam}` : `${wsBase}${path}`
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
private _ensureWs(): void {
|
|
83
|
+
if (this._ws && (this._ws.readyState === 1 /* OPEN */ || this._ws.readyState === 0 /* CONNECTING */)) {
|
|
84
|
+
return
|
|
85
|
+
}
|
|
86
|
+
// Prevent duplicate connections from concurrent callers
|
|
87
|
+
if (this._wsReady) return
|
|
88
|
+
|
|
89
|
+
this._wsClosed = false
|
|
90
|
+
|
|
91
|
+
this._wsReady = new Promise<void>((resolve) => {
|
|
92
|
+
this._wsReadyResolve = resolve
|
|
93
|
+
})
|
|
94
|
+
|
|
95
|
+
const url = this._getWsUrl()
|
|
96
|
+
const WsImpl = this._webSocketImpl ?? WebSocket
|
|
97
|
+
const ws = new WsImpl(url)
|
|
98
|
+
this._ws = ws
|
|
99
|
+
|
|
100
|
+
ws.onopen = () => {
|
|
101
|
+
this._wsReconnectDelay = INITIAL_RECONNECT_DELAY_MS
|
|
102
|
+
if (this._wsReadyResolve) {
|
|
103
|
+
this._wsReadyResolve()
|
|
104
|
+
this._wsReadyResolve = null
|
|
105
|
+
}
|
|
106
|
+
this._startPing()
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
ws.onmessage = (event) => {
|
|
110
|
+
let parsed: Record<string, unknown>
|
|
111
|
+
try { parsed = JSON.parse(event.data) } catch (e) {
|
|
112
|
+
console.error('Error parsing WebSocket data:', e)
|
|
113
|
+
return
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
// Ignore pong messages
|
|
117
|
+
if (parsed.type === 'pong') return
|
|
118
|
+
|
|
119
|
+
// Check if this is a response to a pending RPC call (has an id field)
|
|
120
|
+
const id = parsed.id as string | undefined
|
|
121
|
+
if (id && this._pendingCalls.has(id)) {
|
|
122
|
+
const pending = this._pendingCalls.get(id)!
|
|
123
|
+
this._pendingCalls.delete(id)
|
|
124
|
+
clearTimeout(pending.timer)
|
|
125
|
+
|
|
126
|
+
if (parsed.error) {
|
|
127
|
+
const err = parsed.error as { code?: number; message?: string }
|
|
128
|
+
pending.reject(new RpcError(err.code ?? 500, err.message ?? 'Unknown error'))
|
|
129
|
+
} else {
|
|
130
|
+
pending.resolve(parsed.result)
|
|
131
|
+
}
|
|
132
|
+
return
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
// Server-push event (no id, or id not in pending) → route to subscribers
|
|
136
|
+
for (const cb of this._wsCallbacks) cb(parsed)
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
ws.onerror = (e) => {
|
|
140
|
+
console.error('WebSocket error:', e)
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
ws.onclose = () => {
|
|
144
|
+
this._stopPing()
|
|
145
|
+
this._ws = null
|
|
146
|
+
// Reset the readiness promise so future calls reconnect
|
|
147
|
+
this._wsReady = null
|
|
148
|
+
|
|
149
|
+
// Reject all pending calls
|
|
150
|
+
const hadPendingCalls = this._pendingCalls.size > 0
|
|
151
|
+
for (const [id, pending] of this._pendingCalls) {
|
|
152
|
+
clearTimeout(pending.timer)
|
|
153
|
+
pending.reject(new RpcError(503, 'WebSocket connection closed'))
|
|
154
|
+
}
|
|
155
|
+
this._pendingCalls.clear()
|
|
156
|
+
|
|
157
|
+
if (!this._wsClosed && (this._wsCallbacks.size > 0 || hadPendingCalls)) {
|
|
158
|
+
this._scheduleReconnect()
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
private _startPing(): void {
|
|
164
|
+
this._stopPing()
|
|
165
|
+
this._wsPingTimer = setInterval(() => {
|
|
166
|
+
if (this._ws && this._ws.readyState === 1 /* OPEN */) {
|
|
167
|
+
this._ws.send(JSON.stringify({ type: 'ping' }))
|
|
168
|
+
}
|
|
169
|
+
}, 30_000)
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
private _stopPing(): void {
|
|
173
|
+
if (this._wsPingTimer) {
|
|
174
|
+
clearInterval(this._wsPingTimer)
|
|
175
|
+
this._wsPingTimer = null
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
private _scheduleReconnect(): void {
|
|
180
|
+
if (this._wsReconnectTimer) return
|
|
181
|
+
const delay = this._wsReconnectDelay
|
|
182
|
+
this._wsReconnectDelay = Math.min(this._wsReconnectDelay * 2, MAX_RECONNECT_DELAY_MS)
|
|
183
|
+
this._wsReconnectTimer = setTimeout(() => {
|
|
184
|
+
this._wsReconnectTimer = null
|
|
185
|
+
if (!this._wsClosed) {
|
|
186
|
+
this._ensureWs()
|
|
187
|
+
}
|
|
188
|
+
}, delay)
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
/** Ensure WS is connected and ready. Lazy — connects on first use. */
|
|
192
|
+
private async _ready(): Promise<void> {
|
|
193
|
+
this._ensureWs()
|
|
194
|
+
if (this._wsReady) await this._wsReady
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
// ── RPC call method ─────────────────────────────────────────────────────
|
|
198
|
+
|
|
199
|
+
/**
|
|
200
|
+
* Send an RPC call over the WebSocket connection.
|
|
201
|
+
* @param type - The operation type (e.g. 'agent.get', 'perspective.all')
|
|
202
|
+
* @param params - Optional parameters to include in the message
|
|
203
|
+
* @returns Promise that resolves with the result from the server
|
|
204
|
+
*/
|
|
205
|
+
async call<T>(type: string, params?: Record<string, unknown>): Promise<T> {
|
|
206
|
+
await this._ready()
|
|
207
|
+
|
|
208
|
+
const id = nextId()
|
|
209
|
+
// Put params under a "params" key to avoid collision with
|
|
210
|
+
// protocol fields "id" and "type" (e.g. params might contain
|
|
211
|
+
// { id: modelId } or { type: "db" }).
|
|
212
|
+
const message: Record<string, unknown> = { id, type, params: params || {} }
|
|
213
|
+
|
|
214
|
+
return new Promise<T>((resolve, reject) => {
|
|
215
|
+
const timer = setTimeout(() => {
|
|
216
|
+
this._pendingCalls.delete(id)
|
|
217
|
+
reject(new RpcError(408, `RPC call '${type}' timed out after ${DEFAULT_TIMEOUT_MS}ms`))
|
|
218
|
+
}, DEFAULT_TIMEOUT_MS)
|
|
219
|
+
|
|
220
|
+
this._pendingCalls.set(id, {
|
|
221
|
+
resolve: resolve as (value: unknown) => void,
|
|
222
|
+
reject,
|
|
223
|
+
timer,
|
|
224
|
+
})
|
|
225
|
+
|
|
226
|
+
if (this._ws && this._ws.readyState === 1 /* OPEN */) {
|
|
227
|
+
this._ws.send(JSON.stringify(message))
|
|
228
|
+
} else {
|
|
229
|
+
this._pendingCalls.delete(id)
|
|
230
|
+
clearTimeout(timer)
|
|
231
|
+
reject(new RpcError(503, 'WebSocket not connected'))
|
|
232
|
+
}
|
|
233
|
+
})
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
// ── Event subscriptions (same interface as before) ──────────────────────
|
|
237
|
+
|
|
238
|
+
subscribe<T = WsEvent>(callback: (data: T) => void): () => void {
|
|
239
|
+
this._wsCallbacks.add(callback as (data: unknown) => void)
|
|
240
|
+
this._ensureWs()
|
|
241
|
+
|
|
242
|
+
return () => {
|
|
243
|
+
this._wsCallbacks.delete(callback as (data: unknown) => void)
|
|
244
|
+
if (this._wsCallbacks.size === 0 && this._pendingCalls.size === 0) {
|
|
245
|
+
this._closeWs()
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
}
|
|
249
|
+
|
|
250
|
+
/** Wait until the WebSocket connection is established. */
|
|
251
|
+
async waitForSubscription(): Promise<void> {
|
|
252
|
+
await this._ready()
|
|
253
|
+
}
|
|
254
|
+
|
|
255
|
+
// ── Explicit connection ─────────────────────────────────────────────────
|
|
256
|
+
|
|
257
|
+
/** Explicitly connect the WebSocket (optional — connection is lazy). */
|
|
258
|
+
connect(): void {
|
|
259
|
+
this._ensureWs()
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
private _closeWs(): void {
|
|
263
|
+
this._stopPing()
|
|
264
|
+
if (this._wsReconnectTimer) {
|
|
265
|
+
clearTimeout(this._wsReconnectTimer)
|
|
266
|
+
this._wsReconnectTimer = null
|
|
267
|
+
}
|
|
268
|
+
if (this._ws) {
|
|
269
|
+
this._wsClosed = true
|
|
270
|
+
this._ws.close()
|
|
271
|
+
this._ws = null
|
|
272
|
+
this._wsReady = null
|
|
273
|
+
}
|
|
274
|
+
}
|
|
275
|
+
|
|
276
|
+
/** Close all open WebSocket connections and reject pending calls. */
|
|
277
|
+
closeAll(): void {
|
|
278
|
+
// Reject pending calls
|
|
279
|
+
for (const [id, pending] of this._pendingCalls) {
|
|
280
|
+
clearTimeout(pending.timer)
|
|
281
|
+
pending.reject(new RpcError(503, 'Client closed'))
|
|
282
|
+
}
|
|
283
|
+
this._pendingCalls.clear()
|
|
284
|
+
this._closeWs()
|
|
285
|
+
this._wsCallbacks.clear()
|
|
286
|
+
}
|
|
287
|
+
}
|
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PersistentCache — two-tier persistent key-value cache abstraction.
|
|
3
|
+
*
|
|
4
|
+
* Provides an IndexedDB-backed implementation for browsers and a no-op
|
|
5
|
+
* NullCache fallback for Node.js / environments without IndexedDB.
|
|
6
|
+
*
|
|
7
|
+
* Design goals:
|
|
8
|
+
* - Lazy open: IDB connection is deferred until first access
|
|
9
|
+
* - Fire-and-forget writes: put() resolves immediately (best-effort persistence)
|
|
10
|
+
* - Graceful degradation: all IDB errors resolve (never reject), so callers
|
|
11
|
+
* never need try/catch around cache operations
|
|
12
|
+
* - Tree-shakeable: import only what you need
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
// ── Interface ────────────────────────────────────────────────────────
|
|
16
|
+
|
|
17
|
+
export interface PersistentCache<T = unknown> {
|
|
18
|
+
get(key: string): Promise<T | undefined>;
|
|
19
|
+
put(key: string, value: T): Promise<void>;
|
|
20
|
+
delete(key: string): Promise<void>;
|
|
21
|
+
clear(): Promise<void>;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
// ── IndexedDB Implementation ─────────────────────────────────────────
|
|
25
|
+
|
|
26
|
+
export class IDBCache<T = unknown> implements PersistentCache<T> {
|
|
27
|
+
#dbName: string;
|
|
28
|
+
#storeName: string;
|
|
29
|
+
#dbPromise: Promise<IDBDatabase> | null = null;
|
|
30
|
+
#version = 1;
|
|
31
|
+
|
|
32
|
+
constructor(dbName: string, storeName: string) {
|
|
33
|
+
this.#dbName = dbName;
|
|
34
|
+
this.#storeName = storeName;
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
#open(): Promise<IDBDatabase> {
|
|
38
|
+
if (!this.#dbPromise) {
|
|
39
|
+
this.#dbPromise = new Promise<IDBDatabase>((resolve, reject) => {
|
|
40
|
+
const storeName = this.#storeName;
|
|
41
|
+
const req = indexedDB.open(this.#dbName, this.#version);
|
|
42
|
+
req.onupgradeneeded = () => {
|
|
43
|
+
const db = req.result;
|
|
44
|
+
if (!db.objectStoreNames.contains(storeName)) {
|
|
45
|
+
db.createObjectStore(storeName);
|
|
46
|
+
}
|
|
47
|
+
};
|
|
48
|
+
req.onsuccess = () => resolve(req.result);
|
|
49
|
+
req.onerror = () => reject(req.error);
|
|
50
|
+
});
|
|
51
|
+
}
|
|
52
|
+
return this.#dbPromise;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
async get(key: string): Promise<T | undefined> {
|
|
56
|
+
try {
|
|
57
|
+
const db = await this.#open();
|
|
58
|
+
return new Promise<T | undefined>((resolve) => {
|
|
59
|
+
const tx = db.transaction(this.#storeName, 'readonly');
|
|
60
|
+
const store = tx.objectStore(this.#storeName);
|
|
61
|
+
const req = store.get(key);
|
|
62
|
+
req.onsuccess = () => resolve(req.result ?? undefined);
|
|
63
|
+
req.onerror = () => resolve(undefined);
|
|
64
|
+
});
|
|
65
|
+
} catch {
|
|
66
|
+
return undefined;
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
async put(key: string, value: T): Promise<void> {
|
|
71
|
+
try {
|
|
72
|
+
const db = await this.#open();
|
|
73
|
+
return new Promise<void>((resolve) => {
|
|
74
|
+
const tx = db.transaction(this.#storeName, 'readwrite');
|
|
75
|
+
const store = tx.objectStore(this.#storeName);
|
|
76
|
+
store.put(value, key);
|
|
77
|
+
tx.oncomplete = () => resolve();
|
|
78
|
+
tx.onerror = () => resolve(); // fire-and-forget
|
|
79
|
+
});
|
|
80
|
+
} catch {
|
|
81
|
+
// degrade gracefully
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
async delete(key: string): Promise<void> {
|
|
86
|
+
try {
|
|
87
|
+
const db = await this.#open();
|
|
88
|
+
return new Promise<void>((resolve) => {
|
|
89
|
+
const tx = db.transaction(this.#storeName, 'readwrite');
|
|
90
|
+
const store = tx.objectStore(this.#storeName);
|
|
91
|
+
store.delete(key);
|
|
92
|
+
tx.oncomplete = () => resolve();
|
|
93
|
+
tx.onerror = () => resolve();
|
|
94
|
+
});
|
|
95
|
+
} catch {
|
|
96
|
+
// degrade gracefully
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
async clear(): Promise<void> {
|
|
101
|
+
try {
|
|
102
|
+
const db = await this.#open();
|
|
103
|
+
return new Promise<void>((resolve) => {
|
|
104
|
+
const tx = db.transaction(this.#storeName, 'readwrite');
|
|
105
|
+
const store = tx.objectStore(this.#storeName);
|
|
106
|
+
store.clear();
|
|
107
|
+
tx.oncomplete = () => resolve();
|
|
108
|
+
tx.onerror = () => resolve();
|
|
109
|
+
});
|
|
110
|
+
} catch {
|
|
111
|
+
// degrade gracefully
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
// ── NullCache (no-op fallback for Node.js) ───────────────────────────
|
|
117
|
+
|
|
118
|
+
export class NullCache<T = unknown> implements PersistentCache<T> {
|
|
119
|
+
async get(_key: string): Promise<T | undefined> { return undefined; }
|
|
120
|
+
async put(_key: string, _value: T): Promise<void> {}
|
|
121
|
+
async delete(_key: string): Promise<void> {}
|
|
122
|
+
async clear(): Promise<void> {}
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
// ── Factory ──────────────────────────────────────────────────────────
|
|
126
|
+
|
|
127
|
+
/**
|
|
128
|
+
* Create a PersistentCache backed by IndexedDB (browser) or NullCache (Node.js).
|
|
129
|
+
*
|
|
130
|
+
* @param dbName - IndexedDB database name
|
|
131
|
+
* @param storeName - IndexedDB object store name
|
|
132
|
+
*/
|
|
133
|
+
export function createPersistentCache<T = unknown>(
|
|
134
|
+
dbName: string,
|
|
135
|
+
storeName: string,
|
|
136
|
+
): PersistentCache<T> {
|
|
137
|
+
try {
|
|
138
|
+
if (typeof indexedDB !== 'undefined') {
|
|
139
|
+
return new IDBCache<T>(dbName, storeName);
|
|
140
|
+
}
|
|
141
|
+
} catch {
|
|
142
|
+
// indexedDB access threw (e.g. in a worker with restricted globals)
|
|
143
|
+
}
|
|
144
|
+
return new NullCache<T>();
|
|
145
|
+
}
|