@solidxai/core 0.1.13-beta.4 → 0.1.13-beta.6

package/dist/testing/steps/ui/assertions.step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assertions.step.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/ui/assertions.step.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAYxD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAgDnE"}
+{"version":3,"file":"assertions.step.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/ui/assertions.step.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAiBxD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAwDnE"}

package/dist/testing/steps/ui/assertions.step.js

@@ -14,7 +14,10 @@ function registerAssertionSteps(registry) {
         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, step) => {
         const page = requirePage(ctx, "ui.expectHidden");
@@ -22,7 +25,10 @@ function registerAssertionSteps(registry) {
         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, step) => {
         const page = requirePage(ctx, "ui.expectText");
@@ -30,7 +36,9 @@ function registerAssertionSteps(registry) {
         if (!input.selector) {
             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(`Expected text to equal "${input.equals}" but got "${text}"`);

package/dist/testing/steps/ui/assertions.step.js.map

@@ -1 +1 @@
-{"version":3,"file":"assertions.step.js","sourceRoot":"","sources":["../../../../src/testing/steps/ui/assertions.step.ts"],"names":[],"mappings":";;AAcA,wDAgDC;AAvDD,SAAS,WAAW,CAAC,GAAgB,EAAE,EAAU;IAC/C,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,SAAgB,sBAAsB,CAAC,QAAsB;IAC3D,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,EAAE,KAAK,EAAE,GAAgB,EAAE,IAAY,EAAE,EAAE;QAC7E,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAiB,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC/E,CAAC;QACD,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,EAAE,KAAK,EAAE,GAAgB,EAAE,IAAY,EAAE,EAAE;QAC5E,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAiB,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,CAAC,eAAe,EAAE,KAAK,EAAE,GAAgB,EAAE,IAAY,EAAE,EAAE;QAC1E,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAoB,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,CAAC;QAC5D,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,IAAI,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CACb,2BAA2B,KAAK,CAAC,MAAM,cAAc,IAAI,GAAG,CAC7D,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CACb,6BAA6B,KAAK,CAAC,QAAQ,cAAc,IAAI,GAAG,CACjE,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { TestContext } from \"../../contracts/runtime-context.types\";\nimport type { OpStep } from \"../../contracts/testing-metadata.types\";\nimport { StepRegistry } from \"../../core/step-registry\";\n\ntype VisibleInput = { selector: string };\ntype ExpectTextInput = { selector: string; equals?: string; contains?: string };\n\nfunction requirePage(ctx: TestContext, op: string) {\n  if (!ctx.ui || !ctx.ui.page) {\n    throw new Error(`Missing UI page on context for op \"${op}\"`);\n  }\n  return ctx.ui.page;\n}\n\nexport function registerAssertionSteps(registry: StepRegistry): void {\n  registry.register(\"ui.expectVisible\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.expectVisible\");\n    const input = (step.with ?? {}) as VisibleInput;\n    if (!input.selector) {\n      throw new Error('Missing \"selector\" in step.with for op \"ui.expectVisible\"');\n    }\n    await page.waitForSelector(input.selector, { state: \"visible\" });\n  });\n\n  registry.register(\"ui.expectHidden\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.expectHidden\");\n    const input = (step.with ?? {}) as VisibleInput;\n    if (!input.selector) {\n      throw new Error('Missing \"selector\" in step.with for op \"ui.expectHidden\"');\n    }\n    await page.waitForSelector(input.selector, { state: \"hidden\" });\n  });\n\n  registry.register(\"ui.expectText\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.expectText\");\n    const input = (step.with ?? {}) as ExpectTextInput;\n    if (!input.selector) {\n      throw new Error('Missing \"selector\" in step.with for op \"ui.expectText\"');\n    }\n\n    const text = await page.locator(input.selector).innerText();\n    if (input.equals !== undefined) {\n      if (text !== input.equals) {\n        throw new Error(\n          `Expected text to equal \"${input.equals}\" but got \"${text}\"`,\n        );\n      }\n      return;\n    }\n    if (input.contains !== undefined) {\n      if (!text.includes(input.contains)) {\n        throw new Error(\n          `Expected text to contain \"${input.contains}\" but got \"${text}\"`,\n        );\n      }\n      return;\n    }\n\n    throw new Error(\n      'Missing \"equals\" or \"contains\" in step.with for op \"ui.expectText\"',\n    );\n  });\n}\n"]}
+{"version":3,"file":"assertions.step.js","sourceRoot":"","sources":["../../../../src/testing/steps/ui/assertions.step.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TestContext } from \"../../contracts/runtime-context.types\";\nimport type { OpStep } from \"../../contracts/testing-metadata.types\";\nimport { StepRegistry } from \"../../core/step-registry\";\n\ntype VisibleInput = { selector: string; timeoutMs?: number };\ntype ExpectTextInput = {\n  selector: string;\n  equals?: string;\n  contains?: string;\n  timeoutMs?: number;\n};\n\nfunction requirePage(ctx: TestContext, op: string) {\n  if (!ctx.ui || !ctx.ui.page) {\n    throw new Error(`Missing UI page on context for op \"${op}\"`);\n  }\n  return ctx.ui.page;\n}\n\nexport function registerAssertionSteps(registry: StepRegistry): void {\n  registry.register(\"ui.expectVisible\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.expectVisible\");\n    const input = (step.with ?? {}) as VisibleInput;\n    if (!input.selector) {\n      throw new Error('Missing \"selector\" in step.with for op \"ui.expectVisible\"');\n    }\n    await page.waitForSelector(input.selector, {\n      state: \"visible\",\n      timeout: ctx.ui?.resolveTimeout(input.timeoutMs),\n    });\n  });\n\n  registry.register(\"ui.expectHidden\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.expectHidden\");\n    const input = (step.with ?? {}) as VisibleInput;\n    if (!input.selector) {\n      throw new Error('Missing \"selector\" in step.with for op \"ui.expectHidden\"');\n    }\n    await page.waitForSelector(input.selector, {\n      state: \"hidden\",\n      timeout: ctx.ui?.resolveTimeout(input.timeoutMs),\n    });\n  });\n\n  registry.register(\"ui.expectText\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.expectText\");\n    const input = (step.with ?? {}) as ExpectTextInput;\n    if (!input.selector) {\n      throw new Error('Missing \"selector\" in step.with for op \"ui.expectText\"');\n    }\n\n    const text = await page\n      .locator(input.selector)\n      .innerText({ timeout: ctx.ui?.resolveTimeout(input.timeoutMs) });\n    if (input.equals !== undefined) {\n      if (text !== input.equals) {\n        throw new Error(\n          `Expected text to equal \"${input.equals}\" but got \"${text}\"`,\n        );\n      }\n      return;\n    }\n    if (input.contains !== undefined) {\n      if (!text.includes(input.contains)) {\n        throw new Error(\n          `Expected text to contain \"${input.contains}\" but got \"${text}\"`,\n        );\n      }\n      return;\n    }\n\n    throw new Error(\n      'Missing \"equals\" or \"contains\" in step.with for op \"ui.expectText\"',\n    );\n  });\n}\n"]}

package/dist/testing/steps/ui/form.step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form.step.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/ui/form.step.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAaxD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAwC9D"}
+{"version":3,"file":"form.step.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/ui/form.step.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAiBxD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CA8C9D"}

package/dist/testing/steps/ui/form.step.js

@@ -51,7 +51,9 @@ function registerFormSteps(registry) {
         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, step) => {
         const page = requirePage(ctx, "ui.select");
@@ -62,7 +64,9 @@ function registerFormSteps(registry) {
         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, step) => {
         const page = requirePage(ctx, "ui.uploadFile");
@@ -77,7 +81,9 @@ function registerFormSteps(registry) {
         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),
+        });
     });
 }
 //# sourceMappingURL=form.step.js.map

