@solidxai/core 0.1.10-beta.21 → 0.1.10-beta.23

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

@@ -6,13 +6,12 @@ import { ModelMetadataRepository } from 'src/repository/model-metadata.repositor
 import { InstanceWrapper } from '@nestjs/core/injector/instance-wrapper';
 import { getDataSourceToken } from '@nestjs/typeorm';
 import { IS_COMPUTED_FIELD_PROVIDER } from 'src/decorators/computed-field-provider.decorator';
-import { IS_DASHBOARD_QUESTION_DATA_PROVIDER } from 'src/decorators/dashboard-question-data-provider.decorator';
-import { IS_DASHBOARD_VARIABLE_SELECTION_PROVIDER } from 'src/decorators/dashboard-selection-provider.decorator';
 import { IS_ERROR_CODE_PROVIDER } from 'src/decorators/error-codes-provider.decorator';
 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_DASHBOARD_WIDGET_DATA_PROVIDER } from 'src/decorators/dashboard-widget-data-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';
@@ -70,24 +69,18 @@ export class SolidIntrospectService implements OnApplicationBootstrap {
       this.solidRegistry.registerSelectionProvider(selectionProvider);
     });
 
+    // Register all IDashboardWidgetDataProvider implementations
+    const dashboardWidgetDataProviders = this.discoveryService.getProviders().filter((provider) => this.isDashboardWidgetDataProvider(provider));
+    dashboardWidgetDataProviders.forEach((provider) => {
+      this.solidRegistry.registerDashboardWidgetDataProvider(provider);
+    });
+
     // Register all ISettingsProvider implementations
     const settingsProviders = this.discoveryService.getProviders().filter((provider) => this.isSettingsProvider(provider));
     settingsProviders.forEach((settingsProvider) => {
       this.solidRegistry.registerSettingsProvider(settingsProvider);
     });
 
