@coasys/ad4m 0.13.0-test-3 → 0.13.0-test-5
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 +6717 -15519
- package/lib/index.js +4811 -13662
- package/lib/src/Ad4mClient.d.ts +7 -3
- package/lib/src/Ad4mClient.js +39 -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 -1
- package/lib/src/index.js +6 -1
- 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 +1 -1
- package/lib/src/language/Language.js +10 -76
- 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 +76 -44
- package/lib/src/model/Ad4mModel.js +635 -479
- package/lib/src/model/Ad4mModel.test.js +371 -815
- package/lib/src/model/ModelQueryBuilder.d.ts +15 -27
- package/lib/src/model/ModelQueryBuilder.js +163 -224
- package/lib/src/model/decorators.d.ts +22 -0
- package/lib/src/model/decorators.js +7 -0
- package/lib/src/model/hydration.d.ts +3 -93
- package/lib/src/model/hydration.js +3 -970
- 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 +4 -67
- package/lib/src/model/query-sparql.js +26 -322
- package/lib/src/model/query-sparql.test.js +35 -218
- package/lib/src/model/query-utils.d.ts +1 -0
- package/lib/src/model/query-utils.js +46 -1
- package/lib/src/model/shacl-gen.js +4 -0
- package/lib/src/model/types.d.ts +51 -43
- 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 +13 -17
- package/lib/src/perspectives/PerspectiveClient.js +179 -429
- package/lib/src/perspectives/PerspectiveClient.test.js +55 -0
- package/lib/src/perspectives/PerspectiveDiff.js +4 -31
- package/lib/src/perspectives/PerspectiveHandle.js +3 -43
- package/lib/src/perspectives/PerspectiveProxy.d.ts +106 -71
- package/lib/src/perspectives/PerspectiveProxy.js +289 -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 +6 -18
- package/rollup.config.js +0 -7
- package/src/Ad4mClient.test.ts +1179 -1340
- package/src/Ad4mClient.ts +40 -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 -1
- package/src/jestSetup.ts +1 -1
- package/src/language/Icon.ts +0 -4
- package/src/language/Language.ts +2 -23
- 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 +766 -1173
- package/src/model/Ad4mModel.ts +664 -529
- package/src/model/ModelQueryBuilder.ts +203 -251
- package/src/model/decorators.ts +29 -0
- package/src/model/hydration.ts +3 -1037
- package/src/model/index.ts +0 -4
- package/src/model/query-sparql.test.ts +34 -242
- package/src/model/query-sparql.ts +27 -337
- package/src/model/query-utils.ts +47 -2
- package/src/model/shacl-gen.ts +5 -0
- package/src/model/types.ts +55 -44
- 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 +206 -148
- package/src/perspectives/PerspectiveClient.ts +247 -442
- 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 +331 -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/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/LanguageResolver.ts +0 -98
- package/src/model/Subject.ts +0 -159
- package/src/model/hydration-batch.ts +0 -205
- package/src/model/hydration-batching.test.ts +0 -563
- 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-delta.test.ts +0 -207
- package/src/model/subscription-pool.ts +0 -211
- 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/lib/src/model/index.d.ts
CHANGED
|
@@ -8,10 +8,7 @@
|
|
|
8
8
|
export * from "./types";
|
|
9
9
|
export * from "./Ad4mModel";
|
|
10
10
|
export * from "./decorators";
|
|
11
|
-
export * from "./Subject";
|
|
12
11
|
export * from "./query-common";
|
|
13
|
-
export * from "./query-prolog";
|
|
14
|
-
export * from "./prolog-facts";
|
|
15
12
|
export * from "./json-schema";
|
|
16
13
|
export * from "./query-utils";
|
|
17
14
|
export * from "./query-sparql";
|
|
@@ -20,4 +17,3 @@ export * from "./ModelQueryBuilder";
|
|
|
20
17
|
export * from "./sdna";
|
|
21
18
|
export * from "./shacl-gen";
|
|
22
19
|
export * from "./query-cache";
|
|
23
|
-
export * from "./subscription-pool";
|
package/lib/src/model/index.js
CHANGED
|
@@ -8,10 +8,7 @@
|
|
|
8
8
|
export * from "./types";
|
|
9
9
|
export * from "./Ad4mModel";
|
|
10
10
|
export * from "./decorators";
|
|
11
|
-
export * from "./Subject";
|
|
12
11
|
export * from "./query-common";
|
|
13
|
-
export * from "./query-prolog";
|
|
14
|
-
export * from "./prolog-facts";
|
|
15
12
|
export * from "./json-schema";
|
|
16
13
|
export * from "./query-utils";
|
|
17
14
|
export * from "./query-sparql";
|
|
@@ -20,4 +17,3 @@ export * from "./ModelQueryBuilder";
|
|
|
20
17
|
export * from "./sdna";
|
|
21
18
|
export * from "./shacl-gen";
|
|
22
19
|
export * from "./query-cache";
|
|
23
|
-
export * from "./subscription-pool";
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Types for the perspective model manifest — a human-readable, AI-friendly summary
|
|
3
|
+
* of all Ad4mModel-compatible classes defined in a perspective's SHACL shapes.
|
|
4
|
+
*
|
|
5
|
+
* Used by `PerspectiveProxy.getModelManifest()` and consumed by WE's AI context
|
|
6
|
+
* injection (`formatManifestForPrompt`) to describe external perspective models
|
|
7
|
+
* to the schema-generation AI.
|
|
8
|
+
*
|
|
9
|
+
* @module
|
|
10
|
+
*/
|
|
11
|
+
/** Normalised description of a single property on a model class. */
|
|
12
|
+
export interface ModelManifestProperty {
|
|
13
|
+
/** Property name as declared in the SHACL shape (e.g. "name", "body", "participants"). */
|
|
14
|
+
name: string;
|
|
15
|
+
/** The exact RDF predicate URI (e.g. "flux://has_name"). */
|
|
16
|
+
predicate: string;
|
|
17
|
+
/** Normalised scalar type; inferred from xsd:/sh: datatype + nodeKind. */
|
|
18
|
+
type: 'string' | 'number' | 'boolean' | 'uri';
|
|
19
|
+
/** `true` when maxCount is absent or > 1 (i.e. returned as an array). */
|
|
20
|
+
isCollection: boolean;
|
|
21
|
+
/** `true` when minCount >= 1. */
|
|
22
|
+
required: boolean;
|
|
23
|
+
writable: boolean;
|
|
24
|
+
/** AD4M language used to resolve the value (e.g. "literal"). */
|
|
25
|
+
resolveLanguage?: string;
|
|
26
|
+
/**
|
|
27
|
+
* Local name of the related model class when this is a typed relation property.
|
|
28
|
+
* Derived from `SHACLPropertyShape.class` by stripping the URI prefix.
|
|
29
|
+
* E.g. `flux://Message` → `"Message"`.
|
|
30
|
+
*/
|
|
31
|
+
relatedModel?: string;
|
|
32
|
+
}
|
|
33
|
+
/** Normalised description of a single model class stored in a perspective. */
|
|
34
|
+
export interface ModelManifestEntry {
|
|
35
|
+
/** Class name — usable directly as the `model` field in a `$query` token. */
|
|
36
|
+
name: string;
|
|
37
|
+
/** The SHACL `targetClass` URI (e.g. "flux://Channel"). */
|
|
38
|
+
targetClass: string;
|
|
39
|
+
/** All data properties (flag/hasValue properties are excluded). */
|
|
40
|
+
properties: ModelManifestProperty[];
|
|
41
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Types for the perspective model manifest — a human-readable, AI-friendly summary
|
|
3
|
+
* of all Ad4mModel-compatible classes defined in a perspective's SHACL shapes.
|
|
4
|
+
*
|
|
5
|
+
* Used by `PerspectiveProxy.getModelManifest()` and consumed by WE's AI context
|
|
6
|
+
* injection (`formatManifestForPrompt`) to describe external perspective models
|
|
7
|
+
* to the schema-generation AI.
|
|
8
|
+
*
|
|
9
|
+
* @module
|
|
10
|
+
*/
|
|
11
|
+
export {};
|
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* SPARQL query building utilities for Ad4mModel.
|
|
3
3
|
*
|
|
4
|
-
* Uses the
|
|
5
|
-
*
|
|
4
|
+
* Uses the RDF 1.2 reifier storage model where each AD4M link is stored as:
|
|
5
|
+
* 1. Direct triple: <source> <predicate> <target> . (default graph)
|
|
6
|
+
* 2. Reifier: <link:HASH> <http://www.w3.org/1999/02/22-rdf-syntax-ns#reifies> <<( source predicate target )>> .
|
|
7
|
+
* 3. Metadata: <link:HASH> ad4m://ontology/* "value" . (default graph)
|
|
6
8
|
*
|
|
7
9
|
* All AD4M URIs (source, predicate, target) become RDF IRIs.
|
|
8
10
|
*
|
|
@@ -57,68 +59,3 @@ export declare function buildSPARQLOrderLimitOffset(_metadata: ModelMetadata, qu
|
|
|
57
59
|
* @internal — used by buildSPARQLQuery when SPARQL-level pagination is safe.
|
|
58
60
|
*/
|
|
59
61
|
export declare function buildPaginationSubquery(joinPatterns: string[], filterExpressions: string[], metadata: ModelMetadata, query: Query): string;
|
|
60
|
-
/**
|
|
61
|
-
* Build a SPARQL COUNT query that returns the total number of matching
|
|
62
|
-
* instances WITHOUT hydrating them. Uses the same WHERE clause as
|
|
63
|
-
* buildSPARQLQuery but wraps it in SELECT (COUNT(DISTINCT ?source) AS ?count).
|
|
64
|
-
*
|
|
65
|
-
* LIMIT/OFFSET from the query are stripped internally — this always counts
|
|
66
|
-
* the full result set.
|
|
67
|
-
*/
|
|
68
|
-
export declare function buildSPARQLCountQuery(metadata: ModelMetadata, allRelationsMetadata: Record<string, RelationMetadataEntry>, query: Query, modelClass: any): string;
|
|
69
|
-
/**
|
|
70
|
-
* Build a SPARQL query to fetch all links for a single instance.
|
|
71
|
-
*/
|
|
72
|
-
export declare function buildSPARQLGetDataQuery(baseExpression: string): string;
|
|
73
|
-
/**
|
|
74
|
-
* Group flat SPARQL link rows into the same shape that SPARQL returned:
|
|
75
|
-
* `{ source_uri: string, links: Array<{predicate, target, author, timestamp}> }`
|
|
76
|
-
*/
|
|
77
|
-
export declare function groupSPARQLResults(rows: Array<{
|
|
78
|
-
source: string;
|
|
79
|
-
predicate: string;
|
|
80
|
-
target: string;
|
|
81
|
-
author: string;
|
|
82
|
-
timestamp: string;
|
|
83
|
-
}>): Array<{
|
|
84
|
-
source_uri: string;
|
|
85
|
-
links: Array<{
|
|
86
|
-
predicate: string;
|
|
87
|
-
target: string;
|
|
88
|
-
author: string;
|
|
89
|
-
timestamp: string;
|
|
90
|
-
}>;
|
|
91
|
-
}>;
|
|
92
|
-
/**
|
|
93
|
-
* Parse a SPARQL COUNT result row into a number.
|
|
94
|
-
* Handles `row.count?.value` (RDF binding), `row.count` (direct number/string),
|
|
95
|
-
* NaN results, and empty/malformed results.
|
|
96
|
-
*
|
|
97
|
-
* @returns The parsed count, or `null` if the result cannot be interpreted.
|
|
98
|
-
*/
|
|
99
|
-
export declare function parseSparqlCount(result: any[]): number | null;
|
|
100
|
-
/**
|
|
101
|
-
* Build a SPARQL query that counts child instances grouped by parent IRI.
|
|
102
|
-
*
|
|
103
|
-
* Used by the projection Path A (`count: true`) in `hydrateRelations` to get
|
|
104
|
-
* per-parent counts in a single round-trip with zero instance hydration.
|
|
105
|
-
*
|
|
106
|
-
* Includes the full named graph block so that `?author` and `?timestamp` are
|
|
107
|
-
* bound and available for SPARQL FILTER expressions (unlike the intentionally
|
|
108
|
-
* minimal `buildSPARQLCountQuery` which omits them for speed).
|
|
109
|
-
*
|
|
110
|
-
* @param metadata - Model metadata for the **child** (target) class
|
|
111
|
-
* @param allRelationsMetadata - Relations metadata for the child class
|
|
112
|
-
* @param relationPredicate - The predicate linking `?parent` → `?source` (child)
|
|
113
|
-
* @param parentIds - IRI strings of all parent instances to count for
|
|
114
|
-
* @param where - Optional filter applied to child instances
|
|
115
|
-
*/
|
|
116
|
-
export declare function buildSPARQLGroupedCountQuery(metadata: ModelMetadata, allRelationsMetadata: Record<string, RelationMetadataEntry>, relationPredicate: string, parentIds: string[], where?: import('./types').Where): string;
|
|
117
|
-
/**
|
|
118
|
-
* Parse the result of `buildSPARQLGroupedCountQuery` into a map from parent IRI
|
|
119
|
-
* to count. Missing parents (zero matches) are absent from the map — callers
|
|
120
|
-
* should use `map.get(id) ?? 0`.
|
|
121
|
-
*
|
|
122
|
-
* @returns Map from parentId string → count number
|
|
123
|
-
*/
|
|
124
|
-
export declare function parseSparqlGroupedCount(result: any[]): Map<string, number>;
|
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* SPARQL query building utilities for Ad4mModel.
|
|
3
3
|
*
|
|
4
|
-
* Uses the
|
|
5
|
-
*
|
|
4
|
+
* Uses the RDF 1.2 reifier storage model where each AD4M link is stored as:
|
|
5
|
+
* 1. Direct triple: <source> <predicate> <target> . (default graph)
|
|
6
|
+
* 2. Reifier: <link:HASH> <http://www.w3.org/1999/02/22-rdf-syntax-ns#reifies> <<( source predicate target )>> .
|
|
7
|
+
* 3. Metadata: <link:HASH> ad4m://ontology/* "value" . (default graph)
|
|
6
8
|
*
|
|
7
9
|
* All AD4M URIs (source, predicate, target) become RDF IRIs.
|
|
8
10
|
*
|
|
@@ -29,12 +31,7 @@ export function hasJsOnlyWhereFilters(metadata, allRelationsMetadata, where) {
|
|
|
29
31
|
for (const [propertyName, condition] of Object.entries(where)) {
|
|
30
32
|
if (propertyName === "base" || propertyName === "id")
|
|
31
33
|
continue;
|
|
32
|
-
// author/timestamp
|
|
33
|
-
// path (which uses buildSPARQLQuery — which DOES bind ?author/?timestamp via the
|
|
34
|
-
// named graph block). buildSPARQLCountQuery intentionally omits the named graph,
|
|
35
|
-
// so emitting an ?author FILTER there would produce unbound-variable SPARQL.
|
|
36
|
-
// buildSPARQLWhereFilters still pushes these into FILTER when called from
|
|
37
|
-
// buildSPARQLQuery / buildSPARQLGroupedCountQuery, which both include the named graph.
|
|
34
|
+
// author/timestamp filters are handled in JS
|
|
38
35
|
if (propertyName === "author" || propertyName === "timestamp")
|
|
39
36
|
return true;
|
|
40
37
|
const propMeta = metadata.properties[propertyName];
|
|
@@ -232,7 +229,7 @@ export function buildSPARQLQuery(metadata, allRelationsMetadata, query, modelCla
|
|
|
232
229
|
joinPatterns.push(...userJoins);
|
|
233
230
|
filterExpressions.push(...userFilters);
|
|
234
231
|
// Main triple pattern — fetches all links for matched sources
|
|
235
|
-
//
|
|
232
|
+
// Direct triple in default graph + RDF 1.2 reifier for link metadata
|
|
236
233
|
// FILTER(isIRI(?source)) excludes non-IRI subjects
|
|
237
234
|
const joinClause = joinPatterns.join("\n");
|
|
238
235
|
const filterClause = filterExpressions.length > 0
|
|
@@ -241,13 +238,8 @@ export function buildSPARQLQuery(metadata, allRelationsMetadata, query, modelCla
|
|
|
241
238
|
// Determine if SPARQL-level pagination is safe.
|
|
242
239
|
// When JS-only where filters exist, we must NOT limit at the SPARQL level
|
|
243
240
|
// because the database would cap candidates before JS filters run.
|
|
244
|
-
// Without an explicit ORDER BY, SPARQL OFFSET/LIMIT produces non-deterministic
|
|
245
|
-
// ordering across different query plans and index traversals. Fall back to
|
|
246
|
-
// JS-level slicing in that case to preserve the grouping order from the full
|
|
247
|
-
// result set.
|
|
248
241
|
const canPaginateInSPARQL = !hasJsOnlyWhereFilters(metadata, allRelationsMetadata, query.where)
|
|
249
|
-
&& (query.limit !== undefined || query.offset !== undefined)
|
|
250
|
-
&& query.order !== undefined && Object.keys(query.order).length > 0;
|
|
242
|
+
&& (query.limit !== undefined || query.offset !== undefined);
|
|
251
243
|
// Build a pagination subquery that constrains ?source to only the page
|
|
252
244
|
// of interest. This avoids fetching all links for all matching instances.
|
|
253
245
|
const paginationSubquery = canPaginateInSPARQL
|
|
@@ -257,22 +249,26 @@ export function buildSPARQLQuery(metadata, allRelationsMetadata, query, modelCla
|
|
|
257
249
|
// Use the pagination subquery to constrain ?source, then fetch all links
|
|
258
250
|
// for those sources only.
|
|
259
251
|
return `
|
|
252
|
+
|
|
260
253
|
SELECT ?source ?predicate ?target ?author ?timestamp WHERE {
|
|
261
254
|
${paginationSubquery}${joinClause}
|
|
262
|
-
|
|
255
|
+
?source ?predicate ?target .
|
|
256
|
+
?_reifier <http://www.w3.org/1999/02/22-rdf-syntax-ns#reifies> <<( ?source ?predicate ?target )>> .
|
|
263
257
|
FILTER(isIRI(?source) && isIRI(?predicate))
|
|
264
|
-
?
|
|
265
|
-
?
|
|
258
|
+
?_reifier <ad4m://ontology/author> ?author .
|
|
259
|
+
?_reifier <ad4m://ontology/timestamp> ?timestamp .
|
|
266
260
|
${filterClause}
|
|
267
261
|
}
|
|
268
262
|
`.trim();
|
|
269
263
|
}
|
|
270
264
|
return `
|
|
265
|
+
|
|
271
266
|
SELECT ?source ?predicate ?target ?author ?timestamp WHERE {${joinClause}
|
|
272
|
-
|
|
267
|
+
?source ?predicate ?target .
|
|
268
|
+
?_reifier <http://www.w3.org/1999/02/22-rdf-syntax-ns#reifies> <<( ?source ?predicate ?target )>> .
|
|
273
269
|
FILTER(isIRI(?source) && isIRI(?predicate))
|
|
274
|
-
?
|
|
275
|
-
?
|
|
270
|
+
?_reifier <ad4m://ontology/author> ?author .
|
|
271
|
+
?_reifier <ad4m://ontology/timestamp> ?timestamp .
|
|
276
272
|
${filterClause}
|
|
277
273
|
}
|
|
278
274
|
${buildSPARQLOrderLimitOffset(metadata, query)}
|
|
@@ -305,15 +301,10 @@ export function buildPaginationSubquery(joinPatterns, filterExpressions, metadat
|
|
|
305
301
|
const innerFilter = filterExpressions.length > 0
|
|
306
302
|
? `FILTER(\n ${filterExpressions.join(' &&\n ')}\n )`
|
|
307
303
|
: '';
|
|
308
|
-
// Build ORDER BY clause from query.order
|
|
309
|
-
// When ORDER BY references non-grouped variables we must use SAMPLE()
|
|
310
|
-
// aggregates so the query is valid SPARQL 1.1.
|
|
304
|
+
// Build ORDER BY clause from query.order
|
|
311
305
|
let orderByClause = '';
|
|
312
306
|
const orderJoinPatterns = [];
|
|
313
|
-
const sampleProjections = []; // e.g. (SAMPLE(?cfTarget_title) AS ?pg_sort_0)
|
|
314
|
-
const needsGroupBy = query.order && Object.keys(query.order).length > 0;
|
|
315
307
|
if (query.order) {
|
|
316
|
-
let sortIdx = 0;
|
|
317
308
|
const orderTerms = Object.entries(query.order).map(([prop, dir]) => {
|
|
318
309
|
const sparqlVar = mapPropertyToSPARQLVar(prop, metadata);
|
|
319
310
|
// Check if this order property's variable is already bound by existing
|
|
@@ -325,137 +316,23 @@ export function buildPaginationSubquery(joinPatterns, filterExpressions, metadat
|
|
|
325
316
|
orderJoinPatterns.push(`\n OPTIONAL { ?source <${propMeta.predicate}> ${sparqlVar} . }`);
|
|
326
317
|
}
|
|
327
318
|
}
|
|
328
|
-
|
|
329
|
-
const sortAlias = `?pg_sort_${sortIdx++}`;
|
|
330
|
-
sampleProjections.push(`(SAMPLE(${sparqlVar}) AS ${sortAlias})`);
|
|
331
|
-
return dir === 'DESC' ? `DESC(${sortAlias})` : `ASC(${sortAlias})`;
|
|
319
|
+
return dir === 'DESC' ? `DESC(${sparqlVar})` : `ASC(${sparqlVar})`;
|
|
332
320
|
});
|
|
333
321
|
if (orderTerms.length > 0) {
|
|
334
322
|
orderByClause = `ORDER BY ${orderTerms.join(' ')}`;
|
|
335
323
|
}
|
|
336
324
|
}
|
|
325
|
+
// No default ordering — when no explicit order is specified, results come in
|
|
326
|
+
// natural (insertion) order.
|
|
327
|
+
const tsSelect = '';
|
|
328
|
+
const tsPattern = '';
|
|
337
329
|
const limitClause = query.limit !== undefined ? `LIMIT ${query.limit}` : '';
|
|
338
330
|
const offsetClause = query.offset !== undefined && query.offset > 0 ? `OFFSET ${query.offset}` : '';
|
|
339
|
-
// When there's no ORDER BY, DISTINCT alone handles deduplication — no GROUP BY needed.
|
|
340
|
-
// When there IS ORDER BY, use GROUP BY ?source with SAMPLE() aggregates for the sort keys.
|
|
341
|
-
const sampleSelect = sampleProjections.length > 0 ? ' ' + sampleProjections.join(' ') : '';
|
|
342
|
-
const groupByClause = needsGroupBy ? 'GROUP BY ?source' : '';
|
|
343
331
|
return `
|
|
344
|
-
{ SELECT DISTINCT ?source${
|
|
332
|
+
{ SELECT DISTINCT ?source${tsSelect} WHERE {${innerJoin}${orderJoinPatterns.join('')}${tsPattern}
|
|
345
333
|
FILTER(isIRI(?source))
|
|
346
334
|
${innerFilter}
|
|
347
|
-
}
|
|
348
|
-
}
|
|
349
|
-
/**
|
|
350
|
-
* Build a SPARQL COUNT query that returns the total number of matching
|
|
351
|
-
* instances WITHOUT hydrating them. Uses the same WHERE clause as
|
|
352
|
-
* buildSPARQLQuery but wraps it in SELECT (COUNT(DISTINCT ?source) AS ?count).
|
|
353
|
-
*
|
|
354
|
-
* LIMIT/OFFSET from the query are stripped internally — this always counts
|
|
355
|
-
* the full result set.
|
|
356
|
-
*/
|
|
357
|
-
export function buildSPARQLCountQuery(metadata, allRelationsMetadata, query, modelClass) {
|
|
358
|
-
// Build the same join/filter patterns as buildSPARQLQuery
|
|
359
|
-
const joinPatterns = [];
|
|
360
|
-
const filterExpressions = [];
|
|
361
|
-
if (query.parent) {
|
|
362
|
-
const parentPredicate = resolveParentPredicate(query.parent, modelClass);
|
|
363
|
-
joinPatterns.push(`\n ${iri(query.parent.id)} ${iri(parentPredicate)} ?source .`);
|
|
364
|
-
}
|
|
365
|
-
let hasConformance = false;
|
|
366
|
-
for (const [, propMeta] of Object.entries(metadata.properties)) {
|
|
367
|
-
if (propMeta.required) {
|
|
368
|
-
if (propMeta.getter)
|
|
369
|
-
continue;
|
|
370
|
-
hasConformance = true;
|
|
371
|
-
if (propMeta.flag && propMeta.initial) {
|
|
372
|
-
joinPatterns.push(`\n ?source ${iri(propMeta.predicate)} ${iri(propMeta.initial)} .`);
|
|
373
|
-
}
|
|
374
|
-
else {
|
|
375
|
-
joinPatterns.push(`\n ?source ${iri(propMeta.predicate)} ?cfTarget_${propMeta.name} .`);
|
|
376
|
-
}
|
|
377
|
-
}
|
|
378
|
-
}
|
|
379
|
-
if (!hasConformance) {
|
|
380
|
-
for (const [, propMeta] of Object.entries(metadata.properties)) {
|
|
381
|
-
if (propMeta.initial) {
|
|
382
|
-
hasConformance = true;
|
|
383
|
-
if (propMeta.flag) {
|
|
384
|
-
joinPatterns.push(`\n ?source ${iri(propMeta.predicate)} ${iri(propMeta.initial)} .`);
|
|
385
|
-
}
|
|
386
|
-
else {
|
|
387
|
-
joinPatterns.push(`\n ?source ${iri(propMeta.predicate)} ?cfInitTarget_${propMeta.name} .`);
|
|
388
|
-
}
|
|
389
|
-
break;
|
|
390
|
-
}
|
|
391
|
-
}
|
|
392
|
-
}
|
|
393
|
-
if (!hasConformance && joinPatterns.length === 0) {
|
|
394
|
-
const knownPredicates = [];
|
|
395
|
-
for (const [, propMeta] of Object.entries(metadata.properties)) {
|
|
396
|
-
if (propMeta.predicate)
|
|
397
|
-
knownPredicates.push(iri(propMeta.predicate));
|
|
398
|
-
}
|
|
399
|
-
if (metadata.relations) {
|
|
400
|
-
for (const [, relMeta] of Object.entries(metadata.relations)) {
|
|
401
|
-
if (relMeta.predicate)
|
|
402
|
-
knownPredicates.push(iri(relMeta.predicate));
|
|
403
|
-
}
|
|
404
|
-
}
|
|
405
|
-
if (knownPredicates.length > 0) {
|
|
406
|
-
joinPatterns.push(`\n { SELECT DISTINCT ?source WHERE { ?source ?cf_structPred ?cf_structTarget . FILTER(?cf_structPred IN (${knownPredicates.join(", ")})) } }`);
|
|
407
|
-
}
|
|
408
|
-
}
|
|
409
|
-
const { joins: userJoins, filters: userFilters } = buildSPARQLWhereFilters(metadata, allRelationsMetadata, query.where);
|
|
410
|
-
joinPatterns.push(...userJoins);
|
|
411
|
-
filterExpressions.push(...userFilters);
|
|
412
|
-
const joinClause = joinPatterns.join('\n');
|
|
413
|
-
const filterClause = filterExpressions.length > 0
|
|
414
|
-
? `FILTER(\n ${filterExpressions.join(' &&\n ')}\n )`
|
|
415
|
-
: '';
|
|
416
|
-
return `
|
|
417
|
-
SELECT (COUNT(DISTINCT ?source) AS ?count) WHERE {${joinClause}
|
|
418
|
-
FILTER(isIRI(?source))
|
|
419
|
-
${filterClause}
|
|
420
|
-
}
|
|
421
|
-
`.trim();
|
|
422
|
-
}
|
|
423
|
-
/**
|
|
424
|
-
* Build a SPARQL query to fetch all links for a single instance.
|
|
425
|
-
*/
|
|
426
|
-
export function buildSPARQLGetDataQuery(baseExpression) {
|
|
427
|
-
return `
|
|
428
|
-
SELECT ?source ?predicate ?target ?author ?timestamp WHERE {
|
|
429
|
-
GRAPH ?linkGraph { ${iri(baseExpression)} ?predicate ?target . }
|
|
430
|
-
FILTER(isIRI(?predicate))
|
|
431
|
-
BIND(${iri(baseExpression)} AS ?source)
|
|
432
|
-
?linkGraph <ad4m://ontology/author> ?author .
|
|
433
|
-
?linkGraph <ad4m://ontology/timestamp> ?timestamp .
|
|
434
|
-
}
|
|
435
|
-
`.trim();
|
|
436
|
-
}
|
|
437
|
-
/**
|
|
438
|
-
* Group flat SPARQL link rows into the same shape that SPARQL returned:
|
|
439
|
-
* `{ source_uri: string, links: Array<{predicate, target, author, timestamp}> }`
|
|
440
|
-
*/
|
|
441
|
-
export function groupSPARQLResults(rows) {
|
|
442
|
-
const grouped = new Map();
|
|
443
|
-
for (const row of rows) {
|
|
444
|
-
const key = row.source;
|
|
445
|
-
if (!grouped.has(key)) {
|
|
446
|
-
grouped.set(key, []);
|
|
447
|
-
}
|
|
448
|
-
grouped.get(key).push({
|
|
449
|
-
predicate: row.predicate,
|
|
450
|
-
target: row.target,
|
|
451
|
-
author: row.author,
|
|
452
|
-
timestamp: row.timestamp,
|
|
453
|
-
});
|
|
454
|
-
}
|
|
455
|
-
return Array.from(grouped.entries()).map(([source_uri, links]) => ({
|
|
456
|
-
source_uri,
|
|
457
|
-
links,
|
|
458
|
-
}));
|
|
335
|
+
} GROUP BY ?source ${orderByClause} ${limitClause} ${offsetClause} }\n`;
|
|
459
336
|
}
|
|
460
337
|
/**
|
|
461
338
|
* Build SPARQL FILTER expressions from user `where` conditions.
|
|
@@ -490,53 +367,7 @@ function buildSPARQLWhereFilters(metadata, _allRelationsMetadata, where) {
|
|
|
490
367
|
}
|
|
491
368
|
continue;
|
|
492
369
|
}
|
|
493
|
-
if (propertyName === "author") {
|
|
494
|
-
// ?author is bound by the named graph block in buildSPARQLQuery /
|
|
495
|
-
// buildSPARQLGroupedCountQuery — push equality/IN filters into SPARQL.
|
|
496
|
-
if (Array.isArray(condition)) {
|
|
497
|
-
const formatted = condition.map(v => formatSPARQLValue(String(v))).join(', ');
|
|
498
|
-
filters.push(`STR(?author) IN (${formatted})`);
|
|
499
|
-
}
|
|
500
|
-
else if (typeof condition === 'object' && condition !== null) {
|
|
501
|
-
const ops = condition;
|
|
502
|
-
if (ops.not !== undefined) {
|
|
503
|
-
if (Array.isArray(ops.not)) {
|
|
504
|
-
const formatted = ops.not.map((v) => formatSPARQLValue(String(v))).join(', ');
|
|
505
|
-
filters.push(`!(STR(?author) IN (${formatted}))`);
|
|
506
|
-
}
|
|
507
|
-
else {
|
|
508
|
-
filters.push(`STR(?author) != ${formatSPARQLValue(String(ops.not))}`);
|
|
509
|
-
}
|
|
510
|
-
}
|
|
511
|
-
// Other operators (gt/lt/etc.) fall through to JS post-filter
|
|
512
|
-
}
|
|
513
|
-
else {
|
|
514
|
-
filters.push(`STR(?author) = ${formatSPARQLValue(String(condition))}`);
|
|
515
|
-
}
|
|
516
|
-
continue;
|
|
517
|
-
}
|
|
518
|
-
if (propertyName === "timestamp") {
|
|
519
|
-
// ?timestamp is bound by the named graph block — push numeric comparisons.
|
|
520
|
-
if (typeof condition === 'object' && condition !== null && !Array.isArray(condition)) {
|
|
521
|
-
const ops = condition;
|
|
522
|
-
if (ops.gt !== undefined)
|
|
523
|
-
filters.push(`?timestamp > ${Number(ops.gt)}`);
|
|
524
|
-
if (ops.gte !== undefined)
|
|
525
|
-
filters.push(`?timestamp >= ${Number(ops.gte)}`);
|
|
526
|
-
if (ops.lt !== undefined)
|
|
527
|
-
filters.push(`?timestamp < ${Number(ops.lt)}`);
|
|
528
|
-
if (ops.lte !== undefined)
|
|
529
|
-
filters.push(`?timestamp <= ${Number(ops.lte)}`);
|
|
530
|
-
if (ops.between !== undefined && Array.isArray(ops.between)) {
|
|
531
|
-
filters.push(`?timestamp >= ${Number(ops.between[0])} && ?timestamp <= ${Number(ops.between[1])}`);
|
|
532
|
-
}
|
|
533
|
-
if (ops.not !== undefined) {
|
|
534
|
-
filters.push(`?timestamp != ${Number(ops.not)}`);
|
|
535
|
-
}
|
|
536
|
-
}
|
|
537
|
-
else if (typeof condition === 'number' || (typeof condition === 'string' && !isNaN(Number(condition)))) {
|
|
538
|
-
filters.push(`?timestamp = ${Number(condition)}`);
|
|
539
|
-
}
|
|
370
|
+
if (propertyName === "author" || propertyName === "timestamp") {
|
|
540
371
|
continue;
|
|
541
372
|
}
|
|
542
373
|
const propMeta = metadata.properties[propertyName];
|
|
@@ -638,130 +469,3 @@ function buildSPARQLWhereFilters(metadata, _allRelationsMetadata, where) {
|
|
|
638
469
|
}
|
|
639
470
|
return { joins, filters };
|
|
640
471
|
}
|
|
641
|
-
/**
|
|
642
|
-
* Parse a SPARQL COUNT result row into a number.
|
|
643
|
-
* Handles `row.count?.value` (RDF binding), `row.count` (direct number/string),
|
|
644
|
-
* NaN results, and empty/malformed results.
|
|
645
|
-
*
|
|
646
|
-
* @returns The parsed count, or `null` if the result cannot be interpreted.
|
|
647
|
-
*/
|
|
648
|
-
export function parseSparqlCount(result) {
|
|
649
|
-
if (!Array.isArray(result) || result.length === 0)
|
|
650
|
-
return null;
|
|
651
|
-
const row = result[0];
|
|
652
|
-
const val = row.count?.value ?? row.count;
|
|
653
|
-
if (val === undefined || val === null)
|
|
654
|
-
return null;
|
|
655
|
-
const parsed = typeof val === 'number' ? val : parseInt(String(val), 10);
|
|
656
|
-
return isNaN(parsed) ? null : parsed;
|
|
657
|
-
}
|
|
658
|
-
/**
|
|
659
|
-
* Build a SPARQL query that counts child instances grouped by parent IRI.
|
|
660
|
-
*
|
|
661
|
-
* Used by the projection Path A (`count: true`) in `hydrateRelations` to get
|
|
662
|
-
* per-parent counts in a single round-trip with zero instance hydration.
|
|
663
|
-
*
|
|
664
|
-
* Includes the full named graph block so that `?author` and `?timestamp` are
|
|
665
|
-
* bound and available for SPARQL FILTER expressions (unlike the intentionally
|
|
666
|
-
* minimal `buildSPARQLCountQuery` which omits them for speed).
|
|
667
|
-
*
|
|
668
|
-
* @param metadata - Model metadata for the **child** (target) class
|
|
669
|
-
* @param allRelationsMetadata - Relations metadata for the child class
|
|
670
|
-
* @param relationPredicate - The predicate linking `?parent` → `?source` (child)
|
|
671
|
-
* @param parentIds - IRI strings of all parent instances to count for
|
|
672
|
-
* @param where - Optional filter applied to child instances
|
|
673
|
-
*/
|
|
674
|
-
export function buildSPARQLGroupedCountQuery(metadata, allRelationsMetadata, relationPredicate, parentIds, where) {
|
|
675
|
-
const joinPatterns = [];
|
|
676
|
-
const filterExpressions = [];
|
|
677
|
-
// Parent → child join and IN filter
|
|
678
|
-
joinPatterns.push(`\n ?parent ${iri(relationPredicate)} ?source .`);
|
|
679
|
-
const parentIris = parentIds.map(id => iri(id)).join(', ');
|
|
680
|
-
filterExpressions.push(`?parent IN (${parentIris})`);
|
|
681
|
-
// Conformance patterns (mirrors buildSPARQLCountQuery logic)
|
|
682
|
-
let hasConformance = false;
|
|
683
|
-
for (const [, propMeta] of Object.entries(metadata.properties)) {
|
|
684
|
-
if (propMeta.required) {
|
|
685
|
-
if (propMeta.getter)
|
|
686
|
-
continue;
|
|
687
|
-
hasConformance = true;
|
|
688
|
-
if (propMeta.flag && propMeta.initial) {
|
|
689
|
-
joinPatterns.push(`\n ?source ${iri(propMeta.predicate)} ${iri(propMeta.initial)} .`);
|
|
690
|
-
}
|
|
691
|
-
else {
|
|
692
|
-
joinPatterns.push(`\n ?source ${iri(propMeta.predicate)} ?cfTarget_${propMeta.name} .`);
|
|
693
|
-
}
|
|
694
|
-
}
|
|
695
|
-
}
|
|
696
|
-
if (!hasConformance) {
|
|
697
|
-
for (const [, propMeta] of Object.entries(metadata.properties)) {
|
|
698
|
-
if (propMeta.initial) {
|
|
699
|
-
hasConformance = true;
|
|
700
|
-
if (propMeta.flag) {
|
|
701
|
-
joinPatterns.push(`\n ?source ${iri(propMeta.predicate)} ${iri(propMeta.initial)} .`);
|
|
702
|
-
}
|
|
703
|
-
else {
|
|
704
|
-
joinPatterns.push(`\n ?source ${iri(propMeta.predicate)} ?cfInitTarget_${propMeta.name} .`);
|
|
705
|
-
}
|
|
706
|
-
break;
|
|
707
|
-
}
|
|
708
|
-
}
|
|
709
|
-
}
|
|
710
|
-
if (!hasConformance && joinPatterns.length <= 1) {
|
|
711
|
-
// Only the parent join so far — add open-world structural matching
|
|
712
|
-
const knownPredicates = [];
|
|
713
|
-
for (const [, propMeta] of Object.entries(metadata.properties)) {
|
|
714
|
-
if (propMeta.predicate)
|
|
715
|
-
knownPredicates.push(iri(propMeta.predicate));
|
|
716
|
-
}
|
|
717
|
-
if (metadata.relations) {
|
|
718
|
-
for (const [, relMeta] of Object.entries(metadata.relations)) {
|
|
719
|
-
if (relMeta.predicate)
|
|
720
|
-
knownPredicates.push(iri(relMeta.predicate));
|
|
721
|
-
}
|
|
722
|
-
}
|
|
723
|
-
if (knownPredicates.length > 0) {
|
|
724
|
-
joinPatterns.push(`\n { SELECT DISTINCT ?source WHERE { ?source ?cf_structPred ?cf_structTarget . FILTER(?cf_structPred IN (${knownPredicates.join(', ')})) } }`);
|
|
725
|
-
}
|
|
726
|
-
}
|
|
727
|
-
// User where-clause filters (including author/timestamp after the SPARQL push)
|
|
728
|
-
const { joins: userJoins, filters: userFilters } = buildSPARQLWhereFilters(metadata, allRelationsMetadata, where);
|
|
729
|
-
joinPatterns.push(...userJoins);
|
|
730
|
-
filterExpressions.push(...userFilters);
|
|
731
|
-
const joinClause = joinPatterns.join('\n');
|
|
732
|
-
const filterClause = filterExpressions.length > 0
|
|
733
|
-
? `FILTER(\n ${filterExpressions.join(' &&\n ')}\n )`
|
|
734
|
-
: '';
|
|
735
|
-
return `
|
|
736
|
-
SELECT ?parent (COUNT(DISTINCT ?source) AS ?count) WHERE {${joinClause}
|
|
737
|
-
GRAPH ?linkGraph { ?source ?predicate ?target . }
|
|
738
|
-
FILTER(isIRI(?source) && isIRI(?predicate))
|
|
739
|
-
?linkGraph <ad4m://ontology/author> ?author .
|
|
740
|
-
?linkGraph <ad4m://ontology/timestamp> ?timestamp .
|
|
741
|
-
${filterClause}
|
|
742
|
-
}
|
|
743
|
-
GROUP BY ?parent
|
|
744
|
-
`.trim();
|
|
745
|
-
}
|
|
746
|
-
/**
|
|
747
|
-
* Parse the result of `buildSPARQLGroupedCountQuery` into a map from parent IRI
|
|
748
|
-
* to count. Missing parents (zero matches) are absent from the map — callers
|
|
749
|
-
* should use `map.get(id) ?? 0`.
|
|
750
|
-
*
|
|
751
|
-
* @returns Map from parentId string → count number
|
|
752
|
-
*/
|
|
753
|
-
export function parseSparqlGroupedCount(result) {
|
|
754
|
-
const out = new Map();
|
|
755
|
-
if (!Array.isArray(result))
|
|
756
|
-
return out;
|
|
757
|
-
for (const row of result) {
|
|
758
|
-
const parentVal = row.parent?.value ?? row.parent;
|
|
759
|
-
const countVal = row.count?.value ?? row.count;
|
|
760
|
-
if (!parentVal || countVal === undefined || countVal === null)
|
|
761
|
-
continue;
|
|
762
|
-
const parsed = typeof countVal === 'number' ? countVal : parseInt(String(countVal), 10);
|
|
763
|
-
if (!isNaN(parsed))
|
|
764
|
-
out.set(String(parentVal), parsed);
|
|
765
|
-
}
|
|
766
|
-
return out;
|
|
767
|
-
}
|