@ripplo/testing 0.5.2 → 0.5.4

package/README.md

@@ -256,12 +256,14 @@ Each batched setup item exposes `ctx`:
 
 - `ctx.runId` — 12-char run id.
 - `ctx.fixed(value)` — static test value, type-branded so the engine can tell it apart from a raw literal.
-- `ctx.uniqueId(prefix)` returns `ripplo-test-<prefix>-<runId>`.
-- `ctx.uniqueEmail()` returns `ripplo-test-<runId>@test.ripplo.ai`.
+- `ctx.uniqueId(prefix)` returns `ripplo-test-<prefix>-<runId>-<n>`, where `n` is a per-call counter scoped to the run. Calling it repeatedly yields distinct values.
+- `ctx.uniqueEmail()` returns `ripplo-test-<runId>-<n>@test.ripplo.ai`, same per-call counter.
 - `ctx.setCookie(name, value, options?)` applies to that run's browser context before the test starts.
 
 Helpers return plain primitives, but the return type is branded — a bare string literal in a `setup` return fails at compile time, which is what stops tests from accidentally seeding identical-looking data across runs.
 
+The shared prefix (`ripplo-test-`) is also exported as `TEST_ID_PREFIX` from `@ripplo/testing`, so teardown / cleanup logic that scopes `WHERE` clauses by `startsWith(TEST_ID_PREFIX)` doesn't have to hardcode the string.
+
 ### Observer context
 
 The observer impl returns one of three terminal states:

package/dist/actions.js

