@solidxai/core 0.0.2

package/dist/validators/is-parsable-int.d.ts

@@ -0,0 +1,3 @@
+import { ValidationOptions } from 'class-validator';
+export declare function IsParsableInt(validationOptions?: ValidationOptions): (object: Object, propertyName: string) => void;
+//# sourceMappingURL=is-parsable-int.d.ts.map

package/dist/validators/is-parsable-int.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-parsable-int.d.ts","sourceRoot":"","sources":["../../src/validators/is-parsable-int.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,iBAAiB,EAAuB,MAAM,iBAAiB,CAAC;AAE5F,wBAAgB,aAAa,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,YACtC,MAAM,gBAAgB,MAAM,UAiBxD"}

package/dist/validators/is-parsable-int.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsParsableInt = IsParsableInt;
+const class_validator_1 = require("class-validator");
+function IsParsableInt(validationOptions) {
+    return function (object, propertyName) {
+        (0, class_validator_1.registerDecorator)({
+            name: 'isParsableInt',
+            target: object.constructor,
+            propertyName: propertyName,
+            options: validationOptions,
+            validator: {
+                validate(value, args) {
+                    const parsedValue = parseInt(value, 10);
+                    return Number.isInteger(parsedValue);
+                },
+                defaultMessage() {
+                    return 'Value must be a parsable integer';
+                },
+            },
+        });
+    };
+}
+//# sourceMappingURL=is-parsable-int.js.map

package/dist/validators/is-parsable-int.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-parsable-int.js","sourceRoot":"","sources":["../../src/validators/is-parsable-int.ts"],"names":[],"mappings":";;AAEA,sCAkBC;AApBD,qDAA4F;AAE5F,SAAgB,aAAa,CAAC,iBAAqC;IAC/D,OAAO,UAAU,MAAc,EAAE,YAAoB;QACjD,IAAA,mCAAiB,EAAC;YACd,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,YAAY,EAAE,YAAY;YAC1B,OAAO,EAAE,iBAAiB;YAC1B,SAAS,EAAE;gBACP,QAAQ,CAAC,KAAU,EAAE,IAAyB;oBAC1C,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACxC,OAAO,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;gBACzC,CAAC;gBACD,cAAc;oBACV,OAAO,kCAAkC,CAAC;gBAC9C,CAAC;aACJ;SACJ,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC","sourcesContent":["import { registerDecorator, ValidationOptions, ValidationArguments } from 'class-validator';\n\nexport function IsParsableInt(validationOptions?: ValidationOptions) {\n    return function (object: Object, propertyName: string) {\n        registerDecorator({\n            name: 'isParsableInt',\n            target: object.constructor,\n            propertyName: propertyName,\n            options: validationOptions,\n            validator: {\n                validate(value: any, args: ValidationArguments) {\n                    const parsedValue = parseInt(value, 10);\n                    return Number.isInteger(parsedValue);\n                },\n                defaultMessage() {\n                    return 'Value must be a parsable integer';\n                },\n            },\n        });\n    };\n}"]}

package/dist/winston.logger.d.ts

@@ -0,0 +1,19 @@
+import { Logger as TypeORMLogger, QueryRunner } from 'typeorm';
+import { Logger } from 'winston';
+import * as winston from 'winston';
+export declare const WinstonLoggerConfig: {
+    level: string;
+    format: winston.Logform.Format;
+    transports: (winston.transports.ConsoleTransportInstance | winston.transports.FileTransportInstance)[];
+};
+export declare class WinstonTypeORMLogger implements TypeORMLogger {
+    private readonly logger;
+    constructor(logger: Logger);
+    logQuery(query: string, parameters?: any[], queryRunner?: QueryRunner): void;
+    logQueryError(error: string, query: string, parameters?: any[], queryRunner?: QueryRunner): void;
+    logQuerySlow(time: number, query: string, parameters?: any[], queryRunner?: QueryRunner): void;
+    logSchemaBuild(message: string, queryRunner?: QueryRunner): void;
+    logMigration(message: string, queryRunner?: QueryRunner): void;
+    log(level: 'log' | 'info' | 'warn' | 'error', message: any): void;
+}
+//# sourceMappingURL=winston.logger.d.ts.map

package/dist/winston.logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"winston.logger.d.ts","sourceRoot":"","sources":["../src/winston.logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAEnC,eAAO,MAAM,mBAAmB;;;;CAgC/B,CAAC;AAEF,qBAAa,oBAAqB,YAAW,aAAa;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE5E,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,GAAG,EAAE,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI;IAM5E,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,GAAG,EAAE,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI;IAIhG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,GAAG,EAAE,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI;IAI9F,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI;IAIhE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI;IAI9D,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;CAGpE"}

