@coasys/ad4m 0.13.0-test-2 → 0.13.0-test-4
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 +2805 -10556
- package/lib/index.js +2513 -10322
- package/lib/src/Ad4mClient.d.ts +7 -3
- package/lib/src/Ad4mClient.js +29 -13
- package/lib/src/agent/Agent.js +26 -272
- package/lib/src/agent/AgentClient.d.ts +10 -21
- package/lib/src/agent/AgentClient.js +75 -427
- 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 +52 -0
- package/lib/src/apiClient.js +231 -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 +3 -3
- package/lib/src/expression/ExpressionClient.js +13 -76
- package/lib/src/expression/ExpressionRef.js +2 -25
- 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 +6 -2
- package/lib/src/index.js +6 -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 -214
- 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 +81 -38
- package/lib/src/model/Ad4mModel.js +651 -408
- package/lib/src/model/Ad4mModel.test.js +488 -750
- package/lib/src/model/ModelQueryBuilder.d.ts +28 -21
- package/lib/src/model/ModelQueryBuilder.js +160 -195
- package/lib/src/model/decorators.d.ts +22 -0
- package/lib/src/model/decorators.js +7 -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 +8 -60
- package/lib/src/model/hydration.js +41 -541
- package/lib/src/model/index.d.ts +0 -4
- package/lib/src/model/index.js +0 -4
- package/lib/src/model/model-manifest.d.ts +41 -0
- package/lib/src/model/model-manifest.js +11 -0
- package/lib/src/model/query-sparql.d.ts +36 -22
- package/lib/src/model/query-sparql.js +188 -53
- 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/query-utils.js +4 -0
- package/lib/src/model/shacl-gen.js +4 -0
- 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.js +48 -2
- package/lib/src/model/types.d.ts +58 -1
- package/lib/src/model/types.js +4 -1
- 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 +12 -15
- package/lib/src/perspectives/PerspectiveClient.js +168 -400
- 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 +95 -71
- package/lib/src/perspectives/PerspectiveProxy.js +288 -310
- package/lib/src/runtime/RuntimeClient.d.ts +6 -6
- package/lib/src/runtime/RuntimeClient.js +93 -467
- package/lib/src/runtime/RuntimeTypes.d.ts +101 -0
- package/lib/src/runtime/RuntimeTypes.js +45 -0
- package/lib/src/shacl/SHACLShape.d.ts +7 -0
- package/lib/src/shacl/SHACLShape.js +19 -0
- package/lib/src/shacl/SHACLShape.test.js +82 -0
- package/lib/src/typeDefs.js +3 -628
- package/package.json +9 -24
- package/rollup.config.js +0 -7
- package/src/Ad4mClient.test.ts +1182 -1288
- package/src/Ad4mClient.ts +30 -15
- package/src/agent/Agent.ts +0 -99
- package/src/agent/AgentClient.ts +112 -526
- 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 +283 -0
- package/src/expression/Expression.ts +3 -43
- package/src/expression/ExpressionClient.ts +14 -77
- package/src/expression/ExpressionRef.ts +0 -6
- 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 +6 -2
- package/src/jestSetup.ts +1 -1
- package/src/language/Icon.ts +0 -4
- package/src/language/Language.ts +50 -292
- 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 +827 -808
- package/src/model/Ad4mModel.ts +676 -457
- package/src/model/ModelQueryBuilder.ts +199 -217
- package/src/model/decorators.ts +29 -0
- package/src/model/hydration.ts +17 -572
- package/src/model/index.ts +0 -4
- package/src/model/query-sparql.test.ts +360 -0
- package/src/model/query-sparql.ts +203 -56
- package/src/model/query-utils.ts +4 -0
- package/src/model/shacl-gen.ts +5 -0
- package/src/model/types.ts +62 -1
- 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 +227 -412
- package/src/perspectives/PerspectiveDiff.ts +0 -8
- package/src/perspectives/PerspectiveHandle.ts +1 -12
- package/src/perspectives/PerspectiveProxy.test.ts +41 -0
- package/src/perspectives/PerspectiveProxy.ts +325 -348
- package/src/runtime/RuntimeClient.ts +112 -474
- package/src/runtime/RuntimeTypes.ts +144 -0
- package/src/shacl/SHACLShape.test.ts +94 -0
- package/src/shacl/SHACLShape.ts +27 -0
- package/src/typeDefs.ts +3 -5
- 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.d.ts +0 -42
- 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/hydration-batch.ts +0 -205
- package/src/model/prolog-facts.ts +0 -145
- package/src/model/query-prolog.ts +0 -148
- package/src/model/query-sparql-batch.ts +0 -301
- package/src/model/subscription-pool.ts +0 -163
- package/src/neighbourhood/NeighbourhoodResolver.ts +0 -100
- package/src/perspectives/PerspectiveResolver.ts +0 -364
- package/src/runtime/RuntimeResolver.ts +0 -749
- package/src/unwrapApolloResult.ts +0 -16
- package/tsconfig-browser.json +0 -82
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
import { PerspectiveExpression } from "../perspectives/Perspective";
|
|
2
|
+
import { ExceptionType } from "../Exception";
|
|
3
|
+
|
|
4
|
+
export class SentMessage {
|
|
5
|
+
recipient: string;
|
|
6
|
+
message: PerspectiveExpression;
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
export class RuntimeInfo {
|
|
10
|
+
ad4mExecutorVersion: string;
|
|
11
|
+
isInitialized: Boolean;
|
|
12
|
+
isUnlocked: Boolean;
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
export class ExceptionInfo {
|
|
16
|
+
title: string;
|
|
17
|
+
message: string;
|
|
18
|
+
type: ExceptionType;
|
|
19
|
+
addon?: string;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export class NotificationInput {
|
|
23
|
+
description: string;
|
|
24
|
+
appName: string;
|
|
25
|
+
appUrl: string;
|
|
26
|
+
appIconPath: string;
|
|
27
|
+
|
|
28
|
+
// This is a query which will be executed on every perspective change.
|
|
29
|
+
// All matched unbound variables will be part of the triggerMatch, i.e.
|
|
30
|
+
// the content that will be sent to the launcher via event push
|
|
31
|
+
// and to the webhook.
|
|
32
|
+
trigger: string;
|
|
33
|
+
|
|
34
|
+
// List Perspectives this Notification is active on.
|
|
35
|
+
perspectiveIds: string[];
|
|
36
|
+
|
|
37
|
+
// URL to which the notification matches will be sent via POST
|
|
38
|
+
webhookUrl: string;
|
|
39
|
+
|
|
40
|
+
// Authentication bearer token to be sent via POST to the webhookUrl.
|
|
41
|
+
webhookAuth: string;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
export class Notification {
|
|
45
|
+
id: string;
|
|
46
|
+
granted: boolean;
|
|
47
|
+
description: string;
|
|
48
|
+
appName: string;
|
|
49
|
+
appUrl: string;
|
|
50
|
+
appIconPath: string;
|
|
51
|
+
trigger: string;
|
|
52
|
+
perspectiveIds: string[];
|
|
53
|
+
webhookUrl: string;
|
|
54
|
+
webhookAuth: string;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
export class TriggeredNotification {
|
|
58
|
+
notification: Notification;
|
|
59
|
+
perspectiveId: string;
|
|
60
|
+
triggerMatch: string;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
export class ImportStats {
|
|
64
|
+
total: number;
|
|
65
|
+
imported: number;
|
|
66
|
+
failed: number;
|
|
67
|
+
omitted: number;
|
|
68
|
+
errors: string[];
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
export class ImportResult {
|
|
72
|
+
perspectives: ImportStats;
|
|
73
|
+
links: ImportStats;
|
|
74
|
+
expressions: ImportStats;
|
|
75
|
+
perspectiveDiffs: ImportStats;
|
|
76
|
+
notifications: ImportStats;
|
|
77
|
+
models: ImportStats;
|
|
78
|
+
defaultModels: ImportStats;
|
|
79
|
+
tasks: ImportStats;
|
|
80
|
+
friends: ImportStats;
|
|
81
|
+
trustedAgents: ImportStats;
|
|
82
|
+
knownLinkLanguages: ImportStats;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
export class UserStatistics {
|
|
86
|
+
email: string;
|
|
87
|
+
did: string;
|
|
88
|
+
lastSeen?: string;
|
|
89
|
+
perspectiveCount: number;
|
|
90
|
+
remainingCredits: string;
|
|
91
|
+
freeAccess: boolean;
|
|
92
|
+
hotWalletAddress?: string;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
export class VerificationRequestResult {
|
|
96
|
+
success: boolean;
|
|
97
|
+
message: string;
|
|
98
|
+
requiresPassword: boolean;
|
|
99
|
+
isExistingUser: boolean;
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
export class HostingUserInfo {
|
|
103
|
+
email: string;
|
|
104
|
+
remainingCredits: string;
|
|
105
|
+
hotWalletAddress?: string;
|
|
106
|
+
freeAccess: boolean;
|
|
107
|
+
|
|
108
|
+
constructor(email: string, remainingCredits: string, hotWalletAddress?: string, freeAccess: boolean = false) {
|
|
109
|
+
this.email = email;
|
|
110
|
+
this.remainingCredits = remainingCredits;
|
|
111
|
+
this.hotWalletAddress = hotWalletAddress;
|
|
112
|
+
this.freeAccess = freeAccess;
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
export class PaymentRequestResult {
|
|
117
|
+
success: boolean;
|
|
118
|
+
message: string;
|
|
119
|
+
|
|
120
|
+
constructor(success: boolean, message: string) {
|
|
121
|
+
this.success = success;
|
|
122
|
+
this.message = message;
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
export class ComputeLogEntry {
|
|
127
|
+
id: number;
|
|
128
|
+
userEmail: string;
|
|
129
|
+
timestamp: string;
|
|
130
|
+
operation: string;
|
|
131
|
+
summary?: string;
|
|
132
|
+
cost: number;
|
|
133
|
+
creditsAfter: number;
|
|
134
|
+
|
|
135
|
+
constructor(id: number, userEmail: string, timestamp: string, operation: string, cost: number, creditsAfter: number, summary?: string) {
|
|
136
|
+
this.id = id;
|
|
137
|
+
this.userEmail = userEmail;
|
|
138
|
+
this.timestamp = timestamp;
|
|
139
|
+
this.operation = operation;
|
|
140
|
+
this.cost = cost;
|
|
141
|
+
this.creditsAfter = creditsAfter;
|
|
142
|
+
this.summary = summary;
|
|
143
|
+
}
|
|
144
|
+
}
|
|
@@ -397,4 +397,98 @@ describe('SHACLShape', () => {
|
|
|
397
397
|
expect(prop.remover).toEqual(original.properties[0].remover);
|
|
398
398
|
});
|
|
399
399
|
});
|
|
400
|
+
|
|
401
|
+
describe('sh:in round-trip', () => {
|
|
402
|
+
it('preserves sh:in enum values through toLinks() → fromLinks()', () => {
|
|
403
|
+
const original = new SHACLShape('test://Model');
|
|
404
|
+
original.addProperty({
|
|
405
|
+
name: 'status',
|
|
406
|
+
path: 'test://status',
|
|
407
|
+
datatype: 'xsd:string',
|
|
408
|
+
in: [
|
|
409
|
+
{ value: 'active', label: 'Active' },
|
|
410
|
+
{ value: 'inactive', label: 'Inactive' },
|
|
411
|
+
{ value: 'archived' },
|
|
412
|
+
],
|
|
413
|
+
});
|
|
414
|
+
|
|
415
|
+
const links = original.toLinks();
|
|
416
|
+
|
|
417
|
+
// Verify sh:in link was created
|
|
418
|
+
const inLink = links.find(l => l.predicate === 'sh://in');
|
|
419
|
+
expect(inLink).toBeDefined();
|
|
420
|
+
expect(inLink!.target).toContain('literal:string:');
|
|
421
|
+
|
|
422
|
+
// Reconstruct and verify
|
|
423
|
+
const reconstructed = SHACLShape.fromLinks(links, 'test://ModelShape');
|
|
424
|
+
expect(reconstructed.properties[0].in).toBeDefined();
|
|
425
|
+
expect(reconstructed.properties[0].in).toEqual([
|
|
426
|
+
{ value: 'active', label: 'Active' },
|
|
427
|
+
{ value: 'inactive', label: 'Inactive' },
|
|
428
|
+
{ value: 'archived' },
|
|
429
|
+
]);
|
|
430
|
+
});
|
|
431
|
+
|
|
432
|
+
it('handles sh:in with special characters in values', () => {
|
|
433
|
+
const original = new SHACLShape('test://Model');
|
|
434
|
+
original.addProperty({
|
|
435
|
+
name: 'category',
|
|
436
|
+
path: 'test://category',
|
|
437
|
+
in: [
|
|
438
|
+
{ value: 'food & drink', label: 'Food & Drink' },
|
|
439
|
+
{ value: 'arts/crafts' },
|
|
440
|
+
],
|
|
441
|
+
});
|
|
442
|
+
|
|
443
|
+
const links = original.toLinks();
|
|
444
|
+
const reconstructed = SHACLShape.fromLinks(links, 'test://ModelShape');
|
|
445
|
+
expect(reconstructed.properties[0].in).toEqual(original.properties[0].in);
|
|
446
|
+
});
|
|
447
|
+
|
|
448
|
+
it('handles sh:in with empty array (no link created)', () => {
|
|
449
|
+
const original = new SHACLShape('test://Model');
|
|
450
|
+
original.addProperty({
|
|
451
|
+
name: 'field',
|
|
452
|
+
path: 'test://field',
|
|
453
|
+
in: [],
|
|
454
|
+
});
|
|
455
|
+
|
|
456
|
+
const links = original.toLinks();
|
|
457
|
+
const inLink = links.find(l => l.predicate === 'sh://in');
|
|
458
|
+
expect(inLink).toBeUndefined();
|
|
459
|
+
});
|
|
460
|
+
|
|
461
|
+
it('handles sh:in with literal://string: prefix variant', () => {
|
|
462
|
+
// fromLinks should handle both `literal:string:` and `literal://string:` prefixes
|
|
463
|
+
const links = [
|
|
464
|
+
{ source: 'test://ModelShape', predicate: 'sh://targetClass', target: 'test://Model' },
|
|
465
|
+
{ source: 'test://ModelShape', predicate: 'sh://property', target: 'test://Model.status' },
|
|
466
|
+
{ source: 'test://Model.status', predicate: 'sh://path', target: 'test://status' },
|
|
467
|
+
{ source: 'test://Model.status', predicate: 'sh://in', target: 'literal://string:[{"value":"a"},{"value":"b"}]' },
|
|
468
|
+
];
|
|
469
|
+
|
|
470
|
+
const reconstructed = SHACLShape.fromLinks(links, 'test://ModelShape');
|
|
471
|
+
expect(reconstructed.properties[0].in).toEqual([
|
|
472
|
+
{ value: 'a' },
|
|
473
|
+
{ value: 'b' },
|
|
474
|
+
]);
|
|
475
|
+
});
|
|
476
|
+
|
|
477
|
+
it('preserves sh:in through toJSON() → fromJSON()', () => {
|
|
478
|
+
const original = new SHACLShape('test://Model');
|
|
479
|
+
original.addProperty({
|
|
480
|
+
name: 'priority',
|
|
481
|
+
path: 'test://priority',
|
|
482
|
+
in: [
|
|
483
|
+
{ value: 'high', label: 'High' },
|
|
484
|
+
{ value: 'medium', label: 'Medium' },
|
|
485
|
+
{ value: 'low', label: 'Low' },
|
|
486
|
+
],
|
|
487
|
+
});
|
|
488
|
+
|
|
489
|
+
const json = original.toJSON();
|
|
490
|
+
const reconstructed = SHACLShape.fromJSON(json);
|
|
491
|
+
expect(reconstructed.properties[0].in).toEqual(original.properties[0].in);
|
|
492
|
+
});
|
|
493
|
+
});
|
|
400
494
|
});
|
package/src/shacl/SHACLShape.ts
CHANGED
|
@@ -174,6 +174,11 @@ export interface SHACLPropertyShape {
|
|
|
174
174
|
* Set automatically when a relation has a `target` model. Enables typed construction
|
|
175
175
|
* on the Rust/MCP side by referencing the full target shape. */
|
|
176
176
|
class?: string;
|
|
177
|
+
|
|
178
|
+
/** sh:in — allowed values for this property (enum constraint).
|
|
179
|
+
* Each entry has a `value` (the RDF term) and an optional `label` (human-readable name).
|
|
180
|
+
* Standard SHACL `sh:in` only defines values; labels are an AD4M extension. */
|
|
181
|
+
in?: Array<{ value: string; label?: string }>;
|
|
177
182
|
}
|
|
178
183
|
|
|
179
184
|
/**
|
|
@@ -545,6 +550,14 @@ export class SHACLShape {
|
|
|
545
550
|
target: prop.class
|
|
546
551
|
});
|
|
547
552
|
}
|
|
553
|
+
|
|
554
|
+
if (prop.in && prop.in.length > 0) {
|
|
555
|
+
links.push({
|
|
556
|
+
source: propShapeId,
|
|
557
|
+
predicate: "sh://in",
|
|
558
|
+
target: `literal:string:${JSON.stringify(prop.in)}`
|
|
559
|
+
});
|
|
560
|
+
}
|
|
548
561
|
}
|
|
549
562
|
|
|
550
563
|
return links;
|
|
@@ -775,6 +788,18 @@ export class SHACLShape {
|
|
|
775
788
|
prop.class = classLink.target;
|
|
776
789
|
}
|
|
777
790
|
|
|
791
|
+
const inLink = links.find(l =>
|
|
792
|
+
l.source === propShapeId && l.predicate === "sh://in"
|
|
793
|
+
);
|
|
794
|
+
if (inLink) {
|
|
795
|
+
try {
|
|
796
|
+
const jsonStr = inLink.target.replace(/^literal:\/\/string:|^literal:string:/, '');
|
|
797
|
+
prop.in = JSON.parse(jsonStr);
|
|
798
|
+
} catch (e) {
|
|
799
|
+
// Ignore parse errors
|
|
800
|
+
}
|
|
801
|
+
}
|
|
802
|
+
|
|
778
803
|
shape.addProperty(prop);
|
|
779
804
|
}
|
|
780
805
|
|
|
@@ -812,6 +837,7 @@ export class SHACLShape {
|
|
|
812
837
|
getter: p.getter,
|
|
813
838
|
conformance_conditions: p.conformanceConditions,
|
|
814
839
|
class: p.class,
|
|
840
|
+
in: p.in,
|
|
815
841
|
})),
|
|
816
842
|
constructor_actions: this.constructor_actions,
|
|
817
843
|
destructor_actions: this.destructor_actions,
|
|
@@ -847,6 +873,7 @@ export class SHACLShape {
|
|
|
847
873
|
getter: p.getter,
|
|
848
874
|
conformanceConditions: p.conformance_conditions,
|
|
849
875
|
class: p.class,
|
|
876
|
+
in: p.in,
|
|
850
877
|
});
|
|
851
878
|
}
|
|
852
879
|
|
package/src/typeDefs.ts
CHANGED
|
@@ -1,6 +1,4 @@
|
|
|
1
|
-
//
|
|
2
|
-
//
|
|
3
|
-
// This way lib/index.js can stay the compiled version of index.ts,
|
|
4
|
-
// where index.ts imports this file...
|
|
1
|
+
// Placeholder for type definition string.
|
|
2
|
+
// Previously generated by buildSchema; kept for backward compatibility.
|
|
5
3
|
|
|
6
|
-
export const typeDefsString = ""
|
|
4
|
+
export const typeDefsString = ""
|
package/tsconfig.json
CHANGED
|
@@ -1,16 +1,12 @@
|
|
|
1
1
|
{
|
|
2
|
-
"include": ["./src/**/*.ts", "./src/*.ts"
|
|
3
|
-
"exclude": ["./src/*.test.ts", "./src
|
|
2
|
+
"include": ["./src/**/*.ts", "./src/*.ts"],
|
|
3
|
+
"exclude": ["./src/*.test.ts", "./src/**/*.test.ts"],
|
|
4
4
|
"compilerOptions": {
|
|
5
5
|
/* Visit https://aka.ms/tsconfig.json to read more about this file */
|
|
6
|
-
// "paths": {
|
|
7
|
-
// "type-graphql": ["./shims/type-graphql.ts"],
|
|
8
|
-
// "reflect-metadata": ["./shims/reflect-metadata.ts"]
|
|
9
|
-
// },
|
|
10
6
|
/* Basic Options */
|
|
11
7
|
// "incremental": true, /* Enable incremental compilation */
|
|
12
8
|
"target": "es2020", /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019', 'es2015', or 'ESNEXT'. */
|
|
13
|
-
"lib": ["es2020", "esnext.asynciterable"],
|
|
9
|
+
"lib": ["es2020", "esnext.asynciterable", "dom"],
|
|
14
10
|
"module": "es2020", /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', 'es2020', or 'ESNext'. */
|
|
15
11
|
// "lib": [], /* Specify library files to be included in the compilation. */
|
|
16
12
|
// "allowJs": true, /* Allow javascript files to be compiled. */
|
|
@@ -1,44 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* SurrealQL query building utilities for Ad4mModel.
|
|
3
|
-
*
|
|
4
|
-
* Contains the graph-traversal WHERE clause builder, legacy
|
|
5
|
-
* subquery-based clause builders, SELECT-field builders, and
|
|
6
|
-
* the main `buildSurrealQLQuery()` function that produces a
|
|
7
|
-
* complete SurrealQL query string from a `Query` object.
|
|
8
|
-
*
|
|
9
|
-
* All functions are stateless — model metadata and relation metadata
|
|
10
|
-
* are passed in as parameters instead of accessed via `this`.
|
|
11
|
-
*
|
|
12
|
-
* @module
|
|
13
|
-
*/
|
|
14
|
-
import type { RelationMetadataEntry } from "./decorators";
|
|
15
|
-
import type { Where, Query, ModelMetadata } from "./types";
|
|
16
|
-
/**
|
|
17
|
-
* Builds WHERE clause filters using SurrealDB graph traversal syntax.
|
|
18
|
-
*
|
|
19
|
-
* Translates where conditions into `->link[WHERE ...]` / `<-link[WHERE ...]`
|
|
20
|
-
* filters that SurrealDB can optimize via graph indexes.
|
|
21
|
-
*
|
|
22
|
-
* @param metadata - Model metadata from `getModelMetadata()`
|
|
23
|
-
* @param allRelationsMetadata - Full relation metadata (needed for belongs-to
|
|
24
|
-
* direction detection)
|
|
25
|
-
* @param where - User-supplied where conditions
|
|
26
|
-
* @returns Combined AND-joined condition string, or empty string
|
|
27
|
-
*/
|
|
28
|
-
export declare function buildGraphTraversalWhereClause(metadata: ModelMetadata, allRelationsMetadata: Record<string, RelationMetadataEntry>, where?: Where): string;
|
|
29
|
-
/**
|
|
30
|
-
* Builds a complete SurrealQL query from a Query object and model metadata.
|
|
31
|
-
*
|
|
32
|
-
* This is the core implementation behind `Ad4mModel.queryToSurrealQL()`.
|
|
33
|
-
* It produces a graph-traversal query that:
|
|
34
|
-
* 1. Filters nodes by required predicates (conformance check)
|
|
35
|
-
* 2. Applies user WHERE conditions
|
|
36
|
-
* 3. Fetches all outgoing links for hydration
|
|
37
|
-
*
|
|
38
|
-
* @param metadata - Model metadata from `getModelMetadata()`
|
|
39
|
-
* @param allRelationsMetadata - Full relation registry (for belongs-to detection)
|
|
40
|
-
* @param query - Query parameters
|
|
41
|
-
* @param modelClass - The model class (for `resolveParentPredicate`)
|
|
42
|
-
* @returns Complete SurrealQL query string
|
|
43
|
-
*/
|
|
44
|
-
export declare function buildSurrealQLQuery(metadata: ModelMetadata, allRelationsMetadata: Record<string, RelationMetadataEntry>, query: Query, modelClass: any): string;
|
|
@@ -1,249 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* SurrealQL query building utilities for Ad4mModel.
|
|
3
|
-
*
|
|
4
|
-
* Contains the graph-traversal WHERE clause builder, legacy
|
|
5
|
-
* subquery-based clause builders, SELECT-field builders, and
|
|
6
|
-
* the main `buildSurrealQLQuery()` function that produces a
|
|
7
|
-
* complete SurrealQL query string from a `Query` object.
|
|
8
|
-
*
|
|
9
|
-
* All functions are stateless — model metadata and relation metadata
|
|
10
|
-
* are passed in as parameters instead of accessed via `this`.
|
|
11
|
-
*
|
|
12
|
-
* @module
|
|
13
|
-
*/
|
|
14
|
-
import { escapeSurrealString } from "../utils";
|
|
15
|
-
import { formatSurrealValue } from "./surreal-utils";
|
|
16
|
-
import { resolveParentPredicate } from "./query-common";
|
|
17
|
-
// ─── Graph Traversal WHERE Clause ────────────────────────────────────────────
|
|
18
|
-
/**
|
|
19
|
-
* Builds WHERE clause filters using SurrealDB graph traversal syntax.
|
|
20
|
-
*
|
|
21
|
-
* Translates where conditions into `->link[WHERE ...]` / `<-link[WHERE ...]`
|
|
22
|
-
* filters that SurrealDB can optimize via graph indexes.
|
|
23
|
-
*
|
|
24
|
-
* @param metadata - Model metadata from `getModelMetadata()`
|
|
25
|
-
* @param allRelationsMetadata - Full relation metadata (needed for belongs-to
|
|
26
|
-
* direction detection)
|
|
27
|
-
* @param where - User-supplied where conditions
|
|
28
|
-
* @returns Combined AND-joined condition string, or empty string
|
|
29
|
-
*/
|
|
30
|
-
export function buildGraphTraversalWhereClause(metadata, allRelationsMetadata, where) {
|
|
31
|
-
if (!where)
|
|
32
|
-
return '';
|
|
33
|
-
const conditions = [];
|
|
34
|
-
for (const [propertyName, condition] of Object.entries(where)) {
|
|
35
|
-
const isSpecial = ['id', 'author', 'timestamp'].includes(propertyName);
|
|
36
|
-
if (isSpecial) {
|
|
37
|
-
if (propertyName === 'author' || propertyName === 'timestamp') {
|
|
38
|
-
continue; // Filtered post-query in JS
|
|
39
|
-
}
|
|
40
|
-
const columnName = 'uri';
|
|
41
|
-
if (Array.isArray(condition)) {
|
|
42
|
-
const formattedValues = condition.map(v => formatSurrealValue(v)).join(', ');
|
|
43
|
-
conditions.push(`${columnName} IN [${formattedValues}]`);
|
|
44
|
-
}
|
|
45
|
-
else if (typeof condition === 'object' && condition !== null) {
|
|
46
|
-
const ops = condition;
|
|
47
|
-
if (ops.not !== undefined) {
|
|
48
|
-
if (Array.isArray(ops.not)) {
|
|
49
|
-
const formattedValues = ops.not.map(v => formatSurrealValue(v)).join(', ');
|
|
50
|
-
conditions.push(`${columnName} NOT IN [${formattedValues}]`);
|
|
51
|
-
}
|
|
52
|
-
else {
|
|
53
|
-
conditions.push(`${columnName} != ${formatSurrealValue(ops.not)}`);
|
|
54
|
-
}
|
|
55
|
-
}
|
|
56
|
-
if (ops.between !== undefined && Array.isArray(ops.between) && ops.between.length === 2) {
|
|
57
|
-
conditions.push(`${columnName} >= ${formatSurrealValue(ops.between[0])} AND ${columnName} <= ${formatSurrealValue(ops.between[1])}`);
|
|
58
|
-
}
|
|
59
|
-
if (ops.gt !== undefined) {
|
|
60
|
-
conditions.push(`${columnName} > ${formatSurrealValue(ops.gt)}`);
|
|
61
|
-
}
|
|
62
|
-
if (ops.gte !== undefined) {
|
|
63
|
-
conditions.push(`${columnName} >= ${formatSurrealValue(ops.gte)}`);
|
|
64
|
-
}
|
|
65
|
-
if (ops.lt !== undefined) {
|
|
66
|
-
conditions.push(`${columnName} < ${formatSurrealValue(ops.lt)}`);
|
|
67
|
-
}
|
|
68
|
-
if (ops.lte !== undefined) {
|
|
69
|
-
conditions.push(`${columnName} <= ${formatSurrealValue(ops.lte)}`);
|
|
70
|
-
}
|
|
71
|
-
if (ops.contains !== undefined) {
|
|
72
|
-
conditions.push(`${columnName} CONTAINS ${formatSurrealValue(ops.contains)}`);
|
|
73
|
-
}
|
|
74
|
-
}
|
|
75
|
-
else {
|
|
76
|
-
conditions.push(`${columnName} = ${formatSurrealValue(condition)}`);
|
|
77
|
-
}
|
|
78
|
-
}
|
|
79
|
-
else {
|
|
80
|
-
// Regular properties — check relation metadata first for direction
|
|
81
|
-
const relMeta = allRelationsMetadata[propertyName];
|
|
82
|
-
const isBelongs = relMeta?.kind === 'belongsToOne' || relMeta?.kind === 'belongsToMany';
|
|
83
|
-
if (relMeta) {
|
|
84
|
-
const predicate = escapeSurrealString(relMeta.predicate);
|
|
85
|
-
if (Array.isArray(condition)) {
|
|
86
|
-
const formattedValues = condition.map(v => formatSurrealValue(v)).join(', ');
|
|
87
|
-
if (isBelongs) {
|
|
88
|
-
conditions.push(`count(<-link[WHERE predicate = '${predicate}' AND in.uri IN [${formattedValues}]]) > 0`);
|
|
89
|
-
}
|
|
90
|
-
else {
|
|
91
|
-
conditions.push(`count(->link[WHERE predicate = '${predicate}' AND out.uri IN [${formattedValues}]]) > 0`);
|
|
92
|
-
}
|
|
93
|
-
}
|
|
94
|
-
else if (typeof condition === 'object' && condition !== null) {
|
|
95
|
-
const ops = condition;
|
|
96
|
-
if (ops.not !== undefined) {
|
|
97
|
-
if (Array.isArray(ops.not)) {
|
|
98
|
-
const formattedValues = ops.not.map(v => formatSurrealValue(v)).join(', ');
|
|
99
|
-
if (isBelongs) {
|
|
100
|
-
conditions.push(`count(<-link[WHERE predicate = '${predicate}' AND in.uri IN [${formattedValues}]]) = 0`);
|
|
101
|
-
}
|
|
102
|
-
else {
|
|
103
|
-
conditions.push(`count(->link[WHERE predicate = '${predicate}' AND out.uri IN [${formattedValues}]]) = 0`);
|
|
104
|
-
}
|
|
105
|
-
}
|
|
106
|
-
else {
|
|
107
|
-
if (isBelongs) {
|
|
108
|
-
conditions.push(`count(<-link[WHERE predicate = '${predicate}' AND in.uri = ${formatSurrealValue(ops.not)}]) = 0`);
|
|
109
|
-
}
|
|
110
|
-
else {
|
|
111
|
-
conditions.push(`count(->link[WHERE predicate = '${predicate}' AND out.uri = ${formatSurrealValue(ops.not)}]) = 0`);
|
|
112
|
-
}
|
|
113
|
-
}
|
|
114
|
-
}
|
|
115
|
-
}
|
|
116
|
-
else {
|
|
117
|
-
if (isBelongs) {
|
|
118
|
-
conditions.push(`count(<-link[WHERE predicate = '${predicate}' AND in.uri = ${formatSurrealValue(condition)}]) > 0`);
|
|
119
|
-
}
|
|
120
|
-
else {
|
|
121
|
-
conditions.push(`count(->link[WHERE predicate = '${predicate}' AND out.uri = ${formatSurrealValue(condition)}]) > 0`);
|
|
122
|
-
}
|
|
123
|
-
}
|
|
124
|
-
continue;
|
|
125
|
-
}
|
|
126
|
-
const propMeta = metadata.properties[propertyName];
|
|
127
|
-
if (!propMeta)
|
|
128
|
-
continue;
|
|
129
|
-
const predicate = escapeSurrealString(propMeta.predicate);
|
|
130
|
-
const targetField = propMeta.resolveLanguage === 'literal' ? 'fn::parse_literal(out.uri)' : 'out.uri';
|
|
131
|
-
if (Array.isArray(condition)) {
|
|
132
|
-
const formattedValues = condition.map(v => formatSurrealValue(v)).join(', ');
|
|
133
|
-
conditions.push(`count(->link[WHERE predicate = '${predicate}' AND ${targetField} IN [${formattedValues}]]) > 0`);
|
|
134
|
-
}
|
|
135
|
-
else if (typeof condition === 'object' && condition !== null) {
|
|
136
|
-
const ops = condition;
|
|
137
|
-
if (ops.not !== undefined) {
|
|
138
|
-
if (Array.isArray(ops.not)) {
|
|
139
|
-
const formattedValues = ops.not.map(v => formatSurrealValue(v)).join(', ');
|
|
140
|
-
conditions.push(`count(->link[WHERE predicate = '${predicate}' AND ${targetField} IN [${formattedValues}]]) = 0`);
|
|
141
|
-
}
|
|
142
|
-
else {
|
|
143
|
-
conditions.push(`count(->link[WHERE predicate = '${predicate}' AND ${targetField} = ${formatSurrealValue(ops.not)}]) = 0`);
|
|
144
|
-
}
|
|
145
|
-
}
|
|
146
|
-
const hasComparisonOps = ops.gt !== undefined || ops.gte !== undefined ||
|
|
147
|
-
ops.lt !== undefined || ops.lte !== undefined ||
|
|
148
|
-
ops.between !== undefined || ops.contains !== undefined;
|
|
149
|
-
if (hasComparisonOps) {
|
|
150
|
-
conditions.push(`count(->link[WHERE predicate = '${predicate}']) > 0`);
|
|
151
|
-
}
|
|
152
|
-
}
|
|
153
|
-
else {
|
|
154
|
-
conditions.push(`count(->link[WHERE predicate = '${predicate}' AND ${targetField} = ${formatSurrealValue(condition)}]) > 0`);
|
|
155
|
-
}
|
|
156
|
-
}
|
|
157
|
-
}
|
|
158
|
-
return conditions.join(' AND ');
|
|
159
|
-
}
|
|
160
|
-
// ─── Main Query Builder ─────────────────────────────────────────────────────
|
|
161
|
-
/**
|
|
162
|
-
* Builds a complete SurrealQL query from a Query object and model metadata.
|
|
163
|
-
*
|
|
164
|
-
* This is the core implementation behind `Ad4mModel.queryToSurrealQL()`.
|
|
165
|
-
* It produces a graph-traversal query that:
|
|
166
|
-
* 1. Filters nodes by required predicates (conformance check)
|
|
167
|
-
* 2. Applies user WHERE conditions
|
|
168
|
-
* 3. Fetches all outgoing links for hydration
|
|
169
|
-
*
|
|
170
|
-
* @param metadata - Model metadata from `getModelMetadata()`
|
|
171
|
-
* @param allRelationsMetadata - Full relation registry (for belongs-to detection)
|
|
172
|
-
* @param query - Query parameters
|
|
173
|
-
* @param modelClass - The model class (for `resolveParentPredicate`)
|
|
174
|
-
* @returns Complete SurrealQL query string
|
|
175
|
-
*/
|
|
176
|
-
export function buildSurrealQLQuery(metadata, allRelationsMetadata, query, modelClass) {
|
|
177
|
-
const { where } = query;
|
|
178
|
-
// Build graph traversal filters for required predicates
|
|
179
|
-
const graphTraversalFilters = [];
|
|
180
|
-
// Parent filter
|
|
181
|
-
if (query.parent) {
|
|
182
|
-
const parentPredicate = resolveParentPredicate(query.parent, modelClass);
|
|
183
|
-
graphTraversalFilters.push(`count(<-link[WHERE in.uri = ${formatSurrealValue(query.parent.id)} AND predicate = '${escapeSurrealString(parentPredicate)}']) > 0`);
|
|
184
|
-
}
|
|
185
|
-
// Required property filters
|
|
186
|
-
for (const [, propMeta] of Object.entries(metadata.properties)) {
|
|
187
|
-
if (propMeta.required) {
|
|
188
|
-
if (propMeta.getter)
|
|
189
|
-
continue;
|
|
190
|
-
if (propMeta.flag && propMeta.initial) {
|
|
191
|
-
graphTraversalFilters.push(`count(->link[WHERE predicate = '${escapeSurrealString(propMeta.predicate)}' AND out.uri = '${escapeSurrealString(propMeta.initial)}']) > 0`);
|
|
192
|
-
}
|
|
193
|
-
else {
|
|
194
|
-
graphTraversalFilters.push(`count(->link[WHERE predicate = '${escapeSurrealString(propMeta.predicate)}']) > 0`);
|
|
195
|
-
}
|
|
196
|
-
}
|
|
197
|
-
}
|
|
198
|
-
// Fallback: initial-value filters
|
|
199
|
-
if (graphTraversalFilters.length === 0) {
|
|
200
|
-
for (const [, propMeta] of Object.entries(metadata.properties)) {
|
|
201
|
-
if (propMeta.initial) {
|
|
202
|
-
if (propMeta.flag) {
|
|
203
|
-
graphTraversalFilters.push(`count(->link[WHERE predicate = '${escapeSurrealString(propMeta.predicate)}' AND out.uri = '${escapeSurrealString(propMeta.initial)}']) > 0`);
|
|
204
|
-
}
|
|
205
|
-
else {
|
|
206
|
-
graphTraversalFilters.push(`count(->link[WHERE predicate = '${escapeSurrealString(propMeta.predicate)}']) > 0`);
|
|
207
|
-
}
|
|
208
|
-
break;
|
|
209
|
-
}
|
|
210
|
-
}
|
|
211
|
-
}
|
|
212
|
-
// Fallback: open-world structural matching
|
|
213
|
-
if (graphTraversalFilters.length === 0) {
|
|
214
|
-
const structuralPredicates = [];
|
|
215
|
-
for (const [, propMeta] of Object.entries(metadata.properties)) {
|
|
216
|
-
if (propMeta.predicate) {
|
|
217
|
-
structuralPredicates.push(`predicate = '${escapeSurrealString(propMeta.predicate)}'`);
|
|
218
|
-
}
|
|
219
|
-
}
|
|
220
|
-
if (metadata.relations) {
|
|
221
|
-
for (const [, relMeta] of Object.entries(metadata.relations)) {
|
|
222
|
-
if (relMeta.predicate) {
|
|
223
|
-
structuralPredicates.push(`predicate = '${escapeSurrealString(relMeta.predicate)}'`);
|
|
224
|
-
}
|
|
225
|
-
}
|
|
226
|
-
}
|
|
227
|
-
if (structuralPredicates.length > 0) {
|
|
228
|
-
graphTraversalFilters.push(`count(->link[WHERE (${structuralPredicates.join(' OR ')})]) > 0`);
|
|
229
|
-
}
|
|
230
|
-
}
|
|
231
|
-
// User WHERE clause
|
|
232
|
-
const userWhereClause = buildGraphTraversalWhereClause(metadata, allRelationsMetadata, where);
|
|
233
|
-
const whereConditions = [];
|
|
234
|
-
whereConditions.push(...graphTraversalFilters);
|
|
235
|
-
if (userWhereClause) {
|
|
236
|
-
whereConditions.push(userWhereClause);
|
|
237
|
-
}
|
|
238
|
-
whereConditions.push(`count(->link) > 0`);
|
|
239
|
-
const fullQuery = `
|
|
240
|
-
SELECT
|
|
241
|
-
id AS source,
|
|
242
|
-
uri AS source_uri,
|
|
243
|
-
->link AS links
|
|
244
|
-
FROM node
|
|
245
|
-
WHERE ${whereConditions.join(' AND ')}
|
|
246
|
-
FETCH links
|
|
247
|
-
`.trim();
|
|
248
|
-
return fullQuery;
|
|
249
|
-
}
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Shared SurrealQL compilation utilities.
|
|
3
|
-
*
|
|
4
|
-
* These functions are used by both the runtime query builder (`Ad4mModel`) and
|
|
5
|
-
* the compile-time SHACL generator (`decorators.ts`).
|
|
6
|
-
*/
|
|
7
|
-
import type { WhereCondition, Where, ModelMetadata } from "./types";
|
|
8
|
-
/**
|
|
9
|
-
* Format a JavaScript value for embedding in a SurrealQL expression.
|
|
10
|
-
*
|
|
11
|
-
* - Strings are single-quoted with backslash / quote / newline escaping
|
|
12
|
-
* - Numbers and booleans are passed through as-is
|
|
13
|
-
* - Arrays are recursed
|
|
14
|
-
*/
|
|
15
|
-
export declare function formatSurrealValue(value: any): string;
|
|
16
|
-
/**
|
|
17
|
-
* Compile a single Where condition for a property into a SurrealQL
|
|
18
|
-
* graph-traversal sub-expression.
|
|
19
|
-
*
|
|
20
|
-
* Operates on the **target node** — generates `count(->link[WHERE ...]) > 0`
|
|
21
|
-
* style checks that can be used inside a `[WHERE ...]` filter on nodes.
|
|
22
|
-
*
|
|
23
|
-
* @param predicate - The predicate URI for the property
|
|
24
|
-
* @param condition - The Where condition value
|
|
25
|
-
* @param opts - Optional settings (e.g. `resolveLanguage`)
|
|
26
|
-
* @returns A single SurrealQL condition string
|
|
27
|
-
*/
|
|
28
|
-
export declare function buildWhereCondition(predicate: string, condition: WhereCondition, opts?: {
|
|
29
|
-
resolveLanguage?: string;
|
|
30
|
-
}): string;
|
|
31
|
-
/**
|
|
32
|
-
* Compile a full `Where` clause to an array of SurrealQL condition strings.
|
|
33
|
-
*
|
|
34
|
-
* When `metadata` is provided, property names are resolved to predicates
|
|
35
|
-
* using the model's property metadata. When `metadata` is `null`, property
|
|
36
|
-
* names are treated as raw predicate URIs.
|
|
37
|
-
*
|
|
38
|
-
* Only handles **regular properties** — special fields (`id`, `author`,
|
|
39
|
-
* `timestamp`) and relation fields are skipped (they are only relevant at
|
|
40
|
-
* runtime query time, not for compile-time getter generation).
|
|
41
|
-
*/
|
|
42
|
-
export declare function compileWhereClause(where: Where, metadata: ModelMetadata | null): string[];
|