@medyll/idae-machine 0.107.0 → 0.109.0

package/README.md

@@ -159,23 +159,37 @@ fields: {
 }
 ```
 
-## 📝 Development Status
 
-⚠️ **Early Development Phase**
+## 🛡️ Robustness & Test Coverage
 
-This package contains foundational code that is:
-- **Partially validated**: Core schema & field system works; form validation in progress
-- **Under active refinement**: API may change as patterns solidify
-- **Proof of concept**: Not recommended for production until v1.0 release
+All core logic in `src/lib/db/dbFields.ts` is now fully schema-driven and covered by comprehensive unit tests (see `src/lib/db/*.spec.ts`).
+
+- **Field parsing**: Handles all types (primitive, array, object, fk) and modifiers (required, readonly, private) with robust string DSL parsing.
+- **Foreign key support**: Correctly parses and exposes fk and reverse-fk relations, with type-safe metadata.
+- **Test-driven**: All exported classes are covered by robust Vitest suites, including edge cases and complex schemas.
+- **Svelte 5 compliance**: All UI code and event handling strictly follow Svelte 5 idioms (see `AGENTS.md`).
 
 ### Current Focus Areas
 - ✅ Schema declaration & type safety
 - ✅ Database integration with idae-idbql
 - ✅ Component exports & library structure
+- ✅ Comprehensive test coverage (dbFields, CRUD, UI)
+- ✅ Svelte 5 event and binding policy
 - 🔄 Form validation (in progress)
 - 🔄 Field rendering pipeline (needs refinement)
 - ⏳ End-to-end CRUD workflows
-- ⏳ Comprehensive test coverage
+
+## 🧪 Testing Policy
+
+All logic in `dbFields.ts` and related modules is covered by unit tests:
+
+- **Test schema**: All tests use a realistic, complex schema (see `testDbSchema.ts`).
+- **Coverage**: Every method of every exported class is tested, including edge cases (array/object/fk/required/readonly).
+- **Continuous validation**: All tests must pass before merge. See `CHANGELOG.md` for test and coverage history.
+
+## 🦄 Svelte 5 Coding Policy
+
+All UI code must strictly follow Svelte 5 syntax and conventions. See `AGENTS.md` for details and migration rules.
 
 ## 🔗 Dependencies
 

package/dist/db/dbFields.d.ts

@@ -213,11 +213,6 @@ export declare class IDbCollectionValues<T extends Record<string, any>> {
      * @param collection The collection name.
      */
     constructor(collection: TplCollectionName);
-    /**
-     * Get the presentation string for a data object, using the collection's presentation template.
-     * @param data The data object.
-     * @returns The formatted presentation string.
-     */
     presentation(data: Record<string, any>): string;
     /**
      * Get the value of the index field for a data object.
@@ -256,6 +251,11 @@ export declare class IDbCollectionValues<T extends Record<string, any>> {
 }
 export declare class IDbCollectionFieldValues<T extends Record<string, any>> {
     #private;
+    /**
+ * Returns the IDbForge metadata for a given field name.
+ * @param fieldName The field name to introspect.
+ */
+    getForge(fieldName: keyof T): IDbForge | undefined;
     constructor(collection: TplCollectionName, data: T);
     format(fieldName: keyof T): string | string[];
     getInputDataSet(fieldName: keyof T): Record<"data-collection" | "data-fieldName" | "data-fieldType" | "data-fieldArgs" | "data-collectionId", string>;

package/dist/db/dbFields.js

