@toolstackhq/create-qa-patterns 1.0.11 → 1.0.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolstackhq/create-qa-patterns",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "description": "CLI for generating QA framework templates.",
   "license": "MIT",
   "repository": {

package/templates/cypress-template/config/environments.ts

@@ -8,7 +8,7 @@ type EnvironmentDefaults = {
   };
 };
 
-const environmentDefaults: Record<TestEnvironment, EnvironmentDefaults> = {
+const DEFAULTS: Record<TestEnvironment, EnvironmentDefaults> = {
   dev: {
     uiBaseUrl: "http://127.0.0.1:3000",
     credentials: {
@@ -20,18 +20,18 @@ const environmentDefaults: Record<TestEnvironment, EnvironmentDefaults> = {
     uiBaseUrl: "https://staging-ui.example.internal",
     credentials: {
       username: "staging-user",
-      password: "staging-password"
+      password: "replace-me"
     }
   },
   prod: {
     uiBaseUrl: "https://ui.example.internal",
     credentials: {
       username: "prod-user",
-      password: "prod-password"
+      password: "replace-me"
     }
   }
 };
 
-export function getEnvironmentDefaults(environment: TestEnvironment): EnvironmentDefaults {
-  return environmentDefaults[environment];
+export function getEnvironmentDefaults(testEnv: TestEnvironment): EnvironmentDefaults {
+  return DEFAULTS[testEnv];
 }

package/templates/cypress-template/config/runtime-config.ts

@@ -27,6 +27,7 @@ export type RuntimeConfig = z.infer<typeof runtimeConfigSchema>;
 export function loadRuntimeConfig(): RuntimeConfig {
   const defaults = getEnvironmentDefaults(environment);
   const secretManager = new SecretManager(new EnvSecretProvider());
+
   const uiBaseUrl =
     process.env[`${environment.toUpperCase()}_UI_BASE_URL`] ??
     process.env.UI_BASE_URL ??

package/templates/cypress-template/config/secret-manager.ts

@@ -1,19 +1,28 @@
 import type { TestEnvironment } from "./test-env";
 
 export interface SecretProvider {
-  getOptionalSecret(secretName: string, environment: TestEnvironment): string | undefined;
+  getSecret(key: string, testEnv: TestEnvironment): string | undefined;
 }
 
 export class EnvSecretProvider implements SecretProvider {
-  getOptionalSecret(secretName: string, environment: TestEnvironment): string | undefined {
-    return process.env[`${environment.toUpperCase()}_${secretName}`] ?? process.env[secretName];
+  getSecret(key: string, testEnv: TestEnvironment): string | undefined {
+    const envPrefix = testEnv.toUpperCase();
+    return process.env[`${envPrefix}_${key}`] ?? process.env[key];
   }
 }
 
 export class SecretManager {
-  constructor(private readonly secretProvider: SecretProvider) {}
+  constructor(private readonly provider: SecretProvider) {}
 
-  getOptionalSecret(secretName: string, environment: TestEnvironment): string | undefined {
-    return this.secretProvider.getOptionalSecret(secretName, environment);
+  getRequiredSecret(key: string, testEnv: TestEnvironment): string {
+    const value = this.provider.getSecret(key, testEnv);
+    if (!value) {
+      throw new Error(`Missing secret "${key}" for TEST_ENV=${testEnv}`);
+    }
+    return value;
+  }
+
+  getOptionalSecret(key: string, testEnv: TestEnvironment): string | undefined {
+    return this.provider.getSecret(key, testEnv);
   }
 }

package/templates/cypress-template/config/test-env.ts

@@ -1,13 +1,9 @@
-export type TestEnvironment = "dev" | "staging" | "prod";
+import { z } from "zod";
 
-const testEnvironmentValues = new Set<TestEnvironment>(["dev", "staging", "prod"]);
+export const testEnvironmentSchema = z.enum(["dev", "staging", "prod"]);
 
-export function loadTestEnvironment(): TestEnvironment {
-  const testEnv = process.env.TEST_ENV ?? "dev";
-
-  if (!testEnvironmentValues.has(testEnv as TestEnvironment)) {
-    throw new Error(`Unsupported TEST_ENV "${testEnv}". Expected one of: dev, staging, prod.`);
-  }
+export type TestEnvironment = z.infer<typeof testEnvironmentSchema>;
 
-  return testEnv as TestEnvironment;
+export function loadTestEnvironment(): TestEnvironment {
+  return testEnvironmentSchema.parse(process.env.TEST_ENV ?? "dev");
 }

package/templates/cypress-template/cypress/support/data/data-factory.ts

@@ -1,5 +1,5 @@
-import { IdGenerator } from "./id-generator";
 import { createSeededFaker } from "./seeded-faker";
+import { IdGenerator } from "./id-generator";
 
 export type PersonRecord = {
   personId: string;

package/templates/cypress-template/cypress/support/data/id-generator.ts

@@ -1,13 +1,17 @@
 export class IdGenerator {
   private readonly counters = new Map<string, number>();
 
-  constructor(private readonly testRunId: string) {}
+  constructor(private readonly runId: string) {}
 
   next(prefix: string): string {
-    const currentCount = this.counters.get(prefix) ?? 0;
-    const nextCount = currentCount + 1;
-    this.counters.set(prefix, nextCount);
+    const counter = (this.counters.get(prefix) ?? 0) + 1;
+    this.counters.set(prefix, counter);
+    return `${prefix}-${this.runId}-${String(counter).padStart(4, "0")}`;
+  }
 
-    return `${prefix}-${this.testRunId}-${String(nextCount).padStart(4, "0")}`;
+  nextSequence(prefix: string): number {
+    const counter = (this.counters.get(prefix) ?? 0) + 1;
+    this.counters.set(prefix, counter);
+    return counter;
   }
 }

package/templates/cypress-template/cypress/support/data/seeded-faker.ts

@@ -1,11 +1,13 @@
 import { Faker, en } from "@faker-js/faker";
 
-function toNumericSeed(seed: string): number {
-  return seed.split("").reduce((accumulator, character) => accumulator + character.charCodeAt(0), 0);
+function hashSeed(value: string): number {
+  return value.split("").reduce((seed, character) => {
+    return ((seed << 5) - seed + character.charCodeAt(0)) | 0;
+  }, 0);
 }
 
-export function createSeededFaker(seed: string): Faker {
-  const faker = new Faker({ locale: [en] });
-  faker.seed(toNumericSeed(seed));
-  return faker;
+export function createSeededFaker(seedInput: string): Faker {
+  const instance = new Faker({ locale: [en] });
+  instance.seed(Math.abs(hashSeed(seedInput)));
+  return instance;
 }

package/templates/playwright-template/.github/workflows/playwright-tests.yml

@@ -26,20 +26,6 @@ jobs:
         working-directory: templates/playwright-template
         run: npx playwright install --with-deps chromium
 
-      - name: Start API demo server
-        run: npm run dev --workspace @toolstackhq/api-demo-server &
-
-      - name: Start UI demo app
-        run: npm run dev --workspace @toolstackhq/ui-demo-app &
-
-      - name: Wait for demo services
-        run: |
-          for target in http://127.0.0.1:3000/health http://127.0.0.1:3001/health; do
-            until curl --silent --fail "$target" >/dev/null; do
-              sleep 1
-            done
-          done
-
       - name: Run Playwright validation
         working-directory: templates/playwright-template
         env:

package/templates/playwright-template/data/generators/seeded-faker.ts

@@ -1,4 +1,4 @@
-import { faker } from "@faker-js/faker";
+import { Faker, en } from "@faker-js/faker";
 
 function hashSeed(value: string): number {
   return value.split("").reduce((seed, character) => {
@@ -6,8 +6,8 @@ function hashSeed(value: string): number {
   }, 0);
 }
 
-export function createSeededFaker(seedInput: string) {
-  const instance = faker;
+export function createSeededFaker(seedInput: string): Faker {
+  const instance = new Faker({ locale: [en] });
   instance.seed(Math.abs(hashSeed(seedInput)));
   return instance;
 }