@lakutata/core 1.0.60 → 3.0.0-beta.0

package/dist/cjs/lib/validation/messages/zh-TW.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * The messages of the validation errors in Chinese (Traditional) (zh-TW), by their codes
+ */
+const messages = {
+    'bigint.base': '{{#label}} 必須是 bigint',
+    'bigint.greater': '{{#label}} 必須大於 {{#limit}}',
+    'bigint.less': '{{#label}} 必須小於 {{#limit}}',
+    'bigint.max': '{{#label}} 必須小於或等於 {{#limit}}',
+    'bigint.min': '{{#label}} 必須大於或等於 {{#limit}}',
+    'bigint.multiple': '{{#label}} 必須是 {{#base}} 的倍數',
+    'bigint.negative': '{{#label}} 必須是負數',
+    'bigint.port': '{{#label}} 必須是有效的連接埠',
+    'bigint.positive': '{{#label}} 必須是正數',
+    'alternatives.all': '{{#label}} 未符合所有必要的型別',
+    'alternatives.any': '{{#label}} 未符合任何允許的型別',
+    'alternatives.match': '{{#label}} 未符合任何允許的型別',
+    'alternatives.none': '{{#label}} 符合了不允許的型別',
+    'alternatives.one': '{{#label}} 符合了多個允許的型別',
+    'alternatives.types': '{{#label}} 必須是下列型別之一：{{#types}}',
+    'any.custom': '{{#label}} 未通過自訂驗證，原因：{{#error.message}}',
+    'any.default': '{{#label}} 執行預設值方法時發生錯誤',
+    'any.failover': '{{#label}} 執行備援值方法時發生錯誤',
+    'any.invalid': '{{#label}} 包含無效的值',
+    'any.only': '{{#label}} 必須是{if(#valids.length == 1, "", "下列值之一：")}{{#valids}}',
+    'any.ref': '{{#label}} 的 {{#arg}} 參照的 {{:#ref}} 無效：{{#reason}}',
+    'any.required': '{{#label}} 為必填欄位',
+    'any.unknown': '不允許出現 {{#label}}',
+    'array.base': '{{#label}} 必須是陣列',
+    'array.excludes': '{{#label}} 包含被排除的值',
+    'array.hasKnown': '{{#label}} 中沒有至少一個符合型別 {:#patternLabel} 的項目',
+    'array.hasMax': '{{#label}} 中符合要求的項目最多 {{#max}} 個',
+    'array.hasMin': '{{#label}} 中符合要求的項目至少 {{#min}} 個',
+    'array.hasUnknown': '{{#label}} 中沒有至少一個符合要求的項目',
+    'array.includes': '{{#label}} 未符合任何允許的型別',
+    'array.includesRequiredBoth': '{{#label}} 缺少 {{#knownMisses}} 以及另外 {{#unknownMisses}} 個必要的值',
+    'array.includesRequiredKnowns': '{{#label}} 缺少 {{#knownMisses}}',
+    'array.includesRequiredUnknowns': '{{#label}} 缺少 {{#unknownMisses}} 個必要的值',
+    'array.length': '{{#label}} 必須包含 {{#limit}} 個項目',
+    'array.max': '{{#label}} 最多包含 {{#limit}} 個項目',
+    'array.min': '{{#label}} 至少包含 {{#limit}} 個項目',
+    'array.orderedLength': '{{#label}} 最多包含 {{#limit}} 個項目',
+    'array.sort': '{{#label}} 必須依 {{#by}} 以 {#order} 順序排列',
+    'array.sort.mismatching': '{{#label}} 的型別不一致，無法排序',
+    'array.sort.unsupported': '{{#label}} 無法排序，不支援型別 {#type}',
+    'array.sparse': '{{#label}} 不能是稀疏陣列的項目',
+    'array.unique': '{{#label}} 包含重複的值',
+    'binary.base': '{{#label}} 必須是 Buffer 或字串',
+    'binary.length': '{{#label}} 必須是 {{#limit}} 位元組',
+    'binary.max': '{{#label}} 必須小於或等於 {{#limit}} 位元組',
+    'binary.min': '{{#label}} 至少為 {{#limit}} 位元組',
+    'boolean.base': '{{#label}} 必須是布林值',
+    'date.base': '{{#label}} 必須是有效的日期',
+    'date.format': '{{#label}} 必須是{msg("date.format." + #format) || #format}格式',
+    'date.greater': '{{#label}} 必須晚於 {{:#limit}}',
+    'date.less': '{{#label}} 必須早於 {{:#limit}}',
+    'date.max': '{{#label}} 必須早於或等於 {{:#limit}}',
+    'date.min': '{{#label}} 必須晚於或等於 {{:#limit}}',
+    'date.format.iso': 'ISO 8601 日期',
+    'date.format.javascript': '時間戳記或毫秒數',
+    'date.format.unix': '時間戳記或秒數',
+    'function.arity': '{{#label}} 的參數個數必須是 {{#n}}',
+    'function.class': '{{#label}} 必須是類別',
+    'function.maxArity': '{{#label}} 的參數個數必須小於或等於 {{#n}}',
+    'function.minArity': '{{#label}} 的參數個數必須大於或等於 {{#n}}',
+    'object.and': '{{#label}} 包含 {{#presentWithLabels}}，但缺少必須同時出現的 {{#missingWithLabels}}',
+    'object.assert': '{{#label}} 無效，因為{if(#subject.key, `"` + #subject.key + `" 未能` + (#message || "通過斷言檢查"), #message || "斷言失敗")}',
+    'object.base': '{{#label}} 必須是 {{#type}} 型別',
+    'object.instance': '{{#label}} 必須是 {{:#type}} 的執行個體',
+    'object.keyNames': '{{#label}} 的鍵名 "{{#name}}" 不被允許',
+    'object.length': '{{#label}} 必須有 {{#limit}} 個鍵',
+    'object.max': '{{#label}} 最多有 {{#limit}} 個鍵',
+    'object.min': '{{#label}} 至少有 {{#limit}} 個鍵',
+    'object.missing': '{{#label}} 必須至少包含 {{#peersWithLabels}} 其中之一',
+    'object.nand': '{{:#mainWithLabel}} 不能與 {{#peersWithLabels}} 同時存在',
+    'object.oxor': '{{#label}} 中選填的互斥項目 {{#peersWithLabels}} 發生衝突',
+    'object.pattern.match': '{{#label}} 的鍵不符合模式要求',
+    'object.refType': '{{#label}} 必須是參照',
+    'object.regex': '{{#label}} 必須是 RegExp 物件',
+    'object.rename.multiple': '{{#label}} 無法重新命名 {{:#from}}，因為不允許多次重新命名，且已有另一個鍵重新命名為 {{:#to}}',
+    'object.rename.override': '{{#label}} 無法重新命名 {{:#from}}，因為不允許覆寫，且目標 {{:#to}} 已存在',
+    'object.schema': '{{#label}} 必須是 {{#type}} 型別的 schema',
+    'object.unknown': '不允許出現 {{#label}}',
+    'object.with': '{{:#mainWithLabel}} 缺少必須同時出現的 {{:#peerWithLabel}}',
+    'object.without': '{{:#mainWithLabel}} 與禁止同時出現的 {{:#peerWithLabel}} 衝突',
+    'object.xor': '{{#label}} 中互斥的項目 {{#peersWithLabels}} 發生衝突',
+    'number.base': '{{#label}} 必須是數字',
+    'number.float': '{{#label}} 必須是有效的 Float 值（介於 {{#min}} 和 {{#max}} 之間）',
+    'number.greater': '{{#label}} 必須大於 {{#limit}}',
+    'number.infinity': '{{#label}} 不能是無限大',
+    'number.int8': '{{#label}} 必須是有效的 Int8 值（介於 -128 和 127 之間）',
+    'number.int16': '{{#label}} 必須是有效的 Int16 值（介於 -32768 和 32767 之間）',
+    'number.int32': '{{#label}} 必須是有效的 Int32 值（介於 -2147483648 和 2147483647 之間）',
+    'number.int64': '{{#label}} 必須是有效的 Int64 值（介於 -9007199254740991 和 9007199254740991 之間，即 JavaScript 的安全整數）',
+    'number.integer': '{{#label}} 必須是整數',
+    'number.less': '{{#label}} 必須小於 {{#limit}}',
+    'number.max': '{{#label}} 必須小於或等於 {{#limit}}',
+    'number.min': '{{#label}} 必須大於或等於 {{#limit}}',
+    'number.multiple': '{{#label}} 必須是 {{#multiple}} 的倍數',
+    'number.negative': '{{#label}} 必須是負數',
+    'number.port': '{{#label}} 必須是有效的連接埠',
+    'number.positive': '{{#label}} 必須是正數',
+    'number.precision': '{{#label}} 的小數位數不能超過 {{#limit}} 位',
+    'number.uint8': '{{#label}} 必須是有效的 UInt8 值（介於 0 和 255 之間）',
+    'number.uint16': '{{#label}} 必須是有效的 UInt16 值（介於 0 和 65535 之間）',
+    'number.uint32': '{{#label}} 必須是有效的 UInt32 值（介於 0 和 4294967295 之間）',
+    'number.uint64': '{{#label}} 必須是有效的 UInt64 值（介於 0 和 9007199254740991 之間，即 JavaScript 的安全整數）',
+    'number.unsafe': '{{#label}} 必須是安全的數字',
+    'string.alphanum': '{{#label}} 只能包含英文字母和數字',
+    'string.base': '{{#label}} 必須是字串',
+    'string.base64': '{{#label}} 必須是有效的 base64 字串',
+    'string.creditCard': '{{#label}} 必須是信用卡號碼',
+    'string.dataUri': '{{#label}} 必須是有效的 data URI 字串',
+    'string.domain': '{{#label}} 必須包含有效的網域名稱',
+    'string.email': '{{#label}} 必須是有效的電子郵件地址',
+    'string.empty': '{{#label}} 不能為空',
+    'string.format': '{{#label}} 必須是有效的 {{#format}}',
+    'string.guid': '{{#label}} 必須是有效的 GUID',
+    'string.hex': '{{#label}} 只能包含十六進位字元',
+    'string.hexAlign': '{{#label}} 的十六進位解碼結果必須以位元組對齊',
+    'string.hostname': '{{#label}} 必須是有效的主機名稱',
+    'string.ip': '{{#label}} 必須是 CIDR 為 {{#cidr}} 的有效 IP 位址',
+    'string.ipVersion': '{{#label}} 必須是下列版本之一的有效 IP 位址：{{#version}}，CIDR 為 {{#cidr}}',
+    'string.isoDate': '{{#label}} 必須是 ISO 格式',
+    'string.isoDuration': '{{#label}} 必須是有效的 ISO 8601 期間',
+    'string.length': '{{#label}} 的長度必須是 {{#limit}} 個字元',
+    'string.lowercase': '{{#label}} 只能包含小寫字母',
+    'string.max': '{{#label}} 的長度不能超過 {{#limit}} 個字元',
+    'string.min': '{{#label}} 的長度至少為 {{#limit}} 個字元',
+    'string.normalize': '{{#label}} 必須是 {{#form}} 形式的 Unicode 正規化字串',
+    'string.token': '{{#label}} 只能包含英文字母、數字和底線',
+    'string.pattern.base': '{{#label}} 的值 {:[.]} 不符合要求的模式：{{#regex}}',
+    'string.pattern.name': '{{#label}} 的值 {:[.]} 不符合 {{#name}} 模式',
+    'string.pattern.invert.base': '{{#label}} 的值 {:[.]} 符合了反向模式：{{#regex}}',
+    'string.pattern.invert.name': '{{#label}} 的值 {:[.]} 符合了反向的 {{#name}} 模式',
+    'string.trim': '{{#label}} 的開頭和結尾不能有空白字元',
+    'string.uri': '{{#label}} 必須是有效的 URI',
+    'string.uriCustomScheme': '{{#label}} 必須是 scheme 符合 {{#scheme}} 模式的有效 URI',
+    'string.uriRelativeOnly': '{{#label}} 必須是有效的相對 URI',
+    'string.uppercase': '{{#label}} 只能包含大寫字母',
+    'symbol.base': '{{#label}} 必須是 symbol',
+    'symbol.map': '{{#label}} 必須是下列值之一：{{#map}}'
+};
+exports.default = messages;