@@ -296,7 +296,8 @@ export class IDbCollections {
                 is = is ?? fieldType;
                 break;
             case 'fk':
-                fieldType = this.getFkFieldType(extractAfter('fk-', fieldRule));
+                // Pour les fk, fieldType doit rester la string d'origine (ex: 'fk-agentPrompt.id')
+                fieldType = 'fk-' + extractAfter('fk-', fieldRule);
                 is = extractedArgs?.piece;
                 break;
             case 'primitive':
@@ -404,11 +405,6 @@ export class IDbCollectionValues {
         this.collection = collection;
         this.dbCollections = new IDbCollections();
     }
-    /**
-     * Get the presentation string for a data object, using the collection's presentation template.
-     * @param data The data object.
-     * @returns The formatted presentation string.
-     */
     presentation(data) {
         try {
             this.#checkError(!this.#checkAccess(), 'Access denied', 'ACCESS_DENIED');
@@ -563,6 +559,13 @@ export class IDbCollectionFieldValues {
     #collection;
     #collectionValues;
     #data;
+    /**
+ * Returns the IDbForge metadata for a given field name.
+ * @param fieldName The field name to introspect.
+ */
+    getForge(fieldName) {
+        return this.#collectionValues.dbCollections.parseCollectionFieldName(this.#collection, String(fieldName));
+    }
     constructor(collection, data) {
         this.#collection = collection;
         this.#collectionValues = new IDbCollectionValues(collection);
@@ -814,3 +817,4 @@ export class IDbFormValidate {
         }
     }
 }
+// (fin de fichier)

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export * from './types/appschemeTypes.js';
+export * from './main/machine.js';
+export * from './main/machine.spec.js';
 export { default as Skeleton } from './fragments/Skeleton.svelte';
 export { default as Selector } from './fragments/Selector.svelte';
 export { default as List } from './fragments/List.svelte';
@@ -11,7 +13,6 @@ export { default as FieldInPlace } from './form/FieldInPlace.svelte';
 export { default as DataProvider } from './form/DataProvider.svelte';
 export { default as DataList } from './form/DataList.svelte';
 export { default as CrudZone } from './form/CrudZone.svelte';
-export * from './form/CrudZone.spec.js';
 export { default as CreateUpdate } from './form/CreateUpdate.svelte';
 export { default as CollectionReverseFks } from './form/CollectionReverseFks.svelte';
 export { default as CollectionListMenu } from './form/CollectionListMenu.svelte';
@@ -30,5 +31,4 @@ export * from './db/dbCollectionValues.spec.js';
 export * from './db/dbCollectionFieldValues.spec.js';
 export * from './db/dbCollectionFieldForge.spec.js';
 export * from './db/dataModel.js';
-export * from './db/FieldValue.spec.js';
 export * from './db/CrudService.js';

package/dist/index.js

@@ -1,5 +1,7 @@
 // auto exports of entry components
 export * from './types/appschemeTypes.js';
+export * from './main/machine.js';
+export * from './main/machine.spec.js';
 export { default as Skeleton } from './fragments/Skeleton.svelte';
 export { default as Selector } from './fragments/Selector.svelte';
 export { default as List } from './fragments/List.svelte';
@@ -12,7 +14,6 @@ export { default as FieldInPlace } from './form/FieldInPlace.svelte';
 export { default as DataProvider } from './form/DataProvider.svelte';
 export { default as DataList } from './form/DataList.svelte';
 export { default as CrudZone } from './form/CrudZone.svelte';
-export * from './form/CrudZone.spec.js';
 export { default as CreateUpdate } from './form/CreateUpdate.svelte';
 export { default as CollectionReverseFks } from './form/CollectionReverseFks.svelte';
 export { default as CollectionListMenu } from './form/CollectionListMenu.svelte';
@@ -31,5 +32,4 @@ export * from './db/dbCollectionValues.spec.js';
 export * from './db/dbCollectionFieldValues.spec.js';
 export * from './db/dbCollectionFieldForge.spec.js';
 export * from './db/dataModel.js';
-export * from './db/FieldValue.spec.js';
 export * from './db/CrudService.js';

package/dist/main/machine.d.ts

@@ -0,0 +1,78 @@
+import { IDbCollections } from '../db/dbFields.js';
+import { createIdbqDb, type IdbqModel } from '@medyll/idae-idbql';
+/**
+ * Machine: main entry point for managing the IDBQL connection and centralized data access.
+ */
+export declare class Machine {
+    /**
+  
+     * IDBQL (readonly collections instance)
+     */
+    _idbql: ReturnType<ReturnType<typeof createIdbqDb>["create"]>["idbql"] | undefined;
+    /**
+     * IDBQL (stateful collections instance)
+     */
+    _idbqlState: ReturnType<ReturnType<typeof createIdbqDb>["create"]>["idbqlState"] | undefined;
+    /**
+     * Direct access to IndexedDB (core)
+     */
+    _idbDatabase: ReturnType<ReturnType<typeof createIdbqDb>["create"]>["idbDatabase"] | undefined;
+    /**
+     * IDBQL data model
+     */
+    _idbqModel: ReturnType<ReturnType<typeof createIdbqDb>["create"]>["idbqModel"] | undefined;
+    /**
+     * Centralized access to schema and collection logic
+     */
+    _collections: IDbCollections | undefined;
+    /**
+     * Database name
+     */
+    _dbName: string;
+    /**
+     * Schema version
+     */
+    _version: number;
+    /**
+     * Data model
+     */
+    _model: IdbqModel;
+    /**
+     * Main constructor
+     * @param dbName Database name (default: 'idae-machine')
+     * @param version Schema version (default: 1)
+     * @param model Data model (default: schemeModel)
+     */
+    constructor(dbName?: string, version?: number, model?: IdbqModel);
+    /**
+     * Start the machine: initialize collections and IDBQL connection.
+     * @param options Optional overrides: { dbName, version, model }
+     */
+    start(options?: {
+        dbName?: string;
+        version?: number;
+        model?: IdbqModel;
+    }): void;
+    private createCollections;
+    private createStore;
+    /**
+     * Get the IDbCollections (schema logic) instance
+     */
+    get collections(): IDbCollections | undefined;
+    /**
+     * IDBQL (readonly) instance
+     */
+    get idbql(): import("@medyll/idae-idbql").ReadonlyCollections<IdbqModel<Record<string, Record<string, any>>>> | undefined;
+    /**
+     * IDBQL (stateful) instance
+     */
+    get idbqlState(): import("@medyll/idae-idbql").StateCollections<IdbqModel<Record<string, Record<string, any>>>> | undefined;
+    /**
+     * IndexedDB (core) instance
+     */
+    get indexedb(): import("@medyll/idae-idbql").IdbqlIndexedCore<IdbqModel<Record<string, Record<string, any>>>> | undefined;
+    /**
+     * IDBQL data model instance
+     */
+    get idbqModel(): IdbqModel<Record<string, Record<string, any>>> | undefined;
+}

package/dist/main/machine.js

@@ -0,0 +1,136 @@
+/**
+ * Example usage:
+ *
+ * import { Machine } from './machine.js';
+ *
+ * // Create a new Machine instance with default parameters
+ * const machine = new Machine( 'example-db', 1, { collections: {} });
+ *
+ * // Start the machine (initialize collections and IDBQL connection)
+ * machine.start();
+ *
+ * // Access collections (schema logic)
+ * const collections = machine.collections;
+ *
+ * // Access IDBQL (readonly)
+ * const idbql = machine.idbql;
+ *
+ * // Access IDBQL (stateful)
+ * const idbqlState = machine.idbqlState;
+ *
+ * // Access IndexedDB core
+ * const db = machine.indexedb;
+ *
+ * // Access the IDBQL data model
+ * const model = machine.idbqModel;
+ */
+import { schemeModel } from '../db/dbSchema.js';
+import { IDbCollections } from '../db/dbFields.js';
+import { createIdbqDb } from '@medyll/idae-idbql';
+/**
+ * Machine: main entry point for managing the IDBQL connection and centralized data access.
+ */
+export class Machine {
+    /**
+  
+     * IDBQL (readonly collections instance)
+     */
+    _idbql;
+    /**
+     * IDBQL (stateful collections instance)
+     */
+    _idbqlState;
+    /**
+     * Direct access to IndexedDB (core)
+     */
+    _idbDatabase;
+    /**
+     * IDBQL data model
+     */
+    _idbqModel;
+    /**
+     * Centralized access to schema and collection logic
+     */
+    _collections;
+    /**
+     * Database name
+     */
+    _dbName;
+    /**
+     * Schema version
+     */
+    _version;
+    /**
+     * Data model
+     */
+    _model;
+    /**
+     * Main constructor
+     * @param dbName Database name (default: 'idae-machine')
+     * @param version Schema version (default: 1)
+     * @param model Data model (default: schemeModel)
+     */
+    constructor(dbName = 'idae-machine', version = 1, model = schemeModel) {
+        this._dbName = dbName;
+        this._version = version;
+        this._model = model;
+    }
+    /**
+     * Start the machine: initialize collections and IDBQL connection.
+     * @param options Optional overrides: { dbName, version, model }
+     */
+    start(options) {
+        this._dbName = options?.dbName ?? this._dbName;
+        this._version = options?.version ?? this._version;
+        this._model = options?.model ?? this._model;
+        this.createCollections();
+        this.createStore();
+    }
+    createCollections() {
+        if (!this._model) {
+            throw new Error('Data model is not defined');
+        }
+        this._collections = new IDbCollections(this._model);
+    }
+    createStore() {
+        if (!this._model || !this._dbName || !this._version) {
+            throw new Error('Model, dbName, or version is not defined');
+        }
+        const idbqStore = createIdbqDb(this._model, this._version);
+        const { idbql, idbqlState, idbDatabase, idbqModel } = idbqStore.create(this._dbName);
+        this._idbql = idbql;
+        this._idbqlState = idbqlState;
+        this._idbDatabase = idbDatabase;
+        this._idbqModel = idbqModel;
+    }
+    /**
+     * Get the IDbCollections (schema logic) instance
+     */
+    get collections() {
+        return this._collections;
+    }
+    /**
+     * IDBQL (readonly) instance
+     */
+    get idbql() {
+        return this._idbql;
+    }
+    /**
+     * IDBQL (stateful) instance
+     */
+    get idbqlState() {
+        return this._idbqlState;
+    }
+    /**
+     * IndexedDB (core) instance
+     */
+    get indexedb() {
+        return this._idbDatabase;
+    }
+    /**
+     * IDBQL data model instance
+     */
+    get idbqModel() {
+        return this._idbqModel;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@medyll/idae-machine",
-	"version": "0.107.0",
+	"version": "0.109.0",
 	"scripts": {
 		"dev": "vite dev",
 		"build": "vite build && npm run prepack",