@solidxai/core 0.1.10-beta.8 → 0.1.10

package/docs/seed-changes.md

@@ -1,65 +0,0 @@
-# Seeding Enhancements Summary
-
-## Overview
-This document summarizes the changes made to seeding behavior in `solid-core`:
-- Metadata pruning support across targets.
-- CLI flags for selective modules and pruning.
-
-## Pruning Support
-Pruning is now available for most metadata targets. When enabled, records present in the DB but missing from JSON are removed. This is done in two phases:
-1. Identify records in DB not present in JSON.
-2. Delete those records before normal upsert seeding.
-
-### Targets with Pruning
-- Module models + fields (with model-level pruning).
-- Views, actions, menus (with join cleanup).
-- Security rules, list of values, dashboards.
-- Scheduled jobs, saved filters, model sequences.
-- Permissions (also clears role-permission join table).
-
-### Targets WITHOUT Pruning (conservative)
-- Module metadata itself
-- Media storage providers
-- Roles
-- Users
-- Email templates
-- SMS templates
-- System fields (global)
-- Default settings (global)
-
-### Pruning Mode
-Pruning runs **only** when `--prune` is provided. If omitted, pruning is skipped.
-
-## CLI Changes
-### Modules to Seed
-`--conf` was removed. Use:
-```
---modules-to-seed venue,reports
-```
-This passes `modulesToSeed` to the seeder as an array.
-
-## Sample Commands
-### Default seeding
-```
-npx @solidxai/solidctl seed
-```
-
-### Select modules only
-```
-npx @solidxai/solidctl seed --modules-to-seed venue,reports
-```
-
-### Pruning enabled
-```
-npx @solidxai/solidctl seed --modules-to-seed venue --prune
-```
-
-### Pruning enabled (all modules)
-```
-npx @solidxai/solidctl seed --prune
-```
-
-## Files Touched (Key)
-- `src/seeders/module-metadata-seeder.service.ts`
-- `src/commands/seed.command.ts`
-- `src/repository/solid-base.repository.ts` (added `findOneByUserKey`)

package/docs/test-data-workflow.md

