libmodulor 0.20.0 → 0.22.0

package/dist/esm/uc/UCInputField.js

@@ -1,8 +1,7 @@
 import { Validation } from '../dt/index.js';
 import { isBlank } from '../utils/index.js';
-import { UCInputFieldChangeOperator, ucifIsMandatory, ucifMustBeFilledManually, ucifRepeatability, } from './input-field.js';
+import { ucifIsMandatory, ucifMustBeFilledManually, ucifRepeatability, } from './input-field.js';
 import { rVal0, rValArr } from './utils/rVal.js';
-import { ucifcoIsForArray } from './utils/ucifcoIsForArray.js';
 export class UCInputField {
     key;
     def;
@@ -21,6 +20,18 @@ export class UCInputField {
             this.value = initialValue;
         }
     }
+    addVal(value) {
+        const { type } = this.def;
+        type.assign(value);
+        const val = type.val();
+        if (val === undefined) {
+            // The value is invalid for T (we might want to throw an error here)
+            return;
+        }
+        const current = Array.isArray(this.value) ? this.value : [];
+        // We are not really forced to use immutability here, to be reconsidered
+        this.value = current.concat([val]);
+    }
     clear() {
         this.value = undefined;
         const initialValue = this.def.type.getInitialValue();
@@ -28,6 +39,18 @@ export class UCInputField {
             this.value = initialValue;
         }
     }
+    fillWithExample() {
+        this.clear();
+        const [isRepeatable] = ucifRepeatability(this.def);
+        const { type } = this.def;
+        const val = type.getExamples()?.[0] ?? type.example();
+        if (isRepeatable) {
+            this.addVal(val);
+        }
+        else {
+            this.setVal(val);
+        }
+    }
     getDynamicWording() {
         return this.dynamicWording;
     }
@@ -77,7 +100,7 @@ export class UCInputField {
         throw new Error(`${this.key.toString()} is not set and has no default value. Do not require it.`);
     }
     /**
-     * Require the value as an array
+     * Read the value as an array
      *
      * Unlink the standalone {@link rValArr}, it returns the default value in an array if present.
      *
@@ -100,40 +123,27 @@ export class UCInputField {
         // Otherwise, we could not get the value of an optional repeatable field (see remark above on the defaultValue).
         return [];
     }
-    setValue(op, value) {
-        if (op === UCInputFieldChangeOperator.RESET) {
-            this.clear();
-            return;
-        }
+    rmVal(value) {
         const { type } = this.def;
         type.assign(value);
         const val = type.val();
         if (val === undefined) {
-            return;
-        }
-        if (!ucifcoIsForArray(op)) {
-            // Using a switch, even for just one case, to have it trigger an error if we miss to handle an enum value
-            switch (op) {
-                case UCInputFieldChangeOperator.SET:
-                    this.value = val;
-                    break;
-                default:
-                    ((_) => { })(op);
-            }
+            // The value is invalid for T (we might want to throw an error here)
             return;
         }
         const current = Array.isArray(this.value) ? this.value : [];
-        switch (op) {
-            // We are not really forced to use immutability here, but it's better for consistency
-            case UCInputFieldChangeOperator.ADD:
-                this.value = current.concat([val]);
-                break;
-            case UCInputFieldChangeOperator.REMOVE:
-                this.value = current.filter((v) => v !== val);
-                break;
-            default:
-                ((_) => { })(op);
+        // We are not really forced to use immutability here, to be reconsidered
+        this.value = current.filter((v) => v !== val);
+    }
+    setVal(value) {
+        const { type } = this.def;
+        type.assign(value);
+        const val = type.val();
+        if (val === undefined) {
+            // The value is invalid for T (we might want to throw an error here)
+            return;
         }
+        this.value = val;
     }
     updateDef(def) {
         this.def = def;

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

@@ -1,4 +1,4 @@
-import type { HTTPMethod, URLPath } from '../dt/index.js';
+import type { HTTPMethod, TransportType, URLPath } from '../dt/index.js';
 import type { UCOPIBase } from './opi.js';
 import type { UCOutput } from './output.js';
 import type { UCMountingPoint } from './utils/ucMountingPoint.js';
@@ -41,5 +41,11 @@ export interface UCExt<OPI0 extends UCOPIBase | undefined = undefined, OPI1 exte
          * @returns
          */
         transform?: (output: UCOutput<OPI0, OPI1>) => object;
