@lssm/example.workflow-system 0.0.0-canary-20251221165922 → 0.0.0-canary-20251221185840
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/dist/approval/approval.contracts.d.ts +133 -133
- package/dist/approval/approval.contracts.d.ts.map +1 -1
- package/dist/approval/approval.enum.d.ts +3 -3
- package/dist/approval/approval.event.d.ts +31 -31
- package/dist/approval/approval.schema.d.ts +24 -24
- package/dist/approval/approval.schema.d.ts.map +1 -1
- package/dist/entities/approval.d.ts +36 -36
- package/dist/entities/approval.d.ts.map +1 -1
- package/dist/entities/index.d.ts +127 -127
- package/dist/entities/index.d.ts.map +1 -1
- package/dist/entities/instance.d.ts +47 -47
- package/dist/entities/step.d.ts +32 -32
- package/dist/entities/step.d.ts.map +1 -1
- package/dist/entities/workflow.d.ts +23 -23
- package/dist/instance/instance.contracts.d.ts +256 -256
- package/dist/instance/instance.contracts.d.ts.map +1 -1
- package/dist/instance/instance.enum.d.ts +2 -2
- package/dist/instance/instance.event.d.ts +87 -87
- package/dist/instance/instance.event.d.ts.map +1 -1
- package/dist/instance/instance.schema.d.ts +54 -54
- package/dist/libs/contracts/dist/data-views/data-views.js +7 -1
- package/dist/libs/contracts/dist/data-views/data-views.js.map +1 -0
- package/dist/libs/contracts/dist/features.js +7 -1
- package/dist/libs/contracts/dist/features.js.map +1 -0
- package/dist/libs/contracts/dist/operations/registry.js +7 -1
- package/dist/libs/contracts/dist/operations/registry.js.map +1 -0
- package/dist/libs/contracts/dist/presentations/presentations.js +7 -1
- package/dist/libs/contracts/dist/presentations/presentations.js.map +1 -0
- package/dist/libs/contracts/dist/workflow/spec.js +7 -1
- package/dist/libs/contracts/dist/workflow/spec.js.map +1 -0
- package/dist/workflow/workflow.contracts.d.ts +245 -245
- package/dist/workflow/workflow.enum.d.ts +5 -5
- package/dist/workflow/workflow.event.d.ts +32 -32
- package/package.json +11 -11
|
@@ -1,220 +1,220 @@
|
|
|
1
|
-
import * as
|
|
1
|
+
import * as _lssm_lib_schema825 from "@lssm/lib.schema";
|
|
2
2
|
|
|
3
3
|
//#region src/instance/instance.schema.d.ts
|
|
4
4
|
/**
|
|
5
5
|
* A running workflow instance.
|
|
6
6
|
*/
|
|
7
|
-
declare const WorkflowInstanceModel:
|
|
7
|
+
declare const WorkflowInstanceModel: _lssm_lib_schema825.SchemaModel<{
|
|
8
8
|
id: {
|
|
9
|
-
type:
|
|
9
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
10
10
|
isOptional: false;
|
|
11
11
|
};
|
|
12
12
|
workflowDefinitionId: {
|
|
13
|
-
type:
|
|
13
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
14
14
|
isOptional: false;
|
|
15
15
|
};
|
|
16
16
|
referenceId: {
|
|
17
|
-
type:
|
|
17
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
18
18
|
isOptional: true;
|
|
19
19
|
};
|
|
20
20
|
referenceType: {
|
|
21
|
-
type:
|
|
21
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
22
22
|
isOptional: true;
|
|
23
23
|
};
|
|
24
24
|
status: {
|
|
25
|
-
type:
|
|
25
|
+
type: _lssm_lib_schema825.EnumType<[string, string, string, string, string, string, string, string]>;
|
|
26
26
|
isOptional: false;
|
|
27
27
|
};
|
|
28
28
|
currentStepId: {
|
|
29
|
-
type:
|
|
29
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
30
30
|
isOptional: true;
|
|
31
31
|
};
|
|
32
32
|
contextData: {
|
|
33
|
-
type:
|
|
33
|
+
type: _lssm_lib_schema825.FieldType<unknown, unknown>;
|
|
34
34
|
isOptional: true;
|
|
35
35
|
};
|
|
36
36
|
triggeredBy: {
|
|
37
|
-
type:
|
|
37
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
38
38
|
isOptional: false;
|
|
39
39
|
};
|
|
40
40
|
organizationId: {
|
|
41
|
-
type:
|
|
41
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
42
42
|
isOptional: false;
|
|
43
43
|
};
|
|
44
44
|
priority: {
|
|
45
|
-
type:
|
|
45
|
+
type: _lssm_lib_schema825.FieldType<number, number>;
|
|
46
46
|
isOptional: false;
|
|
47
47
|
};
|
|
48
48
|
dueAt: {
|
|
49
|
-
type:
|
|
49
|
+
type: _lssm_lib_schema825.FieldType<Date, string>;
|
|
50
50
|
isOptional: true;
|
|
51
51
|
};
|
|
52
52
|
outcome: {
|
|
53
|
-
type:
|
|
53
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
54
54
|
isOptional: true;
|
|
55
55
|
};
|
|
56
56
|
resultData: {
|
|
57
|
-
type:
|
|
57
|
+
type: _lssm_lib_schema825.FieldType<unknown, unknown>;
|
|
58
58
|
isOptional: true;
|
|
59
59
|
};
|
|
60
60
|
errorMessage: {
|
|
61
|
-
type:
|
|
61
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
62
62
|
isOptional: true;
|
|
63
63
|
};
|
|
64
64
|
createdAt: {
|
|
65
|
-
type:
|
|
65
|
+
type: _lssm_lib_schema825.FieldType<Date, string>;
|
|
66
66
|
isOptional: false;
|
|
67
67
|
};
|
|
68
68
|
startedAt: {
|
|
69
|
-
type:
|
|
69
|
+
type: _lssm_lib_schema825.FieldType<Date, string>;
|
|
70
70
|
isOptional: true;
|
|
71
71
|
};
|
|
72
72
|
completedAt: {
|
|
73
|
-
type:
|
|
73
|
+
type: _lssm_lib_schema825.FieldType<Date, string>;
|
|
74
74
|
isOptional: true;
|
|
75
75
|
};
|
|
76
76
|
}>;
|
|
77
77
|
/**
|
|
78
78
|
* Input for starting a workflow.
|
|
79
79
|
*/
|
|
80
|
-
declare const StartWorkflowInputModel:
|
|
80
|
+
declare const StartWorkflowInputModel: _lssm_lib_schema825.SchemaModel<{
|
|
81
81
|
workflowKey: {
|
|
82
|
-
type:
|
|
82
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
83
83
|
isOptional: false;
|
|
84
84
|
};
|
|
85
85
|
contextData: {
|
|
86
|
-
type:
|
|
86
|
+
type: _lssm_lib_schema825.FieldType<unknown, unknown>;
|
|
87
87
|
isOptional: true;
|
|
88
88
|
};
|
|
89
89
|
referenceId: {
|
|
90
|
-
type:
|
|
90
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
91
91
|
isOptional: true;
|
|
92
92
|
};
|
|
93
93
|
referenceType: {
|
|
94
|
-
type:
|
|
94
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
95
95
|
isOptional: true;
|
|
96
96
|
};
|
|
97
97
|
priority: {
|
|
98
|
-
type:
|
|
98
|
+
type: _lssm_lib_schema825.FieldType<number, number>;
|
|
99
99
|
isOptional: true;
|
|
100
100
|
};
|
|
101
101
|
dueAt: {
|
|
102
|
-
type:
|
|
102
|
+
type: _lssm_lib_schema825.FieldType<Date, string>;
|
|
103
103
|
isOptional: true;
|
|
104
104
|
};
|
|
105
105
|
}>;
|
|
106
106
|
/**
|
|
107
107
|
* Input for transitioning a workflow.
|
|
108
108
|
*/
|
|
109
|
-
declare const TransitionInputModel:
|
|
109
|
+
declare const TransitionInputModel: _lssm_lib_schema825.SchemaModel<{
|
|
110
110
|
instanceId: {
|
|
111
|
-
type:
|
|
111
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
112
112
|
isOptional: false;
|
|
113
113
|
};
|
|
114
114
|
action: {
|
|
115
|
-
type:
|
|
115
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
116
116
|
isOptional: false;
|
|
117
117
|
};
|
|
118
118
|
data: {
|
|
119
|
-
type:
|
|
119
|
+
type: _lssm_lib_schema825.FieldType<unknown, unknown>;
|
|
120
120
|
isOptional: true;
|
|
121
121
|
};
|
|
122
122
|
comment: {
|
|
123
|
-
type:
|
|
123
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
124
124
|
isOptional: true;
|
|
125
125
|
};
|
|
126
126
|
}>;
|
|
127
127
|
/**
|
|
128
128
|
* Result of a workflow transition.
|
|
129
129
|
*/
|
|
130
|
-
declare const TransitionResultModel:
|
|
130
|
+
declare const TransitionResultModel: _lssm_lib_schema825.SchemaModel<{
|
|
131
131
|
success: {
|
|
132
|
-
type:
|
|
132
|
+
type: _lssm_lib_schema825.FieldType<boolean, boolean>;
|
|
133
133
|
isOptional: false;
|
|
134
134
|
};
|
|
135
135
|
instance: {
|
|
136
|
-
type:
|
|
136
|
+
type: _lssm_lib_schema825.SchemaModel<{
|
|
137
137
|
id: {
|
|
138
|
-
type:
|
|
138
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
139
139
|
isOptional: false;
|
|
140
140
|
};
|
|
141
141
|
workflowDefinitionId: {
|
|
142
|
-
type:
|
|
142
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
143
143
|
isOptional: false;
|
|
144
144
|
};
|
|
145
145
|
referenceId: {
|
|
146
|
-
type:
|
|
146
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
147
147
|
isOptional: true;
|
|
148
148
|
};
|
|
149
149
|
referenceType: {
|
|
150
|
-
type:
|
|
150
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
151
151
|
isOptional: true;
|
|
152
152
|
};
|
|
153
153
|
status: {
|
|
154
|
-
type:
|
|
154
|
+
type: _lssm_lib_schema825.EnumType<[string, string, string, string, string, string, string, string]>;
|
|
155
155
|
isOptional: false;
|
|
156
156
|
};
|
|
157
157
|
currentStepId: {
|
|
158
|
-
type:
|
|
158
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
159
159
|
isOptional: true;
|
|
160
160
|
};
|
|
161
161
|
contextData: {
|
|
162
|
-
type:
|
|
162
|
+
type: _lssm_lib_schema825.FieldType<unknown, unknown>;
|
|
163
163
|
isOptional: true;
|
|
164
164
|
};
|
|
165
165
|
triggeredBy: {
|
|
166
|
-
type:
|
|
166
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
167
167
|
isOptional: false;
|
|
168
168
|
};
|
|
169
169
|
organizationId: {
|
|
170
|
-
type:
|
|
170
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
171
171
|
isOptional: false;
|
|
172
172
|
};
|
|
173
173
|
priority: {
|
|
174
|
-
type:
|
|
174
|
+
type: _lssm_lib_schema825.FieldType<number, number>;
|
|
175
175
|
isOptional: false;
|
|
176
176
|
};
|
|
177
177
|
dueAt: {
|
|
178
|
-
type:
|
|
178
|
+
type: _lssm_lib_schema825.FieldType<Date, string>;
|
|
179
179
|
isOptional: true;
|
|
180
180
|
};
|
|
181
181
|
outcome: {
|
|
182
|
-
type:
|
|
182
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
183
183
|
isOptional: true;
|
|
184
184
|
};
|
|
185
185
|
resultData: {
|
|
186
|
-
type:
|
|
186
|
+
type: _lssm_lib_schema825.FieldType<unknown, unknown>;
|
|
187
187
|
isOptional: true;
|
|
188
188
|
};
|
|
189
189
|
errorMessage: {
|
|
190
|
-
type:
|
|
190
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
191
191
|
isOptional: true;
|
|
192
192
|
};
|
|
193
193
|
createdAt: {
|
|
194
|
-
type:
|
|
194
|
+
type: _lssm_lib_schema825.FieldType<Date, string>;
|
|
195
195
|
isOptional: false;
|
|
196
196
|
};
|
|
197
197
|
startedAt: {
|
|
198
|
-
type:
|
|
198
|
+
type: _lssm_lib_schema825.FieldType<Date, string>;
|
|
199
199
|
isOptional: true;
|
|
200
200
|
};
|
|
201
201
|
completedAt: {
|
|
202
|
-
type:
|
|
202
|
+
type: _lssm_lib_schema825.FieldType<Date, string>;
|
|
203
203
|
isOptional: true;
|
|
204
204
|
};
|
|
205
205
|
}>;
|
|
206
206
|
isOptional: false;
|
|
207
207
|
};
|
|
208
208
|
previousStepKey: {
|
|
209
|
-
type:
|
|
209
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
210
210
|
isOptional: true;
|
|
211
211
|
};
|
|
212
212
|
currentStepKey: {
|
|
213
|
-
type:
|
|
213
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
214
214
|
isOptional: true;
|
|
215
215
|
};
|
|
216
216
|
message: {
|
|
217
|
-
type:
|
|
217
|
+
type: _lssm_lib_schema825.FieldType<string, string>;
|
|
218
218
|
isOptional: true;
|
|
219
219
|
};
|
|
220
220
|
}>;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"data-views.js","names":[],"sources":["../../../../../../../libs/contracts/dist/data-views/data-views.js"],"sourcesContent":["import { filterBy, getUniqueTags, groupBy, init_registry_utils } from \"../registry-utils.js\";\n\n//#region src/data-views/data-views.ts\ninit_registry_utils();\nfunction keyOf(spec) {\n\treturn `${spec.meta.name}.v${spec.meta.version}`;\n}\nvar DataViewRegistry = class {\n\titems = /* @__PURE__ */ new Map();\n\tregister(spec) {\n\t\tconst key = keyOf(spec);\n\t\tif (this.items.has(key)) throw new Error(`Duplicate data view ${key}`);\n\t\tthis.items.set(key, spec);\n\t\treturn this;\n\t}\n\tlist() {\n\t\treturn [...this.items.values()];\n\t}\n\tget(name, version) {\n\t\tif (version != null) return this.items.get(`${name}.v${version}`);\n\t\tlet candidate;\n\t\tlet max = -Infinity;\n\t\tfor (const spec of this.items.values()) {\n\t\t\tif (spec.meta.name !== name) continue;\n\t\t\tif (spec.meta.version > max) {\n\t\t\t\tmax = spec.meta.version;\n\t\t\t\tcandidate = spec;\n\t\t\t}\n\t\t}\n\t\treturn candidate;\n\t}\n\t/** Filter data views by criteria. */\n\tfilter(criteria) {\n\t\treturn filterBy(this.list(), criteria);\n\t}\n\t/** List data views with specific tag. */\n\tlistByTag(tag) {\n\t\treturn this.list().filter((d) => d.meta.tags?.includes(tag));\n\t}\n\t/** List data views by owner. */\n\tlistByOwner(owner) {\n\t\treturn this.list().filter((d) => d.meta.owners?.includes(owner));\n\t}\n\t/** Group data views by key function. */\n\tgroupBy(keyFn) {\n\t\treturn groupBy(this.list(), keyFn);\n\t}\n\t/** Get unique tags from all data views. */\n\tgetUniqueTags() {\n\t\treturn getUniqueTags(this.list());\n\t}\n};\nfunction dataViewKey(spec) {\n\treturn keyOf(spec);\n}\n\n//#endregion\nexport { DataViewRegistry, dataViewKey };"],"mappings":";;;AAGA,qBAAqB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"features.js","names":[],"sources":["../../../../../../libs/contracts/dist/features.js"],"sourcesContent":["import { filterBy, getUniqueTags, groupBy, init_registry_utils } from \"./registry-utils.js\";\n\n//#region src/features.ts\ninit_registry_utils();\nfunction keyOf(f) {\n\treturn f.meta.key;\n}\n/** In-memory registry for FeatureModuleSpec. */\nvar FeatureRegistry = class {\n\titems = /* @__PURE__ */ new Map();\n\t/** Register a feature module. Throws when the key already exists. */\n\tregister(f) {\n\t\tconst key = keyOf(f);\n\t\tif (this.items.has(key)) throw new Error(`Duplicate feature ${key}`);\n\t\tthis.items.set(key, f);\n\t\treturn this;\n\t}\n\t/** List all registered feature modules. */\n\tlist() {\n\t\treturn [...this.items.values()];\n\t}\n\t/** Get a feature by its key (slug). */\n\tget(key) {\n\t\treturn this.items.get(key);\n\t}\n\t/** Filter features by criteria. */\n\tfilter(criteria) {\n\t\treturn filterBy(this.list(), criteria);\n\t}\n\t/** List features with specific tag. */\n\tlistByTag(tag) {\n\t\treturn this.list().filter((f) => f.meta.tags?.includes(tag));\n\t}\n\t/** List features by owner. */\n\tlistByOwner(owner) {\n\t\treturn this.list().filter((f) => f.meta.owners?.includes(owner));\n\t}\n\t/** Group features by key function. */\n\tgroupBy(keyFn) {\n\t\treturn groupBy(this.list(), keyFn);\n\t}\n\t/** Get unique tags from all features. */\n\tgetUniqueTags() {\n\t\treturn getUniqueTags(this.list());\n\t}\n};\n/** Validate and register a feature against optional registries/descriptors. */\nfunction installFeature(feature, deps) {\n\tif (deps.ops && feature.operations) {\n\t\tfor (const o of feature.operations) if (!deps.ops.getSpec(o.name, o.version)) throw new Error(`installFeature: operation not found ${o.name}.v${o.version}`);\n\t}\n\tif (deps.presentations && feature.presentations) {\n\t\tfor (const p of feature.presentations) if (!deps.presentations.get(p.name, p.version)) throw new Error(`installFeature: presentation not found ${p.name}.v${p.version}`);\n\t}\n\tif (feature.presentationsTargets && deps.descriptorsV2) for (const req of feature.presentationsTargets) {\n\t\tconst d = deps.descriptorsV2.find((x) => x.meta.name === req.name && x.meta.version === req.version);\n\t\tif (!d) throw new Error(`installFeature: V2 descriptor not found ${req.name}.v${req.version}`);\n\t\tfor (const t of req.targets) if (!d.targets.includes(t)) throw new Error(`installFeature: descriptor ${req.name}.v${req.version} missing target ${t}`);\n\t}\n\tif (feature.opToPresentation && feature.opToPresentation.length > 0) for (const link of feature.opToPresentation) {\n\t\tif (deps.ops) {\n\t\t\tif (!deps.ops.getSpec(link.op.name, link.op.version)) throw new Error(`installFeature: linked op not found ${link.op.name}.v${link.op.version}`);\n\t\t}\n\t\tif (deps.presentations) {\n\t\t\tif (!deps.presentations.get(link.pres.name, link.pres.version)) throw new Error(`installFeature: linked presentation not found ${link.pres.name}.v${link.pres.version}`);\n\t\t}\n\t}\n\tif (deps.capabilities && feature.capabilities?.provides) {\n\t\tfor (const cap of feature.capabilities.provides) if (!deps.capabilities.get(cap.key, cap.version)) throw new Error(`installFeature: capability not registered ${cap.key}.v${cap.version}`);\n\t}\n\tif (feature.capabilities?.requires?.length) {\n\t\tif (!deps.capabilities) throw new Error(`installFeature: capability registry required to validate capability requirements for ${feature.meta.key}`);\n\t\tconst provided = feature.capabilities.provides ?? [];\n\t\tfor (const req of feature.capabilities.requires) if (!deps.capabilities.satisfies(req, provided)) throw new Error(`installFeature: capability requirement not satisfied ${req.key}${req.version ? `.v${req.version}` : \"\"}`);\n\t}\n\tdeps.features.register(feature);\n\treturn deps.features;\n}\n/** Ensure declared target requirements exist on the provided descriptors. */\nfunction validateFeatureTargetsV2(feature, descriptors) {\n\tif (!feature.presentationsTargets || feature.presentationsTargets.length === 0) return true;\n\tfor (const req of feature.presentationsTargets) {\n\t\tconst d = descriptors.find((x) => x.meta.name === req.name && x.meta.version === req.version);\n\t\tif (!d) throw new Error(`V2 descriptor not found ${req.name}.v${req.version}`);\n\t\tfor (const t of req.targets) if (!d.targets.includes(t)) throw new Error(`Descriptor ${req.name}.v${req.version} missing target ${t}`);\n\t}\n\treturn true;\n}\n\n//#endregion\nexport { FeatureRegistry, installFeature, validateFeatureTargetsV2 };"],"mappings":";;;AAGA,qBAAqB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry.js","names":[],"sources":["../../../../../../../libs/contracts/dist/operations/registry.js"],"sourcesContent":["import { eventKey } from \"../events.js\";\nimport { GroupingStrategies, filterBy, getUniqueOwners, getUniqueTags, groupBy, init_registry_utils } from \"../registry-utils.js\";\nimport { isEmitDeclRef } from \"./operation.js\";\n\n//#region src/operations/registry.ts\ninit_registry_utils();\nfunction opKey(name, version) {\n\treturn `${name}.v${version}`;\n}\n/**\n* In-memory registry for ContractSpecs and their bound handlers.\n* Provides validation, policy enforcement, and guarded event emission at execute time.\n*/\nvar OperationSpecRegistry = class {\n\tspecs = /* @__PURE__ */ new Map();\n\thandlers = /* @__PURE__ */ new Map();\n\t/**\n\t* Registers a OperationSpec definition.\n\t*\n\t* @param spec - The contract specification to register.\n\t* @returns The registry instance for chaining.\n\t* @throws If a spec with the same name and version is already registered.\n\t*/\n\tregister(spec) {\n\t\tconst key = opKey(spec.meta.name, spec.meta.version);\n\t\tif (this.specs.has(key)) throw new Error(`Duplicate spec ${key}`);\n\t\tthis.specs.set(key, spec);\n\t\treturn this;\n\t}\n\t/**\n\t* Binds a runtime handler implementation to a previously registered spec.\n\t*\n\t* @param spec - The spec to bind to.\n\t* @param handler - The async function implementing the business logic.\n\t* @returns The registry instance for chaining.\n\t* @throws If the spec is not found or a handler is already bound.\n\t*/\n\tbind(spec, handler) {\n\t\tconst key = opKey(spec.meta.name, spec.meta.version);\n\t\tif (!this.specs.has(key)) throw new Error(`Cannot bind; spec not found: ${key}`);\n\t\tif (this.handlers.has(key)) throw new Error(`Handler already bound for ${key}`);\n\t\tthis.handlers.set(key, handler);\n\t\treturn this;\n\t}\n\t/**\n\t* Retrieves a registered spec by name and version.\n\t* If version is omitted, returns the highest version found.\n\t*\n\t* @param name - Operation name.\n\t* @param version - (Optional) Specific version.\n\t*/\n\tgetSpec(name, version) {\n\t\tif (version != null) return this.specs.get(opKey(name, version));\n\t\tlet found;\n\t\tlet maxV = -Infinity;\n\t\tfor (const [k, s] of this.specs.entries()) {\n\t\t\tif (!k.startsWith(`${name}.v`)) continue;\n\t\t\tif (s.meta.version > maxV) {\n\t\t\t\tmaxV = s.meta.version;\n\t\t\t\tfound = s;\n\t\t\t}\n\t\t}\n\t\treturn found;\n\t}\n\t/**\n\t* Retrieves the bound handler for a spec.\n\t*/\n\tgetHandler(name, version) {\n\t\tconst spec = this.getSpec(name, version);\n\t\tif (!spec) return void 0;\n\t\treturn this.handlers.get(opKey(spec.meta.name, spec.meta.version));\n\t}\n\t/** Iterate all registered specs. */\n\tlistSpecs() {\n\t\treturn [...this.specs.values()];\n\t}\n\t/** Iterate all bound operations (spec+handler). */\n\tlistBound() {\n\t\tconst out = [];\n\t\tfor (const [k, spec] of this.specs.entries()) {\n\t\t\tconst h = this.handlers.get(k);\n\t\t\tif (h) out.push({\n\t\t\t\tspec,\n\t\t\t\thandler: h\n\t\t\t});\n\t\t}\n\t\treturn out;\n\t}\n\t/**\n\t* Filter specs by criteria.\n\t*/\n\tfilter(criteria) {\n\t\treturn filterBy(this.listSpecs(), criteria);\n\t}\n\t/**\n\t* List specs with specific tag.\n\t*/\n\tlistByTag(tag) {\n\t\treturn this.listSpecs().filter((s) => s.meta.tags?.includes(tag));\n\t}\n\t/**\n\t* List specs by owner.\n\t*/\n\tlistByOwner(owner) {\n\t\treturn this.listSpecs().filter((s) => s.meta.owners?.includes(owner));\n\t}\n\t/**\n\t* Group specs by key function.\n\t*/\n\tgroupBy(keyFn) {\n\t\treturn groupBy(this.listSpecs(), keyFn);\n\t}\n\t/**\n\t* Group by domain (first segment of name).\n\t*/\n\tgroupByDomain() {\n\t\treturn this.groupBy(GroupingStrategies.byDomain);\n\t}\n\t/**\n\t* Group by tag.\n\t*/\n\tgroupByTag() {\n\t\treturn this.groupBy(GroupingStrategies.byTag);\n\t}\n\t/**\n\t* Get unique tags from all specs.\n\t*/\n\tgetUniqueTags() {\n\t\treturn getUniqueTags(this.listSpecs());\n\t}\n\t/**\n\t* Get unique owners from all specs.\n\t*/\n\tgetUniqueOwners() {\n\t\treturn getUniqueOwners(this.listSpecs());\n\t}\n\t/**\n\t* Execute an operation by name/version with full runtime protections:\n\t* 1. Validates input against Zod schema.\n\t* 2. Enforces policy (Auth, RBAC, Rate Limits) via PDP.\n\t* 3. Guards event emission to ensure only declared events are sent.\n\t* 4. Validates output against Zod schema (if applicable).\n\t* 5. Tracks telemetry (success/failure).\n\t*\n\t* @param name - Operation name.\n\t* @param version - Operation version (optional, defaults to latest).\n\t* @param rawInput - The raw input payload (e.g. from JSON body).\n\t* @param ctx - The runtime context (actor, tenant, etc.).\n\t*/\n\tasync execute(name, version, rawInput, ctx) {\n\t\tconst baseSpec = this.getSpec(name, version);\n\t\tif (!baseSpec) throw new Error(`Spec not found for ${name}${version ? `.v${version}` : \"\"}`);\n\t\tconst spec = await ctx.specVariantResolver?.resolve({\n\t\t\tname: baseSpec.meta.name,\n\t\t\tversion: baseSpec.meta.version,\n\t\t\tkind: baseSpec.meta.kind\n\t\t}, ctx) ?? baseSpec;\n\t\tlet key = opKey(spec.meta.name, spec.meta.version);\n\t\tlet handler = this.handlers.get(key);\n\t\tif (!handler) {\n\t\t\tconst fallbackKey = opKey(baseSpec.meta.name, baseSpec.meta.version);\n\t\t\thandler = this.handlers.get(fallbackKey);\n\t\t\tkey = fallbackKey;\n\t\t}\n\t\tif (!handler) throw new Error(`No handler bound for ${key}`);\n\t\tconst parsedInput = spec.io.input?.getZod().parse(rawInput);\n\t\tif (ctx.decide) {\n\t\t\tconst [service, command] = spec.meta.name.split(\".\");\n\t\t\tif (!service || !command) throw new Error(`Invalid spec name: ${spec.meta.name}`);\n\t\t\tconst decision = await ctx.decide({\n\t\t\t\tservice,\n\t\t\t\tcommand,\n\t\t\t\tversion: spec.meta.version,\n\t\t\t\tactor: ctx.actor ?? \"anonymous\",\n\t\t\t\tchannel: ctx.channel,\n\t\t\t\troles: ctx.roles,\n\t\t\t\torganizationId: ctx.organizationId,\n\t\t\t\tuserId: ctx.userId,\n\t\t\t\tflags: []\n\t\t\t});\n\t\t\tif (decision.effect === \"deny\") throw new Error(`PolicyDenied: ${spec.meta.name}.v${spec.meta.version}`);\n\t\t\tif (decision.rateLimit && ctx.rateLimit) {\n\t\t\t\tconst key$1 = decision.rateLimit.key ?? \"default\";\n\t\t\t\tconst rpm = decision.rateLimit.rpm ?? 60;\n\t\t\t\tawait ctx.rateLimit(key$1, 1, rpm);\n\t\t\t}\n\t\t}\n\t\tconst allowedEvents = /* @__PURE__ */ new Map();\n\t\tif (spec.sideEffects?.emits) for (const e of spec.sideEffects.emits) if (isEmitDeclRef(e)) allowedEvents.set(`${e.ref.name}.v${e.ref.version}`, e.ref.payload);\n\t\telse allowedEvents.set(`${e.name}.v${e.version}`, e.payload);\n\t\tconst emitGuard = async (eventName, eventVersion, payload) => {\n\t\t\tconst key2 = eventKey(eventName, eventVersion);\n\t\t\tconst schema = allowedEvents.get(key2);\n\t\t\tif (!schema) throw new Error(`UndeclaredEvent: ${key2} not allowed by ${opKey(spec.meta.name, spec.meta.version)}`);\n\t\t\tconst parsed = schema.getZod().parse(payload);\n\t\t\tawait ctx.eventPublisher?.({\n\t\t\t\tname: eventName,\n\t\t\t\tversion: eventVersion,\n\t\t\t\tpayload: parsed,\n\t\t\t\ttraceId: ctx.traceId\n\t\t\t});\n\t\t};\n\t\tif (ctx.appConfig) {\n\t\t\tif (!ctx.branding) ctx.branding = ctx.appConfig.branding;\n\t\t\tif (!ctx.translation) ctx.translation = { config: ctx.appConfig.translation };\n\t\t\telse if (!ctx.translation.config) ctx.translation = {\n\t\t\t\t...ctx.translation,\n\t\t\t\tconfig: ctx.appConfig.translation\n\t\t\t};\n\t\t}\n\t\tconst telemetryContext = ctx.telemetry;\n\t\tconst trackTelemetry = async (trigger, details) => {\n\t\t\tif (!telemetryContext || !trigger?.event) return;\n\t\t\ttry {\n\t\t\t\tconst props = trigger.properties?.(details) ?? {};\n\t\t\t\tawait telemetryContext.track(trigger.event.name, trigger.event.version ?? 1, props, {\n\t\t\t\t\ttenantId: ctx.organizationId ?? void 0,\n\t\t\t\t\torganizationId: ctx.organizationId,\n\t\t\t\t\tuserId: ctx.userId,\n\t\t\t\t\tactor: ctx.actor,\n\t\t\t\t\tchannel: ctx.channel,\n\t\t\t\t\tmetadata: ctx.traceId ? { traceId: ctx.traceId } : void 0\n\t\t\t\t});\n\t\t\t} catch (_error) {}\n\t\t};\n\t\tlet result;\n\t\ttry {\n\t\t\tresult = await handler(parsedInput, {\n\t\t\t\t...ctx,\n\t\t\t\t__emitGuard__: emitGuard\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tif (spec.telemetry?.failure) await trackTelemetry(spec.telemetry.failure, {\n\t\t\t\tinput: parsedInput ?? rawInput,\n\t\t\t\terror\n\t\t\t});\n\t\t\tthrow error;\n\t\t}\n\t\tif (spec.telemetry?.success) await trackTelemetry(spec.telemetry.success, {\n\t\t\tinput: parsedInput ?? rawInput,\n\t\t\toutput: result\n\t\t});\n\t\tconst outputModel = spec.io.output;\n\t\tif (outputModel?.getZod) return outputModel.getZod().parse(result);\n\t\treturn result;\n\t}\n};\n\n//#endregion\nexport { OperationSpecRegistry, opKey };"],"mappings":";;;;AAKA,qBAAqB"}
|
|
@@ -1,2 +1,8 @@
|
|
|
1
|
-
import "../registry-utils.js";
|
|
1
|
+
import { init_registry_utils } from "../registry-utils.js";
|
|
2
2
|
import z from "zod";
|
|
3
|
+
|
|
4
|
+
//#region ../../libs/contracts/dist/presentations/presentations.js
|
|
5
|
+
init_registry_utils();
|
|
6
|
+
|
|
7
|
+
//#endregion
|
|
8
|
+
//# sourceMappingURL=presentations.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"presentations.js","names":[],"sources":["../../../../../../../libs/contracts/dist/presentations/presentations.js"],"sourcesContent":["import { filterBy, getUniqueTags, groupBy, init_registry_utils } from \"../registry-utils.js\";\nimport z from \"zod\";\n\n//#region src/presentations/presentations.ts\ninit_registry_utils();\nfunction keyOf(p) {\n\treturn `${p.meta.name}.v${p.meta.version}`;\n}\n/** In-memory registry for V1 PresentationSpec. */\nvar PresentationRegistry = class {\n\titems = /* @__PURE__ */ new Map();\n\tconstructor(items) {\n\t\tif (items) items.forEach((p) => this.register(p));\n\t}\n\tregister(p) {\n\t\tconst key = keyOf(p);\n\t\tif (this.items.has(key)) throw new Error(`Duplicate presentation ${key}`);\n\t\tthis.items.set(key, p);\n\t\treturn this;\n\t}\n\tlist() {\n\t\treturn [...this.items.values()];\n\t}\n\tget(name, version) {\n\t\tif (version != null) return this.items.get(`${name}.v${version}`);\n\t\tlet candidate;\n\t\tlet max = -Infinity;\n\t\tfor (const [k, p] of this.items.entries()) {\n\t\t\tif (!k.startsWith(`${name}.v`)) continue;\n\t\t\tif (p.meta.version > max) {\n\t\t\t\tmax = p.meta.version;\n\t\t\t\tcandidate = p;\n\t\t\t}\n\t\t}\n\t\treturn candidate;\n\t}\n\t/** Filter presentations by criteria. */\n\tfilter(criteria) {\n\t\treturn filterBy(this.list(), criteria);\n\t}\n\t/** List presentations with specific tag. */\n\tlistByTag(tag) {\n\t\treturn this.list().filter((p) => p.meta.tags?.includes(tag));\n\t}\n\t/** List presentations by owner. */\n\tlistByOwner(owner) {\n\t\treturn this.list().filter((p) => p.meta.owners?.includes(owner));\n\t}\n\t/** Group presentations by key function. */\n\tgroupBy(keyFn) {\n\t\treturn groupBy(this.list(), keyFn);\n\t}\n\t/** Get unique tags from all presentations. */\n\tgetUniqueTags() {\n\t\treturn getUniqueTags(this.list());\n\t}\n};\nfunction jsonSchemaForPresentation(p) {\n\tconst base = {\n\t\tmeta: {\n\t\t\tname: p.meta.name,\n\t\t\tversion: p.meta.version,\n\t\t\tstability: p.meta.stability ?? \"stable\",\n\t\t\ttags: p.meta.tags ?? [],\n\t\t\tdescription: p.meta.description ?? \"\"\n\t\t},\n\t\tkind: p.content.kind\n\t};\n\tif (p.content.kind === \"web_component\") return {\n\t\t...base,\n\t\tframework: p.content.framework,\n\t\tcomponentKey: p.content.componentKey,\n\t\tprops: z.toJSONSchema(p.content.props.getZod())\n\t};\n\tif (p.content.kind === \"markdown\") return {\n\t\t...base,\n\t\tcontent: p.content.content,\n\t\tresourceUri: p.content.resourceUri\n\t};\n\treturn {\n\t\t...base,\n\t\tmimeType: p.content.mimeType,\n\t\tmodel: z.toJSONSchema(p.content.model.getZod())\n\t};\n}\n\n//#endregion\nexport { PresentationRegistry, jsonSchemaForPresentation };"],"mappings":";;;;AAIA,qBAAqB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"spec.js","names":[],"sources":["../../../../../../../libs/contracts/dist/workflow/spec.js"],"sourcesContent":["import { filterBy, getUniqueTags, groupBy, init_registry_utils } from \"../registry-utils.js\";\n\n//#region src/workflow/spec.ts\ninit_registry_utils();\nfunction workflowKey(meta) {\n\treturn `${meta.name}.v${meta.version}`;\n}\nvar WorkflowRegistry = class {\n\titems = /* @__PURE__ */ new Map();\n\tregister(spec) {\n\t\tconst key = workflowKey(spec.meta);\n\t\tif (this.items.has(key)) throw new Error(`Duplicate workflow ${key}`);\n\t\tthis.items.set(key, spec);\n\t\treturn this;\n\t}\n\tlist() {\n\t\treturn [...this.items.values()];\n\t}\n\tget(name, version) {\n\t\tif (version != null) return this.items.get(`${name}.v${version}`);\n\t\tlet candidate;\n\t\tlet max = -Infinity;\n\t\tfor (const spec of this.items.values()) {\n\t\t\tif (spec.meta.name !== name) continue;\n\t\t\tif (spec.meta.version > max) {\n\t\t\t\tmax = spec.meta.version;\n\t\t\t\tcandidate = spec;\n\t\t\t}\n\t\t}\n\t\treturn candidate;\n\t}\n\t/** Filter workflows by criteria. */\n\tfilter(criteria) {\n\t\treturn filterBy(this.list(), criteria);\n\t}\n\t/** List workflows with specific tag. */\n\tlistByTag(tag) {\n\t\treturn this.list().filter((w) => w.meta.tags?.includes(tag));\n\t}\n\t/** List workflows by owner. */\n\tlistByOwner(owner) {\n\t\treturn this.list().filter((w) => w.meta.owners?.includes(owner));\n\t}\n\t/** Group workflows by key function. */\n\tgroupBy(keyFn) {\n\t\treturn groupBy(this.list(), keyFn);\n\t}\n\t/** Get unique tags from all workflows. */\n\tgetUniqueTags() {\n\t\treturn getUniqueTags(this.list());\n\t}\n};\n\n//#endregion\nexport { WorkflowRegistry };"],"mappings":";;;AAGA,qBAAqB"}
|