@coasys/ad4m 0.12.0-rc1-dev.2 → 0.12.0-rc1-dev.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/jest.config.js +10 -3
- package/lib/index.cjs +6872 -5886
- package/lib/index.js +6868 -5874
- package/lib/src/Ad4mClient.d.ts +9 -16
- package/lib/src/Ad4mClient.js +46 -25
- package/lib/src/Literal.d.ts +1 -2
- package/lib/src/Literal.js +38 -35
- package/lib/src/SmartLiteral.d.ts +1 -2
- package/lib/src/SmartLiteral.js +30 -15
- package/lib/src/agent/AgentClient.d.ts +1 -4
- package/lib/src/agent/AgentClient.js +79 -99
- package/lib/src/ai/AIClient.d.ts +1 -2
- package/lib/src/ai/AIClient.js +224 -220
- package/lib/src/expression/ExpressionClient.d.ts +1 -1
- package/lib/src/expression/ExpressionClient.js +73 -86
- package/lib/src/index.d.ts +1 -1
- package/lib/src/index.js +1 -1
- package/lib/src/language/LanguageClient.d.ts +1 -1
- package/lib/src/language/LanguageClient.js +52 -52
- package/lib/src/model/Ad4mModel.d.ts +1351 -144
- package/lib/src/model/Ad4mModel.js +3737 -228
- package/lib/src/model/Ad4mModel.test.js +522 -979
- package/lib/src/model/Subject.d.ts +3 -3
- package/lib/src/model/Subject.js +25 -25
- package/lib/src/model/decorators.d.ts +444 -100
- package/lib/src/model/decorators.js +686 -321
- package/lib/src/model/util.d.ts +6 -6
- package/lib/src/model/util.js +24 -24
- package/lib/src/neighbourhood/NeighbourhoodClient.d.ts +1 -5
- package/lib/src/neighbourhood/NeighbourhoodClient.js +179 -242
- package/lib/src/neighbourhood/NeighbourhoodProxy.d.ts +1 -2
- package/lib/src/neighbourhood/NeighbourhoodProxy.js +28 -13
- package/lib/src/neighbourhood/NeighbourhoodProxy.test.js +5 -1
- package/lib/src/perspectives/PerspectiveClient.d.ts +9 -9
- package/lib/src/perspectives/PerspectiveClient.js +240 -316
- package/lib/src/perspectives/PerspectiveProxy.d.ts +99 -61
- package/lib/src/perspectives/PerspectiveProxy.js +485 -832
- package/lib/src/runtime/RuntimeClient.d.ts +1 -5
- package/lib/src/runtime/RuntimeClient.js +238 -412
- package/lib/src/shacl/SHACLFlow.test.js +105 -164
- package/lib/src/shacl/SHACLShape.d.ts +12 -17
- package/lib/src/shacl/SHACLShape.js +115 -128
- package/lib/src/shacl/SHACLShape.test.js +176 -244
- package/lib/src/shims/reflect-metadata.d.ts +0 -0
- package/lib/src/shims/type-graphql.d.ts +32 -0
- package/lib/src/src/Ad4mClient.d.ts +28 -0
- package/lib/src/src/Address.d.ts +1 -0
- package/lib/src/src/DID.d.ts +1 -0
- package/lib/src/src/Exception.d.ts +7 -0
- package/lib/src/src/Literal.d.ts +7 -0
- package/lib/src/src/PubSub.d.ts +17 -0
- package/lib/src/src/SmartLiteral.d.ts +12 -0
- package/lib/src/src/agent/Agent.d.ts +110 -0
- package/lib/src/src/agent/AgentClient.d.ts +62 -0
- package/lib/src/src/agent/AgentResolver.d.ts +30 -0
- package/lib/src/src/agent/AgentStatus.d.ts +8 -0
- package/lib/src/src/ai/AIClient.d.ts +32 -0
- package/lib/src/src/ai/AIResolver.d.ts +75 -0
- package/lib/src/src/ai/Tasks.d.ts +37 -0
- package/lib/src/src/buildSchema.d.ts +1 -0
- package/lib/src/src/expression/Expression.d.ts +28 -0
- package/lib/src/src/expression/ExpressionClient.d.ts +13 -0
- package/lib/src/src/expression/ExpressionRef.d.ts +9 -0
- package/lib/src/src/expression/ExpressionResolver.d.ts +10 -0
- package/lib/src/src/index.d.ts +35 -0
- package/lib/src/src/jestSetup.d.ts +1 -0
- package/lib/src/src/language/Icon.d.ts +4 -0
- package/lib/src/src/language/Language.d.ts +206 -0
- package/lib/src/src/language/LanguageClient.d.ts +17 -0
- package/lib/src/src/language/LanguageContext.d.ts +37 -0
- package/lib/src/src/language/LanguageHandle.d.ts +9 -0
- package/lib/src/src/language/LanguageMeta.d.ts +35 -0
- package/lib/src/src/language/LanguageRef.d.ts +6 -0
- package/lib/src/src/language/LanguageResolver.d.ts +19 -0
- package/lib/src/src/links/Links.d.ts +39 -0
- package/lib/src/src/links/Links.test.d.ts +1 -0
- package/lib/src/src/model/Ad4mModel.d.ts +1438 -0
- package/lib/src/src/model/Ad4mModel.test.d.ts +1 -0
- package/lib/src/src/model/Subject.d.ts +25 -0
- package/lib/src/src/model/decorators.d.ts +545 -0
- package/lib/src/src/model/util.d.ts +12 -0
- package/lib/src/src/neighbourhood/Neighbourhood.d.ts +10 -0
- package/lib/src/src/neighbourhood/NeighbourhoodClient.d.ts +25 -0
- package/lib/src/src/neighbourhood/NeighbourhoodProxy.d.ts +19 -0
- package/lib/src/src/neighbourhood/NeighbourhoodProxy.test.d.ts +1 -0
- package/lib/src/src/neighbourhood/NeighbourhoodResolver.d.ts +24 -0
- package/lib/src/src/perspectives/LinkQuery.d.ts +11 -0
- package/lib/src/src/perspectives/Perspective.d.ts +38 -0
- package/lib/src/src/perspectives/Perspective.test.d.ts +1 -0
- package/lib/src/src/perspectives/PerspectiveClient.d.ts +97 -0
- package/lib/src/src/perspectives/PerspectiveDiff.d.ts +9 -0
- package/lib/src/src/perspectives/PerspectiveHandle.d.ts +18 -0
- package/lib/src/src/perspectives/PerspectiveProxy.d.ts +865 -0
- package/lib/src/src/perspectives/PerspectiveResolver.d.ts +57 -0
- package/lib/src/src/runtime/RuntimeClient.d.ts +56 -0
- package/lib/src/src/runtime/RuntimeResolver.d.ts +132 -0
- package/lib/src/src/shacl/SHACLFlow.d.ts +171 -0
- package/lib/src/src/shacl/SHACLFlow.test.d.ts +1 -0
- package/lib/src/src/shacl/SHACLShape.d.ts +117 -0
- package/lib/src/src/shacl/SHACLShape.test.d.ts +1 -0
- package/lib/src/src/typeDefs.d.ts +1 -0
- package/lib/src/src/unwrapApolloResult.d.ts +2 -0
- package/lib/src/src/utils.d.ts +25 -0
- package/lib/src/utils.d.ts +0 -8
- package/lib/src/utils.js +7 -21
- package/package.json +15 -14
- package/src/Ad4mClient.test.ts +1315 -1564
- package/src/Ad4mClient.ts +54 -55
- package/src/Literal.test.ts +26 -45
- package/src/Literal.ts +66 -82
- package/src/SmartLiteral.ts +58 -74
- package/src/agent/AgentClient.ts +99 -144
- package/src/ai/AIClient.ts +359 -409
- package/src/expression/ExpressionClient.ts +96 -142
- package/src/index.ts +1 -1
- package/src/language/LanguageClient.ts +113 -137
- package/src/model/Ad4mModel.test.ts +616 -1114
- package/src/model/Ad4mModel.ts +4361 -451
- package/src/model/Subject.ts +159 -0
- package/src/model/decorators.ts +1168 -667
- package/src/model/util.ts +54 -53
- package/src/neighbourhood/NeighbourhoodClient.ts +266 -392
- package/src/neighbourhood/NeighbourhoodProxy.test.ts +7 -3
- package/src/neighbourhood/NeighbourhoodProxy.ts +40 -58
- package/src/perspectives/PerspectiveClient.ts +540 -779
- package/src/perspectives/PerspectiveProxy.ts +2067 -2860
- package/src/runtime/RuntimeClient.ts +476 -775
- package/src/shacl/SHACLFlow.test.ts +129 -196
- package/src/shacl/SHACLShape.test.ts +190 -284
- package/src/shacl/SHACLShape.ts +200 -224
- package/src/utils.ts +17 -31
- package/tsconfig.json +10 -9
- package/src/model/IMPROVEMENTS.md +0 -482
- package/src/model/PREDICATE_COLLISION_FIX.md +0 -651
- package/src/model/README.md +0 -317
- package/src/model/SHACL_MUTATION_DECOUPLING.md +0 -356
- package/src/model/SUBSCRIPTION_STRATEGY.md +0 -317
- package/src/model/TC39_STAGE_3_DECORATORS.md +0 -609
- package/src/model/mutation.ts +0 -461
- package/src/model/parentUtils.ts +0 -91
- package/src/model/prolog/generatePrologFacts.ts +0 -176
- package/src/model/prolog/index.ts +0 -1
- package/src/model/query/ModelQueryBuilder.ts +0 -173
- package/src/model/query/fetchInstance.ts +0 -181
- package/src/model/query/hydration.ts +0 -273
- package/src/model/query/operations.ts +0 -510
- package/src/model/query/snapshot.ts +0 -126
- package/src/model/query/surrealCompiler.ts +0 -376
- package/src/model/schema/fromJSONSchema.ts +0 -411
- package/src/model/schema/metadata.ts +0 -148
- package/src/model/subscription.ts +0 -307
- package/src/model/transaction.ts +0 -60
- package/src/model/types.ts +0 -207
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import { Link, LinkExpression, LinkExpressionInput, LinkInput } from "../links/Links";
|
|
2
|
+
import { LinkQuery } from "./LinkQuery";
|
|
3
|
+
/** A Perspective represents subjective meaning, encoded through
|
|
4
|
+
* associations between expressions, a.k.a. Links, that is a graph
|
|
5
|
+
* over the objective Expressions of any subset of Languages.
|
|
6
|
+
*
|
|
7
|
+
* This type represents the clean onotological concept of a Perspective.
|
|
8
|
+
* An instance of this class can be regarded as an immutable snapshot of
|
|
9
|
+
* a mutable perspective.
|
|
10
|
+
*
|
|
11
|
+
* The types PerspectiveProxy and PerspectiveHandle are used when dealing
|
|
12
|
+
* with an instantiated mutable perspective as is done through most of
|
|
13
|
+
* the GraphQL mutations.
|
|
14
|
+
*/
|
|
15
|
+
export declare class Perspective {
|
|
16
|
+
/** The content of the perspective, a list/graph of links */
|
|
17
|
+
links: LinkExpression[];
|
|
18
|
+
constructor(links?: LinkExpression[]);
|
|
19
|
+
/** Convenience function for filtering links just like with PerspectiveProxy */
|
|
20
|
+
get(query: LinkQuery): LinkExpression[];
|
|
21
|
+
/** Convenience function to get the target of the first link that matches the given query
|
|
22
|
+
* This makes sense when the query is expected to return only one link
|
|
23
|
+
* and the target of that link is what you are looking for.
|
|
24
|
+
*/
|
|
25
|
+
getSingleTarget(query: LinkQuery): string | void;
|
|
26
|
+
}
|
|
27
|
+
export declare class PerspectiveInput {
|
|
28
|
+
links: LinkExpressionInput[];
|
|
29
|
+
}
|
|
30
|
+
export declare class PerspectiveUnsignedInput {
|
|
31
|
+
links: LinkInput[];
|
|
32
|
+
constructor(links?: LinkInput[]);
|
|
33
|
+
static fromLink(link: Link): PerspectiveUnsignedInput;
|
|
34
|
+
}
|
|
35
|
+
declare const PerspectiveExpression_base: any;
|
|
36
|
+
export declare class PerspectiveExpression extends PerspectiveExpression_base {
|
|
37
|
+
}
|
|
38
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import { ApolloClient } from "@apollo/client/core";
|
|
2
|
+
import { ExpressionRendered } from "../expression/Expression";
|
|
3
|
+
import { ExpressionClient } from "../expression/ExpressionClient";
|
|
4
|
+
import { Link, LinkExpressionInput, LinkExpression, LinkMutations, LinkExpressionMutations } from "../links/Links";
|
|
5
|
+
import { NeighbourhoodClient } from "../neighbourhood/NeighbourhoodClient";
|
|
6
|
+
import { NeighbourhoodProxy } from "../neighbourhood/NeighbourhoodProxy";
|
|
7
|
+
import { LinkQuery } from "./LinkQuery";
|
|
8
|
+
import { Perspective } from "./Perspective";
|
|
9
|
+
import { PerspectiveHandle, PerspectiveState } from "./PerspectiveHandle";
|
|
10
|
+
import { LinkStatus, PerspectiveProxy } from './PerspectiveProxy';
|
|
11
|
+
import { AIClient } from "../ai/AIClient";
|
|
12
|
+
import { AllInstancesResult } from "../model/Ad4mModel";
|
|
13
|
+
export type PerspectiveHandleCallback = (perspective: PerspectiveHandle) => null;
|
|
14
|
+
export type UuidCallback = (uuid: string) => null;
|
|
15
|
+
export type LinkCallback = (link: LinkExpression) => null;
|
|
16
|
+
export type SyncStateChangeCallback = (state: PerspectiveState) => null;
|
|
17
|
+
export declare class PerspectiveClient {
|
|
18
|
+
#private;
|
|
19
|
+
constructor(client: ApolloClient<any>, subscribe?: boolean);
|
|
20
|
+
setExpressionClient(client: ExpressionClient): void;
|
|
21
|
+
setNeighbourhoodClient(client: NeighbourhoodClient): void;
|
|
22
|
+
setAIClient(client: AIClient): void;
|
|
23
|
+
get aiClient(): AIClient;
|
|
24
|
+
all(): Promise<PerspectiveProxy[]>;
|
|
25
|
+
byUUID(uuid: string): Promise<PerspectiveProxy | null>;
|
|
26
|
+
snapshotByUUID(uuid: string): Promise<Perspective | null>;
|
|
27
|
+
publishSnapshotByUUID(uuid: string): Promise<string | null>;
|
|
28
|
+
queryLinks(uuid: string, query: LinkQuery): Promise<LinkExpression[]>;
|
|
29
|
+
queryProlog(uuid: string, query: string): Promise<any>;
|
|
30
|
+
/**
|
|
31
|
+
* Executes a read-only SurrealQL query against a perspective's link cache.
|
|
32
|
+
*
|
|
33
|
+
* Security: Only SELECT, RETURN, and other read-only queries are permitted.
|
|
34
|
+
* Mutating operations (DELETE, UPDATE, INSERT, etc.) are blocked.
|
|
35
|
+
*
|
|
36
|
+
* Note: GraphQL field name is "perspectiveQuerySurrealDb" (lowercase "b" in "Db")
|
|
37
|
+
* as generated from Rust method "perspective_query_surreal_db"
|
|
38
|
+
*/
|
|
39
|
+
querySurrealDB(uuid: string, query: string): Promise<any>;
|
|
40
|
+
subscribeQuery(uuid: string, query: string): Promise<{
|
|
41
|
+
subscriptionId: string;
|
|
42
|
+
result: AllInstancesResult;
|
|
43
|
+
isInit?: boolean;
|
|
44
|
+
}>;
|
|
45
|
+
perspectiveSubscribeSurrealQuery(uuid: string, query: string): Promise<{
|
|
46
|
+
subscriptionId: string;
|
|
47
|
+
result: AllInstancesResult;
|
|
48
|
+
isInit?: boolean;
|
|
49
|
+
}>;
|
|
50
|
+
perspectiveKeepAliveSurrealQuery(uuid: string, subscriptionId: string): Promise<boolean>;
|
|
51
|
+
perspectiveDisposeSurrealQuerySubscription(uuid: string, subscriptionId: string): Promise<boolean>;
|
|
52
|
+
subscribeToQueryUpdates(subscriptionId: string, onData: (result: AllInstancesResult) => void): () => void;
|
|
53
|
+
keepAliveQuery(uuid: string, subscriptionId: string): Promise<boolean>;
|
|
54
|
+
disposeQuerySubscription(uuid: string, subscriptionId: string): Promise<boolean>;
|
|
55
|
+
add(name: string): Promise<PerspectiveProxy>;
|
|
56
|
+
update(uuid: string, name: string): Promise<PerspectiveProxy>;
|
|
57
|
+
remove(uuid: string): Promise<{
|
|
58
|
+
perspectiveRemove: boolean;
|
|
59
|
+
}>;
|
|
60
|
+
addLink(uuid: string, link: Link, status?: LinkStatus, batchId?: string): Promise<LinkExpression>;
|
|
61
|
+
addLinks(uuid: string, links: Link[], status?: LinkStatus, batchId?: string): Promise<LinkExpression[]>;
|
|
62
|
+
removeLinks(uuid: string, links: LinkExpressionInput[], batchId?: string): Promise<LinkExpression[]>;
|
|
63
|
+
linkMutations(uuid: string, mutations: LinkMutations, status?: LinkStatus): Promise<LinkExpressionMutations>;
|
|
64
|
+
addLinkExpression(uuid: string, link: LinkExpression, status?: LinkStatus, batchId?: string): Promise<LinkExpression>;
|
|
65
|
+
updateLink(uuid: string, oldLink: LinkExpressionInput, newLink: Link, batchId?: string): Promise<LinkExpression>;
|
|
66
|
+
removeLink(uuid: string, link: LinkExpressionInput, batchId?: string): Promise<boolean>;
|
|
67
|
+
/**
|
|
68
|
+
* Adds Social DNA code to a perspective.
|
|
69
|
+
*
|
|
70
|
+
* Preferred usage: pass shaclJson (from SHACLShape.toJSON()) as the primary schema definition.
|
|
71
|
+
* The sdnaCode parameter is kept for backward compatibility but SHACL is the source of truth
|
|
72
|
+
* for all SDNA operations. Prolog engines remain available for complex queries.
|
|
73
|
+
*
|
|
74
|
+
* @param sdnaCode - Legacy Prolog code (pass empty string when using shaclJson)
|
|
75
|
+
* @param shaclJson - SHACL JSON string from SHACLShape.toJSON() (recommended)
|
|
76
|
+
*/
|
|
77
|
+
addSdna(uuid: string, name: string, sdnaCode: string | undefined, sdnaType: "subject_class" | "flow" | "custom", shaclJson?: string): Promise<boolean>;
|
|
78
|
+
executeCommands(uuid: string, commands: string, expression: string, parameters: string, batchId?: string): Promise<boolean>;
|
|
79
|
+
createSubject(uuid: string, subjectClass: string, expressionAddress: string, initialValues?: string, batchId?: string): Promise<boolean>;
|
|
80
|
+
getSubjectData(uuid: string, subjectClass: string, expressionAddress: string): Promise<string>;
|
|
81
|
+
getExpression(expressionURI: string): Promise<ExpressionRendered>;
|
|
82
|
+
createExpression(content: any, languageAddress: string): Promise<string>;
|
|
83
|
+
addPerspectiveAddedListener(cb: PerspectiveHandleCallback): void;
|
|
84
|
+
subscribePerspectiveAdded(): void;
|
|
85
|
+
addPerspectiveUpdatedListener(cb: PerspectiveHandleCallback): void;
|
|
86
|
+
subscribePerspectiveUpdated(): void;
|
|
87
|
+
addPerspectiveSyncedListener(cb: SyncStateChangeCallback): void;
|
|
88
|
+
addPerspectiveSyncStateChangeListener(uuid: String, cb: SyncStateChangeCallback[]): Promise<void>;
|
|
89
|
+
addPerspectiveRemovedListener(cb: UuidCallback): void;
|
|
90
|
+
subscribePerspectiveRemoved(): void;
|
|
91
|
+
addPerspectiveLinkAddedListener(uuid: String, cb: LinkCallback[]): Promise<void>;
|
|
92
|
+
addPerspectiveLinkRemovedListener(uuid: String, cb: LinkCallback[]): Promise<void>;
|
|
93
|
+
addPerspectiveLinkUpdatedListener(uuid: String, cb: LinkCallback[]): Promise<void>;
|
|
94
|
+
getNeighbourhoodProxy(uuid: string): NeighbourhoodProxy;
|
|
95
|
+
createBatch(uuid: string): Promise<string>;
|
|
96
|
+
commitBatch(uuid: string, batchId: string): Promise<LinkExpressionMutations>;
|
|
97
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { LinkExpression } from "../links/Links";
|
|
2
|
+
export declare class PerspectiveDiff {
|
|
3
|
+
additions: LinkExpression[];
|
|
4
|
+
removals: LinkExpression[];
|
|
5
|
+
}
|
|
6
|
+
declare const PerspectiveDiffExpression_base: any;
|
|
7
|
+
export declare class PerspectiveDiffExpression extends PerspectiveDiffExpression_base {
|
|
8
|
+
}
|
|
9
|
+
export {};
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { NeighbourhoodExpression } from "../neighbourhood/Neighbourhood";
|
|
2
|
+
export declare enum PerspectiveState {
|
|
3
|
+
Private = "PRIVATE",
|
|
4
|
+
NeighboudhoodCreationInitiated = "NEIGHBOURHOOD_CREATION_INITIATED",
|
|
5
|
+
NeighbourhoodJoinInitiated = "NEIGHBOURHOOD_JOIN_INITIATED",
|
|
6
|
+
LinkLanguageFailedToInstall = "LINK_LANGUAGE_FAILED_TO_INSTALL",
|
|
7
|
+
LinkLanguageInstalledButNotSynced = "LINK_LANGUAGE_INSTALLED_BUT_NOT_SYNCED",
|
|
8
|
+
Synced = "SYNCED"
|
|
9
|
+
}
|
|
10
|
+
export declare class PerspectiveHandle {
|
|
11
|
+
uuid: string;
|
|
12
|
+
name: string;
|
|
13
|
+
state: PerspectiveState;
|
|
14
|
+
sharedUrl?: string;
|
|
15
|
+
neighbourhood?: NeighbourhoodExpression;
|
|
16
|
+
owners?: string[];
|
|
17
|
+
constructor(uuid?: string, name?: string, state?: PerspectiveState);
|
|
18
|
+
}
|