package/dist/winston.logger.js

@@ -0,0 +1,106 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WinstonTypeORMLogger = exports.WinstonLoggerConfig = void 0;
+const winston_1 = require("winston");
+const common_1 = require("@nestjs/common");
+const nest_winston_1 = require("nest-winston");
+const winston = __importStar(require("winston"));
+exports.WinstonLoggerConfig = {
+    level: 'debug',
+    format: winston.format.combine(winston.format.timestamp(), winston.format.errors({ stack: true }), winston.format.printf(({ level, message, timestamp }) => {
+        if (!message) {
+            return `[${timestamp}] ${level.toUpperCase()}: (No message provided)`;
+        }
+        return `[${timestamp}] ${level.toUpperCase()}: ${message}`;
+    })),
+    transports: [
+        new winston.transports.Console({
+            format: winston.format.combine(winston.format.printf(({ level, message, timestamp }) => {
+                return `[${timestamp}] ${level.toUpperCase()}: ${message}`;
+            })),
+        }),
+        new winston.transports.File({
+            filename: 'logs/application.log',
+        }),
+        new winston.transports.File({
+            filename: 'logs/error.log',
+            level: 'error',
+        }),
+    ],
+};
+let WinstonTypeORMLogger = class WinstonTypeORMLogger {
+    constructor(logger) {
+        this.logger = logger;
+    }
+    logQuery(query, parameters, queryRunner) {
+        if (Boolean(process.env.DEFAULT_DATABASE_LOGGING)) {
+            this.logger.info(`Query: ${query} Parameters: ${parameters}`);
+        }
+    }
+    logQueryError(error, query, parameters, queryRunner) {
+        this.logger.error(`Query failed: ${error} | Query: ${query} | Parameters: ${parameters}`);
+    }
+    logQuerySlow(time, query, parameters, queryRunner) {
+        this.logger.warn(`Slow query: ${time}ms | Query: ${query} | Parameters: ${parameters}`);
+    }
+    logSchemaBuild(message, queryRunner) {
+        this.logger.info(`Schema Build: ${message}`);
+    }
+    logMigration(message, queryRunner) {
+        this.logger.info(`Migration: ${message}`);
+    }
+    log(level, message) {
+        this.logger[level](message);
+    }
+};
+exports.WinstonTypeORMLogger = WinstonTypeORMLogger;
+exports.WinstonTypeORMLogger = WinstonTypeORMLogger = __decorate([
+    __param(0, (0, common_1.Inject)(nest_winston_1.WINSTON_MODULE_PROVIDER)),
+    __metadata("design:paramtypes", [winston_1.Logger])
+], WinstonTypeORMLogger);
+//# sourceMappingURL=winston.logger.js.map

package/dist/winston.logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"winston.logger.js","sourceRoot":"","sources":["../src/winston.logger.ts"],"names":[],"mappings":"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","sourcesContent":["\nimport { Logger as TypeORMLogger, QueryRunner } from 'typeorm';\nimport { Logger } from 'winston';\nimport { Inject } from '@nestjs/common';\nimport { WINSTON_MODULE_PROVIDER } from 'nest-winston';\nimport * as winston from 'winston';\n\nexport const WinstonLoggerConfig = {\n    level: 'debug', // Allow all log levels for debugging\n    format: winston.format.combine(\n        winston.format.timestamp(),\n        winston.format.errors({ stack: true }),\n        winston.format.printf(({ level, message, timestamp }) => {\n            if (!message) {\n                return `[${timestamp}] ${level.toUpperCase()}: (No message provided)`;\n            }\n            return `[${timestamp}] ${level.toUpperCase()}: ${message}`;\n        }),\n    ),\n    transports: [\n        new winston.transports.Console({\n            format: winston.format.combine(\n                // winston.format.colorize(),\n                // winston.format.timestamp(),\n                winston.format.printf(({ level, message, timestamp }) => {\n                    return `[${timestamp}] ${level.toUpperCase()}: ${message}`;\n                }),\n            ),\n        }),\n        new winston.transports.File({\n            filename: 'logs/application.log',\n            // format: winston.format.json(),\n        }),\n        new winston.transports.File({\n            filename: 'logs/error.log',\n            level: 'error',\n            // format: winston.format.json(),\n        }),\n    ],\n};\n\nexport class WinstonTypeORMLogger implements TypeORMLogger {\n    constructor(@Inject(WINSTON_MODULE_PROVIDER) private readonly logger: Logger) { }\n\n    logQuery(query: string, parameters?: any[], queryRunner?: QueryRunner): void {\n        if (Boolean(process.env.DEFAULT_DATABASE_LOGGING)) {\n            this.logger.info(`Query: ${query} Parameters: ${parameters}`);\n        }\n    }\n\n    logQueryError(error: string, query: string, parameters?: any[], queryRunner?: QueryRunner): void {\n        this.logger.error(`Query failed: ${error} | Query: ${query} | Parameters: ${parameters}`);\n    }\n\n    logQuerySlow(time: number, query: string, parameters?: any[], queryRunner?: QueryRunner): void {\n        this.logger.warn(`Slow query: ${time}ms | Query: ${query} | Parameters: ${parameters}`);\n    }\n\n    logSchemaBuild(message: string, queryRunner?: QueryRunner): void {\n        this.logger.info(`Schema Build: ${message}`);\n    }\n\n    logMigration(message: string, queryRunner?: QueryRunner): void {\n        this.logger.info(`Migration: ${message}`);\n    }\n\n    log(level: 'log' | 'info' | 'warn' | 'error', message: any): void {\n        this.logger[level](message);\n    }\n}"]}

