@x12i/memorix-service 3.7.1 → 3.7.7

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 (169) hide show
  1. package/dist/activity-ring.d.ts +185 -0
  2. package/dist/activity-ring.d.ts.map +1 -0
  3. package/dist/activity-ring.js +249 -0
  4. package/dist/activity-ring.js.map +1 -0
  5. package/dist/activity-routes.d.ts +3 -0
  6. package/dist/activity-routes.d.ts.map +1 -0
  7. package/dist/activity-routes.js +47 -0
  8. package/dist/activity-routes.js.map +1 -0
  9. package/dist/activity-ui.d.ts +3 -0
  10. package/dist/activity-ui.d.ts.map +1 -0
  11. package/dist/activity-ui.js +1105 -0
  12. package/dist/activity-ui.js.map +1 -0
  13. package/dist/app.d.ts.map +1 -1
  14. package/dist/app.js +21 -2
  15. package/dist/app.js.map +1 -1
  16. package/dist/caller-identity.d.ts +3 -2
  17. package/dist/caller-identity.d.ts.map +1 -1
  18. package/dist/caller-identity.js.map +1 -1
  19. package/dist/catalog-bridge.d.ts.map +1 -1
  20. package/dist/catalog-bridge.js +7 -1
  21. package/dist/catalog-bridge.js.map +1 -1
  22. package/dist/cli.d.ts.map +1 -1
  23. package/dist/cli.js +12 -0
  24. package/dist/cli.js.map +1 -1
  25. package/dist/connector-catalog.d.ts +1 -1
  26. package/dist/connector-ops/attempt-store.d.ts.map +1 -1
  27. package/dist/connector-ops/attempt-store.js +1 -3
  28. package/dist/connector-ops/attempt-store.js.map +1 -1
  29. package/dist/connector-ops/checkpoint-store.d.ts.map +1 -1
  30. package/dist/connector-ops/checkpoint-store.js +1 -3
  31. package/dist/connector-ops/checkpoint-store.js.map +1 -1
  32. package/dist/connector-ops/override-store.d.ts.map +1 -1
  33. package/dist/connector-ops/override-store.js +1 -3
  34. package/dist/connector-ops/override-store.js.map +1 -1
  35. package/dist/connector-ops/run-store.d.ts.map +1 -1
  36. package/dist/connector-ops/run-store.js +1 -3
  37. package/dist/connector-ops/run-store.js.map +1 -1
  38. package/dist/connector-ops/schedule-lease-store.d.ts.map +1 -1
  39. package/dist/connector-ops/schedule-lease-store.js +1 -3
  40. package/dist/connector-ops/schedule-lease-store.js.map +1 -1
  41. package/dist/data-changes-routes.d.ts +7 -0
  42. package/dist/data-changes-routes.d.ts.map +1 -0
  43. package/dist/data-changes-routes.js +27 -0
  44. package/dist/data-changes-routes.js.map +1 -0
  45. package/dist/data-changes-ui.d.ts +3 -0
  46. package/dist/data-changes-ui.d.ts.map +1 -0
  47. package/dist/data-changes-ui.js +239 -0
  48. package/dist/data-changes-ui.js.map +1 -0
  49. package/dist/data-changes.d.ts +51 -0
  50. package/dist/data-changes.d.ts.map +1 -0
  51. package/dist/data-changes.js +218 -0
  52. package/dist/data-changes.js.map +1 -0
  53. package/dist/errors.d.ts +3 -0
  54. package/dist/errors.d.ts.map +1 -1
  55. package/dist/errors.js +36 -3
  56. package/dist/errors.js.map +1 -1
  57. package/dist/graph-ui.d.ts +3 -0
  58. package/dist/graph-ui.d.ts.map +1 -0
  59. package/dist/graph-ui.js +676 -0
  60. package/dist/graph-ui.js.map +1 -0
  61. package/dist/identity-alias.d.ts +12 -0
  62. package/dist/identity-alias.d.ts.map +1 -0
  63. package/dist/identity-alias.js +22 -0
  64. package/dist/identity-alias.js.map +1 -0
  65. package/dist/incremental-state/state-store.d.ts.map +1 -1
  66. package/dist/incremental-state/state-store.js +1 -3
  67. package/dist/incremental-state/state-store.js.map +1 -1
  68. package/dist/integrations/instance-store.d.ts.map +1 -1
  69. package/dist/integrations/instance-store.js +1 -3
  70. package/dist/integrations/instance-store.js.map +1 -1
  71. package/dist/isolation.d.ts.map +1 -1
  72. package/dist/isolation.js +3 -2
  73. package/dist/isolation.js.map +1 -1
  74. package/dist/knowledge-upstream.d.ts +13 -0
  75. package/dist/knowledge-upstream.d.ts.map +1 -0
  76. package/dist/knowledge-upstream.js +38 -0
  77. package/dist/knowledge-upstream.js.map +1 -0
  78. package/dist/land-v2-guards.d.ts +22 -0
  79. package/dist/land-v2-guards.d.ts.map +1 -0
  80. package/dist/land-v2-guards.js +57 -0
  81. package/dist/land-v2-guards.js.map +1 -0
  82. package/dist/live-ops-nav.d.ts +2 -0
  83. package/dist/live-ops-nav.d.ts.map +1 -0
  84. package/dist/live-ops-nav.js +53 -0
  85. package/dist/live-ops-nav.js.map +1 -0
  86. package/dist/live.d.ts.map +1 -1
  87. package/dist/mcp/nexum-tools.d.ts +28 -0
  88. package/dist/mcp/nexum-tools.d.ts.map +1 -0
  89. package/dist/mcp/nexum-tools.js +257 -0
  90. package/dist/mcp/nexum-tools.js.map +1 -0
  91. package/dist/mcp/service-public-url.d.ts +7 -0
  92. package/dist/mcp/service-public-url.d.ts.map +1 -0
  93. package/dist/mcp/service-public-url.js +19 -0
  94. package/dist/mcp/service-public-url.js.map +1 -0
  95. package/dist/nexum-analysis/backfill.d.ts +59 -0
  96. package/dist/nexum-analysis/backfill.d.ts.map +1 -0
  97. package/dist/nexum-analysis/backfill.js +199 -0
  98. package/dist/nexum-analysis/backfill.js.map +1 -0
  99. package/dist/nexum-analysis/enqueue.d.ts +29 -0
  100. package/dist/nexum-analysis/enqueue.d.ts.map +1 -0
  101. package/dist/nexum-analysis/enqueue.js +190 -0
  102. package/dist/nexum-analysis/enqueue.js.map +1 -0
  103. package/dist/nexum-analysis/outbox.d.ts +44 -0
  104. package/dist/nexum-analysis/outbox.d.ts.map +1 -0
  105. package/dist/nexum-analysis/outbox.js +176 -0
  106. package/dist/nexum-analysis/outbox.js.map +1 -0
  107. package/dist/nexum-analysis/policy.d.ts +48 -0
  108. package/dist/nexum-analysis/policy.d.ts.map +1 -0
  109. package/dist/nexum-analysis/policy.js +165 -0
  110. package/dist/nexum-analysis/policy.js.map +1 -0
  111. package/dist/nexum-analysis/reconcile.d.ts +8 -0
  112. package/dist/nexum-analysis/reconcile.d.ts.map +1 -0
  113. package/dist/nexum-analysis/reconcile.js +37 -0
  114. package/dist/nexum-analysis/reconcile.js.map +1 -0
  115. package/dist/openapi/openapi.json +591 -4
  116. package/dist/operational-db.d.ts +6 -0
  117. package/dist/operational-db.d.ts.map +1 -0
  118. package/dist/operational-db.js +22 -0
  119. package/dist/operational-db.js.map +1 -0
  120. package/dist/platform.d.ts +4 -1
  121. package/dist/platform.d.ts.map +1 -1
  122. package/dist/platform.js +67 -14
  123. package/dist/platform.js.map +1 -1
  124. package/dist/request-countex.d.ts +25 -0
  125. package/dist/request-countex.d.ts.map +1 -1
  126. package/dist/request-countex.js +103 -18
  127. package/dist/request-countex.js.map +1 -1
  128. package/dist/restricted-store/object-store.d.ts.map +1 -1
  129. package/dist/restricted-store/object-store.js +1 -3
  130. package/dist/restricted-store/object-store.js.map +1 -1
  131. package/dist/routes/connector-invocations.d.ts.map +1 -1
  132. package/dist/routes/connector-invocations.js +7 -1
  133. package/dist/routes/connector-invocations.js.map +1 -1
  134. package/dist/routes/data.d.ts.map +1 -1
  135. package/dist/routes/data.js +113 -14
  136. package/dist/routes/data.js.map +1 -1
  137. package/dist/routes/knowledge.d.ts +8 -0
  138. package/dist/routes/knowledge.d.ts.map +1 -0
  139. package/dist/routes/knowledge.js +86 -0
  140. package/dist/routes/knowledge.js.map +1 -0
  141. package/dist/routes/memory.d.ts.map +1 -1
  142. package/dist/routes/memory.js +33 -9
  143. package/dist/routes/memory.js.map +1 -1
  144. package/dist/routes/metadata.d.ts.map +1 -1
  145. package/dist/routes/metadata.js +102 -1
  146. package/dist/routes/metadata.js.map +1 -1
  147. package/dist/routes/mgc-landing.d.ts.map +1 -1
  148. package/dist/routes/mgc-landing.js +90 -1
  149. package/dist/routes/mgc-landing.js.map +1 -1
  150. package/dist/routes/nexum-mcp.d.ts +9 -0
  151. package/dist/routes/nexum-mcp.d.ts.map +1 -0
  152. package/dist/routes/nexum-mcp.js +95 -0
  153. package/dist/routes/nexum-mcp.js.map +1 -0
  154. package/dist/routes/operations.d.ts.map +1 -1
  155. package/dist/routes/operations.js +39 -2
  156. package/dist/routes/operations.js.map +1 -1
  157. package/dist/routes/publications.d.ts +4 -0
  158. package/dist/routes/publications.d.ts.map +1 -0
  159. package/dist/routes/publications.js +111 -0
  160. package/dist/routes/publications.js.map +1 -0
  161. package/dist/routes/workflow.d.ts.map +1 -1
  162. package/dist/routes/workflow.js +18 -9
  163. package/dist/routes/workflow.js.map +1 -1
  164. package/dist/safe-query.d.ts +28 -0
  165. package/dist/safe-query.d.ts.map +1 -0
  166. package/dist/safe-query.js +104 -0
  167. package/dist/safe-query.js.map +1 -0
  168. package/openapi/openapi.json +591 -4
  169. package/package.json +5 -5