+        /**
+         * The way the output is transported
+         *
+         * By default, it's `standard`.
+         */
+        transportType?: TransportType;
     };
 }

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

@@ -3,7 +3,7 @@ import type { ServerClientManager, ServerClientManagerSettings } from '../../tar
 import type { UCInput } from '../input.js';
 import type { UCOPIBase } from '../opi.js';
 import type { UCOutputOrNothing } from '../output.js';
-import type { UCTransporter } from '../transporter.js';
+import type { UCTransporter, UCTransporterOpts } from '../transporter.js';
 import type { UC } from '../UC.js';
 type S = Pick<ServerClientManagerSettings, 'server_cookies_name_auth' | 'server_public_api_key_header_name'>;
 export declare class HTTPUCTransporter implements Configurable<S>, UCTransporter {
@@ -12,6 +12,6 @@ export declare class HTTPUCTransporter implements Configurable<S>, UCTransporter
     private settingsManager;
     constructor(httpAPICaller: HTTPAPICaller, serverClientManager: ServerClientManager, settingsManager: SettingsManager<S>);
     s(): S;
-    send<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(uc: UC<I, OPI0, OPI1>): Promise<UCOutputOrNothing<OPI0, OPI1>>;
+    send<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(uc: UC<I, OPI0, OPI1>, opts: UCTransporterOpts<OPI0, OPI1>): Promise<UCOutputOrNothing<OPI0, OPI1>>;
 }
 export {};

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

@@ -29,7 +29,7 @@ let HTTPUCTransporter = class HTTPUCTransporter {
             server_public_api_key_header_name: this.settingsManager.get()('server_public_api_key_header_name'),
         };
     }