package/dist/cjs/lib/validation/types/BasicType.d.ts

@@ -0,0 +1,4 @@
+/**
+ * The literal values a default value may be: a primitive, an array, an object or null.
+ */
+export type BasicType = boolean | number | string | any[] | object | null;

package/dist/cjs/lib/validation/types/BasicType.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/ComparatorFunction.d.ts

@@ -0,0 +1,4 @@
+/**
+ * A function telling whether two array items are duplicates (true: duplicates), given to `ArraySchema.unique()`.
+ */
+export type ComparatorFunction = (a: any, b: any) => boolean;

package/dist/cjs/lib/validation/types/ComparatorFunction.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/CustomValidator.d.ts

@@ -0,0 +1,9 @@
+import { CustomHelpers } from '../interfaces/CustomHelpers.js';
+import { ErrorReport } from '../interfaces/ErrorReport.js';
+/**
+ * A custom validation rule given to `custom()`. It receives the value (converted by the previous rules) and the helpers
+ * of the validation, and returns the value to keep (a new one replaces it; undefined keeps it unchanged), or the error
+ * returned by `helpers.error(code, context)` or `helpers.message(messages)`. An error it throws fails the validation
+ * with the code `any.custom` and the error message.
+ */
+export type CustomValidator<V = any, R = V> = (value: V, helpers: CustomHelpers<R>) => R | ErrorReport;