@@ -0,0 +1,111 @@
1
+ import { createMongoContentStore, createMongoDataPlane, verifyPublicationMembers, } from "@x12i/memorix-data";
2
+ import { resolveScope } from "../request-scope.js";
3
+ import { ServiceError } from "../errors.js";
4
+ import { requireDeploymentAccess } from "../access-gate.js";
5
+ export async function registerPublicationRoutes(app, platform) {
6
+ app.post("/api/data/publications", async (req) => {
7
+ requireDeploymentAccess(req, "write");
8
+ const scope = resolveScope(req);
9
+ const body = req.body;
10
+ if (!Array.isArray(body.members) || body.members.length === 0) {
11
+ throw new ServiceError("VALIDATION", "members[] required", 400);
12
+ }
13
+ const ports = platform.portsFor(scope);
14
+ const publication = await ports.publications.createDraft({
15
+ publicationId: body.publicationId,
16
+ members: body.members,
17
+ supersedes: body.supersedes,
18
+ });
19
+ return { scope, publication };
20
+ });
21
+ app.get("/api/data/publications", async (req) => {
22
+ const scope = resolveScope(req);
23
+ const q = req.query;
24
+ const ports = platform.portsFor(scope);
25
+ if (q.lastGood === "true") {
26
+ const publication = await ports.publications.lastCommitted();
27
+ return { scope, publication };
28
+ }
29
+ const publications = await ports.publications.list(q.status ? { status: q.status } : undefined);
30
+ return { scope, publications };
31
+ });
32
+ app.get("/api/data/publications/:publicationId", async (req) => {
33
+ const scope = resolveScope(req);
34
+ const { publicationId } = req.params;
35
+ const ports = platform.portsFor(scope);
36
+ const publication = await ports.publications.get(publicationId);
37
+ if (!publication) {
38
+ throw new ServiceError("PUBLICATION_NOT_FOUND", `publication ${publicationId} not found`, 404);
39
+ }
40
+ return { scope, publication, complete: publication.status === "committed" };
41
+ });
42
+ app.post("/api/data/publications/:publicationId/commit", async (req) => {
43
+ requireDeploymentAccess(req, "write");
44
+ const scope = resolveScope(req);
45
+ const { publicationId } = req.params;
46
+ const ports = platform.portsFor(scope);
47
+ const draft = await ports.publications.get(publicationId);
48
+ if (!draft) {
49
+ throw new ServiceError("PUBLICATION_NOT_FOUND", `publication ${publicationId} not found`, 404);
50
+ }
51
+ const client = platform.client;
52
+ if (!client) {
53
+ throw new ServiceError("CANONICAL_PORT_MISSING", "Mongo client required", 503);
54
+ }
55
+ const plane = createMongoDataPlane(client);
56
+ await verifyPublicationMembers({
57
+ members: draft.members,
58
+ catalog: ports.catalog,
59
+ contentStoreFor: ({ objectType, contentType, dataCategory }) => createMongoContentStore({
60
+ plane,
61
+ scope,
62
+ objectType,
63
+ contentType,
64
+ dataCategory,
65
+ }),
66
+ });
67
+ const publication = await ports.publications.commit(publicationId);
68
+ return { scope, publication, complete: true };
69
+ });
70
+ app.get("/api/data/publications/:publicationId/instances", async (req) => {
71
+ const scope = resolveScope(req);
72
+ const { publicationId } = req.params;
73
+ const ports = platform.portsFor(scope);
74
+ const publication = await ports.publications.get(publicationId);
75
+ if (!publication) {
76
+ throw new ServiceError("PUBLICATION_NOT_FOUND", `publication ${publicationId} not found`, 404);
77
+ }
78
+ if (publication.status !== "committed") {
79
+ throw new ServiceError("PUBLICATION_NOT_COMMITTED", "only committed publications can be read as pinned instances", 409, { status: publication.status });
80
+ }
81
+ const instances = [];
82
+ for (const member of publication.members) {
83
+ try {
84
+ const record = await ports.reader.getContent(scope, {
85
+ objectType: member.objectType,
86
+ contentType: member.contentType,
87
+ recordId: member.recordId,
88
+ discriminatorValue: member.discriminator,
89
+ });
90
+ if (record.revision !== member.revision) {
91
+ throw new ServiceError("PUBLICATION_MEMBER_UNAVAILABLE", "pinned instance revision no longer matches the manifest", 409, { member, actualRevision: record.revision });
92
+ }
93
+ instances.push({ member, record });
94
+ }
95
+ catch (err) {
96
+ if (err instanceof ServiceError)
97
+ throw err;
98
+ throw new ServiceError("PUBLICATION_MEMBER_UNAVAILABLE", "pinned instance cannot be retrieved", 409, { member, cause: err instanceof Error ? err.message : String(err) });
99
+ }
100
+ }
101
+ return {
102
+ scope,
103
+ publicationId,
104
+ commitMarker: publication.commitMarker,
105
+ complete: true,
106
+ instances,
107
+ note: "Pinned evidence only. Live relationship expansion is the current graph, not this manifest.",
108
+ };
109
+ });
110
+ }
111
+ //# sourceMappingURL=publications.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"publications.js","sourceRoot":"","sources":["../../src/routes/publications.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/routes/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAItD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAqHf"}
1
+ {"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/routes/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAKtD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CA2Hf"}
@@ -1,7 +1,8 @@
1
1
  import { resolveScope } from "../request-scope.js";
