@afora/core 0.0.8 → 0.0.9

package/dist/index-y280ew0k.js

@@ -0,0 +1,396 @@
+import {
+  statusOf2,
+  PROBLEM_MEDIA_TYPE2,
+  problemOf2,
+  outputValueOf2,
+  ROUTE_OPTION_KEYS2,
+  routeOptionsIssue2,
+  requestIdHeaderOf2,
+  operationRoutes2,
+  openapi2
+} from "./index-hg1z2s2v.js";
+import {
+  Exception2,
+  toOpenAPI2,
+  HEADER_NAME,
+  InvalidOutputStage2,
+  jwtOptionsIssue,
+  jwtOf2
+} from "./index-xegv6a1p.js";
+// src/core/output/coerce.ts
+var scalarTypes = new WeakMap;
+function scalarTypesOf(blueprint) {
+  let types = scalarTypes.get(blueprint);
+  if (!types) {
+    const schema = toOpenAPI2(blueprint);
+    const found = {};
+    for (const [key, property] of Object.entries(schema.properties ?? {})) {
+      found[key] = [property.type ?? []].flat();
+    }
+    types = Object.freeze(found);
+    scalarTypes.set(blueprint, types);
+  }
+  return types;
+}
+function coerce(text, types) {
+  if (!types || types.includes("string"))
+    return text;
+  const trimmed = text.trim();
+  if (types.includes("boolean") && (trimmed === "true" || trimmed === "false")) {
+    return trimmed === "true";
+  }
+  if (types.includes("integer") || types.includes("number")) {
+    const number = trimmed === "" ? Number.NaN : Number(trimmed);
+    if (Number.isFinite(number))
+      return number;
+  }
+  return text;
+}
+function coerceTextValues2(blueprint, texts) {
+  const types = scalarTypesOf(blueprint);
+  const out = {};
+  for (const [key, value] of Object.entries(texts)) {
+    if (value !== undefined)
+      out[key] = coerce(value, types[key]);
+  }
+  return out;
+}
+// src/core/output/http.ts
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function onlyKeys(value, allowed, where) {
+  for (const key of Object.keys(value)) {
+    if (!allowed.includes(key))
+      return `${where} has no option "${key}".`;
+  }
+  return;
+}
+var HTTP_OPTION_KEYS2 = [
+  ...ROUTE_OPTION_KEYS2,
+  "docs",
+  "debug",
+  "context",
+  "auth"
+];
+function httpOptionsIssue2(options, where) {
+  const given = options;
+  const routing = routeOptionsIssue2(options, where);
+  if (routing)
+    return routing;
+  if (given.debug !== undefined && typeof given.debug !== "boolean") {
+    return `Expected ${where}.debug to be a boolean.`;
+  }
+  const { docs, context, auth } = given;
+  if (auth !== undefined) {
+    if (!isObject(auth) || Object.keys(auth).join() !== "jwt") {
+      return `Expected ${where}.auth to be { jwt: { secret, ... } }.`;
+    }
+    const bad = jwtOptionsIssue(auth.jwt, `${where}.auth.jwt`, ["header", "cookie"], true);
+    if (bad)
+      return bad;
+    const { header, cookie } = auth.jwt;
+    for (const [key, value] of [
+      ["header", header],
+      ["cookie", cookie]
+    ]) {
+      if (value !== undefined && (typeof value !== "string" || !HEADER_NAME.test(value))) {
+        return `Expected ${where}.auth.jwt.${key} to be the name of a ${key}.`;
+      }
+    }
+  }
+  if (docs !== undefined) {
+    if (!isObject(docs))
+      return `Expected ${where}.docs to be an object.`;
+    const docsBad = onlyKeys(docs, ["path", "info", "servers"], `${where}.docs`);
+    if (docsBad)
+      return docsBad;
+    if (typeof docs.path !== "string" || !docs.path.startsWith("/") || /[{}?#\s:*]/.test(docs.path)) {
+      return `Expected ${where}.docs.path to be a path such as "/openapi.json".`;
+    }
+    try {
+      openapi2({
+        info: docs.info,
+        ...docs.servers ? { servers: docs.servers } : {}
+      });
+    } catch (error) {
+      const reason = error.details?.reason;
+      return (reason ?? `Expected ${where}.docs to be valid.`).replaceAll("openapi.", `${where}.docs.`);
+    }
+  }
+  if (context !== undefined) {
+    if (!isObject(context))
+      return `Expected ${where}.context to be an object.`;
+    const contextBad = onlyKeys(context, ["headers", "variables"], `${where}.context`);
+    if (contextBad)
+      return contextBad;
+    const { headers, variables } = context;
+    if (headers !== undefined) {
+      if (!isObject(headers)) {
+        return `Expected ${where}.context.headers to be an object.`;
+      }
+      for (const [key, name] of Object.entries(headers)) {
+        if (typeof name !== "string" || !HEADER_NAME.test(name)) {
+          return `Expected ${where}.context.headers["${key}"] to be a header name.`;
+        }
+      }
+    }
+    if (variables !== undefined) {
+      if (!isObject(variables)) {
+        return `Expected ${where}.context.variables to be an object.`;
+      }
+      for (const [key, name] of Object.entries(variables)) {
+        if (typeof name !== "string" || name === "") {
+          return `Expected ${where}.context.variables["${key}"] to be the name of a variable.`;
+        }
+        if (isObject(headers) && Object.hasOwn(headers, key)) {
+          return `${where}.context maps "${key}" both from a header and from a variable; keep one.`;
+        }
+      }
+    }
+  }
+  return;
+}
+var REQUEST_ID = /^[\x21-\x7e]{1,200}$/;
+var JSON_TYPE = "application/json";
+var NO_COOKIES = Object.freeze([]);
+function cookiesOf(header) {
+  const cookies = new Map;
+  if (!header)
+    return cookies;
+  for (const pair of header.split(";")) {
+    const at = pair.indexOf("=");
+    if (at < 0)
+      continue;
+    const name = pair.slice(0, at).trim();
+    if (name === "" || cookies.has(name))
+      continue;
+    let value = pair.slice(at + 1).trim();
+    if (value.length > 1 && value.startsWith('"') && value.endsWith('"')) {
+      value = value.slice(1, -1);
+    }
+    if (value.includes("%")) {
+      try {
+        value = decodeURIComponent(value);
+      } catch {}
+    }
+    cookies.set(name, value);
+  }
+  return cookies;
+}
+function cookieWriterOf(cookie) {
+  const sameSite = cookie.sameSite ?? "lax";
+  const attributes = [
+    `Path=${cookie.path ?? "/"}`,
+    ...cookie.domain === undefined ? [] : [`Domain=${cookie.domain}`],
+    ...cookie.httpOnly === false ? [] : ["HttpOnly"],
+    ...cookie.secure === false ? [] : ["Secure"],
+    `SameSite=${sameSite.charAt(0).toUpperCase()}${sameSite.slice(1)}`
+  ].join("; ");
+  const lasting = cookie.maxAge === undefined ? "" : `; Max-Age=${cookie.maxAge}`;
+  return (value) => value === "" ? `${cookie.name}=; ${attributes}; Max-Age=0` : `${cookie.name}=${encodeURIComponent(value)}; ${attributes}${lasting}`;
+}
+function compileRoutes2(operations, options, context, settings) {
+  const { source } = settings;
+  const { output } = context;
+  let authenticator = settings.authenticator;
+  if (!authenticator && options.auth) {
+    const { header, cookie, ...jwt } = options.auth.jwt;
+    authenticator = jwtOf2(jwt).authenticator({
+      ...header === undefined ? {} : { header },
+      ...cookie === undefined ? {} : { cookie }
+    });
+  }
+  const routes = operationRoutes2(operations, options, source);
+  const debug = options.debug === true;
+  const contextHeaders = options.context?.headers ?? {};
+  const contextVariables = options.context?.variables ?? {};
+  const requestIdHeader = requestIdHeaderOf2(options);
+  const idOf = (request) => {
+    const sent = request?.header(requestIdHeader);
+    return sent !== undefined && REQUEST_ID.test(sent) ? sent : crypto.randomUUID();
+  };
+  const headersOf = (headers, request) => requestIdHeader === undefined ? headers : { ...headers, [requestIdHeader]: idOf(request) };
+  const problemHeaders = Object.freeze({ "content-type": PROBLEM_MEDIA_TYPE2 });
+  const problem = (body, status, request) => ({
+    status,
+    headers: headersOf(problemHeaders, request),
+    cookies: NO_COOKIES,
+    body: JSON.stringify(body)
+  });
+  const fail = (error, operation, request, fallback) => {
+    const status = fallback !== undefined && !(error instanceof Exception2 && Object.hasOwn(output.statuses, error.name)) ? fallback : statusOf2(error, operation, output.statuses);
+    return problem(problemOf2(error, { status, debug }), status, request);
+  };
+  const failure = (error, given) => fail(error, given?.operation, given?.request, given?.status);
+  const compiled = operations.map((operation) => {
+    const route = routes.get(operation.id);
+    const { method, path, parameters, status, body } = route;
+    const queryKeys = body ? route.query : [];
+    const headerKeys = Object.entries(route.requestHeaders);
+    const cookieKeys = Object.entries(route.cookies);
+    const placed = parameters.length + queryKeys.length + headerKeys.length + cookieKeys.length > 0;
+    const declared = operation.context ? Object.keys(operation.context.properties) : [];
+    const contextHeaderKeys = declared.filter((key) => Object.hasOwn(contextHeaders, key)).map((key) => [key, contextHeaders[key].toLowerCase()]);
+    const contextVariableKeys = declared.filter((key) => Object.hasOwn(contextVariables, key)).map((key) => [key, contextVariables[key]]);
+    const guarded = operation.access !== undefined && operation.access.public !== true;
+    const setCookies = Object.entries(route.setCookies).map(([key, cookie]) => [key, cookieWriterOf(cookie)]);
+    const successHeaders = Object.freeze(status === 204 ? { ...route.headers } : { "content-type": JSON_TYPE, ...route.headers });
+    const readsCookies = cookieKeys.length > 0;
+    const authenticates = guarded && authenticator !== undefined;
+    const hasContext = operation.context !== undefined;
+    const handle = async (request) => {
+      try {
+        let cookies;
+        let principal;
+        if (authenticates) {
+          principal = await authenticator({
+            header: (name) => request.header(name),
+            cookie: (name) => {
+              cookies ??= cookiesOf(request.header("cookie"));
+              return cookies.get(name);
+            },
+            operation,
+            native: request.native
+          });
+        }
+        let input;
+        if (body) {
+          const text = await request.text();
+          try {
+            input = text.trim() === "" ? {} : JSON.parse(text);
+          } catch {
+            return problem({
+              type: "urn:afora:exception:InvalidRequestBody",
+              title: "InvalidRequestBody",
+              status: 400,
+              detail: "The request body is not valid JSON."
+            }, 400, request);
+          }
+        } else {
+          input = coerceTextValues2(operation.input, request.query());
+        }
+        if (placed && isObject(input)) {
+          const texts = {};
+          if (queryKeys.length > 0) {
+            const query = request.query();
+            for (const key of queryKeys)
+              texts[key] = query[key];
+          }
+          for (const [key, name] of headerKeys) {
+            texts[key] = request.header(name);
+          }
+          if (readsCookies) {
+            cookies ??= cookiesOf(request.header("cookie"));
+            for (const [key, name] of cookieKeys)
+              texts[key] = cookies.get(name);
+          }
+          for (const name of parameters)
+            texts[name] = request.param(name);
+          input = { ...input, ...coerceTextValues2(operation.input, texts) };
+        }
+        let call;
+        if (hasContext) {
+          const raw = {};
+          for (const [key, name] of contextHeaderKeys) {
+            raw[key] = request.header(name);
+          }
+          const values = coerceTextValues2(operation.context, raw);
+          for (const [key, name] of contextVariableKeys) {
+            const value = request.variable?.(name);
+            if (value !== undefined)
+              values[key] = value;
+          }
+          call = guarded ? { context: values, principal: principal ?? null } : { context: values };
+        } else if (guarded)
+          call = { principal: principal ?? null };
+        const response = await operation.invoke(input, call);
+        if (setCookies.length === 0) {
+          return {
+            status,
+            headers: headersOf(successHeaders, request),
+            cookies: NO_COOKIES,
+            body: status === 204 ? null : JSON.stringify(response) ?? "null"
+          };
+        }
+        const value = outputValueOf2(response);
+        const sent = [];
+        if (isObject(value)) {
+          for (const [key, write] of setCookies) {
+            const cookie = value[key];
+            delete value[key];
+            if (cookie !== undefined && cookie !== null) {
+              sent.push(write(String(cookie)));
+            }
+          }
+        }
+        return {
+          status,
+          headers: headersOf(successHeaders, request),
+          cookies: sent,
+          body: status === 204 ? null : JSON.stringify(value) ?? "null"
+        };
+      } catch (error) {
+        return fail(error, operation, request);
+      }
+    };
+    return Object.freeze({ operation, method, path, parameters, handle });
+  });
+  let docs;
+  if (options.docs) {
+    const { path, info, servers } = options.docs;
+    if (compiled.some((route) => route.method === "get" && route.path === path)) {
+      throw new InvalidOutputStage2({
+        source,
+        details: {
+          reason: `${source}.docs.path "${path}" collides with a GET operation route.`
+        }
+      });
+    }
+    const routing = {};
+    for (const key of ROUTE_OPTION_KEYS2) {
+      if (options[key] !== undefined)
+        routing[key] = options[key];
+    }
+    if (options.auth && routing.security === undefined) {
+      const { header, cookie } = options.auth.jwt;
+      routing.security = {
+        schemes: cookie !== undefined && header === undefined ? { session: { type: "apiKey", in: "cookie", name: cookie } } : header !== undefined && header.toLowerCase() !== "authorization" ? { token: { type: "apiKey", in: "header", name: header } } : {
+          bearer: {
+            type: "http",
+            scheme: "bearer",
+            bearerFormat: "JWT"
+          }
+        }
+      };
+    }
+    const document = openapi2({
+      info,
+      ...servers ? { servers } : {},
+      ...routing
+    }).build(operations, context);
+    const text = JSON.stringify(settings.document ? settings.document(document) : document);
+    const headers = Object.freeze({ "content-type": JSON_TYPE });
+    docs = Object.freeze({
+      path,
+      handle: (request) => ({
+        status: 200,
+        headers: headersOf(headers, request),
+        cookies: NO_COOKIES,
+        body: text
+      })
+    });
+  }
+  return Object.freeze({
+    routes: Object.freeze(compiled),
+    ...docs ? { docs } : {},
+    notFound: (request) => problem({
+      type: "urn:afora:exception:NotFound",
+      title: "NotFound",
+      status: 404,
+      detail: "No operation is served at this method and path."
+    }, 404, request),
+    failure
+  });
+}
+export { coerceTextValues2, HTTP_OPTION_KEYS2, httpOptionsIssue2, compileRoutes2 };

package/dist/index.d.ts

@@ -1,37 +1,42 @@
-export { applicationOf, isApplication } from "./core/application/application.js";
-export { ApplicationAlreadyStarted, ApplicationConflict, ApplicationNotStarted, DuplicateApplicationDeclaration, InvalidApplicationDeclaration, InvalidApplicationEnvironment, ProviderNotBound, UnregisteredApplicationReference, UnregisteredRepositoryDependency, UnregisteredUseCaseDependency, } from "./core/application/exceptions.js";
-export { isProviderSlot, isProviderStorage, type ProviderSlot, type ProviderStorage, providersOf, } from "./core/application/providers.js";
+/**
+ * `@afora/core`: the stable API, what application code imports. Plumbing for
+ * sinks, providers and code generators is in `@afora/core/adapters`, features
+ * that may still change in `@afora/core/experimental`. A new export goes in
+ * the tier `docs/api-tiers.md` describes, and in that table.
+ */
+export { applicationOf } from "./core/application/application.js";
+export { ApplicationAlreadyStarted, ApplicationConflict, ApplicationNotStarted, DuplicateApplicationDeclaration, InvalidApplicationDeclaration, InvalidApplicationEnvironment, InvalidSchemaMigration, ProviderNotBound, SchemaLockMismatch, UnregisteredApplicationReference, UnregisteredRepositoryDependency, UnregisteredUseCaseDependency, } from "./core/application/exceptions.js";
+export { type ProviderSlot, type ProviderStorage, providersOf, } from "./core/application/providers.js";
 export { type Register, type RegisteredApplication, resetApplication, useApplication, } from "./core/application/registry.js";
-export { isLogFactory, isProviderFactory, type LogFactory, logFrom, type ProviderFactory, providerFrom, } from "./core/application/start.js";
-export type { AnyApplication, ApplicationCollections, ApplicationContext, ApplicationDescription, ApplicationRunArgs, ApplicationRunOptions, ApplicationSettings, ApplicationStartOptions, CommandDescription, ExceptionDescription, FieldDescription, FieldsDescription, IApplication, LogDescription, OutputDescription, PropertyDescription, PropertyLineageDescription, PropertyReference, ProviderReference, RecordDescription, UseCaseDependencyDescription, UseCaseDescription, } from "./core/application/types/application.interface.js";
+export { isProviderFactory, type LogFactory, logFrom, type ProviderFactory, providerFrom, } from "./core/application/start.js";
+export type { AnyApplication, ApplicationCollections, ApplicationContext, ApplicationRunArgs, ApplicationRunOptions, ApplicationSettings, ApplicationStartOptions, IApplication, } from "./core/application/types/application.interface.js";
 export { blueprintBuilderOf } from "./core/blueprint/blueprint.js";
 export { blueprintPluginOf } from "./core/blueprint/blueprint-plugin.js";
-export { ReservedBlueprintKey, UndeclaredBlueprintProperty, } from "./core/blueprint/exceptions.js";
-export { isBlueprint } from "./core/blueprint/is-blueprint.js";
-export { isBlueprintList, listOf } from "./core/blueprint/list.js";
+export { InvalidBlueprintVariant, ReservedBlueprintKey, UndeclaredBlueprintProperty, } from "./core/blueprint/exceptions.js";
+export { listOf } from "./core/blueprint/list.js";
 export { optionalOf } from "./core/blueprint/optional.js";
-export { isOptionalRecord, isRecordClass, recordFieldOf, } from "./core/blueprint/record-field.js";
-export type { AnyBlueprint, AnyBlueprintList, AnyOptionalRecord, AnyRecordClass, BlueprintBuilder, BlueprintContext, BlueprintData, BlueprintDefinition, BlueprintField, BlueprintHelpers, BlueprintInput, BlueprintListOptions, BlueprintPluginContext, BlueprintSchema, BlueprintSource, BlueprintValue, IBlueprint, IBlueprintCollection, IBlueprintList, OptionalBlueprint, OptionalBlueprintList, OptionalRecord, } from "./core/blueprint/types/blueprint.interface.js";
+export type { AnyBlueprint, AnyBlueprintList, AnyBlueprintVariant, AnyOptionalRecord, AnyRecordClass, BlueprintBuilder, BlueprintContext, BlueprintData, BlueprintDefinition, BlueprintField, BlueprintHelpers, BlueprintInput, BlueprintListOptions, BlueprintPluginContext, BlueprintSchema, BlueprintSource, BlueprintValue, BlueprintVariants, IBlueprint, IBlueprintCollection, IBlueprintList, IBlueprintVariant, OptionalBlueprint, OptionalBlueprintList, OptionalBlueprintVariant, OptionalRecord, } from "./core/blueprint/types/blueprint.interface.js";
 export type { BlueprintFactory, IBlueprintFactories, IBlueprintPlugin, } from "./core/blueprint/types/blueprint-plugin.interface.js";
+export { variantOf } from "./core/blueprint/variant.js";
 export { commandBuilderOf, isCommand } from "./core/command/command.js";
 export { CommandEventFailed, InvalidCommandContext, InvalidCommandDeclaration, InvalidCommandEnvironment, UnknownCommandOperation, } from "./core/command/exceptions.js";
 export type { AnyCommand, CommandBuilder, CommandBuilderSettings, CommandEnvOption, CommandEventErrorHandler, CommandEventHandler, CommandEventInfo, CommandEvents, CommandExecution, CommandInput, CommandOf, CommandOperation, CommandOptions, CommandResponse, CommandSettings, CommandUseCases, CommandUseCasesOption, } from "./core/command/types/command.interface.js";
-export { AbstractEntity, ENTITY_IDENTITY_KEYS, EntitySettings, EntityUniqueKeys, RESERVED_ENTITY_KEYS, } from "./core/entity/abstract-entity.js";
+export { EntitySettings, EntityUniqueKeys, } from "./core/entity/abstract-entity.js";
 export { entityBuilderOf, isEntity, isEntityClass } from "./core/entity/entity.js";
 export type { AnyEntityClass, EntityEvent, EntityEventReference, EntityEvents, EventDefinition, EventHandlerContext, } from "./core/entity/event.js";
 export { eventOf } from "./core/entity/event.js";
-export { DeletedEntity, ImmutableEntityKey, InvalidEntityExpiry, ReservedEntityKey, } from "./core/entity/exceptions.js";
-export type { DeclaredEntityInstance, EntityBuilder, EntityBuilderSettings, EntityConstructor, EntityDuration, EntityExpires, EntityIdentityKey, EntityInput, EntityOptions, EntityProperties, EntityStorageOptions, EntityStorageSettings, EntityUniqueKey, ExpiresAtField, ExpiringIdentity, IEntityIdentity, IEntityVersion, VersionedIdentity, } from "./core/entity/types/entity.interface.js";
+export { DeletedEntity, ImmutableEntityKey, InvalidEntityExpiry, InvalidEntitySchemaVersion, ReservedEntityKey, } from "./core/entity/exceptions.js";
+export type { DeclaredEntityInstance, EntityBuilder, EntityBuilderSettings, EntityConstructor, EntityDuration, EntityExpires, EntityIdentityKey, EntityInput, EntityOptions, EntityProperties, EntityStorageOptions, EntityStorageSettings, EntityUniqueKey, EntityUpgrade, EntityUpgrades, ExpiresAtField, ExpiringIdentity, IEntityIdentity, IEntityVersion, VersionedIdentity, } from "./core/entity/types/entity.interface.js";
 export { EntityVersion } from "./core/entity/version.js";
 export type { AnyEnvironment, EnvironmentDependencies, EnvironmentOptions, EnvironmentSource, EnvironmentValue, IEnvironment, } from "./core/environment/environment.js";
-export { environmentOf, InvalidEnvironment, isEnvironment, } from "./core/environment/environment.js";
-export { eventPolicyCatalogOf, eventPolicyDescriptionOf, eventPolicyOf, } from "./core/event-policy/event-policy.js";
+export { environmentOf, InvalidEnvironment, } from "./core/environment/environment.js";
+export { eventPolicyOf } from "./core/event-policy/event-policy.js";
 export { InvalidEventPolicy, PublisherNotBound, } from "./core/event-policy/exceptions.js";
 export { publishEvents } from "./core/event-policy/publish.js";
-export type { EventPolicyDescription, EventPolicyFactory, EventPolicyOptions, EventPolicySettings, IEventPolicyCatalog, IEventPublisher, PublishEventsOptions, PublishedEvent, } from "./core/event-policy/types/event-policy.interface.js";
+export type { EventPolicyFactory, EventPolicyOptions, EventPolicySettings, IEventPolicyCatalog, IEventPublisher, PublishEventsOptions, PublishedEvent, } from "./core/event-policy/types/event-policy.interface.js";
 export { ExceptionLayers } from "./core/exception/enums/exception-layers.js";
 export type { DeclaredExceptionClass } from "./core/exception/exception.js";
-export { Exception, exceptionOf, UNEXPECTED_ERROR, } from "./core/exception/exception.js";
+export { Exception, exceptionOf } from "./core/exception/exception.js";
 export { guard } from "./core/exception/guard.js";
 export type { ExceptionArgs, ExceptionClass, ExceptionDeclaration, ExceptionFrame, ExceptionInit, ExceptionMessage, ExceptionPropagation, ExceptionScope, } from "./core/exception/types/exception.interface.js";
 export { InvalidLogDeclaration } from "./core/logger/exceptions.js";
@@ -40,28 +45,19 @@ export { consoleLogProvider, jsonLogProvider, Logger, LogLevels, logProviderOf,
 export { InvalidOpenAPIModel } from "./core/openapi/exceptions.js";
 export { toOpenAPI } from "./core/openapi/openapi.js";
 export type { OpenAPIComponents, OpenAPIOptions, OpenAPISchema, } from "./core/openapi/types/openapi.interface.js";
-export { coerceTextValues } from "./core/output/coerce.js";
-export { DuplicateOperation, InvalidOutputStage, } from "./core/output/exceptions.js";
-export type { OpenAPIDocument, OpenAPIMethod, OpenAPISecurityScheme, OpenAPISinkOptions, OperationRoute, RouteOptions, RouteStatus, SecurityRequirement, } from "./core/output/openapi-sink.js";
-export { openapi, operationRoutes, ROUTE_OPTION_KEYS, requestIdHeaderOf, routeOptionsIssue, } from "./core/output/openapi-sink.js";
+export { DuplicateOperation, Forbidden, InvalidOutputStage, Unauthenticated, } from "./core/output/exceptions.js";
+export type { OpenAPIDocument, OpenAPIMethod, OpenAPISecurityScheme, OpenAPISinkOptions, RouteOptions, RouteStatus, SecurityRequirement, } from "./core/output/openapi-sink.js";
+export { openapi } from "./core/output/openapi-sink.js";
 export { isOutput, operationOf, outputOf } from "./core/output/output.js";
-export { outputValueOf, PROBLEM_MEDIA_TYPE, problemOf, } from "./core/output/problem.js";
 export type { SelectOptions } from "./core/output/select.js";
 export { select } from "./core/output/select.js";
-export { sinkOf, stageCatalogOf, stageDescriptionOf, stageKindOf, transformOf, } from "./core/output/stage.js";
-export { statusOf } from "./core/output/status.js";
-export type { AnyOutput, IStageCatalog, OperationCallOptions, OperationDescriptor, OperationPatch, OutputApplication, OutputOf, OutputSettings, OutputSource, OutputStatuses, PipeResult, Problem, ProblemOptions, SinkFactory, SinkSettings, SinkStage, Stage, StageContext, StageDescription, StageFactory, StageOptions, TransformFactory, TransformSettings, TransformStage, } from "./core/output/types/output.interface.js";
+export { transformOf } from "./core/output/stage.js";
+export type { AnyOutput, IStageCatalog, OperationCallOptions, OperationPatch, OutputApplication, OutputOf, OutputSettings, OutputSource, OutputStatuses, PipeResult, Stage, StageContext, StageFactory, StageOptions, TransformFactory, TransformSettings, TransformStage, } from "./core/output/types/output.interface.js";
 export { stripUndeclared } from "./core/parse/strip.js";
 export type { Issue, IssueCode, ParseResult, } from "./core/parse/types/parse.interface.js";
-export { AbstractProperty } from "./core/property/abstract-property.js";
-export { AbstractDefineProperty } from "./core/property/define-property.js";
-export { PropertyStates } from "./core/property/enums/property-states.js";
 export { InvalidPropertyValue, PropertyRequired, } from "./core/property/exceptions.js";
 export type { IPropertyInput } from "./core/property/input.js";
 export { PropertyInput, propertyInputOf } from "./core/property/input.js";
-export { isProperty } from "./core/property/is-property.js";
-export type { PropertyLineage } from "./core/property/lineage.js";
-export { propertyLineageOf } from "./core/property/lineage.js";
 export type { DeclaredProperty, PropertyClass } from "./core/property/property.js";
 export { propertyOf } from "./core/property/property.js";
 export type { AbstractPropertyConstructor } from "./core/property/types/abstract-property-constructor.type.js";
@@ -72,39 +68,38 @@ export type { AnyPropertyConstructor, IPropertyCollection, } from "./core/proper
 export type { PropertyValue } from "./core/property/types/property-constructor.type.js";
 export type { CallableProperty, NumberConstraints, PropertyMetadata, PropertyOptions, StringConstraints, } from "./core/property/types/property-options.interface.js";
 export type { IPropertyType, SensitiveMark, UniqueMark, } from "./core/property/types/property-type.interface.js";
-export { AbstractRecord, RESERVED_RECORD_KEYS, } from "./core/record/abstract-record.js";
 export { IncompatibleRecordPlugin, InvalidRecordDeclaration, InvalidRecordPlugin, InvalidRecordValue, RecordPluginConflict, ReservedRecordKey, UndeclaredRecordProperty, UnknownRecordPlugin, } from "./core/record/exceptions.js";
 export { MASK } from "./core/record/mask.js";
 export { recordNameOf } from "./core/record/name.js";
-export { hasPlugin, isRecordPlugin, pluginsOf, recordPluginOf, } from "./core/record/plugin.js";
+export { hasPlugin, pluginsOf, recordPluginOf } from "./core/record/plugin.js";
 export { recordPluginCatalogOf } from "./core/record/plugin-catalog.js";
 export type { RecordBuilder } from "./core/record/record.js";
 export { recordBuilderOf } from "./core/record/record.js";
 export type { AnyRecordPlugin, IRecordPlugin, IRecordPluginCatalog, PluginUniqueKey, RecordPluginDescriptor, RecordPluginOptions, RecordPluginReference, RecordPluginRequirement, RecordPluginsOption, } from "./core/record/types/plugin.interface.js";
 export type { DeclaredRecordInstance, IRecord, MarkedUniqueKey, Masked, RecordChange, RecordChanges, RecordConstructor, RecordEffect, RecordEffects, RecordJson, RecordKey, RecordOptions, RecordSettings, RecordValue, } from "./core/record/types/record.interface.js";
-export { InvalidRepositoryCursor, InvalidRepositoryData, InvalidRepositoryDeclaration, InvalidRepositoryEntity, InvalidRepositoryIncrement, InvalidRepositoryQuery, RepositoryConcurrencyConflict, RepositoryEntityNotFound, RepositoryUniqueViolation, RepositoryUsedOutsideApplication, } from "./core/repository/exceptions.js";
+export { InvalidRepositoryCursor, InvalidRepositoryData, InvalidRepositoryDeclaration, InvalidRepositoryEntity, InvalidRepositoryIncrement, InvalidRepositoryQuery, InvalidStoredSchemaVersion, RepositoryConcurrencyConflict, RepositoryEntityNotFound, RepositoryUniqueViolation, RepositoryUsedOutsideApplication, } from "./core/repository/exceptions.js";
 export { type InMemoryProvider, inMemoryProvider, } from "./core/repository/in-memory.js";
-export { providerDescriptionOf, providerOf } from "./core/repository/provider.js";
+export { providerOf } from "./core/repository/provider.js";
 export type { RepositorySettings } from "./core/repository/repository.js";
-export { AbstractRepository, isRepository, RepositoryOf, repositoryOf, } from "./core/repository/repository.js";
-export type { ProviderCapabilities, ProviderDescription, ProviderOption, ProviderOptions, ProviderQuery, ProviderSettings, RepositoryCursorPage, RepositoryCursorQuery, RepositoryExists, RepositoryExplain, RepositoryFindCursor, RepositoryFindMany, RepositoryFindPage, RepositoryForEachPage, RepositoryIndex, RepositoryOrder, RepositoryPage, RepositoryPlan, RepositoryQuery, RepositoryScans, RepositoryWalkOptions, RepositoryWalkPage, RepositoryWalkResult, RepositoryWhere, } from "./core/repository/types/query.interface.js";
-export type { AnyRepository, AnyRepositoryEntity, EntityIncrementKeyOf, EntityInstanceOf, EntityKeyOf, EntityNonUniqueKeyOf, EntityUniqueKeyOf, EntityValueOf, IRepositoryProvider, ProviderIncrementOptions, ProviderKeyset, ProviderUpdateOptions, QueryValueOf, RepositoryAction, RepositoryContext, RepositoryCount, RepositoryCreate, RepositoryCreateInput, RepositoryData, RepositoryDelete, RepositoryFindBy, RepositoryFindManyBy, RepositoryIncrement, RepositoryIncrementDeltas, RepositoryIncrementOptions, RepositoryRestore, RepositoryUpdate, } from "./core/repository/types/repository.interface.js";
-export type { SchemaClass } from "./core/schema/schema.js";
-export { schemaOf } from "./core/schema/schema.js";
+export { RepositoryOf, repositoryOf } from "./core/repository/repository.js";
+export type { ProviderOption, ProviderOptions, ProviderSettings, RepositoryCursorPage, RepositoryCursorQuery, RepositoryExists, RepositoryExplain, RepositoryFindCursor, RepositoryFindMany, RepositoryFindPage, RepositoryForEachPage, RepositoryIndex, RepositoryOrder, RepositoryPage, RepositoryPlan, RepositoryQuery, RepositoryScans, RepositoryWalkOptions, RepositoryWalkPage, RepositoryWalkResult, RepositoryWhere, } from "./core/repository/types/query.interface.js";
+export type { AnyRepository, AnyRepositoryEntity, EntityIncrementKeyOf, EntityInstanceOf, EntityKeyOf, EntityNonUniqueKeyOf, EntityUniqueKeyOf, EntityValueOf, QueryValueOf, RepositoryAction, RepositoryCount, RepositoryCreate, RepositoryCreateInput, RepositoryDelete, RepositoryFindBy, RepositoryFindManyBy, RepositoryIncrement, RepositoryIncrementDeltas, RepositoryIncrementOptions, RepositoryRestore, RepositoryUpdate, } from "./core/repository/types/repository.interface.js";
+export type { EntityMigrationReport, SchemaMigrationInvalidRow, SchemaMigrationOptions, SchemaMigrationReport, } from "./core/repository/types/schema.interface.js";
 export type { ISchema, ISchemaType, } from "./core/schema/types/schema.interface.js";
 export type { StandardSchemaV1 } from "./core/standard/standard-schema.js";
-export { Demo } from "./core/symbols/demo.js";
-export { Kind } from "./core/symbols/kind.js";
 export { Meta } from "./core/symbols/meta.js";
 export { State } from "./core/symbols/state.js";
+export { Access, Route } from "./core/use-case/decorators.js";
 export { IncompatibleUseCasePlugin, InvalidUseCasePlugin, InvalidUseCaseStep, UnknownUseCasePlugin, UseCaseEntityConflict, UseCaseEntityNotFound, UseCaseInvalidCredentials, UseCaseUnavailable, } from "./core/use-case/exceptions.js";
-export { isUseCasePlugin, useCaseOriginOf, useCasePluginOf, } from "./core/use-case/plugin.js";
+export { isUseCasePlugin, useCasePluginOf } from "./core/use-case/plugin.js";
 export { isUseCaseCatalog, useCaseCatalogOf, } from "./core/use-case/plugin-catalog.js";
+export type { CheckedSteps, StepReferencesOf, StepReferenceType, StepsInitialScope, StepValueCheck, } from "./core/use-case/steps/types/check.interface.js";
 export type { StepArgs, StepEnsureKind, StepErrorDescription, StepFindTarget, StepReadAction, StepReference, StepRepositoryWith, StepValue, UseCaseStep, UseCaseStepDescription, } from "./core/use-case/steps/types/steps.interface.js";
-export { useCaseTargetOf } from "./core/use-case/target.js";
-export type { AnyUseCasePlugin, EntityOfRepository, IUseCaseCatalog, IUseCasePlugin, MissingRecordPlugin, MissingRepositoryAction, UseCaseCompilation, UseCaseContextOf, UseCaseFieldPlan, UseCaseMaker, UseCaseOriginInfo, UseCasePluginContext, UseCasePluginDescriptor, UseCasePluginRequirements, UseCasePluginSettings, UseCasePluginsByName, UseCaseTarget, UseCaseTargetInfo, } from "./core/use-case/types/plugin.interface.js";
-export type { AnyExceptionClass, AnyUseCaseClass, DependencyFunctions, DependencyOf, DependencyOverrides, StepsUseCaseConstructor, UseCaseCollection, UseCaseConstructor, UseCaseContext, UseCaseDependencies, UseCaseDependency, UseCaseInput, UseCaseOptions, UseCaseResponse, UseCaseSettings, UseCaseStepsSettings, } from "./core/use-case/use-case.js";
-export { AbstractUseCase, InvalidUseCaseDeclaration, InvalidUseCaseDependencies, isUseCase, isUseCaseClass, UseCaseAlreadyExecuted, useCaseOf, } from "./core/use-case/use-case.js";
+export type { AccessDeclaration, Principal, } from "./core/use-case/types/access.interface.js";
+export type { AnyUseCasePlugin, EntityOfRepository, IUseCaseCatalog, IUseCasePlugin, MissingRecordPlugin, MissingRepositoryAction, UseCaseCompilation, UseCaseFieldPlan, UseCaseMaker, UseCasePluginDescriptor, UseCasePluginRequirements, UseCasePluginSettings, UseCaseTarget, UseCaseTargetInfo, } from "./core/use-case/types/plugin.interface.js";
+export type { RouteDeclaration, RouteSettings, } from "./core/use-case/types/route.interface.js";
+export type { AnyExceptionClass, AnyUseCaseClass, DependencyFunctions, DependencyOf, DependencyOverrides, StepsUseCaseConstructor, UseCaseCollection, UseCaseConstructor, UseCaseContext, UseCaseDeclaration, UseCaseDependencies, UseCaseDependency, UseCaseInput, UseCaseOptions, UseCaseResponse, UseCaseSettings, UseCaseStepsSettings, } from "./core/use-case/use-case.js";
+export { InvalidUseCaseDeclaration, InvalidUseCaseDependencies, isUseCase, isUseCaseClass, UseCaseAlreadyExecuted, useCaseOf, } from "./core/use-case/use-case.js";
 export { blueprintOf } from "./std/blueprint.js";
 export { Std } from "./std/blueprint-plugin.js";
 export { commandOf } from "./std/command.js";
@@ -118,13 +113,14 @@ export { SchemaProperty } from "./std/properties/headless.js";
 export { Id, Slug } from "./std/properties/identity.js";
 export type { JsonClass, JsonValue } from "./std/properties/json.js";
 export { checkJsonSchema, JsonProperty, jsonOf, jsonSchemaIssues, } from "./std/properties/json.js";
-export { isPasswordHash, PASSWORD_MAX_LENGTH, PASSWORD_MIN_LENGTH, PASSWORD_SPECIAL_CHARACTERS, Password, PlainPassword, passwordIssues, } from "./std/properties/password.js";
+export { Password, PlainPassword } from "./std/properties/password.js";
 export { BooleanProperty, Integer, NumberProperty, StringProperty, Text, } from "./std/properties/primitives.js";
 export { CreatedAt, DateProperty, DateTime, DeletedAt, ExpiresAt, UpdatedAt, } from "./std/properties/time.js";
 export { recordOf } from "./std/record.js";
 export { Archivable, Authenticatable, Ownable, Publishable, StdRecordPlugins, Taggable, } from "./std/record-plugins.js";
+export { resourceOf } from "./std/resource.js";
 export type { IdGenerator, PasswordHasher, RuntimeServices, } from "./std/runtime.js";
 export { configure, PasswordHasherRequired, resetRuntime, SyncVerifyUnsupported, } from "./std/runtime.js";
 export { StdStages } from "./std/stages.js";
 export { StdUseCases } from "./std/use-cases/index.js";
-export type { ArchiveMaker, CreateMaker, DeleteMaker, GetMaker, ListMaker, LoginMaker, PublishMaker, RegisterMaker, RestoreMaker, StdCreateOptions, StdEntityOptions, StdHookArgs, StdHookOptions, StdLifecycleOptions, StdListOptions, StdNoHookOptions, StdOwnerOption, StdUseCaseContext, StdUseCaseErrors, StdUseCaseOptions, StdUseCasePlugins, TagMaker, UpdateMaker, } from "./std/use-cases/types.js";
+export type { ArchiveMaker, CreateMaker, DeleteMaker, GetMaker, ListMaker, LoginMaker, PublishMaker, RegisterMaker, ResourceAction, ResourceOptions, ResourceUseCases, RestoreMaker, StdCreateOptions, StdEntityOptions, StdHookArgs, StdHookOptions, StdLifecycleOptions, StdListOptions, StdNoHookOptions, StdOwnerOption, StdUseCaseContext, StdUseCaseErrors, StdUseCaseOptions, StdUseCasePlugins, TagMaker, UpdateMaker, } from "./std/use-cases/types.js";