-    // Register all IDashboardSelectionProvider implementations
-    const dashboardVariableSelectionProviders = this.discoveryService.getProviders().filter((provider) => this.isDashboardVariableSelectionProvider(provider));
-    dashboardVariableSelectionProviders.forEach((dashboardSelectionProvider) => {
-      this.solidRegistry.registerDashboardVariableSelectionProvider(dashboardSelectionProvider);
-    });
-
-    // Register all IDashboardSelectionProvider implementations
-    const dashboardQuestionDataProviders = this.discoveryService.getProviders().filter((provider) => this.isDashboardQuestionDataProvider(provider));
-    dashboardQuestionDataProviders.forEach((provider) => {
-      this.solidRegistry.registerDashboardQuestionDataProvider(provider);
-    });
-
     // Register all IComputedProvider implementations
     const computedFieldProviders = this.discoveryService.getProviders().filter((provider) => this.isComputedFieldProvider(provider));
     computedFieldProviders.forEach((computedFieldProvider) => {
@@ -250,16 +243,6 @@ export class SolidIntrospectService implements OnApplicationBootstrap {
     }
   }
 
-  isDashboardQuestionDataProvider(providerWrapper: InstanceWrapper<any>) {
-    const { instance } = providerWrapper;
-    if (!instance) return false;
-    const provider = this.reflector.get<boolean>(
-      IS_DASHBOARD_QUESTION_DATA_PROVIDER,
-      instance.constructor,
-    );
-    return !!provider;
-  }
-
   // This method identifies a provider as a seeder if it has a seed method i.e duck typing
   private isSeeder(provider: InstanceWrapper) {
     const { instance } = provider;
@@ -294,6 +277,18 @@ export class SolidIntrospectService implements OnApplicationBootstrap {
     return !!isSelectionProvider;
   }
 
+  private isDashboardWidgetDataProvider(provider: InstanceWrapper) {
+    const { instance } = provider;
+    if (!instance) return false;
+
+    const isDashboardWidgetDataProvider = this.reflector.get<boolean>(
+      IS_DASHBOARD_WIDGET_DATA_PROVIDER,
+      instance.constructor,
+    );
+
+    return !!isDashboardWidgetDataProvider;
+  }
+
   private isExtensionUserCreationProvider(provider: InstanceWrapper): boolean {
     const { instance } = provider;
     if (!instance) return false;
@@ -312,16 +307,6 @@ export class SolidIntrospectService implements OnApplicationBootstrap {
     return !!isSettingsProvider;
   }
 
-  private isDashboardVariableSelectionProvider(provider: InstanceWrapper) {
-    const { instance } = provider;
-    if (!instance) return false;
-    const isDashboardSelectionProvider = this.reflector.get<boolean>(
-      IS_DASHBOARD_VARIABLE_SELECTION_PROVIDER,
-      instance.constructor,
-    );
-    return !!isDashboardSelectionProvider;
-  }
-
   private isComputedFieldProvider(provider: InstanceWrapper) {
     const { instance } = provider;
     if (!instance) return false;

package/src/solid-core.module.ts

@@ -14,6 +14,7 @@ import { MulterModule } from "@nestjs/platform-express";
 import { TypeOrmModule } from "@nestjs/typeorm";
 import { RemoveFieldsCommand } from "./commands/remove-fields.command";
 import { FieldMetadataController } from "./controllers/field-metadata.controller";
+import { DashboardController } from "./controllers/dashboard.controller";
 import { MediaStorageProviderMetadataController } from "./controllers/media-storage-provider-metadata.controller";
 import { ModelMetadataController } from "./controllers/model-metadata.controller";
 import { ModuleMetadataController } from "./controllers/module-metadata.controller";
@@ -27,11 +28,14 @@ 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 { MqDashboardMessageBrokerVariableOptionsProvider } from "./services/selection-providers/mq-dashboard-message-broker-variable-options-provider.service";
+import { MqDashboardQueueNameVariableOptionsProvider } from "./services/selection-providers/mq-dashboard-queue-name-variable-options-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";
 import { FieldMetadataService } from "./services/field-metadata.service";
+import { DashboardRuntimeService } from "./services/dashboard-runtime.service";
 import { ListOfValuesService } from "./services/list-of-values.service";
 // import { MediaStorageProviderMetadataSeederService } from './services/media-storage-provider-metadata-seeder.service';
 import { MediaStorageProviderMetadataService } from "./services/media-storage-provider-metadata.service";
@@ -179,12 +183,7 @@ import { ClsModule } from "nestjs-cls";
 import { AiInteractionController } from "./controllers/ai-interaction.controller";
 import { ChatterMessageDetailsController } from "./controllers/chatter-message-details.controller";
 import { ChatterMessageController } from "./controllers/chatter-message.controller";
-import { DashboardQuestionSqlDatasetConfigController } from "./controllers/dashboard-question-sql-dataset-config.controller";
-import { DashboardQuestionController } from "./controllers/dashboard-question.controller";
-import { DashboardVariableController } from "./controllers/dashboard-variable.controller";
-import { DashboardLayoutController } from "./controllers/dashboard-layout.controller";
 
-import { DashboardController } from './controllers/dashboard.controller';
 import { ExportTemplateController } from './controllers/export-template.controller';
 import { ExportTransactionController } from './controllers/export-transaction.controller';
 import { ImportTransactionErrorLogController } from './controllers/import-transaction-error-log.controller';
@@ -207,12 +206,7 @@ import { UserController } from './controllers/user.controller';
 import { AiInteraction } from './entities/ai-interaction.entity';
 import { ChatterMessageDetails } from './entities/chatter-message-details.entity';
 import { ChatterMessage } from './entities/chatter-message.entity';
-import { DashboardQuestionSqlDatasetConfig } from './entities/dashboard-question-sql-dataset-config.entity';
-import { DashboardQuestion } from './entities/dashboard-question.entity';
-import { DashboardVariable } from './entities/dashboard-variable.entity';
-import { DashboardLayout } from './entities/dashboard-layout.entity';
 
-import { Dashboard } from './entities/dashboard.entity';
 import { ExportTemplate } from './entities/export-template.entity';
 import { ExportTransaction } from './entities/export-transaction.entity';
 import { ImportTransactionErrorLog } from './entities/import-transaction-error-log.entity';
@@ -270,17 +264,11 @@ import { TriggerMcpClientPublisherRabbitmq } from "./jobs/rabbitmq/trigger-mcp-c
 import { TriggerMcpClientSubscriberRabbitmq } from "./jobs/rabbitmq/trigger-mcp-client-subscriber.service";
 import { TwilioSmsQueuePublisherRabbitmq } from "./jobs/rabbitmq/twilio-sms-publisher.service";
 import { TwilioSmsQueueSubscriberRabbitmq } from "./jobs/rabbitmq/twilio-sms-subscriber.service";
-import { DashboardMapper } from "./mappers/dashboard-mapper";
 import { ListOfValuesMapper } from "./mappers/list-of-values-mapper";
 import { ActionMetadataRepository } from "./repository/action-metadata.repository";
 import { AiInteractionRepository } from "./repository/ai-interaction.repository";
 import { ChatterMessageDetailsRepository } from "./repository/chatter-message-details.repository";
 import { ChatterMessageRepository } from "./repository/chatter-message.repository";
-import { DashboardQuestionSqlDatasetConfigRepository } from "./repository/dashboard-question-sql-dataset-config.repository";
-import { DashboardQuestionRepository } from "./repository/dashboard-question.repository";
-import { DashboardVariableRepository } from "./repository/dashboard-variable.repository";
-import { DashboardRepository } from "./repository/dashboard.repository";
-import { DashboardLayoutRepository } from "./repository/dashboard-layout.repository";
 
 import { EmailTemplateRepository } from './repository/email-template.repository';
 import { ExportTemplateRepository } from './repository/export-template.repository';
@@ -319,16 +307,22 @@ import { ChatterMessageService } from './services/chatter-message.service';
 import { ConcatComputedFieldProvider } from './services/computed-fields/concat-computed-field-provider.service';
 import { AlphaNumExternalIdComputationProvider } from './services/computed-fields/entity/alpha-num-external-id-computed-field-provider';
 import { ConcatEntityComputedFieldProvider } from './services/computed-fields/entity/concat-entity-computed-field-provider.service';
+import { MqDashboardFailedMessagesKpiProvider } from './services/dashboard-providers/mq-dashboard-failed-messages-kpi-provider.service';
+import { MqDashboardInflightMessagesKpiProvider } from './services/dashboard-providers/mq-dashboard-inflight-messages-kpi-provider.service';
+import { MqDashboardLatencyTrendProvider } from './services/dashboard-providers/mq-dashboard-latency-trend-provider.service';
+import { MqDashboardMessagesOverTimeProvider } from './services/dashboard-providers/mq-dashboard-messages-over-time-provider.service';
+import { MqDashboardQueueWiseAvgElapsedProvider } from './services/dashboard-providers/mq-dashboard-queue-wise-avg-elapsed-provider.service';
+import { MqDashboardQueueWiseFailuresProvider } from './services/dashboard-providers/mq-dashboard-queue-wise-failures-provider.service';
+import { MqDashboardQueueSlaHeatmapProvider } from './services/dashboard-providers/mq-dashboard-queue-sla-heatmap-provider.service';
+import { MqDashboardRecentFailuresProvider } from './services/dashboard-providers/mq-dashboard-recent-failures-provider.service';
+import { MqDashboardStageDistributionProvider } from './services/dashboard-providers/mq-dashboard-stage-distribution-provider.service';
+import { MqDashboardSucceededMessagesKpiProvider } from './services/dashboard-providers/mq-dashboard-succeeded-messages-kpi-provider.service';
+import { MqDashboardSuccessRateKpiProvider } from './services/dashboard-providers/mq-dashboard-success-rate-kpi-provider.service';
+import { MqDashboardTotalMessagesKpiProvider } from './services/dashboard-providers/mq-dashboard-total-messages-kpi-provider.service';
+import { MqDashboardAvgElapsedKpiProvider } from './services/dashboard-providers/mq-dashboard-avg-elapsed-kpi-provider.service';
 import { NoopsEntityComputedFieldProviderService } from './services/computed-fields/entity/noops-entity-computed-field-provider.service';
 import { CRUDService } from './services/crud.service';
 import { CsvService } from './services/csv.service';
-import { DashboardQuestionSqlDatasetConfigService } from './services/dashboard-question-sql-dataset-config.service';
-import { DashboardQuestionService } from './services/dashboard-question.service';
-import { DashboardVariableSQLDynamicProvider } from './services/dashboard-selection-providers/dashboard-variable-sql-dynamic-provider.service';
-import { DasbhoardVariableTestDynamicProvider } from './services/dashboard-selection-providers/dashboard-variable-test-dynamic-provider.service';
-import { DashboardVariableService } from './services/dashboard-variable.service';
-import { DashboardService } from './services/dashboard.service';
-import { DashboardLayoutService } from './services/dashboard-layout.service';
 
 import { ExcelService } from './services/excel.service';
 import { ExportTemplateService } from './services/export-template.service';
@@ -342,9 +336,6 @@ import { LocaleService } from './services/locale.service';
 import { FileS3StorageProvider } from './services/mediaStorageProviders/file-s3-storage-provider';
 import { FileStorageProvider } from './services/mediaStorageProviders/file-storage-provider';
 import { PollerService } from './services/poller.service';
-import { ChartJsSqlDataProvider } from './services/question-data-providers/chartjs-sql-data-provider.service';
-import { PrimeReactDatatableSqlDataProvider } from './services/question-data-providers/prime-react-datatable-sql-data-provider.service';
-import { PrimeReactMeterGroupSqlDataProvider } from './services/question-data-providers/prime-react-meter-group-sql-data-provider.service';
 import { PublisherFactory } from './services/queues/publisher-factory.service';
 import { RequestContextService } from './services/request-context.service';
 import { RoleMetadataService } from './services/role-metadata.service';
@@ -355,14 +346,11 @@ import { AgentEventService } from './services/agent-event.service';
 import { McpAuditLogService } from './services/mcp-audit-log.service';
 import { SchedulerServiceImpl } from './services/scheduled-jobs/scheduler.service';
 import { SecurityRuleService } from './services/security-rule.service';
-import { ListOfDashboardQuestionProvidersSelectionProvider } from './services/selection-providers/list-of-dashboard-question-providers-selection-provider.service';
-import { ListOfDashboardVariableProvidersSelectionProvider } from './services/selection-providers/list-of-dashboard-variable-providers-selection-provider.service';
 import { ListOfScheduledJobsSelectionProvider } from './services/selection-providers/list-of-scheduled-jobs-selection-provider.service';
 import { LocaleListSelectionProvider } from './services/selection-providers/locale-list-selection-provider.service';
 import { SettingService } from './services/setting.service';
 import { TwilioSMSService } from './services/sms/TwilioSMSService';
 import { SolidTsMorphService } from './services/solid-ts-morph.service';
-import { SqlExpressionResolverService } from './services/sql-expression-resolver.service';
 import { TextractService } from './services/textract.service';
 import { UserActivityHistoryService } from './services/user-activity-history.service';
 import { UserViewMetadataService } from './services/user-view-metadata.service';
@@ -371,10 +359,6 @@ import { Three60WhatsappService } from './services/whatsapp/Three60WhatsappServi
 import { AuditSubscriber } from './subscribers/audit.subscriber';
 import { ComputedEntityFieldSubscriber } from './subscribers/computed-entity-field.subscriber';
 import { CreatedByUpdatedBySubscriber } from './subscribers/created-by-updated-by.subscriber';
-import { DashboardQuestionSqlDatasetConfigSubscriber } from './subscribers/dashboard-question-sql-dataset-config.subscriber';
-import { DashboardQuestionSubscriber } from './subscribers/dashboard-question.subscriber';
-import { DashboardVariableSubscriber } from './subscribers/dashboard-variable.subscriber';
-import { DashboardSubscriber } from './subscribers/dashboard.subscriber';
 import { ListOfValuesSubscriber } from './subscribers/list-of-values.subscriber';
 import { ScheduledJobSubscriber } from './subscribers/scheduled-job.subscriber';
 import { SecurityRuleSubscriber } from './subscribers/security-rule.subscriber';
@@ -400,6 +384,10 @@ import { SolidMicroserviceAdapter } from './helpers/solid-microservice-adapter.s
 import { InfoCommand } from './commands/info.command';
 import { ListOfRolesSelectionProvider } from './services/selection-providers/list-of-roles-selectionproviders.service';
 import { Entity } from 'typeorm';
+import { DashboardUserLayout } from './entities/dashboard-user-layout.entity';
+import { DashboardUserLayoutService } from './services/dashboard-user-layout.service';
+import { DashboardUserLayoutController } from './controllers/dashboard-user-layout.controller';
+import { DashboardUserLayoutRepository } from './repositories/dashboard-user-layout.repository';
 
 @Global()
 @Module({
@@ -409,11 +397,6 @@ import { Entity } from 'typeorm';
       AiInteraction,
       ChatterMessage,
       ChatterMessageDetails,
-      Dashboard,
-      DashboardQuestion,
-      DashboardQuestionSqlDatasetConfig,
-      DashboardVariable,
-      DashboardLayout,
       EmailAttachment,
       EmailTemplate,
       ExportTemplate,
@@ -478,6 +461,7 @@ import { Entity } from 'typeorm';
     JwtModule.register({
       global: true,
     }),
+    TypeOrmModule.forFeature([DashboardUserLayout]),
   ],
   controllers: [
     ActionMetadataController,
@@ -485,15 +469,11 @@ import { Entity } from 'typeorm';
     AuthenticationController,
     ChatterMessageController,
     ChatterMessageDetailsController,
-    DashboardController,
-    DashboardQuestionController,
-    DashboardQuestionSqlDatasetConfigController,
-    DashboardVariableController,
-    DashboardLayoutController,
     EmailTemplateController,
     ExportTemplateController,
     ExportTransactionController,
     FieldMetadataController,
+    DashboardController,
     GoogleAuthenticationController,
     FacebookAuthenticationController,
     MicrosoftAuthenticationController,
@@ -530,6 +510,7 @@ import { Entity } from 'typeorm';
     UserViewMetadataController,
     ViewMetadataController,
     ModelSequenceController,
+    DashboardUserLayoutController,
   ],
   providers: [
     {
@@ -557,6 +538,7 @@ import { Entity } from 'typeorm';
     ModelMetadataService,
     ModelMetadataHelperService,
     FieldMetadataService,
+    DashboardRuntimeService,
     RemoveFieldsCommand,
     RefreshModelCommand,
     RefreshModuleCommand,
@@ -578,6 +560,8 @@ import { Entity } from 'typeorm';
     ModuleTestDataService,
     ListOfValuesService,
     ListOfValuesSelectionProvider,
+    MqDashboardQueueNameVariableOptionsProvider,
+    MqDashboardMessageBrokerVariableOptionsProvider,
     PseudoForeignKeySelectionProvider,
     ModelMetadataSubscriber,
     ViewMetadataService,
@@ -722,6 +706,19 @@ import { Entity } from 'typeorm';
     UserRepository,
     SettingService,
     ConcatComputedFieldProvider,
+    MqDashboardTotalMessagesKpiProvider,
+    MqDashboardSucceededMessagesKpiProvider,
+    MqDashboardFailedMessagesKpiProvider,
+    MqDashboardInflightMessagesKpiProvider,
+    MqDashboardSuccessRateKpiProvider,
+    MqDashboardAvgElapsedKpiProvider,
+    MqDashboardMessagesOverTimeProvider,
+    MqDashboardStageDistributionProvider,
+    MqDashboardQueueWiseFailuresProvider,
+    MqDashboardQueueWiseAvgElapsedProvider,
+    MqDashboardQueueSlaHeatmapProvider,
+    MqDashboardLatencyTrendProvider,
+    MqDashboardRecentFailuresProvider,
     FileStorageProvider,
     FileS3StorageProvider,
     MediaRepository,
@@ -741,6 +738,7 @@ import { Entity } from 'typeorm';
     ExportTransactionService,
     ExcelService,
     CsvService,
+    DashboardRuntimeService,
     ImportTransactionService,
     ImportTransactionErrorLogService,
     CreatedByUpdatedBySubscriber,
@@ -753,35 +751,10 @@ import { Entity } from 'typeorm';
     ComputedFieldEvaluationSubscriberRabbitmq,
     ConcatEntityComputedFieldProvider,
     UserActivityHistoryService,
-    DashboardService,
-    DashboardVariableService,
-    DashboardLayoutService,
-    DashboardQuestionService,
-    DashboardVariableSQLDynamicProvider,
-    DasbhoardVariableTestDynamicProvider,
-    ListOfDashboardVariableProvidersSelectionProvider,
-    ListOfDashboardQuestionProvidersSelectionProvider,
-    DashboardQuestionSqlDatasetConfigService,
-    ChartJsSqlDataProvider,
-    PrimeReactMeterGroupSqlDataProvider,
-    PrimeReactDatatableSqlDataProvider,
-    SqlExpressionResolverService,
     AiInteractionService,
-    DashboardMapper,
-    DashboardRepository,
-    DashboardSubscriber,
-    DashboardVariableSubscriber,
-    DashboardQuestionSubscriber,
-    DashboardQuestionSqlDatasetConfigSubscriber,
     NoopsEntityComputedFieldProviderService,
 
     McpHandlerFactory,
-    // SolidCreateDashboardWithWidgetsMcpHandler,
-    // SolidCreateDashboardQuestionMcpHandler,
-    // SolidCreateDashboardQuestionSqlDatasetConfigMcpHandler,
-    // SolidCreateDashboardWidgetMcpHandler,
-    // SolidAddVariableToDashboardMcpHandler,
-    // SolidAddQuestionToDashboardMcpHandler,
 
     SolidTsMorphService,
 
@@ -803,10 +776,6 @@ import { Entity } from 'typeorm';
     ChatterMessageRepository,
     ChatterMessageDetailsRepository,
     AiInteractionRepository,
-    DashboardQuestionSqlDatasetConfigRepository,
-    DashboardQuestionRepository,
-    DashboardVariableRepository,
-    DashboardLayoutRepository,
     EmailTemplateRepository,
     ExportTemplateRepository,
     ExportTransactionRepository,
@@ -839,6 +808,8 @@ import { Entity } from 'typeorm';
     ImageEncodingService,
     SolidMicroserviceAdapter,
     ListOfRolesSelectionProvider,
+    DashboardUserLayoutService,
+    DashboardUserLayoutRepository,
   ],
   exports: [
     AiInteractionService,

package/src/testing/README.md

@@ -15,6 +15,12 @@
 {
   "testing": {
     "specs": ["path/to/register-test-specs.js"],
+    "roles": [
+      { "name": "Editor", "permissions": ["BookController.*"] }
+    ],
+    "users": [
+      { "username": "testEditor", "email": "testEditor@test.local", "password": "Test@1234", "roles": ["Editor"] }
+    ],
     "data": [
       {
         "modelUserKey": "stateMaster",
@@ -227,6 +233,37 @@ Options in `with`:
 - `selector` (required)
 - `key` (required)
 
+### **Op: `ui.waitForManual`**
+Description: Pauses a headed Playwright run so a human can interact with the live browser, then resumes when Enter is pressed in the terminal.
+
+Options in `with`:
+- `message` (optional, defaults to a generic instruction)
+- `prompt` (optional, defaults to `Press Enter to continue...`)
+- `waitForSelector` (optional, waits for a visible selector after resume)
+- `waitForUrlEquals` (optional, waits until the current URL exactly matches)
+- `waitForUrlContains` (optional, waits until the current URL contains a substring)
+- `timeoutMs` (optional, timeout for post-resume waits)
+- `bringToFront` (optional, defaults to `true`)
+
+Notes:
+- Requires `--headless false`.
+- Requires an interactive terminal (TTY).
+- Useful for OTP screens or third-party verification challenges that must be completed by a human.
+
+Example:
+```json
+{
+  "then": {
+    "op": "ui.waitForManual",
+    "with": {
+      "message": "Enter the OTP in the browser, then return here to continue.",
+      "waitForSelector": "text=Dashboard",
+      "timeoutMs": 30000
+    }
+  }
+}
+```
+
 ### **Op: `ui.expectVisible`**
 Description: Waits for an element to be visible.
 
@@ -340,7 +377,6 @@ await runFromMetadata({
 When using `solidctl test run`, specs are loaded from `testing.specs` in module metadata.
 Use `--skip-scenario-ids` to exclude scenarios by id (comma-separated).
 Use `--print-api-logs` to print full API request/response details for `api.request` steps.
-Use `--print-api-logs` to print full API request/response details for `api.request` steps.
 
 ## Run From Metadata
 ```ts
@@ -366,14 +402,16 @@ Full isolated-database workflow:
 
 Lightweight existing-database workflow:
 1. `npx @solidxai/solidctl@latest test data --load`
-2. `npx @solidxai/solidctl@latest test run --module <module-name>`
+2. `npx @solidxai/solidctl@latest test run --module <module-name> --headless false`
 3. `npx @solidxai/solidctl@latest test data --unlink`
 
-`test data --unlink` deletes records declared in `testing.data` in reverse order using each model's `userKeyFieldUserKey` and the entry's `recUserKeyValue`. This assumes `testing.data` is authored in dependency order, with parent records appearing before dependent records.
+`test data --unlink` deletes records declared in `testing.data` in reverse order using each model's actual `userKeyFieldUserKey` value from `testing.data[*].data`. This assumes `testing.data` is authored in dependency order, with parent records appearing before dependent records.
+
+For human-assisted OTP or third-party verification flows, use `ui.waitForManual` in a headed run so the browser remains interactive while the scenario is paused.
 
 ## Add A New Step (SOP)
 1. Create a new `*.step.ts` in the right domain folder.
 2. Implement a `registerXSteps(registry)` function and `registry.register("op.name", handler)`.
 3. Validate required `step.with` fields and throw clear errors.
 4. Use adapters via `ctx.api` / `ctx.ui` and update `ctx.last` when helpful.
-5. Export and register it from the domain `index.ts`.
+5. Export and register it from the domain `index.ts`.

package/src/testing/adapters/ui/playwright-adapter.ts

@@ -18,6 +18,10 @@ export class PlaywrightAdapter {
     this.headless = opts?.headless ?? true;
   }
 
+  isHeadless(): boolean {
+    return this.headless;
+  }
+
   async start(): Promise<void> {
     const { chromium } = await import('playwright');
     this.browser = await chromium.launch({ headless: this.headless });

package/src/testing/steps/ui/index.ts

@@ -3,10 +3,12 @@ import { registerNavigationSteps } from "./navigation.step";
 import { registerFormSteps } from "./form.step";
 import { registerActionSteps } from "./actions.step";
 import { registerAssertionSteps } from "./assertions.step";
+import { registerManualSteps } from "./manual.step";
 
 export function registerUiSteps(registry: StepRegistry): void {
   registerNavigationSteps(registry);
   registerFormSteps(registry);
   registerActionSteps(registry);
   registerAssertionSteps(registry);
+  registerManualSteps(registry);
 }

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

@@ -0,0 +1,80 @@
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+
+import type { TestContext } from "../../contracts/runtime-context.types";
+import type { OpStep } from "../../contracts/testing-metadata.types";
+import { StepRegistry } from "../../core/step-registry";
+
+type WaitForManualInput = {
+  message?: string;
+  prompt?: string;
+  waitForSelector?: string;
+  waitForUrlContains?: string;
+  waitForUrlEquals?: string;
+  timeoutMs?: number;
+  bringToFront?: boolean;
+};
+
+function requirePage(ctx: TestContext, op: string) {
+  if (!ctx.ui || !ctx.ui.page) {
+    throw new Error(`Missing UI page on context for op "${op}"`);
+  }
+  return ctx.ui.page;
+}
+
+export function registerManualSteps(registry: StepRegistry): void {
+  registry.register("ui.waitForManual", async (ctx: TestContext, step: OpStep) => {
+    const page = requirePage(ctx, "ui.waitForManual");
+    const inputConfig = (step.with ?? {}) as WaitForManualInput;
+    const message = inputConfig.message?.trim() || "Manual interaction required.";
+    const prompt = inputConfig.prompt?.trim() || "Press Enter to continue...";
+    const timeoutMs = inputConfig.timeoutMs;
+    const bringToFront = inputConfig.bringToFront ?? true;
+
+    if (ctx.ui?.isHeadless()) {
+      throw new Error('Op "ui.waitForManual" requires headed mode. Re-run with --headless false.');
+    }
+    if (!input.isTTY || !output.isTTY) {
+      throw new Error('Op "ui.waitForManual" requires an interactive terminal (TTY).');
+    }
+
+    if (bringToFront) {
+      await page.bringToFront();
+    }
+
+    console.log("");
+    console.log("════════ Manual Interaction Required ════════");
+    console.log(message);
+    console.log(`Scenario: ${ctx.scenarioId}`);
+    console.log(`Current URL: ${page.url()}`);
+    console.log(prompt);
+
+    const rl = createInterface({ input, output });
+    try {
+      await rl.question("");
+    } finally {
+      rl.close();
+    }
+
+    if (inputConfig.waitForSelector) {
+      await page.waitForSelector(inputConfig.waitForSelector, {
+        state: "visible",
+        timeout: timeoutMs,
+      });
+    }
+
+    if (inputConfig.waitForUrlEquals) {
+      await page.waitForURL(
+        (url) => url.toString() === inputConfig.waitForUrlEquals,
+        { timeout: timeoutMs },
+      );
+    }
+
+    if (inputConfig.waitForUrlContains) {
+      await page.waitForURL(
+        (url) => url.toString().includes(String(inputConfig.waitForUrlContains)),
+        { timeout: timeoutMs },
+      );
+    }
+  });
+}

package/dist/controllers/dashboard-layout.controller.d.ts

@@ -1,47 +0,0 @@
-import { CreateDashboardLayoutDto } from '../dtos/create-dashboard-layout.dto';
-import { UpdateDashboardLayoutDto } from '../dtos/update-dashboard-layout.dto';
-import { DashboardLayoutService } from '../services/dashboard-layout.service';
-export declare class DashboardLayoutController {
-    private readonly service;
-    constructor(service: DashboardLayoutService);
-    create(createDto: CreateDashboardLayoutDto, files: Array<Express.Multer.File>): Promise<import("..").DashboardLayout>;
-    insertMany(createDtos: CreateDashboardLayoutDto[], filesArray?: Express.Multer.File[][]): Promise<import("..").DashboardLayout[]>;
-    upsertUserDashboardLayout(createDtos: CreateDashboardLayoutDto): Promise<import("..").DashboardLayout>;
-    update(id: number, updateDto: UpdateDashboardLayoutDto, files: Array<Express.Multer.File>): Promise<import("..").DashboardLayout>;
-    partialUpdate(id: number, updateDto: UpdateDashboardLayoutDto, files: Array<Express.Multer.File>): Promise<import("..").DashboardLayout>;
-    recoverMany(ids: number[]): Promise<{
-        message: string;
-        recoveredIds: number[];
-    }>;
-    getUserDashboardLayoutByDashboardId(dashboardId: number): Promise<import("..").DashboardLayout | {
-        layout: any;
-    }>;
-    recover(id: number): Promise<{
-        message: string;
-        data: import("..").DashboardLayout;
-    }>;
-    findMany(query: any): Promise<{
-        meta: {
-            totalRecords: number;
-        };
-        groupMeta: any[];
-        groupRecords: any[];
-        records?: undefined;
-    } | {
-        meta: {
-            totalRecords: number;
-            currentPage: number;
-            nextPage: number;
-            prevPage: number;
-            totalPages: number;
-            perPage: number;
-        };
-        records: import("..").DashboardLayout[];
-        groupMeta?: undefined;
-        groupRecords?: undefined;
-    }>;
-    findOne(id: string, query: any): Promise<import("..").DashboardLayout>;
-    deleteMany(ids: number[]): Promise<any>;
-    delete(id: number): Promise<import("..").DashboardLayout>;
-}
-//# sourceMappingURL=dashboard-layout.controller.d.ts.map

package/dist/controllers/dashboard-layout.controller.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dashboard-layout.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/dashboard-layout.controller.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAO/E,qBAEa,yBAAyB;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,sBAAsB;IAK5D,MAAM,CAAS,SAAS,EAAE,wBAAwB,EAAmB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;IAOtG,UAAU,CAAS,UAAU,EAAE,wBAAwB,EAAE,EAAmB,UAAU,GAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,EAAO;IAOpH,yBAAyB,CAAS,UAAU,EAAE,wBAAwB;IAQtE,MAAM,CAAc,EAAE,EAAE,MAAM,EAAU,SAAS,EAAE,wBAAwB,EAAmB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;IAO/H,aAAa,CAAc,EAAE,EAAE,MAAM,EAAU,SAAS,EAAE,wBAAwB,EAAmB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;IAMhI,WAAW,CAAS,GAAG,EAAE,MAAM,EAAE;;;;IAMjC,mCAAmC,CAAuB,WAAW,EAAE,MAAM;;;IAM7E,OAAO,CAAc,EAAE,EAAE,MAAM;;;;IAe/B,QAAQ,CAAU,KAAK,EAAE,GAAG;;;;;;;;;;;;;;;;;;;;IAM5B,OAAO,CAAc,EAAE,EAAE,MAAM,EAAW,KAAK,EAAE,GAAG;IAMpD,UAAU,CAAS,GAAG,EAAE,MAAM,EAAE;IAMhC,MAAM,CAAc,EAAE,EAAE,MAAM;CAKrC"}