@party-stack/ontology 0.3.0 → 0.4.0

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.
Files changed (278) hide show
  1. package/lib/OntologyConfig.d.ts +3 -2
  2. package/lib/OntologyConfig.d.ts.map +1 -1
  3. package/lib/cli/generate.d.ts.map +1 -1
  4. package/lib/cli/generate.js +65 -47
  5. package/lib/cli/generate.js.map +1 -1
  6. package/lib/cli/index.js +7 -4
  7. package/lib/cli/index.js.map +1 -1
  8. package/lib/cli/pull.d.ts.map +1 -1
  9. package/lib/cli/pull.js +10 -4
  10. package/lib/cli/pull.js.map +1 -1
  11. package/lib/examples/blog.d.ts +214 -17
  12. package/lib/examples/blog.d.ts.map +1 -1
  13. package/lib/examples/blog.js +20 -0
  14. package/lib/examples/blog.js.map +1 -1
  15. package/lib/examples/blog.live-queries.d.ts.map +1 -1
  16. package/lib/examples/blog.live-queries.js +4 -2
  17. package/lib/examples/blog.live-queries.js.map +1 -1
  18. package/lib/examples/generated/live.d.ts +2 -2
  19. package/lib/examples/generated/live.d.ts.map +1 -1
  20. package/lib/examples/generated/live.js +2 -5
  21. package/lib/examples/generated/live.js.map +1 -1
  22. package/lib/examples/generated/types.d.ts +15 -10
  23. package/lib/examples/generated/types.d.ts.map +1 -1
  24. package/lib/generate/builders.d.ts +9 -0
  25. package/lib/generate/builders.d.ts.map +1 -0
  26. package/lib/generate/builders.js +60 -0
  27. package/lib/generate/builders.js.map +1 -0
  28. package/lib/generate/builders.test.d.ts +2 -0
  29. package/lib/generate/builders.test.d.ts.map +1 -0
  30. package/lib/generate/builders.test.js +49 -0
  31. package/lib/generate/builders.test.js.map +1 -0
  32. package/lib/generate/index.d.ts +5 -0
  33. package/lib/generate/index.d.ts.map +1 -0
  34. package/lib/generate/index.js +5 -0
  35. package/lib/generate/index.js.map +1 -0
  36. package/lib/generate/live.d.ts.map +1 -1
  37. package/lib/generate/live.js +13 -10
  38. package/lib/generate/live.js.map +1 -1
  39. package/lib/generate/ontology.d.ts.map +1 -1
  40. package/lib/generate/ontology.js +29 -8
  41. package/lib/generate/ontology.js.map +1 -1
  42. package/lib/generate/types.d.ts +11 -1
  43. package/lib/generate/types.d.ts.map +1 -1
  44. package/lib/generate/types.js +178 -118
  45. package/lib/generate/types.js.map +1 -1
  46. package/lib/generate/types.test.js +118 -8
  47. package/lib/generate/types.test.js.map +1 -1
  48. package/lib/generate/utils/buildJsDocs.d.ts +7 -0
  49. package/lib/generate/utils/buildJsDocs.d.ts.map +1 -0
  50. package/lib/generate/utils/buildJsDocs.js +12 -0
  51. package/lib/generate/utils/buildJsDocs.js.map +1 -0
  52. package/lib/index.d.ts +4 -2
  53. package/lib/index.d.ts.map +1 -1
  54. package/lib/index.js +2 -1
  55. package/lib/index.js.map +1 -1
  56. package/lib/infer.d.ts +231 -0
  57. package/lib/infer.d.ts.map +1 -0
  58. package/lib/infer.js +10 -0
  59. package/lib/infer.js.map +1 -0
  60. package/lib/infer.test.d.ts +2 -0
  61. package/lib/infer.test.d.ts.map +1 -0
  62. package/lib/infer.test.js +116 -0
  63. package/lib/infer.test.js.map +1 -0
  64. package/lib/ir/generated/builders.d.ts +180 -180
  65. package/lib/ir/generated/builders.d.ts.map +1 -1
  66. package/lib/ir/generated/builders.js +24 -75
  67. package/lib/ir/generated/builders.js.map +1 -1
  68. package/lib/ir/generated/types.d.ts +32 -5
  69. package/lib/ir/generated/types.d.ts.map +1 -1
  70. package/lib/ir/schema.d.ts +1498 -5
  71. package/lib/ir/schema.d.ts.map +1 -1
  72. package/lib/ir/schema.js +509 -97
  73. package/lib/ir/schema.js.map +1 -1
  74. package/lib/ir/validate.d.ts.map +1 -1
  75. package/lib/ir/validate.js +31 -0
  76. package/lib/ir/validate.js.map +1 -1
  77. package/lib/ir/validate.test.js +53 -3
  78. package/lib/ir/validate.test.js.map +1 -1
  79. package/lib/json/index.d.ts +14 -0
  80. package/lib/json/index.d.ts.map +1 -0
  81. package/lib/json/index.js +158 -0
  82. package/lib/json/index.js.map +1 -0
  83. package/lib/json/index.test.d.ts +2 -0
  84. package/lib/json/index.test.d.ts.map +1 -0
  85. package/lib/json/index.test.js +123 -0
  86. package/lib/json/index.test.js.map +1 -0
  87. package/lib/live/LiveOntology.d.ts +43 -18
  88. package/lib/live/LiveOntology.d.ts.map +1 -1
  89. package/lib/live/LiveOntology.js +63 -67
  90. package/lib/live/LiveOntology.js.map +1 -1
  91. package/lib/live/LiveOntology.test.d.ts +2 -0
  92. package/lib/live/LiveOntology.test.d.ts.map +1 -0
  93. package/lib/live/LiveOntology.test.js +154 -0
  94. package/lib/live/LiveOntology.test.js.map +1 -0
  95. package/lib/live/OntologyBackendAdapter.d.ts +53 -0
  96. package/lib/live/OntologyBackendAdapter.d.ts.map +1 -0
  97. package/lib/live/OntologyBackendAdapter.js +2 -0
  98. package/lib/live/OntologyBackendAdapter.js.map +1 -0
  99. package/lib/live/actions/createLiveOntologyAction.d.ts +20 -0
  100. package/lib/live/actions/createLiveOntologyAction.d.ts.map +1 -0
  101. package/lib/live/actions/createLiveOntologyAction.js +22 -0
  102. package/lib/live/actions/createLiveOntologyAction.js.map +1 -0
  103. package/lib/live/actions/createLiveOntologyActions.d.ts +23 -0
  104. package/lib/live/actions/createLiveOntologyActions.d.ts.map +1 -0
  105. package/lib/live/actions/createLiveOntologyActions.js +129 -0
  106. package/lib/live/actions/createLiveOntologyActions.js.map +1 -0
  107. package/lib/live/actions/prepareActionParameters.d.ts +16 -0
  108. package/lib/live/actions/prepareActionParameters.d.ts.map +1 -0
  109. package/lib/live/actions/prepareActionParameters.js +251 -0
  110. package/lib/live/actions/prepareActionParameters.js.map +1 -0
  111. package/lib/live/actions/prepareActionParameters.test.d.ts +2 -0
  112. package/lib/live/actions/prepareActionParameters.test.d.ts.map +1 -0
  113. package/lib/live/actions/prepareActionParameters.test.js +165 -0
  114. package/lib/live/actions/prepareActionParameters.test.js.map +1 -0
  115. package/lib/live/attachments/attachmentSources.d.ts +7 -0
  116. package/lib/live/attachments/attachmentSources.d.ts.map +1 -0
  117. package/lib/live/attachments/attachmentSources.js +80 -0
  118. package/lib/live/attachments/attachmentSources.js.map +1 -0
  119. package/lib/live/attachments/createLiveOntologyAttachments.d.ts +38 -0
  120. package/lib/live/attachments/createLiveOntologyAttachments.d.ts.map +1 -0
  121. package/lib/live/attachments/createLiveOntologyAttachments.js +59 -0
  122. package/lib/live/attachments/createLiveOntologyAttachments.js.map +1 -0
  123. package/lib/live/attachments/createLiveOntologyAttachments.test.d.ts +2 -0
  124. package/lib/live/attachments/createLiveOntologyAttachments.test.d.ts.map +1 -0
  125. package/lib/live/attachments/createLiveOntologyAttachments.test.js +244 -0
  126. package/lib/live/attachments/createLiveOntologyAttachments.test.js.map +1 -0
  127. package/lib/live/attachments/unsupportedOntologyAttachmentsAdapter.d.ts +3 -0
  128. package/lib/live/attachments/unsupportedOntologyAttachmentsAdapter.d.ts.map +1 -0
  129. package/lib/live/attachments/unsupportedOntologyAttachmentsAdapter.js +5 -0
  130. package/lib/live/attachments/unsupportedOntologyAttachmentsAdapter.js.map +1 -0
  131. package/lib/live/expression.d.ts +16 -3
  132. package/lib/live/expression.d.ts.map +1 -1
  133. package/lib/live/expression.js +54 -41
  134. package/lib/live/expression.js.map +1 -1
  135. package/lib/live/expression.test.d.ts +2 -0
  136. package/lib/live/expression.test.d.ts.map +1 -0
  137. package/lib/live/expression.test.js +76 -0
  138. package/lib/live/expression.test.js.map +1 -0
  139. package/lib/live/index.d.ts +4 -1
  140. package/lib/live/index.d.ts.map +1 -1
  141. package/lib/live/index.js +4 -1
  142. package/lib/live/index.js.map +1 -1
  143. package/lib/live/mutators/OntologyEdits.d.ts +11 -0
  144. package/lib/live/mutators/OntologyEdits.d.ts.map +1 -0
  145. package/lib/live/mutators/OntologyEdits.js +66 -0
  146. package/lib/live/mutators/OntologyEdits.js.map +1 -0
  147. package/lib/live/mutators/createMutatorTx.d.ts +9 -0
  148. package/lib/live/mutators/createMutatorTx.d.ts.map +1 -0
  149. package/lib/live/mutators/createMutatorTx.js +67 -0
  150. package/lib/live/mutators/createMutatorTx.js.map +1 -0
  151. package/lib/live/mutators/createMutatorTx.test.d.ts +2 -0
  152. package/lib/live/mutators/createMutatorTx.test.d.ts.map +1 -0
  153. package/lib/live/mutators/createMutatorTx.test.js +90 -0
  154. package/lib/live/mutators/createMutatorTx.test.js.map +1 -0
  155. package/lib/live/mutators/runOptimisticAction.d.ts +15 -0
  156. package/lib/live/mutators/runOptimisticAction.d.ts.map +1 -0
  157. package/lib/live/mutators/runOptimisticAction.js +29 -0
  158. package/lib/live/mutators/runOptimisticAction.js.map +1 -0
  159. package/lib/live/mutators/types.d.ts +24 -0
  160. package/lib/live/mutators/types.d.ts.map +1 -0
  161. package/lib/live/mutators/types.js +2 -0
  162. package/lib/live/mutators/types.js.map +1 -0
  163. package/lib/live/objects/OntologyObject.d.ts +2 -0
  164. package/lib/live/objects/OntologyObject.d.ts.map +1 -0
  165. package/lib/live/objects/OntologyObject.js +2 -0
  166. package/lib/live/objects/OntologyObject.js.map +1 -0
  167. package/lib/live/objects/createLiveOntologyObjectCollection.d.ts +14 -0
  168. package/lib/live/objects/createLiveOntologyObjectCollection.d.ts.map +1 -0
  169. package/lib/live/objects/createLiveOntologyObjectCollection.js +59 -0
  170. package/lib/live/objects/createLiveOntologyObjectCollection.js.map +1 -0
  171. package/lib/live/objects/createLiveOntologyObjectCollection.test.d.ts +2 -0
  172. package/lib/live/objects/createLiveOntologyObjectCollection.test.d.ts.map +1 -0
  173. package/lib/live/objects/createLiveOntologyObjectCollection.test.js +176 -0
  174. package/lib/live/objects/createLiveOntologyObjectCollection.test.js.map +1 -0
  175. package/lib/live/objects/ontologyObjectCollectionId.d.ts +2 -0
  176. package/lib/live/objects/ontologyObjectCollectionId.d.ts.map +1 -0
  177. package/lib/live/objects/ontologyObjectCollectionId.js +4 -0
  178. package/lib/live/objects/ontologyObjectCollectionId.js.map +1 -0
  179. package/lib/live/outbox/createOntologyOutbox.d.ts +19 -0
  180. package/lib/live/outbox/createOntologyOutbox.d.ts.map +1 -0
  181. package/lib/live/outbox/createOntologyOutbox.js +321 -0
  182. package/lib/live/outbox/createOntologyOutbox.js.map +1 -0
  183. package/lib/live/outbox/createOntologyOutbox.test.d.ts +2 -0
  184. package/lib/live/outbox/createOntologyOutbox.test.d.ts.map +1 -0
  185. package/lib/live/outbox/createOntologyOutbox.test.js +914 -0
  186. package/lib/live/outbox/createOntologyOutbox.test.js.map +1 -0
  187. package/lib/live/outbox/leaderExecutor.d.ts +16 -0
  188. package/lib/live/outbox/leaderExecutor.d.ts.map +1 -0
  189. package/lib/live/outbox/leaderExecutor.js +143 -0
  190. package/lib/live/outbox/leaderExecutor.js.map +1 -0
  191. package/lib/live/outbox/outboxService.d.ts +5 -0
  192. package/lib/live/outbox/outboxService.d.ts.map +1 -0
  193. package/lib/live/outbox/outboxService.js +73 -0
  194. package/lib/live/outbox/outboxService.js.map +1 -0
  195. package/lib/live/outbox/outboxValues.d.ts +7 -0
  196. package/lib/live/outbox/outboxValues.d.ts.map +1 -0
  197. package/lib/live/outbox/outboxValues.js +76 -0
  198. package/lib/live/outbox/outboxValues.js.map +1 -0
  199. package/lib/live/outbox/projectionManager.d.ts +29 -0
  200. package/lib/live/outbox/projectionManager.d.ts.map +1 -0
  201. package/lib/live/outbox/projectionManager.js +155 -0
  202. package/lib/live/outbox/projectionManager.js.map +1 -0
  203. package/lib/live/outbox/repository.d.ts +29 -0
  204. package/lib/live/outbox/repository.d.ts.map +1 -0
  205. package/lib/live/outbox/repository.js +245 -0
  206. package/lib/live/outbox/repository.js.map +1 -0
  207. package/lib/live/outbox/service.d.ts +59 -0
  208. package/lib/live/outbox/service.d.ts.map +1 -0
  209. package/lib/live/outbox/service.js +2 -0
  210. package/lib/live/outbox/service.js.map +1 -0
  211. package/lib/live/outbox/types.d.ts +45 -0
  212. package/lib/live/outbox/types.d.ts.map +1 -0
  213. package/lib/live/outbox/types.js +7 -0
  214. package/lib/live/outbox/types.js.map +1 -0
  215. package/lib/meta/generated/live.d.ts +5 -0
  216. package/lib/meta/generated/live.d.ts.map +1 -0
  217. package/lib/{ontology → meta}/generated/live.js +2 -5
  218. package/lib/meta/generated/live.js.map +1 -0
  219. package/lib/{ontology → meta}/generated/types.d.ts +32 -11
  220. package/lib/meta/generated/types.d.ts.map +1 -0
  221. package/lib/meta/generated/types.js.map +1 -0
  222. package/lib/{ontology → meta}/ontology.d.ts +1 -0
  223. package/lib/meta/ontology.d.ts.map +1 -0
  224. package/lib/{ontology → meta}/ontology.js +7 -0
  225. package/lib/meta/ontology.js.map +1 -0
  226. package/lib/meta/pull.d.ts +2 -1
  227. package/lib/meta/pull.d.ts.map +1 -1
  228. package/lib/meta/pull.js +20 -5
  229. package/lib/meta/pull.js.map +1 -1
  230. package/lib/utils/provide.d.ts +2 -0
  231. package/lib/utils/provide.d.ts.map +1 -0
  232. package/lib/utils/provide.js +11 -0
  233. package/lib/utils/provide.js.map +1 -0
  234. package/lib/utils/targets.d.ts +35 -0
  235. package/lib/utils/targets.d.ts.map +1 -0
  236. package/lib/utils/targets.js +2 -0
  237. package/lib/utils/targets.js.map +1 -0
  238. package/lib/utils/typeNames.d.ts +26 -0
  239. package/lib/utils/typeNames.d.ts.map +1 -0
  240. package/lib/utils/typeNames.js +2 -0
  241. package/lib/utils/typeNames.js.map +1 -0
  242. package/lib/utils/types.d.ts +6 -5
  243. package/lib/utils/types.d.ts.map +1 -1
  244. package/lib/utils/types.js +22 -1
  245. package/lib/utils/types.js.map +1 -1
  246. package/lib/utils/types.test.js +23 -3
  247. package/lib/utils/types.test.js.map +1 -1
  248. package/lib/utils/values.d.ts +25 -1
  249. package/lib/utils/values.d.ts.map +1 -1
  250. package/package.json +14 -8
  251. package/lib/ir/generated/validators.d.ts +0 -49
  252. package/lib/ir/generated/validators.d.ts.map +0 -1
  253. package/lib/ir/generated/validators.js +0 -173
  254. package/lib/ir/generated/validators.js.map +0 -1
  255. package/lib/live/OntologyAdapter.d.ts +0 -25
  256. package/lib/live/OntologyAdapter.d.ts.map +0 -1
  257. package/lib/live/OntologyAdapter.js +0 -2
  258. package/lib/live/OntologyAdapter.js.map +0 -1
  259. package/lib/live/applyActionLogic.d.ts +0 -10
  260. package/lib/live/applyActionLogic.d.ts.map +0 -1
  261. package/lib/live/applyActionLogic.js +0 -59
  262. package/lib/live/applyActionLogic.js.map +0 -1
  263. package/lib/live/createLiveOntologyAttachments.d.ts +0 -20
  264. package/lib/live/createLiveOntologyAttachments.d.ts.map +0 -1
  265. package/lib/live/createLiveOntologyAttachments.js +0 -30
  266. package/lib/live/createLiveOntologyAttachments.js.map +0 -1
  267. package/lib/live/materializeActionParameters.d.ts +0 -11
  268. package/lib/live/materializeActionParameters.d.ts.map +0 -1
  269. package/lib/live/materializeActionParameters.js +0 -86
  270. package/lib/live/materializeActionParameters.js.map +0 -1
  271. package/lib/ontology/generated/live.d.ts +0 -5
  272. package/lib/ontology/generated/live.d.ts.map +0 -1
  273. package/lib/ontology/generated/live.js.map +0 -1
  274. package/lib/ontology/generated/types.d.ts.map +0 -1
  275. package/lib/ontology/generated/types.js.map +0 -1
  276. package/lib/ontology/ontology.d.ts.map +0 -1
  277. package/lib/ontology/ontology.js.map +0 -1
  278. /package/lib/{ontology → meta}/generated/types.js +0 -0