package/dist/cjs/lib/validation/types/CustomValidator.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/ExtensionBoundSchema.d.ts

@@ -0,0 +1,2 @@
+import { Schema } from './Schema.js';
+export type ExtensionBoundSchema = Schema;

package/dist/cjs/lib/validation/types/ExtensionBoundSchema.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/ExternalValidationFunction.d.ts

@@ -0,0 +1,8 @@
+import { ExternalHelpers } from '../interfaces/ExternalHelpers.js';
+/**
+ * An external validation rule given to `external()`, which may be asynchronous (a database lookup): it runs after all
+ * the other rules passed, in `DTO.validateAsync()` only. It returns the value to keep (undefined keeps it unchanged) or
+ * the error returned by `helpers.error()` / `helpers.message()`; an error it throws ends the validation with its
+ * message, followed by the label of the value.
+ */
+export type ExternalValidationFunction<V = any, R = V> = (value: V, helpers: ExternalHelpers<R>) => R | undefined;

package/dist/cjs/lib/validation/types/ExternalValidationFunction.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/IsNonPrimitiveSubsetUnion.d.ts

@@ -0,0 +1,3 @@
+import { IsUnion } from './IsUnion.js';
+import { IsPrimitiveSubset } from './IsPrimitiveSubset.js';
+export type IsNonPrimitiveSubsetUnion<T> = true extends IsUnion<T> ? true extends IsPrimitiveSubset<T> ? false : true : false;