package/docs/grouping-enhancements.md

@@ -0,0 +1,89 @@
+# Grouping & Aggregation Enhancements (Code Review Summary)
+
+This document explains the recent changes to grouping/aggregation in the CRUD helper/service, why they were made, and how to use them (with examples on `PincodeMaster`).
+
+## What Changed and Why
+- **Dedicated grouping pipeline**: Grouping no longer reuses the record-level query (which had `SELECT entity.*`, pagination, and default order). A separate path builds clean group queries to avoid SQL errors and ensure correct counts.
+- **Multiple group-by fields**: The one-field limit was removed. You can now group on multiple fields (including relations) in the requested order.
+- **Relation-safe grouping**: Group-by fields can traverse many-to-one relations (e.g., `state.name`, `city.name`). The helper reuses existing joins (from filters) or adds the necessary joins and aliases.
+- **Date granularity**: Grouping supports `day`, `week`, `month`, `year` granularities in a DB-aware way (Postgres, MySQL/MariaDB, SQL Server).
+- **Aggregates**: Supports a core, DB-agnostic set: `count`, `count_distinct`, `sum`, `avg`, `min`, `max`. If `aggregates` is omitted, it defaults to `count(*)`.
+- **Group sorting/pagination**: Sorting and pagination are applied to group rows (not entity rows). Record pagination is kept separate for non-grouped queries.
+- **Ordered group names**: Group names follow the order of `groupBy` fields. Relation values and date/grouped values are included in sequence.
+- **Formatted date group labels**: You can add an optional format specifier to a date groupBy field: `field:granularity:format`. Supported formats: `MMM`, `MMMM`, `YYYY`, `YYYY-MM`, `YYYY-MM-DD` (defaults to the raw value if omitted).
+- **Count of groups**: Group counts are computed without pagination interference, so `meta.totalRecords` reflects total groups.
+- **DTO update**: `BasicFilterDto` now includes optional `aggregates?: string[]`.
+
+## Caveats
+- `populateGroup` is **not** supported when grouping on relation fields (e.g., `state.name`, `city.name`). Use it for scalar group-by fields only; otherwise fetch group metadata and then retrieve records in a separate call with the group key.
+- Sorting works for group keys without extra colons (e.g., `state.name`) and for aggregate aliases (e.g., `id_max`). For date bucket group keys with granularity/format (`createdAt:month:YYYY`), the sort parser treats the last segment as the order; results may vary by driver and may not sort as expected in all cases.
+
+## Usage Examples (PincodeMaster)
+Assume `PincodeMaster` has many-to-one `state` and `city` relations and a `createdAt` timestamp.
+
+### 1) Group by State and City
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=state.name&groupBy[1]=city.name
+```
+Returns groups for every state/city combination with default `count(*)` aggregate.
+
+### 2) Group by Relation + Filter on Relation
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=state.name&filters[state][name][$eq]=Maharashtra
+```
+Groups by state name but only for rows where state is Maharashtra.
+
+### 3) Multiple Group Fields (Relation + Scalar)
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=state.name&groupBy[1]=city.name&groupBy[2]=pincode
+```
+Group names are ordered: state → city → pincode.
+
+### 4) Group by Date with Granularity (Month)
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=createdAt:month
+```
+Groups by month (driver-aware), default group labels are raw date buckets.
+
+### 5) Date Granularity with Formatting
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=createdAt:month:MMM
+```
+Group labels use short month names (Jan, Feb, …). For full names: `createdAt:month:MMMM`. Other formats: `YYYY`, `YYYY-MM`, `YYYY-MM-DD`.
+
+### 6) Aggregates (Count Distinct)
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=state.name&aggregates[0]=pincode:count_distinct
+```
+Shows distinct pincodes per state.
+
+### 7) Aggregates (Multiple)
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=state.name&groupBy[1]=city.name&aggregates[0]=id:count&aggregates[1]=id:count_distinct
+```
+Returns both total rows and distinct IDs per state/city group.
+
+### 8) Date Granularity + Relations + Aggregates
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=createdAt:year&groupBy[1]=state.name&aggregates[0]=pincode:count_distinct
+```
+Distinct pincodes per state, per year.
+
+### 9) Filters with Grouping (Many-to-One)
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=state.name&groupBy[1]=city.name&filters[state][name][$eq]=Nagaland
+```
+Groups only rows where state.name = Nagaland.
+
+### 10) Group Sorting and Pagination
+- Sorting applies to the group rows. Example:
+```
+GET /api/pincode-master?offset=0&limit=50&groupBy[0]=state.name&sort[0]=state.name:ASC
+```
+- Pagination (`offset/limit`) limits the number of groups returned; total group count remains in `meta.totalRecords`.
+
+## Notes and Behavior
+- If `aggregates` is omitted, `COUNT(*)` is added automatically.
+- Group names reflect `groupBy` order and apply formatting when specified.
+- Group queries reuse joins from filters when possible; otherwise, they create necessary joins for relation paths.
+- Non-grouped find behavior remains unchanged.

package/docs/seed-changes.md

@@ -0,0 +1,65 @@
+# 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

@@ -0,0 +1,160 @@
+# 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 --create-datasources
+```
+
+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-data
+```
+
+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: Tear everything down
+
+Command:
+```
+npx @solidxai/solidctl test-data --delete-datasources
+```
+
+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-data --modules-to-test venue,reports
+```
+
+Only the listed modules are processed.

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