package/dist/testing/steps/ui/form.step.js.map

@@ -1 +1 @@
-{"version":3,"file":"form.step.js","sourceRoot":"","sources":["../../../../src/testing/steps/ui/form.step.ts"],"names":[],"mappings":"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","sourcesContent":["import * as path from \"path\";\n\nimport type { TestContext } from \"../../contracts/runtime-context.types\";\nimport type { OpStep } from \"../../contracts/testing-metadata.types\";\nimport { StepRegistry } from \"../../core/step-registry\";\n\ntype FillInput = { selector: string; value: string };\ntype SelectInput = { selector: string; value: string };\ntype UploadFileInput = { selector: string; filePath: string | string[] };\n\nfunction requirePage(ctx: TestContext, op: string) {\n  if (!ctx.ui || !ctx.ui.page) {\n    throw new Error(`Missing UI page on context for op \"${op}\"`);\n  }\n  return ctx.ui.page;\n}\n\nexport function registerFormSteps(registry: StepRegistry): void {\n  registry.register(\"ui.fill\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.fill\");\n    const input = (step.with ?? {}) as FillInput;\n    if (!input.selector) {\n      throw new Error('Missing \"selector\" in step.with for op \"ui.fill\"');\n    }\n    if (input.value === undefined) {\n      throw new Error('Missing \"value\" in step.with for op \"ui.fill\"');\n    }\n    await page.fill(input.selector, String(input.value));\n  });\n\n  registry.register(\"ui.select\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.select\");\n    const input = (step.with ?? {}) as SelectInput;\n    if (!input.selector) {\n      throw new Error('Missing \"selector\" in step.with for op \"ui.select\"');\n    }\n    if (input.value === undefined) {\n      throw new Error('Missing \"value\" in step.with for op \"ui.select\"');\n    }\n    await page.selectOption(input.selector, String(input.value));\n  });\n\n  registry.register(\"ui.uploadFile\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.uploadFile\");\n    const input = (step.with ?? {}) as UploadFileInput;\n    if (!input.selector) {\n      throw new Error('Missing \"selector\" in step.with for op \"ui.uploadFile\"');\n    }\n    if (input.filePath === undefined || input.filePath === null) {\n      throw new Error('Missing \"filePath\" in step.with for op \"ui.uploadFile\"');\n    }\n    const cwd = process.cwd();\n    const resolved = Array.isArray(input.filePath)\n      ? input.filePath.map((p) => path.resolve(cwd, String(p)))\n      : path.resolve(cwd, String(input.filePath));\n    await page.setInputFiles(input.selector, resolved);\n  });\n}\n"]}
+{"version":3,"file":"form.step.js","sourceRoot":"","sources":["../../../../src/testing/steps/ui/form.step.ts"],"names":[],"mappings":"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","sourcesContent":["import * as path from \"path\";\n\nimport type { TestContext } from \"../../contracts/runtime-context.types\";\nimport type { OpStep } from \"../../contracts/testing-metadata.types\";\nimport { StepRegistry } from \"../../core/step-registry\";\n\ntype FillInput = { selector: string; value: string; timeoutMs?: number };\ntype SelectInput = { selector: string; value: string; timeoutMs?: number };\ntype UploadFileInput = {\n  selector: string;\n  filePath: string | string[];\n  timeoutMs?: number;\n};\n\nfunction requirePage(ctx: TestContext, op: string) {\n  if (!ctx.ui || !ctx.ui.page) {\n    throw new Error(`Missing UI page on context for op \"${op}\"`);\n  }\n  return ctx.ui.page;\n}\n\nexport function registerFormSteps(registry: StepRegistry): void {\n  registry.register(\"ui.fill\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.fill\");\n    const input = (step.with ?? {}) as FillInput;\n    if (!input.selector) {\n      throw new Error('Missing \"selector\" in step.with for op \"ui.fill\"');\n    }\n    if (input.value === undefined) {\n      throw new Error('Missing \"value\" in step.with for op \"ui.fill\"');\n    }\n    await page.fill(input.selector, String(input.value), {\n      timeout: ctx.ui?.resolveTimeout(input.timeoutMs),\n    });\n  });\n\n  registry.register(\"ui.select\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.select\");\n    const input = (step.with ?? {}) as SelectInput;\n    if (!input.selector) {\n      throw new Error('Missing \"selector\" in step.with for op \"ui.select\"');\n    }\n    if (input.value === undefined) {\n      throw new Error('Missing \"value\" in step.with for op \"ui.select\"');\n    }\n    await page.selectOption(input.selector, String(input.value), {\n      timeout: ctx.ui?.resolveTimeout(input.timeoutMs),\n    });\n  });\n\n  registry.register(\"ui.uploadFile\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.uploadFile\");\n    const input = (step.with ?? {}) as UploadFileInput;\n    if (!input.selector) {\n      throw new Error('Missing \"selector\" in step.with for op \"ui.uploadFile\"');\n    }\n    if (input.filePath === undefined || input.filePath === null) {\n      throw new Error('Missing \"filePath\" in step.with for op \"ui.uploadFile\"');\n    }\n    const cwd = process.cwd();\n    const resolved = Array.isArray(input.filePath)\n      ? input.filePath.map((p) => path.resolve(cwd, String(p)))\n      : path.resolve(cwd, String(input.filePath));\n    await page.setInputFiles(input.selector, resolved, {\n      timeout: ctx.ui?.resolveTimeout(input.timeoutMs),\n    });\n  });\n}\n"]}

