SDK

import { prodbreak } from "@prod-break/sdk";

const sandbox = await prodbreak.connect({
  url: process.env.PRODBREAK_URL!,
  key: process.env.PRODBREAK_KEY!,
});

sandbox.faults.arm(resource, operation, {
  status: number, code: string, message?: string,
  count?: number,                                  // omit = until cleared
  match?: { input?: object, credential_id?: string },
});
sandbox.faults.clear(id?);                          // one by id, or all

sandbox.world.trigger(event, data?);   // fire an external cause; 409 if its precondition fails
sandbox.world.next();                  // the live "what can happen next" set

sandbox.clock.advance("5s");                       // due events fire in order, before this resolves
sandbox.clock.setDurations({ run_settle: "0s" });  // collapse named durations for deterministic CI

const inbox = await sandbox.webhooks.sink();        // local HTTP receiver: { url, secret, waitFor, all }
sandbox.webhooks.register(url, { subscribe: [...] }); // → { id, secret }
sandbox.webhooks.unregister(id);

sandbox.exogenous.pin(match, field_path, value);   // result-keyed override
sandbox.exogenous.on(event, field_path, value);    // event-name sugar → same pin
sandbox.exogenous.clear(id);