@medyll/idae-machine 0.128.0 → 0.135.2

package/dist/main/machine/IDbCollectionValues.d.ts

@@ -1,78 +0,0 @@
-import type { TplCollectionName, TplFields } from '@medyll/idae-idbql';
-import { MachineDb } from '../machineDb.js';
-import { type IDbForge } from '../machineForge.js';
-/**
- * IDbCollectionValues
- *
- * This class provides utilities to display, format, and introspect field values for a given collection, using the schema and provided data.
- * It is designed for dynamic UI rendering, presentation logic, and metadata extraction for form generation in schema-driven applications.
- *
- * Main responsibilities:
- * - Holds a reference to the collection name and the schema (IDbBase).
- * - Provides methods to format field values according to their type (number, text, array, object, etc.).
- * - Supplies presentation logic for displaying records (e.g., presentation string, index value).
- * - Offers input attribute generation for forms (inputDataSet).
- * - Supports iteration over array/object fields for advanced UI layouts.
- * - Enables access to field metadata for validation and rendering.
- *
- * Usage:
- *   const values = new IDbCollectionValues('agents');
- *   const display = values.presentation(agentData); // formatted display string
- *   const index = values.indexValue(agentData); // index field value
- *   const formatted = values.format('name', agentData); // formatted field value
- *   const attrs = values.getInputDataSet('name', agentData); // input attributes for forms
- *
- * This class is typically used via IDbBase.getCollectionValues for shared instance management.
- * @template T - The type of the data object for the collection.
- */
-export declare class IDbCollectionValues<T extends Record<string, any>> {
-    #private;
-    /**
-     * The IDbBase instance used for schema introspection.
-     */
-    idbBase: MachineDb;
-    /**
-     * The collection name this instance operates on.
-     */
-    private collectionName;
-    /**
-     * Create a new IDbCollectionValues instance for a given collection.
-     * @param collectionName The collection name.
-     */
-    constructor(collectionName: TplCollectionName, idbBase?: MachineDb);
-    presentation(data: Record<string, any>): string;
-    /**
-     * Get the value of the index field for a data object.
-     * @param data The data object.
-     * @returns The value of the index field, or null if not found.
-     */
-    indexValue(data: Record<string, any>): any | null;
-    /**
-     * Format a field value for display, using the field type and schema.
-     * @param fieldName The field name.
-     * @param data The data object.
-     * @returns The formatted value as a string.
-     */
-    format(fieldName: keyof T, data: T): string;
-    /**
-     * Get a set of data-* attributes for a field, for use in form generation or UI.
-     * @param fieldName The field name.
-     * @param data The data object.
-     * @returns An object with data-* attributes for the field.
-     */
-    getInputDataSet(fieldName: string, data: T): Record<`data-${'collection' | 'collectionId' | 'fieldName' | 'fieldType' | 'fieldArgs'}`, string>;
-    /**
-     * Iterate over an array field and return an array of IDbForge objects for each element.
-     * @param fieldName The field name.
-     * @param data The array data.
-     * @returns An array of IDbForge objects.
-     */
-    iterateArrayField(fieldName: keyof TplFields, data: any[]): IDbForge[];
-    /**
-     * Iterate over an object field and return an array of IDbForge objects for each property.
-     * @param fieldName The field name.
-     * @param data The object data.
-     * @returns An array of IDbForge objects.
-     */
-    iterateObjectField(fieldName: keyof TplFields, data: Record<string, unknown>): IDbForge[];
-}

package/dist/main/machine/IDbError.d.ts

@@ -1,6 +0,0 @@
-export declare class IDbError extends Error {
-    readonly code: string;
-    constructor(message: string, code: string);
-    static throwError(message: string, code: string): void;
-    static handleError(error: unknown): void;
-}

package/dist/main/machine/IDbError.js

