@afora/core 0.0.5 → 0.0.7

package/dist/{index-hn82hm31.js → index-r78dsvtc.js}

@@ -17,6 +17,7 @@ var __export = (target, all) => {
 var exports_exceptions = {};
 __export(exports_exceptions, {
   IncompatibleRecordPlugin: () => IncompatibleRecordPlugin2,
+  InvalidRecordDeclaration: () => InvalidRecordDeclaration2,
   InvalidRecordPlugin: () => InvalidRecordPlugin2,
   InvalidRecordValue: () => InvalidRecordValue2,
   RecordPluginConflict: () => RecordPluginConflict2,
@@ -307,6 +308,31 @@ function recordFieldOf2(field) {
   return;
 }
 
+// src/core/record/name.ts
+var RECORD_NAME = /^[A-Za-z_$][\w$]*$/;
+function isRecordName(name) {
+  return typeof name === "string" && RECORD_NAME.test(name);
+}
+function recordNameOf2(Class) {
+  const { recordName, name } = Class;
+  return typeof recordName === "string" ? recordName : String(name);
+}
+var declaredNames = new WeakMap;
+function declareRecordName(Class, name) {
+  declaredNames.set(Class, name);
+}
+function declaredRecordNameOf(Class) {
+  for (let current = Class;typeof current === "function"; current = Object.getPrototypeOf(current)) {
+    const own = Object.getOwnPropertyDescriptor(current, "recordName")?.value;
+    if (typeof own === "string")
+      return own;
+    const declared = declaredNames.get(current);
+    if (declared !== undefined)
+      return declared;
+  }
+  return;
+}
+
 // src/core/parse/issue.ts
 function withLazyCause(issue, build) {
   let cause;
@@ -454,7 +480,7 @@ function fieldAt(field, value, parent, key, source) {
     if (value instanceof record.record)
       return { value };
     if (!isPlainObject(value)) {
-      return rejection("not_record", `must be an instance of record "${record.record.name}"`, pathAt(parent, key), source);
+      return rejection("not_record", `must be an instance of record "${recordNameOf2(record.record)}"`, pathAt(parent, key), source);
     }
     const result = record.record.safeParse(value);
     return result.issues ? underPath(result, pathAt(parent, key)) : result;
@@ -587,14 +613,16 @@ class Exception2 extends Error {
     message = this.message,
     details
   }) {
-    return new Exception2({
+    const keepsClass = name === this.name && details === undefined && isDeclaredInstance(this);
+    const init = {
       layer,
       source,
       name,
       message,
-      details,
+      details: keepsClass ? this.details : details,
       cause: this
-    });
+    };
+    return keepsClass ? Reflect.construct(Exception2, [init], this.constructor) : new Exception2(init);
   }
   toJSON() {
     return { ...this.frame, trace: this.trace };
@@ -612,6 +640,13 @@ class Exception2 extends Error {
   }
 }
 var declarations = new WeakMap;
+function isDeclaredInstance(exception) {
+  for (let current = exception.constructor;typeof current === "function"; current = Object.getPrototypeOf(current)) {
+    if (declarations.has(current))
+      return true;
+  }
+  return false;
+}
 function isDeclaredException(value) {
   return typeof value === "function" && declarations.has(value);
 }
@@ -660,6 +695,11 @@ var InvalidRecordValue2 = exceptionOf2({
     errors
   }, source) => `Invalid value for ${key ? `"${key}" of ` : ""}record "${source}": ${errors.join("; ")}`
 });
+var InvalidRecordDeclaration2 = exceptionOf2({
+  layer: "record" /* Record */,
+  name: "InvalidRecordDeclaration",
+  message: (reason, source) => `Invalid declaration of record "${source}": ${reason}`
+});
 var UndeclaredRecordProperty2 = exceptionOf2({
   layer: "record" /* Record */,
   name: "UndeclaredRecordProperty",
@@ -781,7 +821,10 @@ function checkMembers(record, keys) {
   for (let prototype = Object.getPrototypeOf(record);prototype !== null && !Object.hasOwn(prototype.constructor, "blueprint"); prototype = Object.getPrototypeOf(prototype)) {
     const key = Object.getOwnPropertyNames(prototype).find((name) => keys.includes(name));
     if (key !== undefined) {
-      throw new ReservedRecordKey2({ source: Class.name, details: { key } });
+      throw new ReservedRecordKey2({
+        source: recordNameOf2(Class),
+        details: { key }
+      });
     }
   }
   checked.add(Class);
@@ -837,7 +880,7 @@ function parseRecord(Class, value) {
   try {
     return { value: new Class(value) };
   } catch (error) {
-    return { issues: issuesOfError(error, Class.name) };
+    return { issues: issuesOfError(error, recordNameOf2(Class)) };
   }
 }
 function recordValue(record) {
@@ -868,7 +911,7 @@ function recordFieldDataOf(field, value, options) {
   return value;
 }
 function storeRecordValue(record, key, value) {
-  const source = record.constructor.name;
+  const source = recordNameOf2(record.constructor);
   const { properties } = record[Meta2].blueprint;
   if (!Object.hasOwn(properties, key)) {
     throw exceptionOfIssues([
@@ -921,7 +964,7 @@ class AbstractRecord2 {
   }
   constructor(value) {
     checkMembers(this, Object.keys(this[Meta2].blueprint.properties));
-    const source = this.constructor.name;
+    const source = recordNameOf2(this.constructor);
     const result = parseCollection(this[Meta2].blueprint.properties, value, [], source);
     if (result.issues)
       throw exceptionOfIssues(result.issues, source);
@@ -957,6 +1000,17 @@ function versionParts(version) {
   const [, major, minor, patch] = SEMVER.exec(version);
   return [Number(major), Number(minor), Number(patch)];
 }
+function satisfies(available, requested) {
+  const [major, minor, patch] = versionParts(available);
+  const [wantedMajor, wantedMinor, wantedPatch] = versionParts(requested);
+  if (major !== wantedMajor)
+    return false;
+  if (major === 0 && minor !== wantedMinor)
+    return false;
+  if (minor !== wantedMinor)
+    return minor > wantedMinor;
+  return patch >= wantedPatch;
+}
 var HOOKS = ["onSet", "onSetAll"];
 var internals = new WeakMap;
 function pluginsOf2(value) {
@@ -1140,7 +1194,14 @@ function pluginContextOf(catalogs) {
   return Object.freeze(Object.assign({}, ...catalogs.map((catalog) => catalog.plugins)));
 }
 var recordOf3 = recordBuilderOf2();
-function declareRecord(Base, declared, { plugins = [], ...declaredOptions }, name, reserved = [], context = {}) {
+function declareRecord(Base, declared, { plugins = [], name: declaredName, ...declaredOptions }, fallback, reserved = [], context = {}) {
+  if (declaredName !== undefined && !isRecordName(declaredName)) {
+    throw new InvalidRecordDeclaration2({
+      source: fallback,
+      details: `"name" must be an identifier, got ${JSON.stringify(declaredName)}.`
+    });
+  }
+  const name = declaredName ?? fallback;
   const applied = applyPlugins(declared, typeof plugins === "function" ? plugins(context) : plugins, name, reserved);
   const blueprint = applied.blueprint;
   const sensitive = [
@@ -1192,6 +1253,15 @@ function declareRecord(Base, declared, { plugins = [], ...declaredOptions }, nam
     static [RecordPlugins] = applied.plugins;
     static [RecordPluginHooks] = applied.hooks;
   }
+  if (declaredName !== undefined) {
+    declareRecordName(DeclaredRecord, declaredName);
+  }
+  Object.defineProperty(DeclaredRecord, "recordName", {
+    get() {
+      return declaredName ?? this.name;
+    },
+    configurable: true
+  });
   exposeRecordKeys(DeclaredRecord.prototype, keys);
   for (const [member, descriptor] of Object.entries(applied.descriptors)) {
     Object.defineProperty(DeclaredRecord.prototype, member, descriptor);
@@ -1218,6 +1288,60 @@ function declareRecord(Base, declared, { plugins = [], ...declaredOptions }, nam
 var CHANGE_MEMBER = "change";
 var changeNamespaces = new WeakMap;
 
+// src/core/blueprint/optional.ts
+import { Type } from "typebox";
+var cache2 = new WeakMap;
+function optionalOf2(given) {
+  const field = fieldOf(given);
+  const cached = cache2.get(field);
+  if (cached)
+    return cached;
+  if (isOptionalRecord2(field))
+    return field;
+  if (isRecordClass2(field)) {
+    const optional = Object.freeze(withStandard({
+      [Kind2]: "record",
+      record: field,
+      optional: true
+    }, (value) => value === undefined ? { value } : field.safeParse(value)));
+    cache2.set(field, optional);
+    return optional;
+  }
+  if (isBlueprint2(field)) {
+    if (field.optional)
+      return field;
+    const optional = {
+      ...field,
+      optional: true,
+      safeParse: (value) => value === undefined ? { value } : field.safeParse(value)
+    };
+    Object.freeze(withStandard(optional, (value) => optional.safeParse(value)));
+    cache2.set(field, optional);
+    return optional;
+  }
+  if (isBlueprintList2(field)) {
+    if (field.optional)
+      return field;
+    const optional = standardListOf({ ...field, optional: true });
+    cache2.set(field, optional);
+    return optional;
+  }
+  const Property = field;
+  if (Property.type.optional)
+    return Property;
+  const base = Property.type;
+  const SchemaConstructor = schemaOf2(base.name, Type.Optional(base.schema.type.Type()));
+  const type = {
+    ...base,
+    schema: new SchemaConstructor,
+    optional: true
+  };
+  const Optional = derivePropertyOf(Property, type);
+  recordPropertyLineage(Optional, { kind: "optional", base: Property });
+  cache2.set(Property, Optional);
+  return Optional;
+}
+
 // src/core/blueprint/exceptions.ts
 var ReservedBlueprintKey2 = exceptionOf2({
   layer: "blueprint" /* Blueprint */,
@@ -1246,7 +1370,7 @@ var InvalidPropertyValue2 = exceptionOf2({
 import { Type as Type3 } from "typebox";
 
 // src/core/property/property.ts
-import { Type } from "typebox";
+import { Type as Type2 } from "typebox";
 
 // src/core/symbols/state.ts
 var State2 = Symbol("state");
@@ -1464,7 +1588,7 @@ function propertyOf2({
   preHandle: onPreHandle,
   afterHandle: onAfterHandle
 }) {
-  const valueSchema = optional ? Type.Optional(schema) : schema;
+  const valueSchema = optional ? Type2.Optional(schema) : schema;
   const SchemaConstructor = schemaOf2(name, valueSchema);
   const type = {
     [Demo2]: _default,
@@ -1496,60 +1620,6 @@ function propertyOf2({
   return Property;
 }
 
-// src/core/blueprint/optional.ts
-import { Type as Type2 } from "typebox";
-var cache2 = new WeakMap;
-function optionalOf2(given) {
-  const field = fieldOf(given);
-  const cached = cache2.get(field);
-  if (cached)
-    return cached;
-  if (isOptionalRecord2(field))
-    return field;
-  if (isRecordClass2(field)) {
-    const optional = Object.freeze(withStandard({
-      [Kind2]: "record",
-      record: field,
-      optional: true
-    }, (value) => value === undefined ? { value } : field.safeParse(value)));
-    cache2.set(field, optional);
-    return optional;
-  }
-  if (isBlueprint2(field)) {
-    if (field.optional)
-      return field;
-    const optional = {
-      ...field,
-      optional: true,
-      safeParse: (value) => value === undefined ? { value } : field.safeParse(value)
-    };
-    Object.freeze(withStandard(optional, (value) => optional.safeParse(value)));
-    cache2.set(field, optional);
-    return optional;
-  }
-  if (isBlueprintList2(field)) {
-    if (field.optional)
-      return field;
-    const optional = standardListOf({ ...field, optional: true });
-    cache2.set(field, optional);
-    return optional;
-  }
-  const Property = field;
-  if (Property.type.optional)
-    return Property;
-  const base = Property.type;
-  const SchemaConstructor = schemaOf2(base.name, Type2.Optional(base.schema.type.Type()));
-  const type = {
-    ...base,
-    schema: new SchemaConstructor,
-    optional: true
-  };
-  const Optional = derivePropertyOf(Property, type);
-  recordPropertyLineage(Optional, { kind: "optional", base: Property });
-  cache2.set(Property, Optional);
-  return Optional;
-}
-
 // src/core/blueprint/blueprint.ts
 function blueprintBuilderOf2(...base) {
   return (sourcesOrDefine, maybeDefine) => {
@@ -1648,4 +1718,4 @@ function schemaOfField(key, field) {
   });
 }
 
-export { __export, isProperty2, schemaOf2, Demo2, recordPropertyLineage, propertyLineageOf2, fieldOf, Kind2, isBlueprint2, isRecordClass2, isOptionalRecord2, recordFieldOf2, listOf2, isBlueprintList2, ExceptionLayers2, UNEXPECTED_ERROR2, Exception2, isDeclaredException, declaredMessageOf, exceptionOf2, Meta2, InvalidRecordValue2, UndeclaredRecordProperty2, ReservedRecordKey2, InvalidRecordPlugin2, RecordPluginConflict2, UnknownRecordPlugin2, IncompatibleRecordPlugin2, exports_exceptions, MASK2, RESERVED_RECORD_KEYS2, recordDataOf, recordFieldDataOf, storeRecordValue, runRecordEffects, AbstractRecord2, IdentifiedRecord, isVersion, versionParts, pluginsOf2, isRecordPlugin2, hasPlugin2, recordPluginOf2, recordBuilderOf2, pluginContextOf, recordOf3, declareRecord, ReservedBlueprintKey2, UndeclaredBlueprintProperty2, exports_exceptions2, PropertyRequired2, InvalidPropertyValue2, exports_exceptions3, State2, AbstractProperty2, PropertyStates2, AbstractDefineProperty2, propertyOf2, optionalOf2, blueprintBuilderOf2, blueprintFromProperties };
+export { __export, isProperty2, schemaOf2, Demo2, recordPropertyLineage, propertyLineageOf2, fieldOf, Kind2, isBlueprint2, isRecordClass2, isOptionalRecord2, recordFieldOf2, recordNameOf2, declaredRecordNameOf, listOf2, isBlueprintList2, ExceptionLayers2, UNEXPECTED_ERROR2, Exception2, isDeclaredException, declaredMessageOf, exceptionOf2, Meta2, InvalidRecordValue2, InvalidRecordDeclaration2, UndeclaredRecordProperty2, ReservedRecordKey2, InvalidRecordPlugin2, RecordPluginConflict2, UnknownRecordPlugin2, IncompatibleRecordPlugin2, exports_exceptions, MASK2, RESERVED_RECORD_KEYS2, recordDataOf, recordFieldDataOf, storeRecordValue, runRecordEffects, AbstractRecord2, IdentifiedRecord, isVersion, satisfies, pluginsOf2, isRecordPlugin2, hasPlugin2, recordPluginOf2, recordBuilderOf2, pluginContextOf, recordOf3, declareRecord, optionalOf2, ReservedBlueprintKey2, UndeclaredBlueprintProperty2, exports_exceptions2, PropertyRequired2, InvalidPropertyValue2, exports_exceptions3, State2, AbstractProperty2, PropertyStates2, AbstractDefineProperty2, propertyOf2, blueprintBuilderOf2, blueprintFromProperties };

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { ApplicationAlreadyStarted, ApplicationConflict, ApplicationNotStarted,
 export { isProviderSlot, isProviderStorage, 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, ApplicationSettings, ApplicationStartOptions, CommandDescription, ExceptionDescription, FieldDescription, FieldsDescription, IApplication, LogDescription, OutputDescription, PropertyDescription, PropertyLineageDescription, PropertyReference, ProviderReference, RecordDescription, UseCaseDependencyDescription, UseCaseDescription, } from "./core/application/types/application.interface.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 { blueprintBuilderOf } from "./core/blueprint/blueprint.js";
 export { blueprintPluginOf } from "./core/blueprint/blueprint-plugin.js";
 export { ReservedBlueprintKey, UndeclaredBlueprintProperty, } from "./core/blueprint/exceptions.js";
@@ -13,9 +13,9 @@ 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 { BlueprintFactory, IBlueprintFactories, IBlueprintPlugin, } from "./core/blueprint/types/blueprint-plugin.interface.js";
-export { commandOf, isCommand } from "./core/command/command.js";
+export { commandBuilderOf, isCommand } from "./core/command/command.js";
 export { CommandEventFailed, InvalidCommandContext, InvalidCommandDeclaration, InvalidCommandEnvironment, UnknownCommandOperation, } from "./core/command/exceptions.js";
-export type { AnyCommand, CommandEnvOption, CommandEventErrorHandler, CommandEventHandler, CommandEventInfo, CommandEvents, CommandExecution, CommandInput, CommandOf, CommandOperation, CommandOptions, CommandResponse, CommandSettings, CommandUseCases, } from "./core/command/types/command.interface.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, EntityUniqueKeys, RESERVED_ENTITY_KEYS, } 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";
@@ -50,6 +50,8 @@ 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";
@@ -62,23 +64,24 @@ export type { IProperty } from "./core/property/types/property.interface.js";
 export type { AnyPropertyConstructor, IPropertyCollection, } from "./core/property/types/property-collection.type.js";
 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, UniqueMark, } from "./core/property/types/property-type.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, InvalidRecordPlugin, InvalidRecordValue, RecordPluginConflict, ReservedRecordKey, UndeclaredRecordProperty, UnknownRecordPlugin, } from "./core/record/exceptions.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 { 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, RecordChange, RecordChanges, RecordConstructor, RecordEffect, RecordEffects, RecordKey, RecordOptions, RecordSettings, RecordValue, } from "./core/record/types/record.interface.js";
-export { InvalidRepositoryData, InvalidRepositoryDeclaration, InvalidRepositoryEntity, InvalidRepositoryQuery, RepositoryEntityNotFound, RepositoryUniqueViolation, } from "./core/repository/exceptions.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, InvalidRepositoryQuery, RepositoryEntityNotFound, RepositoryUniqueViolation, } from "./core/repository/exceptions.js";
 export { inMemoryProvider } from "./core/repository/in-memory.js";
 export { providerDescriptionOf, 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, ProviderSettings, RepositoryExists, RepositoryFindMany, RepositoryFindPage, RepositoryOrder, RepositoryPage, RepositoryQuery, RepositoryWhere, } from "./core/repository/types/query.interface.js";
-export type { AnyRepository, AnyRepositoryEntity, EntityInstanceOf, EntityKeyOf, EntityNonUniqueKeyOf, EntityUniqueKeyOf, EntityValueOf, IRepositoryProvider, QueryValueOf, RepositoryAction, RepositoryContext, RepositoryCount, RepositoryCreate, RepositoryCreateInput, RepositoryData, RepositoryDelete, RepositoryFindBy, RepositoryFindManyBy, RepositoryUpdate, } from "./core/repository/types/repository.interface.js";
+export type { ProviderCapabilities, ProviderDescription, ProviderOption, ProviderOptions, ProviderQuery, ProviderSettings, RepositoryCursorPage, RepositoryCursorQuery, RepositoryExists, RepositoryFindCursor, RepositoryFindMany, RepositoryFindPage, RepositoryOrder, RepositoryPage, RepositoryQuery, RepositoryWhere, } from "./core/repository/types/query.interface.js";
+export type { AnyRepository, AnyRepositoryEntity, EntityInstanceOf, EntityKeyOf, EntityNonUniqueKeyOf, EntityUniqueKeyOf, EntityValueOf, IRepositoryProvider, QueryValueOf, RepositoryAction, RepositoryContext, RepositoryCount, RepositoryCreate, RepositoryCreateInput, RepositoryData, RepositoryDelete, RepositoryFindBy, RepositoryFindManyBy, 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 type { ISchema, ISchemaType, } from "./core/schema/types/schema.interface.js";
@@ -87,19 +90,24 @@ 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 { InvalidUseCaseStep } from "./core/use-case/exceptions.js";
-export type { StepEnsureKind, StepErrorDescription, StepFindTarget, StepReadAction, StepReference, StepRepositoryWith, StepValue, UseCaseStep, UseCaseStepDescription, } from "./core/use-case/steps/types/steps.interface.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 { isUseCaseCatalog, useCaseCatalogOf, } from "./core/use-case/plugin-catalog.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 { blueprintOf } from "./std/blueprint.js";
 export { Std } from "./std/blueprint-plugin.js";
+export { commandOf } from "./std/command.js";
 export { entityOf } from "./std/entity.js";
 export { Email, Ip, Phone, Url } from "./std/properties/contact.js";
 export type { EnumClass } from "./std/properties/enum.js";
 export { enumOf } from "./std/properties/enum.js";
 export { SchemaProperty } from "./std/properties/headless.js";
 export { Id, Slug } from "./std/properties/identity.js";
-export { isPasswordHash, PASSWORD_MAX_LENGTH, PASSWORD_MIN_LENGTH, PASSWORD_SPECIAL_CHARACTERS, Password, passwordIssues, } from "./std/properties/password.js";
+export { isPasswordHash, PASSWORD_MAX_LENGTH, PASSWORD_MIN_LENGTH, PASSWORD_SPECIAL_CHARACTERS, Password, PlainPassword, passwordIssues, } from "./std/properties/password.js";
 export { BooleanProperty, Integer, NumberProperty, StringProperty, Text, } from "./std/properties/primitives.js";
 export { CreatedAt, DateProperty, DateTime, DeletedAt, UpdatedAt, } from "./std/properties/time.js";
 export { recordOf } from "./std/record.js";
@@ -107,3 +115,5 @@ export { Archivable, Authenticatable, Ownable, Publishable, StdRecordPlugins, Ta
 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, StdLifecycleOptions, StdListOptions, StdOwnerOption, StdUseCaseContext, StdUseCaseErrors, StdUseCaseOptions, StdUseCasePlugins, TagMaker, UpdateMaker, } from "./std/use-cases/types.js";

package/dist/index.js

@@ -34,6 +34,7 @@ import {
   EntityUniqueKeys2,
   AbstractEntity2,
   InvalidRepositoryQuery2,
+  InvalidRepositoryCursor2,
   InvalidRepositoryDeclaration2,
   InvalidRepositoryEntity2,
   InvalidRepositoryData2,
@@ -47,6 +48,16 @@ import {
   RepositoryOf2,
   isRepository2,
   InvalidUseCaseStep2,
+  InvalidUseCasePlugin2,
+  UnknownUseCasePlugin2,
+  IncompatibleUseCasePlugin2,
+  UseCaseUnavailable2,
+  UseCaseEntityNotFound2,
+  UseCaseEntityConflict2,
+  UseCaseInvalidCredentials2,
+  PropertyInput2,
+  propertyInputOf2,
+  useCaseTargetOf2,
   InvalidUseCaseDeclaration2,
   UseCaseAlreadyExecuted2,
   InvalidUseCaseDependencies2,
@@ -54,12 +65,17 @@ import {
   useCaseOf2,
   isUseCaseClass2,
   isUseCase2,
+  isUseCasePlugin2,
+  useCaseOriginOf2,
+  useCasePluginOf2,
+  isUseCaseCatalog2,
+  useCaseCatalogOf2,
   InvalidCommandDeclaration2,
   UnknownCommandOperation2,
   InvalidCommandContext2,
   InvalidCommandEnvironment2,
   CommandEventFailed2,
-  commandOf2,
+  commandBuilderOf2,
   isCommand2,
   InvalidOpenAPIModel2,
   InvalidOutputStage2,
@@ -109,6 +125,7 @@ import {
   PASSWORD_SPECIAL_CHARACTERS2,
   isPasswordHash2,
   passwordIssues2,
+  PlainPassword2,
   Password2,
   StringProperty2,
   Text2,
@@ -122,6 +139,8 @@ import {
   DeletedAt2,
   Std2,
   blueprintOf2,
+  StdUseCases2,
+  commandOf2,
   Publishable2,
   Archivable2,
   Taggable2,
@@ -131,7 +150,7 @@ import {
   entityOf2,
   recordOf2,
   StdStages2
-} from "./index-8m80wjzf.js";
+} from "./index-q6hggpzw.js";
 import {
   isProperty2,
   schemaOf2,
@@ -142,6 +161,7 @@ import {
   isRecordClass2,
   isOptionalRecord2,
   recordFieldOf2,
+  recordNameOf2,
   listOf2,
   isBlueprintList2,
   ExceptionLayers2,
@@ -150,6 +170,7 @@ import {
   exceptionOf2,
   Meta2,
   InvalidRecordValue2,
+  InvalidRecordDeclaration2,
   UndeclaredRecordProperty2,
   ReservedRecordKey2,
   InvalidRecordPlugin2,
@@ -164,6 +185,7 @@ import {
   hasPlugin2,
   recordPluginOf2,
   recordBuilderOf2,
+  optionalOf2,
   ReservedBlueprintKey2,
   UndeclaredBlueprintProperty2,
   PropertyRequired2,
@@ -173,9 +195,8 @@ import {
   PropertyStates2,
   AbstractDefineProperty2,
   propertyOf2,
-  optionalOf2,
   blueprintBuilderOf2
-} from "./index-hn82hm31.js";
+} from "./index-r78dsvtc.js";
 export {
   AbstractDefineProperty2 as AbstractDefineProperty,
   AbstractEntity2 as AbstractEntity,
@@ -206,6 +227,7 @@ export {
   Id2 as Id,
   ImmutableEntityKey2 as ImmutableEntityKey,
   IncompatibleRecordPlugin2 as IncompatibleRecordPlugin,
+  IncompatibleUseCasePlugin2 as IncompatibleUseCasePlugin,
   Integer2 as Integer,
   InvalidApplicationDeclaration2 as InvalidApplicationDeclaration,
   InvalidApplicationEnvironment2 as InvalidApplicationEnvironment,
@@ -217,14 +239,17 @@ export {
   InvalidOpenAPIModel2 as InvalidOpenAPIModel,
   InvalidOutputStage2 as InvalidOutputStage,
   InvalidPropertyValue2 as InvalidPropertyValue,
+  InvalidRecordDeclaration2 as InvalidRecordDeclaration,
   InvalidRecordPlugin2 as InvalidRecordPlugin,
   InvalidRecordValue2 as InvalidRecordValue,
+  InvalidRepositoryCursor2 as InvalidRepositoryCursor,
   InvalidRepositoryData2 as InvalidRepositoryData,
   InvalidRepositoryDeclaration2 as InvalidRepositoryDeclaration,
   InvalidRepositoryEntity2 as InvalidRepositoryEntity,
   InvalidRepositoryQuery2 as InvalidRepositoryQuery,
   InvalidUseCaseDeclaration2 as InvalidUseCaseDeclaration,
   InvalidUseCaseDependencies2 as InvalidUseCaseDependencies,
+  InvalidUseCasePlugin2 as InvalidUseCasePlugin,
   InvalidUseCaseStep2 as InvalidUseCaseStep,
   Ip2 as Ip,
   Kind2 as Kind,
@@ -241,6 +266,8 @@ export {
   Password2 as Password,
   PasswordHasherRequired2 as PasswordHasherRequired,
   Phone2 as Phone,
+  PlainPassword2 as PlainPassword,
+  PropertyInput2 as PropertyInput,
   PropertyRequired2 as PropertyRequired,
   PropertyStates2 as PropertyStates,
   ProviderNotBound2 as ProviderNotBound,
@@ -260,6 +287,7 @@ export {
   Std2 as Std,
   StdRecordPlugins2 as StdRecordPlugins,
   StdStages2 as StdStages,
+  StdUseCases2 as StdUseCases,
   StringProperty2 as StringProperty,
   SyncVerifyUnsupported2 as SyncVerifyUnsupported,
   Taggable2 as Taggable,
@@ -269,16 +297,22 @@ export {
   UndeclaredRecordProperty2 as UndeclaredRecordProperty,
   UnknownCommandOperation2 as UnknownCommandOperation,
   UnknownRecordPlugin2 as UnknownRecordPlugin,
+  UnknownUseCasePlugin2 as UnknownUseCasePlugin,
   UnregisteredApplicationReference2 as UnregisteredApplicationReference,
   UnregisteredRepositoryDependency2 as UnregisteredRepositoryDependency,
   UnregisteredUseCaseDependency2 as UnregisteredUseCaseDependency,
   UpdatedAt2 as UpdatedAt,
   Url2 as Url,
   UseCaseAlreadyExecuted2 as UseCaseAlreadyExecuted,
+  UseCaseEntityConflict2 as UseCaseEntityConflict,
+  UseCaseEntityNotFound2 as UseCaseEntityNotFound,
+  UseCaseInvalidCredentials2 as UseCaseInvalidCredentials,
+  UseCaseUnavailable2 as UseCaseUnavailable,
   applicationOf2 as applicationOf,
   blueprintBuilderOf2 as blueprintBuilderOf,
   blueprintOf2 as blueprintOf,
   blueprintPluginOf2 as blueprintPluginOf,
+  commandBuilderOf2 as commandBuilderOf,
   commandOf2 as commandOf,
   configure2 as configure,
   consoleLogProvider2 as consoleLogProvider,
@@ -310,7 +344,9 @@ export {
   isRecordPlugin2 as isRecordPlugin,
   isRepository2 as isRepository,
   isUseCase2 as isUseCase,
+  isUseCaseCatalog2 as isUseCaseCatalog,
   isUseCaseClass2 as isUseCaseClass,
+  isUseCasePlugin2 as isUseCasePlugin,
   jsonLogProvider2 as jsonLogProvider,
   listOf2 as listOf,
   logFrom2 as logFrom,
@@ -325,6 +361,7 @@ export {
   passwordIssues2 as passwordIssues,
   pluginsOf2 as pluginsOf,
   problemOf2 as problemOf,
+  propertyInputOf2 as propertyInputOf,
   propertyLineageOf2 as propertyLineageOf,
   propertyOf2 as propertyOf,
   providerDescriptionOf2 as providerDescriptionOf,
@@ -333,6 +370,7 @@ export {
   providersOf2 as providersOf,
   recordBuilderOf2 as recordBuilderOf,
   recordFieldOf2 as recordFieldOf,
+  recordNameOf2 as recordNameOf,
   recordOf2 as recordOf,
   recordPluginCatalogOf2 as recordPluginCatalogOf,
   recordPluginOf2 as recordPluginOf,
@@ -350,5 +388,9 @@ export {
   toOpenAPI2 as toOpenAPI,
   transformOf2 as transformOf,
   useApplication2 as useApplication,
-  useCaseOf2 as useCaseOf
+  useCaseCatalogOf2 as useCaseCatalogOf,
+  useCaseOf2 as useCaseOf,
+  useCaseOriginOf2 as useCaseOriginOf,
+  useCasePluginOf2 as useCasePluginOf,
+  useCaseTargetOf2 as useCaseTargetOf
 };

package/dist/std/command.d.ts

@@ -0,0 +1,11 @@
+import type { CommandBuilder } from "../core/command/types/command.interface.js";
+import type { StdUseCaseContext } from "./use-cases/types.js";
+/**
+ * Groups use cases under operation names and is the boundary of a call: the
+ * context is validated once, a transaction can wrap the use case, and the
+ * events it raised are handled by a policy once it succeeded. `useCases` is
+ * an object of use case classes, or a function of the standard use cases
+ * (`StdUseCases`) that gives one:
+ * `(ctx) => ({ create: ctx.create(Posts), custom: MyUseCase })`.
+ */
+export declare const commandOf: CommandBuilder<StdUseCaseContext>;