@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
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
import { PerspectiveProxy } from "../perspectives/PerspectiveProxy";
|
|
2
|
+
import type { SHACLShape } from "../shacl/SHACLShape";
|
|
2
3
|
import type { JSONSchema, JSONSchemaToModelOptions } from "./json-schema";
|
|
3
4
|
import { ModelQueryBuilder } from "./ModelQueryBuilder";
|
|
4
|
-
import type { ParentScope, IncludeMap, Query, GetOptions,
|
|
5
|
+
import type { ParentScope, IncludeMap, Query, GetOptions, ResultsWithTotalCount, PaginationResult, ModelMetadata } from "./types";
|
|
5
6
|
/**
|
|
6
7
|
* Base class for defining data models in AD4M.
|
|
7
8
|
*
|
|
@@ -105,6 +106,11 @@ export declare class Ad4mModel {
|
|
|
105
106
|
author: string;
|
|
106
107
|
createdAt: any;
|
|
107
108
|
updatedAt: any;
|
|
109
|
+
/**
|
|
110
|
+
* Backwards compatibility alias for createdAt.
|
|
111
|
+
* @deprecated Use createdAt instead. This will be removed in a future version.
|
|
112
|
+
*/
|
|
113
|
+
get timestamp(): any;
|
|
108
114
|
private static classNamesByClass;
|
|
109
115
|
/**
|
|
110
116
|
* Generates the SDNA (Subject DNA) Prolog rules for this model class.
|
|
@@ -126,11 +132,6 @@ export declare class Ad4mModel {
|
|
|
126
132
|
name: string;
|
|
127
133
|
};
|
|
128
134
|
static getClassName(perspective: PerspectiveProxy): Promise<string>;
|
|
129
|
-
/**
|
|
130
|
-
* Backwards compatibility alias for createdAt.
|
|
131
|
-
* @deprecated Use createdAt instead. This will be removed in a future version.
|
|
132
|
-
*/
|
|
133
|
-
get timestamp(): any;
|
|
134
135
|
/**
|
|
135
136
|
* Extracts metadata from decorators for query building.
|
|
136
137
|
*
|
|
@@ -192,10 +193,6 @@ export declare class Ad4mModel {
|
|
|
192
193
|
* The unique identifier (expression URI) of this model instance.
|
|
193
194
|
*/
|
|
194
195
|
get id(): string;
|
|
195
|
-
/**
|
|
196
|
-
* @deprecated Use `.id` instead. Will be removed in a future version.
|
|
197
|
-
*/
|
|
198
|
-
get baseExpression(): string;
|
|
199
196
|
/**
|
|
200
197
|
* Protected getter for the perspective.
|
|
201
198
|
* Allows subclasses to access the perspective while keeping it private from external code.
|
|
@@ -221,11 +218,6 @@ export declare class Ad4mModel {
|
|
|
221
218
|
* @private
|
|
222
219
|
*/
|
|
223
220
|
private generateRelationAction;
|
|
224
|
-
/**
|
|
225
|
-
* Assigns decoded Prolog property values to an instance.
|
|
226
|
-
* Delegates to the standalone function in hydration.ts.
|
|
227
|
-
*/
|
|
228
|
-
static assignValuesToInstance(perspective: PerspectiveProxy, instance: Ad4mModel, values: ValueTuple[]): Promise<void>;
|
|
229
221
|
/**
|
|
230
222
|
* @param includedRelations Controls which relation fields are recorded
|
|
231
223
|
* in the snapshot for dirty-tracking:
|
|
@@ -268,7 +260,6 @@ export declare class Ad4mModel {
|
|
|
268
260
|
*/
|
|
269
261
|
changedFields(): string[];
|
|
270
262
|
private getData;
|
|
271
|
-
static queryToProlog(perspective: PerspectiveProxy, query: Query, modelClassName?: string | null): Promise<string>;
|
|
272
263
|
/**
|
|
273
264
|
* Generates a SPARQL query from a Query object.
|
|
274
265
|
*
|
|
@@ -306,18 +297,31 @@ export declare class Ad4mModel {
|
|
|
306
297
|
* ```
|
|
307
298
|
*/
|
|
308
299
|
static queryToSPARQL(perspective: PerspectiveProxy, query: Query): Promise<string>;
|
|
309
|
-
static instancesFromPrologResult<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query: Query, result: AllInstancesResult): Promise<ResultsWithTotalCount<T>>;
|
|
310
300
|
/**
|
|
311
|
-
*
|
|
301
|
+
* Build the JSON parameters needed for a model query/subscription endpoint.
|
|
302
|
+
* Returns the className, queryJson, and shapeJson that the Rust executor expects.
|
|
303
|
+
* @internal
|
|
304
|
+
*/
|
|
305
|
+
static prepareModelQueryParams(query?: Query, classNameOverride?: string | null): {
|
|
306
|
+
className: string;
|
|
307
|
+
queryJson: string;
|
|
308
|
+
shapeJson: string;
|
|
309
|
+
};
|
|
310
|
+
/**
|
|
311
|
+
* Parse raw model query/subscription result JSON into typed model instances.
|
|
312
|
+
* Used by ModelQueryBuilder to convert subscription updates without circular imports.
|
|
313
|
+
* @internal
|
|
314
|
+
*/
|
|
315
|
+
static parseModelResult<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, raw: any, include?: IncludeMap, properties?: string[]): T[];
|
|
316
|
+
/**
|
|
317
|
+
* Execute a model query via the executor-side endpoint.
|
|
312
318
|
*
|
|
313
|
-
*
|
|
314
|
-
*
|
|
315
|
-
* @param result - Array of result objects from SPARQL
|
|
316
|
-
* @returns Promise resolving to results with total count
|
|
319
|
+
* This replaces the old SPARQL-build → hydrate → JS-filter → JS-sort → JS-paginate pipeline
|
|
320
|
+
* with a single RPC to the executor that handles everything in Rust.
|
|
317
321
|
*
|
|
318
322
|
* @internal
|
|
319
323
|
*/
|
|
320
|
-
static
|
|
324
|
+
private static executeModelQuery;
|
|
321
325
|
/**
|
|
322
326
|
* Gets all instances of the model in the perspective that match the query params.
|
|
323
327
|
*
|
|
@@ -345,7 +349,7 @@ export declare class Ad4mModel {
|
|
|
345
349
|
* const recipesProlog = await Recipe.findAll(perspective, {}, false);
|
|
346
350
|
* ```
|
|
347
351
|
*/
|
|
348
|
-
static findAll<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query,
|
|
352
|
+
static findAll<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query, _engine?: 'sparql' | 'prolog' | boolean): Promise<T[]>;
|
|
349
353
|
/**
|
|
350
354
|
* Finds the first instance matching the query, or `null` if none exists.
|
|
351
355
|
*
|
|
@@ -366,7 +370,7 @@ export declare class Ad4mModel {
|
|
|
366
370
|
* }
|
|
367
371
|
* ```
|
|
368
372
|
*/
|
|
369
|
-
static findOne<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query,
|
|
373
|
+
static findOne<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query, _engine?: 'sparql' | 'prolog' | boolean): Promise<T | null>;
|
|
370
374
|
/**
|
|
371
375
|
* Gets all instances with count of total matches without offset & limit applied.
|
|
372
376
|
*
|
|
@@ -387,7 +391,7 @@ export declare class Ad4mModel {
|
|
|
387
391
|
* const { results, totalCount } = await Recipe.findAllAndCount(perspective, {}, false);
|
|
388
392
|
* ```
|
|
389
393
|
*/
|
|
390
|
-
static findAllAndCount<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query,
|
|
394
|
+
static findAllAndCount<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, query?: Query, _engine?: 'sparql' | 'prolog' | boolean): Promise<ResultsWithTotalCount<T>>;
|
|
391
395
|
/**
|
|
392
396
|
* Helper function for pagination with explicit page size and number.
|
|
393
397
|
*
|
|
@@ -395,7 +399,6 @@ export declare class Ad4mModel {
|
|
|
395
399
|
* @param pageSize - Number of items per page
|
|
396
400
|
* @param pageNumber - Which page to retrieve (1-based)
|
|
397
401
|
* @param query - Optional additional query parameters
|
|
398
|
-
* @param useSPARQL - Whether to use SPARQL (default: true, 10-100x faster) or Prolog (legacy)
|
|
399
402
|
* @returns Paginated results with metadata
|
|
400
403
|
*
|
|
401
404
|
* @example
|
|
@@ -404,13 +407,9 @@ export declare class Ad4mModel {
|
|
|
404
407
|
* where: { category: "Main Course" }
|
|
405
408
|
* });
|
|
406
409
|
* console.log(`Page ${page.pageNumber} of recipes, ${page.results.length} items`);
|
|
407
|
-
*
|
|
408
|
-
* // Use Prolog explicitly (legacy)
|
|
409
|
-
* const pageProlog = await Recipe.paginate(perspective, 10, 1, {}, false);
|
|
410
410
|
* ```
|
|
411
411
|
*/
|
|
412
|
-
static paginate<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, pageSize: number, pageNumber: number, query?: Query,
|
|
413
|
-
static countQueryToProlog(perspective: PerspectiveProxy, query?: Query, modelClassName?: string | null): Promise<string>;
|
|
412
|
+
static paginate<T extends Ad4mModel>(this: typeof Ad4mModel & (new (...args: any[]) => T), perspective: PerspectiveProxy, pageSize: number, pageNumber: number, query?: Query, _engine?: 'sparql' | 'prolog' | boolean): Promise<PaginationResult<T>>;
|
|
414
413
|
/**
|
|
415
414
|
* Generates a SPARQL COUNT query for the model.
|
|
416
415
|
*
|
|
@@ -420,13 +419,11 @@ export declare class Ad4mModel {
|
|
|
420
419
|
*
|
|
421
420
|
* @private
|
|
422
421
|
*/
|
|
423
|
-
static countQueryToSPARQL(perspective: PerspectiveProxy, query: Query): Promise<string>;
|
|
424
422
|
/**
|
|
425
423
|
* Gets a count of all matching instances.
|
|
426
424
|
*
|
|
427
425
|
* @param perspective - The perspective to search in
|
|
428
426
|
* @param query - Optional query parameters to filter results
|
|
429
|
-
* @param useSPARQL - Whether to use SPARQL (default: true, 10-100x faster) or Prolog (legacy)
|
|
430
427
|
* @returns Total count of matching entities
|
|
431
428
|
*
|
|
432
429
|
* @example
|
|
@@ -435,12 +432,9 @@ export declare class Ad4mModel {
|
|
|
435
432
|
* const activeRecipes = await Recipe.count(perspective, {
|
|
436
433
|
* where: { status: "active" }
|
|
437
434
|
* });
|
|
438
|
-
*
|
|
439
|
-
* // Use Prolog explicitly (legacy)
|
|
440
|
-
* const countProlog = await Recipe.count(perspective, {}, false);
|
|
441
435
|
* ```
|
|
442
436
|
*/
|
|
443
|
-
static count(perspective: PerspectiveProxy, query?: Query
|
|
437
|
+
static count(perspective: PerspectiveProxy, query?: Query): Promise<number>;
|
|
444
438
|
private setProperty;
|
|
445
439
|
/** Resolve a relation argument to a plain string ID. Accepts either a raw
|
|
446
440
|
* string ID or an Ad4mModel instance (in which case `.id` is used). */
|
|
@@ -477,6 +471,30 @@ export declare class Ad4mModel {
|
|
|
477
471
|
save(batchId?: string): Promise<void>;
|
|
478
472
|
private cleanCopy;
|
|
479
473
|
private innerUpdate;
|
|
474
|
+
/**
|
|
475
|
+
* Evaluate SPARQL getters for a batch of instances on demand.
|
|
476
|
+
*
|
|
477
|
+
* Use after a shallow collection query (the default) to resolve
|
|
478
|
+
* getter-backed properties for visible items only. This avoids the
|
|
479
|
+
* O(N × getters) cost of evaluating every getter on every instance in
|
|
480
|
+
* a large collection query.
|
|
481
|
+
*
|
|
482
|
+
* @param instances - Array of model instances to evaluate getters on
|
|
483
|
+
* @param perspective - The perspective to query against
|
|
484
|
+
* @param propertyNames - Optional list of getter-backed property names to evaluate.
|
|
485
|
+
* If omitted, all getters are evaluated.
|
|
486
|
+
*
|
|
487
|
+
* @example
|
|
488
|
+
* ```typescript
|
|
489
|
+
* const messages = await Message.findAll(perspective, { parent: channel, limit: 30 });
|
|
490
|
+
* // messages[i].replyingTo is undefined (getter skipped by default)
|
|
491
|
+
*
|
|
492
|
+
* // Evaluate getters for the visible subset
|
|
493
|
+
* await Message.evaluateGetters(messages.slice(0, 10), perspective, ['replyingTo']);
|
|
494
|
+
* // messages[0..9].replyingTo is now populated
|
|
495
|
+
* ```
|
|
496
|
+
*/
|
|
497
|
+
static evaluateGetters<T extends Ad4mModel>(instances: T[], perspective: PerspectiveProxy, propertyNames?: string[]): Promise<void>;
|
|
480
498
|
/**
|
|
481
499
|
* Gets the model instance with all properties and relations populated.
|
|
482
500
|
*
|
|
@@ -724,4 +742,29 @@ export declare class Ad4mModel {
|
|
|
724
742
|
* @throws Error when namespace cannot be inferred
|
|
725
743
|
*/
|
|
726
744
|
static fromJSONSchema(schema: JSONSchema, options: JSONSchemaToModelOptions): typeof Ad4mModel;
|
|
745
|
+
/**
|
|
746
|
+
* Creates a fully functional Ad4mModel subclass from a SHACL shape.
|
|
747
|
+
*
|
|
748
|
+
* Unlike `fromJSONSchema()`, no predicate inference is required —
|
|
749
|
+
* `SHACLShape` already contains the exact predicate URI in `path` for
|
|
750
|
+
* every property. The method reads each property's `path`, `maxCount`,
|
|
751
|
+
* `writable`, and `resolveLanguage` directly and writes them to the
|
|
752
|
+
* WeakMap metadata registries.
|
|
753
|
+
*
|
|
754
|
+
* Properties with `hasValue` (flag / type-discrimination markers) are
|
|
755
|
+
* registered as hidden flag entries so that the SPARQL query builder emits
|
|
756
|
+
* the fixed triple `?source <predicate> <value>` needed for type discrimination.
|
|
757
|
+
* Properties without a `name` field are skipped.
|
|
758
|
+
*
|
|
759
|
+
* **Backward-compat:** Old Flux SHACL shapes (created before `sh:hasValue`
|
|
760
|
+
* was persisted on property shapes) carry the flag value only in
|
|
761
|
+
* `shape.constructor_actions` as the `target` of an `addLink` action.
|
|
762
|
+
* This method recovers those values so that old perspectives are queried
|
|
763
|
+
* with the correct type-discriminator triple.
|
|
764
|
+
*
|
|
765
|
+
* @param shape - SHACL node shape (as returned by `PerspectiveProxy.getAllShacl()`)
|
|
766
|
+
* @param name - Class name to assign (e.g. "Channel")
|
|
767
|
+
* @returns Generated Ad4mModel subclass, ready for querying
|
|
768
|
+
*/
|
|
769
|
+
static fromSHACL(shape: SHACLShape, name: string): typeof Ad4mModel;
|
|
727
770
|
}
|