package/dist/cjs/lib/validation/types/IsNonPrimitiveSubsetUnion.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/IsPrimitiveSubset.d.ts

@@ -0,0 +1,3 @@
+export type IsPrimitiveSubset<T> = [
+    T
+] extends [string] ? true : [T] extends [number] ? true : [T] extends [bigint] ? true : [T] extends [boolean] ? true : [T] extends [symbol] ? true : [T] extends [null] ? true : [T] extends [undefined] ? true : false;

package/dist/cjs/lib/validation/types/IsPrimitiveSubset.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/IsUnion.d.ts

@@ -0,0 +1 @@
+export type IsUnion<T, U extends T = T> = T extends unknown ? [U] extends [T] ? false : true : false;

package/dist/cjs/lib/validation/types/IsUnion.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/LanguageMessages.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Error message templates by error code (`{'any.required': '{{#label}} is required'}`), or by language then error code
+ * (`{fr: {'any.required': '{{#label}} est requis'}}`).
+ */
+export type LanguageMessages = Record<string, string | Record<string, string>>;

package/dist/cjs/lib/validation/types/LanguageMessages.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/NoNestedArrays.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The tuple `T` when none of its items is an array, else `never`: rejects the nested arrays of schemas given to
+ * `ArraySchema.items()`.
+ */
+export type NoNestedArrays<T extends readonly unknown[]> = Extract<T[number], readonly unknown[]> extends never ? T : never;