@@ -0,0 +1,123 @@
1
+ import { Temporal } from "temporal-polyfill";
2
+ import { describe, expect, it } from "vitest";
3
+ import { o } from "../ir/generated/builders.js";
4
+ import { decode, encode } from "./index.js";
5
+ const ir = {
6
+ types: [
7
+ {
8
+ name: "Metadata",
9
+ type: o.struct({
10
+ fields: [
11
+ { name: "publishedOn", displayName: "Published On", type: o.date({}) },
12
+ { name: "tags", displayName: "Tags", type: o.list({ elementType: o.string({}) }) },
13
+ ],
14
+ }),
15
+ },
16
+ ],
17
+ objectTypes: [
18
+ {
19
+ name: "Post",
20
+ displayName: "Post",
21
+ pluralDisplayName: "Posts",
22
+ primaryKey: "id",
23
+ properties: [
24
+ { name: "id", displayName: "ID", type: o.string({}) },
25
+ { name: "createdAt", displayName: "Created At", type: o.timestamp({}) },
26
+ { name: "metadata", displayName: "Metadata", type: o.ref({ name: "Metadata" }) },
27
+ ],
28
+ },
29
+ ],
30
+ linkTypes: [],
31
+ actionTypes: [
32
+ {
33
+ name: "createPost",
34
+ displayName: "Create post",
35
+ parameters: [
36
+ { name: "metadata", displayName: "Metadata", type: o.ref({ name: "Metadata" }) },
37
+ ],
38
+ logic: [],
39
+ },
40
+ ],
41
+ queryFunctionTypes: [
42
+ {
43
+ name: "getPost",
44
+ displayName: "Get post",
45
+ parameters: [{ name: "id", displayName: "ID", type: o.string({}) }],
46
+ returnType: o.ref({ name: "Metadata" }),
47
+ },
48
+ ],
49
+ };
50
+ describe("ontology JSON codec", () => {
51
+ it("encodes and decodes named types", () => {
52
+ const value = {
53
+ publishedOn: Temporal.PlainDate.from("2026-06-09"),
54
+ tags: ["ontology"],
55
+ };
56
+ const encoded = encode({ ir, target: { kind: "type", name: "Metadata" }, value });
57
+ expect(encoded).toEqual({
58
+ publishedOn: "2026-06-09",
59
+ tags: ["ontology"],
60
+ });
61
+ expect(decode({ ir, target: { kind: "type", name: "Metadata" }, value: encoded })).toEqual(value);
62
+ });
63
+ it("encodes and decodes objects by object type name", () => {
64
+ const object = {
65
+ id: "post-1",
66
+ createdAt: Temporal.Instant.from("2026-06-09T12:00:00Z"),
67
+ metadata: {
68
+ publishedOn: Temporal.PlainDate.from("2026-06-09"),
69
+ tags: ["ontology"],
70
+ },
71
+ };
72
+ const encoded = encode({ ir, target: { kind: "object", name: "Post" }, value: object });
73
+ expect(encoded).toEqual({
74
+ id: "post-1",
75
+ createdAt: "2026-06-09T12:00:00Z",
76
+ metadata: {
77
+ publishedOn: "2026-06-09",
78
+ tags: ["ontology"],
79
+ },
80
+ });
81
+ expect(decode({ ir, target: { kind: "object", name: "Post" }, value: encoded })).toEqual(object);
82
+ });
83
+ it("encodes and decodes action and query function parameter objects by name", () => {
84
+ const value = {
85
+ metadata: {
86
+ publishedOn: Temporal.PlainDate.from("2026-06-09"),
87
+ tags: ["ontology"],
88
+ },
89
+ };
90
+ const encoded = {
91
+ metadata: {
92
+ publishedOn: "2026-06-09",
93
+ tags: ["ontology"],
94
+ },
95
+ };
96
+ expect(encode({
97
+ ir,
98
+ target: { kind: "actionParameters", actionType: "createPost" },
99
+ value,
100
+ })).toEqual(encoded);
101
+ expect(decode({
102
+ ir,
103
+ target: { kind: "actionParameters", actionType: "createPost" },
104
+ value: encoded,
105
+ })).toEqual(value);
106
+ });
107
+ it("encodes and decodes single query targets by name", () => {
108
+ const value = {
109
+ publishedOn: Temporal.PlainDate.from("2026-06-09"),
110
+ tags: ["ontology"],
111
+ };
112
+ const encoded = {
113
+ publishedOn: "2026-06-09",
114
+ tags: ["ontology"],
115
+ };
116
+ expect(decode({
117
+ ir,
118
+ target: { kind: "queryFunctionReturn", queryFunctionType: "getPost" },
119
+ value: encoded,
120
+ })).toEqual(value);
121
+ });
122
+ });
123
+ //# sourceMappingURL=index.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/json/index.test.ts"],"names":[],"mappings":"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"}
@@ -1,40 +1,65 @@
1
- import { type BlobStoreProvider } from "@party-stack/blobs";
2
- import { Collection } from "@tanstack/db";
3
- import { type LiveOntologyAttachments } from "./createLiveOntologyAttachments.js";
4
- import type { OntologyAdapter } from "./OntologyAdapter.js";
1
+ import { type RuntimeAdapterProvider } from "@party-stack/runtime";
2
+ import { type LiveOntologyAttachments } from "./attachments/createLiveOntologyAttachments.js";
3
+ import type { LiveOntologyAction } from "./actions/createLiveOntologyAction.js";
4
+ import type { OntologyMutatorRegistry } from "./mutators/types.js";
5
+ import type { OntologyCollection } from "./objects/createLiveOntologyObjectCollection.js";
6
+ import type { OntologyObject } from "./objects/OntologyObject.js";
7
+ import type { OntologyBackendAdapterProvider } from "./OntologyBackendAdapter.js";
8
+ import type { OntologyOutbox } from "./outbox/types.js";
5
9
  import type { OntologyIR } from "../ir/index.js";
