@solidxai/core 0.1.9-beta.0 → 0.1.9-beta.10

package/src/services/solid-introspect.service.ts

@@ -1,4 +1,4 @@
-import { classify } from '@angular-devkit/core/src/utils/strings';
+import { classify } from '../helpers/string.helper';
 import { Injectable, Logger, OnApplicationBootstrap } from '@nestjs/common';
 import { DiscoveryService, MetadataScanner, ModuleRef, Reflector } from '@nestjs/core';
 import { ModelMetadataHelperService } from 'src/helpers/model-metadata-helper.service';
@@ -13,6 +13,7 @@ import { IS_MAIL_PROVIDER } from 'src/decorators/mail-provider.decorator';
 import { IS_SCHEDULED_JOB_PROVIDER } from 'src/decorators/scheduled-job-provider.decorator';
 import { IS_SECURITY_RULE_CONFIG_PROVIDER } from 'src/decorators/security-rule-config-provider.decorator';
 import { IS_SELECTION_PROVIDER } from 'src/decorators/selection-provider.decorator';
+import { IS_EXTENSION_USER_CREATION_PROVIDER } from 'src/decorators/extension-user-creation-provider.decorator';
 import { IS_SOLID_DATABASE_MODULE } from 'src/decorators/solid-database-module.decorator';
 import { IS_WA_PROVIDER } from 'src/decorators/whatsapp-provider.decorator';
 import { SolidRegistry } from 'src/helpers/solid-registry';
@@ -144,6 +145,12 @@ export class SolidIntrospectService implements OnApplicationBootstrap {
       this.solidRegistry.registerSecurityRuleConfigProvider(securityRuleConfigProvider);
     });
 
+    // Register IExtensionUserCreationProvider implementation (at most one per project)
+    const extensionUserCreationProviders = this.discoveryService.getProviders().filter((provider) => this.isExtensionUserCreationProvider(provider));
+    extensionUserCreationProviders.forEach((provider) => {
+      this.solidRegistry.registerExtensionUserCreationProvider(provider);
+    });
+
     // Register the core subscribers against all the configured database modules / datasources
     await this.bootstrapCoreTypeOrmSubscribers(solidDatabaseModules);
     await this.cacheAuditableModels();
@@ -287,6 +294,12 @@ export class SolidIntrospectService implements OnApplicationBootstrap {
     return !!isSelectionProvider;
   }
 