package/dist/cjs/lib/validation/types/NoNestedArrays.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/NullableType.d.ts

@@ -0,0 +1 @@
+export type NullableType<T> = undefined | null | T;

package/dist/cjs/lib/validation/types/NullableType.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/ObjectPropertiesSchema.d.ts

@@ -0,0 +1,12 @@
+import { AlternativesSchema } from '../interfaces/AlternativesSchema.js';
+import { StringSchema } from '../interfaces/StringSchema.js';
+import { NumberSchema } from '../interfaces/NumberSchema.js';
+import { BooleanSchema } from '../interfaces/BooleanSchema.js';
+import { DateSchema } from '../interfaces/DateSchema.js';
+import { BinarySchema } from '../interfaces/BinarySchema.js';
+import { ArraySchema } from '../interfaces/ArraySchema.js';
+import { StrictSchemaMap } from './StrictSchemaMap.js';
+import { ObjectSchema } from '../interfaces/ObjectSchema.js';
+import { IsNonPrimitiveSubsetUnion } from './IsNonPrimitiveSubsetUnion.js';
+import { NullableType } from './NullableType.js';
+export type ObjectPropertiesSchema<T = any> = true extends IsNonPrimitiveSubsetUnion<Exclude<T, undefined | null>> ? AlternativesSchema : T extends NullableType<string> ? StringSchema : T extends NullableType<number> ? NumberSchema : T extends NullableType<bigint> ? NumberSchema : T extends NullableType<boolean> ? BooleanSchema : T extends NullableType<Date> ? DateSchema : T extends NullableType<Buffer> ? BinarySchema : T extends NullableType<Array<any>> ? ArraySchema : T extends NullableType<object> ? (StrictSchemaMap<T> | ObjectSchema<T>) : never;

package/dist/cjs/lib/validation/types/ObjectPropertiesSchema.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/PartialSchemaMap.d.ts

@@ -0,0 +1,4 @@
+import { SchemaLike } from './SchemaLike.js';
+export type PartialSchemaMap<TSchema = any> = {
+    [key in keyof TSchema]?: SchemaLike | SchemaLike[];
+};

package/dist/cjs/lib/validation/types/PartialSchemaMap.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/PresenceMode.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Whether a value may be missing (`optional`), must be present (`required`) or must be missing (`forbidden`).
+ */
+export type PresenceMode = 'optional' | 'required' | 'forbidden';

package/dist/cjs/lib/validation/types/PresenceMode.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/Primitives.d.ts

@@ -0,0 +1,4 @@
+/**
+ * The primitive values a schema method accepts as a literal schema (a value which is the only one allowed).
+ */
+export type Primitives = string | number | boolean | bigint | symbol | null;

package/dist/cjs/lib/validation/types/Primitives.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/Schema.d.ts

