libmodulor 0.24.0 → 0.26.0

package/dist/esm/convention.d.ts

@@ -1,5 +1,7 @@
 import type { AppName } from './app/index.js';
 import type { ProductName } from './product/index.js';
+import type { TargetName } from './target/index.js';
+import type { UCName } from './uc/index.js';
 export declare const SRC_DIR_NAME: string;
 export declare const APPS_ROOT_DIR_NAME: string;
 export declare const APPS_ROOT_ALIAS: string;
@@ -12,7 +14,6 @@ export declare const APP_INDEX_FILE_NAME: string;
 export declare const APP_INDEX_FILE_NAME_FOR_IMPORT: string;
 export declare const APP_INSTALLER_FILE_NAME: string;
 export declare const APP_MANIFEST_NAME: string;
-export declare const APP_MANIFEST_FILE_EXT: string;
 export declare const APP_MANIFEST_FILE_NAME: string;
 export declare const APP_NAME_PLACEHOLDER: AppName;
 export declare const APP_ROOT_FROM_UCD: string[];
@@ -20,17 +21,21 @@ export declare const APP_SETTINGS_FILE_NAME: string;
 export declare const APP_SRC_DIR_NAME: string;
 export declare const APP_SRC_LIB_DIR_NAME: string;
 export declare const APP_SRC_UCDS_DIR_NAME: string;
+export declare const APP_TEST_CONFIGURATOR_NAME: string;
+export declare const APP_TEST_CONFIGURATOR_FILE_NAME: string;
 export declare const APP_TEST_DIR_NAME: string;
 export declare const APP_TEST_MAIN_FILE_NAME: string;
 export declare const APP_TEST_REPORTS_DIR_NAME: string;
+export declare const PRODUCTS_ROOT_DIR_NAME: string;
 export declare const PRODUCTS_ROOT_ALIAS: string;
 export declare const PRODUCTS_ROOT_PATH: string[];
+export declare const PRODUCT_I18N_NAME: string;
+export declare const PRODUCT_I18N_FILE_NAME: string;
 export declare const PRODUCT_MANIFEST_NAME: string;
-export declare const PRODUCT_MANIFEST_FILE_EXT: string;
 export declare const PRODUCT_MANIFEST_FILE_NAME: string;
 export declare const PRODUCT_NAME_PLACEHOLDER: ProductName;
+export declare const PRODUCT_TARGETS_DIR_NAME: string;
 export declare const UC_DEF_SUFFIX: string;
-export declare const UC_DEF_FILE_NAME_EXT: string;
 export declare const UC_DEF_FILE_NAME_SUFFIX: string;
 export declare const UC_DEF_TYPE: string;
 export declare const UC_INPUT_BASE: string;
@@ -42,10 +47,16 @@ export declare const UC_LIFECYCLE_SERVER_PROP_NAME: string;
 export declare const UC_MAIN_SUFFIX: string;
 export declare const UC_MAIN_CLIENT_SUFFIX: string;
 export declare const UC_MAIN_SERVER_SUFFIX: string;
+export declare const UC_MAIN_SERVER_FILE_NAME_SUFFIX: string;
 export declare const UC_MAIN_STEP_PREFIX_REGULAR = "// >=>";
+export declare const UC_NAME_PLACEHOLDER: UCName;
 export declare const UC_OPI_BASE: string;
 export declare const UC_OPI_SUFFIX: string;
+export declare const UC_OPI0_SUFFIX: string;
+export declare const UC_OPI1_SUFFIX: string;
 export declare const UC_POLICY_SUFFIX: string;
 export declare const UC_POLICY_SUFFIX_FULL: string;
-export declare const UC_POLICY_FILE_NAME_EXT: string;
 export declare const UC_POLICY_FILE_NAME_SUFFIX: string;
+export declare const PRODUCT_ROOT_FROM_PRODUCT_TARGET_PATH: string[];
+export declare const APPS_PATH_FROM_PRODUCT_TARGET_PATH: string[];
+export declare const TARGET_NAME_PLACEHOLDER: TargetName;

package/dist/esm/convention.js

@@ -16,32 +16,38 @@ export const APP_INDEX_FILE_NAME = `${APP_INDEX_NAME}.ts`;
 export const APP_INDEX_FILE_NAME_FOR_IMPORT = 'index.js'; // ESM
 export const APP_INSTALLER_FILE_NAME = 'installer.ts';
 export const APP_MANIFEST_NAME = 'Manifest';