+  private isExtensionUserCreationProvider(provider: InstanceWrapper): boolean {
+    const { instance } = provider;
+    if (!instance) return false;
+    return !!this.reflector.get<boolean>(IS_EXTENSION_USER_CREATION_PROVIDER, instance.constructor);
+  }
+
   private isSettingsProvider(provider: InstanceWrapper) {
     const { instance } = provider;
     if (!instance) return false;

package/src/services/user.service.ts

@@ -239,6 +239,93 @@ export class UserService extends CRUDService<User> {
     return user;
   }
 
+  async resolveUserOnOauthFacebook(oauthUserDto: OauthUserDto): Promise<User> {
+    const user = await this.repo.findOne({
+      where: {
+        email: oauthUserDto.email,
+      },
+      relations: {
+        roles: true,
+      },
+    });
+
+    if (!user) {
+      const newUser = new User();
+      newUser.username = oauthUserDto.email;
+      newUser.email = oauthUserDto.email;
+      newUser.fullName = oauthUserDto.name;
+      newUser.lastLoginProvider = oauthUserDto.provider;
+      newUser.accessCode = oauthUserDto.accessCode;
+      newUser.facebookAccessToken = oauthUserDto.accessToken;
+      newUser.facebookId = oauthUserDto.providerId;
+      newUser.facebookProfilePicture = oauthUserDto.picture;
+
+      const savedUser = await this.repo.save(newUser);
+
+      await this.initializeRolesForNewUser(
+        [this.settingService.getConfigValue<SolidCoreSetting>('defaultRole')],
+        savedUser,
+      );
+      return savedUser;
+    } else {
+      const entity = await this.repo.preload({
+        id: user.id,
+        lastLoginProvider: oauthUserDto.provider,
+        accessCode: oauthUserDto.accessCode,
+        facebookAccessToken: oauthUserDto.accessToken,
+        facebookId: oauthUserDto.providerId,
+        facebookProfilePicture: oauthUserDto.picture,
+      });
+
+      await this.repo.save(entity);
+      return entity;
+    }
+  }
+
+
+  async resolveUserOnOauthMicrosoft(oauthUserDto: OauthUserDto): Promise<User> {
+    const user = await this.repo.findOne({
+      where: {
+        email: oauthUserDto.email,
+      },
+      relations: {
+        roles: true,
+      },
+    });
+
+    if (!user) {
+      const newUser = new User();
+      newUser.username = oauthUserDto.email;
+      newUser.email = oauthUserDto.email;
+      newUser.fullName = oauthUserDto.name;
+      newUser.lastLoginProvider = oauthUserDto.provider;
+      newUser.accessCode = oauthUserDto.accessCode;
+      newUser.microsoftAccessToken = oauthUserDto.accessToken;
+      newUser.microsoftId = oauthUserDto.providerId;
+      newUser.microsoftProfilePicture = oauthUserDto.picture;
+
+      const savedUser = await this.repo.save(newUser);
+
+      await this.initializeRolesForNewUser(
+        [this.settingService.getConfigValue<SolidCoreSetting>('defaultRole')],
+        savedUser,
+      );
+      return savedUser;
+    } else {
+      const entity = await this.repo.preload({
+        id: user.id,
+        lastLoginProvider: oauthUserDto.provider,
+        accessCode: oauthUserDto.accessCode,
+        microsoftAccessToken: oauthUserDto.accessToken,
+        microsoftId: oauthUserDto.providerId,
+        microsoftProfilePicture: oauthUserDto.picture,
+      });
+
+      await this.repo.save(entity);
+      return entity;
+    }
+  }
+
   async findUsersByRole(roleName: string, relations: any = {}): Promise<User[]> {
     return await this.repo.find({
       where: {

package/src/services/view-metadata.service.ts

@@ -4,8 +4,7 @@ import { InjectEntityManager } from '@nestjs/typeorm';
 import { CRUDService } from 'src/services/crud.service';
 import { EntityManager } from 'typeorm';
 
-
-import { classify } from '@angular-devkit/core/src/utils/strings';
+import { classify } from '../helpers/string.helper';
 import { Locale } from 'src/entities/locale.entity';
 import { ModelMetadataHelperService } from 'src/helpers/model-metadata-helper.service';
 import { SolidRegistry } from 'src/helpers/solid-registry';
@@ -111,7 +110,6 @@ export class ViewMetadataService extends CRUDService<ViewMetadata> {
   async getLayout(query, activeUser) {
     let { modelName, moduleName, viewType, id, populate, menuItemId, menuItemName, actionId, actionName } = query;
 
-
     // 1. Fetch the action based on actionId.
     const solidRequestContext = {
       activeUser: activeUser
@@ -156,7 +154,6 @@ export class ViewMetadataService extends CRUDService<ViewMetadata> {
       }));
     }
 
-
     const viewId = action?.view?.id
     // 3. Fetch the view based on module, model & view name.
     const entity = await this.repo.findOne({
@@ -203,7 +200,6 @@ export class ViewMetadataService extends CRUDService<ViewMetadata> {
       entity.layout = JSON.parse(entity.layout);
     }
 
-
     // 6. We are resolving the create & edit actions if specified in the layout.
     if (entity?.layout?.attrs?.createAction) {
       const actionName: string = entity.layout.attrs.createAction;

package/src/solid-core.module.ts

@@ -26,7 +26,7 @@ import { ModuleMetadata } from './entities/module-metadata.entity';
 import { CommandService } from './helpers/command.service';
 import { SchematicService } from './helpers/schematic.service';
 import { ListOfValuesSelectionProvider } from './services/selection-providers/list-of-values-selection-providers.service';
-import { PseudoForeignKeySelectionProvider } from './services/selection-providers/pseudo-foreign-key-selection-provider.service'
+import { PseudoForeignKeySelectionProvider } from './services/selection-providers/pseudo-foreign-key-selection-provider.service';
 import { ModuleMetadataSeederService } from './seeders/module-metadata-seeder.service';
 import { ModuleTestDataService } from './seeders/module-test-data.service';
 import { CrudHelperService } from './services/crud-helper.service';
@@ -55,6 +55,11 @@ import { ActionMetadataController } from './controllers/action-metadata.controll
 import { ActionMetadata } from './entities/action-metadata.entity';
 import { ActionMetadataService } from './services/action-metadata.service';
 
+import { FacebookAuthenticationController } from './controllers/facebook-authentication.controller';
+import { MicrosoftAuthenticationController } from './controllers/microsoft-authentication.controller';
+import { FacebookOAuthStrategy } from './passport-strategies/facebook-oauth.strategy';
+import { MicrosoftOAuthStrategy } from './passport-strategies/microsoft-oauth.strategy';
+
 import { HttpModule } from '@nestjs/axios';
 import { JwtModule } from '@nestjs/jwt';
 import { SeedCommand } from './commands/seed.command';
@@ -133,7 +138,14 @@ import { BcryptService } from './services/bcrypt.service';
 import { UuidExternalIdEntityComputedFieldProvider } from './services/computed-fields/entity/uuid-externalid-entity-computed-field-provider.service';
 import { UuidExternalIdComputedFieldProvider } from './services/computed-fields/uuid-external-id-computed-field-provider.service';
 import { EmailTemplateService } from './services/email-template.service';
-import { DiskFileService, S3FileService, FileServiceFactory, DiskStoragePathBuilder, S3StoragePathBuilder, StoragePathBuilderFactory } from './services/file';
+import {
+  DiskFileService,
+  S3FileService,
+  FileServiceFactory,
+  DiskStoragePathBuilder,
+  S3StoragePathBuilder,
+  StoragePathBuilderFactory,
+} from './services/file';
 import { HashingService } from './services/hashing.service';
 import { ElasticEmailService } from './services/mail/elastic-email.service';
 import { SMTPEMailService } from './services/mail/smtp-email.service';
@@ -229,7 +241,6 @@ import { SmtpEmailQueueSubscriberDatabase } from './jobs/database/smtp-email-sub
 import { TwilioSmsQueuePublisherDatabase } from './jobs/database/twilio-sms-publisher-database.service';
 import { TwilioSmsQueueSubscriberDatabase } from './jobs/database/twilio-sms-subscriber-database.service';
 
-
 // import { ThrottlerModule } from '@nestjs/throttler';
 import { IngestCommand } from './commands/ingest.command';
 import { MailFactory } from './factories/mail.factory';
@@ -380,7 +391,6 @@ import { InfoCommand } from './commands/info.command';
 import { ListOfRolesSelectionProvider } from './services/selection-providers/list-of-roles-selectionproviders.service';
 import { Entity } from 'typeorm';
 
-
 @Global()
 @Module({
   imports: [
@@ -442,12 +452,12 @@ import { Entity } from 'typeorm';
           // you can also expose CORS here (not needed for simple <img>):
           // res.setHeader('Access-Control-Allow-Origin', 'http://localhost:3000');
         },
-      }
+      },
     }),
     MulterModule.registerAsync({
       imports: [ConfigModule],
       useFactory: async (configService: ConfigService) => ({
-        dest: process.env.AB_MEDIA_UPLOAD_DIR ?? "media-uploads",
+        dest: process.env.AB_MEDIA_UPLOAD_DIR ?? 'media-uploads',
       }),
       inject: [ConfigService],
     }),
@@ -474,6 +484,8 @@ import { Entity } from 'typeorm';
     ExportTransactionController,
     FieldMetadataController,
     GoogleAuthenticationController,
+    FacebookAuthenticationController,
+    MicrosoftAuthenticationController,
     ImportTransactionController,
     ImportTransactionErrorLogController,
     ListOfValuesController,
@@ -524,7 +536,7 @@ import { Entity } from 'typeorm';
     },
     {
       provide: APP_FILTER,
-      useClass: HttpExceptionFilter
+      useClass: HttpExceptionFilter,
     },
     ModuleMetadataService,
     ModuleMetadataHelperService,
@@ -640,6 +652,8 @@ import { Entity } from 'typeorm';
     RefreshTokenIdsStorageService,
     SsoCodeStorageService,
     GoogleOauthStrategy,
+    FacebookOAuthStrategy,
+    MicrosoftOAuthStrategy,
     UserRegistrationListener,
     TestQueuePublisher,
     TestQueueSubscriber,
@@ -873,7 +887,10 @@ import { Entity } from 'typeorm';
 export class SolidCoreModule implements NestModule {
   configure(consumer: MiddlewareConsumer) {
     consumer
-      .apply(express.json({ limit: '10mb' }), express.urlencoded({ limit: '10mb', extended: true }))
+      .apply(
+        express.json({ limit: '10mb' }),
+        express.urlencoded({ limit: '10mb', extended: true }),
+      )
       .forRoutes('*');
   }
 }

package/src/subscribers/computed-entity-field.subscriber.ts

@@ -1,4 +1,4 @@
-import { camelize } from "@angular-devkit/core/src/utils/strings";
+import { camelCase } from 'lodash';
 import { Delete } from "@aws-sdk/client-s3";
 import { forwardRef, Inject, Injectable, InternalServerErrorException, Logger, Scope } from "@nestjs/common";
 import { model } from "mongoose";
@@ -35,33 +35,33 @@ export class ComputedEntityFieldSubscriber implements EntitySubscriberInterface
     }
 
     async beforeInsert(event: InsertEvent<any>): Promise<any> {
-        const modelName = camelize(event.metadata?.name ?? event.entity?.constructor?.name ?? '');
+        const modelName = camelCase(event.metadata?.name ?? event.entity?.constructor?.name ?? '');
         const eventContext = this.sanitizeEventContext(event, 'beforeInsert');
         await this.handleComputedFieldEvaluation(event.entity, ComputedFieldTriggerOperation.beforeInsert, modelName, eventContext);
     }
 
     async beforeUpdate(event: UpdateEvent<any>): Promise<any> {
-        const modelName = camelize(event.metadata?.name ?? event.entity?.constructor?.name ?? '');
+        const modelName = camelCase(event.metadata?.name ?? event.entity?.constructor?.name ?? '');
         const eventContext = this.sanitizeEventContext(event, 'beforeUpdate');
         // await this.handleComputedFieldEvaluation(event.databaseEntity, ComputedFieldTriggerOperation.beforeUpdate, modelName, eventContext);
         await this.handleComputedFieldEvaluation(event.entity, ComputedFieldTriggerOperation.beforeUpdate, modelName, eventContext);
     }
 
     afterInsert(event: InsertEvent<any>) {
-        const modelName = camelize(event.metadata?.name ?? event.entity?.constructor?.name ?? '');
+        const modelName = camelCase(event.metadata?.name ?? event.entity?.constructor?.name ?? '');
         const eventContext = this.sanitizeEventContext(event, 'afterInsert');
         this.handleComputedFieldEvaluationJob(event.entity, ComputedFieldTriggerOperation.afterInsert, modelName, eventContext);
     }
 
     afterUpdate(event: UpdateEvent<any>) {
-        const modelName = camelize(event.metadata?.name ?? event.entity?.constructor?.name ?? event.databaseEntity?.constructor?.name ?? '');
+        const modelName = camelCase(event.metadata?.name ?? event.entity?.constructor?.name ?? event.databaseEntity?.constructor?.name ?? '');
         const eventContext = this.sanitizeEventContext(event, 'afterUpdate');
         // this.handleComputedFieldEvaluationJob(event.databaseEntity, ComputedFieldTriggerOperation.afterUpdate, modelName, eventContext);
         this.handleComputedFieldEvaluationJob(event.entity, ComputedFieldTriggerOperation.afterUpdate, modelName, eventContext);
     }
 
     afterRemove(event: RemoveEvent<any>) {
-        const modelName = camelize(event.metadata?.name ?? event.entity?.constructor?.name ?? event.databaseEntity?.constructor?.name ?? '');
+        const modelName = camelCase(event.metadata?.name ?? event.entity?.constructor?.name ?? event.databaseEntity?.constructor?.name ?? '');
         const eventContext = this.sanitizeEventContext(event, 'afterRemove');
         this.handleComputedFieldEvaluationJob(event.databaseEntity, ComputedFieldTriggerOperation.afterRemove, modelName, eventContext);
     }

package/src/testing/contracts/testing-metadata.types.ts

@@ -18,6 +18,7 @@ export interface TestingUserSpec {
   fullName?: string;
   mobile?: string;
   roles?: string[];
+  [key: string]: any;
 }
 
 export interface TestingMetadata {

package/src/testing/steps/ui/assertions.step.ts

@@ -22,6 +22,15 @@ export function registerAssertionSteps(registry: StepRegistry): void {
     await page.waitForSelector(input.selector, { state: "visible" });
   });
 
+  registry.register("ui.expectHidden", async (ctx: TestContext, step: OpStep) => {
+    const page = requirePage(ctx, "ui.expectHidden");
+    const input = (step.with ?? {}) as VisibleInput;
+    if (!input.selector) {
+      throw new Error('Missing "selector" in step.with for op "ui.expectHidden"');
+    }
+    await page.waitForSelector(input.selector, { state: "hidden" });
+  });
+
   registry.register("ui.expectText", async (ctx: TestContext, step: OpStep) => {
     const page = requirePage(ctx, "ui.expectText");
     const input = (step.with ?? {}) as ExpectTextInput;

package/src/testing/steps/ui/form.step.ts

@@ -1,9 +1,12 @@
+import * as path from "path";
+
 import type { TestContext } from "../../contracts/runtime-context.types";
 import type { OpStep } from "../../contracts/testing-metadata.types";
 import { StepRegistry } from "../../core/step-registry";
 
 type FillInput = { selector: string; value: string };
 type SelectInput = { selector: string; value: string };
+type UploadFileInput = { selector: string; filePath: string | string[] };
 
 function requirePage(ctx: TestContext, op: string) {
   if (!ctx.ui || !ctx.ui.page) {
@@ -36,4 +39,20 @@ export function registerFormSteps(registry: StepRegistry): void {
     }
     await page.selectOption(input.selector, String(input.value));
   });
+
+  registry.register("ui.uploadFile", async (ctx: TestContext, step: OpStep) => {
+    const page = requirePage(ctx, "ui.uploadFile");
+    const input = (step.with ?? {}) as UploadFileInput;
+    if (!input.selector) {
+      throw new Error('Missing "selector" in step.with for op "ui.uploadFile"');
+    }
+    if (input.filePath === undefined || input.filePath === null) {
+      throw new Error('Missing "filePath" in step.with for op "ui.uploadFile"');
+    }
+    const cwd = process.cwd();
+    const resolved = Array.isArray(input.filePath)
+      ? input.filePath.map((p) => path.resolve(cwd, String(p)))
+      : path.resolve(cwd, String(input.filePath));
+    await page.setInputFiles(input.selector, resolved);
+  });
 }

package/src/winston.logger.ts

@@ -7,7 +7,7 @@ import * as winston from 'winston';
 import { Environment } from './decorators/disallow-in-production.decorator';
 
 export const WinstonLoggerConfig = {
-    level: process.env.LOG_LEVEL || (process.env.ENV === Environment.Production ? 'warn' : 'debug'),
+    level: process.env.LOG_LEVEL || (process.env.ENV === Environment.Production ? 'info' : 'debug'),
     format: winston.format.combine(
         winston.format.timestamp(),
         winston.format.errors({ stack: true }),

package/tsconfig.json

@@ -12,6 +12,9 @@
     "outDir": "./dist",
     "rootDir": "./src",
     "baseUrl": "./",
+    "paths": {
+      "src/*": ["./src/*"]
+    },
     "incremental": false,
     "skipLibCheck": true,
     "strictNullChecks": false,

package/dev-grooming-docs/ozzy-prompts.txt

@@ -1,70 +0,0 @@
-Hi Ozzy, 
-Can you give me instructions to create a new model in the fees portal module, you can call it address-master. 
-This model needs to have the following fields. 
-1. address1 - shortText 
-2. address2 - shortText 
-3. addressType - selectionStatic with values - home, office & other. 
-4. city - many2one with the city model
-5. state - many2one with the state model
-6. pincode - many2one with the state model. 
-
-After I add this model I want to start storing student address. 
-
-To do this if you can also give me instructions on how to add a relation field to the student model, you can call this field studentAddress.
-
-
-
-
-
-
-Can you now create a new computed field provider. 
-- You can call this provider: StateTotalCitiesComputedFieldProvider
-- This will be a post computation provider and will depend on the city model being inserted, deleted, updated. 
-- The implementation simply needs to take a count of cities that belong to the same state as the city being mutated and update the state totalCities field.
-
-
-Can you now create a new computed field provider. 
-- You can call this provider: StateTotalPopulationComputedFieldProvider
-- This will be a post computation provider and will depend on the city model being inserted, deleted, updated. 
-- The implementation simply needs to take a sum of population of each city that belong to the same state as the city being mutated and update the state totalPopulation field.
-
-
-Can you now create a new computed field provider. 
-- You can call this provider: StateTotalGdpComputedFieldProvider
-- This will be a post computation provider and will depend on the city model being inserted, deleted, updated. 
-- The implementation simply needs to take a sum of gdp of each city that belong to the same state as the city being mutated and update the state totalGdp field.
-- I will add the totalGdp field to the state model after I have the computed provider TS code. 
-
-
-# Testing prompt sequence
-
-## Create Module 
-Can you create a new module called address-master. This will be used to store address master data. 
-
-## Add Model - Country 
-Can you add a new model to the address-master module called country. 
-This will have name, description (richText), countryCode. You can assume name & countryCode to be unique. But only name will be used as a userkey. 
-Also enable audit tracking on the model and all its fields.
-Make sure the table name is properly prefixed with the module name snake case. 
-
-## Add Model - Language
-Can you add a new model to the address-master module called language. 
-This will have language, languageIsoCode. You can assume language to be unique. 
-Also for the languageIsoCode, can you create a field with type staticSelection add a bunch (20 odd, include at-least 7-8 indian languages also) of commonly spoken languages with their respective language codes as values.
-Also enable audit tracking on the model and all its fields.
-Make sure the table name is properly prefixed with the module name snake case. 
-
-## Add Model - Country Language 
-
-Can you now add a new model called CountrySpokenLanguages, this model will have 2 many-to-one fields. 
-1. country - many-to-one with the country model. 
-2. spokenLanguage - many-to-one with the language model. 
-3. spokenBy - int field storing data representing how many people speak that language.
-Also enable audit tracking on the model and all its fields.
-Make sure the table name is properly prefixed with the module name snake case. 
-
-## Add Model - Country Population Trend 
-Can you add a model called CountryPopulationTrend, this model has the following fields. 
-1. country - many-to-one with the country model. 
-2. entryDate - date field. 
-3. populationAsOnDate - int field storing the population of that country as on that date. 

package/docs/grouping-enhancements.md

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

@@ -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`)