6
- export type { LiveOntologyAttachments } from "./createLiveOntologyAttachments.js";
7
- export type OntologyObject = Record<string, unknown>;
10
+ export type { LiveOntologyAction, LiveOntologyActionOptions } from "./actions/createLiveOntologyAction.js";
11
+ export type { LiveOntologyAttachments } from "./attachments/createLiveOntologyAttachments.js";
12
+ export type { OntologyCollection } from "./objects/createLiveOntologyObjectCollection.js";
13
+ export type LiveOntologyWriteMode = "direct" | "outbox";
14
+ export type LiveOntologyWriteVisibility = "confirmed" | "optimistic";
15
+ export type LiveOntologyOutboxFailureStrategy = "pause" | "discard-all";
16
+ export interface LiveOntologyOutboxOptions {
17
+ failureStrategy?: LiveOntologyOutboxFailureStrategy;
18
+ maxRetries?: number;
19
+ }
20
+ export interface LiveOntologyWrites {
21
+ defaultMode?: LiveOntologyWriteMode;
22
+ defaultVisibility?: LiveOntologyWriteVisibility;
23
+ mutators?: OntologyMutatorRegistry;
24
+ outbox?: LiveOntologyOutboxOptions;
25
+ }
8
26
  export interface OntologyDefinition {
9
27
  objectTypes: Record<string, OntologyObject>;
10
28
  actionTypes: Record<string, {
11
29
  parameters: Record<string, unknown>;
12
30
  }>;
31
+ queryFunctionTypes: Record<string, {
32
+ parameters: Record<string, unknown>;
33
+ returnType: unknown;
34
+ }>;
13
35
  }
