@solidxai/core 0.1.12 → 0.1.13-beta.10

package/src/solid-core.module.ts

@@ -38,6 +38,8 @@ import { MqDashboardQueueNameVariableOptionsProvider } from "./services/selectio
 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 { DraftPublishHelperService } from "./services/draft-publish-helper.service";
+import { InternationalisationHelperService } from "./services/internationalisation-helper.service";
 import { CrudHelperService } from "./services/crud-helper.service";
 import { DatasourceManagementService } from "./services/datasource-management.service";
 import { DatasourceIntrospectionService } from "./services/datasource-introspection.service";
@@ -56,10 +58,10 @@ import { ModulePackageService } from "./services/module-package.service";
 import { SolidIntrospectService } from "./services/solid-introspect.service";
 // import { ListOfComputedFieldProvider } from './providers/list-of-computed-field-provider.service';
 import { ServeStaticModule } from "@nestjs/serve-static";
-import { extname, join } from "path";
+import { basename, join } from "path";
 import { RefreshModelCommand } from "./commands/refresh-model.command";
 import { MediaController } from "./controllers/media.controller";
-import { INLINE_SAFE_EXTENSIONS } from "./constants/media-file-types";
+import { getLowercaseFileExtension, INLINE_SAFE_EXTENSIONS } from "./constants/media-file-types";
 
 import { RefreshModuleCommand } from "./commands/refresh-module.command";
 import { ModelMetadataSubscriber } from "./subscribers/model-metadata.subscriber";
@@ -148,6 +150,8 @@ import { ComputedFieldEvaluationPublisherRedis } from "./jobs/redis/computed-fie
 import { ComputedFieldEvaluationSubscriberRedis } from "./jobs/redis/computed-field-evaluation-subscriber-redis.service";
 import { GenerateCodePublisherRedis } from "./jobs/redis/generate-code-publisher-redis.service";
 import { GenerateCodeSubscriberRedis } from "./jobs/redis/generate-code-subscriber-redis.service";
+import { WorkflowExecutionPublisherRedis } from "./jobs/redis/workflow-execution-publisher-redis.service";
+import { WorkflowExecutionSubscriberRedis } from "./jobs/redis/workflow-execution-subscriber-redis.service";
 import { Msg91OTPQueuePublisherRedis } from "./jobs/redis/msg91-otp-publisher-redis.service";
 import { Msg91OTPQueueSubscriberRedis } from "./jobs/redis/msg91-otp-subscriber-redis.service";
 import { Msg91SmsQueuePublisherRedis } from "./jobs/redis/msg91-sms-publisher-redis.service";
@@ -165,6 +169,7 @@ import { GoogleOauthStrategy } from "./passport-strategies/google-oauth.strategy
 import { ApiKeyService } from "./services/api-key.service";
 import { ActiveSessionStorageService } from "./services/active-session-storage.service";
 import { AuthenticationService } from "./services/authentication.service";
+import { MetadataValidationService } from "./services/metadata-validation.service";
 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";
@@ -252,6 +257,8 @@ import { ComputedFieldEvaluationPublisherDatabase } from './jobs/database/comput
 import { ComputedFieldEvaluationSubscriberDatabase } from './jobs/database/computed-field-evaluation-subscriber-database.service';
 import { GenerateCodePublisherDatabase } from './jobs/database/generate-code-publisher-database.service';
 import { GenerateCodeSubscriberDatabase } from './jobs/database/generate-code-subscriber-database.service';
+import { WorkflowExecutionPublisherDatabase } from './jobs/database/workflow-execution-publisher-database.service';
+import { WorkflowExecutionSubscriberDatabase } from './jobs/database/workflow-execution-subscriber-database.service';
 import { OTPQueuePublisherDatabase } from './jobs/database/otp-publisher-database.service';
 import { OTPQueueSubscriberDatabase } from './jobs/database/otp-subscriber-database.service';
 import { Msg91SmsQueuePublisherDatabase } from './jobs/database/msg91-sms-publisher-database.service';
