@afora/core 0.0.5 → 0.0.6

package/dist/{index-8m80wjzf.js → index-gbgc40xe.js}

@@ -9,6 +9,8 @@ import {
   isBlueprint2,
   isRecordClass2,
   recordFieldOf2,
+  recordNameOf2,
+  declaredRecordNameOf,
   isBlueprintList2,
   UNEXPECTED_ERROR2,
   Exception2,
@@ -40,7 +42,7 @@ import {
   exports_exceptions3,
   propertyOf2,
   blueprintBuilderOf2
-} from "./index-hn82hm31.js";
+} from "./index-3nd9bjnc.js";
 
 // src/core/environment/environment.ts
 var exports_environment = {};
@@ -83,6 +85,7 @@ __export(exports_exceptions6, {
 // src/core/repository/exceptions.ts
 var exports_exceptions7 = {};
 __export(exports_exceptions7, {
+  InvalidRepositoryCursor: () => InvalidRepositoryCursor2,
   InvalidRepositoryData: () => InvalidRepositoryData2,
   InvalidRepositoryDeclaration: () => InvalidRepositoryDeclaration2,
   InvalidRepositoryEntity: () => InvalidRepositoryEntity2,
@@ -640,7 +643,7 @@ function clockOf(entity) {
 function assertAlive(entity) {
   if (entity.isDeleted) {
     throw new DeletedEntity2({
-      source: entity.constructor.name,
+      source: recordNameOf2(entity.constructor),
       details: { id: identityOf(entity).id }
     });
   }
@@ -690,7 +693,7 @@ class AbstractEntity2 extends AbstractRecord2 {
     const name = String(key);
     if (ENTITY_IDENTITY_KEYS2.includes(name)) {
       throw new ImmutableEntityKey2({
-        source: this.constructor.name,
+        source: recordNameOf2(this.constructor),
         details: { key: name }
       });
     }
@@ -715,6 +718,13 @@ var InvalidRepositoryQuery2 = exceptionOf2({
   name: "InvalidRepositoryQuery",
   message: ({ reason }) => reason
 });
+var InvalidRepositoryCursor2 = exceptionOf2({
+  layer: "repository" /* Repository */,
+  name: "InvalidRepositoryCursor",
+  message: ({
+    reason
+  }) => reason
+});
 var InvalidRepositoryDeclaration2 = exceptionOf2({
   layer: "repository" /* Repository */,
   name: "InvalidRepositoryDeclaration",
@@ -741,6 +751,90 @@ var RepositoryEntityNotFound2 = exceptionOf2({
   message: ({ id }, source) => `"${source}" holds no entity of id "${id}".`
 });
 
+// src/core/repository/cursor.ts
+var VERSION = 1;
+var signatureOf = (orders) => orders.map(({ key, direction = "asc" }) => `${key}:${direction}`);
+function pack(value) {
+  if (value === undefined || value === null)
+    return null;
+  if (value instanceof Date)
+    return { d: value.toISOString() };
+  if (typeof value === "bigint")
+    return { b: value.toString() };
+  return value;
+}
+function unpack(value) {
+  if (value === null)
+    return;
+  if (["string", "number", "boolean"].includes(typeof value))
+    return value;
+  if (typeof value === "object") {
+    const { d, b } = value;
+    const keys = Object.keys(value);
+    if (keys.length === 1 && typeof d === "string") {
+      const date = new Date(d);
+      if (!Number.isNaN(date.getTime()))
+        return date;
+    }
+    if (keys.length === 1 && typeof b === "string" && /^-?\d+$/.test(b))
+      return BigInt(b);
+  }
+  throw new SyntaxError("value");
+}
+function encodeText(text) {
+  let binary = "";
+  for (const byte of new TextEncoder().encode(text))
+    binary += String.fromCharCode(byte);
+  return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/, "");
+}
+function decodeText(encoded) {
+  if (!/^[A-Za-z0-9_-]+$/.test(encoded))
+    throw new SyntaxError("alphabet");
+  const binary = atob(encoded.replaceAll("-", "+").replaceAll("_", "/"));
+  return new TextDecoder("utf-8", { fatal: true }).decode(Uint8Array.from(binary, (char) => char.charCodeAt(0)));
+}
+function encodeCursor(orders, row) {
+  const payload = {
+    v: VERSION,
+    k: signatureOf(orders),
+    a: orders.map(({ key }) => pack(row[key]))
+  };
+  return encodeText(JSON.stringify(payload));
+}
+function decodeCursor(source, orders, cursor) {
+  const fail = (reason) => {
+    throw new InvalidRepositoryCursor2({
+      source,
+      details: {
+        reason,
+        issues: [
+          { code: "invalid_value", path: ["after"], message: reason, source }
+        ]
+      }
+    });
+  };
+  if (typeof cursor !== "string" || cursor === "")
+    return fail("Expected a cursor given by findCursor.");
+  let payload;
+  let values;
+  try {
+    payload = JSON.parse(decodeText(cursor));
+    if (typeof payload !== "object" || payload === null)
+      throw new SyntaxError;
+    if (!Array.isArray(payload.k) || !Array.isArray(payload.a))
+      throw new SyntaxError;
+    values = payload.a.map(unpack);
+  } catch {
+    return fail("The cursor is not one given by findCursor.");
+  }
+  if (payload.v !== VERSION)
+    return fail("The cursor was made by another version.");
+  const expected = signatureOf(orders);
+  if (payload.k?.length !== expected.length || values.length !== expected.length || expected.some((key, index) => payload.k?.[index] !== key))
+    return fail("The cursor was made for another orderBy.");
+  return values;
+}
+
 // src/core/json.ts
 function frozenJson(value, subject, fail, seen = new Set) {
   if (value === null || typeof value === "string" || typeof value === "boolean")
@@ -798,7 +892,8 @@ function plain(value) {
 function isMembership(value) {
   return plain(value) && Object.keys(value).length === 1 && Array.isArray(value.in);
 }
-function prepareQuery(context, input = {}, map = (_key, value) => value) {
+var QUERY_OPTIONS = ["where", "orderBy", "limit", "offset", "withDeleted"];
+function prepareQuery(context, input = {}, map = (_key, value) => value, options = QUERY_OPTIONS) {
   const fail = (reason) => {
     throw new InvalidRepositoryQuery2({
       source: context.name,
@@ -808,7 +903,7 @@ function prepareQuery(context, input = {}, map = (_key, value) => value) {
   if (!plain(input))
     return fail("Expected a query object.");
   for (const key of Object.keys(input))
-    if (!["where", "orderBy", "limit", "offset", "withDeleted"].includes(key))
+    if (!options.includes(key))
       fail(`Unknown query option "${key}".`);
   const properties = context.entity.blueprint.properties;
   const keyOf = (key) => {
@@ -890,26 +985,32 @@ function compareScalars(a, b) {
   ];
   return x < y ? -1 : x > y ? 1 : 0;
 }
+function compareRows(orders, a, b) {
+  for (const { key, direction } of orders) {
+    const [x, y] = [a[key], b[key]];
+    const [missingX, missingY] = [
+      x === undefined || x === null,
+      y === undefined || y === null
+    ];
+    let result = missingX || missingY ? Number(!missingX) - Number(!missingY) : compareScalars(x, y);
+    if (direction === "desc")
+      result = -result;
+    if (result !== 0)
+      return result;
+  }
+  return 0;
+}
 function orderRows(rows, query) {
   const orders = query.orderBy ?? [];
-  return [...rows].sort((a, b) => {
-    for (const { key, direction } of orders) {
-      const [x, y] = [a[key], b[key]];
-      const [missingX, missingY] = [
-        x === undefined || x === null,
-        y === undefined || y === null
-      ];
-      let result = missingX || missingY ? Number(!missingX) - Number(!missingY) : compareScalars(x, y);
-      if (direction === "desc")
-        result = -result;
-      if (result !== 0)
-        return result;
-    }
-    return 0;
-  });
+  return [...rows].sort((a, b) => compareRows(orders, a, b));
+}
+function rowsAfter(rows, orders, after) {
+  const position = Object.fromEntries(orders.map(({ key }, index) => [key, after[index]]));
+  return rows.filter((row) => compareRows(orders, row, position) > 0);
 }
 function selectRows(rows, query) {
-  const matched = orderRows([...rows].filter((data) => matchesQuery(data, query)), query);
+  const ordered = orderRows([...rows].filter((data) => matchesQuery(data, query)), query);
+  const matched = query.after === undefined ? ordered : rowsAfter(ordered, query.orderBy ?? [], query.after);
   const start = query.offset ?? 0;
   return matched.slice(start, query.limit === undefined ? undefined : start + query.limit);
 }
@@ -961,7 +1062,7 @@ function scopeOf(initial, root) {
     }
   };
   const provider = {
-    capabilities: Object.freeze({ transactions: true }),
+    capabilities: Object.freeze({ transactions: true, keyset: true }),
     findOne: (context, query = {}) => whenIdle(() => {
       const [first] = selectRows(tableOf(context).values(), {
         ...query,
@@ -1193,7 +1294,7 @@ function relationsOf(name, entity, relations) {
     if (!state)
       return invalid("Expected relations made by repositoryOf.");
     if (related.some((other) => other.entity === state.entity)) {
-      return invalid(`Relation "${state.entity.name}" is duplicated.`);
+      return invalid(`Relation "${recordNameOf2(state.entity)}" is duplicated.`);
     }
     if (typeof state.provider.findMany !== "function") {
       return invalid(`The provider of "${state.name}" has no "findMany" to load it.`);
@@ -1206,10 +1307,10 @@ function relationsOf(name, entity, relations) {
     const matches = related.filter((state) => state.entity === target || state.entity.prototype instanceof target);
     const exact = matches.find((state) => state.entity === target);
     if (!exact && matches.length === 0) {
-      return invalid(`Missing relation: no repository of "${target.name}".`);
+      return invalid(`Missing relation: no repository of "${recordNameOf2(target)}".`);
     }
     if (!exact && matches.length > 1) {
-      return invalid(`Relation "${target.name}" matches more than one repository.`);
+      return invalid(`Relation "${recordNameOf2(target)}" matches more than one repository.`);
     }
     const state = exact ?? matches[0];
     map.set(target, state);
@@ -1217,7 +1318,7 @@ function relationsOf(name, entity, relations) {
   }
   for (const state of related) {
     if (!used.has(state)) {
-      return invalid(`Relation "${state.entity.name}" is not held by ${entity.name}.`);
+      return invalid(`Relation "${recordNameOf2(state.entity)}" is not held by ${recordNameOf2(entity)}.`);
     }
   }
   return map;
@@ -1368,6 +1469,44 @@ var findPage = action(async (self, query) => {
   ]);
   return { items: await self.hydrateMany(rows), total, limit, offset };
 });
+var CURSOR_OPTIONS = ["where", "orderBy", "limit", "withDeleted", "after"];
+var findCursor = action(async (self, query = {}) => {
+  const { context } = self;
+  const fail = (reason) => {
+    throw new InvalidRepositoryQuery2({
+      source: context.name,
+      details: { reason }
+    });
+  };
+  const prepared = prepareQuery(context, query, (key, value) => queryValueOf(context, key, value), CURSOR_OPTIONS);
+  const { after } = query;
+  const { where, limit = 20 } = prepared;
+  if (limit < 1)
+    fail("Expected a positive integer for limit.");
+  const withDeleted = prepared.withDeleted ?? stateOf(self).deletion === "hard";
+  const declared = prepared.orderBy ?? [];
+  const orderBy = declared.some(({ key }) => key === "id") ? declared : [...declared, { key: "id", direction: "asc" }];
+  for (const { key } of orderBy) {
+    if (context.entity.options.sensitive.includes(key))
+      fail(`"${key}" is sensitive and cannot order a cursor.`);
+  }
+  if (self.provider.capabilities?.keyset !== true)
+    fail("The provider does not read by cursor (capabilities.keyset).");
+  const rows = await self.provider.findMany(context, {
+    where,
+    orderBy,
+    withDeleted,
+    limit: limit + 1,
+    ...after === undefined ? {} : { after: decodeCursor(context.name, orderBy, after) }
+  });
+  const page = rows.slice(0, limit);
+  const last = page.at(-1);
+  return {
+    items: await self.hydrateMany(page),
+    limit,
+    next: rows.length > limit && last !== undefined ? encodeCursor(orderBy, last) : undefined
+  };
+});
 var create = action(async (self, input) => {
   const { entity: Entity } = self.context;
   const entity = input instanceof Entity ? input : new Entity(input);
@@ -1412,7 +1551,8 @@ var NEEDS = {
   count: ["count"],
   findMany: ["findMany"],
   exists: ["findOne"],
-  findPage: ["findMany", "count"]
+  findPage: ["findMany", "count"],
+  findCursor: ["findMany"]
 };
 function capitalize(key) {
   return `${key.charAt(0).toUpperCase()}${key.slice(1)}`;
@@ -1438,7 +1578,7 @@ function repositoryOf2(settings) {
   if (!isEntityClass2(entity) || !(EntityUniqueKeys2 in entity)) {
     invalid3("repositoryOf", "Expected an entity class made by entityOf.");
   }
-  const name = `${entity.name}Repository`;
+  const name = `${recordNameOf2(entity)}Repository`;
   const deletion = settings.deletion ?? "hard";
   if (deletion !== "hard" && deletion !== "soft") {
     invalid3(name, 'Expected deletion to be "hard" or "soft".');
@@ -1468,13 +1608,14 @@ function repositoryOf2(settings) {
   methods.set("findMany", ["findMany", findMany]);
   methods.set("exists", ["exists", exists]);
   methods.set("findPage", ["findPage", findPage]);
+  methods.set("findCursor", ["findCursor", findCursor]);
 
   class DeclaredRepository extends AbstractRepository2 {
   }
   for (const name_ of new Set(actions)) {
     const method = typeof name_ === "string" ? methods.get(name_) : undefined;
     if (!method)
-      invalid3(name, unknownAction(entity.name, String(name_), methods));
+      invalid3(name, unknownAction(recordNameOf2(entity), String(name_), methods));
     const [kind, implementation] = method;
     const needs = deletion === "soft" && kind === "delete" ? ["findOne", "update"] : NEEDS[kind] ?? [];
     for (const need of needs) {
@@ -1766,7 +1907,7 @@ var ENSURE_KINDS = new Set([
   "true",
   "false"
 ]);
-var READ_ACTION = /^(?:findBy.+|findManyBy.+|findMany|exists|findPage|count)$/;
+var READ_ACTION = /^(?:findBy.+|findManyBy.+|findMany|exists|findPage|findCursor|count)$/;
 var WRITE_ACTIONS = new Set(["create", "update", "delete"]);
 function validateSteps(declaration, steps) {
   const { name } = declaration;
@@ -2068,7 +2209,7 @@ function methodNamesOf(repository) {
 }
 function bindRepository2(repository, overrides, state, source) {
   const Entity = repository.entity;
-  const repositoryName = Entity.name;
+  const repositoryName = recordNameOf2(Entity);
   const bound = Object.create(null);
   const view = new Proxy(Object.create(repository), {
     get: (_target, key, receiver) => {
@@ -3597,7 +3738,7 @@ function resolve(settings) {
       if (!isOfKind(collection, value)) {
         invalid7(source, `${collection}.${name} is not a ${KIND_OF[collection]} (${collection} takes ${KIND_OF[collection]} declarations).`);
       }
-      const declaredName = collection === "useCases" ? value.useCaseName : collection === "commands" ? value.commandName : collection === "outputs" ? value.outputName : collection === "exceptions" ? value.name : name;
+      const declaredName = collection === "useCases" ? value.useCaseName : collection === "commands" ? value.commandName : collection === "outputs" ? value.outputName : collection === "exceptions" ? value.name : collection === "records" || collection === "entities" ? declaredRecordNameOf(value) ?? name : name;
       if (declaredName !== name) {
         invalid7(source, `${collection}.${name} must be keyed by its name, "${declaredName}".`);
       }
@@ -3652,7 +3793,7 @@ function validate(source, registry) {
           source,
           details: {
             holder: `${KIND_OF[collection]} "${entry.name}"`,
-            reference: `${isEntityClass2(record) ? "entity" : "record"} "${record.name}"`
+            reference: `${isEntityClass2(record) ? "entity" : "record"} "${recordNameOf2(record)}"`
           }
         });
       }
@@ -3673,7 +3814,7 @@ function validate(source, registry) {
     }
     for (const relation of info.relations) {
       if (!repositories.has(relation)) {
-        unregistered(entry.name, `the repository of "${relation.entity.name}"`);
+        unregistered(entry.name, `the repository of "${recordNameOf2(relation.entity)}"`);
       }
     }
     for (const environment of info.environments) {
@@ -3772,7 +3913,7 @@ function validateUseCases(source, registry) {
           source,
           details: {
             holder: `the ${part} of use case "${entry.name}"`,
-            reference: `${isEntityClass2(record) ? "entity" : "record"} "${record.name}"`
+            reference: `${isEntityClass2(record) ? "entity" : "record"} "${recordNameOf2(record)}"`
           }
         });
       }
@@ -3795,7 +3936,7 @@ function validateUseCases(source, registry) {
           source,
           details: {
             holder,
-            reference: `${isEntityClass2(step.build) ? "entity" : "record"} "${step.build.name}"`
+            reference: `${isEntityClass2(step.build) ? "entity" : "record"} "${recordNameOf2(step.build)}"`
           }
         });
       }
@@ -3881,7 +4022,7 @@ function fieldDescriptionOf(field, scope) {
     const ref = entity ?? scope.records.get(record.record);
     return {
       kind: entity === undefined ? "record" : "entity",
-      ref: ref ?? record.record.name,
+      ref: ref ?? recordNameOf2(record.record),
       optional: record.optional
     };
   }
@@ -4353,6 +4494,14 @@ function applicationOf2(settings) {
       }
       return boundUseCaseOf.get(useCase);
     },
+    async run(useCase, input = {}, options) {
+      if (!boundUseCaseOf.has(useCase)) {
+        invalid7(name, "Expected a use case registered in the application.");
+      }
+      const Bound = boundUseCaseOf.get(useCase);
+      const instance = options?.context === undefined ? new Bound(input) : new Bound(input, { context: options.context });
+      return instance.execute(options?.dependencies);
+    },
     command(command) {
       if (!boundCommandOf.has(command)) {
         invalid7(name, "Expected a command registered in the application.");
@@ -4763,7 +4912,7 @@ var openapi2 = sinkOf2({
     const models = {};
     const classes = new Map;
     for (const record of records) {
-      const name = record.name;
+      const name = recordNameOf2(record);
       if (!/^[A-Za-z0-9._-]+$/.test(name) || name === "Problem") {
         invalid8(`The record class "${name}" cannot be a component name; give the class a name that is not "Problem".`);
       }
@@ -5539,4 +5688,4 @@ var entityOf2 = entityBuilderOf2({
 var recordOf2 = recordBuilderOf2(StdRecordPlugins2);
 // src/std/stages.ts
 var StdStages2 = stageCatalogOf2(select2, openapi2);
-export { InvalidEnvironment2, environmentOf2, isEnvironment2, guard2, InvalidApplicationDeclaration2, DuplicateApplicationDeclaration2, ApplicationConflict2, UnregisteredApplicationReference2, UnregisteredRepositoryDependency2, UnregisteredUseCaseDependency2, ApplicationNotStarted2, ProviderNotBound2, ApplicationAlreadyStarted2, InvalidApplicationEnvironment2, useApplication2, resetApplication2, InvalidLogDeclaration2, LogLevels2, logProviderOf2, consoleLogProvider2, jsonLogProvider2, memoryLogProvider2, Logger2, ReservedEntityKey2, ImmutableEntityKey2, DeletedEntity2, entityBuilderOf2, isEntityClass2, isEntity2, eventOf2, ENTITY_IDENTITY_KEYS2, RESERVED_ENTITY_KEYS2, EntityUniqueKeys2, AbstractEntity2, InvalidRepositoryQuery2, InvalidRepositoryDeclaration2, InvalidRepositoryEntity2, InvalidRepositoryData2, RepositoryUniqueViolation2, RepositoryEntityNotFound2, providerOf2, providerDescriptionOf2, inMemoryProvider2, AbstractRepository2, repositoryOf2, RepositoryOf2, isRepository2, InvalidUseCaseStep2, InvalidUseCaseDeclaration2, UseCaseAlreadyExecuted2, InvalidUseCaseDependencies2, AbstractUseCase2, useCaseOf2, isUseCaseClass2, isUseCase2, InvalidCommandDeclaration2, UnknownCommandOperation2, InvalidCommandContext2, InvalidCommandEnvironment2, CommandEventFailed2, commandOf2, isCommand2, InvalidOpenAPIModel2, InvalidOutputStage2, DuplicateOperation2, toOpenAPI2, transformOf2, sinkOf2, stageDescriptionOf2, stageKindOf2, stageCatalogOf2, operationOf2, outputOf2, isOutput2, providerFrom2, logFrom2, isLogFactory2, isProviderFactory2, providersOf2, isProviderSlot2, isProviderStorage2, isApplication2, applicationOf2, blueprintPluginOf2, statusOf2, PROBLEM_MEDIA_TYPE2, problemOf2, outputValueOf2, routeOptionsIssue2, operationRoutes2, openapi2, select2, recordPluginCatalogOf2, Email2, Phone2, Url2, Ip2, enumOf2, SchemaProperty2, PasswordHasherRequired2, SyncVerifyUnsupported2, configure2, resetRuntime2, Id2, Slug2, PASSWORD_MIN_LENGTH2, PASSWORD_MAX_LENGTH2, PASSWORD_SPECIAL_CHARACTERS2, isPasswordHash2, passwordIssues2, Password2, StringProperty2, Text2, NumberProperty2, Integer2, BooleanProperty2, DateTime2, DateProperty2, CreatedAt2, UpdatedAt2, DeletedAt2, Std2, blueprintOf2, Publishable2, Archivable2, Taggable2, Ownable2, Authenticatable2, StdRecordPlugins2, entityOf2, recordOf2, StdStages2 };
+export { InvalidEnvironment2, environmentOf2, isEnvironment2, guard2, InvalidApplicationDeclaration2, DuplicateApplicationDeclaration2, ApplicationConflict2, UnregisteredApplicationReference2, UnregisteredRepositoryDependency2, UnregisteredUseCaseDependency2, ApplicationNotStarted2, ProviderNotBound2, ApplicationAlreadyStarted2, InvalidApplicationEnvironment2, useApplication2, resetApplication2, InvalidLogDeclaration2, LogLevels2, logProviderOf2, consoleLogProvider2, jsonLogProvider2, memoryLogProvider2, Logger2, ReservedEntityKey2, ImmutableEntityKey2, DeletedEntity2, entityBuilderOf2, isEntityClass2, isEntity2, eventOf2, ENTITY_IDENTITY_KEYS2, RESERVED_ENTITY_KEYS2, EntityUniqueKeys2, AbstractEntity2, InvalidRepositoryQuery2, InvalidRepositoryCursor2, InvalidRepositoryDeclaration2, InvalidRepositoryEntity2, InvalidRepositoryData2, RepositoryUniqueViolation2, RepositoryEntityNotFound2, providerOf2, providerDescriptionOf2, inMemoryProvider2, AbstractRepository2, repositoryOf2, RepositoryOf2, isRepository2, InvalidUseCaseStep2, InvalidUseCaseDeclaration2, UseCaseAlreadyExecuted2, InvalidUseCaseDependencies2, AbstractUseCase2, useCaseOf2, isUseCaseClass2, isUseCase2, InvalidCommandDeclaration2, UnknownCommandOperation2, InvalidCommandContext2, InvalidCommandEnvironment2, CommandEventFailed2, commandOf2, isCommand2, InvalidOpenAPIModel2, InvalidOutputStage2, DuplicateOperation2, toOpenAPI2, transformOf2, sinkOf2, stageDescriptionOf2, stageKindOf2, stageCatalogOf2, operationOf2, outputOf2, isOutput2, providerFrom2, logFrom2, isLogFactory2, isProviderFactory2, providersOf2, isProviderSlot2, isProviderStorage2, isApplication2, applicationOf2, blueprintPluginOf2, statusOf2, PROBLEM_MEDIA_TYPE2, problemOf2, outputValueOf2, routeOptionsIssue2, operationRoutes2, openapi2, select2, recordPluginCatalogOf2, Email2, Phone2, Url2, Ip2, enumOf2, SchemaProperty2, PasswordHasherRequired2, SyncVerifyUnsupported2, configure2, resetRuntime2, Id2, Slug2, PASSWORD_MIN_LENGTH2, PASSWORD_MAX_LENGTH2, PASSWORD_SPECIAL_CHARACTERS2, isPasswordHash2, passwordIssues2, Password2, StringProperty2, Text2, NumberProperty2, Integer2, BooleanProperty2, DateTime2, DateProperty2, CreatedAt2, UpdatedAt2, DeletedAt2, Std2, blueprintOf2, Publishable2, Archivable2, Taggable2, Ownable2, Authenticatable2, StdRecordPlugins2, entityOf2, recordOf2, StdStages2 };

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";
@@ -62,22 +62,23 @@ 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 { 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, RepositoryUpdate, } from "./core/repository/types/repository.interface.js";
 export type { SchemaClass } from "./core/schema/schema.js";
 export { schemaOf } from "./core/schema/schema.js";

package/dist/index.js

@@ -34,6 +34,7 @@ import {
   EntityUniqueKeys2,
   AbstractEntity2,
   InvalidRepositoryQuery2,
+  InvalidRepositoryCursor2,
   InvalidRepositoryDeclaration2,
   InvalidRepositoryEntity2,
   InvalidRepositoryData2,
@@ -131,7 +132,7 @@ import {
   entityOf2,
   recordOf2,
   StdStages2
-} from "./index-8m80wjzf.js";
+} from "./index-gbgc40xe.js";
 import {
   isProperty2,
   schemaOf2,
@@ -142,6 +143,7 @@ import {
   isRecordClass2,
   isOptionalRecord2,
   recordFieldOf2,
+  recordNameOf2,
   listOf2,
   isBlueprintList2,
   ExceptionLayers2,
@@ -150,6 +152,7 @@ import {
   exceptionOf2,
   Meta2,
   InvalidRecordValue2,
+  InvalidRecordDeclaration2,
   UndeclaredRecordProperty2,
   ReservedRecordKey2,
   InvalidRecordPlugin2,
@@ -175,7 +178,7 @@ import {
   propertyOf2,
   optionalOf2,
   blueprintBuilderOf2
-} from "./index-hn82hm31.js";
+} from "./index-3nd9bjnc.js";
 export {
   AbstractDefineProperty2 as AbstractDefineProperty,
   AbstractEntity2 as AbstractEntity,
@@ -217,8 +220,10 @@ 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,
@@ -333,6 +338,7 @@ export {
   providersOf2 as providersOf,
   recordBuilderOf2 as recordBuilderOf,
   recordFieldOf2 as recordFieldOf,
+  recordNameOf2 as recordNameOf,
   recordOf2 as recordOf,
   recordPluginCatalogOf2 as recordPluginCatalogOf,
   recordPluginOf2 as recordPluginOf,

package/dist/std/properties/password.d.ts

@@ -5,7 +5,11 @@ export declare const PASSWORD_SPECIAL_CHARACTERS = "!@#$%^&*()-_=+[]{}|\\;:'\",.
 export declare function isPasswordHash(value: string): boolean;
 /** The rules a plain password breaks; empty when it is strong enough. */
 export declare function passwordIssues(value: string): string[];
-declare const Password_base: import("../../index.js").PropertyClass<Type.TString, string>;
+declare const Password_base: import("../../index.js").PropertyClass<Type.TString, string> & {
+    readonly type: {
+        readonly sensitive: true;
+    };
+};
 /**
  * A password stored as an Argon2 hash. The constructor only accepts a hash,
  * e.g. one read from the database; `Password.hash` turns a plain password

package/dist/std/record-plugins.d.ts

@@ -6,7 +6,7 @@ declare const PublishableRecord_base: import("../index.js").RecordConstructor<im
         safeParse(value: unknown): import("../index.js").ParseResult<string | undefined>;
         readonly "~standard": import("../index.js").StandardSchemaV1.Props<string | undefined, string | undefined>;
     }>;
-}>, [], never, unknown>;
+}>, [], never, unknown, never, never>;
 /**
  * A `publishedAt` absent while the record is a draft; `publish(at?)` sets it
  * (to now by default), `unpublish()` clears it, `isPublished` tells.
@@ -30,7 +30,7 @@ declare const ArchivableRecord_base: import("../index.js").RecordConstructor<imp
         safeParse(value: unknown): import("../index.js").ParseResult<string | undefined>;
         readonly "~standard": import("../index.js").StandardSchemaV1.Props<string | undefined, string | undefined>;
     }>;
-}>, [], never, unknown>;
+}>, [], never, unknown, never, never>;
 /**
  * An `archivedAt` absent while the record is active; `archive(at?)` sets it,
  * `restore()` clears it, `isArchived` tells.
@@ -49,7 +49,7 @@ export declare class ArchivableRecord extends ArchivableRecord_base {
 export declare const Archivable: import("../index.js").IRecordPlugin<typeof ArchivableRecord, "archivable">;
 declare const TaggableRecord_base: import("../index.js").RecordConstructor<import("../core/property/types/property-options.interface.js").StoredFields<{
     tags: import("../index.js").IBlueprintList<import("../index.js").PropertyClass<import("typebox").TString, string>, true>;
-}>, [], never, unknown>;
+}>, [], never, unknown, never, never>;
 /**
  * `tags`, a list of strings, each once; `tag`, `untag` and `hasTag` change and read it.
  *
@@ -67,7 +67,7 @@ export declare class TaggableRecord extends TaggableRecord_base {
 export declare const Taggable: import("../index.js").IRecordPlugin<typeof TaggableRecord, "taggable">;
 declare const OwnableRecord_base: import("../index.js").RecordConstructor<import("../core/property/types/property-options.interface.js").StoredFields<{
     ownerId: import("../index.js").CallableProperty<typeof import("../index.js").Id>;
-}>, [], never, unknown>;
+}>, [], never, unknown, never, never>;
 /**
  * An `ownerId`, the id of who owns the record, with `isOwnedBy` and `transferTo`.
  *
@@ -84,7 +84,7 @@ export declare const Ownable: import("../index.js").IRecordPlugin<typeof Ownable
 declare const AuthenticatableRecord_base: import("../index.js").RecordConstructor<import("../core/property/types/property-options.interface.js").StoredFields<{
     email: import("../index.js").CallableProperty<import("../index.js").PropertyClass<import("typebox").TString, string>>;
     password: import("../index.js").CallableProperty<typeof Password>;
-}>, readonly ["password"], "email", unknown>;
+}>, readonly ["password"], "email", unknown, never, never>;
 /**
  * An `email`, unique, and a `password` hash, sensitive, changed by
  * `change.password` and checked by `verifyPassword`.