@@ -1,61 +0,0 @@
-/*
-    renamed from DbCollectionError to IDbErrors
- */
-export class IDbError extends Error {
-    code;
-    constructor(message, code) {
-        super(message);
-        this.code = code;
-        this.name = 'DbCollectionError';
-    }
-    static throwError(message, code) {
-        throw new IDbError(message, code);
-    }
-    static handleError(error) {
-        if (error instanceof IDbError) {
-            console.error(`${error.name}: ${error.message} (Code: ${error.code})`);
-            /**
-             * IDbError
-             *
-             * Custom error class for collection-related errors.
-             *
-             * Usage:
-             *   throw new IDbError('Message', 'ERROR_CODE');
-             *   IDbError.handleError(error);
-             */
-            export class IDbError extends Error {
-                code;
-                /**
-                 * Create a new IDbError instance.
-                 * @param message The error message.
-                 * @param code The error code.
-                 */
-                constructor(message, code) {
-                    super(message);
-                    this.code = code;
-                    this.name = 'DbCollectionError';
-                }
-                /**
-                 * Throw a new IDbError.
-                 * @param message The error message.
-                 * @param code The error code.
-                 */
-                static throwError(message, code) {
-                    throw new IDbError(message, code);
-                }
-                /**
-                 * Handle an error, logging details if it's an IDbError.
-                 * @param error The error to handle.
-                 */
-                static handleError(error) {
-                    if (error instanceof IDbError) {
-                        console.error(`${error.name}: ${error.message} (Code: ${error.code})`);
-                    }
-                    else {
-                        console.error('Unexpected error:', error);
-                    }
-                }
-            }
-        }
-    }
-}

package/dist/main/machine/IDbFormValidate.d.ts

@@ -1,55 +0,0 @@
-import type { TplCollectionName, TplFields } from '@medyll/idae-idbql';
-import { MachineDb } from '../machineDb.js';
-/**
- * IDbFormValidate
- *
- * Provides validation utilities for form fields in a collection.
- *
- * Main responsibilities:
- * - Holds a reference to the collection and schema.
- * - Validates field values according to type and arguments.
- * - Supports custom validation for email, URL, phone, and date/time fields.
- *
- * Usage:
- *   const validator = new IDbFormValidate('agents');
- *   const result = validator.validateField('email', value);
- */
-export declare class IDbFormValidate {
-    #private;
-    private collection;
-    private idbCollections;
-    /**
-     * Create a new IDbFormValidate instance.
-     * @param collection The collection name.
-     * @param idbCollections Optional MachineDb instance.
-     */
-    constructor(collection: TplCollectionName, idbCollections?: MachineDb);
-    /**
-     * Validate a field value for the collection.
-     * @param fieldName The field name.
-     * @param value The value to validate.
-     * @returns An object with isValid and optional error.
-     */
-    validateField(fieldName: keyof TplFields, value: any): {
-        isValid: boolean;
-        error?: string;
-    };
-    /**
-     * Validate a single field value for a collection.
-     * @param fieldName The field name.
-     * @param value The value to validate.
-     * @returns True if valid, false otherwise.
-     */
-    validateFieldValue(fieldName: keyof TplFields, value: any): boolean;
-    validateForm(formData: Record<string, any>, options?: {
-        ignoreFields?: string[] | undefined;
-    }): {
-        isValid: boolean;
-        errors: Record<string, string>;
-        invalidFields: string[];
-    };
-    private validateEmail;
-    private validateUrl;
-    private validatePhone;
-    private validateDateTime;
-}

package/dist/main/machine/IDbFormValidate.js