2
2
  import { ServiceError } from "../errors.js";
3
+ import { resolveWorkflowObjectType } from "../land-v2-guards.js";
3
4
  export async function registerWorkflowRoutes(app, platform) {
4
- app.get("/api/workflow", async (req) => {
5
+ app.get("/api/workflow", async (req, reply) => {
5
6
  const scope = resolveScope(req);
6
7
  const q = req.query;
7
8
  if (!q.id) {
@@ -13,8 +14,10 @@ export async function registerWorkflowRoutes(app, platform) {
13
14
  currentRevision: null,
14
15
  };
15
16
  }
17
+ const { objectType, deprecated } = resolveWorkflowObjectType(q.objectType);
18
+ if (deprecated)
19
+ reply.header("Deprecation", deprecated);
16
20
  const ports = platform.portsFor(scope);
17
- const objectType = q.objectType ?? "work-items";
18
21
  const record = await ports.reader.getContent(scope, {
19
22
  objectType,
20
23
  contentType: "workflow",
@@ -27,18 +30,20 @@ export async function registerWorkflowRoutes(app, platform) {
27
30
  contentType: "workflow",
28
31
  record,
29
32
  currentRevision: record.revision,
33
+ ...(deprecated ? { deprecation: deprecated } : {}),
30
34
  };
31
35
  });
32
- app.put("/api/workflow", async (req) => {
36
+ app.put("/api/workflow", async (req, reply) => {
33
37
  const scope = resolveScope(req);
34
38
  const body = req.body;
35
39
  if (!body?.id || !body.record) {
36
40
  throw new ServiceError("VALIDATION", "id and record required", 400);
37
41
  }
38
- if (body.expectedRevision === undefined) {
39
- throw new ServiceError("VALIDATION", "exact revision precondition required (expectedRevision)", 400);
40
- }
42
+ const { objectType, deprecated } = resolveWorkflowObjectType(body.objectType);
43
+ if (deprecated)
44
+ reply.header("Deprecation", deprecated);
41
45
  if (body.currentRevision !== undefined &&
46
+ body.expectedRevision !== undefined &&
42
47
  body.currentRevision !== body.expectedRevision) {
43
48
  throw new ServiceError("REVISION_CONFLICT", "stale expectedRevision — reload and retry", 409, {
44
49
  id: body.id,
@@ -47,7 +52,6 @@ export async function registerWorkflowRoutes(app, platform) {
47
52
  });
48
53
  }
49
54
  const ports = platform.portsFor(scope);
50
- const objectType = body.objectType ?? "work-items";
51
55
  try {
52
56
  const record = {
53
57
  ...body.record,
@@ -68,7 +72,7 @@ export async function registerWorkflowRoutes(app, platform) {
68
72
  existing = null;
69
73
  }
70
74
  let result;
71
- if (!existing && Number(body.expectedRevision) === 0) {
75
+ if (!existing) {
72
76
  result = await ports.writer.add({
73
77
  scope,
74
78
  precondition: { kind: "absent" },
@@ -76,9 +80,13 @@ export async function registerWorkflowRoutes(app, platform) {
76
80
  });
77
81
  }
78
82
  else {
83
+ const rev = Number(body.expectedRevision);
84
+ if (!Number.isInteger(rev) || rev < 1) {
85
+ throw new ServiceError("VALIDATION", "exact-revision precondition required (expectedRevision >= 1) to update workflow", 400);
86
+ }
79
87
  result = await ports.writer.upsert({
80
88
  scope,
81
- precondition: { kind: "revision", revision: Number(body.expectedRevision) },
89
+ precondition: { kind: "revision", revision: rev },
82
90
  record,
83
91
  });
84
92
  }
@@ -90,6 +98,7 @@ export async function registerWorkflowRoutes(app, platform) {
90
98
  status: "accepted",
91
99
  conflict: false,
92
100
  result,
101
+ ...(deprecated ? { deprecation: deprecated } : {}),
93
102
  };
94
103
  }
95
104
  catch (err) {
@@ -1 +1 @@
1
- {"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/routes/workflow.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAoB,EACpB,QAAyB;IAEzB,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,GAAG,CAAC,KAA6C,CAAC;QAC5D,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACV,OAAO;gBACL,KAAK;gBACL,EAAE,EAAE,IAAI;gBACR,WAAW,EAAE,UAAU;gBACvB,MAAM,EAAE,IAAI;gBACZ,eAAe,EAAE,IAAI;aACtB,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,CAAC,CAAC,UAAU,IAAI,YAAY,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE;YAClD,UAAU;YACV,WAAW,EAAE,UAAU;YACvB,QAAQ,EAAE,CAAC,CAAC,EAAE;SACf,CAAC,CAAC;QACH,OAAO;YACL,KAAK;YACL,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,UAAU;YACV,WAAW,EAAE,UAAU;YACvB,MAAM;YACN,eAAe,EAAE,MAAM,CAAC,QAAQ;SACjC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,GAAG,CAAC,IAMhB,CAAC;QACF,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,IAAI,YAAY,CAAC,YAAY,EAAE,wBAAwB,EAAE,GAAG,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,IAAI,YAAY,CACpB,YAAY,EACZ,yDAAyD,EACzD,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,IACE,IAAI,CAAC,eAAe,KAAK,SAAS;YAClC,IAAI,CAAC,eAAe,KAAK,IAAI,CAAC,gBAAgB,EAC9C,CAAC;YACD,MAAM,IAAI,YAAY,CACpB,mBAAmB,EACnB,2CAA2C,EAC3C,GAAG,EACH;gBACE,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;gBACvC,eAAe,EAAE,IAAI,CAAC,eAAe;aACtC,CACF,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,YAAY,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG;gBACb,GAAG,IAAI,CAAC,MAAM;gBACd,QAAQ,EAAE,IAAI,CAAC,EAAE;gBACjB,UAAU;gBACV,WAAW,EAAE,UAAU;gBACvB,YAAY,EAAE,QAAQ;aACD,CAAC;YAExB,IAAI,QAAQ,GAAG,IAAkE,CAAC;YAClF,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE;oBAC9C,UAAU;oBACV,WAAW,EAAE,UAAU;oBACvB,QAAQ,EAAE,IAAI,CAAC,EAAE;iBAClB,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;YAED,IAAI,MAAM,CAAC;YACX,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrD,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;oBAC9B,KAAK;oBACL,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAChC,MAAM;iBACP,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;oBACjC,KAAK;oBACL,YAAY,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE;oBAC3E,MAAM;iBACP,CAAC,CAAC;YACL,CAAC;YACD,OAAO;gBACL,KAAK;gBACL,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;gBACvC,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;gBACvC,MAAM,EAAE,UAAU;gBAClB,QAAQ,EAAE,KAAK;gBACf,MAAM;aACP,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,IAAI,6BAA6B,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5C,MAAM,IAAI,YAAY,CAAC,mBAAmB,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;YACxD,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}
1
+ {"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/routes/workflow.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ /**
2
+ * Parse OpenAPI SafeFilter / SafeSort query strings for GET /api/data/content.
3
+ * Grammar matches @x12i/memorix-data QueryFilter / QuerySort (no Mongo operators).
4
+ */
5
+ export type SafeFilter = {
6
+ field: string;
7
+ op: "eq" | "ne" | "gt" | "gte" | "lt" | "lte";
8
+ value: unknown;
9
+ } | {
10
+ field: string;
11
+ op: "in" | "nin";
12
+ value: unknown[];
13
+ } | {
14
+ field: string;
15
+ op: "exists";
16
+ value: boolean;
17
+ };
18
+ export type SafeSort = {
19
+ field: string;
20
+ direction: "asc" | "desc";
21
+ };
22
+ /**
23
+ * Accept SafeFilter[] JSON, a single SafeFilter, or an equality map
24
+ * `{ "data.status": "open" }` → `[{ field, op: "eq", value }]`.
25
+ */
26
+ export declare function parseSafeFilters(raw: string | undefined): SafeFilter[] | undefined;
27
+ export declare function parseSafeSort(raw: string | undefined): SafeSort[] | undefined;
28
+ //# sourceMappingURL=safe-query.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"safe-query.d.ts","sourceRoot":"","sources":["../src/safe-query.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,UAAU,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAChF;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,GAAG,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,GACrD;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpD,MAAM,MAAM,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,CAAC;AAsDpE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,EAAE,GAAG,SAAS,CAsBlF;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,EAAE,GAAG,SAAS,CAiB7E"}
@@ -0,0 +1,104 @@
1
+ /**
2
+ * Parse OpenAPI SafeFilter / SafeSort query strings for GET /api/data/content.
3
+ * Grammar matches @x12i/memorix-data QueryFilter / QuerySort (no Mongo operators).
4
+ */
5
+ import { ServiceError } from "./errors.js";
6
+ const SCALAR_OPS = new Set(["eq", "ne", "gt", "gte", "lt", "lte"]);
7
+ const ARRAY_OPS = new Set(["in", "nin"]);
8
+ function isRecord(v) {
9
+ return Boolean(v) && typeof v === "object" && !Array.isArray(v);
10
+ }
11
+ function parseJsonParam(raw, label) {
12
+ try {
13
+ return JSON.parse(raw);
14
+ }
15
+ catch {
16
+ throw new ServiceError("VALIDATION", `${label} must be valid JSON`, 400);
17
+ }
18
+ }
19
+ function assertFilter(raw, index) {
20
+ if (!isRecord(raw)) {
21
+ throw new ServiceError("READ_QUERY_INVALID", `filter[${index}] must be an object`, 400);
22
+ }
23
+ const field = raw.field;
24
+ const op = raw.op;
25
+ if (typeof field !== "string" || !field.trim()) {
26
+ throw new ServiceError("READ_QUERY_INVALID", `filter[${index}].field must be a non-empty string`, 400);
27
+ }
28
+ if (typeof op !== "string") {
29
+ throw new ServiceError("READ_QUERY_INVALID", `filter[${index}].op is required`, 400);
30
+ }
31
+ if (SCALAR_OPS.has(op)) {
32
+ if (!("value" in raw)) {
33
+ throw new ServiceError("READ_QUERY_INVALID", `filter[${index}].value is required`, 400);
34
+ }
35
+ return {
36
+ field,
37
+ op: op,
38
+ value: raw.value,
39
+ };
40
+ }
41
+ if (ARRAY_OPS.has(op)) {
42
+ if (!Array.isArray(raw.value)) {
43
+ throw new ServiceError("READ_QUERY_INVALID", `filter[${index}].value must be an array for op ${op}`, 400);
44
+ }
45
+ return { field, op: op, value: raw.value };
46
+ }
47
+ if (op === "exists") {
48
+ if (typeof raw.value !== "boolean") {
49
+ throw new ServiceError("READ_QUERY_INVALID", `filter[${index}].value must be boolean for op exists`, 400);
50
+ }
51
+ return { field, op: "exists", value: raw.value };
52
+ }
53
+ throw new ServiceError("READ_QUERY_INVALID", `Unsupported filter op: ${JSON.stringify(op)}`, 400);
54
+ }
55
+ /**
56
+ * Accept SafeFilter[] JSON, a single SafeFilter, or an equality map
57
+ * `{ "data.status": "open" }` → `[{ field, op: "eq", value }]`.
58
+ */
59
+ export function parseSafeFilters(raw) {
60
+ if (raw == null || raw.trim() === "")
61
+ return undefined;
62
+ const parsed = parseJsonParam(raw, "filter");
63
+ if (Array.isArray(parsed)) {
64
+ if (parsed.length === 0)
65
+ return undefined;
66
+ return parsed.map((f, i) => assertFilter(f, i));
67
+ }
68
+ if (isRecord(parsed)) {
69
+ if ("field" in parsed && "op" in parsed) {
70
+ return [assertFilter(parsed, 0)];
71
+ }
72
+ // Equality map — keys are field paths, values are eq targets.
73
+ const out = [];
74
+ for (const [field, value] of Object.entries(parsed)) {
75
+ if (!field.trim()) {
76
+ throw new ServiceError("READ_QUERY_INVALID", "filter field must be a non-empty string", 400);
77
+ }
78
+ out.push({ field, op: "eq", value });
79
+ }
80
+ return out.length ? out : undefined;
81
+ }
82
+ throw new ServiceError("READ_QUERY_INVALID", "filter must be a JSON array or object", 400);
83
+ }
84
+ export function parseSafeSort(raw) {
85
+ if (raw == null || raw.trim() === "")
86
+ return undefined;
87
+ const parsed = parseJsonParam(raw, "sort");
88
+ const items = Array.isArray(parsed) ? parsed : [parsed];
89
+ if (items.length === 0)
90
+ return undefined;
91
+ const out = [];
92
+ for (let i = 0; i < items.length; i++) {
93
+ const s = items[i];
94
+ if (!isRecord(s) || typeof s.field !== "string" || !s.field.trim()) {
95
+ throw new ServiceError("READ_QUERY_INVALID", `sort[${i}].field must be a non-empty string`, 400);
96
+ }
97
+ if (s.direction !== "asc" && s.direction !== "desc") {
98
+ throw new ServiceError("READ_QUERY_INVALID", `sort[${i}].direction must be asc|desc`, 400);
99
+ }
100
+ out.push({ field: s.field, direction: s.direction });
101
+ }
102
+ return out;
103
+ }
104
+ //# sourceMappingURL=safe-query.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"safe-query.js","sourceRoot":"","sources":["../src/safe-query.ts"],"names":[],"mappings":"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"}