libmodulor 0.3.0 → 0.5.0

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

@@ -23,12 +23,20 @@ export class TJWT extends TString {
                 });
             }
             const [header, payload, _signature] = parts;
+            // Using atob on Node.js platforms triggers the following deprecation message :
+            //
+            // This function is only provided for compatibility with legacy web platform APIs and should never be used in new code,
+            // because they use strings to represent binary data and predate the introduction of typed arrays in JavaScript.
+            // For code running using Node.js APIs, converting between base64-encoded strings and binary data should be performed using Buffer.from(str, 'base64') andbuf.toString('base64').
+            //
+            // However this code must be executable everywhere (including and especially browsers) so we need to use it, for portability reasons
             if (header) {
                 JSON.parse(atob(header));
             }
             if (payload) {
                 JSON.parse(atob(payload));
             }
+            // signature is ignored for now
         }
         catch (err) {
             validation.add({

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

@@ -1,4 +1,6 @@
 import { TNumber } from '../base/TNumber.js';
+// TODO : Add some constraints (e.g. between 0 and 1, etc.)
+// Not forgetting that a percentage can be higher hein ! 1.25 is a valid value for 125% !
 export class TPercentage extends TNumber {
     constructor(constraints, decimalsCount) {
         super(constraints, decimalsCount, 'percent');
@@ -13,6 +15,9 @@ export class TPercentage extends TNumber {
         if (typeof this.raw !== 'number') {
             return super.fmt(ifNullOrUndefined);
         }
+        // Although it works on web, using fmtNumber and setting the unit to 'percent' does not work on React Native (Hermes)
+        // Instead of displaying '89%', it displays '89 percent'
+        // Hence the usage here of style: 'percent' directly
         return new Intl.NumberFormat(undefined, {
             maximumFractionDigits: this.decimalsCount,
             style: 'percent',

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

@@ -1,4 +1,5 @@
 import { TString } from '../base/TString.js';
+// TODO : Add basic syntax validation (without adding any dependencies)
 export class TSQLQuery extends TString {
     tName() {
         return 'SQLQuery';

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

@@ -1,7 +1,9 @@
 import { TString } from '../base/TString.js';
 export const SSHPrivatekKeyTypes = ['OPENSSH', 'RSA'];
 export class TSSHPrivateKey extends TString {
-    static FORMAT = /^-----BEGIN (OPENSSH|RSA) PRIVATE KEY-----\n(.+)?\n-----END (OPENSSH|RSA) PRIVATE KEY-----$/is;
+    static FORMAT = 
+    // @ts-ignore
+    /^-----BEGIN (OPENSSH|RSA) PRIVATE KEY-----\n(.+)?\n-----END (OPENSSH|RSA) PRIVATE KEY-----$/is;
     constructor(constraints) {
         super({
             ...constraints,

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

@@ -1,4 +1,5 @@
 import { TString } from '../base/TString.js';
+// TODO : Add basic syntax validation (without adding any dependencies)
 export class TSemVerVersion extends TString {
     static FORMAT = /^([0-9]+)\.([0-9]+)\.([0-9]+)$/;
     constructor(constraints) {

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

@@ -1,4 +1,5 @@
 import { TString } from '../base/TString.js';
+// TODO : Add basic syntax validation (without adding any dependencies)
 export class TShellCommand extends TString {
     tName() {
         return 'ShellCommand';

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

@@ -1,5 +1,6 @@
 import { TString } from '../base/TString.js';
 export class TURL extends TString {
+    // Inspired by https://github.com/jquense/yup/blob/master/src/string.ts#L24
     static FORMAT = /^((https?|ftp):)?\/\/(((([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(%[\da-f]{2})|[!\$&'\(\)\*\+,;=]|:)*@)?(((\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])\.(\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])\.(\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])\.(\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5]))|((([a-z]|\d|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(([a-z]|\d|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])*([a-z]|\d|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])))\.)+(([a-z]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(([a-z]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])*([a-z]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])))\.?)(:\d*)?)(\/((([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(%[\da-f]{2})|[!\$&'\(\)\*\+,;=]|:|@)+(\/(([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(%[\da-f]{2})|[!\$&'\(\)\*\+,;=]|:|@)*)*)?)?(\?((([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(%[\da-f]{2})|[!\$&'\(\)\*\+,;=]|:|@)|[\uE000-\uF8FF]|\/|\?)*)?(\#((([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(%[\da-f]{2})|[!\$&'\(\)\*\+,;=]|:|@)|\/|\?)*)?$/i;
     constructor(constraints) {
         super({
@@ -20,6 +21,7 @@ export class TURL extends TString {
         return 'url';
     }
     validate() {
+        // Workaround for https://github.com/jquense/yup/issues/224
         if (this.isLocalhost()) {
             this.removeFormatConstraint();
         }

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

@@ -1,5 +1,6 @@
 import { TString } from '../base/TString.js';
 export class TUUID extends TString {
+    // Inspired by https://github.com/jquense/yup/blob/master/src/string.ts#L29
     static FORMAT = /^(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000)$/i;
     constructor(constraints) {
         super({

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

@@ -15,6 +15,6 @@ export class TYesNo extends TString {
         return 'YesNo';
     }
     example() {
-        return 'Y';
+        return 'Y'; // Yes Man !
     }
 }

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

@@ -2,6 +2,22 @@ import type { DataType, TBase, TName } from '../dt/index.js';
 import type { ProductWording } from '../product/index.js';
 import type { I18nManager } from '../std/index.js';
 import type { UCClientConfirmConfig, UCDef, UCExecState, UCFieldKey, UCInput, UCInputField, UCName, UCOPIBase, UCOutputPartIdx, UCOutputPartWording, UCWording } from '../uc/index.js';
+/**
+ * A key to translate
+ *
+ *   - uc_CreateX_desc, uc_CreateX_label
+ *   - ucif_name_desc, uc_name_label, uc_isEnabled_desc, uc_isEnabled_label
+ *
+ * NOTE : The choice has been made to consider the input fields as "global".
+ * Which means, their key is not prefixed by the use case name (e.g. ucif_CreateX_ucif_name_desc).
+ * This has multiple advantages :
+ *
+ *   - The same field present in multiple use cases will be automatically translated
+ *   - It gives more consistency through the app with the same thing always named the same way
+ *
+ * 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 declare class WordingManager {
     private i18nManager;

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

@@ -1,6 +1,11 @@
 import type { ViolationI18nable, YesNo } from '../dt/index.js';
 import type { UCClientConfirmConfig, UCExecState, UCWording } from '../uc/index.js';
 export type I18nLanguageCode = 'en' | 'fr';
+/**
+ * A translation value
+ *
+ * It can contain `{{placeholders}}`.
+ */
 export type I18nTranslation = string;
 export type I18nTranslationKey = string;
 export type I18nCoreKey = ViolationI18nable | `dt_YesNo_${YesNo}_${keyof UCWording}` | `uc_client_confirm_${keyof UCClientConfirmConfig}` | `uc_i_submit_${UCExecState}`;

package/dist/esm/icon/Icon.d.ts

@@ -1 +1,8 @@
+/**
+ * The icon code (e.g. https://fontawesome.com/v6/search?o=s&m=free)
+ *
+ * There are thousands of them so we voluntarily keep it a simple string and not a union type that would become unmaintainable.
+ *
+ * You can naturally use a different icon library as long as the renderer handles it.
+ */
 export type IconCode = string;

package/dist/esm/index.d.ts

@@ -11,8 +11,11 @@ export * from './std/impl/FakeFSManager.js';
 export * from './std/impl/FakeHTTPAPICallExecutor.js';
 export * from './std/impl/FakeJobManager.js';
 export * from './std/impl/FetchHTTPAPICallExecutor.js';
+export * from './std/impl/MistralAILLMManager.js';
 export * from './std/impl/NoopHTTPAPICallExecutorAgentBuilder.js';
 export * from './std/impl/NoopXMLManager.js';
+export * from './std/impl/OllamaLLMManager.js';
+export * from './std/impl/OpenAILLMManager.js';
 export * from './std/impl/SettingsServerClientManager.js';
 export * from './std/impl/SimpleFormDataBuilder.js';
 export * from './std/impl/SimpleHTTPAPICaller.js';

package/dist/esm/index.js

@@ -1,3 +1,4 @@
+// Export only the implementations that have no external dependencies (Otherwise, export them in index.x.ts)
 export * from './app/index.js';
 export * from './dt/index.js';
 export * from './error/index.js';
@@ -11,8 +12,11 @@ export * from './std/impl/FakeFSManager.js';
 export * from './std/impl/FakeHTTPAPICallExecutor.js';
 export * from './std/impl/FakeJobManager.js';
 export * from './std/impl/FetchHTTPAPICallExecutor.js';
+export * from './std/impl/MistralAILLMManager.js';
 export * from './std/impl/NoopHTTPAPICallExecutorAgentBuilder.js';
 export * from './std/impl/NoopXMLManager.js';
+export * from './std/impl/OllamaLLMManager.js';
+export * from './std/impl/OpenAILLMManager.js';
 export * from './std/impl/SettingsServerClientManager.js';
 export * from './std/impl/SimpleFormDataBuilder.js';
 export * from './std/impl/SimpleHTTPAPICaller.js';

package/dist/esm/index.react-native-pure.d.ts

@@ -0,0 +1,10 @@
+export { UCAutoExecLoader } from './target/react-native-pure/UCAutoExecLoader.js';
+export { UCEntrypointTouchable } from './target/react-native-pure/UCEntrypointTouchable.js';
+export { UCExecTouchable } from './target/react-native-pure/UCExecTouchable.js';
+export { UCForm } from './target/react-native-pure/UCForm.js';
+export { UCFormField } from './target/react-native-pure/UCFormField.js';
+export { UCFormFieldControl } from './target/react-native-pure/UCFormFieldControl.js';
+export { UCFormFieldDesc } from './target/react-native-pure/UCFormFieldDesc.js';
+export { UCFormFieldErr } from './target/react-native-pure/UCFormFieldErr.js';
+export { UCFormFieldLabel } from './target/react-native-pure/UCFormFieldLabel.js';
+export { UCFormSubmitControl } from './target/react-native-pure/UCFormSubmitControl.js';

package/dist/esm/index.react-native-pure.js

@@ -0,0 +1,10 @@
+export { UCAutoExecLoader } from './target/react-native-pure/UCAutoExecLoader.js';
+export { UCEntrypointTouchable } from './target/react-native-pure/UCEntrypointTouchable.js';
+export { UCExecTouchable } from './target/react-native-pure/UCExecTouchable.js';
+export { UCForm } from './target/react-native-pure/UCForm.js';
+export { UCFormField } from './target/react-native-pure/UCFormField.js';
+export { UCFormFieldControl } from './target/react-native-pure/UCFormFieldControl.js';
+export { UCFormFieldDesc } from './target/react-native-pure/UCFormFieldDesc.js';
+export { UCFormFieldErr } from './target/react-native-pure/UCFormFieldErr.js';
+export { UCFormFieldLabel } from './target/react-native-pure/UCFormFieldLabel.js';
+export { UCFormSubmitControl } from './target/react-native-pure/UCFormSubmitControl.js';

package/dist/esm/product/manifest.d.ts

@@ -1,8 +1,23 @@
 import type { AppName } from '../app/index.js';
 import type { UCName } from '../uc/index.js';
 export interface ProductAppReg {
+    /**
+     * It must correspond to the app folder name in the {@link APPS_ROOT_PATH}.
+     */
     name: AppName;
+    /**
+     * By default, a product mounts all the enabled use cases of an app.
+     *
+     * With this, you can override this default behavior.
+     */
     ucds?: {
+        /**
+         * Use Cases to exclude from the product
+         *
+         * For example, you can have a generic `Auth` app, used in multiple products.
+         * Some of them will require `SignUp` while others won't. With this setting,
+         * you can exclude the use cases that you don't want. In this case, they won't be mounted.
+         */
         exclude?: UCName[];
     } | undefined;
 }

package/dist/esm/products/Helper/index.js

@@ -3,6 +3,9 @@ import { NodeCoreCLIManager } from '../../target/node-core-cli/NodeCoreCLIManage
 import container from './container.js';
 const i18nManager = container.get('I18nManager');
 await i18nManager.init();
+// Before screaming, yes, this is not using any powerful CLI library.
+// The goal is to reduce the usage of dependencies as much as possible.
+// As long as the built-in Node.js API allows to build it without too many workarounds, let's keep it this way.
 await container.resolve(NodeCoreCLIManager).handleCommand({
     appsRootPath: container
         .get('FSManager')

package/dist/esm/products/Helper/manifest.d.ts

@@ -1 +1,6 @@
-export const Manifest: import("../../product/index.js").ProductManifest;
+export declare const Manifest: {
+    appReg: {
+        name: "Helper";
+    }[];
+    name: string;
+};

package/dist/esm/std/BufferManager.d.ts

@@ -1,4 +1,22 @@
 export type BufferManagerBase64String = string;
+/**
+ * The `Buffer` api is available in Node and similar server side environments. But it's not in browsers.
+ *
+ * Hence the need for this interface to provide multiple implementations (e.g. using https://github.com/feross/buffer).
+ *
+ * But the problem is that both implementations are redundant.
+ *
+ * TODO : Consider alternatives to BufferManager
+ *
+ * Possible solutions :
+ *
+ *   - Import the buffer lib as a polyfill
+ *   - Use only ECMAScript compatible primitives (`ArrayBuffer`, `Uint8Array`, `DataView`, etc.)
+ *   - Use BinaryJS
+ *   - Use Fast-Buffer
+ *
+ * Note that for the last two, keeping this interface makes actually sense since other impl. not `Buffer`-like can be used.
+ */
 export interface BufferManager {
     decodeBase64<T extends string>(value: BufferManagerBase64String): T;
     decodeUint8Array<T extends string>(value: Uint8Array): T;

package/dist/esm/std/ClockManager.d.ts

@@ -1,4 +1,9 @@
 import type { Timestamp } from '../dt/index.js';
+/**
+ * A key representing the date (e.g. 20241125141012)
+ *
+ * Useful to set a prefix when naming files in order to sort them
+ */
 export type ClockManagerDateKey = string;
 export interface ClockManager {
     now(): Date;

package/dist/esm/std/EnvironmentManager.d.ts

@@ -3,6 +3,16 @@ export type EnvironmentManagerEnvVarName = string;
 type Browser = 'chrome' | 'edge' | 'firefox' | 'opera' | 'safari';
 type MobileOS = 'android' | 'ios';
 type OS = 'darwin' | 'linux' | 'macos' | 'windows' | 'windows_nt';
+/**
+ * The type of environment
+ *
+ * The goal of this is not to give the final platform where the runtime is executed.
+ * For instance, in the context of a browser, we want to know that it's running on 'firefox' and not 'macos'.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/platform
+ * @see https://reactnative.dev/docs/platform#os
+ * @see https://nodejs.org/api/os.html#ostype
+ */
 export type EnvironmentManagerType = Browser | MobileOS | OS | (string & {});
 export interface EnvironmentManager {
     cwd(): FilePath;

package/dist/esm/std/HTTPAPICaller.d.ts

@@ -18,6 +18,9 @@ export interface HTTPAPICallerInputOpts {
     xml?: XMLManagerParseOpts;
 }
 export interface HTTPAPICallerInput<AH extends object | undefined, Req extends object, ResBad, ResGood, O> {
+    /**
+     * They are the last ones to be set so they will override any other header already set by `authorizationHeader` or `basicAuth` if any.
+     */
     additionalHeadersBuilder?: AdditionalHeadersBuilder<AH> | undefined;
     authorizationHeader?: HTTPAPICallerAuthorizationHeader | undefined;
     basicAuth?: HTTPAPICallerBasicAuth | undefined;
@@ -25,6 +28,9 @@ export interface HTTPAPICallerInput<AH extends object | undefined, Req extends o
     errBuilder: ErrBuilder<ResBad>;
     method: HTTPMethod;
     opts?: HTTPAPICallerInputOpts | undefined;
+    /**
+     * If not set, it will assume that `ResGood` and `O` are the same and thus return `ResGood` as is.
+     */
     outputBuilder?: OutputBuilder<ResGood, O> | undefined;
     req?: {
         builder: ReqBuilder<Req>;

package/dist/esm/std/I18nManager.d.ts

@@ -7,8 +7,34 @@ export interface I18nManagerTOpts {
     vars?: Record<string, string>;
 }
 export interface I18nManager extends Initializable {
+    /**
+     * Add a translation key
+     *
+     * It might not work for all the implementations, depending on where the translations are stored.
+     *
+     * @param key
+     * @param value
+     */
     add<K extends I18nTranslationKey>(key: K, value: string): Promise<void>;
+    /**
+     * Get the current lang code
+     */
     l(): I18nLanguageCode;
+    /**
+     * Get the translation for the given key
+     *
+     * If the key is missing, it should return `opts.fallback` if any. Otherwise, it should return the key itself.
+     *
+     * Optionally it can fail (by throwing) but that is not recommended since it impacts end users.
+     *
+     * @param key
+     * @param opts
+     */
     t<T extends I18nTranslationKey>(key: T, opts?: I18nManagerTOpts): string;
+    /**
+     * Get the translation for the given key, otherwise `null`
+     * @param key
+     * @param opts
+     */
     tOrNull<T extends I18nTranslationKey>(key: T, opts?: I18nManagerTOpts): string | null;
 }

package/dist/esm/std/JWTManager.d.ts

@@ -16,6 +16,9 @@ export interface JWTManagerSettings extends Settings {
     jwt_manager_subject: string | null;
 }
 export type JWTManagerDecodeOpts = Pick<JWTManagerEncodeOpts, 'secret'> & {
+    /**
+     * The public key to verify JWTs using an `alg` of type `RS*`
+     */
     spki?: SSHPublicKey;
 };
 export interface JWTManagerEncodeOpts {
@@ -28,7 +31,30 @@ export interface JWTManagerEncodeOpts {
     sub?: JWTManagerSettings['jwt_manager_subject'];
 }
 export interface JWTManager {
+    /**
+     * Decode the token
+     *
+     * Pass the ad-hoc opts when using a specific `alg` (e.g. `spki` when decoding a `RS*` token).
+     * If invalid, it must throw an {@link UnauthorizedError} (no errors related to the impl. should be thrown).
+     *
+     * @param value
+     * @param opts
+     */
     decode<T extends JWTManagerPayload>(value: JWT, opts?: JWTManagerDecodeOpts): Promise<T>;
+    /**
+     * Encode the payload
+     *
+     * It uses the global {@link JWTManagerSettings} or the ones provided via `opts`.
+     *
+     * @param payload
+     * @param opts
+     */
     encode<T extends object>(payload: T, opts?: JWTManagerEncodeOpts): Promise<JWT>;
+    /**
+     * Check whether the token is usable or not
+     *
+     * Note that the signature is not checked. Indeed, the main purpose of this method is to be used client side to save some requests (e.g. when the token is expired).
+     * In this case, no need to send a request that will trigger an error. Better to renew the token at the client's initiative.
+     */
     isUsable(value: JWT): Promise<boolean>;
 }

package/dist/esm/std/JobManager.d.ts

@@ -13,5 +13,11 @@ export interface JobManagerSettings extends Settings {
     }[];
 }
 export interface JobManager extends Clearable, Initializable {
+    /**
+     * Send a new job on the queue for processing
+     * @param queueName
+     * @param jobName
+     * @param input
+     */
     dispatch<I>(queueName: JobManagerQueueName, jobName: JobManagerJobName, input: I): Promise<void>;
 }

package/dist/esm/std/LLMManager.d.ts

@@ -0,0 +1,25 @@
+import type { FreeTextLong } from '../dt/index.js';
+export type LLMManagerModel = string;
+export type LLMManagerTemperature = number;
+export interface LLMManagerSendReq {
+    messages: {
+        content: FreeTextLong;
+        /**
+         * In the case of OpenAI :
+         * > With o1 models and newer, developer messages replace the previous system messages
+         */
+        role: 'assistant' | 'developer' | 'system' | 'user';
+    }[];
+    model: LLMManagerModel;
+    temperature?: LLMManagerTemperature;
+}
+export interface LLMManagerSendRes {
+    choices: {
+        message: {
+            content: string;
+        };
+    }[];
+}
+export interface LLMManager {
+    send(req: LLMManagerSendReq): Promise<LLMManagerSendRes>;
+}

package/dist/esm/std/LLMManager.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/std/PromptManager.d.ts

@@ -1,4 +1,12 @@
 export interface PromptManagerPromptOpts<T extends string> {
+    /**
+     * Predicate to validate the input
+     *
+     * It keeps asking while the value is not valid, unless the user presses `Ctrl+C`.
+     *
+     * @param value
+     * @returns
+     */
     validate?: (value: T) => Promise<boolean>;
 }
 export interface PromptManager {

package/dist/esm/std/SettingsManager.d.ts

@@ -1,10 +1,29 @@
+/**
+ * Placeholder for string settings that must be defined explicitly at runtime (e.g. secrets).
+ */
 export declare const SettingsManagerMandatoryPlaceholder = "!<>!";
+/**
+ * Placeholder for array settings that must be defined explicitly at runtime (e.g. secrets).
+ */
 export declare const SettingsManagerMandatoryPlaceholderForArray: string[];
+/**
+ * Placeholder for object settings that must be defined explicitly at runtime (e.g. secrets).
+ */
 export declare const SettingsManagerMandatoryPlaceholderForObject: {
     '0': string;
 };
+/**
+ * A group of settings
+ *
+ * Prefix them with the thing that is configurable to avoid conflicts when defining settings together for a product and/or a target.
+ */
 export interface Settings {
 }
+/**
+ * Interface to implement by the classes that needs settings
+ *
+ * As `S`, pass the subset of settings that the class needs (e.g. `Pick<SomeSettings, 'setting_1'>`).
+ */
 export interface Configurable<S> {
     s(): S;
 }

package/dist/esm/std/SettingsManager.js

@@ -1,7 +1,16 @@
+/**
+ * Placeholder for string settings that must be defined explicitly at runtime (e.g. secrets).
+ */
 export const SettingsManagerMandatoryPlaceholder = '!<>!';
+/**
+ * Placeholder for array settings that must be defined explicitly at runtime (e.g. secrets).
+ */
 export const SettingsManagerMandatoryPlaceholderForArray = [
     SettingsManagerMandatoryPlaceholder,
 ];
+/**
+ * Placeholder for object settings that must be defined explicitly at runtime (e.g. secrets).
+ */
 export const SettingsManagerMandatoryPlaceholderForObject = {
     '0': SettingsManagerMandatoryPlaceholder,
 };

package/dist/esm/std/impl/ConsoleLogger.js

@@ -15,6 +15,7 @@ import { inject, injectable } from 'inversify';
 let ConsoleLogger = class ConsoleLogger {
     static { ConsoleLogger_1 = this; }
     settingsManager;
+    // Ordered by level
     static LEVELS = [
         'trace',
         'debug',
@@ -34,30 +35,35 @@ let ConsoleLogger = class ConsoleLogger {
         if (!this.shouldLog('debug')) {
             return;
         }
+        // biome-ignore lint/suspicious/noConsole: we want it
         console.debug(`${this.t()} [debug] ${message}`, ...meta);
     }
     error(err) {
         if (!this.shouldLog('error')) {
             return;
         }
+        // biome-ignore lint/suspicious/noConsole: we want it
         console.error(err);
     }
     info(message, ...meta) {
         if (!this.shouldLog('info')) {
             return;
         }
+        // biome-ignore lint/suspicious/noConsole: we want it
         console.info(`${this.t()} [info] ${message}`, ...meta);
     }
     trace(message, ...meta) {
         if (!this.shouldLog('trace')) {
             return;
         }
-        console.debug(`${this.t()} [trace] ${message}`, ...meta);
+        // biome-ignore lint/suspicious/noConsole: we want it
+        console.trace(`${this.t()} [trace] ${message}`, ...meta);
     }
     warn(message, ...meta) {
         if (!this.shouldLog('warn')) {
             return;
         }
+        // biome-ignore lint/suspicious/noConsole: we want it
         console.warn(`${this.t()} [warn] ${message}`, ...meta);
     }
     shouldLog(level) {

package/dist/esm/std/impl/FakeEmailManager.js

@@ -20,6 +20,7 @@ let FakeEmailManager = class FakeEmailManager {
         this.entries.push({ def, replyTo, to });
     }
     async verify() {
+        // Nothing to do
     }
 };
 FakeEmailManager = __decorate([

package/dist/esm/std/impl/FakeJobManager.js

@@ -20,6 +20,7 @@ let FakeJobManager = class FakeJobManager {
         this.entries.push({ input, jobName, queueName });
     }
     async init() {
+        // Nothing to do
     }
 };
 FakeJobManager = __decorate([

package/dist/esm/std/impl/FetchHTTPAPICallExecutor.d.ts

@@ -1,4 +1,13 @@
 import type { HTTPAPICallExecutor, HTTPAPICallExecutorFunc } from '../HTTPAPICallExecutor.js';
+/**
+ * Nowadays, most platforms include it as a global :
+ *
+ *   - Node : https://nodejs.org/api/globals.html#fetch
+ *   - RN   : https://reactnative.dev/docs/network#using-fetch
+ *   - Web  : https://developer.mozilla.org/fr/docs/Web/API/Fetch_API
+ *
+ * So we should be safe using it almost everywhere.
+ */
 export declare class FetchHTTPAPICallExecutor implements HTTPAPICallExecutor {
     fn<Res>(): HTTPAPICallExecutorFunc<Res>;
 }

package/dist/esm/std/impl/FetchHTTPAPICallExecutor.js

@@ -5,8 +5,19 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { injectable } from 'inversify';
+/**
+ * Nowadays, most platforms include it as a global :
+ *
+ *   - Node : https://nodejs.org/api/globals.html#fetch
+ *   - RN   : https://reactnative.dev/docs/network#using-fetch
+ *   - Web  : https://developer.mozilla.org/fr/docs/Web/API/Fetch_API
+ *
+ * So we should be safe using it almost everywhere.
+ */
 let FetchHTTPAPICallExecutor = class FetchHTTPAPICallExecutor {
     fn() {
+        // The generalization in HTTPAPICallExecutor is not exactly the same as the actual implementation
+        // @ts-ignore
         return fetch;
     }
 };

package/dist/esm/std/impl/MistralAILLMManager.d.ts

@@ -0,0 +1,17 @@
+import type { ApiKey } from '../../dt/index.js';
+import type { HTTPAPICaller } from '../HTTPAPICaller.js';
+import type { LLMManager, LLMManagerSendReq, LLMManagerSendRes } from '../LLMManager.js';
+import type { Configurable, Settings, SettingsManager } from '../SettingsManager.js';
+export interface MistralAILLMManagerSettings extends Settings {
+    mai_api_key: ApiKey;
+}
+type S = MistralAILLMManagerSettings;
+export declare class MistralAILLMManager implements Configurable<S>, LLMManager {
+    private httpAPICaller;
+    private settingsManager;
+    private static BASE_URL;
+    constructor(httpAPICaller: HTTPAPICaller, settingsManager: SettingsManager<S>);
+    s(): MistralAILLMManagerSettings;
+    send(req: LLMManagerSendReq): Promise<LLMManagerSendRes>;
+}
+export {};