@@ -1,200 +0,0 @@
-# Test Data Workflow
-
-This document describes the end-to-end workflow for creating isolated test databases, seeding metadata, loading test data, and tearing everything down.
-
-## Overview
-The workflow is designed to:
-- Create one **test database per configured datasource** in the project.
-- Point the app to those new databases via `.env` updates.
-- Seed all metadata into the fresh databases.
-- Load model-specific `testData` entries from module metadata JSON files.
-- Cleanly reverse everything at the end.
-
-The commands below are the canonical flow.
-
----
-
-## Step 1: Create test datasources
-
-Command:
-```
-npx @solidxai/solidctl test data --setup
-```
-
-What this does:
-- Reads all configured datasources from the Solid registry (`SolidRegistry.getSolidDatabaseModules()`), and uses their `name()` values.
-- Generates a unique **run name** (two words, underscore-separated, e.g. `steady_wolf`).
-- Builds a **timestamped database name** per datasource:
-  - `<datasource>_<timestamp>_<runName>`
-- Backs up the current `.env` into `.env.backup.<runName>`.
-- Rewrites `.env` in-place with new `*_DATABASE_NAME` values.
-- Creates the databases/schemas using TypeORM and the configured connection info.
-- Writes a `.solidx-test-manifest` with the run name + database names so the teardown can reverse everything later.
-
-Example output:
-```
-▶ Running solid test data
-Creating test datasource environment file and manifest.
-Backed up .env to .env.backup.steady_wolf and applied new test datasource names to .env.
-Creating test database/schema "default_20260201234402_steady_wolf" on datasource "default"...
-
-============================================================
-  TEST DATASOURCE ENVIRONMENT CREATED
-------------------------------------------------------------
-  Run name : steady_wolf
-  Env backup : .env.backup.steady_wolf
-
-  Test databases/schemas created:
-- default: default_20260201234402_steady_wolf
-
-  Next steps:
-  1) Using updated .env with test datasource names
-  2) Run solid seed as usual
-  3) Proceed with loading the test data for each module
-  4) Run the test cases 
-  5) Tear down
-============================================================
-
-✔ solid test data completed
-```
-
-Rationale:
-- The `.env` rewrite guarantees the app connects to fresh databases without changing code.
-- The manifest records the run so deletion is safe and deterministic.
-
----
-
-## Step 2: Seed metadata into the new databases
-
-Command:
-```
-npx @solidxai/solidctl seed
-```
-
-What this does:
-- Seeds full module metadata into the **fresh test databases**.
-- Generates the `sa` user if needed and prints its password.
-- Ensures all models, fields, roles, permissions, views, actions, etc. exist before loading test data.
-
-Example output (truncated):
-```
-▶ Running solid seed
-▶ Pruning disabled: existing metadata will be kept.
-▶ No modulesToSeed provided. Seeding ALL modules.
-▶ Seeding Metadata for Module: solid-core
-✔ [solid-core] Module/Model/Fields seeded (upserted 376)
-...
-✔ Seeding completed.
-✔ solid seed completed
-```
-
-Rationale:
-- Test data relies on model metadata and relationships; this ensures the schema and reference data are ready.
-
----
-
-## Step 3: Load test data
-
-Command:
-```
-npx @solidxai/solidctl test data --load
-```
-
-What this does:
-- Reads all module metadata files (or a subset if `--modules-to-test` is provided).
-- Looks for `testData` arrays in each metadata file.
-- Resolves the correct repository for each model (repository name pattern: `<ModelName>Repository`).
-- Performs **upsert-style** inserts using the model’s `userKeyFieldUserKey`.
-- Resolves many-to-one relations using `${fieldName}UserKey`.
-
-Example output:
-```
-▶ Running solid test data
-Test data setup for all modules.
-Processing test data for module: solid-core
-✔ Test data setup complete for module: solid-core
-Processing test data for module: venue
-✔ Test data setup complete for module: venue
-✔ solid test data completed
-```
-
-Rationale:
-- This keeps test fixtures human-readable and tied to module metadata.
-
----
-
-
-## Step 4: Run Tests 
-```
-npx @solidxai/solidctl test run --module venue --api-base-url http://localhost:3000 --ui-base-url http://localhost:5173 --headless false
-```
-
-```
-npx @solidxai/solidctl test run --module venue --list-specs
-```
-
-What this does:
-- Loads `testing.scenarios` from the module metadata file.
-- Applies `--scenario-ids` or `--include-tags` filtering if provided.
-- Boots API and UI adapters with the supplied base URLs.
-- Registers any custom test specs listed in `testing.specs`.
-- Executes scenarios in order with fail‑fast behavior.
-
-Useful variants:
-```
-npx @solidxai/solidctl test run --module venue --scenario-ids api-authenticate-success,api-create-states
-```
-
-```
-npx @solidxai/solidctl test run --module venue --include-tags smoke
-```
-
-```
-npx @solidxai/solidctl test run --module venue --api-base-url http://localhost:3000 --headless true
-```
-
-```
-npx @solidxai/solidctl test run --module venue --headless false
-```
-
-Notes:
-- If your scenario depends on a previous scenario’s `saveAs` output (e.g., `loginSuccess`), ensure the auth scenario runs first.
-- For UI tests, `--ui-base-url` should point to a running frontend server.
-- `--list-specs` prints registered custom `test.spec` ids and exits.
-
-
-## Step 5: Tear everything down
-
-Command:
-```
-npx @solidxai/solidctl test data --teardown
-```
-
-What this does:
-- Restores `.env` from the latest `.env.backup.<runName>`.
-- Deletes all `.env.backup.<runName>` files created by the workflow.
-- Drops each test database/schema recorded in `.solidx-test-manifest`.
-- Deletes the manifest file.
-
-Example output:
-```
-▶ Running solid test data
-Deleting test datasource environment and databases.
-Dropping test database/schema "default_20260201234402_steady_wolf" on datasource "default"...
-✔ Test datasource env files and manifest deleted; test databases dropped.
-✔ solid test data completed
-```
-
-Rationale:
-- Keeps the local environment clean and restores the original `.env` safely.
-
----
-
-## Optional: Limit modules for test data load
-
-You can restrict test data loading to a subset of modules:
-```
-npx @solidxai/solidctl test data --load --modules-to-test venue,reports
-```
-
-Only the listed modules are processed.

package/docs/type-declaration-import-issue.md