-export const APP_MANIFEST_FILE_EXT = '.ts';
-export const APP_MANIFEST_FILE_NAME = `${APP_MANIFEST_NAME.toLowerCase()}${APP_MANIFEST_FILE_EXT}`;
+export const APP_MANIFEST_FILE_NAME = `${APP_MANIFEST_NAME.toLowerCase()}.ts`;
 export const APP_NAME_PLACEHOLDER = 'AppX';
 export const APP_ROOT_FROM_UCD = ['..', '..', '..']; // $root/src/ucds/XyzUCD.ts
 export const APP_SETTINGS_FILE_NAME = 'settings.ts';
 export const APP_SRC_DIR_NAME = SRC_DIR_NAME;
 export const APP_SRC_LIB_DIR_NAME = 'lib';
 export const APP_SRC_UCDS_DIR_NAME = 'ucds';
+export const APP_TEST_CONFIGURATOR_NAME = 'Configurator';
+export const APP_TEST_CONFIGURATOR_FILE_NAME = `${APP_TEST_CONFIGURATOR_NAME}.ts`;
 export const APP_TEST_DIR_NAME = 'test';
 export const APP_TEST_MAIN_FILE_NAME = 'App.test.ts';
 export const APP_TEST_REPORTS_DIR_NAME = 'reports';
 /*
  * Product
  */
+export const PRODUCTS_ROOT_DIR_NAME = 'products';
 export const PRODUCTS_ROOT_ALIAS = '@p';
-export const PRODUCTS_ROOT_PATH = [SRC_DIR_NAME, 'products'];
+export const PRODUCTS_ROOT_PATH = [
+    SRC_DIR_NAME,
+    PRODUCTS_ROOT_DIR_NAME,
+];
+export const PRODUCT_I18N_NAME = 'I18n';
+export const PRODUCT_I18N_FILE_NAME = `${PRODUCT_I18N_NAME.toLowerCase()}.ts`;
 export const PRODUCT_MANIFEST_NAME = 'Manifest';
-export const PRODUCT_MANIFEST_FILE_EXT = '.ts';
-export const PRODUCT_MANIFEST_FILE_NAME = `${PRODUCT_MANIFEST_NAME.toLowerCase()}${PRODUCT_MANIFEST_FILE_EXT}`;
+export const PRODUCT_MANIFEST_FILE_NAME = `${PRODUCT_MANIFEST_NAME.toLowerCase()}.ts`;
 export const PRODUCT_NAME_PLACEHOLDER = 'ProductX';
+export const PRODUCT_TARGETS_DIR_NAME = 'targets';
 /*
  * Use Case
  */
 export const UC_DEF_SUFFIX = 'UCD';
-export const UC_DEF_FILE_NAME_EXT = '.ts';
-export const UC_DEF_FILE_NAME_SUFFIX = `${UC_DEF_SUFFIX}${UC_DEF_FILE_NAME_EXT}`;
+export const UC_DEF_FILE_NAME_SUFFIX = `${UC_DEF_SUFFIX}.ts`;
 export const UC_DEF_TYPE = 'UCDef';
 export const UC_INPUT_BASE = 'UCInput';
 export const UC_INPUT_FIELD_PATTERN = '^UCInputFieldValue<(.*)>$';
@@ -52,10 +58,28 @@ export const UC_LIFECYCLE_SERVER_PROP_NAME = 'server';
 export const UC_MAIN_SUFFIX = 'Main';
 export const UC_MAIN_CLIENT_SUFFIX = `Client${UC_MAIN_SUFFIX}`;
 export const UC_MAIN_SERVER_SUFFIX = `Server${UC_MAIN_SUFFIX}`;
+export const UC_MAIN_SERVER_FILE_NAME_SUFFIX = `${UC_MAIN_SERVER_SUFFIX}.ts`;
 export const UC_MAIN_STEP_PREFIX_REGULAR = '// >=>';
+export const UC_NAME_PLACEHOLDER = 'CreateX';
 export const UC_OPI_BASE = 'UCOPIBase';
 export const UC_OPI_SUFFIX = 'OPI';
+export const UC_OPI0_SUFFIX = `${UC_OPI_SUFFIX}0`;
+export const UC_OPI1_SUFFIX = `${UC_OPI_SUFFIX}1`;
 export const UC_POLICY_SUFFIX = 'Policy';
 export const UC_POLICY_SUFFIX_FULL = `UC${UC_POLICY_SUFFIX}`;
-export const UC_POLICY_FILE_NAME_EXT = '.ts';
-export const UC_POLICY_FILE_NAME_SUFFIX = `${UC_POLICY_SUFFIX_FULL}${UC_POLICY_FILE_NAME_EXT}`;
+export const UC_POLICY_FILE_NAME_SUFFIX = `${UC_POLICY_SUFFIX_FULL}.ts`;
+/*
+ * Target
+ */
+export const PRODUCT_ROOT_FROM_PRODUCT_TARGET_PATH = [
+    // src/products/${ProductName}/targets/${target-name}
+    '..', // src/products/${ProductName}/targets
+    '..', // src/products/${ProductName}
+];
+export const APPS_PATH_FROM_PRODUCT_TARGET_PATH = [
+    ...PRODUCT_ROOT_FROM_PRODUCT_TARGET_PATH,
+    '..', // src/products
+    '..', // src
+    APPS_ROOT_DIR_NAME, // src/apps
+];
+export const TARGET_NAME_PLACEHOLDER = 'node-express-server';