@@ -274,6 +281,8 @@ import { Three60WhatsappQueuePublisherDatabase } from "./jobs/database/three60-w
 import { Three60WhatsappQueueSubscriberDatabase } from "./jobs/database/three60-whatsapp-subscriber-database.service";
 import { GenerateCodePublisherRabbitmq } from "./jobs/rabbitmq/generate-code-publisher.service";
 import { GenerateCodeSubscriberRabbitmq } from "./jobs/rabbitmq/generate-code-subscriber.service";
+import { WorkflowExecutionPublisherRabbitmq } from "./jobs/rabbitmq/workflow-execution-publisher.service";
+import { WorkflowExecutionSubscriberRabbitmq } from "./jobs/rabbitmq/workflow-execution-subscriber.service";
 import { Three60WhatsappQueuePublisher } from "./jobs/rabbitmq/three60-whatsapp-publisher.service";
 import { Three60WhatsappQueueSubscriber } from "./jobs/rabbitmq/three60-whatsapp-subscriber.service";
 import { TwilioSmsQueuePublisherRabbitmq } from "./jobs/rabbitmq/twilio-sms-publisher.service";
@@ -399,6 +408,63 @@ import { DashboardUserLayoutRepository } from './repositories/dashboard-user-lay
 import { MssqlDatasourceIntrospectionProviderService } from "./services/datasource-introspection/mssql-datasource-introspection-provider.service";
 import { MysqlDatasourceIntrospectionProviderService } from "./services/datasource-introspection/mysql-datasource-introspection-provider.service";
 import { PostgresDatasourceIntrospectionProviderService } from "./services/datasource-introspection/postgres-datasource-introspection-provider.service";
+import { WorkflowDefinition } from './entities/workflow-definition.entity';
+import { WorkflowExecution } from './entities/workflow-execution.entity';
+import { WorkflowStepExecution } from './entities/workflow-step-execution.entity';
+import { WorkflowExecutionLog } from './entities/workflow-execution-log.entity';
+import { WorkflowExecutionArtifact } from './entities/workflow-execution-artifact.entity';
+import { WorkflowTriggerExecution } from './entities/workflow-trigger-execution.entity';
+import { WorkflowSecret } from './entities/workflow-secret.entity';
+import { WorkflowDefinitionController } from './controllers/workflow-definition.controller';
+import { WorkflowExecutionController } from './controllers/workflow-execution.controller';
+import { WorkflowStepExecutionController } from './controllers/workflow-step-execution.controller';
+import { WorkflowExecutionLogController } from './controllers/workflow-execution-log.controller';
+import { WorkflowExecutionArtifactController } from './controllers/workflow-execution-artifact.controller';
+import { WorkflowTriggerExecutionController } from './controllers/workflow-trigger-execution.controller';
+import { WorkflowSecretController } from './controllers/workflow-secret.controller';
+import { WorkflowDefinitionService } from './services/workflow-definition.service';
+import { WorkflowDefinitionMetadataSyncService } from './services/workflow/workflow-definition-metadata-sync.service';
+import { WorkflowExecutionService } from './services/workflow-execution.service';
+import { WorkflowStepExecutionService } from './services/workflow-step-execution.service';
+import { WorkflowExecutionLogService } from './services/workflow-execution-log.service';
+import { WorkflowExecutionArtifactService } from './services/workflow-execution-artifact.service';
+import { WorkflowTriggerExecutionService } from './services/workflow-trigger-execution.service';
+import { WorkflowSecretService } from './services/workflow-secret.service';
+import { WorkflowDefinitionRepository } from './repository/workflow-definition.repository';
+import { WorkflowExecutionRepository } from './repository/workflow-execution.repository';
+import { WorkflowStepExecutionRepository } from './repository/workflow-step-execution.repository';
+import { WorkflowExecutionLogRepository } from './repository/workflow-execution-log.repository';
+import { WorkflowExecutionArtifactRepository } from './repository/workflow-execution-artifact.repository';
+import { WorkflowTriggerExecutionRepository } from './repository/workflow-trigger-execution.repository';
+import { WorkflowSecretRepository } from './repository/workflow-secret.repository';
+import { WorkflowDefinitionValidatorService } from './services/workflow/workflow-definition-validator.service';
+import { WorkflowExecutionWriterService } from './services/workflow/workflow-execution-writer.service';
+import { WorkflowExpressionService } from './services/workflow/workflow-expression.service';
+import { WorkflowInvocationService } from './services/workflow/workflow-invocation.service';
+import { WorkflowNodeRegistryService } from './services/workflow/workflow-node-registry.service';
+import { WorkflowRuntimeService } from './services/workflow/workflow-runtime.service';
+import { WorkflowScheduledTriggerJobService } from './services/workflow/workflow-scheduled-trigger.job';
+import { ExecutionFailNode } from './services/workflow/nodes/execution-fail.node';
+import { ForEachNode } from './services/workflow/nodes/for-each.node';
+import { HttpRequestNode } from './services/workflow/nodes/http-request.node';
+import { IfNode } from './services/workflow/nodes/if.node';
+import { LogWriteNode } from './services/workflow/nodes/log-write.node';
+import { LoopUntilNode } from './services/workflow/nodes/loop-until.node';
+import { ParallelNode } from './services/workflow/nodes/parallel.node';
+import { RuntimePythonNode } from './services/workflow/nodes/runtime-python.node';
+import { SequentialNode } from './services/workflow/nodes/sequential.node';
+import {
+  SolidXCreateNode,
+  SolidXDeleteNode,
+  SolidXGetNode,
+  SolidXListNode,
+  SolidXPatchNode,
+  SolidXUpdateNode,
+} from './services/workflow/nodes/solidx-crud.nodes';
+import { SolidXLoginNode } from './services/workflow/nodes/solidx-login.node';
+import { SolidXSendEmailNode } from './services/workflow/nodes/solidx-send-email.node';
+import { SolidXSendSmsNode } from './services/workflow/nodes/solidx-send-sms.node';
+import { SwitchNode } from './services/workflow/nodes/switch.node';
 
 @Global()
 @Module({
@@ -439,6 +505,13 @@ import { PostgresDatasourceIntrospectionProviderService } from "./services/datas
       UserViewMetadata,
       ViewMetadata,
       ModelSequence,
+      WorkflowDefinition,
+      WorkflowExecution,
+      WorkflowStepExecution,
+      WorkflowExecutionLog,
+      WorkflowExecutionArtifact,
+      WorkflowTriggerExecution,
+      WorkflowSecret,
     ]),
 
     CacheModule.registerAsync(CacheManagerOptions),