@@ -1,24 +0,0 @@
-# Issue: Consumer sees `Property 'id' does not exist on type 'VenueUser'`
-
-## Summary
-The published declaration files in `dist/` import internal types using `src/...` module specifiers. In a consuming project, TypeScript resolves those imports against the consumer's `src` path (or fails), which can cause `User` to extend a different `CommonEntity` that does not define `id`. This leads to `Property 'id' does not exist on type 'VenueUser'` even though `CommonEntity` in the library defines it.
-
-## Evidence
-- `dist/entities/user.entity.d.ts` starts with:
-  - `import { CommonEntity } from "src/entities/common.entity";`
-- `dist/entities/common.entity.d.ts` correctly contains:
-  - `id: number;`
-
-Because the import is `src/...`, the consumer may resolve it to their own `src` tree instead of the library's `dist` types.
-
-## Root Cause
-Library declarations are not portable because internal imports are using absolute `src/...` aliases. These aliases are not part of Node module resolution, so consumers resolve them differently.
-
-## Fix Options
-1. **Preferred:** Replace internal imports in `src/` with relative paths so emitted `.d.ts` files are portable.
-2. **Alternative:** Keep `src/*` aliases but add a post-build step (e.g., `tsc-alias`) to rewrite `dist/**/*.d.ts` imports to relative paths.
-
-## Next Steps
-- Decide on option 1 or 2.
-- Rebuild and verify `dist/**/*.d.ts` no longer import from `src/...`.
-- Publish a new package version and ensure the consuming app resolves `User` and `CommonEntity` from the same package instance.

package/sql/default/mariadb/proc_CleanupModelMetadata.sql