package/dist/esm/dt/Validation.d.ts

@@ -1,13 +1,13 @@
 import type { I18nTranslation } from '../i18n/index.js';
 import type { NumIndex } from './final/TNumIndex.js';
-type ViolationConstraint = 'fieldsOr' | 'format' | 'mandatory' | 'max' | 'maxCount' | 'maxLength' | 'min' | 'minCount' | 'minLength' | 'oneOf' | 'shape' | 'type';
+type ViolationConstraint = 'fieldsOr' | 'format' | 'mandatory' | 'max' | 'maxCount' | 'maxLength' | 'maxSize' | 'min' | 'minCount' | 'minLength' | 'minSize' | 'oneOf' | 'shape' | 'type';
 type ViolationBase<C extends ViolationConstraint, EV> = {
     constraint: C;
     expected: EV;
 };
 export type ViolationFormat = 'ColorRGBA' | 'DateISO8601' | 'DirPath' | 'DomainName' | 'Email' | 'FilePath' | 'GitSSHURL' | 'IPv4' | 'IPv6' | 'JSON' | 'JWT' | 'PersonFirstname' | 'PersonFullname' | 'PersonInitials' | 'PersonLastname' | 'QRCode' | 'SemVerVersion' | 'Slug' | 'SSHPrivateKey' | 'SSHPublicKey' | 'Time' | 'URL' | 'UUID';
 export type ViolationType = 'array' | 'boolean' | 'int' | 'number' | 'object' | 'scalar' | 'string';
-export type Violation<T = unknown> = ViolationBase<'fieldsOr', string> | ViolationBase<'format', ViolationFormat> | ViolationBase<'format', string> | ViolationBase<'mandatory', undefined> | ViolationBase<'max', number> | ViolationBase<'maxCount', number> | ViolationBase<'maxLength', number> | ViolationBase<'min', number> | ViolationBase<'minCount', number> | ViolationBase<'minLength', number> | ViolationBase<'oneOf', T[]> | ViolationBase<'shape', object> | ViolationBase<'type', ViolationType>;
+export type Violation<T = unknown> = ViolationBase<'fieldsOr', string> | ViolationBase<'format', ViolationFormat> | ViolationBase<'format', string> | ViolationBase<'mandatory', undefined> | ViolationBase<'max', number> | ViolationBase<'maxCount', number> | ViolationBase<'maxLength', number> | ViolationBase<'maxSize', string> | ViolationBase<'min', number> | ViolationBase<'minCount', number> | ViolationBase<'minLength', number> | ViolationBase<'minSize', string> | ViolationBase<'oneOf', T[]> | ViolationBase<'shape', object> | ViolationBase<'type', ViolationType>;
 type ViolationI18nableSimple = Exclude<ViolationConstraint, 'format' | 'type'>;
 export type ViolationI18nable = `validation_${ViolationI18nableSimple}` | `validation_format_${ViolationFormat}` | `validation_type_${ViolationType}`;
 export type ViolationI18n = Record<ViolationI18nable, I18nTranslation>;

package/dist/esm/dt/base/TBase.d.ts

@@ -26,6 +26,7 @@ export interface OptionsOpts {
     shouldTranslateLabels?: boolean;
     strict?: boolean;
 }
