@entifix/service-shell 0.11.0 → 0.12.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 (82) hide show
  1. package/README.md +1 -4
  2. package/dist/auth/require-organization.d.ts +1 -1
  3. package/dist/auth/require-organization.d.ts.map +1 -1
  4. package/dist/auth/require-organization.js.map +1 -1
  5. package/dist/auth/require-principal.d.ts +9 -55
  6. package/dist/auth/require-principal.d.ts.map +1 -1
  7. package/dist/auth/require-principal.js +15 -13
  8. package/dist/auth/require-principal.js.map +1 -1
  9. package/dist/auth/require-service-crossing.d.ts.map +1 -1
  10. package/dist/auth/require-service-crossing.js +3 -13
  11. package/dist/auth/require-service-crossing.js.map +1 -1
  12. package/dist/auth/shared-token.d.ts +2 -0
  13. package/dist/auth/shared-token.d.ts.map +1 -1
  14. package/dist/auth/shared-token.js +2 -2
  15. package/dist/auth/shared-token.js.map +1 -1
  16. package/dist/auth/verified-context.d.ts +1 -2
  17. package/dist/auth/verified-context.d.ts.map +1 -1
  18. package/dist/auth/verified-context.js.map +1 -1
  19. package/dist/entity-facet-routes.d.ts +2 -2
  20. package/dist/entity-facet-routes.d.ts.map +1 -1
  21. package/dist/entity-facet-routes.js.map +1 -1
  22. package/dist/entity-route-guard.d.ts +2 -2
  23. package/dist/entity-route-guard.d.ts.map +1 -1
  24. package/dist/entity-route-guard.js.map +1 -1
  25. package/dist/entity-routes.d.ts +1 -1
  26. package/dist/entity-routes.d.ts.map +1 -1
  27. package/dist/entity-routes.js.map +1 -1
  28. package/dist/http-api/build-api.d.ts +78 -0
  29. package/dist/http-api/build-api.d.ts.map +1 -0
  30. package/dist/http-api/build-api.js +189 -0
  31. package/dist/http-api/build-api.js.map +1 -0
  32. package/dist/http-api/entity-api.d.ts +69 -0
  33. package/dist/http-api/entity-api.d.ts.map +1 -0
  34. package/dist/http-api/entity-api.js +522 -0
  35. package/dist/http-api/entity-api.js.map +1 -0
  36. package/dist/http-api/guards.d.ts +92 -0
  37. package/dist/http-api/guards.d.ts.map +1 -0
  38. package/dist/http-api/guards.js +131 -0
  39. package/dist/http-api/guards.js.map +1 -0
  40. package/dist/http-api/index.d.ts +6 -0
  41. package/dist/http-api/index.d.ts.map +1 -0
  42. package/dist/http-api/index.js +7 -0
  43. package/dist/http-api/index.js.map +1 -0
  44. package/dist/http-api/problem-codec.d.ts +14 -0
  45. package/dist/http-api/problem-codec.d.ts.map +1 -0
  46. package/dist/http-api/problem-codec.js +26 -0
  47. package/dist/http-api/problem-codec.js.map +1 -0
  48. package/dist/http-api/service-group.d.ts +74 -0
  49. package/dist/http-api/service-group.d.ts.map +1 -0
  50. package/dist/http-api/service-group.js +168 -0
  51. package/dist/http-api/service-group.js.map +1 -0
  52. package/dist/idempotency.d.ts +9 -4
  53. package/dist/idempotency.d.ts.map +1 -1
  54. package/dist/idempotency.js +11 -6
  55. package/dist/idempotency.js.map +1 -1
  56. package/dist/index.d.ts +1 -2
  57. package/dist/index.d.ts.map +1 -1
  58. package/dist/index.js +1 -2
  59. package/dist/index.js.map +1 -1
  60. package/dist/make-service.d.ts +39 -6
  61. package/dist/make-service.d.ts.map +1 -1
  62. package/dist/make-service.js +54 -16
  63. package/dist/make-service.js.map +1 -1
  64. package/dist/narrowing.d.ts +1 -15
  65. package/dist/narrowing.d.ts.map +1 -1
  66. package/dist/narrowing.js.map +1 -1
  67. package/dist/respond.d.ts +6 -4
  68. package/dist/respond.d.ts.map +1 -1
  69. package/dist/respond.js +11 -7
  70. package/dist/respond.js.map +1 -1
  71. package/dist/serve-test-service.d.ts +2 -1
  72. package/dist/serve-test-service.d.ts.map +1 -1
  73. package/dist/serve-test-service.js.map +1 -1
  74. package/package.json +7 -6
  75. package/dist/health-routes.d.ts +0 -24
  76. package/dist/health-routes.d.ts.map +0 -1
  77. package/dist/health-routes.js +0 -86
  78. package/dist/health-routes.js.map +0 -1
  79. package/dist/service-description-route.d.ts +0 -66
  80. package/dist/service-description-route.d.ts.map +0 -1
  81. package/dist/service-description-route.js +0 -60
  82. package/dist/service-description-route.js.map +0 -1