@@ -0,0 +1,24 @@
+# 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/import_fix

@@ -0,0 +1,37 @@
+commit 0ee811cd5c23efc2f3762436b89cc3d50f82ceae
+Author: Oswald Rodrigues <oswald@logicloop.io>
+Date:   Wed Jun 11 14:58:16 2025 +0530
+
+    import related records fix
+
+diff --git a/src/services/import-transaction.service.ts b/src/services/import-transaction.service.ts
+index 6b3d167..515e52c 100644
+--- a/src/services/import-transaction.service.ts
++++ b/src/services/import-transaction.service.ts
+@@ -434,6 +434,9 @@ export class ImportTransactionService extends CRUDService<ImportTransaction> {
+     }
+ 
+     const relatedRecordsIds = await this.getRelatedEntityIdsFromUserKeys(fieldMetadata, record, key);
++    if (relatedRecordsIds.length === 0) {
++      return dtoRecord; // If no related records found, return the dtoRecord as is
++    }
+ 
+     if (fieldMetadata.relationType === RelationType.manyTomany || fieldMetadata.relationType === RelationType.oneToMany) {
+       dtoRecord[`${fieldMetadata.name}Ids`] = relatedRecordsIds;
+@@ -446,12 +449,14 @@ export class ImportTransactionService extends CRUDService<ImportTransaction> {
+   }
+ 
+   private async getRelatedEntityIdsFromUserKeys(fieldMetadata: FieldMetadata, record: Record<string, any>, key: string): Promise<Array<number>> {
++    // For many-to-many or one-to-many relations, we expect the record cell to contains a comma-separated list of userKeys
++    const relationUserKeys = record[key] ? String(record[key]).split(',').map((userKey: string) => userKey.trim()) : [];
++    if (relationUserKeys.length === 0) return [];
++
+     const coModelService = this.getModelService(fieldMetadata.relationCoModelSingularName);
+     const coModelWithUserKeyField = await this.modelMetadataService.findOneBySingularName(fieldMetadata.relationCoModelSingularName, ['userKeyField']);
+     const coModelUserKeyFieldName = coModelWithUserKeyField?.userKeyField?.name || 'id'; // Default to 'id' if not found
+ 
+-    // For many-to-many or one-to-many relations, we expect the record cell to contains a comma-separated list of userKeys
+-    const relationUserKeys = record[key] ? String(record[key]).split(',').map((userKey: string) => userKey.trim()) : [];
+ 
+     // Set the relation basic filter dto filters with the userkeys and call the find method of the model service to get the related records
+     const relationFilterDto = {

package/nest-cli.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "compilerOptions": {
+    "deleteOutDir": true,
+    "plugins": ["@nestjs/swagger/plugin"]
+  }
+}