@@ -465,7 +538,11 @@ import { PostgresDatasourceIntrospectionProviderService } from "./services/datas
           // else (including svg, html, and any other uploaded file) is forced to download
           // rather than be displayed/executed by the browser, regardless of what mimetype or
           // extension it was uploaded with.
-          if (!INLINE_SAFE_EXTENSIONS.has(extname(path).toLowerCase().replace(/^\./, ''))) {
+          // basename first: getLowercaseFileExtension takes a file name, not a path, so a
+          // directory containing a dot must not be mistaken for the extension. An
+          // extensionless file yields undefined, which is not inline-safe - so it correctly
+          // falls through to the forced-download branch.
+          if (!INLINE_SAFE_EXTENSIONS.has(getLowercaseFileExtension(basename(path)) ?? '')) {
             res.setHeader("Content-Type", "application/octet-stream");
             res.setHeader("Content-Disposition", "attachment");
           }
@@ -539,6 +616,13 @@ import { PostgresDatasourceIntrospectionProviderService } from "./services/datas
     ViewMetadataController,
     ModelSequenceController,
     DashboardUserLayoutController,
+    WorkflowDefinitionController,
+    WorkflowExecutionController,
+    WorkflowStepExecutionController,
+    WorkflowExecutionLogController,
+    WorkflowExecutionArtifactController,
+    WorkflowTriggerExecutionController,
+    WorkflowSecretController,
   ],
   providers: [
     {
@@ -567,6 +651,7 @@ import { PostgresDatasourceIntrospectionProviderService } from "./services/datas
     ModuleMetadataExplorerService,
     ModuleMetadataHelperService,
     ModulePackageService,
+    MetadataValidationService,
     ModelMetadataService,
     ModelMetadataHelperService,
     FieldMetadataService,
@@ -579,6 +664,8 @@ import { PostgresDatasourceIntrospectionProviderService } from "./services/datas
     InfoService,
     SolidIntrospectService,
     DiscoveryService,
+    DraftPublishHelperService,
+    InternationalisationHelperService,
     CrudHelperService,
     CRUDService,
     Reflector,
@@ -711,6 +798,8 @@ import { PostgresDatasourceIntrospectionProviderService } from "./services/datas
     ComputedFieldEvaluationSubscriberRedis,
     GenerateCodePublisherRedis,
     GenerateCodeSubscriberRedis,
+    WorkflowExecutionPublisherRedis,
+    WorkflowExecutionSubscriberRedis,
     Msg91OTPQueuePublisherRedis,
     Msg91OTPQueueSubscriberRedis,
     Msg91SmsQueuePublisherRedis,
@@ -727,6 +816,10 @@ import { PostgresDatasourceIntrospectionProviderService } from "./services/datas
     GenerateCodeSubscriberDatabase,
     GenerateCodePublisherRabbitmq,
     GenerateCodeSubscriberRabbitmq,
+    WorkflowExecutionPublisherDatabase,
+    WorkflowExecutionSubscriberDatabase,
+    WorkflowExecutionPublisherRabbitmq,
+    WorkflowExecutionSubscriberRabbitmq,
     Msg91OTPQueuePublisher,
     MqMessageQueueService,
     MqMessageService,
@@ -844,6 +937,47 @@ import { PostgresDatasourceIntrospectionProviderService } from "./services/datas
     ListOfRolesSelectionProvider,
     DashboardUserLayoutService,
     DashboardUserLayoutRepository,
+    WorkflowDefinitionService,
+    WorkflowDefinitionMetadataSyncService,
+    WorkflowDefinitionRepository,
+    WorkflowExecutionService,
+    WorkflowExecutionRepository,
+    WorkflowStepExecutionService,
+    WorkflowStepExecutionRepository,
+    WorkflowExecutionLogService,
+    WorkflowExecutionLogRepository,
+    WorkflowExecutionArtifactService,
+    WorkflowExecutionArtifactRepository,
+    WorkflowTriggerExecutionService,
+    WorkflowTriggerExecutionRepository,
+    WorkflowSecretService,
+    WorkflowSecretRepository,
+    WorkflowInvocationService,
+    WorkflowRuntimeService,
+    WorkflowExecutionWriterService,
+    WorkflowExpressionService,
+    WorkflowDefinitionValidatorService,
+    WorkflowNodeRegistryService,
+    WorkflowScheduledTriggerJobService,
+    ExecutionFailNode,
+    LogWriteNode,
+    HttpRequestNode,
+    IfNode,
+    ForEachNode,
+    LoopUntilNode,
+    ParallelNode,
+    RuntimePythonNode,
+    SequentialNode,
+    SwitchNode,
+    SolidXLoginNode,
+    SolidXListNode,
+    SolidXGetNode,
+    SolidXCreateNode,
+    SolidXUpdateNode,
+    SolidXPatchNode,
+    SolidXDeleteNode,
+    SolidXSendEmailNode,
+    SolidXSendSmsNode,
   ],
   exports: [
     AuthenticationService,
@@ -852,6 +986,8 @@ import { PostgresDatasourceIntrospectionProviderService } from "./services/datas
     ChatterMessageRepository,
     ChatterMessageService,
     ConfigModule,
+    DraftPublishHelperService,
+    InternationalisationHelperService,
     CrudHelperService,
     CRUDService,
     CsvService,
@@ -874,6 +1010,7 @@ import { PostgresDatasourceIntrospectionProviderService } from "./services/datas
     SmsFactory,
     MediaService,
     MediaStorageProviderMetadataService,
+    MetadataValidationService,
     ModelMetadataHelperService,
     ModelMetadataService,
     ModuleMetadataService,
@@ -907,6 +1044,10 @@ import { PostgresDatasourceIntrospectionProviderService } from "./services/datas
     SolidMicroserviceAdapter,
     UserService,
     SettingService,
+    WorkflowInvocationService,
+    WorkflowRuntimeService,
+    WorkflowNodeRegistryService,
+    WorkflowExpressionService,
   ],
 })
 export class SolidCoreModule implements NestModule {

package/src/testing/README.md

@@ -75,6 +75,57 @@ General step fields:
 - `timeoutMs` (optional): per-step timeout override
 - `spec` (optional): used by `test.spec` to identify the spec
 
+## Timeouts
+There are two independent timeout layers. They are easy to confuse, so note which one you want:
+
+**1. Engine timeouts** — `scenario.timeoutMs` and the top-level `step.timeoutMs`.
+These wrap execution in a `Promise.race` (`core/timeout.ts`). They are a hard upper bound
+on wall-clock time and do **not** cancel the underlying browser call, so the failure message
+only tells you the scenario or op that overran.
+
+**2. UI (Playwright) timeouts** — the run-wide default plus per-step `with.timeoutMs`.
+This is what governs how long `ui.expectVisible`, `ui.click`, `ui.fill` etc. wait for a
+selector. Playwright cancels the operation itself, so the error names the selector and the
+state it was waiting for. **If your UI steps are timing out, this is the knob to turn.**
+
+Resolution order for UI steps: `with.timeoutMs` → `--ui-timeout-ms` → `UI_TIMEOUT_MS` →
+`uiTestDefaultTimeoutMs` setting → `30000`.
+`ui.goto` uses the navigation timeout instead: `with.timeoutMs` → `--ui-navigation-timeout-ms`
+→ `UI_NAVIGATION_TIMEOUT_MS` → `uiTestNavigationTimeoutMs` setting → the resolved UI timeout.
+
+Raise the default for a whole run:
+```bash
+solid test run --module <module-name> --ui-timeout-ms 60000
+# or
+UI_TIMEOUT_MS=60000 solid test run --module <module-name>
+```
+
+Or set the installation-wide default under **Settings → Testing Settings** in the admin UI
+(`uiTestDefaultTimeoutMs` / `uiTestNavigationTimeoutMs`). Those rows are created by `solid seed`;
+until then the built-in `30000` applies. Flags and env vars still win, so CI keeps per-run control.
+
+The seeded value of those two settings can be provisioned from the environment with
+`COMMON_UI_TEST_DEFAULT_TIMEOUT_MS` and `COMMON_UI_TEST_NAVIGATION_TIMEOUT_MS` (the latter falls
+back to the former). Seeding is insert-only, so these apply on first seed only — afterwards the
+stored value wins and the setting must be changed in the admin UI. Values that are missing,
+non-numeric, or not positive fall back to `30000`.
+
+Note these are distinct from the run-time `UI_TIMEOUT_MS` / `UI_NAVIGATION_TIMEOUT_MS` vars,
+which override the setting on a per-run basis and are read every run.
+
+Or bump only the one slow step, leaving the rest of the suite strict:
+```json
+{
+  "then": {
+    "op": "ui.expectVisible",
+    "with": { "selector": "#report-grid", "timeoutMs": 90000 }
+  }
+}
+```
+
+Caution: a scenario-level `timeoutMs` lower than the UI timeout will fire first and mask the
+more useful Playwright error. Keep `defaults.timeoutMs` above your UI timeout.
+
 ## Interpolation
 Available tokens:
 - `${env:NAME}` (environment variables)
@@ -198,6 +249,7 @@ Description: Navigates the browser to a URL.
 
 Options in `with`:
 - `url` (required)
+- `timeoutMs` (optional, overrides the run-wide UI navigation timeout)
 
 ### **Op: `ui.expectUrl`**
 Description: Asserts the current page URL.
@@ -212,6 +264,7 @@ Description: Fills an input or editable element.
 Options in `with`:
 - `selector` (required)
 - `value` (required)
+- `timeoutMs` (optional, overrides the run-wide UI timeout)
 
 ### **Op: `ui.select`**
 Description: Selects an option in a select element.
@@ -219,12 +272,14 @@ Description: Selects an option in a select element.
 Options in `with`:
 - `selector` (required)
 - `value` (required)
+- `timeoutMs` (optional, overrides the run-wide UI timeout)
 
 ### **Op: `ui.click`**
 Description: Clicks an element located by selector.
 
 Options in `with`:
 - `selector` (required)
+- `timeoutMs` (optional, overrides the run-wide UI timeout)
 
 ### **Op: `ui.press`**
 Description: Presses a keyboard key on a focused element.
@@ -232,6 +287,7 @@ Description: Presses a keyboard key on a focused element.
 Options in `with`:
 - `selector` (required)
 - `key` (required)
+- `timeoutMs` (optional, overrides the run-wide UI timeout)
 
 ### **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.
@@ -242,7 +298,7 @@ Options in `with`:
 - `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)
+- `timeoutMs` (optional, timeout for post-resume waits; defaults to the run-wide UI timeout)
 - `bringToFront` (optional, defaults to `true`)
 
 Notes:
@@ -269,6 +325,7 @@ Description: Waits for an element to be visible.
 
 Options in `with`:
 - `selector` (required)
+- `timeoutMs` (optional, overrides the run-wide UI timeout)
 
 ### **Op: `ui.expectText`**
 Description: Asserts the text content of an element.
@@ -277,6 +334,7 @@ Options in `with`:
 - `selector` (required)
 - `equals` (optional)
 - `contains` (optional)
+- `timeoutMs` (optional, overrides the run-wide UI timeout)
 
 ### **Op: `assert.equals`**
 Description: Asserts strict equality between two values.
@@ -388,7 +446,12 @@ await runFromMetadata({
   includeTags: ["smoke"],
   defaults: { timeoutMs: 30_000, retries: 1 },
   api: { baseUrl: "https://api.example.com" },
-  ui: { baseUrl: "https://app.example.com", headless: true }
+  ui: {
+    baseUrl: "https://app.example.com",
+    headless: true,
+    defaultTimeoutMs: 30_000,
+    navigationTimeoutMs: 45_000
+  }
 });
 ```
 
@@ -409,6 +472,14 @@ Lightweight existing-database workflow:
 
 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.
 
+Common `test run` flags (all pass through solidctl unchanged):
+- `--ui-base-url <url>` / `--api-base-url <url>`
+- `--headless [true|false]`
+- `--ui-timeout-ms <number>` — default wait for every UI step (see [Timeouts](#timeouts))
+- `--ui-navigation-timeout-ms <number>` — default wait for `ui.goto`
+- `--timeout-ms <number>` / `--retries <number>` — scenario-level guard and retry count
+- `--scenario-ids <ids>` / `--include-tags <tags>` / `--skip-scenario-ids <ids>`
+
 ## 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)`.

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

@@ -6,9 +6,13 @@ function isAbsoluteUrl(url: string): boolean {
   return /^https?:\/\//i.test(url);
 }
 
+export const DEFAULT_UI_TIMEOUT_MS = 30_000;
+
 export class PlaywrightAdapter {
   private readonly baseUrl?: string;
   private readonly headless: boolean;
+  private readonly defaultTimeoutMs: number;
+  private readonly navigationTimeoutMs: number;
   private browser?: Browser;
   private context?: BrowserContext;
   public page?: Page;
@@ -16,16 +20,37 @@ export class PlaywrightAdapter {
   constructor(opts?: PlaywrightAdapterOptions) {
     this.baseUrl = opts?.baseUrl;
     this.headless = opts?.headless ?? true;
+    this.defaultTimeoutMs = opts?.defaultTimeoutMs ?? DEFAULT_UI_TIMEOUT_MS;
+    this.navigationTimeoutMs =
+      opts?.navigationTimeoutMs ?? this.defaultTimeoutMs;
   }
 
   isHeadless(): boolean {
     return this.headless;
   }
 
+  /**
+   * Resolves the timeout for a single Playwright call: an explicit per-step
+   * value wins, otherwise the run-wide default applies.
+   */
+  resolveTimeout(stepTimeoutMs?: number): number {
+    return typeof stepTimeoutMs === 'number' && Number.isFinite(stepTimeoutMs)
+      ? stepTimeoutMs
+      : this.defaultTimeoutMs;
+  }
+
+  resolveNavigationTimeout(stepTimeoutMs?: number): number {
+    return typeof stepTimeoutMs === 'number' && Number.isFinite(stepTimeoutMs)
+      ? stepTimeoutMs
+      : this.navigationTimeoutMs;
+  }
+
   async start(): Promise<void> {
     const { chromium } = await import('playwright');
     this.browser = await chromium.launch({ headless: this.headless });
     this.context = await this.browser.newContext();
+    this.context.setDefaultTimeout(this.defaultTimeoutMs);
+    this.context.setDefaultNavigationTimeout(this.navigationTimeoutMs);
     this.page = await this.context.newPage();
   }
 

package/src/testing/adapters/ui/ui.types.ts

@@ -1,4 +1,6 @@
 export interface PlaywrightAdapterOptions {
   headless?: boolean;
   baseUrl?: string;
+  defaultTimeoutMs?: number;
+  navigationTimeoutMs?: number;
 }

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

@@ -2,8 +2,8 @@ import type { TestContext } from "../../contracts/runtime-context.types";
 import type { OpStep } from "../../contracts/testing-metadata.types";
 import { StepRegistry } from "../../core/step-registry";
 
-type ClickInput = { selector: string };
-type PressInput = { selector: string; key: string };
+type ClickInput = { selector: string; timeoutMs?: number };
+type PressInput = { selector: string; key: string; timeoutMs?: number };
 
 function requirePage(ctx: TestContext, op: string) {
   if (!ctx.ui || !ctx.ui.page) {
@@ -19,7 +19,9 @@ export function registerActionSteps(registry: StepRegistry): void {
     if (!input.selector) {
       throw new Error('Missing "selector" in step.with for op "ui.click"');
     }
-    await page.click(input.selector);
+    await page.click(input.selector, {
+      timeout: ctx.ui?.resolveTimeout(input.timeoutMs),
+    });
   });
 
   registry.register("ui.press", async (ctx: TestContext, step: OpStep) => {
@@ -31,6 +33,8 @@ export function registerActionSteps(registry: StepRegistry): void {
     if (!input.key) {
       throw new Error('Missing "key" in step.with for op "ui.press"');
     }
-    await page.press(input.selector, input.key);
+    await page.press(input.selector, input.key, {
+      timeout: ctx.ui?.resolveTimeout(input.timeoutMs),
+    });
   });
 }

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

@@ -2,8 +2,13 @@ import type { TestContext } from "../../contracts/runtime-context.types";
 import type { OpStep } from "../../contracts/testing-metadata.types";
 import { StepRegistry } from "../../core/step-registry";
 
-type VisibleInput = { selector: string };
-type ExpectTextInput = { selector: string; equals?: string; contains?: string };
+type VisibleInput = { selector: string; timeoutMs?: number };
+type ExpectTextInput = {
+  selector: string;
+  equals?: string;
+  contains?: string;
+  timeoutMs?: number;
+};
 
 function requirePage(ctx: TestContext, op: string) {
   if (!ctx.ui || !ctx.ui.page) {
@@ -19,7 +24,10 @@ export function registerAssertionSteps(registry: StepRegistry): void {
     if (!input.selector) {
       throw new Error('Missing "selector" in step.with for op "ui.expectVisible"');
     }
-    await page.waitForSelector(input.selector, { state: "visible" });
+    await page.waitForSelector(input.selector, {
+      state: "visible",
+      timeout: ctx.ui?.resolveTimeout(input.timeoutMs),
+    });
   });
 
   registry.register("ui.expectHidden", async (ctx: TestContext, step: OpStep) => {
@@ -28,7 +36,10 @@ export function registerAssertionSteps(registry: StepRegistry): void {
     if (!input.selector) {
       throw new Error('Missing "selector" in step.with for op "ui.expectHidden"');
     }
-    await page.waitForSelector(input.selector, { state: "hidden" });
+    await page.waitForSelector(input.selector, {
+      state: "hidden",
+      timeout: ctx.ui?.resolveTimeout(input.timeoutMs),
+    });
   });
 
   registry.register("ui.expectText", async (ctx: TestContext, step: OpStep) => {
@@ -38,7 +49,9 @@ export function registerAssertionSteps(registry: StepRegistry): void {
       throw new Error('Missing "selector" in step.with for op "ui.expectText"');
     }
 
-    const text = await page.locator(input.selector).innerText();
+    const text = await page
+      .locator(input.selector)
+      .innerText({ timeout: ctx.ui?.resolveTimeout(input.timeoutMs) });
     if (input.equals !== undefined) {
       if (text !== input.equals) {
         throw new Error(

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

@@ -4,9 +4,13 @@ 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[] };
+type FillInput = { selector: string; value: string; timeoutMs?: number };
+type SelectInput = { selector: string; value: string; timeoutMs?: number };
+type UploadFileInput = {
+  selector: string;
+  filePath: string | string[];
+  timeoutMs?: number;
+};
 
 function requirePage(ctx: TestContext, op: string) {
   if (!ctx.ui || !ctx.ui.page) {
@@ -25,7 +29,9 @@ export function registerFormSteps(registry: StepRegistry): void {
     if (input.value === undefined) {
       throw new Error('Missing "value" in step.with for op "ui.fill"');
     }
-    await page.fill(input.selector, String(input.value));
+    await page.fill(input.selector, String(input.value), {
+      timeout: ctx.ui?.resolveTimeout(input.timeoutMs),
+    });
   });
 
   registry.register("ui.select", async (ctx: TestContext, step: OpStep) => {
@@ -37,7 +43,9 @@ export function registerFormSteps(registry: StepRegistry): void {
     if (input.value === undefined) {
       throw new Error('Missing "value" in step.with for op "ui.select"');
     }
-    await page.selectOption(input.selector, String(input.value));
+    await page.selectOption(input.selector, String(input.value), {
+      timeout: ctx.ui?.resolveTimeout(input.timeoutMs),
+    });
   });
 
   registry.register("ui.uploadFile", async (ctx: TestContext, step: OpStep) => {
@@ -53,6 +61,8 @@ export function registerFormSteps(registry: StepRegistry): void {
     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);
+    await page.setInputFiles(input.selector, resolved, {
+      timeout: ctx.ui?.resolveTimeout(input.timeoutMs),
+    });
   });
 }

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

@@ -28,7 +28,7 @@ export function registerManualSteps(registry: StepRegistry): void {
     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 timeoutMs = ctx.ui?.resolveTimeout(inputConfig.timeoutMs);
     const bringToFront = inputConfig.bringToFront ?? true;
 
     if (ctx.ui?.isHeadless()) {

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

@@ -2,7 +2,7 @@ import type { TestContext } from "../../contracts/runtime-context.types";
 import type { OpStep } from "../../contracts/testing-metadata.types";
 import { StepRegistry } from "../../core/step-registry";
 
-type GotoInput = { url: string };
+type GotoInput = { url: string; timeoutMs?: number };
 type ExpectUrlInput = { equals?: string; contains?: string };
 
 function requirePage(ctx: TestContext, op: string) {
@@ -20,7 +20,9 @@ export function registerNavigationSteps(registry: StepRegistry): void {
       throw new Error('Missing "url" in step.with for op "ui.goto"');
     }
     const url = ctx.ui?.resolveUrl(input.url) ?? input.url;
-    await page.goto(url);
+    await page.goto(url, {
+      timeout: ctx.ui?.resolveNavigationTimeout(input.timeoutMs),
+    });
   });
 
   registry.register("ui.expectUrl", async (ctx: TestContext, step: OpStep) => {

package/src/transformers/empty-string-to-null-transformer.ts

@@ -0,0 +1,11 @@
+import { TransformFnParams } from "class-transformer";
+
+export const emptyStringToNullTransformer = ({ value }: TransformFnParams) => {
+    if (typeof value === "string" && value.trim() === "") {
+        return null;
+    }
+
+    return value;
+};
+
+export default emptyStringToNullTransformer;