@hyprcart/app-testing 1.0.0

package/README.md

@@ -0,0 +1,5 @@
+# @hyprcart/app-testing
+
+Testing fixtures, preview helpers, and clean-room checks for Hyprcart apps.
+
+This package supports local preview, template verification, external package boundary checks, and Playwright evidence helpers for app development workflows.

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+import { HyprcartFixturePack } from '@hyprcart/app-sdk';
+
+declare const defaultFixturePacks: HyprcartFixturePack[];
+
+interface PreviewDiagnostic {
+    requestId: string;
+    surface: string;
+    quotaClass: string;
+    fixtureId: string;
+    level: "info" | "warning" | "error";
+    message: string;
+    data?: unknown;
+}
+declare function redactedDiagnostic(diagnostic: PreviewDiagnostic): PreviewDiagnostic;
+
+interface PreviewServerState {
+    fixtures: HyprcartFixturePack[];
+    diagnostics: PreviewDiagnostic[];
+    remoteVersionCreated: boolean;
+}
+declare function createPreviewServer(fixtures?: HyprcartFixturePack[]): PreviewServerState;
+declare function previewSurface(state: PreviewServerState, surface: string, fixtureId?: string | undefined): Promise<{
+    html: string;
+    requestId: string;
+}>;
+
+declare function findForbiddenInternalImports(files: Record<string, string>): string[];
+
+interface PlaywrightEvidenceRow {
+    rowId: string;
+    url: string;
+    status: "pass" | "fail" | "blocked";
+    requestIds: string[];
+    notes: string;
+}
+declare function recordEvidence(row: PlaywrightEvidenceRow): PlaywrightEvidenceRow;
+
+interface DriftInput {
+    docsCommands: string[];
+    cliCommands: string[];
+    templateNames: string[];
+    schemaOperations: string[];
+}
+declare function findDeveloperToolingDrift(input: DriftInput): string[];
+
+interface PerformanceBudget {
+    name: string;
+    actualMs: number;
+    budgetMs: number;
+}
+declare function evaluateBudgets(budgets: PerformanceBudget[]): {
+    ok: boolean;
+    name: string;
+    actualMs: number;
+    budgetMs: number;
+}[];
+
+export { type DriftInput, type PerformanceBudget, type PlaywrightEvidenceRow, type PreviewDiagnostic, type PreviewServerState, createPreviewServer, defaultFixturePacks, evaluateBudgets, findDeveloperToolingDrift, findForbiddenInternalImports, previewSurface, recordEvidence, redactedDiagnostic };

package/dist/index.js