+export type ConstraintsForHuman = Record<string, string>;
 export declare abstract class TBase<T extends DataType> {
     static DEFAULT_OPTIONS: Required<OptionsOpts>;
     protected defaultValue: T | undefined;
@@ -44,6 +45,7 @@ export declare abstract class TBase<T extends DataType> {
     fmt(ifNullOrUndefined?: string): string;
     getDefaultValue(): T | undefined;
     getExamples(): T[] | undefined;
+    getConstraintsForHuman(): ConstraintsForHuman | null;
     getInitialValue(): T | undefined;
     getOptions(): Option<T>[] | undefined;
     getSemanticsMapping(): SemanticsMapping | undefined;

package/dist/esm/dt/base/TBase.js

@@ -39,6 +39,9 @@ export class TBase {
     getExamples() {
         return this.examples;
     }
+    getConstraintsForHuman() {
+        return null;
+    }
     getInitialValue() {
         return this.initialValue;
     }

package/dist/esm/dt/base/TObject.d.ts

@@ -1,6 +1,7 @@
+import type { EnumOf } from '../../utils/index.js';
 import type { Validation } from '../Validation.js';
 import { TBase, type TName } from './TBase.js';
-export declare enum TObjectShapeValidationStrategy {
+export declare const TObjectShapeValidationStrategy: {
     /**
      * No shape validation is performed
      *
@@ -8,14 +9,15 @@ export declare enum TObjectShapeValidationStrategy {
      *
      * Otherwise, you can still override {@link validate} in the `T*` class and do your own validation.
      */
-    NONE = "NONE",
+    readonly NONE: "NONE";
     /**
      * Validate against the {@link TObject.example()}
      *
      * It checks that the keys of the value, sorted alphabetically, are the same as the example's keys.
      */
-    SAME_AS_EXAMPLE = "SAME_AS_EXAMPLE"
-}
+    readonly SAME_AS_EXAMPLE: "SAME_AS_EXAMPLE";
+};
+export type TObjectShapeValidationStrategy = EnumOf<typeof TObjectShapeValidationStrategy>;
 export interface TObjectConstraints {
     /**
      * @defaultValue {@link TObjectShapeValidationStrategy.SAME_AS_EXAMPLE}

package/dist/esm/dt/base/TObject.js

@@ -1,6 +1,5 @@
 import { TBase } from './TBase.js';
-export var TObjectShapeValidationStrategy;
-(function (TObjectShapeValidationStrategy) {
+export const TObjectShapeValidationStrategy = {
     /**
      * No shape validation is performed
      *
@@ -8,14 +7,14 @@ export var TObjectShapeValidationStrategy;
      *
      * Otherwise, you can still override {@link validate} in the `T*` class and do your own validation.
      */
-    TObjectShapeValidationStrategy["NONE"] = "NONE";
+    NONE: 'NONE',
     /**
      * Validate against the {@link TObject.example()}
      *
      * It checks that the keys of the value, sorted alphabetically, are the same as the example's keys.
      */
-    TObjectShapeValidationStrategy["SAME_AS_EXAMPLE"] = "SAME_AS_EXAMPLE";
-})(TObjectShapeValidationStrategy || (TObjectShapeValidationStrategy = {}));
+    SAME_AS_EXAMPLE: 'SAME_AS_EXAMPLE',
+};
 export class TObject extends TBase {
     constraints;
     constructor(constraints = {

package/dist/esm/dt/base/TString.d.ts

@@ -1,5 +1,5 @@
 import type { Validation, ViolationFormat } from '../Validation.js';
-import { TBase, type TName } from './TBase.js';
+import { type ConstraintsForHuman, TBase, type TName } from './TBase.js';
 export interface TStringConstraints<VF extends ViolationFormat | (string & {}) = ViolationFormat> {
     format?: {
         f: VF;
@@ -15,6 +15,7 @@ export declare class TString<T extends string = string, VF extends ViolationForm
     constructor(constraints?: TStringConstraints<VF> | undefined);
     tName(): TName;
     example(): T;
+    getConstraintsForHuman(): ConstraintsForHuman | null;
     getConstraints(): TStringConstraints<VF> | undefined;
     isPotentiallyLong(): boolean;
     protected removeFormatConstraint(): void;

package/dist/esm/dt/base/TString.js

@@ -13,6 +13,28 @@ export class TString extends TBase {
     example() {
         return 'Miami';
     }
+    getConstraintsForHuman() {
+        if (!this.constraints) {
+            return null;
+        }
+        const c = {};
+        const { format, maxLength, minLength } = this.constraints;
+        if (minLength) {
+            // biome-ignore lint/complexity/useLiteralKeys: typescript disagrees
+            c['minLength'] = minLength.toString();
+        }
+        if (maxLength) {
+            // biome-ignore lint/complexity/useLiteralKeys: typescript disagrees
+            c['maxLength'] = maxLength.toString();
+        }
+        if (format) {
+            // Are regexes really "human" ?
+            // TODO : Find a more human way of displaying regexes
+            // biome-ignore lint/complexity/useLiteralKeys: typescript disagrees
+            c['format'] = format.regexp.toString();
+        }
+        return c;
+    }
     getConstraints() {
         return this.constraints;
     }

package/dist/esm/dt/final/TFile.d.ts

@@ -1,23 +1,32 @@
-import type { TName } from '../base/TBase.js';
+import type { ConstraintsForHuman, TName } from '../base/TBase.js';
 import { TObject } from '../base/TObject.js';
 import type { HTMLInputType } from '../targets/web.js';
 import type { Validation } from '../Validation.js';
-import { type FileMimeType, type TFileMimeTypeConstraints } from './TFileMimeType.js';
+import { type FileMimeType } from './TFileMimeType.js';
 import { type FileName } from './TFileName.js';
 import { type FilePath } from './TFilePath.js';
+import type { UIntQuantity } from './TUIntQuantity.js';
 export type File = {
     name: FileName;
-    path: FilePath;
+    size: UIntQuantity;
     type: FileMimeType;
+    uri: FilePath;
 };
 export interface TFileConstraints {
-    type: TFileMimeTypeConstraints;
+    accept: FileMimeType[];
+    maxSizeInBytes?: UIntQuantity;
+    minSizeInBytes?: UIntQuantity;
 }
 export declare class TFile extends TObject<File> {
     protected fileConstraints: TFileConstraints;
+    static readonly UNITS: string[];
     constructor(fileConstraints: TFileConstraints);
     tName(): TName;
     example(): File;
+    getConstraintsForHuman(): ConstraintsForHuman | null;
     htmlInputType(): HTMLInputType;
     validate(): Validation;
+    getFileConstraints(): TFileConstraints;
+    fmtBytes(bytes: number, decimals?: number): string;
+    withOneExample(name: File['name']): this;
 }

package/dist/esm/dt/final/TFile.js

@@ -1,9 +1,21 @@
 import { TObject, TObjectShapeValidationStrategy } from '../base/TObject.js';
-import { TFileMimeType, } from './TFileMimeType.js';
+import { TFileMimeType } from './TFileMimeType.js';
 import { TFileName } from './TFileName.js';
 import { TFilePath } from './TFilePath.js';
 export class TFile extends TObject {
     fileConstraints;
+    // We consider them generic enough to not having to be translated
+    static UNITS = [
+        'B',
+        'KB',
+        'MB',
+        'GB',
+        'TB',
+        'PB',
+        'EB',
+        'ZB',
+        'YB',
+    ];
     constructor(fileConstraints) {
         super({
             // We usually process instances of https://developer.mozilla.org/fr/docs/Web/API/File
@@ -17,11 +29,27 @@ export class TFile extends TObject {
     }
     example() {
         return {
-            name: 'picture.png',
-            path: '/Users/dexter/Desktop/picture.png',
-            type: 'image/png',
+            name: TFilePath.FILE_NAME,
+            size: TFilePath.FILE_SIZE,
+            type: TFilePath.MIME_TYPE,
+            uri: `${TFilePath.ABS_PATH}/${TFilePath.FILE_NAME}`,
         };
     }
+    getConstraintsForHuman() {
+        const c = {};
+        const { accept, maxSizeInBytes, minSizeInBytes } = this.fileConstraints;
+        if (minSizeInBytes) {
+            // biome-ignore lint/complexity/useLiteralKeys: typescript disagrees
+            c['minSizeInBytes'] = this.fmtBytes(minSizeInBytes);
+        }
+        if (maxSizeInBytes) {
+            // biome-ignore lint/complexity/useLiteralKeys: typescript disagrees
+            c['maxSizeInBytes'] = this.fmtBytes(maxSizeInBytes);
+        }
+        // biome-ignore lint/complexity/useLiteralKeys: typescript disagrees
+        c['accept'] = accept.join(', ');
+        return c;
+    }
     htmlInputType() {
         return 'file';
     }
@@ -32,13 +60,47 @@ export class TFile extends TObject {
         }
         const val = this.raw;
         validation.concat(new TFileName().assign(val.name).validate());
+        const { accept, maxSizeInBytes, minSizeInBytes } = this.fileConstraints;
+        const { size, type, uri } = val;
         if (!(val instanceof File)) {
-            validation.concat(new TFilePath().assign(val.path).validate());
+            validation.concat(new TFilePath().assign(uri).validate());
         }
-        validation.concat(new TFileMimeType(this.fileConstraints.type)
-            .assign(val.type)
+        validation.concat(new TFileMimeType()
+            .setOptions(accept.map((a) => ({ label: a, value: a })))
+            .assign(type)
             .validate());
-        // TODO : Add validation on file size
+        if (minSizeInBytes && size < minSizeInBytes) {
+            validation.add({
+                constraint: 'minSize',
+                expected: this.fmtBytes(minSizeInBytes),
+            });
+        }
+        if (maxSizeInBytes && size > maxSizeInBytes) {
+            validation.add({
+                constraint: 'maxSize',
+                expected: this.fmtBytes(maxSizeInBytes),
+            });
+        }
         return validation;
     }
+    getFileConstraints() {
+        return this.fileConstraints;
+    }
+    fmtBytes(bytes, decimals = 2) {
+        const k = 1024;
+        const dm = decimals < 0 ? 0 : decimals;
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return `${Number.parseFloat((bytes / k ** i).toFixed(dm))} ${TFile.UNITS[i]}`;
+    }
+    withOneExample(name) {
+        this.setExamples([
+            {
+                name,
+                size: TFilePath.FILE_SIZE,
+                type: this.fileConstraints.accept[0] ?? TFilePath.MIME_TYPE,
+                uri: `${TFilePath.ABS_PATH}/${name}`,
+            },
+        ]);
+        return this;
+    }
 }

package/dist/esm/dt/final/TFileExtension.d.ts

@@ -3,7 +3,7 @@ import { TString, type TStringConstraints } from '../base/TString.js';
 type ImageExtension = 'gif' | 'heic' | 'jpg' | 'png';
 type VideoExtension = 'mov' | 'mp4';
 type XMLExtension = 'gpx' | 'xml';
-export type FileExtension = ImageExtension | VideoExtension | XMLExtension;
+export type FileExtension = ImageExtension | VideoExtension | XMLExtension | (string & {});
 export interface TFileExtensionConstraints extends TStringConstraints {
     allowed: FileExtension[];
 }

package/dist/esm/dt/final/TFileMimeType.d.ts

@@ -1,11 +1,7 @@
 import type { TName } from '../base/TBase.js';
-import { TString, type TStringConstraints } from '../base/TString.js';
-export type FileMimeType = 'text/plain' | 'audio/aac' | 'application/x-abiword' | 'application/octet-stream' | 'video/x-msvideo' | 'application/vnd.amazon.ebook' | 'image/bmp' | 'application/x-bzip' | 'application/x-bzip2' | 'application/x-csh' | 'text/css' | 'text/csv' | 'application/msword' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/vnd.ms-fontobject' | 'application/epub+zip' | 'image/gif' | 'text/html' | 'image/x-icon' | 'text/calendar' | 'application/java-archive' | 'image/jpeg' | 'image/jpg' | 'application/javascript' | 'application/json' | 'audio/midi' | 'video/mpeg' | 'application/vnd.apple.installer+xml' | 'application/vnd.oasis.opendocument.presentation' | 'application/vnd.oasis.opendocument.spreadsheet' | 'application/vnd.oasis.opendocument.text' | 'audio/ogg' | 'video/ogg' | 'application/ogg' | 'font/otf' | 'image/png' | 'application/pdf' | 'application/vnd.ms-powerpoint' | 'application/vnd.openxmlformats-officedocument.presentationml.presentation' | 'application/x-rar-compressed' | 'application/rtf' | 'application/x-sh' | 'image/svg+xml' | 'application/x-shockwave-flash' | 'application/x-tar' | 'image/tiff' | 'application/typescript' | 'font/ttf' | 'application/vnd.visio' | 'audio/x-wav' | 'audio/webm' | 'video/webm' | 'image/webp' | 'font/woff' | 'font/woff2' | 'application/xhtml+xml' | 'application/vnd.ms-excel' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'application/xml' | 'application/vnd.mozilla.xul+xml' | 'application/zip' | 'video/3gpp audio/3gpp' | 'video/3gpp2 audio/3gpp2' | 'application/x-7z-compressed';
-export interface TFileMimeTypeConstraints extends TStringConstraints {
-    allowed: FileMimeType[];
-}
+import { TString } from '../base/TString.js';
+export type FileMimeType = 'text/plain' | 'audio/aac' | 'application/x-abiword' | 'application/octet-stream' | 'video/x-msvideo' | 'application/vnd.amazon.ebook' | 'image/bmp' | 'application/x-bzip' | 'application/x-bzip2' | 'application/x-csh' | 'text/css' | 'text/csv' | 'application/msword' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/vnd.ms-fontobject' | 'application/epub+zip' | 'image/gif' | 'text/html' | 'image/x-icon' | 'text/calendar' | 'application/java-archive' | 'image/jpeg' | 'image/jpg' | 'application/javascript' | 'application/json' | 'audio/midi' | 'video/mpeg' | 'application/vnd.apple.installer+xml' | 'application/vnd.oasis.opendocument.presentation' | 'application/vnd.oasis.opendocument.spreadsheet' | 'application/vnd.oasis.opendocument.text' | 'audio/ogg' | 'video/ogg' | 'application/ogg' | 'font/otf' | 'image/png' | 'application/pdf' | 'application/vnd.ms-powerpoint' | 'application/vnd.openxmlformats-officedocument.presentationml.presentation' | 'application/x-rar-compressed' | 'application/rtf' | 'application/x-sh' | 'image/svg+xml' | 'application/x-shockwave-flash' | 'application/x-tar' | 'image/tiff' | 'application/typescript' | 'font/ttf' | 'application/vnd.visio' | 'audio/x-wav' | 'audio/webm' | 'video/webm' | 'image/webp' | 'font/woff' | 'font/woff2' | 'application/xhtml+xml' | 'application/vnd.ms-excel' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'application/xml' | 'application/vnd.mozilla.xul+xml' | 'application/zip' | 'video/3gpp audio/3gpp' | 'video/3gpp2 audio/3gpp2' | 'application/x-7z-compressed' | (string & {});
 export declare class TFileMimeType extends TString<FileMimeType> {
-    constructor(constraints?: TFileMimeTypeConstraints);
     tName(): TName;
     example(): FileMimeType;
 }

package/dist/esm/dt/final/TFileMimeType.js

@@ -1,11 +1,5 @@
 import { TString } from '../base/TString.js';
 export class TFileMimeType extends TString {
-    constructor(constraints) {
-        super(constraints);
-        if (constraints?.allowed) {
-            this.setOptions(constraints?.allowed.map((v) => ({ label: v, value: v })));
-        }
-    }
     tName() {
         return 'FileMimeType';
     }

package/dist/esm/dt/final/TFilePath.d.ts

@@ -1,7 +1,14 @@
 import type { TName } from '../base/TBase.js';
 import { TString, type TStringConstraints } from '../base/TString.js';
+import type { FileMimeType } from './TFileMimeType.js';
+import type { FileName } from './TFileName.js';
+import type { UIntQuantity } from './TUIntQuantity.js';
 export type FilePath = string;
 export declare class TFilePath extends TString<FilePath> {
+    static readonly ABS_PATH: FilePath;
+    static readonly FILE_NAME: FileName;
+    static readonly FILE_SIZE: UIntQuantity;
+    static readonly MIME_TYPE: FileMimeType;
     static readonly FORMAT: RegExp;
     constructor(constraints?: TStringConstraints);
     tName(): TName;

package/dist/esm/dt/final/TFilePath.js

@@ -1,5 +1,9 @@
 import { TString } from '../base/TString.js';
 export class TFilePath extends TString {
+    static ABS_PATH = '/Users/dexter/Desktop';
+    static FILE_NAME = 'picture.png';
+    static FILE_SIZE = 32;
+    static MIME_TYPE = 'image/png';
     static FORMAT = /^[a-z0-9_/.][a-z0-9-_/.]+/i;
     constructor(constraints) {
         super({
@@ -11,6 +15,6 @@ export class TFilePath extends TString {
         return 'FilePath';
     }
     example() {
-        return '/Users/dexter/Desktop/picture.png';
+        return `${TFilePath.ABS_PATH}/${TFilePath.FILE_NAME}`;
     }
 }

package/dist/esm/dt/index.d.ts

@@ -27,7 +27,7 @@ export { type Emoji, TEmoji } from './final/TEmoji.js';
 export { type EncryptionKey, TEncryptionKey } from './final/TEncryptionKey.js';
 export { type ErrorMessage, TErrorMessage } from './final/TErrorMessage.js';
 export { type ExternalServiceId, TExternalServiceId, } from './final/TExternalServiceId.js';
-export { type File, TFile } from './final/TFile.js';
+export { type File, TFile, type TFileConstraints } from './final/TFile.js';
 export { type FileExtension, TFileExtension } from './final/TFileExtension.js';
 export { type FileMimeType, TFileMimeType } from './final/TFileMimeType.js';
 export { type FileName, TFileName } from './final/TFileName.js';

package/dist/esm/error/funcs.d.ts

@@ -1,2 +1,4 @@
 import type { ErrorMessage, HTTPStatusNumber } from '../dt/index.js';
+export declare function isEmptyJSON(err: unknown): boolean;
+export declare function isInvalidJSON(err: unknown): boolean;
 export declare function throwCustomError(message: ErrorMessage, status: HTTPStatusNumber): never;

package/dist/esm/error/funcs.js

@@ -10,6 +10,26 @@ const ERROR_HTTP_STATUS_MAP = new Map([
     [404, NotFoundError],
     [500, InternalServerError],
 ]);
+export function isEmptyJSON(err) {
+    return (err instanceof Error &&
+        err.message.toLowerCase().includes('unexpected end of json input'));
+}
+export function isInvalidJSON(err) {
+    if (!(err instanceof Error)) {
+        return false;
+    }
+    const message = err.message.toLowerCase();
+    // The usual JS error thrown by JSON.parse
+    if (message.includes('is not valid json')) {
+        return true;
+    }
+    // The error thrown by undici (used by hono for example)
+    // https://github.com/nodejs/undici/blob/ec4a84e13a9b86355b4d65a63a247524986386af/lib/web/fetch/body.js#L402
+    if (message.includes('content-type was not one of')) {
+        return true;
+    }
+    return false;
+}
 export function throwCustomError(message, status) {
     const clazz = ERROR_HTTP_STATUS_MAP.get(status);
     if (clazz) {

package/dist/esm/error/index.d.ts

@@ -1,7 +1,7 @@
 export { CustomError, type ServerError } from './CustomError.js';
 export { ForbiddenAsNotFoundError } from './ForbiddenAsNotFoundError.js';
 export { ForbiddenError } from './ForbiddenError.js';
-export { throwCustomError } from './funcs.js';
+export { isEmptyJSON, isInvalidJSON, throwCustomError } from './funcs.js';
 export { IllegalArgumentError } from './IllegalArgumentError.js';
 export { InternalServerError } from './InternalServerError.js';
 export { NotAvailableError } from './internal/NotAvailableError.js';

package/dist/esm/error/index.js

@@ -1,7 +1,7 @@
 export { CustomError } from './CustomError.js';
 export { ForbiddenAsNotFoundError } from './ForbiddenAsNotFoundError.js';
 export { ForbiddenError } from './ForbiddenError.js';
-export { throwCustomError } from './funcs.js';
+export { isEmptyJSON, isInvalidJSON, throwCustomError } from './funcs.js';
 export { IllegalArgumentError } from './IllegalArgumentError.js';
 export { InternalServerError } from './InternalServerError.js';
 export { NotAvailableError } from './internal/NotAvailableError.js';

package/dist/esm/i18n/WordingManager.d.ts

@@ -18,11 +18,12 @@ import type { UCClientConfirmConfig, UCDef, UCExecState, UCFieldKey, UCInput, UC
  * One might argue that a label can be different for "name" in "CreateX" and "CreateY".
  * In this case, we consider that the input field shouldn't be named "name" in both places.
  */
-export type WordingManagerKey = `dt_${TName}_${string}_${keyof UCWording}` | `p_${keyof ProductWording}` | `uc_${UCName}_${keyof UCWording}` | `uc_${UCName}_client_confirm_${keyof UCClientConfirmConfig}` | `uc_${UCName}_i_submit_${UCExecState}` | `uc_${UCName}_op_${UCOutputPartIdx}_${keyof UCOutputPartWording}` | `ucif_${UCFieldKey}_${keyof UCWording}` | `ucof_${UCFieldKey}_${keyof UCWording}`;
+export type WordingManagerKey = `dt_${TName}_constr_${string}` | `dt_${TName}_${string}_${keyof UCWording}` | `p_${keyof ProductWording}` | `uc_${UCName}_${keyof UCWording}` | `uc_${UCName}_client_confirm_${keyof UCClientConfirmConfig}` | `uc_${UCName}_i_submit_${UCExecState}` | `uc_${UCName}_op_${UCOutputPartIdx}_${keyof UCOutputPartWording}` | `ucif_${UCFieldKey}_${keyof UCWording}` | `ucof_${UCFieldKey}_${keyof UCWording}`;
 export declare class WordingManager {
     private i18nManager;
     constructor(i18nManager: I18nManager);
     dt<DT extends DataType>(type: TBase<DT>): UCWording;
+    dtConstr<DT extends DataType>(type: TBase<DT>): string[] | null;
     p(): ProductWording;
     uc<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(def: UCDef<I, OPI0, OPI1>): UCWording;
     ucClientConfirm<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(def: UCDef<I, OPI0, OPI1>): UCClientConfirmConfig;

package/dist/esm/i18n/WordingManager.js

@@ -39,6 +39,24 @@ let WordingManager = class WordingManager {
         }
         return { desc, label };
     }
+    dtConstr(type) {
+        const constraints = type.getConstraintsForHuman();
+        if (!constraints) {
+            return null;
+        }
+        const entries = Object.entries(constraints);
+        if (entries.length === 0) {
+            return null;
+        }
+        const parts = [];
+        for (const [k, v] of Object.entries(constraints)) {
+            parts.push(
+            // TODO : Consider moving up the type hierarchy to fetch the constr of the parent when missing
+            // e.g. TFreeTextShort > TString
+            this.t(`dt_${type.tName()}_constr_${k}`, undefined, v));
+        }
+        return parts;
+    }
     p() {
         return {
             desc: this.tOrNull('p_desc'),
@@ -87,8 +105,11 @@ let WordingManager = class WordingManager {
             label: this.tOrNull(`uc_${name}_op_${idx}_label`),
         };
     }
-    t(key, fallback = undefined) {
-        return this.i18nManager.t(key, { fallback });
+    t(key, fallback = undefined, expected = undefined) {
+        return this.i18nManager.t(key, {
+            fallback,
+            vars: expected ? { expected } : {},
+        });
     }
     tOr(key, fallbackKey) {
         let val = this.tOrNull(key);