@@ -2,7 +2,7 @@ import {
   readVariable,
   toSpecLocator,
   toStringValueRef
-} from "./chunk-YJ4KB56W.js";
+} from "./chunk-2YLI7VD4.js";
 import "./chunk-DCJBLS2U.js";
 import {
   createStep
@@ -14,10 +14,16 @@ var Fixture = class {
   kind = "fixture";
   name;
   constructor(name) {
-    if (name.length === 0) {
+    const raw = name;
+    if (typeof raw !== "string") {
+      throw new TypeError(
+        `fixture(name) requires a string name \u2014 got ${raw == null ? String(raw) : typeof raw}`
+      );
+    }
+    if (raw.length === 0) {
       throw new Error("fixture(name) requires a non-empty name");
     }
-    this.name = name;
+    this.name = raw;
   }
 };
 function fixture(name) {
@@ -65,8 +71,32 @@ function hover(locator) {
 function press(key) {
   return createStep({ key, type: "press" });
 }
+function describeFilesArg(files) {
+  if (typeof files === "string") {
+    return `string "${files}"`;
+  }
+  return typeof files;
+}
+function normalizeUploadFiles(files) {
+  if (files instanceof Fixture) {
+    return [files];
+  }
+  if (!Array.isArray(files)) {
+    throw new TypeError(
+      `upload() expected a Fixture or an array of Fixtures \u2014 got ${describeFilesArg(files)}. Wrap the filename with fixture(): upload(loc, fixture("file.png"))`
+    );
+  }
+  return files.map((f, i) => {
+    if (!(f instanceof Fixture)) {
+      throw new TypeError(
+        `upload() files[${String(i)}] is not a Fixture \u2014 wrap it with fixture(): upload(loc, fixture("file.png"))`
+      );
+    }
+    return f;
+  });
+}
 function upload(locator, files, options) {
-  const list = files instanceof Fixture ? [files] : [...files];
+  const list = normalizeUploadFiles(files);
   return createStep({
     files: list.map((f) => f.name),
     locator: toSpecLocator(locator),

package/dist/assert.js

@@ -5,7 +5,7 @@ import {
 import {
   toSpecLocator,
   toStringValueRef
-} from "./chunk-YJ4KB56W.js";
+} from "./chunk-2YLI7VD4.js";
 import "./chunk-DCJBLS2U.js";
 import {
   createStep

package/dist/{builder-DiVz3t1D.d.ts → builder-SsgqYqSC.d.ts}

@@ -153,4 +153,4 @@ declare function test(id: string, options?: TestOptions): TestNeedsName;
  */
 declare function createRipplo<P extends PreconditionRegistry, O extends ObserverRegistry>(registries: RipploRegistries<P, O>): RipploInstance<P, O>;
 
-export { type CoverageRegistry as C, type ObserverImplFn as O, type PreconditionImpl as P, type ResolveDeps as R, type ObserverRegistry as a, type PreconditionRecord as b, type PreconditionRegistry as c, type RipploBuilder as d, type RipploInstance as e, type RipploRegistries as f, createRipplo as g, observer as o, precondition as p, test as t };
+export { type CoverageRegistry as C, type ObserverImplFn as O, type PreconditionImpl as P, type ResolveDeps as R, type ObserverRegistry as a, type PreconditionRecord as b, type PreconditionRegistry as c, type PreconditionSetupItem as d, type PreconditionTeardownItem as e, type RipploBuilder as f, type RipploInstance as g, type RipploRegistries as h, createRipplo as i, observer as o, precondition as p, test as t };

package/dist/{chunk-YJ4KB56W.js → chunk-2YLI7VD4.js}

@@ -38,6 +38,13 @@ function toStringValueRef(value) {
   if (typeof value === "string") {
     return { type: "static", value };
   }
+  if (!isVariable(value)) {
+    const raw = value;
+    const got = raw == null ? String(raw) : typeof raw;
+    throw new TypeError(
+      `Expected a string or variable() \u2014 got ${got}. Wrap dynamic values with variable("name") and pair them with extract().`
+    );
+  }
   return { name: readVariable(value), type: "variable" };
 }
 function extract(locator, target) {

package/dist/compiler.d.ts

@@ -1,5 +1,5 @@
 import { Observer, Precondition, WorkflowSpec } from '@ripplo/spec';
-import { d as RipploBuilder } from './builder-DiVz3t1D.js';
+import { f as RipploBuilder } from './builder-SsgqYqSC.js';
 import './types-BzZrl65Z.js';
 import './step-De52hTLd.js';
 

package/dist/control.js

@@ -4,7 +4,7 @@ import {
   readVariable,
   toStringValueRef,
   variable
-} from "./chunk-YJ4KB56W.js";
+} from "./chunk-2YLI7VD4.js";
 import "./chunk-DCJBLS2U.js";
 import "./chunk-MGATMMCZ.js";
 import "./chunk-4MGIQFAJ.js";

package/dist/elysia.d.ts

@@ -1,6 +1,6 @@
 import { Elysia } from 'elysia';
-import { R as RipploEngine } from './engine-DVbF4E5A.js';
-import './builder-DiVz3t1D.js';
+import { R as RipploEngine } from './engine-BOqzK_go.js';
+import './builder-SsgqYqSC.js';
 import './types-BzZrl65Z.js';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/dist/{engine-DVbF4E5A.d.ts → engine-BOqzK_go.d.ts}

@@ -1,6 +1,7 @@
-import { c as PreconditionRegistry, a as ObserverRegistry, O as ObserverImplFn, P as PreconditionImpl, e as RipploInstance } from './builder-DiVz3t1D.js';
+import { c as PreconditionRegistry, a as ObserverRegistry, O as ObserverImplFn, P as PreconditionImpl, g as RipploInstance } from './builder-SsgqYqSC.js';
 import { P as Primitive, g as ObserverOutcome, C as CookieEntry, f as ObserverDefinition, l as PreconditionDefinition, U as UnimplementedItems, O as ObserverHandle, h as Precondition } from './types-BzZrl65Z.js';
 
+declare const TEST_ID_PREFIX = "ripplo-test-";
 interface EngineRunResult {
     readonly cookies: ReadonlyArray<CookieEntry>;
     readonly data: Record<string, Record<string, Primitive>>;
@@ -57,4 +58,4 @@ interface EngineImpls<P extends PreconditionRegistry, O extends ObserverRegistry
 }
 declare function createEngine<P extends PreconditionRegistry, O extends ObserverRegistry>(ripplo: RipploInstance<P, O>, impls: EngineImpls<P, O>): RipploEngine;
 
-export { type EngineRunResult as E, type NotImplemented as N, type ObserverImplFnFor as O, type PreconditionImplFor as P, type RipploEngine as R, type TeardownRunResult as T, type EngineImpls as a, type ExecuteBatchItem as b, type ExecuteBatchOptions as c, type TeardownBatchItem as d, createEngine as e, notImplemented as n };
+export { type EngineRunResult as E, type NotImplemented as N, type ObserverImplFnFor as O, type PreconditionImplFor as P, type RipploEngine as R, type TeardownRunResult as T, type EngineImpls as a, type ExecuteBatchItem as b, type ExecuteBatchOptions as c, TEST_ID_PREFIX as d, type TeardownBatchItem as e, createEngine as f, notImplemented as n };

package/dist/express.d.ts

@@ -1,6 +1,6 @@
 import { Router } from 'express';
-import { R as RipploEngine } from './engine-DVbF4E5A.js';
-import './builder-DiVz3t1D.js';
+import { R as RipploEngine } from './engine-BOqzK_go.js';
+import './builder-SsgqYqSC.js';
 import './types-BzZrl65Z.js';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/dist/fastify.d.ts

@@ -1,6 +1,6 @@
 import { FastifyInstance } from 'fastify';
-import { R as RipploEngine } from './engine-DVbF4E5A.js';
-import './builder-DiVz3t1D.js';
+import { R as RipploEngine } from './engine-BOqzK_go.js';
+import './builder-SsgqYqSC.js';
 import './types-BzZrl65Z.js';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/dist/hono.d.ts

@@ -1,6 +1,6 @@
 import { Hono } from 'hono';
-import { R as RipploEngine } from './engine-DVbF4E5A.js';
-import './builder-DiVz3t1D.js';
+import { R as RipploEngine } from './engine-BOqzK_go.js';
+import './builder-SsgqYqSC.js';
 import './types-BzZrl65Z.js';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-export { C as CoverageRegistry, O as ObserverImplFn, a as ObserverRegistry, P as PreconditionImpl, b as PreconditionRecord, c as PreconditionRegistry, R as ResolveDeps, d as RipploBuilder, e as RipploInstance, f as RipploRegistries, g as createRipplo, o as observer, p as precondition, t as test } from './builder-DiVz3t1D.js';
+export { C as CoverageRegistry, O as ObserverImplFn, a as ObserverRegistry, P as PreconditionImpl, b as PreconditionRecord, c as PreconditionRegistry, d as PreconditionSetupItem, e as PreconditionTeardownItem, R as ResolveDeps, f as RipploBuilder, g as RipploInstance, h as RipploRegistries, i as createRipplo, o as observer, p as precondition, t as test } from './builder-SsgqYqSC.js';
 import { CompileResult } from './compiler.js';
 export { CompiledTest, compile } from './compiler.js';
-import { E as EngineRunResult, T as TeardownRunResult$1 } from './engine-DVbF4E5A.js';
-export { a as EngineImpls, b as ExecuteBatchItem, c as ExecuteBatchOptions, N as NotImplemented, O as ObserverImplFnFor, P as PreconditionImplFor, R as RipploEngine, d as TeardownBatchItem, e as createEngine, n as notImplemented } from './engine-DVbF4E5A.js';
+import { E as EngineRunResult, T as TeardownRunResult$1 } from './engine-BOqzK_go.js';
+export { a as EngineImpls, b as ExecuteBatchItem, c as ExecuteBatchOptions, N as NotImplemented, O as ObserverImplFnFor, P as PreconditionImplFor, R as RipploEngine, d as TEST_ID_PREFIX, e as TeardownBatchItem, f as createEngine, n as notImplemented } from './engine-BOqzK_go.js';
 import { C as CookieEntry } from './types-BzZrl65Z.js';
 export { c as CookieOptions, D as DEFAULT_IGNORE_PATHS, d as DEFAULT_WATCH_PATHS, e as ObserverContext, f as ObserverDefinition, O as ObserverHandle, a as ObserverInput, g as ObserverOutcome, h as Precondition, i as PreconditionDeps, P as Primitive, S as SetupContext, T as TeardownContext, j as TestDefinition, k as TestValue } from './types-BzZrl65Z.js';
 export { D as DslNodeInput } from './step-De52hTLd.js';

package/dist/index.js

@@ -849,6 +849,7 @@ var RULES = [
 ];
 
 // src/engine.ts
+var TEST_ID_PREFIX = "ripplo-test-";
 function notImplemented(reason) {
   return { reason: reason ?? "not implemented" };
 }
@@ -1232,6 +1233,11 @@ function createSetupContext({
   defaultDomain,
   runId
 }) {
+  let callCounter = 0;
+  const nextSuffix = () => {
+    callCounter += 1;
+    return `${runId}-${String(callCounter)}`;
+  };
   return {
     runId,
     fixed: (value) => brandTestValue(value),
@@ -1239,8 +1245,8 @@ function createSetupContext({
       const resolvedOptions = options != null && options.domain == null && defaultDomain != null ? { ...options, domain: defaultDomain } : options ?? void 0;
       cookies.push({ name, options: resolvedOptions, value });
     },
-    uniqueEmail: () => brandTestValue(`ripplo-test-${runId}@test.ripplo.ai`),
-    uniqueId: (prefix) => brandTestValue(`ripplo-test-${prefix}-${runId}`)
+    uniqueEmail: () => brandTestValue(`${TEST_ID_PREFIX}${nextSuffix()}@test.ripplo.ai`),
+    uniqueId: (prefix) => brandTestValue(`${TEST_ID_PREFIX}${prefix}-${nextSuffix()}`)
   };
 }
 function deriveDefaultDomain(baseUrl) {
@@ -1256,6 +1262,7 @@ function deriveDefaultDomain(baseUrl) {
 export {
   DEFAULT_IGNORE_PATHS,
   DEFAULT_WATCH_PATHS,
+  TEST_ID_PREFIX,
   compile,
   createEngine,
   createRipplo,

package/dist/koa.d.ts

@@ -1,6 +1,6 @@
 import { Middleware } from 'koa';
-import { R as RipploEngine } from './engine-DVbF4E5A.js';
-import './builder-DiVz3t1D.js';
+import { R as RipploEngine } from './engine-BOqzK_go.js';
+import './builder-SsgqYqSC.js';
 import './types-BzZrl65Z.js';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/dist/lockfile.d.ts

@@ -1,7 +1,7 @@
 import { Codec } from '@ripplo/spec';
 import { z } from 'zod';
 import { CompileResult } from './compiler.js';
-import './builder-DiVz3t1D.js';
+import './builder-SsgqYqSC.js';
 import './types-BzZrl65Z.js';
 import './step-De52hTLd.js';
 
@@ -714,8 +714,9 @@ declare function hashFixturesIntoCompileResult({ cwd, result, }: HashFixturesPar
 type LockfileComparison = "match" | "missing" | "stale";
 interface CompareLockfileParams {
     readonly compiled: CompileResult;
+    readonly cwd: string;
     readonly existing: Lockfile | null;
 }
-declare function compareCompileToLockfile({ compiled, existing, }: CompareLockfileParams): LockfileComparison;
+declare function compareCompileToLockfile({ compiled, cwd, existing, }: CompareLockfileParams): Promise<LockfileComparison>;
 
 export { type CompareLockfileParams, FIXTURES_RELATIVE_PATH, type FixtureEntry, LOCKFILE_RELATIVE_PATH, type Lockfile, type LockfileComparison, type ReadLockfileParams, type WriteLockfileParams, compareCompileToLockfile, compileResultToLockfile, hashFixturesIntoCompileResult, lockfileCodec, readLockfile, serializeLockfile, writeLockfile };

package/dist/lockfile.js

@@ -642,14 +642,16 @@ function collectFixtureReferences(result) {
   });
   return names;
 }
-function compareCompileToLockfile({
+async function compareCompileToLockfile({
   compiled,
+  cwd,
   existing
 }) {
   if (existing == null) {
     return "missing";
   }
-  const fresh = serializeLockfile(compileResultToLockfile(compiled));
+  const hydrated = await hashFixturesIntoCompileResult({ cwd, result: compiled });
+  const fresh = serializeLockfile(compileResultToLockfile(hydrated));
   const current = serializeLockfile(existing);
   return fresh === current ? "match" : "stale";
 }

package/dist/nestjs.d.ts

@@ -1,6 +1,6 @@
 import { DynamicModule } from '@nestjs/common';
-import { R as RipploEngine } from './engine-DVbF4E5A.js';
-import './builder-DiVz3t1D.js';
+import { R as RipploEngine } from './engine-BOqzK_go.js';
+import './builder-SsgqYqSC.js';
 import './types-BzZrl65Z.js';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/dist/nextjs.d.ts

@@ -1,5 +1,5 @@
-import { R as RipploEngine } from './engine-DVbF4E5A.js';
-import './builder-DiVz3t1D.js';
+import { R as RipploEngine } from './engine-BOqzK_go.js';
+import './builder-SsgqYqSC.js';
 import './types-BzZrl65Z.js';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ripplo/testing",
   "description": "TypeScript DSL for defining and running Ripplo e2e workflow tests",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "type": "module",
   "files": [
     "dist"