@@ -1,183 +0,0 @@
-import { MachineDb, enumPrimitive } from '../machineDb.js';
-import { IDbValidationError } from './IDbValidationError.js';
-/**
- * IDbFormValidate
- *
- * Provides validation utilities for form fields in a collection.
- *
- * Main responsibilities:
- * - Holds a reference to the collection and schema.
- * - Validates field values according to type and arguments.
- * - Supports custom validation for email, URL, phone, and date/time fields.
- *
- * Usage:
- *   const validator = new IDbFormValidate('agents');
- *   const result = validator.validateField('email', value);
- */
-export class IDbFormValidate {
-    collection;
-    idbCollections;
-    /**
-     * Create a new IDbFormValidate instance.
-     * @param collection The collection name.
-     * @param idbCollections Optional MachineDb instance.
-     */
-    constructor(collection, idbCollections) {
-        this.collection = collection;
-        this.idbCollections = idbCollections ?? new MachineDb();
-    }
-    /**
-     * Validate a field value for the collection.
-     * @param fieldName The field name.
-     * @param value The value to validate.
-     * @returns An object with isValid and optional error.
-     */
-    validateField(fieldName, value) {
-        try {
-            const fieldInfo = this.idbCollections.parseCollectionFieldName(this.collection, fieldName);
-            if (!fieldInfo) {
-                return { isValid: false, error: `Field ${String(fieldName)} not found in collection` };
-            }
-            // Type checking
-            if (!this.#validateType(value, fieldInfo.fieldType)) {
-                return this.#returnError(fieldName, fieldInfo.fieldType);
-            }
-            // Check field arguments (required, etc.)
-            if (fieldInfo.fieldArgs) {
-                for (const arg of fieldInfo.fieldArgs) {
-                    if (arg === 'required' && (value === undefined || value === null || value === '')) {
-                        return this.#returnError(fieldName, 'required');
-                    }
-                }
-            }
-            // Specific validations according to field type
-            switch (fieldInfo.fieldType) {
-                case enumPrimitive.email:
-                    if (!this.validateEmail(value)) {
-                        return this.#returnError(fieldName, fieldInfo.fieldType);
-                    }
-                    break;
-                case enumPrimitive.url:
-                    if (!this.validateUrl(value)) {
-                        return this.#returnError(fieldName, fieldInfo.fieldType);
-                    }
-                    break;
-                case enumPrimitive.phone:
-                    if (!this.validatePhone(value)) {
-                        return this.#returnError(fieldName, fieldInfo.fieldType);
-                    }
-                    break;
-                case enumPrimitive.date:
-                case enumPrimitive.datetime:
-                case enumPrimitive.time:
-                    if (!this.validateDateTime(value, fieldInfo.fieldType)) {
-                        return this.#returnError(fieldName, fieldInfo.fieldType);
-                    }
-                    break;
-                // Add other specific cases here
-            }
-            return { isValid: true };
-        }
-        catch (error) {
-            if (error instanceof IDbValidationError) {
-                return { isValid: false, error: error.message };
-            }
-            throw error;
-        }
-    }
-    /**
-     * Validate a single field value for a collection.
-     * @param fieldName The field name.
-     * @param value The value to validate.
-     * @returns True if valid, false otherwise.
-     */
-    validateFieldValue(fieldName, value) {
-        const result = this.validateField(fieldName, value);
-        return !!result.isValid;
-    }
-    validateForm(formData, options = {}) {
-        const errors = {};
-        const invalidFields = [];
-        let isValid = true;
-        const fields = this.idbCollections.collection(this.collection).getTemplate().fields;
-        if (!fields) {
-            return {
-                isValid: false,
-                errors: { general: 'Collection template not found' },
-                invalidFields: ['general']
-            };
-        }
-        for (const [fieldName, fieldRule] of Object.entries(fields)) {
-            // Ignorer les champs spécifiés dans options.ignoreFields
-            if (options.ignoreFields && options.ignoreFields.includes(fieldName)) {
-                continue;
-            }
-            const result = this.validateField(fieldName, formData[fieldName]);
-            if (!result.isValid) {
-                errors[fieldName] = result.error || 'Invalid field';
-                invalidFields.push(fieldName);
-                isValid = false;
-            }
-        }
-        return { isValid, errors, invalidFields };
-    }
-    #validateType(value, type) {
-        switch (type) {
-            case enumPrimitive.number:
-                return typeof value === 'number' && !isNaN(value);
-            case enumPrimitive.boolean:
-                return typeof value === 'boolean';
-            case enumPrimitive.text:
-            case enumPrimitive.email:
-            case enumPrimitive.url:
-            case enumPrimitive.phone:
-            case enumPrimitive.password:
-                return typeof value === 'string';
-            case enumPrimitive.date:
-            case enumPrimitive.datetime:
-            case enumPrimitive.time:
-                return value instanceof Date || typeof value === 'string';
-            case enumPrimitive.any:
-                return true;
-            default:
-                return true; // Pour les types non gérés, on considère que c'est valide
-        }
-    }
-    #returnError(fieldName, enumCode) {
-        throw new IDbValidationError(String(fieldName), enumCode ?? 'unknown', `Invalid format for field ${String(fieldName)}. Cause "${enumCode}" `);
-    }
-    validateEmail(email) {
-        const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-        return emailRegex.test(email);
-    }
-    validateUrl(url) {
-        try {
-            new URL(url);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    validatePhone(phone) {
-        // Ceci est un exemple simple. Vous pouvez ajuster selon vos besoins spécifiques
-        const phoneRegex = /^\+?[\d\s-]{10,}$/;
-        return phoneRegex.test(phone);
-    }
-    validateDateTime(value, type) {
-        const date = value instanceof Date ? value : new Date(value);
-        if (isNaN(date.getTime()))
-            return false;
-        switch (type) {
-            case enumPrimitive.date:
-                return true; // La conversion en Date a déjà validé le format
-            case enumPrimitive.time:
-                // Vérifiez si la chaîne contient uniquement l'heure
-                return /^([01]\d|2[0-3]):([0-5]\d)(:([0-5]\d))?$/.test(value);
-            case enumPrimitive.datetime:
-                return true; // La conversion en Date a déjà validé le format
-            default:
-                return false;
-        }
-    }
-}

package/dist/main/machine/IDbValidationError.d.ts

@@ -1,19 +0,0 @@
-/**
- * IDbValidationError
- *
- * Custom error class for validation errors on form fields.
- *
- * Usage:
- *   throw new IDbValidationError('email', 'INVALID_EMAIL', 'Invalid email address');
- */
-export declare class IDbValidationError extends Error {
-    field: string;
-    code: string;
-    /**
-     * Create a new IDbValidationError instance.
-     * @param field The field name.
-     * @param code The error code.
-     * @param message The error message.
-     */
-    constructor(field: string, code: string, message: string);
-}

package/dist/main/machine/IDbValidationError.js

@@ -1,24 +0,0 @@
-/**
- * IDbValidationError
- *
- * Custom error class for validation errors on form fields.
- *
- * Usage:
- *   throw new IDbValidationError('email', 'INVALID_EMAIL', 'Invalid email address');
- */
-export class IDbValidationError extends Error {
-    field;
-    code;
-    /**
-     * Create a new IDbValidationError instance.
-     * @param field The field name.
-     * @param code The error code.
-     * @param message The error message.
-     */
-    constructor(field, code, message) {
-        super(message);
-        this.field = field;
-        this.code = code;
-        this.name = 'IDbValidationError';
-    }
-}

package/dist/main/machine/types.d.ts

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

package/dist/main/machine/types.js

@@ -1 +0,0 @@
-"use strict";

package/dist/ui/CollectionFieldGuess.svelte

@@ -1,29 +0,0 @@
-<!-- CollectionFieldGuess.svelte -->
-<script lang="ts">
-	import { Guesser } from '../tools/Guesser ';
-	import type { TplCollectionName } from '@medyll/idae-idbql';
-	import { IconButton } from '@medyll/idae-slotui-svelte';
-
-	let { collection, collectionId, fieldName, data, onGuess } = $props<{
-		collection:    TplCollectionName;
-		collectionId?: any;
-		fieldName:     string;
-		data:          Record<string, any>;
-		onGuess:       (fieldName: string, value: string) => void;
-	}>();
-
-	const guesser = new Guesser();
-
-	async function guessValue() {
-		try {
-			const result = await guesser.guessValue({ collection, collectionId, fieldName, data });
-			console.log({ result });
-			onGuess?.(fieldName, result.guessedValue);
-		} catch (error) {
-			console.error('Erreur lors de la devinette :', error);
-			// Gérer l'erreur (par exemple, afficher un message à l'utilisateur)
-		}
-	}
-</script>
-
-<IconButton icon="mdi:brain" tall="tiny" class="guess-button" onclick={guessValue} />

package/dist/ui/CollectionFieldGuess.svelte.d.ts

@@ -1,11 +0,0 @@
-import type { TplCollectionName } from '@medyll/idae-idbql';
-type $$ComponentProps = {
-    collection: TplCollectionName;
-    collectionId?: any;
-    fieldName: string;
-    data: Record<string, any>;
-    onGuess: (fieldName: string, value: string) => void;
-};
-declare const CollectionFieldGuess: import("svelte").Component<$$ComponentProps, {}, "">;
-type CollectionFieldGuess = ReturnType<typeof CollectionFieldGuess>;
-export default CollectionFieldGuess;