libmodulor 0.26.0 → 0.28.0

package/dist/esm/target/lib/cli/renderer.js

@@ -3,18 +3,17 @@ export function print(line) {
     // biome-ignore lint/suspicious/noConsole: we want it
     console.info(line);
 }
-export function printError(err) {
-    let message = '';
-    if (err instanceof Error) {
-        message = err.message;
-        if (!(err instanceof CustomError)) {
-            // biome-ignore lint/suspicious/noConsole: we want it
-            console.error(err);
-        }
+export function printError(i18nManager, err) {
+    if (typeof err === 'string') {
+        // biome-ignore lint/suspicious/noConsole: we want it
+        console.error(err);
+        return;
     }
-    else if (typeof err === 'string') {
-        message = err;
+    if (!(err instanceof CustomError)) {
+        // biome-ignore lint/suspicious/noConsole: we want it
+        console.error(err);
+        return;
     }
     // biome-ignore lint/suspicious/noConsole: we want it
-    console.error(message);
+    console.error(i18nManager.t(err.message));
 }

package/dist/esm/target/lib/server/AuthenticationChecker.d.ts

@@ -1,4 +1,4 @@
-import { type Provider } from 'inversify';
+import { type Factory } from 'inversify';
 import type { AppManifest } from '../../../app/index.js';
 import type { Logger, Worker } from '../../../std/index.js';
 import { type UC, type UCAuth, type UCDef, type UCInput, type UCOPIBase, type UCPolicy } from '../../../uc/index.js';
@@ -23,8 +23,8 @@ export declare class AuthenticationChecker implements Worker<Input, Promise<Outp
     private jwtAuthenticationChecker;
     private privateApiKeyAuthenticationChecker;
     private logger;
-    private ucPolicyProvider;
-    constructor(basicAuthenticationChecker: BasicAuthenticationChecker, jwtAuthenticationChecker: JWTAuthenticationChecker, privateApiKeyAuthenticationChecker: PrivateApiKeyAuthenticationChecker, logger: Logger, ucPolicyProvider: Provider<UCPolicy>);
+    private ucPolicyFactory;
+    constructor(basicAuthenticationChecker: BasicAuthenticationChecker, jwtAuthenticationChecker: JWTAuthenticationChecker, privateApiKeyAuthenticationChecker: PrivateApiKeyAuthenticationChecker, logger: Logger, ucPolicyFactory: Factory<UCPolicy>);
     exec<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>({ authCookie, authorizationHeader, uc, }: Input<I, OPI0, OPI1>): Promise<Output>;
 }
 export {};

package/dist/esm/target/lib/server/AuthenticationChecker.js

@@ -21,13 +21,13 @@ let AuthenticationChecker = class AuthenticationChecker {
     jwtAuthenticationChecker;
     privateApiKeyAuthenticationChecker;
     logger;
-    ucPolicyProvider;
-    constructor(basicAuthenticationChecker, jwtAuthenticationChecker, privateApiKeyAuthenticationChecker, logger, ucPolicyProvider) {
+    ucPolicyFactory;
+    constructor(basicAuthenticationChecker, jwtAuthenticationChecker, privateApiKeyAuthenticationChecker, logger, ucPolicyFactory) {
         this.basicAuthenticationChecker = basicAuthenticationChecker;
         this.jwtAuthenticationChecker = jwtAuthenticationChecker;
         this.privateApiKeyAuthenticationChecker = privateApiKeyAuthenticationChecker;
         this.logger = logger;
-        this.ucPolicyProvider = ucPolicyProvider;
+        this.ucPolicyFactory = ucPolicyFactory;
     }
     async exec({ authCookie, authorizationHeader, uc, }) {
         this.logger.trace('Checking auth', {
@@ -43,7 +43,7 @@ let AuthenticationChecker = class AuthenticationChecker {
             return output;
         }
         const authType = sec?.authType ?? DEFAULT_UC_SEC_AT;
-        const policy = (await this.ucPolicyProvider(server.policy));
+        const policy = (await this.ucPolicyFactory(server.policy));
         const canBeExecutedPreAuth = await policy.canBeExecutedPreAuth();
         if (canBeExecutedPreAuth) {
             const { allowed } = await policy.exec({
@@ -101,7 +101,7 @@ AuthenticationChecker = __decorate([
     __param(1, inject(JWTAuthenticationChecker)),
     __param(2, inject(PrivateApiKeyAuthenticationChecker)),
     __param(3, inject('Logger')),
-    __param(4, inject('Provider<UCPolicy>')),
+    __param(4, inject('Factory<UCPolicy>')),
     __metadata("design:paramtypes", [BasicAuthenticationChecker,
         JWTAuthenticationChecker,
         PrivateApiKeyAuthenticationChecker, Object, Function])

package/dist/esm/target/node-core-cli/NodeCoreCLIManager.js

@@ -41,7 +41,7 @@ let NodeCoreCLIManager = class NodeCoreCLIManager {
             uc.def.ext?.cmd?.mountAt ?? ucMountingPoint(uc),
             uc,
         ]));
-        if (!command || !command.trim() || command === '--help') {
+        if (!command?.trim() || command === '--help') {
             showHelp(ucs, this.wordingManager);
         }
         else if (command === '--version') {

package/dist/esm/target/react-web-pure/UCForm.d.ts

@@ -1,4 +1,4 @@
 import { type ReactElement } from 'react';
-import type { UCInput, UCOPIBase } from '../../uc/index.js';
+import { type UCInput, type UCOPIBase } from '../../uc/index.js';
 import type { UCFormProps } from '../lib/react/form.js';
 export declare function UCForm<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>({ clearAfterExec, disabled, execState, onSubmit: onSubmitBase, uc, }: UCFormProps<I, OPI0, OPI1>): ReactElement;

package/dist/esm/target/react-web-pure/UCForm.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useRef } from 'react';
+import { UCExecRes } from '../../uc/index.js';
 import { useStyleContext } from '../lib/react/StyleContextProvider.js';
 import { UCFormField } from './UCFormField.js';
 import { UCFormSubmitControl } from './UCFormSubmitControl.js';
@@ -8,8 +9,8 @@ export function UCForm({ clearAfterExec, disabled, execState, onSubmit: onSubmit
     const formRef = useRef(null);
     const onSubmit = async (e) => {
         e.preventDefault();
-        const succeeded = await onSubmitBase();
-        if (succeeded && clearAfterExec) {
+        const res = await onSubmitBase();
+        if (res === UCExecRes.SUCCEEDED && clearAfterExec) {
             formRef.current?.reset();
         }
     };

package/dist/esm/testing/workers/checkers/AppI18nChecker.js

@@ -16,7 +16,7 @@ const ERR_I18N_LABEL_NO_DOT = (key) => `The i18n key '${key}' is a label, thus i
 const ERR_I18N_MISSING_TRANS = (key, lang) => `The i18n key '${key}' is missing for lang '${lang}'`;
 let AppI18nChecker = class AppI18nChecker {
     static { AppI18nChecker_1 = this; }
-    static I18N_KEY_PATTERN = /(dt_([A-Z][A-Za-z0-9]+)_([A-Za-z0-9]+)_(desc|label))|(err_([A-Za-z_]+))|(uc_([A-Z][A-Za-z0-9]+)_(client_confirm_(cancel|confirm|message|title)|desc|label|i_submit_(changing|idle|initializing|submitting)|op_(0|1)_(empty|label)))|(ucif_([a-z]([A-Za-z0-9]+)?)_(desc|label))|(ucof_([a-z]([A-Za-z0-9]+)?)_(desc|label))|(validation_([a-z]+)_([A-Z][A-Za-z0-9]+))/;
+    static I18N_KEY_PATTERN = /(dt_([A-Z][A-Za-z0-9]+)_constr_format)|(dt_([A-Z][A-Za-z0-9]+)_([A-Za-z0-9]+)_(desc|label))|(err_([A-Za-z_]+))|(uc_([A-Z][A-Za-z0-9]+)_(client_confirm_(cancel|confirm|message|title)|desc|label|i_submit_(changing|idle|initializing|submitting)|op_(0|1)_(empty|label)))|(ucif_([a-z]([A-Za-z0-9]+)?)_(desc|label))|(ucof_([a-z]([A-Za-z0-9]+)?)_(desc|label))|(validation_([a-z]+)_([A-Z][A-Za-z0-9]+))/;
     output;
     constructor() {
         this.output = { errors: [] };
@@ -41,7 +41,9 @@ let AppI18nChecker = class AppI18nChecker {
                 if (!matches) {
                     this.output.errors.push(ERR_I18N_KEY_INVALID(key));
                 }
-                if (key.endsWith('_label') && translation.endsWith('.')) {
+                if (key.endsWith('_label') &&
+                    translation.endsWith('.') &&
+                    !translation.endsWith('...')) {
                     this.output.errors.push(ERR_I18N_LABEL_NO_DOT(key));
                 }
             }

package/dist/esm/uc/data-store.d.ts

@@ -1,11 +1,18 @@
 import type { AppName } from '../app/index.js';
 import type { UIntQuantity, UUID } from '../dt/index.js';
-import type { Clearable, Initializable, StringKeys } from '../utils/index.js';
+import type { Clearable, EnumOf, Initializable, StringKeys } from '../utils/index.js';
 import type { UCData } from './data.js';
 import type { UCExecMode } from './exec.js';
 import type { UCInput } from './input.js';
 import type { UCName } from './metadata.js';
 export type UCDataStoreDatasetName = string;
+export declare const UCDataStoreMode: {
+    readonly NONE: "NONE";
+    readonly READ: "READ";
+    readonly READ_WRITE: "READ_WRITE";
+    readonly WRITE: "WRITE";
+};
+export type UCDataStoreMode = EnumOf<typeof UCDataStoreMode>;
 interface UCDataStoreQueryOpts {
 }
 export type UCDataStoreReadFilter<T> = T | T[];
@@ -67,4 +74,5 @@ export interface UCDataStore extends Clearable, Initializable {
     writeBulk<I extends UCInput | undefined = undefined, D extends UCData | null = null>(records: UCDataStoreRecord<I, D>[], opts?: UCDataStoreWriteOpts): Promise<void>;
     writeProjection<T extends object>(name: string, data: T, opts?: UCDataStoreWriteProjectionOpts): Promise<void>;
 }
+export declare function assertCan(op: 'read' | 'write', mode: UCDataStoreMode): void;
 export {};

package/dist/esm/uc/data-store.js

@@ -1 +1,33 @@
-export {};
+import { UnavailableError } from '../error/index.js';
+export const UCDataStoreMode = {
+    NONE: 'NONE',
+    READ: 'READ',
+    READ_WRITE: 'READ_WRITE',
+    WRITE: 'WRITE',
+};
+export function assertCan(op, mode) {
+    switch (mode) {
+        case 'NONE':
+            if (op === 'read') {
+                throw new UnavailableError('err_uc_data_store_not_readable');
+            }
+            if (op === 'write') {
+                throw new UnavailableError('err_uc_data_store_not_writable');
+            }
+            break;
+        case 'READ':
+            if (op === 'write') {
+                throw new UnavailableError('err_uc_data_store_not_writable');
+            }
+            break;
+        case 'READ_WRITE':
+            break;
+        case 'WRITE':
+            if (op === 'read') {
+                throw new UnavailableError('err_uc_data_store_not_readable');
+            }
+            break;
+        default:
+            mode;
+    }
+}

package/dist/esm/uc/impl/CloudflareD1UCDataStore.d.ts

@@ -1,10 +1,10 @@
 import type { D1Database } from '@cloudflare/workers-types';
 import type { Configurable, SettingsManager } from '../../std/index.js';
 import type { UCData } from '../data.js';
-import type { UCDataStore, UCDataStoreReadOpts, UCDataStoreReadProjectionOpts, UCDataStoreReadResponse, UCDataStoreRecord, UCDataStoreTx, UCDataStoreWriteOpts, UCDataStoreWriteProjectionOpts, UCDataStoreWriteProjectionSpecificBinding } from '../data-store.js';
+import { type UCDataStore, type UCDataStoreReadOpts, type UCDataStoreReadProjectionOpts, type UCDataStoreReadResponse, type UCDataStoreRecord, type UCDataStoreTx, type UCDataStoreWriteOpts, type UCDataStoreWriteProjectionOpts, type UCDataStoreWriteProjectionSpecificBinding } from '../data-store.js';
 import type { UCInput } from '../input.js';
 import type { UCSettings } from '../settings.js';
-type S = Pick<UCSettings, 'uc_data_store_ucs_dataset_name'>;
+type S = Pick<UCSettings, 'uc_data_store_mode' | 'uc_data_store_ucs_dataset_name'>;
 export declare const ROW_COLS: (keyof UCDataStoreRecord)[];
 /**
  * @alpha This implementation is still a WIP and needs improvement

package/dist/esm/uc/impl/CloudflareD1UCDataStore.js

@@ -12,6 +12,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { inject, injectable } from 'inversify';
 import { NotAvailableError, NotImplementedError } from '../../error/index.js';
+import { assertCan, } from '../data-store.js';
 export const ROW_COLS = [
     'aggregateId',
     'appName',
@@ -38,6 +39,7 @@ let CloudflareD1UCDataStore = class CloudflareD1UCDataStore {
     }
     s() {
         return {
+            uc_data_store_mode: this.settingsManager.get()('uc_data_store_mode'),
             uc_data_store_ucs_dataset_name: this.settingsManager.get()('uc_data_store_ucs_dataset_name'),
         };
     }
@@ -92,6 +94,7 @@ CREATE INDEX IF NOT EXISTS uc_executions_user_id_index ON uc_executions (userId)
     }
     async read(opts) {
         this.assertClient();
+        assertCan('read', this.s().uc_data_store_mode);
         // TODO : Consider using a query builder (or Google's pipe operator ?) when it gets too complicated or dangerous
         const query = [
             `select * from ${this.s().uc_data_store_ucs_dataset_name}`,
@@ -131,6 +134,7 @@ CREATE INDEX IF NOT EXISTS uc_executions_user_id_index ON uc_executions (userId)
         };
     }
     async readProjection(_name, _opts) {
+        assertCan('read', this.s().uc_data_store_mode);
         throw new NotImplementedError('readProjection');
     }
     async startTx() {
@@ -144,6 +148,7 @@ CREATE INDEX IF NOT EXISTS uc_executions_user_id_index ON uc_executions (userId)
     }
     async write(record, _opts) {
         this.assertClient();
+        assertCan('write', this.s().uc_data_store_mode);
         const cols = ROW_COLS.join(', ');
         const placeholders = ROW_COLS.map(() => '?').join(', ');
         // Use variables only for variables declared here => never for data coming from outside this method !
@@ -166,9 +171,11 @@ CREATE INDEX IF NOT EXISTS uc_executions_user_id_index ON uc_executions (userId)
             .run();
     }
     async writeBulk(_records, _opts) {
+        assertCan('write', this.s().uc_data_store_mode);
         throw new NotImplementedError('writeBulk');
     }
     async writeProjection(_name, _data, _opts) {
+        assertCan('write', this.s().uc_data_store_mode);
         throw new NotImplementedError('writeProjection');
     }
     setClient(client) {

package/dist/esm/uc/impl/InMemoryUCDataStore.d.ts

@@ -1,11 +1,16 @@
+import type { Configurable, SettingsManager } from '../../std/index.js';
 import type { UCData } from '../data.js';
-import type { UCDataStore, UCDataStoreReadOpts, UCDataStoreReadResponse, UCDataStoreRecord, UCDataStoreTx, UCDataStoreWriteProjectionSpecificBinding } from '../data-store.js';
+import { type UCDataStore, type UCDataStoreReadOpts, type UCDataStoreReadResponse, type UCDataStoreRecord, type UCDataStoreTx, type UCDataStoreWriteProjectionSpecificBinding } from '../data-store.js';
 import type { UCInput } from '../input.js';
+import type { UCSettings } from '../settings.js';
 type TxState = 'committed' | 'pending' | 'rollbacked';
-export declare class InMemoryUCDataStore implements UCDataStore {
+type S = Pick<UCSettings, 'uc_data_store_mode'>;
+export declare class InMemoryUCDataStore implements Configurable<S>, UCDataStore {
+    protected settingsManager: SettingsManager<S>;
     entries: UCDataStoreRecord<any, any>[];
     tx: TxState | undefined;
-    constructor();
+    constructor(settingsManager: SettingsManager<S>);
+    s(): S;
     clear(): Promise<void>;
     destroy(): Promise<void>;
     exists(): Promise<boolean>;

package/dist/esm/uc/impl/InMemoryUCDataStore.js

@@ -7,8 +7,12 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { injectable } from 'inversify';
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from 'inversify';
 import { NotImplementedError } from '../../error/index.js';
+import { assertCan, } from '../data-store.js';
 function predicate(key, filter) {
     if (filter === null) {
         return (r) => r[key] === null;
@@ -19,12 +23,19 @@ function predicate(key, filter) {
     return (r) => r[key] === filter;
 }
 let InMemoryUCDataStore = class InMemoryUCDataStore {
+    settingsManager;
     // biome-ignore lint/suspicious/noExplicitAny: can be anything
     entries;
     tx;
-    constructor() {
+    constructor(settingsManager) {
+        this.settingsManager = settingsManager;
         this.entries = [];
     }
+    s() {
+        return {
+            uc_data_store_mode: this.settingsManager.get()('uc_data_store_mode'),
+        };
+    }
     async clear() {
         this.entries = [];
     }
@@ -41,6 +52,7 @@ let InMemoryUCDataStore = class InMemoryUCDataStore {
         // Nothing to do
     }
     async read(opts) {
+        assertCan('read', this.s().uc_data_store_mode);
         let items = this
             .entries;
         // Filter
@@ -70,6 +82,7 @@ let InMemoryUCDataStore = class InMemoryUCDataStore {
         };
     }
     async readProjection() {
+        assertCan('read', this.s().uc_data_store_mode);
         return [];
     }
     async startTx() {
@@ -94,14 +107,17 @@ let InMemoryUCDataStore = class InMemoryUCDataStore {
         this.writeBulk([record]);
     }
     async writeBulk(records) {
+        assertCan('write', this.s().uc_data_store_mode);
         this.entries.push(...records);
     }
     async writeProjection() {
+        assertCan('write', this.s().uc_data_store_mode);
         throw new NotImplementedError('writeProjection');
     }
 };
 InMemoryUCDataStore = __decorate([
     injectable(),
-    __metadata("design:paramtypes", [])
+    __param(0, inject('SettingsManager')),
+    __metadata("design:paramtypes", [Object])
 ], InMemoryUCDataStore);
 export { InMemoryUCDataStore };

package/dist/esm/uc/impl/KnexUCDataStore.d.ts

@@ -2,7 +2,7 @@ import { type Knex } from 'knex';
 import type { FilePath, UIntQuantity } from '../../dt/index.js';
 import type { Configurable, Settings, SettingsManager } from '../../std/index.js';
 import type { UCData } from '../data.js';
-import type { UCDataStore, UCDataStoreReadOpts, UCDataStoreReadProjectionOpts, UCDataStoreReadResponse, UCDataStoreRecord, UCDataStoreTx, UCDataStoreWriteOpts, UCDataStoreWriteProjectionOpts, UCDataStoreWriteProjectionSpecificBinding } from '../data-store.js';
+import { type UCDataStore, type UCDataStoreReadOpts, type UCDataStoreReadProjectionOpts, type UCDataStoreReadResponse, type UCDataStoreRecord, type UCDataStoreTx, type UCDataStoreWriteOpts, type UCDataStoreWriteProjectionOpts, type UCDataStoreWriteProjectionSpecificBinding } from '../data-store.js';
 import type { UCInput } from '../input.js';
 import type { UCSettings } from '../settings.js';
 /**
@@ -16,7 +16,7 @@ export interface KnexUCDataStoreSettings extends Settings {
     knex_uc_data_store_pool_min: UIntQuantity;
     knex_uc_data_store_type: 'pg' | 'sqlite3';
 }
-type S = KnexUCDataStoreSettings & Pick<UCSettings, 'uc_data_store_ucs_dataset_name'>;
+type S = KnexUCDataStoreSettings & Pick<UCSettings, 'uc_data_store_mode' | 'uc_data_store_ucs_dataset_name'>;
 export declare class KnexUCDataStore implements Configurable<S>, UCDataStore {
     protected settingsManager: SettingsManager<S>;
     protected config: Knex.Config;

package/dist/esm/uc/impl/KnexUCDataStore.js

@@ -13,6 +13,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 import { inject, injectable } from 'inversify';
 import knex, {} from 'knex';
 import { NotAvailableError, NotCallableError } from '../../error/index.js';
+import { assertCan, } from '../data-store.js';
 const FILTERS_MAPPING = new Map([
     ['aggregateId', 'aggregate_id'],
     ['appName', 'app_name'],
@@ -37,6 +38,7 @@ let KnexUCDataStore = class KnexUCDataStore {
             knex_uc_data_store_pool_max: this.settingsManager.get()('knex_uc_data_store_pool_max'),
             knex_uc_data_store_pool_min: this.settingsManager.get()('knex_uc_data_store_pool_min'),
             knex_uc_data_store_type: this.settingsManager.get()('knex_uc_data_store_type'),
+            uc_data_store_mode: this.settingsManager.get()('uc_data_store_mode'),
             uc_data_store_ucs_dataset_name: this.settingsManager.get()('uc_data_store_ucs_dataset_name'),
         };
     }
@@ -58,6 +60,7 @@ let KnexUCDataStore = class KnexUCDataStore {
         throw new NotCallableError('initSync', 'init', 'async-only');
     }
     async read(opts) {
+        assertCan('read', this.s().uc_data_store_mode);
         const query = this.client(this.s().uc_data_store_ucs_dataset_name);
         // Filter
         if (opts?.filters) {
@@ -87,6 +90,7 @@ let KnexUCDataStore = class KnexUCDataStore {
         };
     }
     async readProjection(name, opts) {
+        assertCan('read', this.s().uc_data_store_mode);
         const query = this.client(name);
         // Sort
         if (opts?.orderBy) {
@@ -123,6 +127,7 @@ let KnexUCDataStore = class KnexUCDataStore {
         await this.writeBulk([record], opts);
     }
     async writeBulk(records, opts) {
+        assertCan('write', this.s().uc_data_store_mode);
         const query = this.client(this.s().uc_data_store_ucs_dataset_name).insert(records.map((r) => this.mapRecordToRow(r)));
         if (opts?.tx) {
             query.transacting(opts.tx.ref);
@@ -130,6 +135,7 @@ let KnexUCDataStore = class KnexUCDataStore {
         await query;
     }
     async writeProjection(name, data, opts) {
+        assertCan('write', this.s().uc_data_store_mode);
         const dataToInsert = {};
         for (const [k, v] of Object.entries(data)) {
             const specificBinding = opts?.specificBindings?.[k];
@@ -183,8 +189,10 @@ let KnexUCDataStore = class KnexUCDataStore {
             return;
         }
         Array.isArray(value)
-            ? query.whereIn(col, value)
-            : query.where(col, value);
+            ? // @ts-expect-error : https://github.com/knex/knex/pull/6428
+                query.whereIn(col, value)
+            : // @ts-expect-error : https://github.com/knex/knex/pull/6428
+                query.where(col, value);
     }
     mapRecordToRow(record) {
         return {

package/dist/esm/uc/impl/SimpleUCManager.d.ts

@@ -1,4 +1,4 @@
-import { type Provider } from 'inversify';
+import { type Factory } from 'inversify';
 import type { ClockManager, CryptoManager, Logger } from '../../std/index.js';
 import type { UCClientConfirmManager } from '../client.js';
 import type { UCData } from '../data.js';
@@ -23,10 +23,10 @@ export declare class SimpleUCManager implements UCManager {
     private ucExecChecker;
     private ucInputFilesProcessor;
     private ucInputValidator;
-    private ucInitProvider;
-    private ucMainProvider;
+    private ucInitFactory;
+    private ucMainFactory;
     private tx?;
-    constructor(ucClientConfirmManager: UCClientConfirmManager, clockManager: ClockManager, cryptoManager: CryptoManager, logger: Logger, ucDataStore: UCDataStore, ucExecChecker: UCExecChecker, ucInputFilesProcessor: UCInputFilesProcessor, ucInputValidator: UCInputValidator, ucInitProvider: Provider<UCInit>, ucMainProvider: Provider<UCMain>);
+    constructor(ucClientConfirmManager: UCClientConfirmManager, clockManager: ClockManager, cryptoManager: CryptoManager, logger: Logger, ucDataStore: UCDataStore, ucExecChecker: UCExecChecker, ucInputFilesProcessor: UCInputFilesProcessor, ucInputValidator: UCInputValidator, ucInitFactory: Factory<UCInit>, ucMainFactory: Factory<UCMain>);
     commitTx(): Promise<void>;
     confirmClient<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(uc: UC<I, OPI0, OPI1>): Promise<boolean>;
     execClient<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(uc: UC<I, OPI0, OPI1>, opts?: UCManagerExecClientOpts<I, OPI0, OPI1>): Promise<UCOutputReader<I, OPI0, OPI1>>;

package/dist/esm/uc/impl/SimpleUCManager.js

@@ -27,11 +27,11 @@ let SimpleUCManager = class SimpleUCManager {
     ucExecChecker;
     ucInputFilesProcessor;
     ucInputValidator;
-    ucInitProvider;
-    ucMainProvider;
+    ucInitFactory;
+    ucMainFactory;
     // WARNING : This property makes this class "thread unsafe". Be careful how you inject it into your components.
     tx;
-    constructor(ucClientConfirmManager, clockManager, cryptoManager, logger, ucDataStore, ucExecChecker, ucInputFilesProcessor, ucInputValidator, ucInitProvider, ucMainProvider) {
+    constructor(ucClientConfirmManager, clockManager, cryptoManager, logger, ucDataStore, ucExecChecker, ucInputFilesProcessor, ucInputValidator, ucInitFactory, ucMainFactory) {
         this.ucClientConfirmManager = ucClientConfirmManager;
         this.clockManager = clockManager;
         this.cryptoManager = cryptoManager;
@@ -40,8 +40,8 @@ let SimpleUCManager = class SimpleUCManager {
         this.ucExecChecker = ucExecChecker;
         this.ucInputFilesProcessor = ucInputFilesProcessor;
         this.ucInputValidator = ucInputValidator;
-        this.ucInitProvider = ucInitProvider;
-        this.ucMainProvider = ucMainProvider;
+        this.ucInitFactory = ucInitFactory;
+        this.ucMainFactory = ucMainFactory;
         this.tx = undefined;
     }
     async commitTx() {
@@ -80,7 +80,7 @@ let SimpleUCManager = class SimpleUCManager {
         if (server === undefined) {
             await this.ucInputFilesProcessor.exec({ uc });
         }
-        const main = (await this.ucMainProvider(client.main));
+        const main = (await this.ucMainFactory(client.main));
         const streamOpts = opts?.stream;
         const output = await main.exec({
             opts: {
@@ -113,7 +113,7 @@ let SimpleUCManager = class SimpleUCManager {
         }
         this.ucInputValidator.exec({ uc });
         await this.ucInputFilesProcessor.exec({ uc });
-        const main = (await this.ucMainProvider(server.main));
+        const main = (await this.ucMainFactory(server.main));
         const output = main.exec({
             opts: {
                 stream: opts?.stream,
@@ -132,7 +132,7 @@ let SimpleUCManager = class SimpleUCManager {
             return;
         }
         this.logger.info('Initializing ucd', { name: metadata.name });
-        const init = (await this.ucInitProvider(server.init));
+        const init = (await this.ucInitFactory(server.init));
         await init.exec();
     }
     async startTx() {
@@ -179,8 +179,8 @@ SimpleUCManager = __decorate([
     __param(5, inject(UCExecChecker)),
     __param(6, inject(UCInputFilesProcessor)),
     __param(7, inject(UCInputValidator)),
-    __param(8, inject('Provider<UCInit>')),
-    __param(9, inject('Provider<UCMain>')),
+    __param(8, inject('Factory<UCInit>')),
+    __param(9, inject('Factory<UCMain>')),
     __metadata("design:paramtypes", [Object, Object, Object, Object, Object, UCExecChecker,
         UCInputFilesProcessor,
         UCInputValidator, Function, Function])

package/dist/esm/uc/settings/consts.js

@@ -1,4 +1,5 @@
 export const UC_DEFAULT_SETTINGS = {
+    uc_data_store_mode: 'READ_WRITE',
     uc_data_store_ucs_dataset_name: 'uc_executions',
     uc_disabled_use_cases: [],
     uc_file_ref_prefix: '$ref:',

package/dist/esm/uc/settings.d.ts

@@ -1,9 +1,15 @@
 import type { FilePath } from '../dt/index.js';
 import type { Settings } from '../std/index.js';
-import type { UCDataStoreDatasetName } from './data-store.js';
+import type { UCDataStoreDatasetName, UCDataStoreMode } from './data-store.js';
 import type { UCFileInputFieldRefPrefix } from './file.js';
 import type { UCName } from './metadata.js';
 export interface UCSettings extends Settings {
+    /**
+     * The mode of the data store.
+     *
+     * @default UC_DEFAULT_SETTINGS.uc_data_store_mode
+     */
+    uc_data_store_mode: UCDataStoreMode;
     /**
      * The name of the collection/table storing the persisted use cases in the data store
      *
@@ -22,6 +28,7 @@ export interface UCSettings extends Settings {
     uc_disabled_use_cases: UCName[];
     /**
      * The prefix of the file path when the use case has been processed, before storing
+     *
      * @default UC_DEFAULT_SETTINGS.uc_file_ref_prefix
      */
     uc_file_ref_prefix: UCFileInputFieldRefPrefix;

package/dist/esm/uc/workers/UCExecChecker.d.ts

@@ -1,4 +1,4 @@
-import { type Provider } from 'inversify';
+import { type Factory } from 'inversify';
 import type { ProductManifest } from '../../product/index.js';
 import type { Configurable, SettingsManager, Worker } from '../../std/index.js';
 import type { UCDefLifecycle } from '../def.js';
@@ -16,8 +16,8 @@ type S = Pick<UCSettings, 'uc_disabled_use_cases'>;
 export declare class UCExecChecker implements Configurable<S>, Worker<Input, Promise<Output>> {
     private productManifest;
     private settingsManager;
-    private ucPolicyProvider;
-    constructor(productManifest: ProductManifest, settingsManager: SettingsManager<S>, ucPolicyProvider: Provider<UCPolicy>);
+    private ucPolicyFactory;
+    constructor(productManifest: ProductManifest, settingsManager: SettingsManager<S>, ucPolicyFactory: Factory<UCPolicy>);
     s(): S;
     exec<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>({ lifecycle, uc }: Input<I, OPI0, OPI1>): Promise<Output>;
 }

package/dist/esm/uc/workers/UCExecChecker.js

@@ -14,11 +14,11 @@ import { inject, injectable } from 'inversify';
 let UCExecChecker = class UCExecChecker {
     productManifest;
     settingsManager;
-    ucPolicyProvider;
-    constructor(productManifest, settingsManager, ucPolicyProvider) {
+    ucPolicyFactory;
+    constructor(productManifest, settingsManager, ucPolicyFactory) {
         this.productManifest = productManifest;
         this.settingsManager = settingsManager;
-        this.ucPolicyProvider = ucPolicyProvider;
+        this.ucPolicyFactory = ucPolicyFactory;
     }
     s() {
         return {
@@ -47,7 +47,7 @@ let UCExecChecker = class UCExecChecker {
                 const ucds = app.ucds?.exclude ?? [];
                 output.allowed = !ucds.includes(metadata.name);
                 if (output.allowed) {
-                    const policy = (await this.ucPolicyProvider(client.policy));
+                    const policy = (await this.ucPolicyFactory(client.policy));
                     const { allowed } = await policy.exec({ uc });
                     output.allowed = allowed;
                 }
@@ -68,7 +68,7 @@ UCExecChecker = __decorate([
     injectable(),
     __param(0, inject('ProductManifest')),
     __param(1, inject('SettingsManager')),
-    __param(2, inject('Provider<UCPolicy>')),
+    __param(2, inject('Factory<UCPolicy>')),
     __metadata("design:paramtypes", [Object, Object, Function])
 ], UCExecChecker);
 export { UCExecChecker };

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

@@ -12,7 +12,7 @@ export { SSEStreamManager } from './http/SSEStreamManager.js';
 export { fmtSingleDataMsg, fmtSSEError, isSSEError, parseDataLine, SSE_HEADERS, } from './http/sse.js';
 export { isClientError, isError, isServerError } from './http/status.js';
 export type { HTTPDataEnvelope, HTTPReqData } from './http/types.js';
-export { bindProvider } from './ioc/bindProvider.js';
+export { bindFactory } from './ioc/bindFactory.js';
 export { CONTAINER_OPTS } from './ioc/container.js';
 export type { Class } from './ioc/types.js';
 export { fmt as fmtNumber } from './numbers/fmt.js';

package/dist/esm/utils/index.js

@@ -7,7 +7,7 @@ export { fromQueryParams, toQueryParams } from './http/query-params.js';
 export { SSEStreamManager } from './http/SSEStreamManager.js';
 export { fmtSingleDataMsg, fmtSSEError, isSSEError, parseDataLine, SSE_HEADERS, } from './http/sse.js';
 export { isClientError, isError, isServerError } from './http/status.js';
-export { bindProvider } from './ioc/bindProvider.js';
+export { bindFactory } from './ioc/bindFactory.js';
 export { CONTAINER_OPTS } from './ioc/container.js';
 export { fmt as fmtNumber } from './numbers/fmt.js';
 export { baseFromSquareUnit, isSquareUnit, } from './numbers/units.js';