@entifix/service-shell 0.22.3 → 0.23.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.
|
@@ -32,6 +32,14 @@ type ReturnRequirements<F> = F extends (...args: any[]) => Effect.Effect<any, an
|
|
|
32
32
|
type OverrideRequirements<V> = V extends {
|
|
33
33
|
readonly handler: infer H;
|
|
34
34
|
} ? ReturnRequirements<H> : never;
|
|
35
|
+
/**
|
|
36
|
+
* An entity that declares a `revision` member has its generic `create` and
|
|
37
|
+
* `update` served idempotent at the edge (ADR 0032 §5), so a save that landed
|
|
38
|
+
* but whose response was lost replays instead of answering `409`. Read from the
|
|
39
|
+
* member's presence on the class, which is what the runtime reads from its
|
|
40
|
+
* metadata.
|
|
41
|
+
*/
|
|
42
|
+
type RevisionIdempotency<T> = 'revision' extends keyof T ? 'edge' : never;
|
|
35
43
|
/** What the host's `prepare` and overrides need. */
|
|
36
44
|
export type OptionsRequirements<O> = ReturnRequirements<O extends {
|
|
37
45
|
readonly prepare: infer P;
|
|
@@ -64,6 +72,6 @@ export interface EntityApiServing {
|
|
|
64
72
|
* shell alone knows — the recipes and variants `$metadata` resolves verbs
|
|
65
73
|
* against — is added here.
|
|
66
74
|
*/
|
|
67
|
-
export declare const entityApi: <T extends Entity, const K extends string, const O extends EntityApiOptions<T, any>>(declaration: EntityApiDeclaration<T, K, O>, serving?: EntityApiServing) => EndpointGroup<EntityEndpoint<EntityGuardKinds<O>, EntityIdempotencies<O>>, OptionsRequirements<O> | EntityRepositoryFactoryTag | PolicyDecisionTag | (O["facets"] extends true ? EntityFacetCounterFactoryTag : never)>;
|
|
75
|
+
export declare const entityApi: <T extends Entity, const K extends string, const O extends EntityApiOptions<T, any>>(declaration: EntityApiDeclaration<T, K, O>, serving?: EntityApiServing) => EndpointGroup<EntityEndpoint<EntityGuardKinds<O>, EntityIdempotencies<O> | RevisionIdempotency<T>>, OptionsRequirements<O> | EntityRepositoryFactoryTag | PolicyDecisionTag | (O["facets"] extends true ? EntityFacetCounterFactoryTag : never)>;
|
|
68
76
|
export {};
|
|
69
77
|
//# sourceMappingURL=entity-api.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"entity-api.d.ts","sourceRoot":"","sources":["../../src/http-api/entity-api.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAGL,KAAK,oBAAoB,EAGzB,KAAK,gBAAgB,EAGrB,4BAA4B,EAI5B,0BAA0B,EAa3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,WAAW,
|
|
1
|
+
{"version":3,"file":"entity-api.d.ts","sourceRoot":"","sources":["../../src/http-api/entity-api.ts"],"names":[],"mappings":"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"}
|
|
@@ -2,7 +2,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
|
|
|
2
2
|
import { createHash } from 'node:crypto';
|
|
3
3
|
import { parsePermission, permissionForEntity, permissionForUseCase, PolicyDecisionTag } from '@entifix/authz';
|
|
4
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';
|
|
5
|
+
import { declaresRevision, defineEndpoint, describeEntityUseCases, ENTITY_ACTIONS, Envelope, implement, Internal, Invalid, InvalidQuery, JsonBody, makeEntityEnvelope, makeEntityFacetsEnvelope, makeEntityMetadataEnvelope, makeEntityPageEnvelope, NotFound, parseFacetQueryParams, parseLoadRequestParams, readEntityEnvelope, readRevision, StaleRevision, verbPath } from '@entifix/core';
|
|
6
6
|
import { Effect, Option, Schema } from 'effect';
|
|
7
7
|
import { HttpServerRequest, HttpServerResponse } from 'effect/http';
|
|
8
8
|
import { resolveRequestPrincipal } from '../auth/require-principal.js';
|
|
@@ -274,15 +274,40 @@ const cacheHeaders = (etag)=>({
|
|
|
274
274
|
const found = yield* getUCFactory().pipe(Effect.provideService(EntityRepositoryTag, (yield* repository(caller))), Effect.provideService(EntityIdTag, id));
|
|
275
275
|
return makeEntityEnvelope(entityConstructor, found, caller.links.record(id));
|
|
276
276
|
});
|
|
277
|
+
const revised = declaresRevision(entityConstructor);
|
|
277
278
|
const save = (verb, body, id)=>Effect.gen(function*() {
|
|
278
279
|
const caller = yield* context;
|
|
279
280
|
let entity = yield* readEntityEnvelope(entityConstructor, body);
|
|
280
281
|
// On update the path is authoritative, so a record cannot be renamed
|
|
281
282
|
// onto another one by editing its payload.
|
|
282
283
|
if (id !== undefined) entity.id = id;
|
|
283
|
-
if (
|
|
284
|
-
verb
|
|
285
|
-
|
|
284
|
+
if (revised) {
|
|
285
|
+
if (verb === 'create') {
|
|
286
|
+
// The server owns the first revision, whatever the body said.
|
|
287
|
+
entity.revision = undefined;
|
|
288
|
+
} else if (readRevision(entity) === undefined) {
|
|
289
|
+
// Never a create and never an overwrite: an update names what it read.
|
|
290
|
+
return yield* Effect.fail(new Invalid({
|
|
291
|
+
errors: [
|
|
292
|
+
{
|
|
293
|
+
pointer: '/data/revision',
|
|
294
|
+
detail: 'An update names the revision it read.',
|
|
295
|
+
code: 'required'
|
|
296
|
+
}
|
|
297
|
+
]
|
|
298
|
+
}));
|
|
299
|
+
}
|
|
300
|
+
}
|
|
301
|
+
const read = revised ? readRevision(entity) : undefined;
|
|
302
|
+
if (options.prepare !== undefined) {
|
|
303
|
+
entity = yield* options.prepare(entity, _extends({}, caller, {
|
|
304
|
+
verb
|
|
305
|
+
}));
|
|
306
|
+
// A `prepare` that moves the revision is a defect, not a request.
|
|
307
|
+
if (revised && readRevision(entity) !== read) {
|
|
308
|
+
return yield* Effect.fail(new Internal());
|
|
309
|
+
}
|
|
310
|
+
}
|
|
286
311
|
const saved = yield* saveUCFactory().pipe(Effect.provideService(EntityRepositoryTag, (yield* repository(caller))), Effect.provideService(EntityTag, entity));
|
|
287
312
|
return makeEntityEnvelope(entityConstructor, saved, caller.links.record(saved.id));
|
|
288
313
|
});
|
|
@@ -408,12 +433,17 @@ const cacheHeaders = (etag)=>({
|
|
|
408
433
|
InvalidQuery
|
|
409
434
|
] : [],
|
|
410
435
|
...takesBody ? (_options_errors = options.errors) != null ? _options_errors : [] : [],
|
|
436
|
+
...revised && takesBody ? [
|
|
437
|
+
StaleRevision
|
|
438
|
+
] : [],
|
|
411
439
|
...(_ref1 = override == null ? void 0 : override.errors) != null ? _ref1 : []
|
|
412
440
|
],
|
|
413
441
|
guard: endpointGuard(entityConstructor, guardFor(verb), ACTION[verb])
|
|
414
|
-
}, (override == null ? void 0 : override.idempotent)
|
|
442
|
+
}, (override == null ? void 0 : override.idempotent) !== undefined ? {
|
|
415
443
|
idempotent: override.idempotent
|
|
416
|
-
}
|
|
444
|
+
} : revised && takesBody ? {
|
|
445
|
+
idempotent: 'edge'
|
|
446
|
+
} : {}));
|
|
417
447
|
return implement(descriptor, (request)=>{
|
|
418
448
|
var _request_params;
|
|
419
449
|
if (override !== undefined) return Effect.flatMap(context, (caller)=>override.handler(request, caller));
|
|
@@ -1 +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 ...(verb.accepted === true ? { accepted: true } : {}),\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 ...(verb.accepted === true ? { accepted: true } : {}),\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","accepted"],"mappings":"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"}
|
|
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 declaresRevision,\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 Internal,\n Invalid,\n InvalidQuery,\n JsonBody,\n makeEntityEnvelope,\n makeEntityFacetsEnvelope,\n makeEntityMetadataEnvelope,\n makeEntityPageEnvelope,\n NotFound,\n parseFacetQueryParams,\n parseLoadRequestParams,\n readEntityEnvelope,\n readRevision,\n StaleRevision,\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/**\n * An entity that declares a `revision` member has its generic `create` and\n * `update` served idempotent at the edge (ADR 0032 §5), so a save that landed\n * but whose response was lost replays instead of answering `409`. Read from the\n * member's presence on the class, which is what the runtime reads from its\n * metadata.\n */\ntype RevisionIdempotency<T> = 'revision' extends keyof T ? 'edge' : 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<\n EntityGuardKinds<O>,\n EntityIdempotencies<O> | RevisionIdempotency<T>\n >,\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 revised = declaresRevision(entityConstructor);\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 (revised) {\n if (verb === 'create') {\n // The server owns the first revision, whatever the body said.\n (entity as { revision?: number }).revision = undefined;\n } else if (readRevision(entity) === undefined) {\n // Never a create and never an overwrite: an update names what it read.\n return yield* Effect.fail(\n new Invalid({\n errors: [\n {\n pointer: '/data/revision',\n detail: 'An update names the revision it read.',\n code: 'required',\n },\n ],\n }),\n );\n }\n }\n const read = revised ? readRevision(entity) : undefined;\n if (options.prepare !== undefined) {\n entity = yield* options.prepare(entity, { ...caller, verb });\n // A `prepare` that moves the revision is a defect, not a request.\n if (revised && readRevision(entity) !== read) {\n return yield* Effect.fail(new Internal());\n }\n }\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 ...(revised && takesBody ? [StaleRevision] : []),\n ...(override?.errors ?? []),\n ],\n guard: endpointGuard(entityConstructor, guardFor(verb), ACTION[verb]),\n ...(override?.idempotent !== undefined\n ? { idempotent: override.idempotent }\n : revised && takesBody\n ? { idempotent: 'edge' }\n : {}),\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 ...(verb.accepted === true ? { accepted: true } : {}),\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 ...(verb.accepted === true ? { accepted: true } : {}),\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","declaresRevision","defineEndpoint","describeEntityUseCases","ENTITY_ACTIONS","Envelope","implement","Internal","Invalid","InvalidQuery","JsonBody","makeEntityEnvelope","makeEntityFacetsEnvelope","makeEntityMetadataEnvelope","makeEntityPageEnvelope","NotFound","parseFacetQueryParams","parseLoadRequestParams","readEntityEnvelope","readRevision","StaleRevision","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","revised","save","body","revision","errors","pointer","detail","code","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","idempotent","handler","readGuard","endpoints","accepted"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@entifix/service-shell",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.23.0",
|
|
4
4
|
"description": "Effect HTTP service skeleton: server layer, health and metadata routes, permission guards, remote configuration and OpenTelemetry.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -76,23 +76,23 @@
|
|
|
76
76
|
},
|
|
77
77
|
"dependencies": {
|
|
78
78
|
"@swc/helpers": "0.5.23",
|
|
79
|
-
"@entifix/authz": "0.
|
|
80
|
-
"@entifix/business": "0.
|
|
81
|
-
"@entifix/core": "0.
|
|
82
|
-
"@entifix/tooling": "0.
|
|
79
|
+
"@entifix/authz": "0.23.0",
|
|
80
|
+
"@entifix/business": "0.23.0",
|
|
81
|
+
"@entifix/core": "0.23.0",
|
|
82
|
+
"@entifix/tooling": "0.23.0"
|
|
83
83
|
},
|
|
84
84
|
"devDependencies": {
|
|
85
85
|
"@effect/opentelemetry": "4.0.7",
|
|
86
86
|
"@effect/platform-node": "4.0.7",
|
|
87
87
|
"@opentelemetry/api": "1.9.1",
|
|
88
88
|
"@opentelemetry/context-async-hooks": "2.12.1",
|
|
89
|
-
"@opentelemetry/exporter-metrics-otlp-http": "0.223.
|
|
90
|
-
"@opentelemetry/exporter-trace-otlp-http": "0.223.
|
|
89
|
+
"@opentelemetry/exporter-metrics-otlp-http": "0.223.2",
|
|
90
|
+
"@opentelemetry/exporter-trace-otlp-http": "0.223.2",
|
|
91
91
|
"@opentelemetry/sdk-metrics": "2.12.1",
|
|
92
92
|
"@opentelemetry/sdk-trace-base": "2.12.0",
|
|
93
93
|
"effect": "4.0.7",
|
|
94
|
-
"@entifix/rest": "0.
|
|
95
|
-
"@entifix/testing-unit": "0.
|
|
94
|
+
"@entifix/rest": "0.23.0",
|
|
95
|
+
"@entifix/testing-unit": "0.23.0"
|
|
96
96
|
},
|
|
97
97
|
"peerDependencies": {
|
|
98
98
|
"@effect/opentelemetry": "^4.0.7",
|