@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
package/src/model/Subject.ts
DELETED
|
@@ -1,159 +0,0 @@
|
|
|
1
|
-
import { PerspectiveProxy } from "../perspectives/PerspectiveProxy";
|
|
2
|
-
import { relationToAdderName, relationToRemoverName, relationToSetterName, propertyNameToSetterName } from "./util";
|
|
3
|
-
|
|
4
|
-
/**
|
|
5
|
-
* Represents a subject in the perspective.
|
|
6
|
-
* A subject is an entity that has properties and relations.
|
|
7
|
-
*/
|
|
8
|
-
export class Subject {
|
|
9
|
-
#baseExpression: string;
|
|
10
|
-
#subjectClassName: string;
|
|
11
|
-
#perspective: PerspectiveProxy
|
|
12
|
-
|
|
13
|
-
/**
|
|
14
|
-
* Constructs a new subject.
|
|
15
|
-
* @param perspective - The perspective that the subject belongs to.
|
|
16
|
-
* @param baseExpression - The base expression of the subject.
|
|
17
|
-
* @param subjectClassName - The class name of the subject.
|
|
18
|
-
*/
|
|
19
|
-
constructor(perspective: PerspectiveProxy, baseExpression: string, subjectClassName: string) {
|
|
20
|
-
this.#baseExpression = baseExpression
|
|
21
|
-
this.#subjectClassName = subjectClassName
|
|
22
|
-
this.#perspective = perspective
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
/**
|
|
26
|
-
* Gets the base expression of the subject.
|
|
27
|
-
*/
|
|
28
|
-
get baseExpression() {
|
|
29
|
-
return this.#baseExpression
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
/**
|
|
33
|
-
* Initializes the subject by validating it and defining its properties and relations dynamically.
|
|
34
|
-
*
|
|
35
|
-
* NOTE: This method should be called before using the subject. All the properties and relations of the subject defined are not type-checked.
|
|
36
|
-
*/
|
|
37
|
-
async init() {
|
|
38
|
-
// Check if the subject is a valid instance of the subject class
|
|
39
|
-
let isInstance = await this.#perspective.isSubjectInstance(this.#baseExpression, this.#subjectClassName)
|
|
40
|
-
if(!isInstance) {
|
|
41
|
-
throw `Not a valid subject instance of ${this.#subjectClassName} for ${this.#baseExpression}`
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
// Define properties and relations dynamically
|
|
45
|
-
let results = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), property(C, Property)`)
|
|
46
|
-
let properties = results.map(result => result.Property)
|
|
47
|
-
|
|
48
|
-
for(let p of properties) {
|
|
49
|
-
const resolveExpressionURI = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), property_resolve(C, "${p}")`)
|
|
50
|
-
Object.defineProperty(this, p, {
|
|
51
|
-
configurable: true,
|
|
52
|
-
get: async () => {
|
|
53
|
-
// Use SPARQL for data queries
|
|
54
|
-
try {
|
|
55
|
-
return await this.#perspective.getPropertyValueViaSparql(this.#baseExpression, this.#subjectClassName, p);
|
|
56
|
-
} catch (err) {
|
|
57
|
-
console.warn(`Failed to get property ${p} via SPARQL:`, err);
|
|
58
|
-
return undefined;
|
|
59
|
-
}
|
|
60
|
-
}
|
|
61
|
-
})
|
|
62
|
-
}
|
|
63
|
-
|
|
64
|
-
// Define setters
|
|
65
|
-
const setters = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), property_setter(C, Property, Setter)`)
|
|
66
|
-
|
|
67
|
-
for(let setter of (setters ? setters : [])) {
|
|
68
|
-
if(setter) {
|
|
69
|
-
const property = setter.Property
|
|
70
|
-
const actions = eval(setter.Setter)
|
|
71
|
-
const resolveLanguageResults = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), property_resolve_language(C, "${property}", Language)`)
|
|
72
|
-
let resolveLanguage
|
|
73
|
-
if(resolveLanguageResults && resolveLanguageResults.length > 0) {
|
|
74
|
-
resolveLanguage = resolveLanguageResults[0].Language
|
|
75
|
-
}
|
|
76
|
-
this[propertyNameToSetterName(property)] = async (value: any) => {
|
|
77
|
-
if(resolveLanguage) {
|
|
78
|
-
value = await this.#perspective.createExpression(value, resolveLanguage)
|
|
79
|
-
}
|
|
80
|
-
await this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value}])
|
|
81
|
-
}
|
|
82
|
-
}
|
|
83
|
-
}
|
|
84
|
-
|
|
85
|
-
// Define relations
|
|
86
|
-
let results2 = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), collection(C, Collection)`)
|
|
87
|
-
if(!results2) results2 = []
|
|
88
|
-
let relations = results2.map(result => result.Collection)
|
|
89
|
-
|
|
90
|
-
for(let c of relations) {
|
|
91
|
-
Object.defineProperty(this, c, {
|
|
92
|
-
configurable: true,
|
|
93
|
-
get: async () => {
|
|
94
|
-
// Use SPARQL for data queries
|
|
95
|
-
try {
|
|
96
|
-
return await this.#perspective.getRelationValuesViaSparql(this.#baseExpression, this.#subjectClassName, c);
|
|
97
|
-
} catch (err) {
|
|
98
|
-
console.warn(`Failed to get relation ${c} via SPARQL:`, err);
|
|
99
|
-
return [];
|
|
100
|
-
}
|
|
101
|
-
}
|
|
102
|
-
})
|
|
103
|
-
}
|
|
104
|
-
|
|
105
|
-
// Define relation adders
|
|
106
|
-
let adders = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), collection_adder(C, Collection, Adder)`)
|
|
107
|
-
if(!adders) adders = []
|
|
108
|
-
|
|
109
|
-
for(let adder of adders) {
|
|
110
|
-
if(adder) {
|
|
111
|
-
const relation = adder.Collection
|
|
112
|
-
const actions = eval(adder.Adder)
|
|
113
|
-
this[relationToAdderName(relation)] = async (value: any) => {
|
|
114
|
-
if (Array.isArray(value)) {
|
|
115
|
-
await Promise.all(value.map(v => this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value: v}])))
|
|
116
|
-
} else {
|
|
117
|
-
await this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value}])
|
|
118
|
-
}
|
|
119
|
-
}
|
|
120
|
-
}
|
|
121
|
-
}
|
|
122
|
-
|
|
123
|
-
// Define relation removers
|
|
124
|
-
let removers = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), collection_remover(C, Collection, Remover)`)
|
|
125
|
-
if(!removers) removers = []
|
|
126
|
-
|
|
127
|
-
for(let remover of removers) {
|
|
128
|
-
if(remover) {
|
|
129
|
-
const relation = remover.Collection
|
|
130
|
-
const actions = eval(remover.Remover)
|
|
131
|
-
this[relationToRemoverName(relation)] = async (value: any) => {
|
|
132
|
-
if (Array.isArray(value)) {
|
|
133
|
-
await Promise.all(value.map(v => this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value: v}])))
|
|
134
|
-
} else {
|
|
135
|
-
await this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value}])
|
|
136
|
-
}
|
|
137
|
-
}
|
|
138
|
-
}
|
|
139
|
-
}
|
|
140
|
-
|
|
141
|
-
// Define relation setters
|
|
142
|
-
let relationSetters = await this.#perspective.infer(`subject_class("${this.#subjectClassName}", C), collection_setter(C, Collection, Setter)`)
|
|
143
|
-
if(!relationSetters) relationSetters = []
|
|
144
|
-
|
|
145
|
-
for(let relationSetter of relationSetters) {
|
|
146
|
-
if(relationSetter) {
|
|
147
|
-
const relation = relationSetter.Collection
|
|
148
|
-
const actions = eval(relationSetter.Setter)
|
|
149
|
-
this[relationToSetterName(relation)] = async (value: any) => {
|
|
150
|
-
if (Array.isArray(value)) {
|
|
151
|
-
await this.#perspective.executeAction(actions, this.#baseExpression, value.map(v => ({name: "value", value: v})))
|
|
152
|
-
} else {
|
|
153
|
-
await this.#perspective.executeAction(actions, this.#baseExpression, [{name: "value", value}])
|
|
154
|
-
}
|
|
155
|
-
}
|
|
156
|
-
}
|
|
157
|
-
}
|
|
158
|
-
}
|
|
159
|
-
}
|
|
@@ -1,205 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Batch hydration for SPARQL batch query results.
|
|
3
|
-
*
|
|
4
|
-
* Takes the flat rows returned by `buildBatchSPARQLQuery()` (each tagged
|
|
5
|
-
* with ?depth, ?parentBase, ?relationName) and reconstructs a tree of
|
|
6
|
-
* model instances.
|
|
7
|
-
*
|
|
8
|
-
* @module
|
|
9
|
-
*/
|
|
10
|
-
|
|
11
|
-
import { hydrateFromLinks, evaluateCustomGettersForInstance } from "./hydration";
|
|
12
|
-
import { getRelationsMetadata } from "./decorators";
|
|
13
|
-
import type { IncludeMap, ModelMetadata } from "./types";
|
|
14
|
-
|
|
15
|
-
/**
|
|
16
|
-
* A row returned by the batch SPARQL query.
|
|
17
|
-
*/
|
|
18
|
-
interface BatchRow {
|
|
19
|
-
depth: string;
|
|
20
|
-
parentBase: string;
|
|
21
|
-
relationName: string;
|
|
22
|
-
source: string;
|
|
23
|
-
predicate: string;
|
|
24
|
-
target: string;
|
|
25
|
-
author: string;
|
|
26
|
-
timestamp: string;
|
|
27
|
-
}
|
|
28
|
-
|
|
29
|
-
/**
|
|
30
|
-
* Grouped link data for one instance (same shape as SPARQL grouped result).
|
|
31
|
-
*/
|
|
32
|
-
interface GroupedInstance {
|
|
33
|
-
source_uri: string;
|
|
34
|
-
parentBase: string;
|
|
35
|
-
relationName: string;
|
|
36
|
-
links: Array<{ predicate: string; target: string; author: string; timestamp: string }>;
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
/**
|
|
40
|
-
* Group batch rows by (depth, source) → array of links, preserving parentBase/relationName.
|
|
41
|
-
*/
|
|
42
|
-
function groupBatchRows(rows: BatchRow[]): Map<number, GroupedInstance[]> {
|
|
43
|
-
const byDepth = new Map<number, Map<string, GroupedInstance>>();
|
|
44
|
-
|
|
45
|
-
for (const row of rows) {
|
|
46
|
-
const depth = parseInt(row.depth, 10);
|
|
47
|
-
if (!byDepth.has(depth)) byDepth.set(depth, new Map());
|
|
48
|
-
const depthMap = byDepth.get(depth)!;
|
|
49
|
-
|
|
50
|
-
const key = row.source;
|
|
51
|
-
if (!depthMap.has(key)) {
|
|
52
|
-
depthMap.set(key, {
|
|
53
|
-
source_uri: key,
|
|
54
|
-
parentBase: row.parentBase,
|
|
55
|
-
relationName: row.relationName,
|
|
56
|
-
links: [],
|
|
57
|
-
});
|
|
58
|
-
}
|
|
59
|
-
depthMap.get(key)!.links.push({
|
|
60
|
-
predicate: row.predicate,
|
|
61
|
-
target: row.target,
|
|
62
|
-
author: row.author,
|
|
63
|
-
timestamp: row.timestamp,
|
|
64
|
-
});
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
const result = new Map<number, GroupedInstance[]>();
|
|
68
|
-
for (const [depth, map] of byDepth) {
|
|
69
|
-
result.set(depth, Array.from(map.values()));
|
|
70
|
-
}
|
|
71
|
-
return result;
|
|
72
|
-
}
|
|
73
|
-
|
|
74
|
-
/**
|
|
75
|
-
* Hydrate batch SPARQL results into a tree of model instances.
|
|
76
|
-
*
|
|
77
|
-
* @param rows - Flat rows from the batch SPARQL query
|
|
78
|
-
* @param rootClass - The root model class (extends Ad4mModel)
|
|
79
|
-
* @param includeMap - The include specification from the query
|
|
80
|
-
* @param perspective - The PerspectiveProxy for creating instances
|
|
81
|
-
* @returns Array of hydrated root instances with relations populated
|
|
82
|
-
*/
|
|
83
|
-
export async function hydrateBatchResult<T>(
|
|
84
|
-
rows: BatchRow[],
|
|
85
|
-
rootClass: any,
|
|
86
|
-
includeMap: IncludeMap,
|
|
87
|
-
perspective: any,
|
|
88
|
-
): Promise<T[]> {
|
|
89
|
-
if (!rows || rows.length === 0) return [];
|
|
90
|
-
|
|
91
|
-
const grouped = groupBatchRows(rows);
|
|
92
|
-
|
|
93
|
-
// Hydrate root instances (depth 0)
|
|
94
|
-
const rootInstances = grouped.get(0) || [];
|
|
95
|
-
const metadata: ModelMetadata = rootClass.getModelMetadata();
|
|
96
|
-
const instances: T[] = [];
|
|
97
|
-
const instanceMap = new Map<string, T>();
|
|
98
|
-
|
|
99
|
-
for (const group of rootInstances) {
|
|
100
|
-
const instance = new rootClass(perspective, group.source_uri) as any;
|
|
101
|
-
await hydrateFromLinks(instance, group.links, metadata, perspective);
|
|
102
|
-
await evaluateCustomGettersForInstance(instance, perspective, metadata);
|
|
103
|
-
instances.push(instance);
|
|
104
|
-
instanceMap.set(group.source_uri, instance);
|
|
105
|
-
}
|
|
106
|
-
|
|
107
|
-
// Hydrate each depth level and wire to parents
|
|
108
|
-
const relMeta = getRelationsMetadata(rootClass);
|
|
109
|
-
const maxDepth = Math.max(...Array.from(grouped.keys()), 0);
|
|
110
|
-
|
|
111
|
-
// Build a map of depth → (class, relMetadata, parentInstanceMap)
|
|
112
|
-
// For depth 1, parents are root instances; for deeper depths, we need
|
|
113
|
-
// the instances from the previous level.
|
|
114
|
-
const depthInstanceMaps = new Map<number, Map<string, any>>();
|
|
115
|
-
depthInstanceMaps.set(0, instanceMap);
|
|
116
|
-
|
|
117
|
-
// Build depth→class mapping from include tree
|
|
118
|
-
const depthClassMap = new Map<number, { targetClass: any; includeMap?: IncludeMap }>();
|
|
119
|
-
buildDepthClassMap(rootClass, includeMap, 0, { value: 1 }, depthClassMap);
|
|
120
|
-
|
|
121
|
-
for (let depth = 1; depth <= maxDepth; depth++) {
|
|
122
|
-
const depthGroups = grouped.get(depth) || [];
|
|
123
|
-
if (depthGroups.length === 0) continue;
|
|
124
|
-
|
|
125
|
-
const depthInfo = depthClassMap.get(depth);
|
|
126
|
-
if (!depthInfo) continue;
|
|
127
|
-
|
|
128
|
-
const TargetClass = depthInfo.targetClass;
|
|
129
|
-
const targetMetadata: ModelMetadata = TargetClass.getModelMetadata
|
|
130
|
-
? TargetClass.getModelMetadata()
|
|
131
|
-
: { className: "Unknown", properties: {}, relations: {} };
|
|
132
|
-
|
|
133
|
-
const currentDepthInstances = new Map<string, any>();
|
|
134
|
-
|
|
135
|
-
// Group by parentBase to wire children to parents
|
|
136
|
-
for (const group of depthGroups) {
|
|
137
|
-
const instance = new TargetClass(perspective, group.source_uri) as any;
|
|
138
|
-
await hydrateFromLinks(instance, group.links, targetMetadata, perspective);
|
|
139
|
-
await evaluateCustomGettersForInstance(instance, perspective, targetMetadata);
|
|
140
|
-
currentDepthInstances.set(group.source_uri, instance);
|
|
141
|
-
|
|
142
|
-
// Wire to parent
|
|
143
|
-
// Find the parent depth's instance map
|
|
144
|
-
// The parentBase should exist in one of the prior depth maps
|
|
145
|
-
for (let pd = depth - 1; pd >= 0; pd--) {
|
|
146
|
-
const parentMap = depthInstanceMaps.get(pd);
|
|
147
|
-
if (parentMap && parentMap.has(group.parentBase)) {
|
|
148
|
-
const parent = parentMap.get(group.parentBase)!;
|
|
149
|
-
const relName = group.relationName;
|
|
150
|
-
|
|
151
|
-
// Determine relation metadata to know if it's an array or single
|
|
152
|
-
const parentRelMeta = getRelationsMetadata(pd === 0 ? rootClass : (depthClassMap.get(pd)?.targetClass || rootClass));
|
|
153
|
-
const rel = parentRelMeta[relName];
|
|
154
|
-
|
|
155
|
-
if (rel) {
|
|
156
|
-
if (rel.kind === 'hasMany' || rel.kind === 'belongsToMany') {
|
|
157
|
-
if (!Array.isArray(parent[relName])) {
|
|
158
|
-
parent[relName] = [];
|
|
159
|
-
}
|
|
160
|
-
parent[relName].push(instance);
|
|
161
|
-
} else {
|
|
162
|
-
parent[relName] = instance;
|
|
163
|
-
}
|
|
164
|
-
}
|
|
165
|
-
break;
|
|
166
|
-
}
|
|
167
|
-
}
|
|
168
|
-
}
|
|
169
|
-
|
|
170
|
-
depthInstanceMaps.set(depth, currentDepthInstances);
|
|
171
|
-
}
|
|
172
|
-
|
|
173
|
-
return instances;
|
|
174
|
-
}
|
|
175
|
-
|
|
176
|
-
/**
|
|
177
|
-
* Build a mapping from depth number to target class info.
|
|
178
|
-
*/
|
|
179
|
-
function buildDepthClassMap(
|
|
180
|
-
parentClass: any,
|
|
181
|
-
includeMap: IncludeMap,
|
|
182
|
-
_parentDepth: number,
|
|
183
|
-
nextDepth: { value: number },
|
|
184
|
-
result: Map<number, { targetClass: any; includeMap?: IncludeMap }>,
|
|
185
|
-
): void {
|
|
186
|
-
const relMeta = getRelationsMetadata(parentClass);
|
|
187
|
-
|
|
188
|
-
for (const [relName, includeValue] of Object.entries(includeMap)) {
|
|
189
|
-
const meta = relMeta[relName];
|
|
190
|
-
if (!meta || !meta.target) continue;
|
|
191
|
-
|
|
192
|
-
const TargetClass = meta.target();
|
|
193
|
-
const depth = nextDepth.value++;
|
|
194
|
-
|
|
195
|
-
const nestedInclude = typeof includeValue === 'object' && includeValue !== null
|
|
196
|
-
? (includeValue as any).include
|
|
197
|
-
: undefined;
|
|
198
|
-
|
|
199
|
-
result.set(depth, { targetClass: TargetClass, includeMap: nestedInclude });
|
|
200
|
-
|
|
201
|
-
if (nestedInclude) {
|
|
202
|
-
buildDepthClassMap(TargetClass, nestedInclude, depth, nextDepth, result);
|
|
203
|
-
}
|
|
204
|
-
}
|
|
205
|
-
}
|
|
@@ -1,145 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Standalone Prolog fact generator for Ad4mModel classes.
|
|
3
|
-
*
|
|
4
|
-
* Converts decorator metadata into Prolog clauses that can be prepended to
|
|
5
|
-
* `perspective.infer()` calls, enabling custom Prolog rules to reference
|
|
6
|
-
* model instances and their fields.
|
|
7
|
-
*/
|
|
8
|
-
|
|
9
|
-
import type { ModelMetadata, PropertyMetadata, RelationMetadata } from "./types";
|
|
10
|
-
import type { Ad4mModel } from "./Ad4mModel";
|
|
11
|
-
|
|
12
|
-
// ── Helpers ──────────────────────────────────────────────────────────────────
|
|
13
|
-
|
|
14
|
-
/**
|
|
15
|
-
* Convert a camelCase or PascalCase identifier to snake_case.
|
|
16
|
-
* Examples: "TestPost" -> "test_post", "createdAt" -> "created_at"
|
|
17
|
-
*/
|
|
18
|
-
function toSnakeCase(str: string): string {
|
|
19
|
-
return str
|
|
20
|
-
.replace(/([A-Z])/g, "_$1")
|
|
21
|
-
.toLowerCase()
|
|
22
|
-
.replace(/^_/, "");
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
function buildInstanceClause(predicateName: string, metadata: ModelMetadata): string | null {
|
|
26
|
-
const props = metadata.properties;
|
|
27
|
-
// Collect flags first — these are the strongest recognizers
|
|
28
|
-
const flags = Object.values(props).filter((p) => p.flag && p.predicate && p.initial);
|
|
29
|
-
if (flags.length > 0) {
|
|
30
|
-
const conditions = flags
|
|
31
|
-
.map((p) => `triple(X, '${p.predicate}', '${p.initial}')`)
|
|
32
|
-
.join(",\n ");
|
|
33
|
-
return `${predicateName}(X) :-\n ${conditions}.`;
|
|
34
|
-
}
|
|
35
|
-
// Fallback: required non-flag properties
|
|
36
|
-
const required = Object.values(props).filter((p) => p.required && p.predicate && !p.flag);
|
|
37
|
-
if (required.length > 0) {
|
|
38
|
-
const conditions = required
|
|
39
|
-
.map((p) => `triple(X, '${p.predicate}', _)`)
|
|
40
|
-
.join(",\n ");
|
|
41
|
-
return `${predicateName}(X) :-\n ${conditions}.`;
|
|
42
|
-
}
|
|
43
|
-
// Open-world structural fallback: match nodes that have at least one of the
|
|
44
|
-
// model's declared property predicates. Uses disjunction (;) so any single
|
|
45
|
-
// predicate is enough.
|
|
46
|
-
const allPredicates = Object.values(props)
|
|
47
|
-
.filter((p) => p.predicate)
|
|
48
|
-
.map((p) => p.predicate!);
|
|
49
|
-
if (metadata.relations) {
|
|
50
|
-
for (const rel of Object.values(metadata.relations)) {
|
|
51
|
-
if (rel.predicate) allPredicates.push(rel.predicate);
|
|
52
|
-
}
|
|
53
|
-
}
|
|
54
|
-
if (allPredicates.length > 0) {
|
|
55
|
-
const disjunction = allPredicates
|
|
56
|
-
.map((pred) => `triple(X, '${pred}', _)`)
|
|
57
|
-
.join(" ;\n ");
|
|
58
|
-
return `${predicateName}(X) :-\n (${disjunction}).`;
|
|
59
|
-
}
|
|
60
|
-
return null;
|
|
61
|
-
}
|
|
62
|
-
|
|
63
|
-
function buildPropertyClause(modelPredicateName: string, prop: PropertyMetadata): string | null {
|
|
64
|
-
if (prop.flag) return null;
|
|
65
|
-
if (!prop.predicate) return null;
|
|
66
|
-
const clauseName = `${modelPredicateName}_${toSnakeCase(prop.name)}`;
|
|
67
|
-
return `${clauseName}(X, Value) :- triple(X, '${prop.predicate}', Value).`;
|
|
68
|
-
}
|
|
69
|
-
|
|
70
|
-
function buildRelationClause(modelPredicateName: string, relation: RelationMetadata): string | null {
|
|
71
|
-
if (!relation.predicate) return null;
|
|
72
|
-
const clauseName = `${modelPredicateName}_${toSnakeCase(relation.name)}`;
|
|
73
|
-
if (relation.direction === "reverse") {
|
|
74
|
-
return `${clauseName}(X, Values) :- findall(V, triple(V, '${relation.predicate}', X), Values).`;
|
|
75
|
-
}
|
|
76
|
-
return `${clauseName}(X, Values) :- findall(V, triple(X, '${relation.predicate}', V), Values).`;
|
|
77
|
-
}
|
|
78
|
-
|
|
79
|
-
// ── Public API ───────────────────────────────────────────────────────────────
|
|
80
|
-
|
|
81
|
-
/**
|
|
82
|
-
* Generate Prolog predicate facts from a model class's decorator metadata.
|
|
83
|
-
*
|
|
84
|
-
* Given a model class decorated with `@Model` (and its `@Flag`, `@Property`,
|
|
85
|
-
* `@HasMany`, `@BelongsToMany` decorators), this function emits a string of
|
|
86
|
-
* Prolog clauses that can be prepended to any `perspective.infer()` call.
|
|
87
|
-
*
|
|
88
|
-
* The generated predicates are:
|
|
89
|
-
* - **Instance recognizer** — `modelName(X)` — matches instances of the model
|
|
90
|
-
* - **Property getters** — `modelName_propName(X, Value)` — one per property
|
|
91
|
-
* - **Relation getters** — `modelName_relName(X, Values)` — one per relation
|
|
92
|
-
*
|
|
93
|
-
* @example
|
|
94
|
-
* ```typescript
|
|
95
|
-
* import { generatePrologFacts } from '@coasys/ad4m';
|
|
96
|
-
*
|
|
97
|
-
* const facts = generatePrologFacts(Poll);
|
|
98
|
-
* const result = await perspective.infer(\`
|
|
99
|
-
* \${facts}
|
|
100
|
-
* recent_popular_poll(X) :-
|
|
101
|
-
* poll(X),
|
|
102
|
-
* poll_vote_count(X, N), N > 10.
|
|
103
|
-
* \`);
|
|
104
|
-
* ```
|
|
105
|
-
*
|
|
106
|
-
* @param ModelClass - A class decorated with `@Model` that extends `Ad4mModel`
|
|
107
|
-
* @returns A multi-line Prolog string ready for use with `perspective.infer()`
|
|
108
|
-
*/
|
|
109
|
-
export function generatePrologFacts(ModelClass: typeof Ad4mModel): string {
|
|
110
|
-
const metadata = ModelClass.getModelMetadata();
|
|
111
|
-
const predicateName = toSnakeCase(metadata.className);
|
|
112
|
-
const lines: string[] = [];
|
|
113
|
-
|
|
114
|
-
lines.push(`% ${metadata.className} — generated Prolog facts`);
|
|
115
|
-
|
|
116
|
-
// Instance recognizer
|
|
117
|
-
const instanceClause = buildInstanceClause(predicateName, metadata);
|
|
118
|
-
if (instanceClause) {
|
|
119
|
-
lines.push("");
|
|
120
|
-
lines.push(`% Instance recognizer`);
|
|
121
|
-
lines.push(instanceClause);
|
|
122
|
-
}
|
|
123
|
-
|
|
124
|
-
// Property getters
|
|
125
|
-
const propClauses = Object.values(metadata.properties)
|
|
126
|
-
.map((p) => buildPropertyClause(predicateName, p))
|
|
127
|
-
.filter((c): c is string => c !== null);
|
|
128
|
-
if (propClauses.length > 0) {
|
|
129
|
-
lines.push("");
|
|
130
|
-
lines.push(`% Field getters`);
|
|
131
|
-
lines.push(...propClauses);
|
|
132
|
-
}
|
|
133
|
-
|
|
134
|
-
// Relation getters
|
|
135
|
-
const relClauses = Object.values(metadata.relations)
|
|
136
|
-
.map((c) => buildRelationClause(predicateName, c))
|
|
137
|
-
.filter((c): c is string => c !== null);
|
|
138
|
-
if (relClauses.length > 0) {
|
|
139
|
-
lines.push("");
|
|
140
|
-
lines.push(`% Relation getters`);
|
|
141
|
-
lines.push(...relClauses);
|
|
142
|
-
}
|
|
143
|
-
|
|
144
|
-
return lines.join("\n");
|
|
145
|
-
}
|
|
@@ -1,148 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Prolog query building helpers for the Ad4mModel query pipeline.
|
|
3
|
-
*
|
|
4
|
-
* These pure functions translate the Ad4mModel `Query` DSL into Prolog clause
|
|
5
|
-
* fragments that are assembled by `Ad4mModel.queryToProlog()`.
|
|
6
|
-
*/
|
|
7
|
-
|
|
8
|
-
import type { Where, WhereCondition, Order, ParentScope } from "./types";
|
|
9
|
-
import { capitalize } from "./util";
|
|
10
|
-
|
|
11
|
-
// ── Query clause builders ────────────────────────────────────────────────────
|
|
12
|
-
|
|
13
|
-
export function buildParentQuery(
|
|
14
|
-
parent: ParentScope | undefined,
|
|
15
|
-
resolvedPredicate?: string,
|
|
16
|
-
): string {
|
|
17
|
-
if (!parent || !resolvedPredicate) return '';
|
|
18
|
-
return `triple("${parent.id}", "${resolvedPredicate}", Base)`;
|
|
19
|
-
}
|
|
20
|
-
|
|
21
|
-
export function buildAuthorAndTimestampQuery(): string {
|
|
22
|
-
// Gets the author and timestamp of a Ad4mModel instance (based on the first link mentioning the base)
|
|
23
|
-
return `
|
|
24
|
-
findall(
|
|
25
|
-
[T, A],
|
|
26
|
-
link(Base, _, _, T, A),
|
|
27
|
-
AllLinks
|
|
28
|
-
),
|
|
29
|
-
sort(AllLinks, SortedLinks),
|
|
30
|
-
SortedLinks = [[Timestamp, Author]|_]
|
|
31
|
-
`;
|
|
32
|
-
}
|
|
33
|
-
|
|
34
|
-
export function buildPropertiesQuery(properties?: string[]): string {
|
|
35
|
-
// Gets the name, value, and resolve boolean for all (or some) properties on a Ad4mModel instance
|
|
36
|
-
// Resolves literals (if property_resolve/2 is true) to their value - either the data field if it is
|
|
37
|
-
// an Expression in JSON literal, or the direct literal value if it is a simple literal
|
|
38
|
-
// If no properties are provided, all are included
|
|
39
|
-
return `
|
|
40
|
-
findall([PropertyName, PropertyValue, Resolve], (
|
|
41
|
-
% Constrain to specified properties if provided
|
|
42
|
-
${properties ? `member(PropertyName, [${properties.map((name) => `"${name}"`).join(", ")}]),` : ""}
|
|
43
|
-
resolve_property(SubjectClass, Base, PropertyName, PropertyValue, Resolve)
|
|
44
|
-
), Properties)
|
|
45
|
-
`;
|
|
46
|
-
}
|
|
47
|
-
|
|
48
|
-
export function buildWhereQuery(where: Where = {}): string {
|
|
49
|
-
// Constrains the query to instances that match the provided where conditions
|
|
50
|
-
// 'id' maps to the Prolog 'Base' variable (the base expression of the instance).
|
|
51
|
-
|
|
52
|
-
function formatValue(value) {
|
|
53
|
-
// Wrap strings in quotes
|
|
54
|
-
return typeof value === "string" ? `"${value}"` : value;
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
return (Object.entries(where) as [string, WhereCondition][])
|
|
58
|
-
.map(([key, value]) => {
|
|
59
|
-
const isSpecial = ["id", "author", "timestamp"].includes(key);
|
|
60
|
-
const getter = `resolve_property(SubjectClass, Base, "${key}", Value${key}, _)`;
|
|
61
|
-
// For 'id' the Prolog variable is always 'Base'
|
|
62
|
-
const field = key === "id" ? "Base" : capitalize(key);
|
|
63
|
-
|
|
64
|
-
// Handle direct array values (for IN conditions)
|
|
65
|
-
if (Array.isArray(value)) {
|
|
66
|
-
const formattedValues = value.map((v) => formatValue(v)).join(", ");
|
|
67
|
-
if (isSpecial) return `member(${field}, [${formattedValues}])`;
|
|
68
|
-
else return `${getter}, member(Value${key}, [${formattedValues}])`;
|
|
69
|
-
}
|
|
70
|
-
|
|
71
|
-
// Handle operation object
|
|
72
|
-
if (typeof value === "object" && value !== null) {
|
|
73
|
-
const { not, between, lt, lte, gt, gte } = value;
|
|
74
|
-
|
|
75
|
-
// Handle NOT operation
|
|
76
|
-
if (not !== undefined) {
|
|
77
|
-
if (Array.isArray(not)) {
|
|
78
|
-
// NOT IN array
|
|
79
|
-
const formattedValues = not.map((v) => formatValue(v)).join(", ");
|
|
80
|
-
if (isSpecial) return `\\+ member(${field}, [${formattedValues}])`;
|
|
81
|
-
else return `${getter}, \\+ member(Value${key}, [${formattedValues}])`;
|
|
82
|
-
} else {
|
|
83
|
-
// NOT EQUAL
|
|
84
|
-
if (isSpecial) return `${field} \\= ${formatValue(not)}`;
|
|
85
|
-
else return `${getter}, Value${key} \\= ${formatValue(not)}`;
|
|
86
|
-
}
|
|
87
|
-
}
|
|
88
|
-
|
|
89
|
-
// Handle BETWEEN
|
|
90
|
-
if (between !== undefined && Array.isArray(between) && between.length === 2) {
|
|
91
|
-
if (isSpecial) return `${field} >= ${between[0]}, ${field} =< ${between[1]}`;
|
|
92
|
-
else return `${getter}, Value${key} >= ${between[0]}, Value${key} =< ${between[1]}`;
|
|
93
|
-
}
|
|
94
|
-
|
|
95
|
-
// Handle lt, lte, gt, & gte operations
|
|
96
|
-
const operators = [
|
|
97
|
-
{ value: lt, symbol: "<" }, // LESS THAN
|
|
98
|
-
{ value: lte, symbol: "=<" }, // LESS THAN OR EQUAL TO
|
|
99
|
-
{ value: gt, symbol: ">" }, // GREATER THAN
|
|
100
|
-
{ value: gte, symbol: ">=" }, // GREATER THAN OR EQUAL TO
|
|
101
|
-
];
|
|
102
|
-
|
|
103
|
-
for (const { value, symbol } of operators) {
|
|
104
|
-
if (value !== undefined)
|
|
105
|
-
return isSpecial ? `${field} ${symbol} ${value}` : `${getter}, Value${key} ${symbol} ${value}`;
|
|
106
|
-
}
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
// Default to direct equality
|
|
110
|
-
if (isSpecial) return `${field} = ${formatValue(value)}`;
|
|
111
|
-
else return `${getter}, Value${key} = ${formatValue(value)}`;
|
|
112
|
-
})
|
|
113
|
-
.join(", ");
|
|
114
|
-
}
|
|
115
|
-
|
|
116
|
-
export function buildCountQuery(count?: boolean): string {
|
|
117
|
-
return count ? "length(UnsortedInstances, TotalCount)" : "";
|
|
118
|
-
}
|
|
119
|
-
|
|
120
|
-
export function buildOrderQuery(order?: Order): string {
|
|
121
|
-
if (!order) return "SortedInstances = UnsortedInstances";
|
|
122
|
-
const entries = Object.entries(order);
|
|
123
|
-
if (entries.length === 1) {
|
|
124
|
-
const [propertyName, direction] = entries[0];
|
|
125
|
-
return `sort_instances(UnsortedInstances, "${propertyName}", "${direction}", SortedInstances)`;
|
|
126
|
-
}
|
|
127
|
-
// Multi-field sort: sort from least-significant to most-significant key
|
|
128
|
-
// so that the final (primary) sort preserves secondary-key ordering for equal values.
|
|
129
|
-
// The merge_sort implementation is stable (equal elements keep original order).
|
|
130
|
-
const clauses: string[] = [];
|
|
131
|
-
for (let i = entries.length - 1; i >= 0; i--) {
|
|
132
|
-
const [propertyName, direction] = entries[i];
|
|
133
|
-
const inputVar = i === entries.length - 1 ? "UnsortedInstances" : `MultiSortIntermediate${i + 1}`;
|
|
134
|
-
const outputVar = i === 0 ? "SortedInstances" : `MultiSortIntermediate${i}`;
|
|
135
|
-
clauses.push(`sort_instances(${inputVar}, "${propertyName}", "${direction}", ${outputVar})`);
|
|
136
|
-
}
|
|
137
|
-
return clauses.join(",\n ");
|
|
138
|
-
}
|
|
139
|
-
|
|
140
|
-
export function buildOffsetQuery(offset?: number): string {
|
|
141
|
-
if (!offset || offset < 0) return "InstancesWithOffset = SortedInstances";
|
|
142
|
-
return `skipN(SortedInstances, ${offset}, InstancesWithOffset)`;
|
|
143
|
-
}
|
|
144
|
-
|
|
145
|
-
export function buildLimitQuery(limit?: number): string {
|
|
146
|
-
if (!limit || limit < 0) return "AllInstances = InstancesWithOffset";
|
|
147
|
-
return `takeN(InstancesWithOffset, ${limit}, AllInstances)`;
|
|
148
|
-
}
|