14
- export type OntologyCollection<T extends OntologyObject> = Collection<T>;
15
- export interface LiveOntologyActionExecution {
16
- mutationFn: () => Promise<void>;
17
- mutator: () => void;
18
- }
19
- export type LiveOntologyAction<Parameters extends Record<string, unknown> = Record<string, unknown>> = (parameters: Parameters) => LiveOntologyActionExecution;
36
+ export type LiveOntologyQueryFunction<Parameters extends Record<string, unknown> = Record<string, unknown>, Return = unknown> = (parameters: Parameters) => Promise<Return>;
20
37
  export type LiveOntologyObjects<ObjectTypes extends OntologyDefinition["objectTypes"] = OntologyDefinition["objectTypes"]> = {
21
38
  [ObjectTypeName in keyof ObjectTypes]: OntologyCollection<ObjectTypes[ObjectTypeName]>;
22
39
  };
23
40
  export type LiveOntologyActions<ActionTypes extends OntologyDefinition["actionTypes"]> = {
24
41
  [ActionTypeName in keyof ActionTypes]: LiveOntologyAction<ActionTypes[ActionTypeName]["parameters"]>;
25
42
  };
43
+ export type LiveOntologyQueryFunctions<QueryFunctionTypes extends OntologyDefinition["queryFunctionTypes"]> = {
44
+ [QueryFunctionTypeName in keyof QueryFunctionTypes]: LiveOntologyQueryFunction<QueryFunctionTypes[QueryFunctionTypeName]["parameters"], QueryFunctionTypes[QueryFunctionTypeName]["returnType"]>;
45
+ };
26
46
  export interface LiveOntology<Ontology extends OntologyDefinition = OntologyDefinition> {
27
47
  objects: LiveOntologyObjects<Ontology["objectTypes"]>;
28
48
  actions: LiveOntologyActions<Ontology["actionTypes"]>;
29
- attachments?: LiveOntologyAttachments;
49
+ queryFunctions: LiveOntologyQueryFunctions<Ontology["queryFunctionTypes"]>;
50
+ attachments: LiveOntologyAttachments;
51
+ outbox: OntologyOutbox;
30
52
  cleanup: () => Promise<void>;
31
53
  }