@@ -0,0 +1,17 @@
+import { AnySchema } from '../interfaces/AnySchema.js';
+import { ArraySchema } from '../interfaces/ArraySchema.js';
+import { AlternativesSchema } from '../interfaces/AlternativesSchema.js';
+import { BinarySchema } from '../interfaces/BinarySchema.js';
+import { BooleanSchema } from '../interfaces/BooleanSchema.js';
+import { DateSchema } from '../interfaces/DateSchema.js';
+import { FunctionSchema } from '../interfaces/FunctionSchema.js';
+import { NumberSchema } from '../interfaces/NumberSchema.js';
+import { ObjectSchema } from '../interfaces/ObjectSchema.js';
+import { StringSchema } from '../interfaces/StringSchema.js';
+import { LinkSchema } from '../interfaces/LinkSchema.js';
+import { SymbolSchema } from '../interfaces/SymbolSchema.js';
+/**
+ * Any schema built by the `DTO` builders (`DTO.String()`, `DTO.Object()`, …): what `DTO.validate()`, `@Expect()` and
+ * the other validation APIs accept. `P` is the type of the values it validates.
+ */
+export type Schema<P = any> = AnySchema<P> | ArraySchema<P> | AlternativesSchema<P> | BinarySchema<P> | BooleanSchema<P> | DateSchema<P> | FunctionSchema<P> | NumberSchema<P> | ObjectSchema<P> | StringSchema<P> | LinkSchema<P> | SymbolSchema<P>;

package/dist/cjs/lib/validation/types/Schema.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/SchemaFunction.d.ts

@@ -0,0 +1,6 @@
+import { Schema } from './Schema.js';
+/**
+ * A function receiving a schema and returning a schema derived from it, like `(schema) => schema.required()` (used by
+ * `fork()`).
+ */
+export type SchemaFunction = (schema: Schema) => Schema;

package/dist/cjs/lib/validation/types/SchemaFunction.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/SchemaLike.d.ts

@@ -0,0 +1,6 @@
+import { SchemaLikeWithoutArray } from './SchemaLikeWithoutArray.js';
+/**
+ * What the schema methods accept in place of a schema: a schema, a literal value (allowed as the only valid value), an
+ * object of schemas by key (an object schema) or an array of them (alternatives).
+ */
+export type SchemaLike<T = any> = SchemaLikeWithoutArray<T> | object;

package/dist/cjs/lib/validation/types/SchemaLike.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/SchemaLikeWithoutArray.d.ts

@@ -0,0 +1,7 @@
+import { Schema } from './Schema.js';
+import { SchemaMap } from './SchemaMap.js';
+import { Primitives } from './Primitives.js';
+/**
+ * A `SchemaLike` other than an array: a schema, a primitive literal value, or an object of schemas by key.
+ */
+export type SchemaLikeWithoutArray<TSchema = any> = Exclude<Primitives | Schema<TSchema> | SchemaMap<TSchema>, any[]>;

package/dist/cjs/lib/validation/types/SchemaLikeWithoutArray.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/SchemaMap.d.ts

@@ -0,0 +1,7 @@
+import { PartialSchemaMap } from './PartialSchemaMap.js';
+import { StrictSchemaMap } from './StrictSchemaMap.js';
+/**
+ * The schemas of the keys of an object, by key: the argument of `DTO.Object()` and `ObjectSchema.keys()`. With
+ * `isStrict`, every key of `TSchema` must have a schema of the matching type.
+ */
+export type SchemaMap<TSchema = any, isStrict = false> = isStrict extends true ? StrictSchemaMap<TSchema> : PartialSchemaMap<TSchema>;

package/dist/cjs/lib/validation/types/SchemaMap.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/StrictSchemaMap.d.ts

@@ -0,0 +1,4 @@
+import { ObjectPropertiesSchema } from './ObjectPropertiesSchema.js';
+export type StrictSchemaMap<TSchema = any> = {
+    [key in keyof TSchema]-?: ObjectPropertiesSchema<TSchema[key]>;
+};

package/dist/cjs/lib/validation/types/StrictSchemaMap.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/Types.d.ts

@@ -0,0 +1,4 @@
+/**
+ * The type names of the schemas (the `type` of a schema).
+ */
+export type Types = 'any' | 'alternatives' | 'array' | 'boolean' | 'binary' | 'date' | 'function' | 'link' | 'number' | 'object' | 'string' | 'symbol';

package/dist/cjs/lib/validation/types/Types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/UnwrapSchemaLikeWithoutArray.d.ts

@@ -0,0 +1,5 @@
+import { SchemaLikeWithoutArray } from './SchemaLikeWithoutArray.js';
+/**
+ * The type of the values validated by a `SchemaLikeWithoutArray` (`never` when it cannot be inferred).
+ */
+export type UnwrapSchemaLikeWithoutArray<T> = T extends SchemaLikeWithoutArray<infer U> ? U : never;