@@ -0,0 +1,522 @@
1
+ import { _ as _extends } from "@swc/helpers/_/_extends";
2
+ import { createHash } from 'node:crypto';
3
+ import { parsePermission, permissionForEntity, permissionForUseCase, PolicyDecisionTag } from '@entifix/authz';
4
+ import { deleteUCFactory, EntityFacetCounterFactoryTag, EntityFacetCounterTag, EntityIdTag, EntityLoadRequestTag, EntityRepositoryFactoryTag, EntityRepositoryTag, EntityTag, facetCountsUCFactory, getUCFactory, loadUCFactory, OrganizationIdTag, RequestPrincipalTag, saveUCFactory, VerifiedContextTag } from '@entifix/business';
5
+ import { defineEndpoint, describeEntityUseCases, ENTITY_ACTIONS, Envelope, implement, InvalidQuery, JsonBody, makeEntityEnvelope, makeEntityFacetsEnvelope, makeEntityMetadataEnvelope, makeEntityPageEnvelope, NotFound, parseFacetQueryParams, parseLoadRequestParams, readEntityEnvelope, verbPath } from '@entifix/core';
6
+ import { Effect, Option, Schema } from 'effect';
7
+ import { HttpServerRequest, HttpServerResponse } from 'effect/http';
8
+ import { resolveRequestPrincipal } from '../auth/require-principal.js';
9
+ import { assertCompositionsDeclared, compositionFor } from '../metadata-composition.js';
10
+ import { narrowedByIdRequest, narrowingFor, narrowLoadRequest } from '../narrowing.js';
11
+ /** A collection verb's body: the selection, in its wire form. */ const SelectionBody = Schema.Struct({
12
+ selection: Schema.Unknown
13
+ });
14
+ const ACTION = {
15
+ list: 'read',
16
+ get: 'read',
17
+ create: 'write',
18
+ update: 'write',
19
+ delete: 'delete'
20
+ };
21
+ const READS = new Set([
22
+ 'list',
23
+ 'get'
24
+ ]);
25
+ const METHOD = {
26
+ list: 'GET',
27
+ get: 'GET',
28
+ create: 'POST',
29
+ update: 'PUT',
30
+ delete: 'DELETE'
31
+ };
32
+ /** Any envelope: the entity codec reads `data`, so the wire stays open. */ const EnvelopeBody = Envelope.codec(Schema.Unknown);
33
+ const endpointGuardFor = (guard, permission)=>{
34
+ switch(guard.kind){
35
+ case 'public':
36
+ return {
37
+ kind: 'public'
38
+ };
39
+ case 'crossing':
40
+ return {
41
+ kind: 'crossing',
42
+ permission: permission(),
43
+ organization: guard.organization
44
+ };
45
+ default:
46
+ return {
47
+ kind: guard.kind,
48
+ permission: permission()
49
+ };
50
+ }
51
+ };
52
+ const endpointGuard = (entityConstructor, guard, action)=>endpointGuardFor(guard, ()=>permissionForEntity(entityConstructor, action));
53
+ /** The request context a guard provided, read without requiring it. */ const callerContext = Effect.gen(function*() {
54
+ const organizationId = yield* Effect.serviceOption(OrganizationIdTag);
55
+ const principal = yield* Effect.serviceOption(RequestPrincipalTag);
56
+ const verified = yield* Effect.serviceOption(VerifiedContextTag);
57
+ return _extends({}, Option.match(organizationId, {
58
+ onNone: ()=>({}),
59
+ onSome: (value)=>({
60
+ organizationId: value
61
+ })
62
+ }), Option.match(principal, {
63
+ onNone: ()=>({}),
64
+ onSome: (value)=>({
65
+ principal: value
66
+ })
67
+ }), Option.match(verified, {
68
+ onNone: ()=>({}),
69
+ onSome: (value)=>({
70
+ verified: value
71
+ })
72
+ }));
73
+ });
74
+ /** The search the request carried, for the RSQL parsers. */ const searchParams = Effect.map(HttpServerRequest.HttpServerRequest, (request)=>new URL(request.url, 'http://localhost').searchParams);
75
+ // The RSQL parsers throw a build error naming what they refused.
76
+ const asInvalidQuery = (error)=>new InvalidQuery({
77
+ reason: error.message
78
+ });
79
+ const cacheHeaders = (etag)=>({
80
+ etag,
81
+ 'cache-control': 'private, no-cache',
82
+ vary: 'Cookie, Authorization'
83
+ });
84
+ /**
85
+ * The generic endpoints of an entity — list, get, create, update, delete,
86
+ * `$metadata` and, when asked, `$facets` — as one group named for its key
87
+ * ([ADR 0020](../../../../../docs/adr/0020-endpoints-are-descriptors-and-the-shell-builds-an-httpapi.md)).
88
+ *
89
+ * `$metadata` and `$facets` come before `/:id`, so neither is read as an id.
90
+ * The list query is the entity's RSQL request, parsed against its own
91
+ * `filterable`/`sortable` metadata: a member that is not queryable answers
92
+ * `invalidQuery`. A narrowing is conjoined onto every read and count, never
93
+ * substituted, and a reader it leaves with nothing gets an empty page and a
94
+ * `404`, never a `403`.
95
+ *
96
+ * It serves a declaration the domain made with `defineEntityApi`; what the
97
+ * shell alone knows — the recipes and variants `$metadata` resolves verbs
98
+ * against — is added here.
99
+ */ export const entityApi = (declaration, serving = {})=>{
100
+ var _serving_compositions, _options_useCases;
101
+ const { entity: entityConstructor, key, options } = declaration;
102
+ const base = `/api/${key}`;
103
+ const record = `${base}/:id`;
104
+ const mounted = new Set(options.verbs);
105
+ const notFound = new NotFound({
106
+ entity: key
107
+ });
108
+ const compositions = (_serving_compositions = serving.compositions) != null ? _serving_compositions : {};
109
+ assertCompositionsDeclared(describeEntityUseCases(entityConstructor), compositions);
110
+ const verbs = (_options_useCases = options.useCases) != null ? _options_useCases : [];
111
+ // By key and binding: one key may be declared on a record and over a
112
+ // selection, and serving one of the two must not pass for serving both.
113
+ const unserved = describeEntityUseCases(entityConstructor).filter((declared)=>!verbs.some((verb)=>verb.useCase.key === declared.key && verb.useCase.binding === declared.binding)).map((declared)=>declared.key);
114
+ // A record-bound verb declared in a collection cell too is served there,
115
+ // and only then: a bulk handler for a cell nobody declared is a stray.
116
+ const inCollectionCell = (verb)=>{
117
+ var _verb_useCase_alsoAt;
118
+ return verb.useCase.binding === 'entity' && ((_verb_useCase_alsoAt = verb.useCase.alsoAt) != null ? _verb_useCase_alsoAt : []).some((cell)=>cell.binding === 'collection');
119
+ };
120
+ for (const verb of verbs){
121
+ if (inCollectionCell(verb) !== (verb.bulk !== undefined)) throw new Error(`the '${key}' endpoints ` + (verb.bulk === undefined ? `serve no bulk handler for @useCase() '${verb.useCase.key}', declared in a collection cell` : `serve a bulk handler for @useCase() '${verb.useCase.key}', declared in no collection cell`) + '.');
122
+ }
123
+ const strays = verbs.filter((verb)=>verb.useCase.entity !== entityConstructor);
124
+ if (unserved.length > 0 || strays.length > 0) throw new Error(`the '${key}' endpoints ` + [
125
+ ...unserved.length > 0 ? [
126
+ `serve no endpoint for @useCase() ${unserved.map((v)=>`'${v}'`).join(', ')}`
127
+ ] : [],
128
+ ...strays.length > 0 ? [
129
+ `serve ${strays.map((v)=>`'${v.useCase.key}'`).join(', ')}, declared on another entity`
130
+ ] : []
131
+ ].join(', and ') + '; a verb has exactly one endpoint, on its own entity.');
132
+ const linksFor = (allowed)=>({
133
+ record: (id)=>{
134
+ const href = `${base}/${String(id)}`;
135
+ return [
136
+ ...mounted.has('get') ? [
137
+ {
138
+ rel: 'self',
139
+ href,
140
+ method: 'GET'
141
+ }
142
+ ] : [],
143
+ ...mounted.has('list') ? [
144
+ {
145
+ rel: 'list',
146
+ href: base,
147
+ method: 'GET'
148
+ }
149
+ ] : [],
150
+ ...mounted.has('update') ? [
151
+ {
152
+ rel: 'update',
153
+ href,
154
+ method: 'PUT'
155
+ }
156
+ ] : [],
157
+ ...mounted.has('delete') ? [
158
+ {
159
+ rel: 'delete',
160
+ href,
161
+ method: 'DELETE'
162
+ }
163
+ ] : [],
164
+ ...verbs.filter((verb)=>verb.useCase.binding === 'entity' && allowed.has(verb.useCase.key)).map((verb)=>({
165
+ rel: verb.useCase.key,
166
+ href: `${href}/${verb.useCase.key}`,
167
+ method: 'POST'
168
+ }))
169
+ ];
170
+ },
171
+ collection: ()=>[
172
+ ...mounted.has('list') ? [
173
+ {
174
+ rel: 'self',
175
+ href: base,
176
+ method: 'GET'
177
+ }
178
+ ] : [],
179
+ ...mounted.has('create') ? [
180
+ {
181
+ rel: 'create',
182
+ href: base,
183
+ method: 'POST'
184
+ }
185
+ ] : [],
186
+ ...verbs.filter((verb)=>(verb.useCase.binding !== 'entity' || verb.bulk !== undefined) && allowed.has(verb.useCase.key)).map((verb)=>({
187
+ rel: verb.useCase.key,
188
+ href: `${base}/${verb.useCase.key}`,
189
+ method: 'POST'
190
+ }))
191
+ ]
192
+ });
193
+ const guardFor = (verb)=>{
194
+ var _options_override_verb, _options_override;
195
+ const declared = (_options_override = options.override) == null ? void 0 : (_options_override_verb = _options_override[verb]) == null ? void 0 : _options_override_verb.guard;
196
+ if (declared !== undefined) return declared;
197
+ const { guard } = options;
198
+ return 'kind' in guard ? guard : READS.has(verb) ? guard.read : guard.write;
199
+ };
200
+ const verbGuard = (verb)=>{
201
+ var _verb_guard;
202
+ return (_verb_guard = verb.guard) != null ? _verb_guard : guardFor('create');
203
+ };
204
+ /**
205
+ * The verbs this caller would be let through: a public verb for anybody, a
206
+ * session verb for a principal the policy permits. A crossing verb is never
207
+ * linked — no browser holds the token that reaches it.
208
+ */ const allowedVerbs = (principal)=>Effect.gen(function*() {
209
+ const policy = yield* PolicyDecisionTag;
210
+ const allowed = new Set();
211
+ for (const verb of verbs){
212
+ const kind = verbGuard(verb).kind;
213
+ if (kind === 'public') allowed.add(verb.useCase.key);
214
+ else if (kind !== 'crossing' && principal !== undefined) {
215
+ const { resource, action } = parsePermission(permissionForUseCase(entityConstructor, verb.useCase.key));
216
+ if (policy.decide({
217
+ subject: {
218
+ roles: principal.roles
219
+ },
220
+ resource,
221
+ action
222
+ })) allowed.add(verb.useCase.key);
223
+ }
224
+ }
225
+ return allowed;
226
+ });
227
+ const context = Effect.gen(function*() {
228
+ var _caller_principal;
229
+ const caller = yield* callerContext;
230
+ // A public read verifies no session, but a signed-in caller reading it
231
+ // still sees the verbs they may run: the links read the session, if any,
232
+ // and never decide anything by it.
233
+ const principal = (_caller_principal = caller.principal) != null ? _caller_principal : Option.getOrUndefined((yield* resolveRequestPrincipal));
234
+ const allowed = yield* allowedVerbs(principal);
235
+ return _extends({}, caller, {
236
+ links: linksFor(allowed)
237
+ });
238
+ });
239
+ const repository = (caller)=>Effect.flatMap(EntityRepositoryFactoryTag, (factory)=>factory.for(entityConstructor, _extends({}, caller.organizationId === undefined ? {} : {
240
+ organizationId: caller.organizationId
241
+ })));
242
+ const narrowingOf = (caller)=>options.narrowing === undefined || caller.verified === undefined ? undefined : narrowingFor(options.narrowing, caller.verified);
243
+ const list = Effect.gen(function*() {
244
+ const caller = yield* context;
245
+ const search = yield* searchParams;
246
+ const parsed = yield* Effect.try({
247
+ try: ()=>parseLoadRequestParams(entityConstructor, search),
248
+ catch: asInvalidQuery
249
+ });
250
+ const narrowing = narrowingOf(caller);
251
+ // Still parsed: whether a query is well-formed must not depend on who
252
+ // asked. `nothing` answers here without a query.
253
+ if (narrowing === 'nothing') return makeEntityPageEnvelope(entityConstructor, {
254
+ items: [],
255
+ total: 0,
256
+ request: parsed
257
+ }, caller.links.collection());
258
+ const request = narrowing === undefined || narrowing === 'unscoped' ? parsed : narrowLoadRequest(parsed, narrowing);
259
+ const page = yield* loadUCFactory().pipe(Effect.provideService(EntityRepositoryTag, (yield* repository(caller))), Effect.provideService(EntityLoadRequestTag, request));
260
+ return makeEntityPageEnvelope(entityConstructor, page, caller.links.collection());
261
+ });
262
+ const get = (id)=>Effect.gen(function*() {
263
+ const caller = yield* context;
264
+ const narrowing = narrowingOf(caller);
265
+ if (narrowing === 'nothing') return yield* Effect.fail(notFound);
266
+ // A filter narrowing reads by id as a narrowed load, so the read and the
267
+ // list apply one rule.
268
+ if (narrowing !== undefined && narrowing !== 'unscoped') {
269
+ const page = yield* loadUCFactory().pipe(Effect.provideService(EntityRepositoryTag, (yield* repository(caller))), Effect.provideService(EntityLoadRequestTag, narrowedByIdRequest(narrowing, id)));
270
+ const [only] = page.items;
271
+ if (only === undefined) return yield* Effect.fail(notFound);
272
+ return makeEntityEnvelope(entityConstructor, only, caller.links.record(id));
273
+ }
274
+ const found = yield* getUCFactory().pipe(Effect.provideService(EntityRepositoryTag, (yield* repository(caller))), Effect.provideService(EntityIdTag, id));
275
+ return makeEntityEnvelope(entityConstructor, found, caller.links.record(id));
276
+ });
277
+ const save = (verb, body, id)=>Effect.gen(function*() {
278
+ const caller = yield* context;
279
+ let entity = yield* readEntityEnvelope(entityConstructor, body);
280
+ // On update the path is authoritative, so a record cannot be renamed
281
+ // onto another one by editing its payload.
282
+ if (id !== undefined) entity.id = id;
283
+ if (options.prepare !== undefined) entity = yield* options.prepare(entity, _extends({}, caller, {
284
+ verb
285
+ }));
286
+ const saved = yield* saveUCFactory().pipe(Effect.provideService(EntityRepositoryTag, (yield* repository(caller))), Effect.provideService(EntityTag, entity));
287
+ return makeEntityEnvelope(entityConstructor, saved, caller.links.record(saved.id));
288
+ });
289
+ const remove = (id)=>Effect.gen(function*() {
290
+ const caller = yield* context;
291
+ yield* deleteUCFactory().pipe(Effect.provideService(EntityRepositoryTag, (yield* repository(caller))), Effect.provideService(EntityIdTag, id));
292
+ // An envelope rather than a bare `204`: every message between entifix
293
+ // artifacts is one.
294
+ return {
295
+ meta: {
296
+ type: 'entity',
297
+ entity: key,
298
+ links: caller.links.collection()
299
+ },
300
+ data: {
301
+ id
302
+ }
303
+ };
304
+ });
305
+ const metadata = Effect.gen(function*() {
306
+ const principal = yield* RequestPrincipalTag;
307
+ const verified = yield* VerifiedContextTag;
308
+ const policy = yield* PolicyDecisionTag;
309
+ const allows = (permission)=>{
310
+ const { resource, action } = parsePermission(permission);
311
+ return policy.decide({
312
+ subject: {
313
+ roles: principal.roles
314
+ },
315
+ resource,
316
+ action
317
+ });
318
+ };
319
+ // SECURITY BOUNDARY. The document is a map of the model, so an entity the
320
+ // caller may not read answers exactly as one this service does not host:
321
+ // a `403` would make the endpoint an oracle.
322
+ if (!allows(permissionForEntity(entityConstructor, 'read'))) return yield* Effect.fail(notFound);
323
+ const document = {
324
+ actions: ENTITY_ACTIONS.filter((action)=>allows(permissionForEntity(entityConstructor, action))),
325
+ useCases: describeEntityUseCases(entityConstructor).filter((descriptor)=>allows(permissionForUseCase(entityConstructor, descriptor.key)))// A verb the caller resolves to nothing is omitted, like one they may
326
+ // not invoke; the rest carry what they resolve to.
327
+ .flatMap((descriptor)=>{
328
+ const composition = compositionFor(descriptor, verified, compositions);
329
+ if (composition === 'unreachable') return [];
330
+ return composition === undefined ? [
331
+ descriptor
332
+ ] : [
333
+ _extends({}, descriptor, {
334
+ composition
335
+ })
336
+ ];
337
+ })
338
+ };
339
+ // The ETag hashes the computed document, not the model: two principals
340
+ // with different grants get different documents from one model.
341
+ const body = JSON.stringify(makeEntityMetadataEnvelope(entityConstructor, document));
342
+ const etag = `"${createHash('sha256').update(body).digest('hex')}"`;
343
+ const request = yield* HttpServerRequest.HttpServerRequest;
344
+ if (request.headers['if-none-match'] === etag) return HttpServerResponse.empty({
345
+ status: 304
346
+ }).pipe(HttpServerResponse.setHeaders(cacheHeaders(etag)));
347
+ return HttpServerResponse.text(body, {
348
+ contentType: 'application/json',
349
+ headers: cacheHeaders(etag)
350
+ });
351
+ });
352
+ const facets = Effect.gen(function*() {
353
+ var _narrowingOf;
354
+ const caller = yield* context;
355
+ const search = yield* searchParams;
356
+ const queries = yield* Effect.try({
357
+ try: ()=>parseFacetQueryParams(entityConstructor, search),
358
+ catch: asInvalidQuery
359
+ });
360
+ const narrowing = (_narrowingOf = narrowingOf(caller)) != null ? _narrowingOf : 'unscoped';
361
+ if (narrowing === 'nothing') {
362
+ const empty = Object.fromEntries(queries.map(({ member })=>[
363
+ member,
364
+ []
365
+ ]));
366
+ return makeEntityFacetsEnvelope(entityConstructor, empty);
367
+ }
368
+ const narrowed = narrowing === 'unscoped' ? queries : queries.map((query)=>{
369
+ var _query_filtering;
370
+ return _extends({}, query, {
371
+ filtering: [
372
+ ...(_query_filtering = query.filtering) != null ? _query_filtering : [],
373
+ narrowing
374
+ ]
375
+ });
376
+ });
377
+ const factory = yield* EntityFacetCounterFactoryTag;
378
+ const counter = yield* factory.for(entityConstructor, _extends({}, caller.organizationId === undefined ? {} : {
379
+ organizationId: caller.organizationId
380
+ }));
381
+ const counts = yield* facetCountsUCFactory(narrowed).pipe(Effect.provideService(EntityFacetCounterTag, counter));
382
+ return makeEntityFacetsEnvelope(entityConstructor, counts);
383
+ });
384
+ const crudEndpoint = (verb)=>{
385
+ var _ref, _options_errors, _ref1;
386
+ var _options_override;
387
+ const override = (_options_override = options.override) == null ? void 0 : _options_override[verb];
388
+ const withId = verb !== 'list' && verb !== 'create';
389
+ const takesBody = verb === 'create' || verb === 'update';
390
+ const payload = takesBody ? (_ref = override == null ? void 0 : override.payload) != null ? _ref : EnvelopeBody : override == null ? void 0 : override.payload;
391
+ const descriptor = defineEndpoint(_extends({
392
+ name: verb,
393
+ method: METHOD[verb],
394
+ path: withId ? record : base
395
+ }, withId ? {
396
+ params: {
397
+ id: Schema.String
398
+ }
399
+ } : {}, payload === undefined ? {} : {
400
+ payload
401
+ }, {
402
+ success: JsonBody,
403
+ errors: [
404
+ ...verb === 'get' || verb === 'update' || verb === 'delete' ? [
405
+ NotFound
406
+ ] : [],
407
+ ...verb === 'list' ? [
408
+ InvalidQuery
409
+ ] : [],
410
+ ...takesBody ? (_options_errors = options.errors) != null ? _options_errors : [] : [],
411
+ ...(_ref1 = override == null ? void 0 : override.errors) != null ? _ref1 : []
412
+ ],
413
+ guard: endpointGuard(entityConstructor, guardFor(verb), ACTION[verb])
414
+ }, (override == null ? void 0 : override.idempotent) === undefined ? {} : {
415
+ idempotent: override.idempotent
416
+ }));
417
+ return implement(descriptor, (request)=>{
418
+ var _request_params;
419
+ if (override !== undefined) return Effect.flatMap(context, (caller)=>override.handler(request, caller));
420
+ const id = (_request_params = request.params) == null ? void 0 : _request_params.id;
421
+ switch(verb){
422
+ case 'list':
423
+ return list;
424
+ case 'get':
425
+ return get(id);
426
+ case 'create':
427
+ return save('create', request.payload);
428
+ case 'update':
429
+ return save('update', request.payload, id);
430
+ case 'delete':
431
+ return remove(id);
432
+ }
433
+ });
434
+ };
435
+ const readGuard = guardFor('list');
436
+ const endpoints = [
437
+ // Registered first, so neither is captured by `/:id`.
438
+ implement(defineEndpoint({
439
+ name: 'metadata',
440
+ method: 'GET',
441
+ path: `${base}/$metadata`,
442
+ success: JsonBody,
443
+ errors: [
444
+ NotFound
445
+ ],
446
+ guard: {
447
+ kind: 'session'
448
+ }
449
+ }), ()=>metadata),
450
+ ...options.facets === true ? [
451
+ implement(defineEndpoint({
452
+ name: 'facets',
453
+ method: 'GET',
454
+ path: `${base}/$facets`,
455
+ success: JsonBody,
456
+ errors: [
457
+ InvalidQuery
458
+ ],
459
+ guard: endpointGuard(entityConstructor, readGuard, 'read')
460
+ }), ()=>facets)
461
+ ] : [],
462
+ ...options.verbs.map(crudEndpoint),
463
+ ...verbs.map((verb)=>{
464
+ var _useCase_payload, _useCase_success, _useCase_errors;
465
+ const { useCase } = verb;
466
+ const payload = (_useCase_payload = useCase.payload) != null ? _useCase_payload : useCase.binding === 'collection' ? SelectionBody : undefined;
467
+ const descriptor = defineEndpoint(_extends({
468
+ // One key may be served both ways — `publish` on a record and over a
469
+ // selection — under one permission, so a name carries the binding
470
+ // whenever it is not the record's.
471
+ name: useCase.binding === 'entity' ? useCase.key : `${useCase.key}-${useCase.binding}`,
472
+ method: 'POST',
473
+ path: verbPath(key, useCase.key, useCase.binding)
474
+ }, useCase.binding === 'entity' ? {
475
+ params: {
476
+ id: Schema.String
477
+ }
478
+ } : {}, payload === undefined ? {} : {
479
+ payload
480
+ }, {
481
+ success: (_useCase_success = useCase.success) != null ? _useCase_success : JsonBody,
482
+ errors: [
483
+ ...(_useCase_errors = useCase.errors) != null ? _useCase_errors : []
484
+ ],
485
+ guard: endpointGuardFor(verbGuard(verb), ()=>permissionForUseCase(entityConstructor, useCase.key)),
486
+ useCase: useCase.key
487
+ }, verb.idempotent === undefined ? {} : {
488
+ idempotent: verb.idempotent
489
+ }));
490
+ return implement(descriptor, (request)=>Effect.flatMap(context, (caller)=>verb.handler(request, caller)));
491
+ }),
492
+ ...verbs.flatMap((verb)=>{
493
+ var _useCase_errors;
494
+ const { bulk } = verb;
495
+ if (bulk === undefined) return [];
496
+ const { useCase } = verb;
497
+ const descriptor = defineEndpoint(_extends({
498
+ name: `${useCase.key}-collection`,
499
+ method: 'POST',
500
+ path: verbPath(key, useCase.key, 'collection'),
501
+ payload: SelectionBody,
502
+ success: JsonBody,
503
+ errors: [
504
+ ...(_useCase_errors = useCase.errors) != null ? _useCase_errors : []
505
+ ],
506
+ guard: endpointGuardFor(verbGuard(verb), ()=>permissionForUseCase(entityConstructor, useCase.key)),
507
+ useCase: useCase.key
508
+ }, verb.idempotent === undefined ? {} : {
509
+ idempotent: verb.idempotent
510
+ }));
511
+ return [
512
+ implement(descriptor, (request)=>Effect.flatMap(context, (caller)=>bulk(request, caller)))
513
+ ];
514
+ })
515
+ ];
516
+ return {
517
+ name: key,
518
+ endpoints
519
+ };
520
+ };
521
+
522
+ //# sourceMappingURL=entity-api.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/http-api/entity-api.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\n\nimport {\n type Action,\n parsePermission,\n type Permission,\n permissionForEntity,\n permissionForUseCase,\n PolicyDecisionTag,\n} from '@entifix/authz';\nimport {\n deleteUCFactory,\n type EntityApiContext,\n type EntityApiDeclaration,\n type EntityApiGuard,\n type EntityApiLinks,\n type EntityApiOptions,\n type EntityApiRequest,\n type EntityApiVerb,\n EntityFacetCounterFactoryTag,\n EntityFacetCounterTag,\n EntityIdTag,\n EntityLoadRequestTag,\n EntityRepositoryFactoryTag,\n EntityRepositoryTag,\n EntityTag,\n facetCountsUCFactory,\n getUCFactory,\n loadUCFactory,\n type Narrowing,\n OrganizationIdTag,\n type RequestPrincipal,\n RequestPrincipalTag,\n saveUCFactory,\n type VerbEndpoint,\n VerifiedContextTag,\n} from '@entifix/business';\nimport {\n type AnyEndpoint,\n defineEndpoint,\n describeEntityUseCases,\n type EndpointGuard,\n type Entity,\n ENTITY_ACTIONS,\n type EntityConstructor,\n type EntityFacetCounts,\n type EntityFacetQuery,\n type EntityLoadRequest,\n type EntityMetadataDocument,\n Envelope,\n implement,\n type Implemented,\n InvalidQuery,\n JsonBody,\n makeEntityEnvelope,\n makeEntityFacetsEnvelope,\n makeEntityMetadataEnvelope,\n makeEntityPageEnvelope,\n NotFound,\n parseFacetQueryParams,\n parseLoadRequestParams,\n readEntityEnvelope,\n verbPath,\n} from '@entifix/core';\nimport { Effect, Option, Schema } from 'effect';\nimport { HttpServerRequest, HttpServerResponse } from 'effect/http';\n\nimport { resolveRequestPrincipal } from '../auth/require-principal.js';\nimport {\n assertCompositionsDeclared,\n compositionFor,\n type MetadataCompositions,\n} from '../metadata-composition.js';\nimport {\n narrowedByIdRequest,\n narrowingFor,\n narrowLoadRequest,\n} from '../narrowing.js';\nimport type { EndpointGroup } from './build-api.js';\n\n/** A collection verb's body: the selection, in its wire form. */\nconst SelectionBody = Schema.Struct({ selection: Schema.Unknown });\n\nconst ACTION: Record<EntityApiVerb, Action> = {\n list: 'read',\n get: 'read',\n create: 'write',\n update: 'write',\n delete: 'delete',\n};\n\nconst READS: ReadonlySet<EntityApiVerb> = new Set(['list', 'get']);\n\nconst METHOD = {\n list: 'GET',\n get: 'GET',\n create: 'POST',\n update: 'PUT',\n delete: 'DELETE',\n} as const;\n\n/** Any envelope: the entity codec reads `data`, so the wire stays open. */\nconst EnvelopeBody = Envelope.codec(Schema.Unknown);\n\nconst endpointGuardFor = (\n guard: EntityApiGuard,\n permission: () => Permission,\n): EndpointGuard => {\n switch (guard.kind) {\n case 'public':\n return { kind: 'public' };\n case 'crossing':\n return {\n kind: 'crossing',\n permission: permission(),\n organization: guard.organization,\n };\n default:\n return { kind: guard.kind, permission: permission() };\n }\n};\n\nconst endpointGuard = <T extends Entity>(\n entityConstructor: EntityConstructor<T>,\n guard: EntityApiGuard,\n action: Action,\n): EndpointGuard =>\n endpointGuardFor(guard, () => permissionForEntity(entityConstructor, action));\n\n/** The request context a guard provided, read without requiring it. */\nconst callerContext = Effect.gen(function* () {\n const organizationId = yield* Effect.serviceOption(OrganizationIdTag);\n const principal = yield* Effect.serviceOption(RequestPrincipalTag);\n const verified = yield* Effect.serviceOption(VerifiedContextTag);\n return {\n ...Option.match(organizationId, {\n onNone: () => ({}),\n onSome: value => ({ organizationId: value }),\n }),\n ...Option.match(principal, {\n onNone: () => ({}),\n onSome: value => ({ principal: value }),\n }),\n ...Option.match(verified, {\n onNone: () => ({}),\n onSome: value => ({ verified: value }),\n }),\n };\n});\n\n/** The search the request carried, for the RSQL parsers. */\nconst searchParams = Effect.map(\n HttpServerRequest.HttpServerRequest,\n request => new URL(request.url, 'http://localhost').searchParams,\n);\n\n// The RSQL parsers throw a build error naming what they refused.\nconst asInvalidQuery = (error: unknown) =>\n new InvalidQuery({ reason: (error as Error).message });\n\nconst cacheHeaders = (etag: string) => ({\n etag,\n 'cache-control': 'private, no-cache',\n vary: 'Cookie, Authorization',\n});\n\n/* eslint-disable @typescript-eslint/no-explicit-any -- type-level extraction */\ntype KindOf<G> = G extends { readonly kind: infer Kind }\n ? Kind\n : G extends { readonly read: infer Read; readonly write: infer Write }\n ? KindOf<Read> | KindOf<Write>\n : never;\n\ntype OverrideValues<O> = O extends { readonly override: infer Overrides }\n ? Overrides extends object\n ? NonNullable<Overrides[keyof Overrides]>\n : never\n : never;\n\n// Distributive over the overrides, so a group with none contributes nothing.\ntype OverrideGuardKinds<V> = V extends { readonly guard: infer G }\n ? KindOf<G>\n : never;\ntype OverrideIdempotency<V> = V extends { readonly idempotent: infer I }\n ? I\n : never;\n\ntype UseCaseValues<O> = O extends { readonly useCases: infer U }\n ? U extends ReadonlyArray<infer V>\n ? V\n : never\n : never;\n\n/** Every guard kind an entity group mounts: `$metadata` is a session. */\nexport type EntityGuardKinds<O> = Extract<\n | 'session'\n | KindOf<O extends { readonly guard: infer G } ? G : never>\n | OverrideGuardKinds<OverrideValues<O> | UseCaseValues<O>>,\n EndpointGuard['kind']\n>;\n\n/** Every idempotency mode an entity group's overrides and verbs declare. */\nexport type EntityIdempotencies<O> = OverrideIdempotency<\n OverrideValues<O> | UseCaseValues<O>\n>;\n\ntype ReturnRequirements<F> = F extends (\n ...args: any[]\n) => Effect.Effect<any, any, infer R>\n ? R\n : never;\ntype OverrideRequirements<V> = V extends { readonly handler: infer H }\n ? ReturnRequirements<H>\n : never;\n\n/** What the host's `prepare` and overrides need. */\nexport type OptionsRequirements<O> =\n | ReturnRequirements<O extends { readonly prepare: infer P } ? P : never>\n | OverrideRequirements<OverrideValues<O> | UseCaseValues<O>>;\n/* eslint-enable @typescript-eslint/no-explicit-any */\n\n/** An entity endpoint as its guard kinds and idempotency type it. */\nexport type EntityEndpoint<\n Kind extends EndpointGuard['kind'],\n Idempotency,\n> = AnyEndpoint & {\n readonly guard: Extract<EndpointGuard, { readonly kind: Kind }>;\n readonly idempotent?: Idempotency;\n};\n\n/** What the shell adds when it serves an entity's declared endpoints. */\nexport interface EntityApiServing {\n /** The compositions `$metadata` reports for the entity's verbs. */\n readonly compositions?: MetadataCompositions;\n}\n\n/**\n * The generic endpoints of an entity — list, get, create, update, delete,\n * `$metadata` and, when asked, `$facets` — as one group named for its key\n * ([ADR 0020](../../../../../docs/adr/0020-endpoints-are-descriptors-and-the-shell-builds-an-httpapi.md)).\n *\n * `$metadata` and `$facets` come before `/:id`, so neither is read as an id.\n * The list query is the entity's RSQL request, parsed against its own\n * `filterable`/`sortable` metadata: a member that is not queryable answers\n * `invalidQuery`. A narrowing is conjoined onto every read and count, never\n * substituted, and a reader it leaves with nothing gets an empty page and a\n * `404`, never a `403`.\n *\n * It serves a declaration the domain made with `defineEntityApi`; what the\n * shell alone knows — the recipes and variants `$metadata` resolves verbs\n * against — is added here.\n */\nexport const entityApi = <\n T extends Entity,\n const K extends string,\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- inferred from the options\n const O extends EntityApiOptions<T, any>,\n>(\n declaration: EntityApiDeclaration<T, K, O>,\n serving: EntityApiServing = {},\n): EndpointGroup<\n EntityEndpoint<EntityGuardKinds<O>, EntityIdempotencies<O>>,\n | OptionsRequirements<O>\n | EntityRepositoryFactoryTag\n | PolicyDecisionTag\n | (O['facets'] extends true ? EntityFacetCounterFactoryTag : never)\n> => {\n const { entity: entityConstructor, key, options } = declaration;\n const base = `/api/${key}` as const;\n const record = `${base}/:id` as const;\n const mounted = new Set(options.verbs);\n const notFound = new NotFound({ entity: key });\n\n const compositions = serving.compositions ?? {};\n assertCompositionsDeclared(\n describeEntityUseCases(entityConstructor),\n compositions,\n );\n\n const verbs = options.useCases ?? [];\n // By key and binding: one key may be declared on a record and over a\n // selection, and serving one of the two must not pass for serving both.\n const unserved = describeEntityUseCases(entityConstructor)\n .filter(\n declared =>\n !verbs.some(\n verb =>\n verb.useCase.key === declared.key &&\n verb.useCase.binding === declared.binding,\n ),\n )\n .map(declared => declared.key);\n // A record-bound verb declared in a collection cell too is served there,\n // and only then: a bulk handler for a cell nobody declared is a stray.\n const inCollectionCell = (verb: VerbEndpoint<unknown>) =>\n verb.useCase.binding === 'entity' &&\n (verb.useCase.alsoAt ?? []).some(cell => cell.binding === 'collection');\n for (const verb of verbs) {\n if (inCollectionCell(verb) !== (verb.bulk !== undefined))\n throw new Error(\n `the '${key}' endpoints ` +\n (verb.bulk === undefined\n ? `serve no bulk handler for @useCase() '${verb.useCase.key}', declared in a collection cell`\n : `serve a bulk handler for @useCase() '${verb.useCase.key}', declared in no collection cell`) +\n '.',\n );\n }\n const strays = verbs.filter(\n verb => verb.useCase.entity !== entityConstructor,\n );\n if (unserved.length > 0 || strays.length > 0)\n throw new Error(\n `the '${key}' endpoints ` +\n [\n ...(unserved.length > 0\n ? [\n `serve no endpoint for @useCase() ${unserved.map(v => `'${v}'`).join(', ')}`,\n ]\n : []),\n ...(strays.length > 0\n ? [\n `serve ${strays.map(v => `'${v.useCase.key}'`).join(', ')}, declared on another entity`,\n ]\n : []),\n ].join(', and ') +\n '; a verb has exactly one endpoint, on its own entity.',\n );\n\n const linksFor = (allowed: ReadonlySet<string>): EntityApiLinks => ({\n record: id => {\n const href = `${base}/${String(id)}`;\n return [\n ...(mounted.has('get')\n ? [{ rel: 'self', href, method: 'GET' } as const]\n : []),\n ...(mounted.has('list')\n ? [{ rel: 'list', href: base, method: 'GET' } as const]\n : []),\n ...(mounted.has('update')\n ? [{ rel: 'update', href, method: 'PUT' } as const]\n : []),\n ...(mounted.has('delete')\n ? [{ rel: 'delete', href, method: 'DELETE' } as const]\n : []),\n ...verbs\n .filter(\n verb =>\n verb.useCase.binding === 'entity' &&\n allowed.has(verb.useCase.key),\n )\n .map(\n verb =>\n ({\n rel: verb.useCase.key,\n href: `${href}/${verb.useCase.key}`,\n method: 'POST',\n }) as const,\n ),\n ];\n },\n collection: () => [\n ...(mounted.has('list')\n ? [{ rel: 'self', href: base, method: 'GET' } as const]\n : []),\n ...(mounted.has('create')\n ? [{ rel: 'create', href: base, method: 'POST' } as const]\n : []),\n ...verbs\n .filter(\n verb =>\n (verb.useCase.binding !== 'entity' || verb.bulk !== undefined) &&\n allowed.has(verb.useCase.key),\n )\n .map(\n verb =>\n ({\n rel: verb.useCase.key,\n href: `${base}/${verb.useCase.key}`,\n method: 'POST',\n }) as const,\n ),\n ],\n });\n\n const guardFor = (verb: EntityApiVerb): EntityApiGuard => {\n const declared = options.override?.[verb]?.guard;\n if (declared !== undefined) return declared;\n const { guard } = options;\n return 'kind' in guard ? guard : READS.has(verb) ? guard.read : guard.write;\n };\n\n const verbGuard = (verb: VerbEndpoint<unknown>): EntityApiGuard =>\n verb.guard ?? guardFor('create');\n\n /**\n * The verbs this caller would be let through: a public verb for anybody, a\n * session verb for a principal the policy permits. A crossing verb is never\n * linked — no browser holds the token that reaches it.\n */\n const allowedVerbs = (principal: RequestPrincipal | undefined) =>\n Effect.gen(function* () {\n const policy = yield* PolicyDecisionTag;\n const allowed = new Set<string>();\n for (const verb of verbs) {\n const kind = verbGuard(verb).kind;\n if (kind === 'public') allowed.add(verb.useCase.key);\n else if (kind !== 'crossing' && principal !== undefined) {\n const { resource, action } = parsePermission(\n permissionForUseCase(entityConstructor, verb.useCase.key),\n );\n if (\n policy.decide({\n subject: { roles: principal.roles },\n resource,\n action,\n })\n )\n allowed.add(verb.useCase.key);\n }\n }\n return allowed;\n });\n\n const context = Effect.gen(function* () {\n const caller = yield* callerContext;\n // A public read verifies no session, but a signed-in caller reading it\n // still sees the verbs they may run: the links read the session, if any,\n // and never decide anything by it.\n const principal =\n caller.principal ?? Option.getOrUndefined(yield* resolveRequestPrincipal);\n const allowed = yield* allowedVerbs(principal);\n return { ...caller, links: linksFor(allowed) } as EntityApiContext;\n });\n\n const repository = (caller: EntityApiContext) =>\n Effect.flatMap(EntityRepositoryFactoryTag, factory =>\n factory.for(entityConstructor, {\n ...(caller.organizationId === undefined\n ? {}\n : { organizationId: caller.organizationId }),\n }),\n );\n\n const narrowingOf = (caller: EntityApiContext): Narrowing<T> | undefined =>\n options.narrowing === undefined || caller.verified === undefined\n ? undefined\n : narrowingFor(options.narrowing, caller.verified);\n\n const list = Effect.gen(function* () {\n const caller = yield* context;\n const search = yield* searchParams;\n const parsed = yield* Effect.try({\n try: () =>\n parseLoadRequestParams(\n entityConstructor,\n search,\n ) as unknown as EntityLoadRequest<T>,\n catch: asInvalidQuery,\n });\n const narrowing = narrowingOf(caller);\n // Still parsed: whether a query is well-formed must not depend on who\n // asked. `nothing` answers here without a query.\n if (narrowing === 'nothing')\n return makeEntityPageEnvelope(\n entityConstructor,\n { items: [], total: 0, request: parsed },\n caller.links.collection(),\n );\n const request =\n narrowing === undefined || narrowing === 'unscoped'\n ? parsed\n : narrowLoadRequest(parsed, narrowing);\n const page = yield* loadUCFactory<T>().pipe(\n Effect.provideService(EntityRepositoryTag, yield* repository(caller)),\n Effect.provideService(\n EntityLoadRequestTag,\n request as unknown as EntityLoadRequest,\n ),\n );\n return makeEntityPageEnvelope(\n entityConstructor,\n page,\n caller.links.collection(),\n );\n });\n\n const get = (id: string) =>\n Effect.gen(function* () {\n const caller = yield* context;\n const narrowing = narrowingOf(caller);\n if (narrowing === 'nothing') return yield* Effect.fail(notFound);\n // A filter narrowing reads by id as a narrowed load, so the read and the\n // list apply one rule.\n if (narrowing !== undefined && narrowing !== 'unscoped') {\n const page = yield* loadUCFactory<T>().pipe(\n Effect.provideService(EntityRepositoryTag, yield* repository(caller)),\n Effect.provideService(\n EntityLoadRequestTag,\n narrowedByIdRequest<T>(\n narrowing,\n id,\n ) as unknown as EntityLoadRequest,\n ),\n );\n const [only] = page.items;\n if (only === undefined) return yield* Effect.fail(notFound);\n return makeEntityEnvelope(\n entityConstructor,\n only,\n caller.links.record(id),\n );\n }\n const found = yield* getUCFactory<T>().pipe(\n Effect.provideService(EntityRepositoryTag, yield* repository(caller)),\n Effect.provideService(EntityIdTag, id),\n );\n return makeEntityEnvelope(\n entityConstructor,\n found,\n caller.links.record(id),\n );\n });\n\n const save = (verb: 'create' | 'update', body: unknown, id?: string) =>\n Effect.gen(function* () {\n const caller = yield* context;\n let entity = yield* readEntityEnvelope(entityConstructor, body);\n // On update the path is authoritative, so a record cannot be renamed\n // onto another one by editing its payload.\n if (id !== undefined) entity.id = id;\n if (options.prepare !== undefined)\n entity = yield* options.prepare(entity, { ...caller, verb });\n const saved = yield* saveUCFactory<T>().pipe(\n Effect.provideService(EntityRepositoryTag, yield* repository(caller)),\n Effect.provideService(EntityTag, entity),\n );\n return makeEntityEnvelope(\n entityConstructor,\n saved,\n caller.links.record(saved.id),\n );\n });\n\n const remove = (id: string) =>\n Effect.gen(function* () {\n const caller = yield* context;\n yield* deleteUCFactory<T>().pipe(\n Effect.provideService(EntityRepositoryTag, yield* repository(caller)),\n Effect.provideService(EntityIdTag, id),\n );\n // An envelope rather than a bare `204`: every message between entifix\n // artifacts is one.\n return {\n meta: { type: 'entity', entity: key, links: caller.links.collection() },\n data: { id },\n };\n });\n\n const metadata = Effect.gen(function* () {\n const principal = yield* RequestPrincipalTag;\n const verified = yield* VerifiedContextTag;\n const policy = yield* PolicyDecisionTag;\n const allows = (permission: Permission): boolean => {\n const { resource, action } = parsePermission(permission);\n return policy.decide({\n subject: { roles: principal.roles },\n resource,\n action,\n });\n };\n // SECURITY BOUNDARY. The document is a map of the model, so an entity the\n // caller may not read answers exactly as one this service does not host:\n // a `403` would make the endpoint an oracle.\n if (!allows(permissionForEntity(entityConstructor, 'read')))\n return yield* Effect.fail(notFound);\n\n const document: EntityMetadataDocument = {\n actions: ENTITY_ACTIONS.filter(action =>\n allows(permissionForEntity(entityConstructor, action)),\n ),\n useCases: describeEntityUseCases(entityConstructor)\n .filter(descriptor =>\n allows(permissionForUseCase(entityConstructor, descriptor.key)),\n )\n // A verb the caller resolves to nothing is omitted, like one they may\n // not invoke; the rest carry what they resolve to.\n .flatMap(descriptor => {\n const composition = compositionFor(\n descriptor,\n verified,\n compositions,\n );\n if (composition === 'unreachable') return [];\n return composition === undefined\n ? [descriptor]\n : [{ ...descriptor, composition }];\n }),\n };\n\n // The ETag hashes the computed document, not the model: two principals\n // with different grants get different documents from one model.\n const body = JSON.stringify(\n makeEntityMetadataEnvelope(entityConstructor, document),\n );\n const etag = `\"${createHash('sha256').update(body).digest('hex')}\"`;\n const request = yield* HttpServerRequest.HttpServerRequest;\n if (request.headers['if-none-match'] === etag)\n return HttpServerResponse.empty({ status: 304 }).pipe(\n HttpServerResponse.setHeaders(cacheHeaders(etag)),\n );\n return HttpServerResponse.text(body, {\n contentType: 'application/json',\n headers: cacheHeaders(etag),\n });\n });\n\n const facets = Effect.gen(function* () {\n const caller = yield* context;\n const search = yield* searchParams;\n const queries = yield* Effect.try({\n try: () => parseFacetQueryParams(entityConstructor, search),\n catch: asInvalidQuery,\n });\n const narrowing = narrowingOf(caller) ?? 'unscoped';\n if (narrowing === 'nothing') {\n const empty: EntityFacetCounts = Object.fromEntries(\n queries.map(({ member }) => [member, []]),\n );\n return makeEntityFacetsEnvelope(entityConstructor, empty);\n }\n const narrowed: EntityFacetQuery<T>[] =\n narrowing === 'unscoped'\n ? queries\n : queries.map(query => ({\n ...query,\n filtering: [...(query.filtering ?? []), narrowing],\n }));\n const factory = yield* EntityFacetCounterFactoryTag;\n const counter = yield* factory.for(entityConstructor, {\n ...(caller.organizationId === undefined\n ? {}\n : { organizationId: caller.organizationId }),\n });\n const counts = yield* facetCountsUCFactory<T>(narrowed).pipe(\n Effect.provideService(EntityFacetCounterTag, counter),\n );\n return makeEntityFacetsEnvelope(entityConstructor, counts);\n });\n\n const crudEndpoint = (verb: EntityApiVerb): Implemented => {\n const override = options.override?.[verb];\n const withId = verb !== 'list' && verb !== 'create';\n const takesBody = verb === 'create' || verb === 'update';\n const payload = takesBody\n ? (override?.payload ?? EnvelopeBody)\n : override?.payload;\n const descriptor = defineEndpoint({\n name: verb,\n method: METHOD[verb],\n path: withId ? record : base,\n ...(withId ? { params: { id: Schema.String } } : {}),\n ...(payload === undefined ? {} : { payload }),\n success: JsonBody,\n errors: [\n ...(verb === 'get' || verb === 'update' || verb === 'delete'\n ? [NotFound]\n : []),\n ...(verb === 'list' ? [InvalidQuery] : []),\n ...(takesBody ? (options.errors ?? []) : []),\n ...(override?.errors ?? []),\n ],\n guard: endpointGuard(entityConstructor, guardFor(verb), ACTION[verb]),\n ...(override?.idempotent === undefined\n ? {}\n : { idempotent: override.idempotent }),\n } as AnyEndpoint);\n\n return implement(descriptor, ((request: EntityApiRequest) => {\n if (override !== undefined)\n return Effect.flatMap(context, caller =>\n override.handler(request, caller),\n );\n const id = request.params?.id as string;\n switch (verb) {\n case 'list':\n return list;\n case 'get':\n return get(id);\n case 'create':\n return save('create', request.payload);\n case 'update':\n return save('update', request.payload, id);\n case 'delete':\n return remove(id);\n }\n }) as never) as Implemented;\n };\n\n const readGuard = guardFor('list');\n const endpoints: Implemented[] = [\n // Registered first, so neither is captured by `/:id`.\n implement(\n defineEndpoint({\n name: 'metadata',\n method: 'GET',\n path: `${base}/$metadata`,\n success: JsonBody,\n errors: [NotFound],\n guard: { kind: 'session' },\n }) as AnyEndpoint,\n (() => metadata) as never,\n ),\n ...(options.facets === true\n ? [\n implement(\n defineEndpoint({\n name: 'facets',\n method: 'GET',\n path: `${base}/$facets`,\n success: JsonBody,\n errors: [InvalidQuery],\n guard: endpointGuard(entityConstructor, readGuard, 'read'),\n }) as AnyEndpoint,\n (() => facets) as never,\n ),\n ]\n : []),\n ...options.verbs.map(crudEndpoint),\n ...verbs.map(verb => {\n const { useCase } = verb;\n const payload =\n useCase.payload ??\n (useCase.binding === 'collection' ? SelectionBody : undefined);\n const descriptor = defineEndpoint({\n // One key may be served both ways — `publish` on a record and over a\n // selection — under one permission, so a name carries the binding\n // whenever it is not the record's.\n name:\n useCase.binding === 'entity'\n ? useCase.key\n : `${useCase.key}-${useCase.binding}`,\n method: 'POST',\n path: verbPath(key, useCase.key, useCase.binding),\n ...(useCase.binding === 'entity'\n ? { params: { id: Schema.String } }\n : {}),\n ...(payload === undefined ? {} : { payload }),\n success: useCase.success ?? JsonBody,\n errors: [...(useCase.errors ?? [])],\n guard: endpointGuardFor(verbGuard(verb), () =>\n permissionForUseCase(entityConstructor, useCase.key),\n ),\n useCase: useCase.key,\n ...(verb.idempotent === undefined\n ? {}\n : { idempotent: verb.idempotent }),\n } as AnyEndpoint);\n return implement(descriptor, ((request: EntityApiRequest) =>\n Effect.flatMap(context, caller =>\n verb.handler(request, caller),\n )) as never) as Implemented;\n }),\n ...verbs.flatMap(verb => {\n const { bulk } = verb;\n if (bulk === undefined) return [];\n const { useCase } = verb;\n const descriptor = defineEndpoint({\n name: `${useCase.key}-collection`,\n method: 'POST',\n path: verbPath(key, useCase.key, 'collection'),\n payload: SelectionBody,\n success: JsonBody,\n errors: [...(useCase.errors ?? [])],\n guard: endpointGuardFor(verbGuard(verb), () =>\n permissionForUseCase(entityConstructor, useCase.key),\n ),\n useCase: useCase.key,\n ...(verb.idempotent === undefined\n ? {}\n : { idempotent: verb.idempotent }),\n } as AnyEndpoint);\n return [\n implement(descriptor, ((request: EntityApiRequest) =>\n Effect.flatMap(context, caller => bulk(request, caller))) as never),\n ] as Implemented[];\n }),\n ];\n\n return { name: key, endpoints } as never;\n};\n"],"names":["createHash","parsePermission","permissionForEntity","permissionForUseCase","PolicyDecisionTag","deleteUCFactory","EntityFacetCounterFactoryTag","EntityFacetCounterTag","EntityIdTag","EntityLoadRequestTag","EntityRepositoryFactoryTag","EntityRepositoryTag","EntityTag","facetCountsUCFactory","getUCFactory","loadUCFactory","OrganizationIdTag","RequestPrincipalTag","saveUCFactory","VerifiedContextTag","defineEndpoint","describeEntityUseCases","ENTITY_ACTIONS","Envelope","implement","InvalidQuery","JsonBody","makeEntityEnvelope","makeEntityFacetsEnvelope","makeEntityMetadataEnvelope","makeEntityPageEnvelope","NotFound","parseFacetQueryParams","parseLoadRequestParams","readEntityEnvelope","verbPath","Effect","Option","Schema","HttpServerRequest","HttpServerResponse","resolveRequestPrincipal","assertCompositionsDeclared","compositionFor","narrowedByIdRequest","narrowingFor","narrowLoadRequest","SelectionBody","Struct","selection","Unknown","ACTION","list","get","create","update","delete","READS","Set","METHOD","EnvelopeBody","codec","endpointGuardFor","guard","permission","kind","organization","endpointGuard","entityConstructor","action","callerContext","gen","organizationId","serviceOption","principal","verified","match","onNone","onSome","value","searchParams","map","request","URL","url","asInvalidQuery","error","reason","message","cacheHeaders","etag","vary","entityApi","declaration","serving","options","entity","key","base","record","mounted","verbs","notFound","compositions","useCases","unserved","filter","declared","some","verb","useCase","binding","inCollectionCell","alsoAt","cell","bulk","undefined","Error","strays","length","v","join","linksFor","allowed","id","href","String","has","rel","method","collection","guardFor","override","read","write","verbGuard","allowedVerbs","policy","add","resource","decide","subject","roles","context","caller","getOrUndefined","links","repository","flatMap","factory","for","narrowingOf","narrowing","search","parsed","try","catch","items","total","page","pipe","provideService","fail","only","found","save","body","prepare","saved","remove","meta","type","data","metadata","allows","document","actions","descriptor","composition","JSON","stringify","digest","headers","empty","status","setHeaders","text","contentType","facets","queries","Object","fromEntries","member","narrowed","query","filtering","counter","counts","crudEndpoint","withId","takesBody","payload","name","path","params","success","errors","idempotent","handler","readGuard","endpoints"],"mappings":";AAAA,SAASA,UAAU,QAAQ,cAAc;AAEzC,SAEEC,eAAe,EAEfC,mBAAmB,EACnBC,oBAAoB,EACpBC,iBAAiB,QACZ,iBAAiB;AACxB,SACEC,eAAe,EAQfC,4BAA4B,EAC5BC,qBAAqB,EACrBC,WAAW,EACXC,oBAAoB,EACpBC,0BAA0B,EAC1BC,mBAAmB,EACnBC,SAAS,EACTC,oBAAoB,EACpBC,YAAY,EACZC,aAAa,EAEbC,iBAAiB,EAEjBC,mBAAmB,EACnBC,aAAa,EAEbC,kBAAkB,QACb,oBAAoB;AAC3B,SAEEC,cAAc,EACdC,sBAAsB,EAGtBC,cAAc,EAMdC,QAAQ,EACRC,SAAS,EAETC,YAAY,EACZC,QAAQ,EACRC,kBAAkB,EAClBC,wBAAwB,EACxBC,0BAA0B,EAC1BC,sBAAsB,EACtBC,QAAQ,EACRC,qBAAqB,EACrBC,sBAAsB,EACtBC,kBAAkB,EAClBC,QAAQ,QACH,gBAAgB;AACvB,SAASC,MAAM,EAAEC,MAAM,EAAEC,MAAM,QAAQ,SAAS;AAChD,SAASC,iBAAiB,EAAEC,kBAAkB,QAAQ,cAAc;AAEpE,SAASC,uBAAuB,QAAQ,+BAA+B;AACvE,SACEC,0BAA0B,EAC1BC,cAAc,QAET,6BAA6B;AACpC,SACEC,mBAAmB,EACnBC,YAAY,EACZC,iBAAiB,QACZ,kBAAkB;AAGzB,+DAA+D,GAC/D,MAAMC,gBAAgBT,OAAOU,MAAM,CAAC;IAAEC,WAAWX,OAAOY,OAAO;AAAC;AAEhE,MAAMC,SAAwC;IAC5CC,MAAM;IACNC,KAAK;IACLC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;AACV;AAEA,MAAMC,QAAoC,IAAIC,IAAI;IAAC;IAAQ;CAAM;AAEjE,MAAMC,SAAS;IACbP,MAAM;IACNC,KAAK;IACLC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;AACV;AAEA,yEAAyE,GACzE,MAAMI,eAAerC,SAASsC,KAAK,CAACvB,OAAOY,OAAO;AAElD,MAAMY,mBAAmB,CACvBC,OACAC;IAEA,OAAQD,MAAME,IAAI;QAChB,KAAK;YACH,OAAO;gBAAEA,MAAM;YAAS;QAC1B,KAAK;YACH,OAAO;gBACLA,MAAM;gBACND,YAAYA;gBACZE,cAAcH,MAAMG,YAAY;YAClC;QACF;YACE,OAAO;gBAAED,MAAMF,MAAME,IAAI;gBAAED,YAAYA;YAAa;IACxD;AACF;AAEA,MAAMG,gBAAgB,CACpBC,mBACAL,OACAM,SAEAP,iBAAiBC,OAAO,IAAM7D,oBAAoBkE,mBAAmBC;AAEvE,qEAAqE,GACrE,MAAMC,gBAAgBlC,OAAOmC,GAAG,CAAC;IAC/B,MAAMC,iBAAiB,OAAOpC,OAAOqC,aAAa,CAACzD;IACnD,MAAM0D,YAAY,OAAOtC,OAAOqC,aAAa,CAACxD;IAC9C,MAAM0D,WAAW,OAAOvC,OAAOqC,aAAa,CAACtD;IAC7C,OAAO,aACFkB,OAAOuC,KAAK,CAACJ,gBAAgB;QAC9BK,QAAQ,IAAO,CAAA,CAAC,CAAA;QAChBC,QAAQC,CAAAA,QAAU,CAAA;gBAAEP,gBAAgBO;YAAM,CAAA;IAC5C,IACG1C,OAAOuC,KAAK,CAACF,WAAW;QACzBG,QAAQ,IAAO,CAAA,CAAC,CAAA;QAChBC,QAAQC,CAAAA,QAAU,CAAA;gBAAEL,WAAWK;YAAM,CAAA;IACvC,IACG1C,OAAOuC,KAAK,CAACD,UAAU;QACxBE,QAAQ,IAAO,CAAA,CAAC,CAAA;QAChBC,QAAQC,CAAAA,QAAU,CAAA;gBAAEJ,UAAUI;YAAM,CAAA;IACtC;AAEJ;AAEA,0DAA0D,GAC1D,MAAMC,eAAe5C,OAAO6C,GAAG,CAC7B1C,kBAAkBA,iBAAiB,EACnC2C,CAAAA,UAAW,IAAIC,IAAID,QAAQE,GAAG,EAAE,oBAAoBJ,YAAY;AAGlE,iEAAiE;AACjE,MAAMK,iBAAiB,CAACC,QACtB,IAAI7D,aAAa;QAAE8D,QAAQ,AAACD,MAAgBE,OAAO;IAAC;AAEtD,MAAMC,eAAe,CAACC,OAAkB,CAAA;QACtCA;QACA,iBAAiB;QACjBC,MAAM;IACR,CAAA;AAwEA;;;;;;;;;;;;;;;CAeC,GACD,OAAO,MAAMC,YAAY,CAMvBC,aACAC,UAA4B,CAAC,CAAC;QAcTA,uBAMPC;IAZd,MAAM,EAAEC,QAAQ5B,iBAAiB,EAAE6B,GAAG,EAAEF,OAAO,EAAE,GAAGF;IACpD,MAAMK,OAAO,CAAC,KAAK,EAAED,KAAK;IAC1B,MAAME,SAAS,GAAGD,KAAK,IAAI,CAAC;IAC5B,MAAME,UAAU,IAAI1C,IAAIqC,QAAQM,KAAK;IACrC,MAAMC,WAAW,IAAIvE,SAAS;QAAEiE,QAAQC;IAAI;IAE5C,MAAMM,gBAAeT,wBAAAA,QAAQS,YAAY,YAApBT,wBAAwB,CAAC;IAC9CpD,2BACErB,uBAAuB+C,oBACvBmC;IAGF,MAAMF,SAAQN,oBAAAA,QAAQS,QAAQ,YAAhBT,oBAAoB,EAAE;IACpC,qEAAqE;IACrE,wEAAwE;IACxE,MAAMU,WAAWpF,uBAAuB+C,mBACrCsC,MAAM,CACLC,CAAAA,WACE,CAACN,MAAMO,IAAI,CACTC,CAAAA,OACEA,KAAKC,OAAO,CAACb,GAAG,KAAKU,SAASV,GAAG,IACjCY,KAAKC,OAAO,CAACC,OAAO,KAAKJ,SAASI,OAAO,GAGhD9B,GAAG,CAAC0B,CAAAA,WAAYA,SAASV,GAAG;IAC/B,yEAAyE;IACzE,uEAAuE;IACvE,MAAMe,mBAAmB,CAACH;YAEvBA;eADDA,KAAKC,OAAO,CAACC,OAAO,KAAK,YACzB,EAACF,uBAAAA,KAAKC,OAAO,CAACG,MAAM,YAAnBJ,uBAAuB,EAAE,EAAED,IAAI,CAACM,CAAAA,OAAQA,KAAKH,OAAO,KAAK;;IAC5D,KAAK,MAAMF,QAAQR,MAAO;QACxB,IAAIW,iBAAiBH,UAAWA,CAAAA,KAAKM,IAAI,KAAKC,SAAQ,GACpD,MAAM,IAAIC,MACR,CAAC,KAAK,EAAEpB,IAAI,YAAY,CAAC,GACtBY,CAAAA,KAAKM,IAAI,KAAKC,YACX,CAAC,sCAAsC,EAAEP,KAAKC,OAAO,CAACb,GAAG,CAAC,gCAAgC,CAAC,GAC3F,CAAC,qCAAqC,EAAEY,KAAKC,OAAO,CAACb,GAAG,CAAC,iCAAiC,CAAC,AAAD,IAC9F;IAER;IACA,MAAMqB,SAASjB,MAAMK,MAAM,CACzBG,CAAAA,OAAQA,KAAKC,OAAO,CAACd,MAAM,KAAK5B;IAElC,IAAIqC,SAASc,MAAM,GAAG,KAAKD,OAAOC,MAAM,GAAG,GACzC,MAAM,IAAIF,MACR,CAAC,KAAK,EAAEpB,IAAI,YAAY,CAAC,GACvB;WACMQ,SAASc,MAAM,GAAG,IAClB;YACE,CAAC,iCAAiC,EAAEd,SAASxB,GAAG,CAACuC,CAAAA,IAAK,CAAC,CAAC,EAAEA,EAAE,CAAC,CAAC,EAAEC,IAAI,CAAC,OAAO;SAC7E,GACD,EAAE;WACFH,OAAOC,MAAM,GAAG,IAChB;YACE,CAAC,MAAM,EAAED,OAAOrC,GAAG,CAACuC,CAAAA,IAAK,CAAC,CAAC,EAAEA,EAAEV,OAAO,CAACb,GAAG,CAAC,CAAC,CAAC,EAAEwB,IAAI,CAAC,MAAM,4BAA4B,CAAC;SACxF,GACD,EAAE;KACP,CAACA,IAAI,CAAC,YACP;IAGN,MAAMC,WAAW,CAACC,UAAkD,CAAA;YAClExB,QAAQyB,CAAAA;gBACN,MAAMC,OAAO,GAAG3B,KAAK,CAAC,EAAE4B,OAAOF,KAAK;gBACpC,OAAO;uBACDxB,QAAQ2B,GAAG,CAAC,SACZ;wBAAC;4BAAEC,KAAK;4BAAQH;4BAAMI,QAAQ;wBAAM;qBAAW,GAC/C,EAAE;uBACF7B,QAAQ2B,GAAG,CAAC,UACZ;wBAAC;4BAAEC,KAAK;4BAAQH,MAAM3B;4BAAM+B,QAAQ;wBAAM;qBAAW,GACrD,EAAE;uBACF7B,QAAQ2B,GAAG,CAAC,YACZ;wBAAC;4BAAEC,KAAK;4BAAUH;4BAAMI,QAAQ;wBAAM;qBAAW,GACjD,EAAE;uBACF7B,QAAQ2B,GAAG,CAAC,YACZ;wBAAC;4BAAEC,KAAK;4BAAUH;4BAAMI,QAAQ;wBAAS;qBAAW,GACpD,EAAE;uBACH5B,MACAK,MAAM,CACLG,CAAAA,OACEA,KAAKC,OAAO,CAACC,OAAO,KAAK,YACzBY,QAAQI,GAAG,CAAClB,KAAKC,OAAO,CAACb,GAAG,GAE/BhB,GAAG,CACF4B,CAAAA,OACG,CAAA;4BACCmB,KAAKnB,KAAKC,OAAO,CAACb,GAAG;4BACrB4B,MAAM,GAAGA,KAAK,CAAC,EAAEhB,KAAKC,OAAO,CAACb,GAAG,EAAE;4BACnCgC,QAAQ;wBACV,CAAA;iBAEP;YACH;YACAC,YAAY,IAAM;uBACZ9B,QAAQ2B,GAAG,CAAC,UACZ;wBAAC;4BAAEC,KAAK;4BAAQH,MAAM3B;4BAAM+B,QAAQ;wBAAM;qBAAW,GACrD,EAAE;uBACF7B,QAAQ2B,GAAG,CAAC,YACZ;wBAAC;4BAAEC,KAAK;4BAAUH,MAAM3B;4BAAM+B,QAAQ;wBAAO;qBAAW,GACxD,EAAE;uBACH5B,MACAK,MAAM,CACLG,CAAAA,OACE,AAACA,CAAAA,KAAKC,OAAO,CAACC,OAAO,KAAK,YAAYF,KAAKM,IAAI,KAAKC,SAAQ,KAC5DO,QAAQI,GAAG,CAAClB,KAAKC,OAAO,CAACb,GAAG,GAE/BhB,GAAG,CACF4B,CAAAA,OACG,CAAA;4BACCmB,KAAKnB,KAAKC,OAAO,CAACb,GAAG;4BACrB4B,MAAM,GAAG3B,KAAK,CAAC,EAAEW,KAAKC,OAAO,CAACb,GAAG,EAAE;4BACnCgC,QAAQ;wBACV,CAAA;iBAEP;QACH,CAAA;IAEA,MAAME,WAAW,CAACtB;YACCd,wBAAAA;QAAjB,MAAMY,YAAWZ,oBAAAA,QAAQqC,QAAQ,sBAAhBrC,yBAAAA,iBAAkB,CAACc,KAAK,qBAAxBd,uBAA0BhC,KAAK;QAChD,IAAI4C,aAAaS,WAAW,OAAOT;QACnC,MAAM,EAAE5C,KAAK,EAAE,GAAGgC;QAClB,OAAO,UAAUhC,QAAQA,QAAQN,MAAMsE,GAAG,CAAClB,QAAQ9C,MAAMsE,IAAI,GAAGtE,MAAMuE,KAAK;IAC7E;IAEA,MAAMC,YAAY,CAAC1B;YACjBA;gBAAAA,cAAAA,KAAK9C,KAAK,YAAV8C,cAAcsB,SAAS;;IAEzB;;;;GAIC,GACD,MAAMK,eAAe,CAAC9D,YACpBtC,OAAOmC,GAAG,CAAC;YACT,MAAMkE,SAAS,OAAOrI;YACtB,MAAMuH,UAAU,IAAIjE;YACpB,KAAK,MAAMmD,QAAQR,MAAO;gBACxB,MAAMpC,OAAOsE,UAAU1B,MAAM5C,IAAI;gBACjC,IAAIA,SAAS,UAAU0D,QAAQe,GAAG,CAAC7B,KAAKC,OAAO,CAACb,GAAG;qBAC9C,IAAIhC,SAAS,cAAcS,cAAc0C,WAAW;oBACvD,MAAM,EAAEuB,QAAQ,EAAEtE,MAAM,EAAE,GAAGpE,gBAC3BE,qBAAqBiE,mBAAmByC,KAAKC,OAAO,CAACb,GAAG;oBAE1D,IACEwC,OAAOG,MAAM,CAAC;wBACZC,SAAS;4BAAEC,OAAOpE,UAAUoE,KAAK;wBAAC;wBAClCH;wBACAtE;oBACF,IAEAsD,QAAQe,GAAG,CAAC7B,KAAKC,OAAO,CAACb,GAAG;gBAChC;YACF;YACA,OAAO0B;QACT;IAEF,MAAMoB,UAAU3G,OAAOmC,GAAG,CAAC;YAMvByE;QALF,MAAMA,SAAS,OAAO1E;QACtB,uEAAuE;QACvE,yEAAyE;QACzE,mCAAmC;QACnC,MAAMI,aACJsE,oBAAAA,OAAOtE,SAAS,YAAhBsE,oBAAoB3G,OAAO4G,cAAc,CAAC,CAAA,OAAOxG,uBAAsB;QACzE,MAAMkF,UAAU,OAAOa,aAAa9D;QACpC,OAAO,aAAKsE;YAAQE,OAAOxB,SAASC;;IACtC;IAEA,MAAMwB,aAAa,CAACH,SAClB5G,OAAOgH,OAAO,CAAC1I,4BAA4B2I,CAAAA,UACzCA,QAAQC,GAAG,CAAClF,mBAAmB,aACzB4E,OAAOxE,cAAc,KAAK4C,YAC1B,CAAC,IACD;gBAAE5C,gBAAgBwE,OAAOxE,cAAc;YAAC;IAIlD,MAAM+E,cAAc,CAACP,SACnBjD,QAAQyD,SAAS,KAAKpC,aAAa4B,OAAOrE,QAAQ,KAAKyC,YACnDA,YACAvE,aAAakD,QAAQyD,SAAS,EAAER,OAAOrE,QAAQ;IAErD,MAAMvB,OAAOhB,OAAOmC,GAAG,CAAC;QACtB,MAAMyE,SAAS,OAAOD;QACtB,MAAMU,SAAS,OAAOzE;QACtB,MAAM0E,SAAS,OAAOtH,OAAOuH,GAAG,CAAC;YAC/BA,KAAK,IACH1H,uBACEmC,mBACAqF;YAEJG,OAAOvE;QACT;QACA,MAAMmE,YAAYD,YAAYP;QAC9B,sEAAsE;QACtE,iDAAiD;QACjD,IAAIQ,cAAc,WAChB,OAAO1H,uBACLsC,mBACA;YAAEyF,OAAO,EAAE;YAAEC,OAAO;YAAG5E,SAASwE;QAAO,GACvCV,OAAOE,KAAK,CAAChB,UAAU;QAE3B,MAAMhD,UACJsE,cAAcpC,aAAaoC,cAAc,aACrCE,SACA5G,kBAAkB4G,QAAQF;QAChC,MAAMO,OAAO,OAAOhJ,gBAAmBiJ,IAAI,CACzC5H,OAAO6H,cAAc,CAACtJ,qBAAqB,CAAA,OAAOwI,WAAWH,OAAM,IACnE5G,OAAO6H,cAAc,CACnBxJ,sBACAyE;QAGJ,OAAOpD,uBACLsC,mBACA2F,MACAf,OAAOE,KAAK,CAAChB,UAAU;IAE3B;IAEA,MAAM7E,MAAM,CAACuE,KACXxF,OAAOmC,GAAG,CAAC;YACT,MAAMyE,SAAS,OAAOD;YACtB,MAAMS,YAAYD,YAAYP;YAC9B,IAAIQ,cAAc,WAAW,OAAO,OAAOpH,OAAO8H,IAAI,CAAC5D;YACvD,yEAAyE;YACzE,uBAAuB;YACvB,IAAIkD,cAAcpC,aAAaoC,cAAc,YAAY;gBACvD,MAAMO,OAAO,OAAOhJ,gBAAmBiJ,IAAI,CACzC5H,OAAO6H,cAAc,CAACtJ,qBAAqB,CAAA,OAAOwI,WAAWH,OAAM,IACnE5G,OAAO6H,cAAc,CACnBxJ,sBACAmC,oBACE4G,WACA5B;gBAIN,MAAM,CAACuC,KAAK,GAAGJ,KAAKF,KAAK;gBACzB,IAAIM,SAAS/C,WAAW,OAAO,OAAOhF,OAAO8H,IAAI,CAAC5D;gBAClD,OAAO3E,mBACLyC,mBACA+F,MACAnB,OAAOE,KAAK,CAAC/C,MAAM,CAACyB;YAExB;YACA,MAAMwC,QAAQ,OAAOtJ,eAAkBkJ,IAAI,CACzC5H,OAAO6H,cAAc,CAACtJ,qBAAqB,CAAA,OAAOwI,WAAWH,OAAM,IACnE5G,OAAO6H,cAAc,CAACzJ,aAAaoH;YAErC,OAAOjG,mBACLyC,mBACAgG,OACApB,OAAOE,KAAK,CAAC/C,MAAM,CAACyB;QAExB;IAEF,MAAMyC,OAAO,CAACxD,MAA2ByD,MAAe1C,KACtDxF,OAAOmC,GAAG,CAAC;YACT,MAAMyE,SAAS,OAAOD;YACtB,IAAI/C,SAAS,OAAO9D,mBAAmBkC,mBAAmBkG;YAC1D,qEAAqE;YACrE,2CAA2C;YAC3C,IAAI1C,OAAOR,WAAWpB,OAAO4B,EAAE,GAAGA;YAClC,IAAI7B,QAAQwE,OAAO,KAAKnD,WACtBpB,SAAS,OAAOD,QAAQwE,OAAO,CAACvE,QAAQ,aAAKgD;gBAAQnC;;YACvD,MAAM2D,QAAQ,OAAOtJ,gBAAmB8I,IAAI,CAC1C5H,OAAO6H,cAAc,CAACtJ,qBAAqB,CAAA,OAAOwI,WAAWH,OAAM,IACnE5G,OAAO6H,cAAc,CAACrJ,WAAWoF;YAEnC,OAAOrE,mBACLyC,mBACAoG,OACAxB,OAAOE,KAAK,CAAC/C,MAAM,CAACqE,MAAM5C,EAAE;QAEhC;IAEF,MAAM6C,SAAS,CAAC7C,KACdxF,OAAOmC,GAAG,CAAC;YACT,MAAMyE,SAAS,OAAOD;YACtB,OAAO1I,kBAAqB2J,IAAI,CAC9B5H,OAAO6H,cAAc,CAACtJ,qBAAqB,CAAA,OAAOwI,WAAWH,OAAM,IACnE5G,OAAO6H,cAAc,CAACzJ,aAAaoH;YAErC,sEAAsE;YACtE,oBAAoB;YACpB,OAAO;gBACL8C,MAAM;oBAAEC,MAAM;oBAAU3E,QAAQC;oBAAKiD,OAAOF,OAAOE,KAAK,CAAChB,UAAU;gBAAG;gBACtE0C,MAAM;oBAAEhD;gBAAG;YACb;QACF;IAEF,MAAMiD,WAAWzI,OAAOmC,GAAG,CAAC;QAC1B,MAAMG,YAAY,OAAOzD;QACzB,MAAM0D,WAAW,OAAOxD;QACxB,MAAMsH,SAAS,OAAOrI;QACtB,MAAM0K,SAAS,CAAC9G;YACd,MAAM,EAAE2E,QAAQ,EAAEtE,MAAM,EAAE,GAAGpE,gBAAgB+D;YAC7C,OAAOyE,OAAOG,MAAM,CAAC;gBACnBC,SAAS;oBAAEC,OAAOpE,UAAUoE,KAAK;gBAAC;gBAClCH;gBACAtE;YACF;QACF;QACA,0EAA0E;QAC1E,yEAAyE;QACzE,6CAA6C;QAC7C,IAAI,CAACyG,OAAO5K,oBAAoBkE,mBAAmB,UACjD,OAAO,OAAOhC,OAAO8H,IAAI,CAAC5D;QAE5B,MAAMyE,WAAmC;YACvCC,SAAS1J,eAAeoF,MAAM,CAACrC,CAAAA,SAC7ByG,OAAO5K,oBAAoBkE,mBAAmBC;YAEhDmC,UAAUnF,uBAAuB+C,mBAC9BsC,MAAM,CAACuE,CAAAA,aACNH,OAAO3K,qBAAqBiE,mBAAmB6G,WAAWhF,GAAG,GAE/D,sEAAsE;YACtE,mDAAmD;aAClDmD,OAAO,CAAC6B,CAAAA;gBACP,MAAMC,cAAcvI,eAClBsI,YACAtG,UACA4B;gBAEF,IAAI2E,gBAAgB,eAAe,OAAO,EAAE;gBAC5C,OAAOA,gBAAgB9D,YACnB;oBAAC6D;iBAAW,GACZ;oBAAC,aAAKA;wBAAYC;;iBAAc;YACtC;QACJ;QAEA,uEAAuE;QACvE,gEAAgE;QAChE,MAAMZ,OAAOa,KAAKC,SAAS,CACzBvJ,2BAA2BuC,mBAAmB2G;QAEhD,MAAMrF,OAAO,CAAC,CAAC,EAAE1F,WAAW,UAAUuD,MAAM,CAAC+G,MAAMe,MAAM,CAAC,OAAO,CAAC,CAAC;QACnE,MAAMnG,UAAU,OAAO3C,kBAAkBA,iBAAiB;QAC1D,IAAI2C,QAAQoG,OAAO,CAAC,gBAAgB,KAAK5F,MACvC,OAAOlD,mBAAmB+I,KAAK,CAAC;YAAEC,QAAQ;QAAI,GAAGxB,IAAI,CACnDxH,mBAAmBiJ,UAAU,CAAChG,aAAaC;QAE/C,OAAOlD,mBAAmBkJ,IAAI,CAACpB,MAAM;YACnCqB,aAAa;YACbL,SAAS7F,aAAaC;QACxB;IACF;IAEA,MAAMkG,SAASxJ,OAAOmC,GAAG,CAAC;YAONgF;QANlB,MAAMP,SAAS,OAAOD;QACtB,MAAMU,SAAS,OAAOzE;QACtB,MAAM6G,UAAU,OAAOzJ,OAAOuH,GAAG,CAAC;YAChCA,KAAK,IAAM3H,sBAAsBoC,mBAAmBqF;YACpDG,OAAOvE;QACT;QACA,MAAMmE,aAAYD,eAAAA,YAAYP,mBAAZO,eAAuB;QACzC,IAAIC,cAAc,WAAW;YAC3B,MAAM+B,QAA2BO,OAAOC,WAAW,CACjDF,QAAQ5G,GAAG,CAAC,CAAC,EAAE+G,MAAM,EAAE,GAAK;oBAACA;oBAAQ,EAAE;iBAAC;YAE1C,OAAOpK,yBAAyBwC,mBAAmBmH;QACrD;QACA,MAAMU,WACJzC,cAAc,aACVqC,UACAA,QAAQ5G,GAAG,CAACiH,CAAAA;gBAEMA;mBAFI,aACjBA;gBACHC,WAAW;wBAAKD,mBAAAA,MAAMC,SAAS,YAAfD,mBAAmB,EAAE;oBAAG1C;iBAAU;;;QAE1D,MAAMH,UAAU,OAAO/I;QACvB,MAAM8L,UAAU,OAAO/C,QAAQC,GAAG,CAAClF,mBAAmB,aAChD4E,OAAOxE,cAAc,KAAK4C,YAC1B,CAAC,IACD;YAAE5C,gBAAgBwE,OAAOxE,cAAc;QAAC;QAE9C,MAAM6H,SAAS,OAAOxL,qBAAwBoL,UAAUjC,IAAI,CAC1D5H,OAAO6H,cAAc,CAAC1J,uBAAuB6L;QAE/C,OAAOxK,yBAAyBwC,mBAAmBiI;IACrD;IAEA,MAAMC,eAAe,CAACzF;kBAmBCd;YAlBJA;QAAjB,MAAMqC,YAAWrC,oBAAAA,QAAQqC,QAAQ,qBAAhBrC,iBAAkB,CAACc,KAAK;QACzC,MAAM0F,SAAS1F,SAAS,UAAUA,SAAS;QAC3C,MAAM2F,YAAY3F,SAAS,YAAYA,SAAS;QAChD,MAAM4F,UAAUD,oBACXpE,4BAAAA,SAAUqE,OAAO,mBAAI7I,eACtBwE,4BAAAA,SAAUqE,OAAO;QACrB,MAAMxB,aAAa7J,eAAe;YAChCsL,MAAM7F;YACNoB,QAAQtE,MAAM,CAACkD,KAAK;YACpB8F,MAAMJ,SAASpG,SAASD;WACpBqG,SAAS;YAAEK,QAAQ;gBAAEhF,IAAItF,OAAOwF,MAAM;YAAC;QAAE,IAAI,CAAC,GAC9C2E,YAAYrF,YAAY,CAAC,IAAI;YAAEqF;QAAQ;YAC3CI,SAASnL;YACToL,QAAQ;mBACFjG,SAAS,SAASA,SAAS,YAAYA,SAAS,WAChD;oBAAC9E;iBAAS,GACV,EAAE;mBACF8E,SAAS,SAAS;oBAACpF;iBAAa,GAAG,EAAE;mBACrC+K,aAAazG,kBAAAA,QAAQ+G,MAAM,YAAd/G,kBAAkB,EAAE,GAAI,EAAE;4BACvCqC,4BAAAA,SAAU0E,MAAM,oBAAI,EAAE;aAC3B;YACD/I,OAAOI,cAAcC,mBAAmB+D,SAAStB,OAAO1D,MAAM,CAAC0D,KAAK;WAChEuB,CAAAA,4BAAAA,SAAU2E,UAAU,MAAK3F,YACzB,CAAC,IACD;YAAE2F,YAAY3E,SAAS2E,UAAU;QAAC;QAGxC,OAAOvL,UAAUyJ,YAAa,CAAC/F;gBAKlBA;YAJX,IAAIkD,aAAahB,WACf,OAAOhF,OAAOgH,OAAO,CAACL,SAASC,CAAAA,SAC7BZ,SAAS4E,OAAO,CAAC9H,SAAS8D;YAE9B,MAAMpB,MAAK1C,kBAAAA,QAAQ0H,MAAM,qBAAd1H,gBAAgB0C,EAAE;YAC7B,OAAQf;gBACN,KAAK;oBACH,OAAOzD;gBACT,KAAK;oBACH,OAAOC,IAAIuE;gBACb,KAAK;oBACH,OAAOyC,KAAK,UAAUnF,QAAQuH,OAAO;gBACvC,KAAK;oBACH,OAAOpC,KAAK,UAAUnF,QAAQuH,OAAO,EAAE7E;gBACzC,KAAK;oBACH,OAAO6C,OAAO7C;YAClB;QACF;IACF;IAEA,MAAMqF,YAAY9E,SAAS;IAC3B,MAAM+E,YAA2B;QAC/B,sDAAsD;QACtD1L,UACEJ,eAAe;YACbsL,MAAM;YACNzE,QAAQ;YACR0E,MAAM,GAAGzG,KAAK,UAAU,CAAC;YACzB2G,SAASnL;YACToL,QAAQ;gBAAC/K;aAAS;YAClBgC,OAAO;gBAAEE,MAAM;YAAU;QAC3B,IACC,IAAM4G;WAEL9E,QAAQ6F,MAAM,KAAK,OACnB;YACEpK,UACEJ,eAAe;gBACbsL,MAAM;gBACNzE,QAAQ;gBACR0E,MAAM,GAAGzG,KAAK,QAAQ,CAAC;gBACvB2G,SAASnL;gBACToL,QAAQ;oBAACrL;iBAAa;gBACtBsC,OAAOI,cAAcC,mBAAmB6I,WAAW;YACrD,IACC,IAAMrB;SAEV,GACD,EAAE;WACH7F,QAAQM,KAAK,CAACpB,GAAG,CAACqH;WAClBjG,MAAMpB,GAAG,CAAC4B,CAAAA;gBAGTC,kBAgBSA,kBACIA;YAnBf,MAAM,EAAEA,OAAO,EAAE,GAAGD;YACpB,MAAM4F,WACJ3F,mBAAAA,QAAQ2F,OAAO,YAAf3F,mBACCA,QAAQC,OAAO,KAAK,eAAehE,gBAAgBqE;YACtD,MAAM6D,aAAa7J,eAAe;gBAChC,qEAAqE;gBACrE,kEAAkE;gBAClE,mCAAmC;gBACnCsL,MACE5F,QAAQC,OAAO,KAAK,WAChBD,QAAQb,GAAG,GACX,GAAGa,QAAQb,GAAG,CAAC,CAAC,EAAEa,QAAQC,OAAO,EAAE;gBACzCkB,QAAQ;gBACR0E,MAAMxK,SAAS8D,KAAKa,QAAQb,GAAG,EAAEa,QAAQC,OAAO;eAC5CD,QAAQC,OAAO,KAAK,WACpB;gBAAE6F,QAAQ;oBAAEhF,IAAItF,OAAOwF,MAAM;gBAAC;YAAE,IAChC,CAAC,GACD2E,YAAYrF,YAAY,CAAC,IAAI;gBAAEqF;YAAQ;gBAC3CI,OAAO,GAAE/F,mBAAAA,QAAQ+F,OAAO,YAAf/F,mBAAmBpF;gBAC5BoL,QAAQ;wBAAKhG,kBAAAA,QAAQgG,MAAM,YAAdhG,kBAAkB,EAAE;iBAAE;gBACnC/C,OAAOD,iBAAiByE,UAAU1B,OAAO,IACvC1G,qBAAqBiE,mBAAmB0C,QAAQb,GAAG;gBAErDa,SAASA,QAAQb,GAAG;eAChBY,KAAKkG,UAAU,KAAK3F,YACpB,CAAC,IACD;gBAAE2F,YAAYlG,KAAKkG,UAAU;YAAC;YAEpC,OAAOvL,UAAUyJ,YAAa,CAAC/F,UAC7B9C,OAAOgH,OAAO,CAACL,SAASC,CAAAA,SACtBnC,KAAKmG,OAAO,CAAC9H,SAAS8D;QAE5B;WACG3C,MAAM+C,OAAO,CAACvC,CAAAA;gBAUAC;YATf,MAAM,EAAEK,IAAI,EAAE,GAAGN;YACjB,IAAIM,SAASC,WAAW,OAAO,EAAE;YACjC,MAAM,EAAEN,OAAO,EAAE,GAAGD;YACpB,MAAMoE,aAAa7J,eAAe;gBAChCsL,MAAM,GAAG5F,QAAQb,GAAG,CAAC,WAAW,CAAC;gBACjCgC,QAAQ;gBACR0E,MAAMxK,SAAS8D,KAAKa,QAAQb,GAAG,EAAE;gBACjCwG,SAAS1J;gBACT8J,SAASnL;gBACToL,QAAQ;wBAAKhG,kBAAAA,QAAQgG,MAAM,YAAdhG,kBAAkB,EAAE;iBAAE;gBACnC/C,OAAOD,iBAAiByE,UAAU1B,OAAO,IACvC1G,qBAAqBiE,mBAAmB0C,QAAQb,GAAG;gBAErDa,SAASA,QAAQb,GAAG;eAChBY,KAAKkG,UAAU,KAAK3F,YACpB,CAAC,IACD;gBAAE2F,YAAYlG,KAAKkG,UAAU;YAAC;YAEpC,OAAO;gBACLvL,UAAUyJ,YAAa,CAAC/F,UACtB9C,OAAOgH,OAAO,CAACL,SAASC,CAAAA,SAAU7B,KAAKjC,SAAS8D;aACnD;QACH;KACD;IAED,OAAO;QAAE0D,MAAMzG;QAAKiH;IAAU;AAChC,EAAE"}