-    async send(uc) {
+    async send(uc, opts) {
         const { auth, def: { sec }, } = uc;
         const baseURL = await this.serverClientManager.baseURL({ auth });
         const { contentType, envelope, method, path } = ucHTTPContract(uc);
@@ -96,10 +96,12 @@ let HTTPUCTransporter = class HTTPUCTransporter {
             contentType,
             errBuilder: async (error) => error.message,
             method,
+            registerAbort: opts.registerAbort,
             req: {
                 builder: async () => rInput(uc, { ignoreUndefined: true }),
                 envelope,
             },
+            stream: opts.stream,
             urlBuilder: async () => `${baseURL}${path}`,
         });
         // In case of 204, we get an empty object.

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

@@ -7,7 +7,7 @@ import { UCOutputReader } from '../helpers/UCOutputReader.js';
 import type { UCInit } from '../init.js';
 import type { UCInput } from '../input.js';
 import type { UCMain } from '../main.js';
-import type { UCManager, UCManagerPersistOpts } from '../manager.js';
+import type { UCManager, UCManagerExecClientOpts, UCManagerExecServerOpts, UCManagerPersistOpts } from '../manager.js';
 import type { UCOPIBase } from '../opi.js';
 import type { UCOutputOrNothing } from '../output.js';
 import type { UC } from '../UC.js';
@@ -29,8 +29,8 @@ export declare class SimpleUCManager implements UCManager {
     constructor(ucClientConfirmManager: UCClientConfirmManager, clockManager: ClockManager, cryptoManager: CryptoManager, logger: Logger, ucDataStore: UCDataStore, ucExecChecker: UCExecChecker, ucInputFilesProcessor: UCInputFilesProcessor, ucInputValidator: UCInputValidator, ucInitProvider: Provider<UCInit>, ucMainProvider: Provider<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>): Promise<UCOutputReader<I, OPI0, OPI1>>;
-    execServer<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(uc: UC<I, OPI0, OPI1>): Promise<UCOutputOrNothing<OPI0, OPI1>>;
+    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>>;
+    execServer<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(uc: UC<I, OPI0, OPI1>, opts?: UCManagerExecServerOpts<OPI0, OPI1>): Promise<UCOutputOrNothing<OPI0, OPI1>>;
     initServer<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(uc: UC<I, OPI0, OPI1>): Promise<void>;
     startTx(): Promise<void>;
     persist<I extends UCInput | undefined = undefined, D extends UCData | null = null, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(uc: UC<I, OPI0, OPI1>, data?: D, opts?: UCManagerPersistOpts): Promise<UCDataStoreRecord<I, D>>;

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

@@ -59,7 +59,7 @@ let SimpleUCManager = class SimpleUCManager {
         }
         return this.ucClientConfirmManager.exec(def);
     }
-    async execClient(uc) {
+    async execClient(uc, opts) {
         const { lifecycle, metadata } = uc.def;
         const { client, server } = lifecycle;
         if (!client) {
@@ -81,10 +81,23 @@ let SimpleUCManager = class SimpleUCManager {
             await this.ucInputFilesProcessor.exec({ uc });
         }
         const main = (await this.ucMainProvider(client.main));
-        const output = await main.exec({ uc });
+        const streamOpts = opts?.stream;
+        const output = await main.exec({
+            opts: {
+                registerAbort: opts?.registerAbort,
+                stream: streamOpts
+                    ? {
+                        onClose: streamOpts.onClose,
+                        onData: (output) => streamOpts.onData(new UCOutputReader(uc.def, output ?? undefined)),
+                        onDone: streamOpts.onDone,
+                    }
+                    : undefined,
+            },
+            uc,
+        });
         return new UCOutputReader(uc.def, output ?? undefined);
     }
-    async execServer(uc) {
+    async execServer(uc, opts) {
         const { lifecycle, metadata } = uc.def;
         const { server } = lifecycle;
         if (typeof server !== 'object') {
@@ -101,7 +114,13 @@ let SimpleUCManager = class SimpleUCManager {
         this.ucInputValidator.exec({ uc });
         await this.ucInputFilesProcessor.exec({ uc });
         const main = (await this.ucMainProvider(server.main));
-        return main.exec({ uc });
+        const output = main.exec({
+            opts: {
+                stream: opts?.stream,
+            },
+            uc,
+        });
+        return output;
     }
     async initServer(uc) {
         const { lifecycle, metadata } = uc.def;

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

@@ -50,7 +50,6 @@ export * from './utils/rInput.js';
 export * from './utils/rVal.js';
 export * from './utils/stripUCDLifecycleServer.js';
 export * from './utils/ucHTTPContract.js';
-export * from './utils/ucifcoIsForArray.js';
 export * from './utils/ucMountingPoint.js';
 export * from './value.js';
 export * from './workers/SimpleAggregateFinder.js';

package/dist/esm/uc/index.js

@@ -50,7 +50,6 @@ export * from './utils/rInput.js';
 export * from './utils/rVal.js';
 export * from './utils/stripUCDLifecycleServer.js';
 export * from './utils/ucHTTPContract.js';
-export * from './utils/ucifcoIsForArray.js';
 export * from './utils/ucMountingPoint.js';
 export * from './value.js';
 export * from './workers/SimpleAggregateFinder.js';

package/dist/esm/uc/input-field.d.ts

@@ -1,24 +1,6 @@
 import type { DataType, TBase, UIntQuantity } from '../dt/index.js';
 import type { UCFieldKey } from './def.js';
 import type { Value } from './value.js';
-export declare enum UCInputFieldChangeOperator {
-    /**
-     * Considering the cardinality of the field (min > 1), add a new value
-     */
-    ADD = "ADD",
-    /**
-     * Considering the cardinality of the field (min > 1), remove a value
-     */
-    REMOVE = "REMOVE",
-    /**
-     * Reset the value of the field
-     */
-    RESET = "RESET",
-    /**
-     * Considering the cardinality of the field (max <= 1), set the value
-     */
-    SET = "SET"
-}
 export declare enum UCInputFieldFillingMode {
     /**
      * Set programmatically on behalf of the user (e.g. a foreign key id for a given object)
@@ -72,7 +54,8 @@ export interface UCInputFieldDef<T extends DataType> {
     transient?: boolean;
     type: TBase<T>;
 }
-export type UCInputFieldValue<T extends DataType> = Value<T>;
+export type UCInputFieldValue<T> = Value<T>;
+export type UCInputFieldValueUnwrapped<T> = T extends UCInputFieldValue<infer U> ? U : never;
 export declare function ucifExamples<T extends DataType>(def: UCInputFieldDef<T>): T[] | undefined;
 export declare function ucifHint<T extends DataType>(def: UCInputFieldDef<T>): string | undefined;
 /**

package/dist/esm/uc/input-field.js

@@ -1,22 +1,3 @@
-export var UCInputFieldChangeOperator;
-(function (UCInputFieldChangeOperator) {
-    /**
-     * Considering the cardinality of the field (min > 1), add a new value
-     */
-    UCInputFieldChangeOperator["ADD"] = "ADD";
-    /**
-     * Considering the cardinality of the field (min > 1), remove a value
-     */
-    UCInputFieldChangeOperator["REMOVE"] = "REMOVE";
-    /**
-     * Reset the value of the field
-     */
-    UCInputFieldChangeOperator["RESET"] = "RESET";
-    /**
-     * Considering the cardinality of the field (max <= 1), set the value
-     */
-    UCInputFieldChangeOperator["SET"] = "SET";
-})(UCInputFieldChangeOperator || (UCInputFieldChangeOperator = {}));
 export var UCInputFieldFillingMode;
 (function (UCInputFieldFillingMode) {
     /**

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

@@ -1,10 +1,16 @@
+import type { DataType } from '../dt/index.js';
 import type { StringKeys } from '../utils/index.js';
-import type { UCInputFieldDef } from './input-field.js';
+import type { UCInputFieldDef, UCInputFieldValue, UCInputFieldValueUnwrapped } from './input-field.js';
 /**
  * Base interface all the use case input interfaces must extend
  */
-export interface UCInput {
-}
+export type UCInput = {};
+export type UCInputUnwrapped<I extends UCInput | undefined> = {
+    [K in keyof I]: UCInputFieldValueUnwrapped<I[K]>;
+};
+export type UCInputKey<I extends UCInput | undefined> = StringKeys<UCInputUnwrapped<I>>;
+export type UCInputPartial<I extends UCInput | undefined> = Partial<Record<UCInputKey<I>, UCInputFieldValue<DataType>>>;
+export type UCInputKeyDataType<I extends UCInput | undefined, K extends UCInputKey<I>> = NonNullable<UCInputUnwrapped<I>[K]>;
 /**
  * Definition of a use case input
  */
@@ -12,11 +18,11 @@ export interface UCInputDef<I extends UCInput> {
     /**
      * This is useful when you want to render a given field only after its dependent fields have been set.
      */
-    dependencies?: Partial<Record<StringKeys<I>, StringKeys<I>[]>>;
+    dependencies?: Partial<Record<UCInputKey<I>, UCInputKey<I>[]>>;
     /**
      * It must follow strictly the shape of the corresponding {@link UCInput} with fields sorted alphabetically.
      */
-    fields: Record<StringKeys<I>, UCInputFieldDef<any>>;
+    fields: Record<UCInputKey<I>, UCInputFieldDef<any>>;
     /**
      * By default, the fields are displayed in the same order as in {@link fields} (i.e. alphabetically).
      *
@@ -24,13 +30,13 @@ export interface UCInputDef<I extends UCInput> {
      *
      * For example, when rendering a form, this is used.
      */
-    order?: StringKeys<I>[];
+    order?: UCInputKey<I>[];
     /**
      * Cross-field validation rules
      *
      * For example, if you want the user to provide `a` OR `b` but not both.
      */
     validation?: {
-        or?: StringKeys<I>[];
+        or?: UCInputKey<I>[];
     };
 }

package/dist/esm/uc/lifecycle/client/SendClientMain.d.ts

@@ -6,5 +6,5 @@ import type { UCTransporter } from '../../transporter.js';
 export declare class SendClientMain<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined> implements UCMain<I, OPI0, OPI1> {
     private ucTransporter;
     constructor(ucTransporter: UCTransporter);
-    exec({ uc, }: UCMainInput<I, OPI0, OPI1>): Promise<UCOutputOrNothing<OPI0, OPI1>>;
+    exec({ opts, uc, }: UCMainInput<I, OPI0, OPI1>): Promise<UCOutputOrNothing<OPI0, OPI1>>;
 }

package/dist/esm/uc/lifecycle/client/SendClientMain.js

@@ -16,8 +16,11 @@ let SendClientMain = class SendClientMain {
     constructor(ucTransporter) {
         this.ucTransporter = ucTransporter;
     }
-    async exec({ uc, }) {
-        return this.ucTransporter.send(uc);
+    async exec({ opts, uc, }) {
+        return this.ucTransporter.send(uc, {
+            registerAbort: opts?.registerAbort,
+            stream: opts?.stream,
+        });
     }
 };
 SendClientMain = __decorate([

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

@@ -1,9 +1,16 @@
 import type { Worker } from '../std/index.js';
+import type { RegisterAbortFunc, StreamConfig } from '../utils/index.js';
 import type { UCInput } from './input.js';
 import type { UCOPIBase } from './opi.js';
-import type { UCOutputOrNothing } from './output.js';
+import type { UCOutput, UCOutputOrNothing } from './output.js';
 import type { UC } from './UC.js';
+export type UCMainStream<OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined> = StreamConfig<UCOutput<OPI0, OPI1>>;
+export interface UCMainOpts<OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined> {
+    registerAbort?: RegisterAbortFunc | undefined;
+    stream?: UCMainStream<OPI0, OPI1> | undefined;
+}
 export interface UCMainInput<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined> {
+    opts?: UCMainOpts<OPI0, OPI1>;
     uc: UC<I, OPI0, OPI1>;
 }
 export interface UCMain<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined> extends Worker<UCMainInput<I, OPI0, OPI1>, Promise<UCOutputOrNothing<OPI0, OPI1>>> {

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

@@ -1,9 +1,11 @@
 import type { UUID } from '../dt/index.js';
+import type { RegisterAbortFunc, StreamConfig } from '../utils/index.js';
 import type { UCData } from './data.js';
 import type { UCDataStoreRecord } from './data-store.js';
 import type { UCExecMode } from './exec.js';
 import type { UCOutputReader } from './helpers/UCOutputReader.js';
 import type { UCInput } from './input.js';
+import type { UCMainStream } from './main.js';
 import type { UCOPIBase } from './opi.js';
 import type { UCOutputOrNothing } from './output.js';
 import type { UC } from './UC.js';
@@ -23,11 +25,18 @@ export interface UCManagerPersistOpts {
      */
     organizationId?: UUID;
 }
+export interface UCManagerExecClientOpts<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined> {
+    registerAbort?: RegisterAbortFunc | undefined;
+    stream?: StreamConfig<UCOutputReader<I, OPI0, OPI1>> | undefined;
+}
+export interface UCManagerExecServerOpts<OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined> {
+    stream?: UCMainStream<OPI0, OPI1> | undefined;
+}
 export interface UCManager {
     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>): Promise<UCOutputReader<I, OPI0, OPI1>>;
-    execServer<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(uc: UC<I, OPI0, OPI1>): Promise<UCOutputOrNothing<OPI0, OPI1>>;
+    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>>;
+    execServer<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(uc: UC<I, OPI0, OPI1>, opts?: UCManagerExecServerOpts<OPI0, OPI1>): Promise<UCOutputOrNothing<OPI0, OPI1>>;
     initServer<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(uc: UC<I, OPI0, OPI1>): Promise<void>;
     startTx(): Promise<void>;
     persist<I extends UCInput | undefined = undefined, D extends UCData | null = null, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(uc: UC<I, OPI0, OPI1>, data?: D, opts?: UCManagerPersistOpts): Promise<UCDataStoreRecord<I, D>>;

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

@@ -20,3 +20,4 @@ export interface UCOutputDef<OPI0 extends UCOPIBase | undefined = undefined, OPI
     };
     sideEffects?: UCOutputSideEffect[];
 }
+export declare function buildSingleItemOutput<OPI0 extends UCOPIBase>(item: OPI0): UCOutput<OPI0>;

package/dist/esm/uc/output.js

@@ -1 +1,10 @@
-export {};
+export function buildSingleItemOutput(item) {
+    return {
+        parts: {
+            _0: {
+                items: [item],
+                total: 1,
+            },
+        },
+    };
+}

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

@@ -1,7 +1,13 @@
+import type { RegisterAbortFunc } from '../utils/index.js';
 import type { UCInput } from './input.js';
+import type { UCMainStream } from './main.js';
 import type { UCOPIBase } from './opi.js';
 import type { UCOutputOrNothing } from './output.js';
 import type { UC } from './UC.js';
+export interface UCTransporterOpts<OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined> {
+    registerAbort?: RegisterAbortFunc | undefined;
+    stream?: UCMainStream<OPI0, OPI1> | undefined;
+}
 export interface UCTransporter {
-    send<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(uc: UC<I, OPI0, OPI1>): Promise<UCOutputOrNothing<OPI0, OPI1>>;
+    send<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(uc: UC<I, OPI0, OPI1>, opts?: UCTransporterOpts<OPI0, OPI1>): Promise<UCOutputOrNothing<OPI0, OPI1>>;
 }

package/dist/esm/uc/utils/rInput.js

@@ -1,5 +1,5 @@
 import { TBoolean } from '../../dt/index.js';
-import { UCInputFieldChangeOperator, ucifIsMandatory, ucifRepeatability, } from '../input-field.js';
+import { ucifIsMandatory, ucifRepeatability } from '../input-field.js';
 const DEFAULT_OPTS = {
     forceArrayAsEmpty: false,
     forceBooleanAsFalse: true,
@@ -24,18 +24,19 @@ export function rInput(uc, opts) {
             ucifIsMandatory(f.def) &&
             (value === null || value === undefined)) {
             value = false;
-            f.setValue(UCInputFieldChangeOperator.SET, value);
+            f.setVal(value);
         }
         const [isRepeatable] = ucifRepeatability(f.def);
         if (forceArrayAsEmpty &&
             isRepeatable &&
             (value === null || value === undefined)) {
             value = [];
-            f.setValue(UCInputFieldChangeOperator.SET, value);
+            f.setVal(value);
         }
         if (!ignoreUndefined || (ignoreUndefined && value !== undefined)) {
             // Useful when we get the input before persisting for example.
             // Otherwise it will persist `undefined` as a string in the database, for nothing.
+            // @ts-expect-error
             input[f.key] = value;
         }
     }

package/dist/esm/uc/utils/rVal.d.ts

@@ -1,4 +1,3 @@
-import type { DataType } from '../../dt/index.js';
 import type { Value } from '../value.js';
 /**
  * Read the value as a primitive
@@ -9,7 +8,8 @@ import type { Value } from '../value.js';
  * @param or
  * @returns
  */
-export declare function rVal0<T extends DataType>(value: Value<T>, or?: T): T | null;
+export declare function rVal0<T>(value: Value<T>, or: T): T;
+export declare function rVal0<T>(value: Value<T>, or?: undefined): T | null;
 /**
  * Require the value as a primitive
  *
@@ -18,13 +18,13 @@ export declare function rVal0<T extends DataType>(value: Value<T>, or?: T): T |
  * @param value
  * @returns
  */
-export declare function reqVal0<T extends DataType>(value: Value<T>): T;
+export declare function reqVal0<T>(value: Value<T>): T;
 /**
- * Get the value as an array
+ * Read the value as an array
  *
  * To be used when the field has a 0..* cardinality.
  *
  * @param value
  * @returns
  */
-export declare function rValArr<T extends DataType>(value: Value<T>): T[];
+export declare function rValArr<T>(value: Value<T>): T[];

package/dist/esm/uc/utils/rVal.js

@@ -1,15 +1,4 @@
 import { isBlank } from '../../utils/index.js';
-// NOTE : the "r" prefix stands for "read" and the "req" prefix stands for "require"
-/**
- * Read the value as a primitive
- *
- * To be used when the field has a 0..1 cardinality.
- *
- * @param value
- * @param or
- * @returns
- */
-// TODO : Find a way to return `T` when `or` is set (function override does not work)
 export function rVal0(value, or) {
     if (isBlank(value)) {
         return or ?? null;
@@ -32,7 +21,7 @@ export function reqVal0(value) {
     return val;
 }
 /**
- * Get the value as an array
+ * Read the value as an array
  *
  * To be used when the field has a 0..* cardinality.
  *

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

@@ -1,2 +1 @@
-import type { DataType } from '../dt/index.js';
-export type Value<T extends DataType> = T | T[] | null | undefined;
+export type Value<T> = T | T[] | null | undefined;

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

@@ -12,7 +12,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { inject, injectable } from 'inversify';
 import { TFile } from '../../dt/index.js';
-import { UCInputFieldChangeOperator, ucifRepeatability, } from '../input-field.js';
+import { ucifRepeatability } from '../input-field.js';
 import { rVal0, rValArr } from '../utils/rVal.js';
 let UCInputFilesProcessor = class UCInputFilesProcessor {
     clockManager;
@@ -45,13 +45,13 @@ let UCInputFilesProcessor = class UCInputFilesProcessor {
                 // Although the field is a file, here we fill it with the refs (for persistence)
                 // TODO : Improve the mgmt of FileNameRef vs actual File at the use case level
                 // I think we need to introduce another value, something like `setValueSerialized` or similar.
-                field.setValue(UCInputFieldChangeOperator.SET, fileNameRefs);
+                field.setVal(fileNameRefs);
             }
             else {
                 const file = rVal0(field.getValue());
                 if (file) {
                     const fileNameRef = await this.processFile(file);
-                    field.setValue(UCInputFieldChangeOperator.SET, fileNameRef);
+                    field.setVal(fileNameRef);
                 }
             }
         }

package/dist/esm/utils/async/types.d.ts

@@ -0,0 +1,2 @@
+export type AbortFunc = () => void;
+export type RegisterAbortFunc = (func: AbortFunc) => void;

package/dist/esm/utils/async/types.js

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

package/dist/esm/utils/http/NDJSONStreamManager.d.ts

@@ -0,0 +1,12 @@
+import type { HTTPAPICallExecutorResBody, Worker } from '../../std/index.js';
+type Encoding = 'utf-8';
+interface I<D extends object = object> {
+    encoding?: Encoding | undefined;
+    onData: (data: D) => Promise<void>;
+    reader: ReturnType<HTTPAPICallExecutorResBody['getReader']>;
+}
+export declare class NDJSONStreamManager implements Worker<I, Promise<void>> {
+    private static DEFAULT_ENCODING;
+    exec({ encoding, onData, reader, }: I): Promise<void>;
+}
+export {};