@@ -1,153 +0,0 @@
-DROP PROCEDURE IF EXISTS cleanup_model_metadata;
-
-DELIMITER $$
-
-CREATE PROCEDURE cleanup_model_metadata(
-    IN p_model_singular_name VARCHAR(255),
-    IN p_also_drop_model     TINYINT(1)   -- 0 = false, 1 = true (DEFAULT 0)
-)
-BEGIN
-    DECLARE v_model_id        INT;
-    DECLARE v_controller_name VARCHAR(512);
-
-    -- Default p_also_drop_model to 0 when NULL is passed
-    IF p_also_drop_model IS NULL THEN
-        SET p_also_drop_model = 0;
-    END IF;
-
-    --------------------------------------------------------------------
-    -- Derive ControllerName from model singular name
-    -- e.g. 'city' -> 'CityController'
-    --      'bankIfscMaster' -> 'BankIfscMasterController'
-    --------------------------------------------------------------------
-    SET v_controller_name = CONCAT(
-        UPPER(LEFT(p_model_singular_name, 1)),
-        SUBSTR(p_model_singular_name, 2),
-        'Controller'
-    );
-
-    SELECT m.id
-      INTO v_model_id
-      FROM ss_model_metadata AS m
-     WHERE m.singular_name = p_model_singular_name
-     LIMIT 1;
-
-    IF v_model_id IS NULL THEN
-        SIGNAL SQLSTATE '45000'
-            SET MESSAGE_TEXT = CONCAT('CleanupModelMetadata: Model with singular_name "', p_model_singular_name, '" not found.');
-    END IF;
-
-    --------------------------------------------------------------------
-    -- Temp tables for IDs (session-scoped, dropped at end of session)
-    --------------------------------------------------------------------
-    DROP TEMPORARY TABLE IF EXISTS tmp_view_ids;
-    DROP TEMPORARY TABLE IF EXISTS tmp_action_ids;
-    DROP TEMPORARY TABLE IF EXISTS tmp_permission_ids;
-
-    CREATE TEMPORARY TABLE tmp_view_ids       (id INT PRIMARY KEY);
-    CREATE TEMPORARY TABLE tmp_action_ids     (id INT PRIMARY KEY);
-    CREATE TEMPORARY TABLE tmp_permission_ids (id INT PRIMARY KEY);
-
-    INSERT INTO tmp_view_ids (id)
-    SELECT v.id
-      FROM ss_view_metadata AS v
-     WHERE v.model_id = v_model_id;
-
-    INSERT INTO tmp_action_ids (id)
-    SELECT a.id
-      FROM ss_action_metadata AS a
-     WHERE a.model_id = v_model_id;
-
-    --------------------------------------------------------------------
-    -- Collect permissions for this controller:
-    -- e.g. CityController.create, CityController.update, etc.
-    --------------------------------------------------------------------
-    INSERT INTO tmp_permission_ids (id)
-    SELECT p.id
-      FROM ss_permission_metadata AS p
-     WHERE p.name LIKE CONCAT(v_controller_name, '.%');
-
-    --------------------------------------------------------------------
-    -- 1) Delete user-view metadata
-    --------------------------------------------------------------------
-    DELETE FROM ss_user_view_metadata
-     WHERE view_metadata_id IN (SELECT id FROM tmp_view_ids);
-
-    --------------------------------------------------------------------
-    -- 2) Delete menu items linked via action_id
-    --------------------------------------------------------------------
-    DELETE FROM ss_menu_item_metadata
-     WHERE action_id IN (SELECT id FROM tmp_action_ids);
-
-    --------------------------------------------------------------------
-    -- 3) Delete actions
-    --------------------------------------------------------------------
-    DELETE FROM ss_action_metadata
-     WHERE id IN (SELECT id FROM tmp_action_ids);
-
-    --------------------------------------------------------------------
-    -- 4) Delete views
-    --------------------------------------------------------------------
-    DELETE FROM ss_view_metadata
-     WHERE id IN (SELECT id FROM tmp_view_ids);
-
-    --------------------------------------------------------------------
-    -- 5) Delete import transaction error logs for this model's imports
-    --------------------------------------------------------------------
-    DELETE FROM ss_import_transaction_error_log
-     WHERE import_transaction_id IN (
-           SELECT it.id
-             FROM ss_import_transaction AS it
-            WHERE it.model_metadata_id = v_model_id
-     );
-
-    --------------------------------------------------------------------
-    -- 6) Delete import transactions linked to the model
-    --------------------------------------------------------------------
-    DELETE FROM ss_import_transaction
-     WHERE model_metadata_id = v_model_id;
-
-    --------------------------------------------------------------------
-    -- 7) Delete permissions for this controller
-    --    a) Delete from role-permission join table
-    --    b) Delete from permission metadata
-    --------------------------------------------------------------------
-    DELETE FROM ss_role_metadata_permissions_ss_permission_metadata
-     WHERE ss_permission_metadata_id IN (SELECT id FROM tmp_permission_ids);
-
-    DELETE FROM ss_permission_metadata
-     WHERE id IN (SELECT id FROM tmp_permission_ids);
-
-    --------------------------------------------------------------------
-    -- 8) Optionally delete the model row itself (+ fields)
-    --------------------------------------------------------------------
-    IF p_also_drop_model = 1 THEN
-
-        -- 8a) Null user_key_field_id pointing to fields of this model
-        UPDATE ss_model_metadata AS mm
-           SET user_key_field_id = NULL
-         WHERE user_key_field_id IN (
-                SELECT f.id
-                  FROM ss_field_metadata AS f
-                 WHERE f.model_id = v_model_id
-         );
-
-        -- 8b) Null parent_model_id pointing to this model
-        UPDATE ss_model_metadata
-           SET parent_model_id = NULL
-         WHERE parent_model_id = v_model_id;
-
-        -- 8c) Delete model (fields deleted via ON DELETE CASCADE)
-        DELETE FROM ss_model_metadata
-         WHERE id = v_model_id;
-
-    END IF;
-
-    -- Cleanup temp tables
-    DROP TEMPORARY TABLE IF EXISTS tmp_view_ids;
-    DROP TEMPORARY TABLE IF EXISTS tmp_action_ids;
-    DROP TEMPORARY TABLE IF EXISTS tmp_permission_ids;
-
-END$$
-
-DELIMITER ;

package/sql/default/mariadb/proc_CleanupModuleMetadata.sql