package/dist/cjs/lib/validation/types/UnwrapSchemaLikeWithoutArray.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/lib/validation/types/ValidationErrorFunction.d.ts

@@ -0,0 +1,7 @@
+import { ErrorReport } from '../interfaces/ErrorReport.js';
+import { ValidationErrorItem } from '../interfaces/ValidationErrorItem.js';
+/**
+ * A function replacing the errors of a schema (given to `error()`): it receives the error reports and returns the new
+ * message, an error item or the error reports, or an `Error` to throw as is.
+ */
+export type ValidationErrorFunction = (errors: ErrorReport[]) => string | ValidationErrorItem | Error | ErrorReport[];

package/dist/cjs/lib/validation/types/ValidationErrorFunction.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/options/ApplicationOptions.d.ts

@@ -0,0 +1,60 @@
+import { ModuleOptions } from './ModuleOptions.js';
+/**
+ * The options of an application, given to `Application.run()`: its identity (`id`, `name`), its time zone, mode and
+ * shutdown signals, and the objects it declares, as a module does (see {@link ModuleOptions}). They are validated at
+ * launch: invalid options are a fatal exception.
+ * @example
+ * ```typescript
+ * import {Application, type ApplicationOptions, Component} from 'lakutata'
+ *
+ * class Clock extends Component {
+ * }
+ *
+ * const options: ApplicationOptions = {
+ *     id: 'clock.app',
+ *     name: 'Clock',
+ *     timezone: 'Europe/Paris',
+ *     mode: 'production',
+ *     shutdownSignals: ['SIGTERM'],
+ *     components: {
+ *         clock: {class: Clock}
+ *     },
+ *     bootstrap: ['clock']
+ * }
+ *
+ * Application.run(options)
+ * ```
+ */
+export declare class ApplicationOptions extends ModuleOptions {
+    /**
+     * The ID of the application (`'shop.app'`): the `process.title`, read by `Application.appId` and stamped on the
+     * exceptions. Required.
+     */
+    readonly id: string;
+    /**
+     * The name of the application (`'Shop'`), read by `Application.appName`, written in the logs and stamped on the
+     * exceptions. Required.
+     */
+    readonly name: string;
+    /**
+     * The time zone of the process (an IANA name such as `'Asia/Shanghai'`, written to the `TZ` environment
+     * variable), or `'auto'` for the system's. An unknown time zone is warned of and replaced with the system's.
+     * @default 'auto'
+     */
+    readonly timezone?: string | 'auto';
+    /**
+     * The mode the application runs in (`development` or `production`) when the environment gives none: the `MODE`
+     * environment variable, then `NODE_ENV`, override it. The mode is written to both variables.
+     * @default 'development'
+     */
+    readonly mode?: 'development' | 'production';
+    /**
+     * The signals ending the application gracefully: its done handler runs (the application still working), its
+     * entrypoints stop (the requests running complete), its objects are destroyed, then it exits with the code 0. A second signal, or a signal received while
+     * the application launches, ends the process at once with the code 128 + the number of the signal (143 for SIGTERM,
+     * 130 for SIGINT). SIGTERM and SIGINT by default (docker stop, the rolling updates of Kubernetes, systemd, Ctrl+C);
+     * false: the signals are not handled by the application (Node.js ends the process at once).
+     * @default ['SIGTERM', 'SIGINT']
+     */
+    readonly shutdownSignals?: false | NodeJS.Signals[];
+}

package/dist/cjs/options/ApplicationOptions.js