32
- export interface LiveOntologyOpts {
54
+ export interface CreateLiveOntologyOpts<Context extends Record<string, unknown> = Record<string, unknown>> {
33
55
  id?: string;
34
56
  ir: OntologyIR;
35
- adapter: OntologyAdapter;
36
- blobStore?: BlobStoreProvider;
37
- getContext?: () => Record<string, unknown>;
57
+ backend: OntologyBackendAdapterProvider<NoInfer<Context>>;
58
+ runtime?: RuntimeAdapterProvider;
59
+ persistObjects?: boolean;
60
+ writes?: LiveOntologyWrites;
61
+ context?: Context;
62
+ getUserId?: (context: Context) => string;
38
63
  }
39
- export declare function createLiveOntology<Ontology extends OntologyDefinition = OntologyDefinition>(opts: LiveOntologyOpts): LiveOntology<Ontology>;
64
+ export declare function createLiveOntology<Ontology extends OntologyDefinition = OntologyDefinition, Context extends Record<string, unknown> = Record<string, unknown>>(opts: CreateLiveOntologyOpts<Context>): Promise<LiveOntology<Ontology>>;
40
65
  //# sourceMappingURL=LiveOntology.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"LiveOntology.d.ts","sourceRoot":"","sources":["../../src/live/LiveOntology.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAc,UAAU,EAAoB,MAAM,cAAc,CAAC;AAExE,OAAO,EAEH,KAAK,uBAAuB,EAC/B,MAAM,oCAAoC,CAAC;AAG5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,YAAY,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAElF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACrD,MAAM,WAAW,kBAAkB;IAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,WAAW,EAAE,MAAM,CACf,MAAM,EACN;QACI,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvC,CACJ,CAAC;CACL;AAED,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,cAAc,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;AAEzE,MAAM,WAAW,2BAA2B;IACxC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,MAAM,kBAAkB,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CACnG,UAAU,EAAE,UAAU,KACrB,2BAA2B,CAAC;AAEjC,MAAM,MAAM,mBAAmB,CAC3B,WAAW,SAAS,kBAAkB,CAAC,aAAa,CAAC,GAAG,kBAAkB,CAAC,aAAa,CAAC,IACzF;KACC,cAAc,IAAI,MAAM,WAAW,GAAG,kBAAkB,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;CACzF,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,WAAW,SAAS,kBAAkB,CAAC,aAAa,CAAC,IAAI;KACpF,cAAc,IAAI,MAAM,WAAW,GAAG,kBAAkB,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,YAAY,CAAC,CAAC;CACvG,CAAC;AAEF,MAAM,WAAW,YAAY,CAAC,QAAQ,SAAS,kBAAkB,GAAG,kBAAkB;IAClF,OAAO,EAAE,mBAAmB,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IACtD,OAAO,EAAE,mBAAmB,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IACtD,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,UAAU,CAAC;IACf,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9C;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,SAAS,kBAAkB,GAAG,kBAAkB,EACvF,IAAI,EAAE,gBAAgB,GACvB,YAAY,CAAC,QAAQ,CAAC,CAqFxB"}
1
+ {"version":3,"file":"LiveOntology.d.ts","sourceRoot":"","sources":["../../src/live/LiveOntology.ts"],"names":[],"mappings":"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"}
@@ -1,77 +1,73 @@
1
- import { createBlobManager, createInMemoryBlobStore } from "@party-stack/blobs";
2
- import { BasicIndex, createCollection } from "@tanstack/db";
3
- import { applyActionLogic } from "./applyActionLogic.js";
4
- import { createLiveOntologyAttachments, } from "./createLiveOntologyAttachments.js";
5
- import { resolveActionParameters } from "./expression.js";
6
- import { materializeActionParameters } from "./materializeActionParameters.js";
7
- export function createLiveOntology(opts) {
8
- const ontologyId = opts.id ?? crypto.randomUUID();
9
- const blobStore = (opts.blobStore ?? createInMemoryBlobStore)(ontologyId);
10
- const attachmentsAdapter = opts.adapter.attachments;
11
- const blobManager = attachmentsAdapter
12
- ? createBlobManager({
13
- store: blobStore,
14
- remote: {
15
- blob: (id) => attachmentsAdapter.getAttachmentContent({ id }),
16
- metadata: (id) => attachmentsAdapter.getAttachmentMetadata({ id }),
17
- },
18
- })
19
- : undefined;
20
- const attachments = attachmentsAdapter && blobManager
21
- ? createLiveOntologyAttachments({
22
- ir: opts.ir,
23
- attachmentsAdapter,
24
- blobManager,
25
- })
26
- : undefined;
27
- const objects = Object.fromEntries(opts.ir.objectTypes.map((objectType) => {
28
- const collectionOptions = opts.adapter.getCollectionOptions(objectType.name);
29
- const collection = createCollection({
30
- ...collectionOptions,
31
- id: `${ontologyId}:${objectType.name}`,
32
- defaultIndexType: BasicIndex,
33
- autoIndex: "eager",
34
- getKey: (object) => object[objectType.primaryKey],
35
- });
36
- return [objectType.name, collection];
37
- }));
38
- const actions = Object.fromEntries(opts.ir.actionTypes.map((action) => [
39
- action.name,
40
- (providedParameters) => {
41
- const context = opts.getContext?.() ?? {};
42
- const parameters = resolveActionParameters(opts.ir, action.name, providedParameters, context, objects);
43
- return {
44
- mutationFn: async () => {
45
- const materializedParameters = await materializeActionParameters({
46
- ir: opts.ir,
47
- adapter: opts.adapter,
48
- actionTypeName: action.name,
49
- parameters,
50
- blobManager,
51
- });
52
- await opts.adapter.applyAction(action.name, materializedParameters, {
53
- objects: objects,
54
- });
55
- },
56
- mutator: () => {
57
- applyActionLogic({
58
- ir: opts.ir,
59
- actionTypeName: action.name,
60
- parameters,
61
- context,
62
- objects,
63
- });
64
- },
65
- };
1
+ import { createBlobManager } from "@party-stack/blobs";
2
+ import { createDefaultRuntime } from "@party-stack/runtime";
3
+ import { provide } from "../utils/provide.js";
4
+ import { createLiveOntologyActions } from "./actions/createLiveOntologyActions.js";
5
+ import { createLiveOntologyAttachments, } from "./attachments/createLiveOntologyAttachments.js";
6
+ import { unsupportedOntologyAttachmentsAdapter } from "./attachments/unsupportedOntologyAttachmentsAdapter.js";
7
+ import { createLiveOntologyObjectCollection } from "./objects/createLiveOntologyObjectCollection.js";
8
+ export async function createLiveOntology(opts) {
9
+ const ontologyId = opts.id ?? "default";
10
+ const context = (opts.context ?? {});
11
+ const owner = opts.getUserId?.(context) ?? "anonymous";
12
+ const backendAdapter = await provide(opts.backend, opts.ir, context);
13
+ const runtime = await provide(opts.runtime ?? createDefaultRuntime, owner, ontologyId);
14
+ const attachmentsAdapter = backendAdapter.attachments ?? unsupportedOntologyAttachmentsAdapter;
15
+ const blobManager = createBlobManager({
16
+ runtime,
17
+ remote: {
18
+ read: (id, readOptions) => attachmentsAdapter.getAttachmentContent({
19
+ id,
20
+ source: readOptions?.meta?.source,
21
+ }),
22
+ metadata: (id, readOptions) => attachmentsAdapter.getAttachmentMetadata({
23
+ id,
24
+ source: readOptions?.meta?.source,
25
+ }),
66
26
  },
27
+ });
28
+ const attachments = createLiveOntologyAttachments({
29
+ ir: opts.ir,
30
+ attachmentsAdapter,
31
+ blobManager,
32
+ });
33
+ const objects = Object.fromEntries(opts.ir.objectTypes.map((objectType) => [
34
+ objectType.name,
35
+ createLiveOntologyObjectCollection({
36
+ ir: opts.ir,
37
+ objectType,
38
+ backendAdapter,
39
+ runtime,
40
+ persistObjects: opts.persistObjects ?? false,
41
+ }),
42
+ ]));
43
+ const actionsSubsystem = createLiveOntologyActions({
44
+ ir: opts.ir,
45
+ backendAdapter,
46
+ runtime,
47
+ context,
48
+ objects,
49
+ blobManager,
50
+ writes: opts.writes,
51
+ });
52
+ const queryFunctions = Object.fromEntries(opts.ir.queryFunctionTypes.map((queryFunctionType) => [
53
+ queryFunctionType.name,
54
+ (parameters) => backendAdapter.runQueryFunction(queryFunctionType.name, parameters, {
55
+ objects: objects,
56
+ context,
57
+ }),
67
58
  ]));
68
59
  return {
69
60
  objects: objects,
70
- actions: actions,
61
+ actions: actionsSubsystem.actions,
62
+ queryFunctions: queryFunctions,
71
63
  attachments,
64
+ outbox: actionsSubsystem.outbox,
72
65
  cleanup: async () => {
66
+ await actionsSubsystem.outbox.cleanup();
73
67
  await Promise.all(Object.values(objects).map((collection) => collection.cleanup()));
74
- await opts.adapter.cleanup?.();
68
+ await blobManager.cleanup();
69
+ await backendAdapter.cleanup?.();
70
+ await runtime.cleanup?.();
75
71
  },
76
72
  };
77
73
  }
@@ -1 +1 @@
1
- {"version":3,"file":"LiveOntology.js","sourceRoot":"","sources":["../../src/live/LiveOntology.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"LiveOntology.js","sourceRoot":"","sources":["../../src/live/LiveOntology.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=LiveOntology.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LiveOntology.test.d.ts","sourceRoot":"","sources":["../../src/live/LiveOntology.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,154 @@
1
+ import { MemoryBlobBytesStore, SingleProcessCoordination } from "@party-stack/runtime";
2
+ import { describe, expect, it, vi } from "vitest";
3
+ import { o } from "../ir/index.js";
4
+ import { createLiveOntology } from "./LiveOntology.js";
5
+ const ir = {
6
+ types: [],
7
+ objectTypes: [],
8
+ linkTypes: [],
9
+ actionTypes: [],
10
+ queryFunctionTypes: [
11
+ {
12
+ name: "currentUser",
13
+ displayName: "Current User",
14
+ parameters: [],
15
+ returnType: o.string({}),
16
+ },
17
+ ],
18
+ };
19
+ const actionIr = {
20
+ ...ir,
21
+ actionTypes: [
22
+ {
23
+ name: "save",
24
+ displayName: "Save",
25
+ parameters: [],
26
+ logic: [],
27
+ },
28
+ ],
29
+ queryFunctionTypes: [],
30
+ };
31
+ describe("createLiveOntology", () => {
32
+ it("derives runtime scope and owns the provider result", async () => {
33
+ const context = { account: { id: "user-1" }, role: "editor" };
34
+ let receivedContext;
35
+ const cleanupOrder = [];
36
+ const coordination = new SingleProcessCoordination({
37
+ scope: "party-stack:user-1:ontology-1",
38
+ });
39
+ const closeCoordination = vi.spyOn(coordination, "close").mockImplementation(() => {
40
+ cleanupOrder.push("coordination");
41
+ return Promise.resolve();
42
+ });
43
+ const cleanupRuntime = vi.fn(async () => {
44
+ cleanupOrder.push("runtime");
45
+ await coordination.close();
46
+ });
47
+ const backendAdapter = {
48
+ name: "test",
49
+ getCollectionOptions: () => {
50
+ throw new Error("unexpected collection");
51
+ },
52
+ applyAction: () => Promise.reject(new Error("unexpected action")),
53
+ runQueryFunction: (_name, _parameters, live) => {
54
+ receivedContext = live.context;
55
+ return Promise.resolve(context.account.id);
56
+ },
57
+ cleanup: () => {
58
+ cleanupOrder.push("backend");
59
+ },
60
+ };
61
+ const backend = vi.fn((providerIr, providerContext) => {
62
+ expect(providerIr).toBe(ir);
63
+ expect(providerContext).toBe(context);
64
+ return backendAdapter;
65
+ });
66
+ const ontology = await createLiveOntology({
67
+ id: "ontology-1",
68
+ ir,
69
+ backend,
70
+ context,
71
+ getUserId: (liveContext) => liveContext.account.id,
72
+ runtime: (owner, namespace) => {
73
+ expect(owner).toBe("user-1");
74
+ expect(namespace).toBe("ontology-1");
75
+ return Promise.resolve({
76
+ owner: "user-1",
77
+ namespace: "ontology-1",
78
+ blobBytes: {
79
+ write: () => Promise.resolve(),
80
+ read: () => Promise.reject(new Error("unexpected blob read")),
81
+ delete: () => Promise.resolve(),
82
+ },
83
+ coordination,
84
+ cleanup: cleanupRuntime,
85
+ });
86
+ },
87
+ });
88
+ expect(ontology.outbox).toBeDefined();
89
+ await expect(ontology.queryFunctions.currentUser({})).resolves.toBe("user-1");
90
+ expect(receivedContext).toBe(context);
91
+ await ontology.cleanup();
92
+ expect(backend).toHaveBeenCalledOnce();
93
+ expect(closeCoordination).toHaveBeenCalledOnce();
94
+ expect(cleanupRuntime).toHaveBeenCalledOnce();
95
+ expect(cleanupOrder).toEqual(["backend", "runtime", "coordination"]);
96
+ });
97
+ it("routes individual writes independently of the defaults", async () => {
98
+ const applyAction = vi.fn(() => Promise.resolve());
99
+ const backendAdapter = {
100
+ name: "test",
101
+ getCollectionOptions: () => {
102
+ throw new Error("unexpected collection");
103
+ },
104
+ applyAction,
105
+ runQueryFunction: () => Promise.reject(new Error("unexpected query")),
106
+ };
107
+ const listeners = new Set();
108
+ let isConnected = false;
109
+ const coordination = new SingleProcessCoordination({
110
+ scope: "write-routing",
111
+ });
112
+ const ontology = await createLiveOntology({
113
+ id: "write-routing",
114
+ ir: actionIr,
115
+ backend: () => backendAdapter,
116
+ runtime: () => ({
117
+ owner: "user",
118
+ namespace: "write-routing",
119
+ blobBytes: new MemoryBlobBytesStore(),
120
+ coordination,
121
+ connectivity: {
122
+ get isConnected() {
123
+ return isConnected;
124
+ },
125
+ subscribe(listener) {
126
+ listeners.add(listener);
127
+ return () => listeners.delete(listener);
128
+ },
129
+ },
130
+ }),
131
+ });
132
+ await ontology.actions.save({});
133
+ expect(applyAction).toHaveBeenCalledOnce();
134
+ const queued = ontology.actions.save({}, {
135
+ mode: "outbox",
136
+ visibility: "optimistic",
137
+ });
138
+ await vi.waitFor(() => {
139
+ expect(ontology.outbox.collection.size).toBe(1);
140
+ });
141
+ expect(applyAction).toHaveBeenCalledOnce();
142
+ const [entry] = Array.from(ontology.outbox.collection.values());
143
+ expect(entry?.visibility).toBe("optimistic");
144
+ isConnected = true;
145
+ for (const listener of listeners) {
146
+ listener(true);
147
+ }
148
+ await queued;
149
+ expect(applyAction).toHaveBeenCalledTimes(2);
150
+ await ontology.cleanup();
151
+ await coordination.close();
152
+ });
153
+ });
154
+ //# sourceMappingURL=LiveOntology.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LiveOntology.test.js","sourceRoot":"","sources":["../../src/live/LiveOntology.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,53 @@
1
+ import * as v from "../utils/values.js";
2
+ import type { AttachmentTypeDef, OntologyIR } from "../ir/index.js";
3
+ import type { Collection, CollectionConfig } from "@tanstack/db";
4
+ export type OntologyCollectionOptions = Omit<CollectionConfig<Record<string, unknown>, string | number>, "getKey">;
5
+ export interface OntologyAttachmentUpload {
6
+ attachment: v.attachment;
7
+ blob: Blob;
8
+ target?: AttachmentTypeDef;
9
+ }
10
+ export interface OntologyAttachmentIdMapping {
11
+ localId: string;
12
+ remoteId: string;
13
+ }
14
+ export interface OntologyApplyActionResult {
15
+ attachmentIdMappings?: OntologyAttachmentIdMapping[];
16
+ }
17
+ export interface ApplyActionLiveOpts {
18
+ objects: Record<string, Collection<Record<string, unknown>>>;
19
+ context?: Record<string, unknown>;
20
+ attachmentUploads?: OntologyAttachmentUpload[];
21
+ idempotencyKey?: string;
22
+ }
23
+ export interface RunQueryLiveOpts {
24
+ objects: Record<string, Collection<Record<string, unknown>>>;
25
+ context?: Record<string, unknown>;
26
+ }
27
+ export interface OntologyAttachmentsAdapter {
28
+ generateAttachmentId?: (blob: Blob, opts: {
29
+ target?: AttachmentTypeDef;
30
+ }) => Promise<string> | string;
31
+ canMaterializeAttachment?: (attachment: v.attachment, opts: {
32
+ target?: AttachmentTypeDef;
33
+ }) => boolean;
34
+ materializeAttachment?: (attachment: v.attachment, blob: Blob, opts: {
35
+ target?: AttachmentTypeDef;
36
+ }) => Promise<v.attachment | void>;
37
+ getAttachmentContent: (attachment: v.attachment) => Promise<Blob>;
38
+ getAttachmentMetadata: (attachment: v.attachment) => Promise<v.attachment & {
39
+ size: number;
40
+ type: string;
41
+ name?: string;
42
+ }>;
43
+ }
44
+ export interface OntologyBackendAdapter {
45
+ name: string;
46
+ getCollectionOptions: (objectType: string) => OntologyCollectionOptions;
47
+ applyAction: (name: string, parameters: Record<string, unknown>, live: ApplyActionLiveOpts) => Promise<OntologyApplyActionResult | void>;
48
+ runQueryFunction: (name: string, parameters: Record<string, unknown>, live: RunQueryLiveOpts) => Promise<unknown>;
49
+ attachments?: OntologyAttachmentsAdapter;
50
+ cleanup?: () => void | Promise<void>;
51
+ }
52
+ export type OntologyBackendAdapterProvider<Context extends Record<string, unknown> = Record<string, unknown>> = (ir: OntologyIR, context: Context) => OntologyBackendAdapter | Promise<OntologyBackendAdapter>;
53
+ //# sourceMappingURL=OntologyBackendAdapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"OntologyBackendAdapter.d.ts","sourceRoot":"","sources":["../../src/live/OntologyBackendAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,oBAAoB,CAAC;AACxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEjE,MAAM,MAAM,yBAAyB,GAAG,IAAI,CACxC,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,EAC1D,QAAQ,CACX,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACrC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC;IACzB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED,MAAM,WAAW,2BAA2B;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACtC,oBAAoB,CAAC,EAAE,2BAA2B,EAAE,CAAC;CACxD;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,iBAAiB,CAAC,EAAE,wBAAwB,EAAE,CAAC;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,0BAA0B;IACvC,oBAAoB,CAAC,EAAE,CACnB,IAAI,EAAE,IAAI,EACV,IAAI,EAAE;QACF,MAAM,CAAC,EAAE,iBAAiB,CAAC;KAC9B,KACA,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAC9B,wBAAwB,CAAC,EAAE,CACvB,UAAU,EAAE,CAAC,CAAC,UAAU,EACxB,IAAI,EAAE;QACF,MAAM,CAAC,EAAE,iBAAiB,CAAC;KAC9B,KACA,OAAO,CAAC;IACb,qBAAqB,CAAC,EAAE,CACpB,UAAU,EAAE,CAAC,CAAC,UAAU,EACxB,IAAI,EAAE,IAAI,EACV,IAAI,EAAE;QACF,MAAM,CAAC,EAAE,iBAAiB,CAAC;KAC9B,KACA,OAAO,CAAC,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAClC,oBAAoB,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,qBAAqB,EAAE,CACnB,UAAU,EAAE,CAAC,CAAC,UAAU,KACvB,OAAO,CAAC,CAAC,CAAC,UAAU,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9E;AAED,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,yBAAyB,CAAC;IACxE,WAAW,EAAE,CACT,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,IAAI,EAAE,mBAAmB,KACxB,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;IAC/C,gBAAgB,EAAE,CACd,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,IAAI,EAAE,gBAAgB,KACrB,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,WAAW,CAAC,EAAE,0BAA0B,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAExC;AAED,MAAM,MAAM,8BAA8B,CACtC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACjE,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,KAAK,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=OntologyBackendAdapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"OntologyBackendAdapter.js","sourceRoot":"","sources":["../../src/live/OntologyBackendAdapter.ts"],"names":[],"mappings":""}