@@ -1,56 +0,0 @@
-DROP PROCEDURE IF EXISTS cleanup_module_metadata;
-
-DELIMITER $$
-
-CREATE PROCEDURE cleanup_module_metadata(
-    IN p_module_name      VARCHAR(255),
-    IN p_also_drop_module TINYINT(1)   -- 0 = false, 1 = true (DEFAULT 0)
-)
-BEGIN
-    DECLARE v_module_id INT;
-
-    -- Default p_also_drop_module to 0 when NULL is passed
-    IF p_also_drop_module IS NULL THEN
-        SET p_also_drop_module = 0;
-    END IF;
-
-    SELECT m.id
-      INTO v_module_id
-      FROM ss_module_metadata AS m
-     WHERE m.name = p_module_name
-     LIMIT 1;
-
-    IF v_module_id IS NULL THEN
-        SIGNAL SQLSTATE '45000'
-            SET MESSAGE_TEXT = CONCAT('CleanupModuleMetadata: Module "', p_module_name, '" not found.');
-    END IF;
-
-    ----------------------------------------------------------------
-    -- 1) Delete menus for this module (children first, then roots)
-    ----------------------------------------------------------------
-    DELETE FROM ss_menu_item_metadata
-     WHERE module_id = v_module_id
-       AND parent_menu_item_id IS NOT NULL;
-
-    DELETE FROM ss_menu_item_metadata
-     WHERE module_id = v_module_id
-       AND parent_menu_item_id IS NULL;
-
-    ----------------------------------------------------------------
-    -- 2) Delete actions for this module
-    ----------------------------------------------------------------
-    DELETE FROM ss_action_metadata
-     WHERE module_id = v_module_id;
-
-    ----------------------------------------------------------------
-    -- 3) Optionally delete the module row itself
-    --    (assumes ss_model_metadata.module_id has ON DELETE SET NULL)
-    ----------------------------------------------------------------
-    IF p_also_drop_module = 1 THEN
-        DELETE FROM ss_module_metadata
-         WHERE id = v_module_id;
-    END IF;
-
-END$$
-
-DELIMITER ;

package/sql/default/mssql/proc_CleanupModuleMetadata.sql

@@ -1,78 +0,0 @@
-CREATE   PROCEDURE [dbo].[CleanupModuleMetadata]
-    @ModuleName     NVARCHAR(255),
-    @AlsoDropModule BIT = 0   -- 0 = only menus + actions, 1 = also delete module row
-AS
-BEGIN
-    SET NOCOUNT ON;
-
-    DECLARE @ModuleId INT;
-
-    SELECT @ModuleId = m.id
-    FROM   dbo.ss_module_metadata AS m
-    WHERE  m.name = @ModuleName;
-
-    IF @ModuleId IS NULL
-    BEGIN
-        RAISERROR ('CleanupModuleMetadata: Module "%s" not found.', 16, 1, @ModuleName);
-        RETURN;
-    END
-
-    BEGIN TRY
-        BEGIN TRAN;
-
-        ----------------------------------------------------------------
-        -- 1) Delete menu items for this module
-        --    (children first because parent FK has NO cascade)
-        ----------------------------------------------------------------
-        -- Children
-        DELETE mi
-        FROM   dbo.ss_menu_item_metadata AS mi
-        WHERE  mi.module_id = @ModuleId
-          AND  mi.parent_menu_item_id IS NOT NULL;
-
-        -- Roots
-        DELETE mi
-        FROM   dbo.ss_menu_item_metadata AS mi
-        WHERE  mi.module_id = @ModuleId
-          AND  mi.parent_menu_item_id IS NULL;
-
-        -- Note: Role join table
-        -- dbo.ss_menu_item_metadata_roles_ss_role_metadata
-        -- is cleaned automatically via ON DELETE CASCADE from menu items.
-
-        ----------------------------------------------------------------
-        -- 2) Delete actions for this module
-        ----------------------------------------------------------------
-        DELETE a
-        FROM   dbo.ss_action_metadata AS a
-        WHERE  a.module_id = @ModuleId;
-
-        ----------------------------------------------------------------
-        -- 3) Optionally delete the module row itself
-        --    Models keep their rows; module_id is set to NULL on delete
-        --    because of ON DELETE SET NULL in ss_model_metadata.
-        ----------------------------------------------------------------
-        IF @AlsoDropModule = 1
-        BEGIN
-            DELETE m
-            FROM   dbo.ss_module_metadata AS m
-            WHERE  m.id = @ModuleId;
-        END
-
-        COMMIT TRAN;
-    END TRY
-    BEGIN CATCH
-        IF @@TRANCOUNT > 0
-            ROLLBACK TRAN;
-
-        DECLARE @ErrorMessage NVARCHAR(4000),
-                @ErrorSeverity INT,
-                @ErrorState INT;
-
-        SELECT @ErrorMessage = ERROR_MESSAGE(),
-               @ErrorSeverity = ERROR_SEVERITY(),
-               @ErrorState    = ERROR_STATE();
-
-        RAISERROR(@ErrorMessage, @ErrorSeverity, @ErrorState);
-    END CATCH
-END