@@ -0,0 +1,75 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApplicationOptions = void 0;
+const node_os_1 = require("node:os");
+const ModuleOptions_js_1 = require("./ModuleOptions.js");
+const Expect_js_1 = require("../decorators/dto/Expect.js");
+const DTO_js_1 = require("../lib/dto/DTO.js");
+/**
+ * The signals a process can listen to (SIGKILL and SIGSTOP cannot be caught)
+ */
+const CATCHABLE_SIGNALS = Object.keys(node_os_1.constants.signals).filter((signal) => signal !== 'SIGKILL' && signal !== 'SIGSTOP');
+/**
+ * The options of an application, given to `Application.run()`: its identity (`id`, `name`), its time zone, mode and
+ * shutdown signals, and the objects it declares, as a module does (see {@link ModuleOptions}). They are validated at
+ * launch: invalid options are a fatal exception.
+ * @example
+ * ```typescript
+ * import {Application, type ApplicationOptions, Component} from 'lakutata'
+ *
+ * class Clock extends Component {
+ * }
+ *
+ * const options: ApplicationOptions = {
+ *     id: 'clock.app',
+ *     name: 'Clock',
+ *     timezone: 'Europe/Paris',
+ *     mode: 'production',
+ *     shutdownSignals: ['SIGTERM'],
+ *     components: {
+ *         clock: {class: Clock}
+ *     },
+ *     bootstrap: ['clock']
+ * }
+ *
+ * Application.run(options)
+ * ```
+ */
+class ApplicationOptions extends ModuleOptions_js_1.ModuleOptions {
+}
+exports.ApplicationOptions = ApplicationOptions;
+__decorate([
+    (0, Expect_js_1.Expect)(DTO_js_1.DTO.String().required()),
+    __metadata("design:type", String)
+], ApplicationOptions.prototype, "id", void 0);
+__decorate([
+    (0, Expect_js_1.Expect)(DTO_js_1.DTO.String().required()),
+    __metadata("design:type", String)
+], ApplicationOptions.prototype, "name", void 0);
+__decorate([
+    (0, Expect_js_1.Expect)(DTO_js_1.DTO.String()
+        .optional()
+        .default('auto')),
+    __metadata("design:type", String)
+], ApplicationOptions.prototype, "timezone", void 0);
+__decorate([
+    (0, Expect_js_1.Expect)(DTO_js_1.DTO.String()
+        .valid('development', 'production')
+        .optional()),
+    __metadata("design:type", String)
+], ApplicationOptions.prototype, "mode", void 0);
+__decorate([
+    (0, Expect_js_1.Expect)(DTO_js_1.DTO.Alternatives(DTO_js_1.DTO.Boolean().valid(false), DTO_js_1.DTO.Array(DTO_js_1.DTO.String().valid(...CATCHABLE_SIGNALS)))
+        .optional()
+        .default(() => ['SIGTERM', 'SIGINT'])),
+    __metadata("design:type", Object)
+], ApplicationOptions.prototype, "shutdownSignals", void 0);

package/dist/cjs/options/LoadAnonymousObjectOptions.d.ts

@@ -0,0 +1,33 @@
+import { DTO } from '../lib/dto/DTO.js';
+import { BaseObject } from '../lib/base/BaseObject.js';
+/**
+ * The declaration of an anonymous object in the `objects.anonymous` module option: its class and its options. The
+ * object is registered by its class (got with `getObject(TheClass)` or `@Inject(TheClass)`), with its options; the
+ * keys other than `class` are its options (the values of its `@Configurable` properties).
+ * @example
+ * ```typescript
+ * import {Application, BaseObject, DTO, type LoadAnonymousObjectOptions} from 'lakutata'
+ * import {Configurable} from 'lakutata/decorator/di'
+ *
+ * class Mailer extends BaseObject {
+ *     @Configurable(DTO.String())
+ *     protected readonly host: string = 'localhost'
+ * }
+ *
+ * const mailer: LoadAnonymousObjectOptions = {class: Mailer, host: 'smtp.example.com'}
+ *
+ * Application.run({
+ *     id: 'mail.app',
+ *     name: 'Mail',
+ *     objects: {
+ *         anonymous: [mailer]
+ *     }
+ * })
+ * ```
+ */
+export declare class LoadAnonymousObjectOptions<ClassConstructor extends typeof BaseObject = typeof BaseObject> extends DTO {
+    /**
+     * The class of the object, a {@link BaseObject} subclass. Required.
+     */
+    class: ClassConstructor;
+}