@ripplo/testing 0.2.0 → 0.3.0

package/README.md

@@ -272,10 +272,9 @@ import { tests } from "./tests/index.js";
 
 const ripplo = createRipplo(
   {
-    appUrl: process.env.APP_URL ?? "https://localhost:3001",
-    engineUrl: `${process.env.APP_URL ?? "https://localhost:3001"}/ripplo`,
+    appUrl: "https://localhost:3001",
+    engineUrl: "https://localhost:3001/ripplo",
     projectId: "<your-project-id>",
-    webhookSecret: process.env.RIPPLO_WEBHOOK_SECRET ?? "",
   },
   { preconditions, observers, tests },
 );
@@ -283,6 +282,8 @@ const ripplo = createRipplo(
 export default ripplo;
 ```
 
+`webhookSecret` is read from `RIPPLO_WEBHOOK_SECRET` in `.ripplo/.env` (auto-loaded by the CLI before each compile). You can still pass it explicitly to `createRipplo` if you need to.
+
 ### App server — the implementations funnel
 
 ```typescript

package/dist/assert.d.ts

@@ -1,4 +1,4 @@
-import { O as ObserverHandle, a as ObserverInput, b as ObserverBudgetTier } from './types-yIhY8cwG.js';
+import { O as ObserverHandle, a as ObserverInput, b as ObserverBudgetTier } from './types-Degkxs1f.js';
 import { U as UnlabeledStep } from './step-De52hTLd.js';
 import { CheckLocator, AnyLocator } from './locators.js';
 import 'zod';

package/dist/assert.js

@@ -4,7 +4,7 @@ import {
 import {
   readObserverBudget,
   readObserverName
-} from "./chunk-P4ZI7G5M.js";
+} from "./chunk-76BU4M6E.js";
 import {
   createStep
 } from "./chunk-MGATMMCZ.js";

package/dist/{builder-dqXTFZ4j.d.ts → builder-CiAO8dEG.d.ts}

@@ -1,4 +1,4 @@
-import { O as ObserverHandle, P as Precondition, l as PreconditionData, j as TestDefinition, e as DslConfig, g as ObserverDefinition, k as PreconditionDefinition, U as UnimplementedItems, f as ObserverContext, h as ObserverOutcome, S as SetupContext, m as TestValue, T as TeardownContext } from './types-yIhY8cwG.js';
+import { O as ObserverHandle, P as Precondition, l as PreconditionData, j as TestDefinition, e as DslConfig, g as ObserverDefinition, k as PreconditionDefinition, U as UnimplementedItems, f as ObserverContext, h as ObserverOutcome, S as SetupContext, m as TestValue, T as TeardownContext, n as UserDslConfig } from './types-Degkxs1f.js';
 import { ObserverBudget } from '@ripplo/spec';
 import { S as Step } from './step-De52hTLd.js';
 
@@ -75,6 +75,6 @@ type RipploBuilder = RipploInstance;
 declare function precondition(name: string): PreconditionNeedsSetup;
 declare function observer(name: string): ObserverNeedsInput;
 declare function test(id: string, options?: TestOptions): TestNeedsName;
-declare function createRipplo<P extends PreconditionRegistry, O extends ObserverRegistry>(rawConfig: DslConfig, registries: RipploRegistries<P, O>): RipploInstance<P, O>;
+declare function createRipplo<P extends PreconditionRegistry, O extends ObserverRegistry>(rawConfig: UserDslConfig, registries: RipploRegistries<P, O>): RipploInstance<P, O>;
 
 export { 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 };

package/dist/{chunk-P4ZI7G5M.js → chunk-76BU4M6E.js}

@@ -28,6 +28,9 @@ var dslConfigSchema = z.object({
   watchPaths: z.array(z.string()).optional(),
   webhookSecret: z.string()
 });
+var userDslConfigSchema = dslConfigSchema.extend({
+  webhookSecret: z.string().optional()
+});
 function readTestValue(value) {
   return value.value;
 }
@@ -66,7 +69,7 @@ function makeObserverHandle({
 export {
   DEFAULT_WATCH_PATHS,
   DEFAULT_IGNORE_PATHS,
-  dslConfigSchema,
+  userDslConfigSchema,
   readTestValue,
   createTestValue,
   readPreconditionName,

package/dist/compiler.d.ts

@@ -1,6 +1,6 @@
 import { Observer, Precondition, WorkflowSpec } from '@ripplo/spec';
-import { d as RipploBuilder } from './builder-dqXTFZ4j.js';
-import { e as DslConfig } from './types-yIhY8cwG.js';
+import { d as RipploBuilder } from './builder-CiAO8dEG.js';
+import { e as DslConfig } from './types-Degkxs1f.js';
 import './step-De52hTLd.js';
 import 'zod';
 

package/dist/{engine-CphCJ1ZS.d.ts → engine-L0JWPRkj.d.ts}

@@ -1,5 +1,5 @@
-import { c as PreconditionRegistry, a as ObserverRegistry, O as ObserverImplFn, P as PreconditionImpl, e as RipploInstance } from './builder-dqXTFZ4j.js';
-import { h as ObserverOutcome, C as CookieEntry, e as DslConfig, g as ObserverDefinition, k as PreconditionDefinition, U as UnimplementedItems, O as ObserverHandle, P as Precondition } from './types-yIhY8cwG.js';
+import { c as PreconditionRegistry, a as ObserverRegistry, O as ObserverImplFn, P as PreconditionImpl, e as RipploInstance } from './builder-CiAO8dEG.js';
+import { h as ObserverOutcome, C as CookieEntry, e as DslConfig, g as ObserverDefinition, k as PreconditionDefinition, U as UnimplementedItems, O as ObserverHandle, P as Precondition } from './types-Degkxs1f.js';
 
 interface EngineResult {
     readonly cookies: ReadonlyArray<CookieEntry>;

package/dist/express.d.ts

@@ -1,7 +1,7 @@
 import { Router } from 'express';
-import { P as PreconditionEngine } from './engine-CphCJ1ZS.js';
-import './builder-dqXTFZ4j.js';
-import './types-yIhY8cwG.js';
+import { P as PreconditionEngine } from './engine-L0JWPRkj.js';
+import './builder-CiAO8dEG.js';
+import './types-Degkxs1f.js';
 import 'zod';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/dist/fastify.d.ts

@@ -1,7 +1,7 @@
 import { FastifyInstance } from 'fastify';
-import { P as PreconditionEngine } from './engine-CphCJ1ZS.js';
-import './builder-dqXTFZ4j.js';
-import './types-yIhY8cwG.js';
+import { P as PreconditionEngine } from './engine-L0JWPRkj.js';
+import './builder-CiAO8dEG.js';
+import './types-Degkxs1f.js';
 import 'zod';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export { 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-dqXTFZ4j.js';
+export { 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-CiAO8dEG.js';
 import { CompileResult } from './compiler.js';
 export { CompiledTest, compile } from './compiler.js';
-export { E as EngineImpls, a as EngineResult, b as ExecuteBatchOptions, N as NotImplemented, O as ObserverImplFnFor, P as PreconditionEngine, c as PreconditionImplFor, d as createEngine, n as notImplemented } from './engine-CphCJ1ZS.js';
-import { C as CookieEntry } from './types-yIhY8cwG.js';
-export { c as CookieOptions, D as DEFAULT_IGNORE_PATHS, d as DEFAULT_WATCH_PATHS, e as DslConfig, f as ObserverContext, g as ObserverDefinition, O as ObserverHandle, a as ObserverInput, h as ObserverOutcome, P as Precondition, i as PreconditionDeps, S as SetupContext, T as TeardownContext, j as TestDefinition } from './types-yIhY8cwG.js';
+export { E as EngineImpls, a as EngineResult, b as ExecuteBatchOptions, N as NotImplemented, O as ObserverImplFnFor, P as PreconditionEngine, c as PreconditionImplFor, d as createEngine, n as notImplemented } from './engine-L0JWPRkj.js';
+import { C as CookieEntry } from './types-Degkxs1f.js';
+export { c as CookieOptions, D as DEFAULT_IGNORE_PATHS, d as DEFAULT_WATCH_PATHS, e as DslConfig, f as ObserverContext, g as ObserverDefinition, O as ObserverHandle, a as ObserverInput, h as ObserverOutcome, P as Precondition, i as PreconditionDeps, S as SetupContext, T as TeardownContext, j as TestDefinition } from './types-Degkxs1f.js';
 export { D as DslNodeInput } from './step-De52hTLd.js';
 import '@ripplo/spec';
 import 'zod';

package/dist/index.js

@@ -2,7 +2,6 @@ import {
   DEFAULT_IGNORE_PATHS,
   DEFAULT_WATCH_PATHS,
   createTestValue,
-  dslConfigSchema,
   makeObserverHandle,
   readObserverBudget,
   readObserverDescription,
@@ -11,8 +10,9 @@ import {
   readPreconditionDependsOn,
   readPreconditionDescription,
   readPreconditionName,
-  readTestValue
-} from "./chunk-P4ZI7G5M.js";
+  readTestValue,
+  userDslConfigSchema
+} from "./chunk-76BU4M6E.js";
 import {
   compile
 } from "./chunk-KNF4K4JH.js";
@@ -66,7 +66,14 @@ function test(id, options) {
   return buildTestName(id, options?.uiOnly);
 }
 function createRipplo(rawConfig, registries) {
-  const config = dslConfigSchema.parse(rawConfig);
+  const parsed = userDslConfigSchema.parse(rawConfig);
+  const webhookSecret = parsed.webhookSecret ?? process.env["RIPPLO_WEBHOOK_SECRET"] ?? "";
+  if (webhookSecret.length === 0) {
+    throw new Error(
+      "RIPPLO_WEBHOOK_SECRET is required. Set it in .ripplo/.env or pass webhookSecret to createRipplo()."
+    );
+  }
+  const config = { ...parsed, webhookSecret };
   const { observers, preconditions, tests } = registries;
   validateUniqueNames(preconditions, observers, tests);
   const preconditionDefs = Object.values(preconditions).map((p) => stubPreconditionDef(p));

package/dist/lockfile.d.ts

@@ -1,8 +1,8 @@
 import { Codec } from '@ripplo/spec';
 import { z } from 'zod';
 import { CompileResult } from './compiler.js';
-import './builder-dqXTFZ4j.js';
-import './types-yIhY8cwG.js';
+import './builder-CiAO8dEG.js';
+import './types-Degkxs1f.js';
 import './step-De52hTLd.js';
 
 declare const LOCKFILE_RELATIVE_PATH = ".ripplo/ripplo.lock";

package/dist/nextjs.d.ts

@@ -1,6 +1,6 @@
-import { P as PreconditionEngine } from './engine-CphCJ1ZS.js';
-import './builder-dqXTFZ4j.js';
-import './types-yIhY8cwG.js';
+import { P as PreconditionEngine } from './engine-L0JWPRkj.js';
+import './builder-CiAO8dEG.js';
+import './types-Degkxs1f.js';
 import 'zod';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/dist/{types-yIhY8cwG.d.ts → types-Degkxs1f.d.ts}

@@ -12,6 +12,15 @@ declare const dslConfigSchema: z.ZodObject<{
     webhookSecret: z.ZodString;
 }, z.core.$strip>;
 type DslConfig = z.infer<typeof dslConfigSchema>;
+declare const userDslConfigSchema: z.ZodObject<{
+    appUrl: z.ZodString;
+    engineUrl: z.ZodString;
+    ignorePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    projectId: z.ZodString;
+    watchPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    webhookSecret: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type UserDslConfig = z.infer<typeof userDslConfigSchema>;
 interface CookieOptions {
     readonly domain: string | undefined;
     readonly expires: number | undefined;
@@ -112,4 +121,4 @@ interface ObserverDefinition {
     readonly run: (ctx: ObserverContext, params: Record<string, string>) => Promise<ObserverOutcome>;
 }
 
-export { type CookieEntry as C, DEFAULT_IGNORE_PATHS as D, type ObserverHandle as O, type Precondition as P, type SetupContext as S, type TeardownContext as T, type UnimplementedItems as U, type ObserverInput as a, type ObserverBudgetTier as b, type CookieOptions as c, DEFAULT_WATCH_PATHS as d, type DslConfig as e, type ObserverContext as f, type ObserverDefinition as g, type ObserverOutcome as h, type PreconditionDeps as i, type TestDefinition as j, type PreconditionDefinition as k, type PreconditionData as l, type TestValue as m };
+export { type CookieEntry as C, DEFAULT_IGNORE_PATHS as D, type ObserverHandle as O, type Precondition as P, type SetupContext as S, type TeardownContext as T, type UnimplementedItems as U, type ObserverInput as a, type ObserverBudgetTier as b, type CookieOptions as c, DEFAULT_WATCH_PATHS as d, type DslConfig as e, type ObserverContext as f, type ObserverDefinition as g, type ObserverOutcome as h, type PreconditionDeps as i, type TestDefinition as j, type PreconditionDefinition as k, type PreconditionData as l, type TestValue as m, type UserDslConfig as n };

package/package.json

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