@party-stack/ontology 0.16.2 → 0.16.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.
|
@@ -6,20 +6,36 @@ import type { PartialAttachmentMetadata } from "./attachments/types.js";
|
|
|
6
6
|
import type { Collection, CollectionConfig } from "@tanstack/db";
|
|
7
7
|
export type OntologyCollectionOptions = Omit<CollectionConfig<Record<string, unknown>, string | number>, "getKey">;
|
|
8
8
|
export interface OntologyAttachmentUpload {
|
|
9
|
+
/**
|
|
10
|
+
* The attachment referenced by the prepared action parameters. Its ID is an
|
|
11
|
+
* opaque local handle and is not guaranteed to be valid for the backend.
|
|
12
|
+
*/
|
|
9
13
|
attachment: v.attachment;
|
|
10
14
|
blob: Blob;
|
|
11
15
|
target?: AttachmentTypeDef;
|
|
12
16
|
}
|
|
13
17
|
export interface OntologyAttachmentIdMapping {
|
|
18
|
+
/** The opaque attachment ID used before the backend canonicalized it. */
|
|
14
19
|
localId: string;
|
|
20
|
+
/** The canonical attachment ID returned by the backend. */
|
|
15
21
|
remoteId: string;
|
|
16
22
|
}
|
|
17
23
|
export interface OntologyApplyActionResult {
|
|
24
|
+
/**
|
|
25
|
+
* Mappings for uploaded attachments whose canonical backend IDs differ from
|
|
26
|
+
* the local IDs supplied in `ApplyActionLiveOpts.attachmentUploads`.
|
|
27
|
+
*/
|
|
18
28
|
attachmentIdMappings?: OntologyAttachmentIdMapping[];
|
|
19
29
|
}
|
|
20
30
|
export interface ApplyActionLiveOpts {
|
|
21
31
|
objects: Record<string, Collection<Record<string, unknown>>>;
|
|
22
32
|
context?: Record<string, unknown>;
|
|
33
|
+
/**
|
|
34
|
+
* Attachments that must be uploaded as part of action execution. Adapters
|
|
35
|
+
* must treat their IDs as opaque local handles, substitute any backend IDs or
|
|
36
|
+
* references required by the action invocation, and return an ID mapping for
|
|
37
|
+
* every upload whose canonical backend ID differs.
|
|
38
|
+
*/
|
|
23
39
|
attachmentUploads?: OntologyAttachmentUpload[];
|
|
24
40
|
idempotencyKey?: string;
|
|
25
41
|
}
|
|
@@ -35,12 +51,25 @@ export interface RunQueryLiveOpts {
|
|
|
35
51
|
context?: Record<string, unknown>;
|
|
36
52
|
}
|
|
37
53
|
export interface OntologyAttachmentsAdapter {
|
|
54
|
+
/**
|
|
55
|
+
* Generates a preferred ID for an attachment created directly against this adapter.
|
|
56
|
+
*
|
|
57
|
+
* This is a hint, not an invariant. Attachments can arrive with IDs generated elsewhere,
|
|
58
|
+
* so adapters must accept IDs downstream that were not produced by this function.
|
|
59
|
+
*/
|
|
38
60
|
generateAttachmentId?: (blob: Blob, opts: {
|
|
39
61
|
target?: AttachmentTypeDef;
|
|
40
62
|
}) => Promise<string> | string;
|
|
41
63
|
canMaterializeAttachment?: (attachment: v.attachment, opts: {
|
|
42
64
|
target?: AttachmentTypeDef;
|
|
43
65
|
}) => boolean;
|
|
66
|
+
/**
|
|
67
|
+
* Materializes an attachment in the backend.
|
|
68
|
+
*
|
|
69
|
+
* The incoming attachment ID is opaque and may not be valid for this backend. When
|
|
70
|
+
* the backend assigns or requires another ID, return an attachment containing that
|
|
71
|
+
* canonical ID so the caller can rewrite parameters and bind the resulting mapping.
|
|
72
|
+
*/
|
|
44
73
|
materializeAttachment?: (attachment: v.attachment, blob: Blob, opts: {
|
|
45
74
|
target?: AttachmentTypeDef;
|
|
46
75
|
}) => Promise<v.attachment | void>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"OntologyBackendAdapter.d.ts","sourceRoot":"","sources":["../../src/live/OntologyBackendAdapter.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"OntologyBackendAdapter.d.ts","sourceRoot":"","sources":["../../src/live/OntologyBackendAdapter.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@party-stack/ontology",
|
|
3
|
-
"version": "0.16.
|
|
3
|
+
"version": "0.16.3",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"exports": {
|
|
6
6
|
".": {
|
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
"dependencies": {
|
|
29
29
|
"@bobbyfidz/panic": "^0.1.0",
|
|
30
30
|
"@next/env": "^16.1.6",
|
|
31
|
-
"@tanstack/db-sqlite-persistence-core": "^0.2.
|
|
31
|
+
"@tanstack/db-sqlite-persistence-core": "^0.2.21",
|
|
32
32
|
"change-case": "^5.4.4",
|
|
33
33
|
"commander": "^14.0.2",
|
|
34
34
|
"effection": "^4.0.2",
|
|
@@ -37,22 +37,22 @@
|
|
|
37
37
|
"temporal-polyfill": "^0.3.0",
|
|
38
38
|
"ts-morph": "^27.0.2",
|
|
39
39
|
"zod": "^4.4.3",
|
|
40
|
-
"@party-stack/blobs": "0.5.
|
|
41
|
-
"@party-stack/connections": "0.2.
|
|
40
|
+
"@party-stack/blobs": "0.5.3",
|
|
41
|
+
"@party-stack/connections": "0.2.3",
|
|
42
42
|
"@party-stack/errors": "0.2.0",
|
|
43
|
-
"@party-stack/node-runtime": "^0.2.
|
|
44
|
-
"@party-stack/runtime": "0.3.
|
|
43
|
+
"@party-stack/node-runtime": "^0.2.3",
|
|
44
|
+
"@party-stack/runtime": "0.3.3"
|
|
45
45
|
},
|
|
46
46
|
"devDependencies": {
|
|
47
47
|
"@bobbyfidz/universal-build-config": "^0.1.1",
|
|
48
|
-
"@tanstack/db": "^0.
|
|
48
|
+
"@tanstack/db": "^0.9.0",
|
|
49
49
|
"eslint": "^9.25.0",
|
|
50
50
|
"tsx": "^4.20.6",
|
|
51
51
|
"typescript": "~5.8.3",
|
|
52
52
|
"vitest": "^3.1.1"
|
|
53
53
|
},
|
|
54
54
|
"peerDependencies": {
|
|
55
|
-
"@tanstack/db": "^0.
|
|
55
|
+
"@tanstack/db": "^0.9.0"
|
|
56
56
|
},
|
|
57
57
|
"scripts": {
|
|
58
58
|
"bootstrap": "tsx ./src/cli/index.ts generate --ontology ./src/ir/schema.ts --outDir ./src/ir/generated",
|