package/dist/testing/steps/ui/manual.step.js

@@ -15,7 +15,7 @@ function registerManualSteps(registry) {
         const inputConfig = (step.with ?? {});
         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()) {
             throw new Error('Op "ui.waitForManual" requires headed mode. Re-run with --headless false.');

package/dist/testing/steps/ui/manual.step.js.map

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

package/dist/testing/steps/ui/navigation.step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation.step.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/ui/navigation.step.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAYxD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAsCpE"}
+{"version":3,"file":"navigation.step.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/ui/navigation.step.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAYxD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAwCpE"}

package/dist/testing/steps/ui/navigation.step.js

@@ -15,7 +15,9 @@ function registerNavigationSteps(registry) {
             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, step) => {
         const page = requirePage(ctx, "ui.expectUrl");

package/dist/testing/steps/ui/navigation.step.js.map

@@ -1 +1 @@
-{"version":3,"file":"navigation.step.js","sourceRoot":"","sources":["../../../../src/testing/steps/ui/navigation.step.ts"],"names":[],"mappings":";;AAcA,0DAsCC;AA7CD,SAAS,WAAW,CAAC,GAAgB,EAAE,EAAU;IAC/C,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,SAAgB,uBAAuB,CAAC,QAAsB;IAC5D,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,EAAE,GAAgB,EAAE,IAAY,EAAE,EAAE;QACpE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAc,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC;QACvD,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,KAAK,EAAE,GAAgB,EAAE,IAAY,EAAE,EAAE;QACzE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAmB,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE3B,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,OAAO,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CACb,0BAA0B,KAAK,CAAC,MAAM,cAAc,OAAO,GAAG,CAC/D,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CACb,4BAA4B,KAAK,CAAC,QAAQ,cAAc,OAAO,GAAG,CACnE,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { TestContext } from \"../../contracts/runtime-context.types\";\nimport type { OpStep } from \"../../contracts/testing-metadata.types\";\nimport { StepRegistry } from \"../../core/step-registry\";\n\ntype GotoInput = { url: string };\ntype ExpectUrlInput = { equals?: string; contains?: string };\n\nfunction requirePage(ctx: TestContext, op: string) {\n  if (!ctx.ui || !ctx.ui.page) {\n    throw new Error(`Missing UI page on context for op \"${op}\"`);\n  }\n  return ctx.ui.page;\n}\n\nexport function registerNavigationSteps(registry: StepRegistry): void {\n  registry.register(\"ui.goto\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.goto\");\n    const input = (step.with ?? {}) as GotoInput;\n    if (!input.url) {\n      throw new Error('Missing \"url\" in step.with for op \"ui.goto\"');\n    }\n    const url = ctx.ui?.resolveUrl(input.url) ?? input.url;\n    await page.goto(url);\n  });\n\n  registry.register(\"ui.expectUrl\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.expectUrl\");\n    const input = (step.with ?? {}) as ExpectUrlInput;\n    const current = page.url();\n\n    if (input.equals !== undefined) {\n      if (current !== input.equals) {\n        throw new Error(\n          `Expected URL to equal \"${input.equals}\" but got \"${current}\"`,\n        );\n      }\n      return;\n    }\n\n    if (input.contains !== undefined) {\n      if (!current.includes(input.contains)) {\n        throw new Error(\n          `Expected URL to contain \"${input.contains}\" but got \"${current}\"`,\n        );\n      }\n      return;\n    }\n\n    throw new Error(\n      'Missing \"equals\" or \"contains\" in step.with for op \"ui.expectUrl\"',\n    );\n  });\n}\n"]}
+{"version":3,"file":"navigation.step.js","sourceRoot":"","sources":["../../../../src/testing/steps/ui/navigation.step.ts"],"names":[],"mappings":";;AAcA,0DAwCC;AA/CD,SAAS,WAAW,CAAC,GAAgB,EAAE,EAAU;IAC/C,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,SAAgB,uBAAuB,CAAC,QAAsB;IAC5D,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,EAAE,GAAgB,EAAE,IAAY,EAAE,EAAE;QACpE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAc,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC;QACvD,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;YACnB,OAAO,EAAE,GAAG,CAAC,EAAE,EAAE,wBAAwB,CAAC,KAAK,CAAC,SAAS,CAAC;SAC3D,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,KAAK,EAAE,GAAgB,EAAE,IAAY,EAAE,EAAE;QACzE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAmB,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE3B,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,OAAO,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CACb,0BAA0B,KAAK,CAAC,MAAM,cAAc,OAAO,GAAG,CAC/D,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CACb,4BAA4B,KAAK,CAAC,QAAQ,cAAc,OAAO,GAAG,CACnE,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { TestContext } from \"../../contracts/runtime-context.types\";\nimport type { OpStep } from \"../../contracts/testing-metadata.types\";\nimport { StepRegistry } from \"../../core/step-registry\";\n\ntype GotoInput = { url: string; timeoutMs?: number };\ntype ExpectUrlInput = { equals?: string; contains?: string };\n\nfunction requirePage(ctx: TestContext, op: string) {\n  if (!ctx.ui || !ctx.ui.page) {\n    throw new Error(`Missing UI page on context for op \"${op}\"`);\n  }\n  return ctx.ui.page;\n}\n\nexport function registerNavigationSteps(registry: StepRegistry): void {\n  registry.register(\"ui.goto\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.goto\");\n    const input = (step.with ?? {}) as GotoInput;\n    if (!input.url) {\n      throw new Error('Missing \"url\" in step.with for op \"ui.goto\"');\n    }\n    const url = ctx.ui?.resolveUrl(input.url) ?? input.url;\n    await page.goto(url, {\n      timeout: ctx.ui?.resolveNavigationTimeout(input.timeoutMs),\n    });\n  });\n\n  registry.register(\"ui.expectUrl\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.expectUrl\");\n    const input = (step.with ?? {}) as ExpectUrlInput;\n    const current = page.url();\n\n    if (input.equals !== undefined) {\n      if (current !== input.equals) {\n        throw new Error(\n          `Expected URL to equal \"${input.equals}\" but got \"${current}\"`,\n        );\n      }\n      return;\n    }\n\n    if (input.contains !== undefined) {\n      if (!current.includes(input.contains)) {\n        throw new Error(\n          `Expected URL to contain \"${input.contains}\" but got \"${current}\"`,\n        );\n      }\n      return;\n    }\n\n    throw new Error(\n      'Missing \"equals\" or \"contains\" in step.with for op \"ui.expectUrl\"',\n    );\n  });\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidxai/core",
-  "version": "0.1.13-beta.4",
+  "version": "0.1.13-beta.6",
   "description": "This module is a NestJS module containing all the required core providers required by a Solid application",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/commands/run-tests.command.ts

@@ -7,6 +7,8 @@ import { WebhookReporter } from 'src/testing/reporter/webhook-reporter';
 import { runFromMetadata } from 'src/testing/runner/run-from-metadata';
 import type { TestingMetadata } from 'src/testing/contracts/testing-metadata.types';
 import { SpecRegistry } from 'src/testing/core/spec-registry';
+import { SettingService } from 'src/services/setting.service';
+import type { SolidCoreSetting } from 'src/services/settings/default-settings-provider.service';
 
 interface TestRunCommandOptions {
   module?: string;
@@ -18,6 +20,8 @@ interface TestRunCommandOptions {
   apiBaseUrl?: string;
   uiBaseUrl?: string;
   headless?: boolean;
+  uiTimeoutMs?: number;
+  uiNavigationTimeoutMs?: number;
   timeoutMs?: number;
   retries?: number;
   listSpecs?: boolean;
@@ -34,6 +38,7 @@ export class TestRunCommand extends CommandRunner {
 
   constructor(
     private readonly moduleMetadataHelperService: ModuleMetadataHelperService,
+    private readonly settingService: SettingService,
   ) {
     super();
   }
@@ -89,6 +94,14 @@ export class TestRunCommand extends CommandRunner {
       const apiBaseUrl = options?.apiBaseUrl ?? process.env.BASE_URL;
       const uiBaseUrl = options?.uiBaseUrl ?? process.env.FRONTEND_BASE_URL;
       const headless = options?.headless ?? true;
+      const uiTimeoutMs =
+        options?.uiTimeoutMs
+        ?? toPositiveNumber(process.env.UI_TIMEOUT_MS)
+        ?? toPositiveNumber(this.settingService.getConfigValue<SolidCoreSetting>('uiTestDefaultTimeoutMs'));
+      const uiNavigationTimeoutMs =
+        options?.uiNavigationTimeoutMs
+        ?? toPositiveNumber(process.env.UI_NAVIGATION_TIMEOUT_MS)
+        ?? toPositiveNumber(this.settingService.getConfigValue<SolidCoreSetting>('uiTestNavigationTimeoutMs'));
       const printApiLogs = options?.printApiLogs ?? false;
 
       const webhookUrl = process.env.SOLIDCTL_WEBHOOK_URL;
@@ -105,7 +118,12 @@ export class TestRunCommand extends CommandRunner {
           skipScenarioIds,
           reporter,
           api: apiBaseUrl ? { baseUrl: apiBaseUrl } : undefined,
-          ui: { baseUrl: uiBaseUrl, headless },
+          ui: {
+            baseUrl: uiBaseUrl,
+            headless,
+            defaultTimeoutMs: uiTimeoutMs,
+            navigationTimeoutMs: uiNavigationTimeoutMs,
+          },
           defaults: {
             timeoutMs: options?.timeoutMs,
             retries: options?.retries,
@@ -225,6 +243,26 @@ export class TestRunCommand extends CommandRunner {
     return val === 'false' ? false : true;
   }
 
+  @Option({
+    flags: '--ui-timeout-ms [number]',
+    description:
+      'Default timeout in ms for UI steps (waits, clicks, fills). Defaults to process.env.UI_TIMEOUT_MS, then the uiTestDefaultTimeoutMs setting, then 30000.',
+    required: false,
+  })
+  parseUiTimeoutMs(val: string): number {
+    return Number(val);
+  }
+
+  @Option({
+    flags: '--ui-navigation-timeout-ms [number]',
+    description:
+      'Default timeout in ms for ui.goto navigation. Defaults to process.env.UI_NAVIGATION_TIMEOUT_MS, then the uiTestNavigationTimeoutMs setting, then --ui-timeout-ms.',
+    required: false,
+  })
+  parseUiNavigationTimeoutMs(val: string): number {
+    return Number(val);
+  }
+
   @Option({
     flags: '--timeout-ms [number]',
     description: 'Default scenario timeout in milliseconds.',
@@ -262,6 +300,14 @@ function splitCsv(value?: string): string[] | undefined {
   return items.length ? items : undefined;
 }
 
+// Accepts unknown because settings come back already parsed as numbers, while env
+// vars arrive as strings.
+function toPositiveNumber(value?: unknown): number | undefined {
+  if (value === null || value === undefined || value === '') return undefined;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
+}
+
 function resolveSpecPath(entry: string, metadataPath: string): string {
   if (path.isAbsolute(entry)) {
     return entry;

package/src/constants/chatter-message.constants.ts

@@ -1,3 +1,5 @@
+import { USER_SUMMARY_FIELDS } from 'src/constants/user.constants';
+
 export const CHATTER_MESSAGE_TYPE = {
     AUDIT: 'audit',
     CUSTOM: 'custom',
@@ -16,3 +18,13 @@ export const CHATTER_MESSAGE_STATUS = {
     PENDING: 'pending',
     COMPLETED: 'completed',
 } as const;
+
+/**
+ * Columns of the message author exposed by the chatter APIs.
+ *
+ * The chatter panel renders `fullName` (name label + initials avatar) and uses `id`
+ * for the own-note edit check; the admin list/form/tree views display `fullName` via
+ * each view's `coModelFieldToDisplay`. That is exactly the platform-wide summary
+ * shape, so this is an alias rather than a second list to keep in step.
+ */
+export const CHATTER_MESSAGE_USER_FIELDS = USER_SUMMARY_FIELDS;

package/src/constants/user.constants.ts

@@ -0,0 +1,13 @@
+/**
+ * The columns of a `User` that are safe to embed in another entity's API response.
+ *
+ * Whenever a user is attached to a record the caller asked for - a `createdBy` /
+ * `updatedBy` populate, a chatter message author - the caller wants to display who it
+ * was, not to read their profile. Everything else on `User` is PII (email, mobile),
+ * authz metadata (roles, apiKeys) or secret, and the embedded user is frequently
+ * someone the viewer has no other visibility of.
+ *
+ * `fullName` is nullable; consumers that need a fallback should use the record's own
+ * context rather than widening this list.
+ */
+export const USER_SUMMARY_FIELDS = ['id', 'fullName'] as const;

package/src/controllers/chatter-message.controller.ts

@@ -95,6 +95,14 @@ export class ChatterMessageController {
     return this.service.find(query);  
   }
 
+  @ApiBearerAuth("jwt")
+  @ApiQuery({ name: 'search', required: false, type: String })
+  @ApiQuery({ name: 'limit', required: false, type: Number })
+  @Get('mentionable-users')
+  async getMentionableUsers(@Query() query: any) {
+    return this.service.getMentionableUsers(query?.search, query?.limit ? +query.limit : undefined);
+  }
+
   @ApiBearerAuth("jwt")
   @Get(':id')
   async findOne(@Param('id') id: string, @Query() query: any) {

package/src/entities/user.entity.ts

@@ -5,6 +5,23 @@ import { UserViewMetadata } from 'src/entities/user-view-metadata.entity'
 import { UserApiKey } from 'src/entities/user-api-key.entity'
 import { Exclude, Expose } from "class-transformer";
 
+/**
+ * Serialization is locked down twice over, and both halves are load-bearing:
+ *
+ * - The class-level `@Exclude()` below makes User itself an allowlist: only `@Expose()`d
+ *   properties are serialized.
+ * - Every other property additionally carries its own `@Exclude()`. That looks redundant
+ *   here, and for `User` it is - but class-transformer resolves the *class-level* strategy
+ *   with a direct lookup on the exact constructor (MetadataStorage.getStrategy), so a
+ *   subclass inherits nothing and falls back to `exposeAll`. Since this entity is a
+ *   `@TableInheritance` root that consuming projects extend (see
+ *   IExtensionUserCreationProvider), an extension user that forgets its own `@Exclude()`
+ *   would otherwise serialize the password hash and every OAuth/verification token.
+ *   Property-level metadata *is* walked up the prototype chain, so the per-property
+ *   decorators are what actually protect subclasses.
+ *
+ * Keep both. Adding a new column? Give it `@Expose()` or `@Exclude()` - never neither.
+ */
 @Entity("ss_user")
 @TableInheritance({ column: { type: "varchar", name: "type", default: "User" } })
 @Exclude()
@@ -30,7 +47,7 @@ export class User extends CommonEntity {
     mobile: string;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     password: string;
 
     @Column({ nullable: true, default: true })
@@ -38,67 +55,67 @@ export class User extends CommonEntity {
     forcePasswordChange: boolean = true;
 
     @Column({ type: "varchar", default: "local" })
-    // don't send to client
+    @Exclude()
     lastLoginProvider: string = "local";
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client (test)
+    @Exclude()
     accessCode: string;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     googleAccessToken: string;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     googleId: string;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     googleProfilePicture: string;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     facebookId: string;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     facebookAccessToken: string;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     facebookProfilePicture: string;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     appleId: string;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     appleAccessToken: string;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     microsoftId: string;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     microsoftAccessToken: string;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     microsoftProfilePicture: string;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     microsoftActiveDirectoryId: string;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     microsoftActiveDirectoryAccessToken: string;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     microsoftActiveDirectoryProfilePicture: string;
 
     @Index()
@@ -107,63 +124,63 @@ export class User extends CommonEntity {
     active: boolean = true;
 
     @Column({ nullable: true })
-    // don't send to client
+    @Exclude()
     forgotPasswordConfirmedAt: Date;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     verificationTokenOnForgotPassword: string;
 
     @Column({ nullable: true })
-    // don't send to client
+    @Exclude()
     verificationTokenOnForgotPasswordExpiresAt: Date;
 
     @Column({ nullable: true })
-    // don't send to client
+    @Exclude()
     emailVerifiedOnRegistrationAt: Date;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     emailVerificationTokenOnRegistration: string;
 
     @Column({ nullable: true })
-    // don't send to client
+    @Exclude()
     emailVerificationTokenOnRegistrationExpiresAt: Date;
 
     @Column({ nullable: true })
-    // don't send to client
+    @Exclude()
     mobileVerifiedOnRegistrationAt: Date;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     mobileVerificationTokenOnRegistration: string;
 
     @Column({ nullable: true })
-    // don't send to client
+    @Exclude()
     mobileVerificationTokenOnRegistrationExpiresAt: Date;
 
     @Column({ nullable: true })
-    // don't send to client
+    @Exclude()
     emailVerifiedOnLoginAt: Date;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     emailVerificationTokenOnLogin: string;
 
     @Column({ nullable: true })
-    // don't send to client
+    @Exclude()
     emailVerificationTokenOnLoginExpiresAt: Date;
 
     @Column({ nullable: true })
-    // don't send to client
+    @Exclude()
     mobileVerifiedOnLoginAt: Date;
 
     @Column({ type: "varchar", nullable: true })
-    // don't send to client
+    @Exclude()
     mobileVerificationTokenOnLogin: string;
 
     @Column({ nullable: true })
-    // don't send to client
+    @Exclude()
     mobileVerificationTokenOnLoginExpiresAt: Date;
 
     @Column({ type: "varchar", nullable: true })
@@ -176,18 +193,18 @@ export class User extends CommonEntity {
     roles: RoleMetadata[];
 
     @OneToMany(() => UserViewMetadata, userViewMetadata => userViewMetadata.user, { cascade: true })
-    // don't send to client
+    @Exclude()
     userViewMetadata: UserViewMetadata[];
 
-    // dont send to client
+    @Exclude()
     @Column({ type: "varchar", default: "bcrypt" })
     passwordScheme: string;
 
-    // dont send to client
+    @Exclude()
     @Column({ type: "int", default: 1 })
     passwordSchemeVersion: number;
 
-    // dont send to client
+    @Exclude()
     @Column({ nullable: true })
     rehashedAt: Date;