@@ -0,0 +1,102 @@
+// src/fixtures/default-packs.ts
+import { createDefaultFixturePack } from "@hyprcart/app-sdk";
+var defaultFixturePacks = [
+  createDefaultFixturePack(),
+  createDefaultFixturePack({
+    id: "fixture_de",
+    name: "German storefront fixture",
+    locale: "de",
+    market: "DE"
+  }),
+  createDefaultFixturePack({
+    id: "fixture_b2b",
+    name: "B2B customer fixture",
+    customerSegment: { id: "segment_b2b", tags: ["b2b", "approved"] }
+  })
+];
+
+// src/preview-server/diagnostics.ts
+import { redact } from "@hyprcart/app-sdk";
+function redactedDiagnostic(diagnostic) {
+  return {
+    ...diagnostic,
+    message: String(redact(diagnostic.message)),
+    data: redact(diagnostic.data)
+  };
+}
+
+// src/preview-server/server.ts
+import { createSurfaceContext, renderSurface } from "@hyprcart/app-sdk";
+function createPreviewServer(fixtures = defaultFixturePacks) {
+  return {
+    fixtures,
+    diagnostics: [],
+    remoteVersionCreated: false
+  };
+}
+async function previewSurface(state, surface, fixtureId = state.fixtures[0]?.id) {
+  const fixture = state.fixtures.find((candidate) => candidate.id === fixtureId) ?? state.fixtures[0];
+  if (!fixture) {
+    throw new Error("No preview fixtures are available.");
+  }
+  const context = createSurfaceContext({ surface, fixture });
+  const result = await renderSurface(context, () => `<div data-hyprcart-preview="${surface}">${fixture.name}</div>`);
+  state.diagnostics.push(
+    redactedDiagnostic({
+      requestId: context.requestId,
+      surface,
+      quotaClass: "local-preview",
+      fixtureId: fixture.id,
+      level: "info",
+      message: "Preview rendered."
+    })
+  );
+  return result;
+}
+
+// src/clean-room/no-internal-imports.ts
+var forbiddenPatterns = [/from\s+["']\.\.\/\.\.\/apps\//, /from\s+["']apps\//, /@repo\/(?!typescript-config)/];
+function findForbiddenInternalImports(files) {
+  return Object.entries(files).filter(([, content]) => forbiddenPatterns.some((pattern) => pattern.test(content))).map(([path]) => path);
+}
+
+// src/playwright/production/evidence.ts
+import { redact as redact2 } from "@hyprcart/app-sdk";
+function recordEvidence(row) {
+  return redact2(row);
+}
+
+// src/drift/developer-tooling-drift.ts
+function findDeveloperToolingDrift(input) {
+  const drift = [];
+  for (const command of input.docsCommands) {
+    if (!input.cliCommands.includes(command)) {
+      drift.push(`docs command missing from CLI: ${command}`);
+    }
+  }
+  for (const template of input.templateNames) {
+    if (!input.schemaOperations.includes("appTemplates")) {
+      drift.push(`template metadata not exposed by schema: ${template}`);
+    }
+  }
+  return drift;
+}
+
+// src/performance/developer-tooling-performance.ts
+function evaluateBudgets(budgets) {
+  return budgets.map((budget) => ({
+    ...budget,
+    ok: budget.actualMs <= budget.budgetMs
+  }));
+}
+export {
+  createPreviewServer,
+  defaultFixturePacks,
+  evaluateBudgets,
+  findDeveloperToolingDrift,
+  findForbiddenInternalImports,
+  previewSurface,
+  recordEvidence,
+  redactedDiagnostic
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fixtures/default-packs.ts","../src/preview-server/diagnostics.ts","../src/preview-server/server.ts","../src/clean-room/no-internal-imports.ts","../src/playwright/production/evidence.ts","../src/drift/developer-tooling-drift.ts","../src/performance/developer-tooling-performance.ts"],"sourcesContent":["import { createDefaultFixturePack, type HyprcartFixturePack } from \"@hyprcart/app-sdk\";\n\nexport const defaultFixturePacks: HyprcartFixturePack[] = [\n  createDefaultFixturePack(),\n  createDefaultFixturePack({\n    id: \"fixture_de\",\n    name: \"German storefront fixture\",\n    locale: \"de\",\n    market: \"DE\",\n  }),\n  createDefaultFixturePack({\n    id: \"fixture_b2b\",\n    name: \"B2B customer fixture\",\n    customerSegment: { id: \"segment_b2b\", tags: [\"b2b\", \"approved\"] },\n  }),\n];\n","import { redact } from \"@hyprcart/app-sdk\";\n\nexport interface PreviewDiagnostic {\n  requestId: string;\n  surface: string;\n  quotaClass: string;\n  fixtureId: string;\n  level: \"info\" | \"warning\" | \"error\";\n  message: string;\n  data?: unknown;\n}\n\nexport function redactedDiagnostic(diagnostic: PreviewDiagnostic): PreviewDiagnostic {\n  return {\n    ...diagnostic,\n    message: String(redact(diagnostic.message)),\n    data: redact(diagnostic.data),\n  };\n}\n","import { createSurfaceContext, renderSurface, type HyprcartFixturePack } from \"@hyprcart/app-sdk\";\nimport { defaultFixturePacks } from \"../fixtures/default-packs\";\nimport { redactedDiagnostic, type PreviewDiagnostic } from \"./diagnostics\";\n\nexport interface PreviewServerState {\n  fixtures: HyprcartFixturePack[];\n  diagnostics: PreviewDiagnostic[];\n  remoteVersionCreated: boolean;\n}\n\nexport function createPreviewServer(fixtures = defaultFixturePacks): PreviewServerState {\n  return {\n    fixtures,\n    diagnostics: [],\n    remoteVersionCreated: false,\n  };\n}\n\nexport async function previewSurface(state: PreviewServerState, surface: string, fixtureId = state.fixtures[0]?.id) {\n  const fixture = state.fixtures.find((candidate) => candidate.id === fixtureId) ?? state.fixtures[0];\n  if (!fixture) {\n    throw new Error(\"No preview fixtures are available.\");\n  }\n\n  const context = createSurfaceContext({ surface, fixture });\n  const result = await renderSurface(context, () => `<div data-hyprcart-preview=\"${surface}\">${fixture.name}</div>`);\n  state.diagnostics.push(\n    redactedDiagnostic({\n      requestId: context.requestId,\n      surface,\n      quotaClass: \"local-preview\",\n      fixtureId: fixture.id,\n      level: \"info\",\n      message: \"Preview rendered.\",\n    }),\n  );\n  return result;\n}\n","const forbiddenPatterns = [/from\\s+[\"']\\.\\.\\/\\.\\.\\/apps\\//, /from\\s+[\"']apps\\//, /@repo\\/(?!typescript-config)/];\n\nexport function findForbiddenInternalImports(files: Record<string, string>): string[] {\n  return Object.entries(files)\n    .filter(([, content]) => forbiddenPatterns.some((pattern) => pattern.test(content)))\n    .map(([path]) => path);\n}\n","import { redact } from \"@hyprcart/app-sdk\";\n\nexport interface PlaywrightEvidenceRow {\n  rowId: string;\n  url: string;\n  status: \"pass\" | \"fail\" | \"blocked\";\n  requestIds: string[];\n  notes: string;\n}\n\nexport function recordEvidence(row: PlaywrightEvidenceRow): PlaywrightEvidenceRow {\n  return redact(row) as PlaywrightEvidenceRow;\n}\n","export interface DriftInput {\n  docsCommands: string[];\n  cliCommands: string[];\n  templateNames: string[];\n  schemaOperations: string[];\n}\n\nexport function findDeveloperToolingDrift(input: DriftInput): string[] {\n  const drift: string[] = [];\n  for (const command of input.docsCommands) {\n    if (!input.cliCommands.includes(command)) {\n      drift.push(`docs command missing from CLI: ${command}`);\n    }\n  }\n  for (const template of input.templateNames) {\n    if (!input.schemaOperations.includes(\"appTemplates\")) {\n      drift.push(`template metadata not exposed by schema: ${template}`);\n    }\n  }\n  return drift;\n}\n","export interface PerformanceBudget {\n  name: string;\n  actualMs: number;\n  budgetMs: number;\n}\n\nexport function evaluateBudgets(budgets: PerformanceBudget[]) {\n  return budgets.map((budget) => ({\n    ...budget,\n    ok: budget.actualMs <= budget.budgetMs,\n  }));\n}\n"],"mappings":";AAAA,SAAS,gCAA0D;AAE5D,IAAM,sBAA6C;AAAA,EACxD,yBAAyB;AAAA,EACzB,yBAAyB;AAAA,IACvB,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,QAAQ;AAAA,EACV,CAAC;AAAA,EACD,yBAAyB;AAAA,IACvB,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,iBAAiB,EAAE,IAAI,eAAe,MAAM,CAAC,OAAO,UAAU,EAAE;AAAA,EAClE,CAAC;AACH;;;ACfA,SAAS,cAAc;AAYhB,SAAS,mBAAmB,YAAkD;AACnF,SAAO;AAAA,IACL,GAAG;AAAA,IACH,SAAS,OAAO,OAAO,WAAW,OAAO,CAAC;AAAA,IAC1C,MAAM,OAAO,WAAW,IAAI;AAAA,EAC9B;AACF;;;AClBA,SAAS,sBAAsB,qBAA+C;AAUvE,SAAS,oBAAoB,WAAW,qBAAyC;AACtF,SAAO;AAAA,IACL;AAAA,IACA,aAAa,CAAC;AAAA,IACd,sBAAsB;AAAA,EACxB;AACF;AAEA,eAAsB,eAAe,OAA2B,SAAiB,YAAY,MAAM,SAAS,CAAC,GAAG,IAAI;AAClH,QAAM,UAAU,MAAM,SAAS,KAAK,CAAC,cAAc,UAAU,OAAO,SAAS,KAAK,MAAM,SAAS,CAAC;AAClG,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,oCAAoC;AAAA,EACtD;AAEA,QAAM,UAAU,qBAAqB,EAAE,SAAS,QAAQ,CAAC;AACzD,QAAM,SAAS,MAAM,cAAc,SAAS,MAAM,+BAA+B,OAAO,KAAK,QAAQ,IAAI,QAAQ;AACjH,QAAM,YAAY;AAAA,IAChB,mBAAmB;AAAA,MACjB,WAAW,QAAQ;AAAA,MACnB;AAAA,MACA,YAAY;AAAA,MACZ,WAAW,QAAQ;AAAA,MACnB,OAAO;AAAA,MACP,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACA,SAAO;AACT;;;ACrCA,IAAM,oBAAoB,CAAC,iCAAiC,qBAAqB,8BAA8B;AAExG,SAAS,6BAA6B,OAAyC;AACpF,SAAO,OAAO,QAAQ,KAAK,EACxB,OAAO,CAAC,CAAC,EAAE,OAAO,MAAM,kBAAkB,KAAK,CAAC,YAAY,QAAQ,KAAK,OAAO,CAAC,CAAC,EAClF,IAAI,CAAC,CAAC,IAAI,MAAM,IAAI;AACzB;;;ACNA,SAAS,UAAAA,eAAc;AAUhB,SAAS,eAAe,KAAmD;AAChF,SAAOA,QAAO,GAAG;AACnB;;;ACLO,SAAS,0BAA0B,OAA6B;AACrE,QAAM,QAAkB,CAAC;AACzB,aAAW,WAAW,MAAM,cAAc;AACxC,QAAI,CAAC,MAAM,YAAY,SAAS,OAAO,GAAG;AACxC,YAAM,KAAK,kCAAkC,OAAO,EAAE;AAAA,IACxD;AAAA,EACF;AACA,aAAW,YAAY,MAAM,eAAe;AAC1C,QAAI,CAAC,MAAM,iBAAiB,SAAS,cAAc,GAAG;AACpD,YAAM,KAAK,4CAA4C,QAAQ,EAAE;AAAA,IACnE;AAAA,EACF;AACA,SAAO;AACT;;;ACdO,SAAS,gBAAgB,SAA8B;AAC5D,SAAO,QAAQ,IAAI,CAAC,YAAY;AAAA,IAC9B,GAAG;AAAA,IACH,IAAI,OAAO,YAAY,OAAO;AAAA,EAChC,EAAE;AACJ;","names":["redact"]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@hyprcart/app-testing",
+  "version": "1.0.0",
+  "description": "Testing fixtures, preview helpers, and clean-room checks for Hyprcart apps.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@hyprcart/app-manifest": "1.0.0",
+    "@hyprcart/app-sdk": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.18",
+    "@repo/typescript-config": "0.0.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "tsc --noEmit",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist .turbo"
+  }
+}