@revenexx/integrations-node-devkit 0.8.2 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -219,6 +219,10 @@ expect(persistDurableCreds).toHaveBeenCalledWith({ refreshToken: 'RT' });
219
219
  stub.restore();
220
220
  ```
221
221
 
222
+ While a `stubFetch` is active, the DNS lookup `safeFetch` makes before every request is
223
+ answered too, so a stubbed suite runs offline; `stubFetch(handler, { dns: false })` leaves
224
+ DNS real. See `docs/testing.md`.
225
+
222
226
  `vitest` is an optional peer dependency (the harness uses `vi` spies); from Vitest 5 on,
223
227
  install its `vite` peer alongside.
224
228
 
@@ -23,19 +23,48 @@ export interface StubbedRequest {
23
23
  export type FetchHandler = (request: StubbedRequest) => StubResponseInit | Response | Promise<StubResponseInit | Response>;
24
24
  /** Builds a real `Response` from a {@link StubResponseInit}. */
25
25
  export declare function buildResponse(init: StubResponseInit): Response;
26
+ export interface StubFetchOptions {
27
+ /**
28
+ * Answer DNS too, while the stub is active (default `true`). The SDK's
29
+ * `safeFetch` resolves a request's host through `node:dns/promises` before it
30
+ * calls `fetch`, to refuse private addresses — so without this, a test whose
31
+ * `fetch` is stubbed still asks real DNS, and fails offline or on a slow
32
+ * resolver. With it, every host but `localhost` and an IP literal resolves to
33
+ * {@link STUB_DNS_ADDRESS}, a public address, so the guard lets the request
34
+ * through to the stub.
35
+ *
36
+ * Pass `false` for a test that checks real resolution: this stub then takes
37
+ * no hold on DNS (another active stub without it still keeps DNS stubbed until
38
+ * it is restored). A `lookup` the test
39
+ * already replaced on `node:dns/promises` with a vitest mock is left in place
40
+ * either way, so a test that makes a host resolve to a private address keeps
41
+ * its answer.
42
+ */
43
+ dns?: boolean;
44
+ }
26
45
  export interface StubFetchResult {
27
46
  /** The `vi.fn<AnyFn>()` installed as `globalThis.fetch` — assert calls on it. */
28
47
  fetchMock: AnyMock;
29
- /** Restores the previous `globalThis.fetch`. */
48
+ /** Restores the previous `globalThis.fetch`, and the previous DNS `lookup` where it was replaced. */
30
49
  restore(): void;
31
50
  }
51
+ /**
52
+ * The address every host but `localhost` and an IP literal resolves to while
53
+ * {@link stubFetch} answers DNS. Public, so the SDK's SSRF guard lets it through.
54
+ * A lookup that asks for IPv6 only (`family: 6`) gets {@link STUB_DNS_ADDRESS_V6}.
55
+ */
56
+ export declare const STUB_DNS_ADDRESS = "93.184.215.14";
57
+ /** The IPv6 counterpart of {@link STUB_DNS_ADDRESS}, also public. */
58
+ export declare const STUB_DNS_ADDRESS_V6 = "2606:2800:21f:cb07:6820:80da:af6b:8b2c";
32
59
  /**
33
60
  * Replaces `globalThis.fetch` with a `vi.fn<AnyFn>()` driven by `handler`. Pass a
34
61
  * static {@link StubResponseInit} to answer every request identically, or a
35
- * {@link FetchHandler} to branch on url/method. Call `restore()` when done
62
+ * {@link FetchHandler} to branch on url/method. Unless `options.dns` is `false`,
63
+ * it answers DNS as well (see {@link StubFetchOptions.dns}), so a request through
64
+ * the SDK's `safeFetch` never reaches the network. Call `restore()` when done
36
65
  * (e.g. in `afterEach`).
37
66
  */
38
- export declare function stubFetch(handler: FetchHandler | StubResponseInit): StubFetchResult;
67
+ export declare function stubFetch(handler: FetchHandler | StubResponseInit, options?: StubFetchOptions): StubFetchResult;
39
68
  export interface FakeTokenEndpointOptions {
40
69
  /** Only answer requests to this exact URL; other requests 404. Omit to answer any URL. */
41
70
  tokenUrl?: string;
@@ -1,7 +1,9 @@
1
1
  "use strict";
2
+ var __create = Object.create;
2
3
  var __defProp = Object.defineProperty;
3
4
  var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
5
  var __getOwnPropNames = Object.getOwnPropertyNames;
6
+ var __getProtoOf = Object.getPrototypeOf;
5
7
  var __hasOwnProp = Object.prototype.hasOwnProperty;
6
8
  var __export = (target, all) => {
7
9
  for (var name in all)
@@ -15,11 +17,21 @@ var __copyProps = (to, from, except, desc) => {
15
17
  }
16
18
  return to;
17
19
  };
20
+ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
21
+ // If the importer is in node compatibility mode or this is not an ESM
22
+ // file that has been converted to a CommonJS file using a Babel-
23
+ // compatible transform (i.e. "__esModule" has not been set), then set
24
+ // "default" to the CommonJS "module.exports" for node compatibility.
25
+ isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
26
+ mod
27
+ ));
18
28
  var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
29
 
20
30
  // src/testing/index.ts
21
31
  var testing_exports = {};
22
32
  __export(testing_exports, {
33
+ STUB_DNS_ADDRESS: () => STUB_DNS_ADDRESS,
34
+ STUB_DNS_ADDRESS_V6: () => STUB_DNS_ADDRESS_V6,
23
35
  buildResponse: () => buildResponse,
24
36
  createAuthorContext: () => createAuthorContext,
25
37
  createCredentialContext: () => createCredentialContext,
@@ -234,6 +246,9 @@ function createAuthorContext(config = {}, options = {}) {
234
246
  }
235
247
 
236
248
  // src/testing/fetch.ts
249
+ var import_node_dns = __toESM(require("dns"), 1);
250
+ var import_node_module = require("module");
251
+ var import_node_net = require("net");
237
252
  var import_vitest3 = require("vitest");
238
253
  function buildResponse(init) {
239
254
  const headers = new Headers(init.headers ?? {});
@@ -248,8 +263,52 @@ function buildResponse(init) {
248
263
  }
249
264
  return new Response(body, { status: init.status ?? 200, headers });
250
265
  }
251
- function stubFetch(handler) {
266
+ var STUB_DNS_ADDRESS = "93.184.215.14";
267
+ var STUB_DNS_ADDRESS_V6 = "2606:2800:21f:cb07:6820:80da:af6b:8b2c";
268
+ var sharedDnsStub;
269
+ function stubbedAnswer(options) {
270
+ const family = typeof options === "number" ? options : typeof options === "object" && options !== null ? options.family : void 0;
271
+ return family === 6 || family === "IPv6" ? { address: STUB_DNS_ADDRESS_V6, family: 6 } : { address: STUB_DNS_ADDRESS, family: 4 };
272
+ }
273
+ function setLookup(lookup) {
274
+ import_node_dns.default.promises.lookup = lookup;
275
+ (0, import_node_module.syncBuiltinESMExports)();
276
+ }
277
+ function stubDnsLookup() {
278
+ const current = import_node_dns.default.promises.lookup;
279
+ if (sharedDnsStub !== void 0 && current === sharedDnsStub.stubbed) {
280
+ sharedDnsStub.holders += 1;
281
+ } else if (import_vitest3.vi.isMockFunction(current)) {
282
+ return () => {
283
+ };
284
+ } else {
285
+ const original = current;
286
+ const stubbed = ((hostname, options) => {
287
+ if (hostname === "localhost" || (0, import_node_net.isIP)(hostname) !== 0) {
288
+ return original(hostname, options);
289
+ }
290
+ const address = stubbedAnswer(options);
291
+ const all = typeof options === "object" && options !== null && options.all === true;
292
+ return Promise.resolve(all ? [address] : address);
293
+ });
294
+ sharedDnsStub = { original, stubbed, holders: 1 };
295
+ setLookup(stubbed);
296
+ }
297
+ const held = sharedDnsStub;
298
+ let released = false;
299
+ return () => {
300
+ if (released || held === void 0) return;
301
+ released = true;
302
+ held.holders -= 1;
303
+ if (held.holders > 0) return;
304
+ if (sharedDnsStub === held) sharedDnsStub = void 0;
305
+ if (import_node_dns.default.promises.lookup === held.stubbed) setLookup(held.original);
306
+ };
307
+ }
308
+ function stubFetch(handler, options = {}) {
252
309
  const previous = globalThis.fetch;
310
+ const restoreDns = options.dns === false ? () => {
311
+ } : stubDnsLookup();
253
312
  const resolveInit = typeof handler === "function" ? handler : () => handler;
254
313
  const fetchMock = import_vitest3.vi.fn(async (input, init) => {
255
314
  const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
@@ -262,6 +321,7 @@ function stubFetch(handler) {
262
321
  fetchMock,
263
322
  restore() {
264
323
  globalThis.fetch = previous;
324
+ restoreDns();
265
325
  }
266
326
  };
267
327
  }
@@ -331,6 +391,8 @@ async function runOAuthExchangeCode(credential, options) {
331
391
  }
332
392
  // Annotate the CommonJS export names for ESM import in node:
333
393
  0 && (module.exports = {
394
+ STUB_DNS_ADDRESS,
395
+ STUB_DNS_ADDRESS_V6,
334
396
  buildResponse,
335
397
  createAuthorContext,
336
398
  createCredentialContext,
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/testing/index.ts","../../src/testing/context.ts","../../src/state-rules.ts","../../src/testing/author.ts","../../src/testing/fetch.ts","../../src/testing/credentials.ts"],"sourcesContent":["export * from './context.js';\nexport * from './author.js';\nexport * from './fetch.js';\nexport * from './credentials.js';\nexport type * from './mock.js';\n","import type { INodeContext } from '@revenexx/integrations-node-sdk';\nimport { vi } from 'vitest';\nimport type { AnyFn, AnyMock } from './mock.js';\nimport { assertNotRepointed, assertTtlInRange } from '../state-rules.js';\n\n/**\n * Drop-in replacement for the `createMockContext` helper that was, until this\n * package existed, copy-pasted byte-for-byte into every node repo's\n * `tests/helpers/context.ts`. Builds a full {@link INodeContext} with\n * `vi.fn<AnyFn>()`-backed `logger`, `secrets.get`, `credentials.get` and `state` so a\n * node's `execute` can be unit-tested in isolation.\n *\n * The state mock is **stateful on purpose**: what the node writes, it reads\n * back. A node's interesting behaviour is precisely the second run — the one\n * that finds the mapping it created the first time — and a mock that forgets\n * would only ever exercise the create branch. It is the one place an author can\n * test writes at all: in the real product, author-time execution is read-only.\n *\n * It reads back *when the store would let it*, which is not the same for all\n * four roles (SDK 1.0.0, `specs/workflow-state.md`): a mapping and a claim take\n * effect immediately, a cursor and a digest are staged and adopted only once the\n * run completes. So `cursor.get` after `cursor.set` still answers what the last\n * completed run left — call {@link MockContext.completeRun} between two\n * `execute` calls to play the second run, and leave it uncalled to play the run\n * that failed and left the watermark where it was.\n */\n\nexport type MockLogger = {\n info: AnyMock;\n warn: AnyMock;\n error: AnyMock;\n};\n\nexport type MockSecrets = {\n get: AnyMock;\n};\n\nexport type MockCredentials = {\n get: AnyMock;\n};\n\n/** Every state operation is a `vi.fn<AnyFn>()`, so calls can be asserted on. */\nexport type MockState = {\n mapping: { get: AnyMock; put: AnyMock };\n cursor: { get: AnyMock; set: AnyMock };\n claim: AnyMock;\n digest: { unchanged: AnyMock; set: AnyMock };\n};\n\n/**\n * What the store already knows when the node starts — the \"this ran before\"\n * half of any sync test.\n */\nexport interface MockStateSeed {\n /** namespace -> { leftKey: rightKey }; readable from either side. */\n mappings?: Record<string, Record<string, string>>;\n /** namespace -> partitionKey ('' for the unpartitioned one) -> watermark. */\n cursors?: Record<string, Record<string, unknown>>;\n /** namespace -> keys already claimed, so `claim` returns false for them. */\n claims?: Record<string, string[]>;\n /** namespace -> { entityKey: digest }. */\n digests?: Record<string, Record<string, string>>;\n}\n\nexport type MockContext = INodeContext & {\n logger: MockLogger;\n secrets: MockSecrets;\n credentials: MockCredentials;\n state: MockState;\n /**\n * Adopts what this run staged — the cursors and digests it set — the way the\n * engine does when a run completes. Not part of {@link INodeContext}: it is\n * the harness standing in for the run's own ending, and a node can never call\n * it. A test that never calls it has played a run that did not complete.\n */\n completeRun: () => void;\n};\n\nexport interface CreateMockContextOptions {\n signal?: AbortSignal;\n /** Secret key -> value returned by `secrets.get`. Unknown keys fall back to a deterministic stub. */\n secrets?: Record<string, string>;\n /** When set, `secrets.get` rejects with this error instead of resolving. */\n secretsError?: Error;\n /** Credential instance id -> resolved access data returned by `credentials.get`. */\n credentials?: Record<string, Record<string, unknown>>;\n /** When set, `credentials.get` rejects with this error instead of resolving. */\n credentialsError?: Error;\n /** What the state store already holds when the node starts. */\n state?: MockStateSeed;\n /**\n * When set, every state call rejects with this error — the shape of the\n * engine refusing a namespace the workflow never declared.\n */\n stateError?: Error;\n}\n\nexport function createMockContext(options: CreateMockContextOptions = {}): MockContext {\n const signal = options.signal ?? new AbortController().signal;\n const { state, completeRun } = createMockState(options.state, options.stateError);\n\n const secretsGet = options.secretsError\n ? vi.fn<AnyFn>(async () => {\n throw options.secretsError;\n })\n : vi.fn<AnyFn>(async (key: string) => {\n if (options.secrets && key in options.secrets) {\n return options.secrets[key];\n }\n return `secret-value-for-${key}`;\n });\n\n const credentialsGet = options.credentialsError\n ? vi.fn<AnyFn>(async () => {\n throw options.credentialsError;\n })\n : vi.fn<AnyFn>(async (id: string) => {\n if (options.credentials && id in options.credentials) {\n return options.credentials[id];\n }\n return {};\n });\n\n return {\n signal,\n logger: {\n info: vi.fn<AnyFn>(),\n warn: vi.fn<AnyFn>(),\n error: vi.fn<AnyFn>(),\n },\n secrets: {\n get: secretsGet,\n },\n credentials: {\n get: credentialsGet,\n },\n state,\n completeRun,\n };\n}\n\n/**\n * A tiny in-memory stand-in for the four state roles. Seeds are copied rather\n * than referenced, so a test that writes cannot leak into the next one.\n *\n * The write calls split the way the store does. A mapping and a claim land in\n * the committed maps at once; a cursor and a digest land in a staging map that\n * only `completeRun` folds in, so a read during the run answers what the last\n * completed one left. That is the whole reason there are four operations rather\n * than a generic get/set, and a mock that adopted everything immediately would\n * hide the case the rule exists for: the run that fails after advancing its\n * watermark.\n */\nfunction createMockState(seed: MockStateSeed = {}, error?: Error): { state: MockState; completeRun: () => void } {\n const mappings = new Map<string, Map<string, string>>();\n const cursors = new Map<string, Map<string, unknown>>();\n const claims = new Map<string, Set<string>>();\n const digests = new Map<string, Map<string, string>>();\n /** What this run has staged: adopted by `completeRun`, dropped otherwise. */\n const stagedCursors = new Map<string, Map<string, unknown>>();\n const stagedDigests = new Map<string, Map<string, string>>();\n\n for (const [namespace, pairs] of Object.entries(seed.mappings ?? {})) {\n mappings.set(namespace, new Map(Object.entries(pairs)));\n }\n for (const [namespace, partitions] of Object.entries(seed.cursors ?? {})) {\n cursors.set(namespace, new Map(Object.entries(partitions)));\n }\n for (const [namespace, keys] of Object.entries(seed.claims ?? {})) {\n claims.set(namespace, new Set(keys));\n }\n for (const [namespace, entries] of Object.entries(seed.digests ?? {})) {\n digests.set(namespace, new Map(Object.entries(entries)));\n }\n\n /** Wraps an operation so `stateError` short-circuits every one of them. */\n const op = <A extends unknown[], R>(fn: (...args: A) => R) =>\n vi.fn(async (...args: A): Promise<R> => {\n if (error) {\n throw error;\n }\n return fn(...args);\n });\n\n const state: MockState = {\n mapping: {\n get: op((namespace: string, key: string, side: 'left' | 'right' = 'left') => {\n const pairs = mappings.get(namespace);\n if (!pairs) {\n return null;\n }\n if (side === 'left') {\n return pairs.get(key) ?? null;\n }\n for (const [left, right] of pairs) {\n if (right === key) {\n return left;\n }\n }\n return null;\n }),\n put: op((namespace: string, left: string, right: string) => {\n const pairs = mappings.get(namespace) ?? new Map<string, string>();\n assertNotRepointed(namespace, pairs, left, right);\n pairs.set(left, right);\n mappings.set(namespace, pairs);\n }),\n },\n cursor: {\n // The committed watermark: what *this* run staged is deliberately not in\n // the answer, exactly as the real store describes it.\n get: op((namespace: string, partitionKey = '') => cursors.get(namespace)?.get(partitionKey)),\n set: op((namespace: string, value: unknown, partitionKey = '') => {\n const partitions = stagedCursors.get(namespace) ?? new Map<string, unknown>();\n partitions.set(partitionKey, value);\n stagedCursors.set(namespace, partitions);\n }),\n },\n // First caller wins, like the real claim — so a test can drive both the\n // fresh and the duplicate path without reconfiguring the mock. A claim is\n // never handed on here: a TTL is a wall-clock window, and no unit test\n // outlives the shortest one the store accepts.\n claim: op((namespace: string, key: string, opts?: { ttlSeconds?: number }) => {\n assertTtlInRange(opts?.ttlSeconds);\n const held = claims.get(namespace) ?? new Set<string>();\n if (held.has(key)) {\n return false;\n }\n held.add(key);\n claims.set(namespace, held);\n return true;\n }),\n digest: {\n unchanged: op((namespace: string, entityKey: string, digest: string) => digests.get(namespace)?.get(entityKey) === digest),\n set: op((namespace: string, entityKey: string, digest: string) => {\n const entries = stagedDigests.get(namespace) ?? new Map<string, string>();\n entries.set(entityKey, digest);\n stagedDigests.set(namespace, entries);\n }),\n },\n };\n\n const completeRun = (): void => {\n for (const [namespace, partitions] of stagedCursors) {\n const committed = cursors.get(namespace) ?? new Map<string, unknown>();\n for (const [partitionKey, value] of partitions) {\n committed.set(partitionKey, value);\n }\n cursors.set(namespace, committed);\n }\n for (const [namespace, entries] of stagedDigests) {\n const committed = digests.get(namespace) ?? new Map<string, string>();\n for (const [entityKey, digest] of entries) {\n committed.set(entityKey, digest);\n }\n digests.set(namespace, committed);\n }\n stagedCursors.clear();\n stagedDigests.clear();\n };\n\n return { state, completeRun };\n}\n","import { NodeError } from '@revenexx/integrations-node-sdk';\n\n/**\n * The two rules the tenant state store keeps that neither the mock context nor\n * the local preview would otherwise have any reason to keep — and both of which\n * a node author only finds out about in production if we do not.\n *\n * They live here rather than in either caller because the testing harness and\n * the preview must refuse the same things: a node that passes its unit tests and\n * then trips the store on its first preview run has learnt nothing from either.\n * The rest of what the store promises — that a granted claim really excludes a\n * parallel run, that an undeclared namespace is refused — is the engine's, and\n * `specs/workflow-state.md` in the SDK records it as such.\n */\n\n/** Mirrors the engine's default claim lifetime (7 days). */\nexport const DEFAULT_CLAIM_TTL_SECONDS = 604_800;\n\n/** The window the store accepts: one second to one year. */\nexport const MIN_CLAIM_TTL_SECONDS = 1;\nexport const MAX_CLAIM_TTL_SECONDS = 31_536_000;\n\n/**\n * A `ttlSeconds` outside the accepted window is refused rather than clamped: the\n * figure is the duplicate-suppression window *and* the retry window, so a node\n * quietly given a different one than it asked for would suppress deliveries for\n * a stretch its author never chose.\n */\nexport function assertTtlInRange(ttlSeconds: number | undefined): void {\n if (ttlSeconds === undefined) {\n return;\n }\n if (!Number.isFinite(ttlSeconds) || ttlSeconds < MIN_CLAIM_TTL_SECONDS || ttlSeconds > MAX_CLAIM_TTL_SECONDS) {\n throw new NodeError('INVALID_TTL', `ttlSeconds must be between ${MIN_CLAIM_TTL_SECONDS} and ${MAX_CLAIM_TTL_SECONDS}, got ${String(ttlSeconds)}.`);\n }\n}\n\n/**\n * Re-pointing one side of an existing pair is refused, in both directions: an id\n * correlated two ways is always a bug, and no later sync can untangle it —\n * whichever of the two answers a lookup happens to give, half the records it\n * touches are the wrong ones. Writing the same pair again is not a re-point and\n * is allowed, so a node that puts unconditionally on every run stays green.\n */\nexport function assertNotRepointed(namespace: string, pairs: Iterable<[string, string]>, left: string, right: string): void {\n for (const [existingLeft, existingRight] of pairs) {\n if (existingLeft === left && existingRight !== right) {\n throw new NodeError('MAPPING_CONFLICT', `'${left}' is already correlated with '${existingRight}' in namespace '${namespace}'.`);\n }\n if (existingRight === right && existingLeft !== left) {\n throw new NodeError('MAPPING_CONFLICT', `'${right}' is already correlated with '${existingLeft}' in namespace '${namespace}'.`);\n }\n }\n}\n","import type { INodeAuthorContext } from '@revenexx/integrations-node-sdk';\nimport { vi } from 'vitest';\nimport type { AnyFn, AnyMock } from './mock.js';\n\n/**\n * Builds an {@link INodeAuthorContext} for unit-testing a node's *author-time*\n * resolvers (`loadOptions`, `resolveConfigSchema`, `resolveOutputs`). Until this\n * package existed, this factory was reinvented inline in each repo's resolver\n * tests. Mirrors {@link createMockContext}: `secrets.get` / `credentials.get`\n * are `vi.fn<AnyFn>()`-backed and seedable.\n */\n\nexport type MockAuthorLogger = {\n info: AnyMock;\n warn: AnyMock;\n error: AnyMock;\n};\n\nexport type MockAuthorContext = INodeAuthorContext & {\n logger: MockAuthorLogger;\n secrets: { get: AnyMock };\n credentials: { get: AnyMock };\n};\n\nexport interface CreateAuthorContextOptions {\n signal?: AbortSignal;\n /** Preferred locale for resolved labels. */\n locale?: string;\n secrets?: Record<string, string>;\n secretsError?: Error;\n credentials?: Record<string, Record<string, unknown>>;\n credentialsError?: Error;\n}\n\nexport function createAuthorContext(config: Record<string, unknown> = {}, options: CreateAuthorContextOptions = {}): MockAuthorContext {\n const signal = options.signal ?? new AbortController().signal;\n\n const secretsGet = options.secretsError\n ? vi.fn<AnyFn>(async () => {\n throw options.secretsError;\n })\n : vi.fn<AnyFn>(async (key: string) => {\n if (options.secrets && key in options.secrets) {\n return options.secrets[key];\n }\n return `secret-value-for-${key}`;\n });\n\n const credentialsGet = options.credentialsError\n ? vi.fn<AnyFn>(async () => {\n throw options.credentialsError;\n })\n : vi.fn<AnyFn>(async (id: string) => {\n if (options.credentials && id in options.credentials) {\n return options.credentials[id];\n }\n return {};\n });\n\n return {\n signal,\n logger: {\n info: vi.fn<AnyFn>(),\n warn: vi.fn<AnyFn>(),\n error: vi.fn<AnyFn>(),\n },\n config,\n secrets: { get: secretsGet },\n credentials: { get: credentialsGet },\n locale: options.locale,\n };\n}\n","import { vi } from 'vitest';\nimport type { AnyFn, AnyMock } from './mock.js';\n\n/**\n * Utilities for stubbing the global `fetch` so a credential's `resolve` /\n * `test` (which reach an OAuth token endpoint via the SDK's `postForm`) or a\n * node's `execute` (which uses `safeFetch` → global `fetch`) can be\n * unit-tested without touching the network. Builds real `Response` objects so\n * `res.ok` / `res.status` / `res.text()` / `res.json()` all behave exactly as\n * in production.\n */\n\nexport interface StubResponseInit {\n status?: number;\n headers?: Record<string, string>;\n /** JSON body — serialized and served as `application/json` unless `body` is set. */\n json?: unknown;\n /** Raw string body. Takes precedence over `json`. */\n body?: string;\n}\n\nexport interface StubbedRequest {\n url: string;\n method: string;\n init?: RequestInit;\n}\n\nexport type FetchHandler = (request: StubbedRequest) => StubResponseInit | Response | Promise<StubResponseInit | Response>;\n\n/** Builds a real `Response` from a {@link StubResponseInit}. */\nexport function buildResponse(init: StubResponseInit): Response {\n const headers = new Headers(init.headers ?? {});\n let body: string | undefined;\n if (init.body !== undefined) {\n body = init.body;\n } else if (init.json !== undefined) {\n body = JSON.stringify(init.json);\n if (!headers.has('content-type')) {\n headers.set('content-type', 'application/json');\n }\n }\n return new Response(body, { status: init.status ?? 200, headers });\n}\n\nexport interface StubFetchResult {\n /** The `vi.fn<AnyFn>()` installed as `globalThis.fetch` — assert calls on it. */\n fetchMock: AnyMock;\n /** Restores the previous `globalThis.fetch`. */\n restore(): void;\n}\n\n/**\n * Replaces `globalThis.fetch` with a `vi.fn<AnyFn>()` driven by `handler`. Pass a\n * static {@link StubResponseInit} to answer every request identically, or a\n * {@link FetchHandler} to branch on url/method. Call `restore()` when done\n * (e.g. in `afterEach`).\n */\nexport function stubFetch(handler: FetchHandler | StubResponseInit): StubFetchResult {\n const previous = globalThis.fetch;\n const resolveInit: FetchHandler = typeof handler === 'function' ? handler : () => handler;\n\n const fetchMock = vi.fn<AnyFn>(async (input: RequestInfo | URL, init?: RequestInit) => {\n const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;\n const method = (init?.method ?? (input instanceof Request ? input.method : 'GET')).toUpperCase();\n const out = await resolveInit({ url, method, init });\n return out instanceof Response ? out : buildResponse(out);\n });\n\n globalThis.fetch = fetchMock as unknown as typeof fetch;\n return {\n fetchMock,\n restore() {\n globalThis.fetch = previous;\n },\n };\n}\n\nexport interface FakeTokenEndpointOptions {\n /** Only answer requests to this exact URL; other requests 404. Omit to answer any URL. */\n tokenUrl?: string;\n accessToken?: string;\n tokenType?: string;\n /** Seconds until expiry (OAuth `expires_in`). Set `null` to omit the field. */\n expiresIn?: number | null;\n /** Included as `refresh_token` when set (e.g. to assert rotation). */\n refreshToken?: string;\n /** Extra fields merged into the token response body. */\n extra?: Record<string, unknown>;\n}\n\n/**\n * A {@link FetchHandler} that emulates an OAuth token endpoint, returning\n * `{ access_token, token_type, expires_in, refresh_token? }`. Compose with\n * {@link stubFetch} to unit-test `oauth2-*` credentials' `resolve` / OAuth\n * `exchangeCode`.\n */\nexport function fakeTokenEndpoint(options: FakeTokenEndpointOptions = {}): FetchHandler {\n const { tokenUrl, accessToken = 'fake-access-token', tokenType = 'Bearer', expiresIn = 3600, refreshToken, extra } = options;\n\n return ({ url }) => {\n if (tokenUrl && url !== tokenUrl) {\n return { status: 404, json: { error: `no stub for ${url}` } };\n }\n const json: Record<string, unknown> = {\n access_token: accessToken,\n token_type: tokenType,\n ...(expiresIn !== null ? { expires_in: expiresIn } : {}),\n ...(refreshToken !== undefined ? { refresh_token: refreshToken } : {}),\n ...extra,\n };\n return { status: 200, json };\n };\n}\n","import type { ICredential, ICredentialContext, ICredentialResolveResult, ICredentialTestResult } from '@revenexx/integrations-node-sdk';\nimport { isOAuthAuthorizeCredential } from '@revenexx/integrations-node-sdk';\nimport { vi } from 'vitest';\nimport type { AnyFn, AnyMock } from './mock.js';\n\n/**\n * Harness for unit-testing a credential type's `test` / `resolve` / 3-legged\n * OAuth without the credentials broker or a real provider. Combine with\n * {@link stubFetch} / {@link fakeTokenEndpoint} to drive the token endpoint,\n * and inspect the returned `persistDurableCreds` spy to assert refresh-token\n * rotation.\n */\n\nexport type MockCredentialLogger = {\n info: AnyMock;\n warn: AnyMock;\n error: AnyMock;\n};\n\nexport type MockCredentialContext = ICredentialContext & {\n logger: MockCredentialLogger;\n /** Spy wired to `ctx.persistDurableCreds`; assert `.toHaveBeenCalledWith(...)`. */\n persistDurableCreds: AnyMock;\n};\n\nexport interface CreateCredentialContextOptions {\n signal?: AbortSignal;\n}\n\nexport function createCredentialContext(options: CreateCredentialContextOptions = {}): MockCredentialContext {\n const signal = options.signal ?? new AbortController().signal;\n const persistDurableCreds = vi.fn<AnyFn>(async (_durableCreds: Record<string, unknown>) => {});\n return {\n signal,\n logger: {\n info: vi.fn<AnyFn>(),\n warn: vi.fn<AnyFn>(),\n error: vi.fn<AnyFn>(),\n },\n persistDurableCreds,\n };\n}\n\nexport interface RunCredentialTestOptions {\n config: Record<string, unknown>;\n signal?: AbortSignal;\n}\n\n/** Runs a credential's `test(ctx, config)` and returns its result. */\nexport async function runCredentialTest(credential: ICredential, options: RunCredentialTestOptions): Promise<ICredentialTestResult> {\n const ctx = createCredentialContext({ signal: options.signal });\n return credential.test(ctx, options.config);\n}\n\nexport interface RunCredentialResolveOptions {\n config: Record<string, unknown>;\n /** System-managed long-lived secrets (e.g. an OAuth `refresh_token`). */\n durableCreds?: Record<string, unknown> | null;\n signal?: AbortSignal;\n}\n\nexport interface RunCredentialResolveResult {\n result: ICredentialResolveResult;\n /** Spy wired to `ctx.persistDurableCreds` — assert rotation happened. */\n persistDurableCreds: AnyMock;\n /** The context used, for further assertions (logger calls, etc.). */\n ctx: MockCredentialContext;\n}\n\n/** Runs a credential's `resolve(ctx, config, durableCreds)` and captures rotation. */\nexport async function runCredentialResolve(credential: ICredential, options: RunCredentialResolveOptions): Promise<RunCredentialResolveResult> {\n const ctx = createCredentialContext({ signal: options.signal });\n const result = await credential.resolve(ctx, options.config, options.durableCreds ?? null);\n return { result, persistDurableCreds: ctx.persistDurableCreds, ctx };\n}\n\nexport interface RunOAuthAuthorizeUrlOptions {\n config: Record<string, unknown>;\n redirectUri: string;\n state: string;\n signal?: AbortSignal;\n}\n\n/** Runs `buildAuthorizeUrl` on a 3-legged OAuth credential; throws if unsupported. */\nexport async function runOAuthAuthorizeUrl(credential: ICredential, options: RunOAuthAuthorizeUrlOptions): Promise<{ authorizeUrl: string; codeVerifier?: string }> {\n if (!isOAuthAuthorizeCredential(credential)) {\n throw new Error(`${credential.description.slug} is not a 3-legged OAuth credential`);\n }\n const ctx = createCredentialContext({ signal: options.signal });\n return credential.buildAuthorizeUrl(ctx, options.config, {\n redirectUri: options.redirectUri,\n state: options.state,\n });\n}\n\nexport interface RunOAuthExchangeCodeOptions {\n config: Record<string, unknown>;\n code: string;\n redirectUri: string;\n codeVerifier?: string;\n signal?: AbortSignal;\n}\n\n/** Runs `exchangeCode` on a 3-legged OAuth credential; throws if unsupported. */\nexport async function runOAuthExchangeCode(credential: ICredential, options: RunOAuthExchangeCodeOptions): Promise<{ durableCreds: Record<string, unknown> }> {\n if (!isOAuthAuthorizeCredential(credential)) {\n throw new Error(`${credential.description.slug} is not a 3-legged OAuth credential`);\n }\n const ctx = createCredentialContext({ signal: options.signal });\n return credential.exchangeCode(ctx, options.config, {\n code: options.code,\n redirectUri: options.redirectUri,\n codeVerifier: options.codeVerifier,\n });\n}\n"],"mappings":"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","names":["import_vitest","import_vitest","import_integrations_node_sdk","import_vitest"]}
1
+ {"version":3,"sources":["../../src/testing/index.ts","../../src/testing/context.ts","../../src/state-rules.ts","../../src/testing/author.ts","../../src/testing/fetch.ts","../../src/testing/credentials.ts"],"sourcesContent":["export * from './context.js';\nexport * from './author.js';\nexport * from './fetch.js';\nexport * from './credentials.js';\nexport type * from './mock.js';\n","import type { INodeContext } from '@revenexx/integrations-node-sdk';\nimport { vi } from 'vitest';\nimport type { AnyFn, AnyMock } from './mock.js';\nimport { assertNotRepointed, assertTtlInRange } from '../state-rules.js';\n\n/**\n * Drop-in replacement for the `createMockContext` helper that was, until this\n * package existed, copy-pasted byte-for-byte into every node repo's\n * `tests/helpers/context.ts`. Builds a full {@link INodeContext} with\n * `vi.fn<AnyFn>()`-backed `logger`, `secrets.get`, `credentials.get` and `state` so a\n * node's `execute` can be unit-tested in isolation.\n *\n * The state mock is **stateful on purpose**: what the node writes, it reads\n * back. A node's interesting behaviour is precisely the second run — the one\n * that finds the mapping it created the first time — and a mock that forgets\n * would only ever exercise the create branch. It is the one place an author can\n * test writes at all: in the real product, author-time execution is read-only.\n *\n * It reads back *when the store would let it*, which is not the same for all\n * four roles (SDK 1.0.0, `specs/workflow-state.md`): a mapping and a claim take\n * effect immediately, a cursor and a digest are staged and adopted only once the\n * run completes. So `cursor.get` after `cursor.set` still answers what the last\n * completed run left — call {@link MockContext.completeRun} between two\n * `execute` calls to play the second run, and leave it uncalled to play the run\n * that failed and left the watermark where it was.\n */\n\nexport type MockLogger = {\n info: AnyMock;\n warn: AnyMock;\n error: AnyMock;\n};\n\nexport type MockSecrets = {\n get: AnyMock;\n};\n\nexport type MockCredentials = {\n get: AnyMock;\n};\n\n/** Every state operation is a `vi.fn<AnyFn>()`, so calls can be asserted on. */\nexport type MockState = {\n mapping: { get: AnyMock; put: AnyMock };\n cursor: { get: AnyMock; set: AnyMock };\n claim: AnyMock;\n digest: { unchanged: AnyMock; set: AnyMock };\n};\n\n/**\n * What the store already knows when the node starts — the \"this ran before\"\n * half of any sync test.\n */\nexport interface MockStateSeed {\n /** namespace -> { leftKey: rightKey }; readable from either side. */\n mappings?: Record<string, Record<string, string>>;\n /** namespace -> partitionKey ('' for the unpartitioned one) -> watermark. */\n cursors?: Record<string, Record<string, unknown>>;\n /** namespace -> keys already claimed, so `claim` returns false for them. */\n claims?: Record<string, string[]>;\n /** namespace -> { entityKey: digest }. */\n digests?: Record<string, Record<string, string>>;\n}\n\nexport type MockContext = INodeContext & {\n logger: MockLogger;\n secrets: MockSecrets;\n credentials: MockCredentials;\n state: MockState;\n /**\n * Adopts what this run staged — the cursors and digests it set — the way the\n * engine does when a run completes. Not part of {@link INodeContext}: it is\n * the harness standing in for the run's own ending, and a node can never call\n * it. A test that never calls it has played a run that did not complete.\n */\n completeRun: () => void;\n};\n\nexport interface CreateMockContextOptions {\n signal?: AbortSignal;\n /** Secret key -> value returned by `secrets.get`. Unknown keys fall back to a deterministic stub. */\n secrets?: Record<string, string>;\n /** When set, `secrets.get` rejects with this error instead of resolving. */\n secretsError?: Error;\n /** Credential instance id -> resolved access data returned by `credentials.get`. */\n credentials?: Record<string, Record<string, unknown>>;\n /** When set, `credentials.get` rejects with this error instead of resolving. */\n credentialsError?: Error;\n /** What the state store already holds when the node starts. */\n state?: MockStateSeed;\n /**\n * When set, every state call rejects with this error — the shape of the\n * engine refusing a namespace the workflow never declared.\n */\n stateError?: Error;\n}\n\nexport function createMockContext(options: CreateMockContextOptions = {}): MockContext {\n const signal = options.signal ?? new AbortController().signal;\n const { state, completeRun } = createMockState(options.state, options.stateError);\n\n const secretsGet = options.secretsError\n ? vi.fn<AnyFn>(async () => {\n throw options.secretsError;\n })\n : vi.fn<AnyFn>(async (key: string) => {\n if (options.secrets && key in options.secrets) {\n return options.secrets[key];\n }\n return `secret-value-for-${key}`;\n });\n\n const credentialsGet = options.credentialsError\n ? vi.fn<AnyFn>(async () => {\n throw options.credentialsError;\n })\n : vi.fn<AnyFn>(async (id: string) => {\n if (options.credentials && id in options.credentials) {\n return options.credentials[id];\n }\n return {};\n });\n\n return {\n signal,\n logger: {\n info: vi.fn<AnyFn>(),\n warn: vi.fn<AnyFn>(),\n error: vi.fn<AnyFn>(),\n },\n secrets: {\n get: secretsGet,\n },\n credentials: {\n get: credentialsGet,\n },\n state,\n completeRun,\n };\n}\n\n/**\n * A tiny in-memory stand-in for the four state roles. Seeds are copied rather\n * than referenced, so a test that writes cannot leak into the next one.\n *\n * The write calls split the way the store does. A mapping and a claim land in\n * the committed maps at once; a cursor and a digest land in a staging map that\n * only `completeRun` folds in, so a read during the run answers what the last\n * completed one left. That is the whole reason there are four operations rather\n * than a generic get/set, and a mock that adopted everything immediately would\n * hide the case the rule exists for: the run that fails after advancing its\n * watermark.\n */\nfunction createMockState(seed: MockStateSeed = {}, error?: Error): { state: MockState; completeRun: () => void } {\n const mappings = new Map<string, Map<string, string>>();\n const cursors = new Map<string, Map<string, unknown>>();\n const claims = new Map<string, Set<string>>();\n const digests = new Map<string, Map<string, string>>();\n /** What this run has staged: adopted by `completeRun`, dropped otherwise. */\n const stagedCursors = new Map<string, Map<string, unknown>>();\n const stagedDigests = new Map<string, Map<string, string>>();\n\n for (const [namespace, pairs] of Object.entries(seed.mappings ?? {})) {\n mappings.set(namespace, new Map(Object.entries(pairs)));\n }\n for (const [namespace, partitions] of Object.entries(seed.cursors ?? {})) {\n cursors.set(namespace, new Map(Object.entries(partitions)));\n }\n for (const [namespace, keys] of Object.entries(seed.claims ?? {})) {\n claims.set(namespace, new Set(keys));\n }\n for (const [namespace, entries] of Object.entries(seed.digests ?? {})) {\n digests.set(namespace, new Map(Object.entries(entries)));\n }\n\n /** Wraps an operation so `stateError` short-circuits every one of them. */\n const op = <A extends unknown[], R>(fn: (...args: A) => R) =>\n vi.fn(async (...args: A): Promise<R> => {\n if (error) {\n throw error;\n }\n return fn(...args);\n });\n\n const state: MockState = {\n mapping: {\n get: op((namespace: string, key: string, side: 'left' | 'right' = 'left') => {\n const pairs = mappings.get(namespace);\n if (!pairs) {\n return null;\n }\n if (side === 'left') {\n return pairs.get(key) ?? null;\n }\n for (const [left, right] of pairs) {\n if (right === key) {\n return left;\n }\n }\n return null;\n }),\n put: op((namespace: string, left: string, right: string) => {\n const pairs = mappings.get(namespace) ?? new Map<string, string>();\n assertNotRepointed(namespace, pairs, left, right);\n pairs.set(left, right);\n mappings.set(namespace, pairs);\n }),\n },\n cursor: {\n // The committed watermark: what *this* run staged is deliberately not in\n // the answer, exactly as the real store describes it.\n get: op((namespace: string, partitionKey = '') => cursors.get(namespace)?.get(partitionKey)),\n set: op((namespace: string, value: unknown, partitionKey = '') => {\n const partitions = stagedCursors.get(namespace) ?? new Map<string, unknown>();\n partitions.set(partitionKey, value);\n stagedCursors.set(namespace, partitions);\n }),\n },\n // First caller wins, like the real claim — so a test can drive both the\n // fresh and the duplicate path without reconfiguring the mock. A claim is\n // never handed on here: a TTL is a wall-clock window, and no unit test\n // outlives the shortest one the store accepts.\n claim: op((namespace: string, key: string, opts?: { ttlSeconds?: number }) => {\n assertTtlInRange(opts?.ttlSeconds);\n const held = claims.get(namespace) ?? new Set<string>();\n if (held.has(key)) {\n return false;\n }\n held.add(key);\n claims.set(namespace, held);\n return true;\n }),\n digest: {\n unchanged: op((namespace: string, entityKey: string, digest: string) => digests.get(namespace)?.get(entityKey) === digest),\n set: op((namespace: string, entityKey: string, digest: string) => {\n const entries = stagedDigests.get(namespace) ?? new Map<string, string>();\n entries.set(entityKey, digest);\n stagedDigests.set(namespace, entries);\n }),\n },\n };\n\n const completeRun = (): void => {\n for (const [namespace, partitions] of stagedCursors) {\n const committed = cursors.get(namespace) ?? new Map<string, unknown>();\n for (const [partitionKey, value] of partitions) {\n committed.set(partitionKey, value);\n }\n cursors.set(namespace, committed);\n }\n for (const [namespace, entries] of stagedDigests) {\n const committed = digests.get(namespace) ?? new Map<string, string>();\n for (const [entityKey, digest] of entries) {\n committed.set(entityKey, digest);\n }\n digests.set(namespace, committed);\n }\n stagedCursors.clear();\n stagedDigests.clear();\n };\n\n return { state, completeRun };\n}\n","import { NodeError } from '@revenexx/integrations-node-sdk';\n\n/**\n * The two rules the tenant state store keeps that neither the mock context nor\n * the local preview would otherwise have any reason to keep — and both of which\n * a node author only finds out about in production if we do not.\n *\n * They live here rather than in either caller because the testing harness and\n * the preview must refuse the same things: a node that passes its unit tests and\n * then trips the store on its first preview run has learnt nothing from either.\n * The rest of what the store promises — that a granted claim really excludes a\n * parallel run, that an undeclared namespace is refused — is the engine's, and\n * `specs/workflow-state.md` in the SDK records it as such.\n */\n\n/** Mirrors the engine's default claim lifetime (7 days). */\nexport const DEFAULT_CLAIM_TTL_SECONDS = 604_800;\n\n/** The window the store accepts: one second to one year. */\nexport const MIN_CLAIM_TTL_SECONDS = 1;\nexport const MAX_CLAIM_TTL_SECONDS = 31_536_000;\n\n/**\n * A `ttlSeconds` outside the accepted window is refused rather than clamped: the\n * figure is the duplicate-suppression window *and* the retry window, so a node\n * quietly given a different one than it asked for would suppress deliveries for\n * a stretch its author never chose.\n */\nexport function assertTtlInRange(ttlSeconds: number | undefined): void {\n if (ttlSeconds === undefined) {\n return;\n }\n if (!Number.isFinite(ttlSeconds) || ttlSeconds < MIN_CLAIM_TTL_SECONDS || ttlSeconds > MAX_CLAIM_TTL_SECONDS) {\n throw new NodeError('INVALID_TTL', `ttlSeconds must be between ${MIN_CLAIM_TTL_SECONDS} and ${MAX_CLAIM_TTL_SECONDS}, got ${String(ttlSeconds)}.`);\n }\n}\n\n/**\n * Re-pointing one side of an existing pair is refused, in both directions: an id\n * correlated two ways is always a bug, and no later sync can untangle it —\n * whichever of the two answers a lookup happens to give, half the records it\n * touches are the wrong ones. Writing the same pair again is not a re-point and\n * is allowed, so a node that puts unconditionally on every run stays green.\n */\nexport function assertNotRepointed(namespace: string, pairs: Iterable<[string, string]>, left: string, right: string): void {\n for (const [existingLeft, existingRight] of pairs) {\n if (existingLeft === left && existingRight !== right) {\n throw new NodeError('MAPPING_CONFLICT', `'${left}' is already correlated with '${existingRight}' in namespace '${namespace}'.`);\n }\n if (existingRight === right && existingLeft !== left) {\n throw new NodeError('MAPPING_CONFLICT', `'${right}' is already correlated with '${existingLeft}' in namespace '${namespace}'.`);\n }\n }\n}\n","import type { INodeAuthorContext } from '@revenexx/integrations-node-sdk';\nimport { vi } from 'vitest';\nimport type { AnyFn, AnyMock } from './mock.js';\n\n/**\n * Builds an {@link INodeAuthorContext} for unit-testing a node's *author-time*\n * resolvers (`loadOptions`, `resolveConfigSchema`, `resolveOutputs`). Until this\n * package existed, this factory was reinvented inline in each repo's resolver\n * tests. Mirrors {@link createMockContext}: `secrets.get` / `credentials.get`\n * are `vi.fn<AnyFn>()`-backed and seedable.\n */\n\nexport type MockAuthorLogger = {\n info: AnyMock;\n warn: AnyMock;\n error: AnyMock;\n};\n\nexport type MockAuthorContext = INodeAuthorContext & {\n logger: MockAuthorLogger;\n secrets: { get: AnyMock };\n credentials: { get: AnyMock };\n};\n\nexport interface CreateAuthorContextOptions {\n signal?: AbortSignal;\n /** Preferred locale for resolved labels. */\n locale?: string;\n secrets?: Record<string, string>;\n secretsError?: Error;\n credentials?: Record<string, Record<string, unknown>>;\n credentialsError?: Error;\n}\n\nexport function createAuthorContext(config: Record<string, unknown> = {}, options: CreateAuthorContextOptions = {}): MockAuthorContext {\n const signal = options.signal ?? new AbortController().signal;\n\n const secretsGet = options.secretsError\n ? vi.fn<AnyFn>(async () => {\n throw options.secretsError;\n })\n : vi.fn<AnyFn>(async (key: string) => {\n if (options.secrets && key in options.secrets) {\n return options.secrets[key];\n }\n return `secret-value-for-${key}`;\n });\n\n const credentialsGet = options.credentialsError\n ? vi.fn<AnyFn>(async () => {\n throw options.credentialsError;\n })\n : vi.fn<AnyFn>(async (id: string) => {\n if (options.credentials && id in options.credentials) {\n return options.credentials[id];\n }\n return {};\n });\n\n return {\n signal,\n logger: {\n info: vi.fn<AnyFn>(),\n warn: vi.fn<AnyFn>(),\n error: vi.fn<AnyFn>(),\n },\n config,\n secrets: { get: secretsGet },\n credentials: { get: credentialsGet },\n locale: options.locale,\n };\n}\n","import dns from 'node:dns';\nimport { syncBuiltinESMExports } from 'node:module';\nimport { isIP } from 'node:net';\nimport { vi } from 'vitest';\nimport type { AnyFn, AnyMock } from './mock.js';\n\n/**\n * Utilities for stubbing the global `fetch` so a credential's `resolve` /\n * `test` (which reach an OAuth token endpoint via the SDK's `postForm`) or a\n * node's `execute` (which uses `safeFetch` → global `fetch`) can be\n * unit-tested without touching the network. Builds real `Response` objects so\n * `res.ok` / `res.status` / `res.text()` / `res.json()` all behave exactly as\n * in production.\n */\n\nexport interface StubResponseInit {\n status?: number;\n headers?: Record<string, string>;\n /** JSON body — serialized and served as `application/json` unless `body` is set. */\n json?: unknown;\n /** Raw string body. Takes precedence over `json`. */\n body?: string;\n}\n\nexport interface StubbedRequest {\n url: string;\n method: string;\n init?: RequestInit;\n}\n\nexport type FetchHandler = (request: StubbedRequest) => StubResponseInit | Response | Promise<StubResponseInit | Response>;\n\n/** Builds a real `Response` from a {@link StubResponseInit}. */\nexport function buildResponse(init: StubResponseInit): Response {\n const headers = new Headers(init.headers ?? {});\n let body: string | undefined;\n if (init.body !== undefined) {\n body = init.body;\n } else if (init.json !== undefined) {\n body = JSON.stringify(init.json);\n if (!headers.has('content-type')) {\n headers.set('content-type', 'application/json');\n }\n }\n return new Response(body, { status: init.status ?? 200, headers });\n}\n\nexport interface StubFetchOptions {\n /**\n * Answer DNS too, while the stub is active (default `true`). The SDK's\n * `safeFetch` resolves a request's host through `node:dns/promises` before it\n * calls `fetch`, to refuse private addresses — so without this, a test whose\n * `fetch` is stubbed still asks real DNS, and fails offline or on a slow\n * resolver. With it, every host but `localhost` and an IP literal resolves to\n * {@link STUB_DNS_ADDRESS}, a public address, so the guard lets the request\n * through to the stub.\n *\n * Pass `false` for a test that checks real resolution: this stub then takes\n * no hold on DNS (another active stub without it still keeps DNS stubbed until\n * it is restored). A `lookup` the test\n * already replaced on `node:dns/promises` with a vitest mock is left in place\n * either way, so a test that makes a host resolve to a private address keeps\n * its answer.\n */\n dns?: boolean;\n}\n\nexport interface StubFetchResult {\n /** The `vi.fn<AnyFn>()` installed as `globalThis.fetch` — assert calls on it. */\n fetchMock: AnyMock;\n /** Restores the previous `globalThis.fetch`, and the previous DNS `lookup` where it was replaced. */\n restore(): void;\n}\n\n/**\n * The address every host but `localhost` and an IP literal resolves to while\n * {@link stubFetch} answers DNS. Public, so the SDK's SSRF guard lets it through.\n * A lookup that asks for IPv6 only (`family: 6`) gets {@link STUB_DNS_ADDRESS_V6}.\n */\nexport const STUB_DNS_ADDRESS = '93.184.215.14';\n\n/** The IPv6 counterpart of {@link STUB_DNS_ADDRESS}, also public. */\nexport const STUB_DNS_ADDRESS_V6 = '2606:2800:21f:cb07:6820:80da:af6b:8b2c';\n\ntype PromisesLookup = typeof dns.promises.lookup;\n\n/**\n * The one DNS stub every active {@link stubFetch} shares, and how many of them\n * hold it. Counted rather than stacked, so restores in any order put the\n * original back once the last holder is gone.\n */\nlet sharedDnsStub: { original: PromisesLookup; stubbed: PromisesLookup; holders: number } | undefined;\n\nfunction stubbedAnswer(options: unknown): { address: string; family: number } {\n const family = typeof options === 'number' ? options : typeof options === 'object' && options !== null ? (options as { family?: unknown }).family : undefined;\n return family === 6 || family === 'IPv6' ? { address: STUB_DNS_ADDRESS_V6, family: 6 } : { address: STUB_DNS_ADDRESS, family: 4 };\n}\n\nfunction setLookup(lookup: PromisesLookup): void {\n dns.promises.lookup = lookup;\n syncBuiltinESMExports();\n}\n\n/**\n * Replaces `lookup` on `node:dns/promises` — the object `require` hands out and,\n * after `syncBuiltinESMExports()`, the ESM namespace an `import()` of it reads —\n * and returns the function that releases this hold on it.\n *\n * A lookup that is already a vitest mock is left alone: the test installed it to\n * answer DNS itself, often with a private address, and stubbing over it would\n * quietly make the SSRF guard pass.\n */\nfunction stubDnsLookup(): () => void {\n const current = dns.promises.lookup;\n if (sharedDnsStub !== undefined && current === sharedDnsStub.stubbed) {\n sharedDnsStub.holders += 1;\n } else if (vi.isMockFunction(current)) {\n return () => {};\n } else {\n const original = current;\n const stubbed = ((hostname: string, options?: unknown) => {\n if (hostname === 'localhost' || isIP(hostname) !== 0) {\n return (original as (h: string, o?: unknown) => Promise<unknown>)(hostname, options);\n }\n const address = stubbedAnswer(options);\n const all = typeof options === 'object' && options !== null && (options as { all?: unknown }).all === true;\n return Promise.resolve(all ? [address] : address);\n }) as PromisesLookup;\n sharedDnsStub = { original, stubbed, holders: 1 };\n setLookup(stubbed);\n }\n const held = sharedDnsStub;\n let released = false;\n return () => {\n if (released || held === undefined) return;\n released = true;\n held.holders -= 1;\n if (held.holders > 0) return;\n if (sharedDnsStub === held) sharedDnsStub = undefined;\n // Only undo our own replacement: a lookup somebody installed over it is\n // theirs to restore.\n if (dns.promises.lookup === held.stubbed) setLookup(held.original);\n };\n}\n\n/**\n * Replaces `globalThis.fetch` with a `vi.fn<AnyFn>()` driven by `handler`. Pass a\n * static {@link StubResponseInit} to answer every request identically, or a\n * {@link FetchHandler} to branch on url/method. Unless `options.dns` is `false`,\n * it answers DNS as well (see {@link StubFetchOptions.dns}), so a request through\n * the SDK's `safeFetch` never reaches the network. Call `restore()` when done\n * (e.g. in `afterEach`).\n */\nexport function stubFetch(handler: FetchHandler | StubResponseInit, options: StubFetchOptions = {}): StubFetchResult {\n const previous = globalThis.fetch;\n const restoreDns = options.dns === false ? () => {} : stubDnsLookup();\n const resolveInit: FetchHandler = typeof handler === 'function' ? handler : () => handler;\n\n const fetchMock = vi.fn<AnyFn>(async (input: RequestInfo | URL, init?: RequestInit) => {\n const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;\n const method = (init?.method ?? (input instanceof Request ? input.method : 'GET')).toUpperCase();\n const out = await resolveInit({ url, method, init });\n return out instanceof Response ? out : buildResponse(out);\n });\n\n globalThis.fetch = fetchMock as unknown as typeof fetch;\n return {\n fetchMock,\n restore() {\n globalThis.fetch = previous;\n restoreDns();\n },\n };\n}\n\nexport interface FakeTokenEndpointOptions {\n /** Only answer requests to this exact URL; other requests 404. Omit to answer any URL. */\n tokenUrl?: string;\n accessToken?: string;\n tokenType?: string;\n /** Seconds until expiry (OAuth `expires_in`). Set `null` to omit the field. */\n expiresIn?: number | null;\n /** Included as `refresh_token` when set (e.g. to assert rotation). */\n refreshToken?: string;\n /** Extra fields merged into the token response body. */\n extra?: Record<string, unknown>;\n}\n\n/**\n * A {@link FetchHandler} that emulates an OAuth token endpoint, returning\n * `{ access_token, token_type, expires_in, refresh_token? }`. Compose with\n * {@link stubFetch} to unit-test `oauth2-*` credentials' `resolve` / OAuth\n * `exchangeCode`.\n */\nexport function fakeTokenEndpoint(options: FakeTokenEndpointOptions = {}): FetchHandler {\n const { tokenUrl, accessToken = 'fake-access-token', tokenType = 'Bearer', expiresIn = 3600, refreshToken, extra } = options;\n\n return ({ url }) => {\n if (tokenUrl && url !== tokenUrl) {\n return { status: 404, json: { error: `no stub for ${url}` } };\n }\n const json: Record<string, unknown> = {\n access_token: accessToken,\n token_type: tokenType,\n ...(expiresIn !== null ? { expires_in: expiresIn } : {}),\n ...(refreshToken !== undefined ? { refresh_token: refreshToken } : {}),\n ...extra,\n };\n return { status: 200, json };\n };\n}\n","import type { ICredential, ICredentialContext, ICredentialResolveResult, ICredentialTestResult } from '@revenexx/integrations-node-sdk';\nimport { isOAuthAuthorizeCredential } from '@revenexx/integrations-node-sdk';\nimport { vi } from 'vitest';\nimport type { AnyFn, AnyMock } from './mock.js';\n\n/**\n * Harness for unit-testing a credential type's `test` / `resolve` / 3-legged\n * OAuth without the credentials broker or a real provider. Combine with\n * {@link stubFetch} / {@link fakeTokenEndpoint} to drive the token endpoint,\n * and inspect the returned `persistDurableCreds` spy to assert refresh-token\n * rotation.\n */\n\nexport type MockCredentialLogger = {\n info: AnyMock;\n warn: AnyMock;\n error: AnyMock;\n};\n\nexport type MockCredentialContext = ICredentialContext & {\n logger: MockCredentialLogger;\n /** Spy wired to `ctx.persistDurableCreds`; assert `.toHaveBeenCalledWith(...)`. */\n persistDurableCreds: AnyMock;\n};\n\nexport interface CreateCredentialContextOptions {\n signal?: AbortSignal;\n}\n\nexport function createCredentialContext(options: CreateCredentialContextOptions = {}): MockCredentialContext {\n const signal = options.signal ?? new AbortController().signal;\n const persistDurableCreds = vi.fn<AnyFn>(async (_durableCreds: Record<string, unknown>) => {});\n return {\n signal,\n logger: {\n info: vi.fn<AnyFn>(),\n warn: vi.fn<AnyFn>(),\n error: vi.fn<AnyFn>(),\n },\n persistDurableCreds,\n };\n}\n\nexport interface RunCredentialTestOptions {\n config: Record<string, unknown>;\n signal?: AbortSignal;\n}\n\n/** Runs a credential's `test(ctx, config)` and returns its result. */\nexport async function runCredentialTest(credential: ICredential, options: RunCredentialTestOptions): Promise<ICredentialTestResult> {\n const ctx = createCredentialContext({ signal: options.signal });\n return credential.test(ctx, options.config);\n}\n\nexport interface RunCredentialResolveOptions {\n config: Record<string, unknown>;\n /** System-managed long-lived secrets (e.g. an OAuth `refresh_token`). */\n durableCreds?: Record<string, unknown> | null;\n signal?: AbortSignal;\n}\n\nexport interface RunCredentialResolveResult {\n result: ICredentialResolveResult;\n /** Spy wired to `ctx.persistDurableCreds` — assert rotation happened. */\n persistDurableCreds: AnyMock;\n /** The context used, for further assertions (logger calls, etc.). */\n ctx: MockCredentialContext;\n}\n\n/** Runs a credential's `resolve(ctx, config, durableCreds)` and captures rotation. */\nexport async function runCredentialResolve(credential: ICredential, options: RunCredentialResolveOptions): Promise<RunCredentialResolveResult> {\n const ctx = createCredentialContext({ signal: options.signal });\n const result = await credential.resolve(ctx, options.config, options.durableCreds ?? null);\n return { result, persistDurableCreds: ctx.persistDurableCreds, ctx };\n}\n\nexport interface RunOAuthAuthorizeUrlOptions {\n config: Record<string, unknown>;\n redirectUri: string;\n state: string;\n signal?: AbortSignal;\n}\n\n/** Runs `buildAuthorizeUrl` on a 3-legged OAuth credential; throws if unsupported. */\nexport async function runOAuthAuthorizeUrl(credential: ICredential, options: RunOAuthAuthorizeUrlOptions): Promise<{ authorizeUrl: string; codeVerifier?: string }> {\n if (!isOAuthAuthorizeCredential(credential)) {\n throw new Error(`${credential.description.slug} is not a 3-legged OAuth credential`);\n }\n const ctx = createCredentialContext({ signal: options.signal });\n return credential.buildAuthorizeUrl(ctx, options.config, {\n redirectUri: options.redirectUri,\n state: options.state,\n });\n}\n\nexport interface RunOAuthExchangeCodeOptions {\n config: Record<string, unknown>;\n code: string;\n redirectUri: string;\n codeVerifier?: string;\n signal?: AbortSignal;\n}\n\n/** Runs `exchangeCode` on a 3-legged OAuth credential; throws if unsupported. */\nexport async function runOAuthExchangeCode(credential: ICredential, options: RunOAuthExchangeCodeOptions): Promise<{ durableCreds: Record<string, unknown> }> {\n if (!isOAuthAuthorizeCredential(credential)) {\n throw new Error(`${credential.description.slug} is not a 3-legged OAuth credential`);\n }\n const ctx = createCredentialContext({ signal: options.signal });\n return credential.exchangeCode(ctx, options.config, {\n code: options.code,\n redirectUri: options.redirectUri,\n codeVerifier: options.codeVerifier,\n });\n}\n"],"mappings":"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","names":["import_vitest","import_vitest","dns","import_integrations_node_sdk","import_vitest"]}
@@ -179,6 +179,9 @@ function createAuthorContext(config = {}, options = {}) {
179
179
  }
180
180
 
181
181
  // src/testing/fetch.ts
182
+ import dns from "dns";
183
+ import { syncBuiltinESMExports } from "module";
184
+ import { isIP } from "net";
182
185
  import { vi as vi3 } from "vitest";
183
186
  function buildResponse(init) {
184
187
  const headers = new Headers(init.headers ?? {});
@@ -193,8 +196,52 @@ function buildResponse(init) {
193
196
  }
194
197
  return new Response(body, { status: init.status ?? 200, headers });
195
198
  }
196
- function stubFetch(handler) {
199
+ var STUB_DNS_ADDRESS = "93.184.215.14";
200
+ var STUB_DNS_ADDRESS_V6 = "2606:2800:21f:cb07:6820:80da:af6b:8b2c";
201
+ var sharedDnsStub;
202
+ function stubbedAnswer(options) {
203
+ const family = typeof options === "number" ? options : typeof options === "object" && options !== null ? options.family : void 0;
204
+ return family === 6 || family === "IPv6" ? { address: STUB_DNS_ADDRESS_V6, family: 6 } : { address: STUB_DNS_ADDRESS, family: 4 };
205
+ }
206
+ function setLookup(lookup) {
207
+ dns.promises.lookup = lookup;
208
+ syncBuiltinESMExports();
209
+ }
210
+ function stubDnsLookup() {
211
+ const current = dns.promises.lookup;
212
+ if (sharedDnsStub !== void 0 && current === sharedDnsStub.stubbed) {
213
+ sharedDnsStub.holders += 1;
214
+ } else if (vi3.isMockFunction(current)) {
215
+ return () => {
216
+ };
217
+ } else {
218
+ const original = current;
219
+ const stubbed = ((hostname, options) => {
220
+ if (hostname === "localhost" || isIP(hostname) !== 0) {
221
+ return original(hostname, options);
222
+ }
223
+ const address = stubbedAnswer(options);
224
+ const all = typeof options === "object" && options !== null && options.all === true;
225
+ return Promise.resolve(all ? [address] : address);
226
+ });
227
+ sharedDnsStub = { original, stubbed, holders: 1 };
228
+ setLookup(stubbed);
229
+ }
230
+ const held = sharedDnsStub;
231
+ let released = false;
232
+ return () => {
233
+ if (released || held === void 0) return;
234
+ released = true;
235
+ held.holders -= 1;
236
+ if (held.holders > 0) return;
237
+ if (sharedDnsStub === held) sharedDnsStub = void 0;
238
+ if (dns.promises.lookup === held.stubbed) setLookup(held.original);
239
+ };
240
+ }
241
+ function stubFetch(handler, options = {}) {
197
242
  const previous = globalThis.fetch;
243
+ const restoreDns = options.dns === false ? () => {
244
+ } : stubDnsLookup();
198
245
  const resolveInit = typeof handler === "function" ? handler : () => handler;
199
246
  const fetchMock = vi3.fn(async (input, init) => {
200
247
  const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
@@ -207,6 +254,7 @@ function stubFetch(handler) {
207
254
  fetchMock,
208
255
  restore() {
209
256
  globalThis.fetch = previous;
257
+ restoreDns();
210
258
  }
211
259
  };
212
260
  }
@@ -275,6 +323,8 @@ async function runOAuthExchangeCode(credential, options) {
275
323
  });
276
324
  }
277
325
  export {
326
+ STUB_DNS_ADDRESS,
327
+ STUB_DNS_ADDRESS_V6,
278
328
  buildResponse,
279
329
  createAuthorContext,
280
330
  createCredentialContext,
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/testing/context.ts","../../src/testing/author.ts","../../src/testing/fetch.ts","../../src/testing/credentials.ts"],"sourcesContent":["import type { INodeContext } from '@revenexx/integrations-node-sdk';\nimport { vi } from 'vitest';\nimport type { AnyFn, AnyMock } from './mock.js';\nimport { assertNotRepointed, assertTtlInRange } from '../state-rules.js';\n\n/**\n * Drop-in replacement for the `createMockContext` helper that was, until this\n * package existed, copy-pasted byte-for-byte into every node repo's\n * `tests/helpers/context.ts`. Builds a full {@link INodeContext} with\n * `vi.fn<AnyFn>()`-backed `logger`, `secrets.get`, `credentials.get` and `state` so a\n * node's `execute` can be unit-tested in isolation.\n *\n * The state mock is **stateful on purpose**: what the node writes, it reads\n * back. A node's interesting behaviour is precisely the second run — the one\n * that finds the mapping it created the first time — and a mock that forgets\n * would only ever exercise the create branch. It is the one place an author can\n * test writes at all: in the real product, author-time execution is read-only.\n *\n * It reads back *when the store would let it*, which is not the same for all\n * four roles (SDK 1.0.0, `specs/workflow-state.md`): a mapping and a claim take\n * effect immediately, a cursor and a digest are staged and adopted only once the\n * run completes. So `cursor.get` after `cursor.set` still answers what the last\n * completed run left — call {@link MockContext.completeRun} between two\n * `execute` calls to play the second run, and leave it uncalled to play the run\n * that failed and left the watermark where it was.\n */\n\nexport type MockLogger = {\n info: AnyMock;\n warn: AnyMock;\n error: AnyMock;\n};\n\nexport type MockSecrets = {\n get: AnyMock;\n};\n\nexport type MockCredentials = {\n get: AnyMock;\n};\n\n/** Every state operation is a `vi.fn<AnyFn>()`, so calls can be asserted on. */\nexport type MockState = {\n mapping: { get: AnyMock; put: AnyMock };\n cursor: { get: AnyMock; set: AnyMock };\n claim: AnyMock;\n digest: { unchanged: AnyMock; set: AnyMock };\n};\n\n/**\n * What the store already knows when the node starts — the \"this ran before\"\n * half of any sync test.\n */\nexport interface MockStateSeed {\n /** namespace -> { leftKey: rightKey }; readable from either side. */\n mappings?: Record<string, Record<string, string>>;\n /** namespace -> partitionKey ('' for the unpartitioned one) -> watermark. */\n cursors?: Record<string, Record<string, unknown>>;\n /** namespace -> keys already claimed, so `claim` returns false for them. */\n claims?: Record<string, string[]>;\n /** namespace -> { entityKey: digest }. */\n digests?: Record<string, Record<string, string>>;\n}\n\nexport type MockContext = INodeContext & {\n logger: MockLogger;\n secrets: MockSecrets;\n credentials: MockCredentials;\n state: MockState;\n /**\n * Adopts what this run staged — the cursors and digests it set — the way the\n * engine does when a run completes. Not part of {@link INodeContext}: it is\n * the harness standing in for the run's own ending, and a node can never call\n * it. A test that never calls it has played a run that did not complete.\n */\n completeRun: () => void;\n};\n\nexport interface CreateMockContextOptions {\n signal?: AbortSignal;\n /** Secret key -> value returned by `secrets.get`. Unknown keys fall back to a deterministic stub. */\n secrets?: Record<string, string>;\n /** When set, `secrets.get` rejects with this error instead of resolving. */\n secretsError?: Error;\n /** Credential instance id -> resolved access data returned by `credentials.get`. */\n credentials?: Record<string, Record<string, unknown>>;\n /** When set, `credentials.get` rejects with this error instead of resolving. */\n credentialsError?: Error;\n /** What the state store already holds when the node starts. */\n state?: MockStateSeed;\n /**\n * When set, every state call rejects with this error — the shape of the\n * engine refusing a namespace the workflow never declared.\n */\n stateError?: Error;\n}\n\nexport function createMockContext(options: CreateMockContextOptions = {}): MockContext {\n const signal = options.signal ?? new AbortController().signal;\n const { state, completeRun } = createMockState(options.state, options.stateError);\n\n const secretsGet = options.secretsError\n ? vi.fn<AnyFn>(async () => {\n throw options.secretsError;\n })\n : vi.fn<AnyFn>(async (key: string) => {\n if (options.secrets && key in options.secrets) {\n return options.secrets[key];\n }\n return `secret-value-for-${key}`;\n });\n\n const credentialsGet = options.credentialsError\n ? vi.fn<AnyFn>(async () => {\n throw options.credentialsError;\n })\n : vi.fn<AnyFn>(async (id: string) => {\n if (options.credentials && id in options.credentials) {\n return options.credentials[id];\n }\n return {};\n });\n\n return {\n signal,\n logger: {\n info: vi.fn<AnyFn>(),\n warn: vi.fn<AnyFn>(),\n error: vi.fn<AnyFn>(),\n },\n secrets: {\n get: secretsGet,\n },\n credentials: {\n get: credentialsGet,\n },\n state,\n completeRun,\n };\n}\n\n/**\n * A tiny in-memory stand-in for the four state roles. Seeds are copied rather\n * than referenced, so a test that writes cannot leak into the next one.\n *\n * The write calls split the way the store does. A mapping and a claim land in\n * the committed maps at once; a cursor and a digest land in a staging map that\n * only `completeRun` folds in, so a read during the run answers what the last\n * completed one left. That is the whole reason there are four operations rather\n * than a generic get/set, and a mock that adopted everything immediately would\n * hide the case the rule exists for: the run that fails after advancing its\n * watermark.\n */\nfunction createMockState(seed: MockStateSeed = {}, error?: Error): { state: MockState; completeRun: () => void } {\n const mappings = new Map<string, Map<string, string>>();\n const cursors = new Map<string, Map<string, unknown>>();\n const claims = new Map<string, Set<string>>();\n const digests = new Map<string, Map<string, string>>();\n /** What this run has staged: adopted by `completeRun`, dropped otherwise. */\n const stagedCursors = new Map<string, Map<string, unknown>>();\n const stagedDigests = new Map<string, Map<string, string>>();\n\n for (const [namespace, pairs] of Object.entries(seed.mappings ?? {})) {\n mappings.set(namespace, new Map(Object.entries(pairs)));\n }\n for (const [namespace, partitions] of Object.entries(seed.cursors ?? {})) {\n cursors.set(namespace, new Map(Object.entries(partitions)));\n }\n for (const [namespace, keys] of Object.entries(seed.claims ?? {})) {\n claims.set(namespace, new Set(keys));\n }\n for (const [namespace, entries] of Object.entries(seed.digests ?? {})) {\n digests.set(namespace, new Map(Object.entries(entries)));\n }\n\n /** Wraps an operation so `stateError` short-circuits every one of them. */\n const op = <A extends unknown[], R>(fn: (...args: A) => R) =>\n vi.fn(async (...args: A): Promise<R> => {\n if (error) {\n throw error;\n }\n return fn(...args);\n });\n\n const state: MockState = {\n mapping: {\n get: op((namespace: string, key: string, side: 'left' | 'right' = 'left') => {\n const pairs = mappings.get(namespace);\n if (!pairs) {\n return null;\n }\n if (side === 'left') {\n return pairs.get(key) ?? null;\n }\n for (const [left, right] of pairs) {\n if (right === key) {\n return left;\n }\n }\n return null;\n }),\n put: op((namespace: string, left: string, right: string) => {\n const pairs = mappings.get(namespace) ?? new Map<string, string>();\n assertNotRepointed(namespace, pairs, left, right);\n pairs.set(left, right);\n mappings.set(namespace, pairs);\n }),\n },\n cursor: {\n // The committed watermark: what *this* run staged is deliberately not in\n // the answer, exactly as the real store describes it.\n get: op((namespace: string, partitionKey = '') => cursors.get(namespace)?.get(partitionKey)),\n set: op((namespace: string, value: unknown, partitionKey = '') => {\n const partitions = stagedCursors.get(namespace) ?? new Map<string, unknown>();\n partitions.set(partitionKey, value);\n stagedCursors.set(namespace, partitions);\n }),\n },\n // First caller wins, like the real claim — so a test can drive both the\n // fresh and the duplicate path without reconfiguring the mock. A claim is\n // never handed on here: a TTL is a wall-clock window, and no unit test\n // outlives the shortest one the store accepts.\n claim: op((namespace: string, key: string, opts?: { ttlSeconds?: number }) => {\n assertTtlInRange(opts?.ttlSeconds);\n const held = claims.get(namespace) ?? new Set<string>();\n if (held.has(key)) {\n return false;\n }\n held.add(key);\n claims.set(namespace, held);\n return true;\n }),\n digest: {\n unchanged: op((namespace: string, entityKey: string, digest: string) => digests.get(namespace)?.get(entityKey) === digest),\n set: op((namespace: string, entityKey: string, digest: string) => {\n const entries = stagedDigests.get(namespace) ?? new Map<string, string>();\n entries.set(entityKey, digest);\n stagedDigests.set(namespace, entries);\n }),\n },\n };\n\n const completeRun = (): void => {\n for (const [namespace, partitions] of stagedCursors) {\n const committed = cursors.get(namespace) ?? new Map<string, unknown>();\n for (const [partitionKey, value] of partitions) {\n committed.set(partitionKey, value);\n }\n cursors.set(namespace, committed);\n }\n for (const [namespace, entries] of stagedDigests) {\n const committed = digests.get(namespace) ?? new Map<string, string>();\n for (const [entityKey, digest] of entries) {\n committed.set(entityKey, digest);\n }\n digests.set(namespace, committed);\n }\n stagedCursors.clear();\n stagedDigests.clear();\n };\n\n return { state, completeRun };\n}\n","import type { INodeAuthorContext } from '@revenexx/integrations-node-sdk';\nimport { vi } from 'vitest';\nimport type { AnyFn, AnyMock } from './mock.js';\n\n/**\n * Builds an {@link INodeAuthorContext} for unit-testing a node's *author-time*\n * resolvers (`loadOptions`, `resolveConfigSchema`, `resolveOutputs`). Until this\n * package existed, this factory was reinvented inline in each repo's resolver\n * tests. Mirrors {@link createMockContext}: `secrets.get` / `credentials.get`\n * are `vi.fn<AnyFn>()`-backed and seedable.\n */\n\nexport type MockAuthorLogger = {\n info: AnyMock;\n warn: AnyMock;\n error: AnyMock;\n};\n\nexport type MockAuthorContext = INodeAuthorContext & {\n logger: MockAuthorLogger;\n secrets: { get: AnyMock };\n credentials: { get: AnyMock };\n};\n\nexport interface CreateAuthorContextOptions {\n signal?: AbortSignal;\n /** Preferred locale for resolved labels. */\n locale?: string;\n secrets?: Record<string, string>;\n secretsError?: Error;\n credentials?: Record<string, Record<string, unknown>>;\n credentialsError?: Error;\n}\n\nexport function createAuthorContext(config: Record<string, unknown> = {}, options: CreateAuthorContextOptions = {}): MockAuthorContext {\n const signal = options.signal ?? new AbortController().signal;\n\n const secretsGet = options.secretsError\n ? vi.fn<AnyFn>(async () => {\n throw options.secretsError;\n })\n : vi.fn<AnyFn>(async (key: string) => {\n if (options.secrets && key in options.secrets) {\n return options.secrets[key];\n }\n return `secret-value-for-${key}`;\n });\n\n const credentialsGet = options.credentialsError\n ? vi.fn<AnyFn>(async () => {\n throw options.credentialsError;\n })\n : vi.fn<AnyFn>(async (id: string) => {\n if (options.credentials && id in options.credentials) {\n return options.credentials[id];\n }\n return {};\n });\n\n return {\n signal,\n logger: {\n info: vi.fn<AnyFn>(),\n warn: vi.fn<AnyFn>(),\n error: vi.fn<AnyFn>(),\n },\n config,\n secrets: { get: secretsGet },\n credentials: { get: credentialsGet },\n locale: options.locale,\n };\n}\n","import { vi } from 'vitest';\nimport type { AnyFn, AnyMock } from './mock.js';\n\n/**\n * Utilities for stubbing the global `fetch` so a credential's `resolve` /\n * `test` (which reach an OAuth token endpoint via the SDK's `postForm`) or a\n * node's `execute` (which uses `safeFetch` → global `fetch`) can be\n * unit-tested without touching the network. Builds real `Response` objects so\n * `res.ok` / `res.status` / `res.text()` / `res.json()` all behave exactly as\n * in production.\n */\n\nexport interface StubResponseInit {\n status?: number;\n headers?: Record<string, string>;\n /** JSON body — serialized and served as `application/json` unless `body` is set. */\n json?: unknown;\n /** Raw string body. Takes precedence over `json`. */\n body?: string;\n}\n\nexport interface StubbedRequest {\n url: string;\n method: string;\n init?: RequestInit;\n}\n\nexport type FetchHandler = (request: StubbedRequest) => StubResponseInit | Response | Promise<StubResponseInit | Response>;\n\n/** Builds a real `Response` from a {@link StubResponseInit}. */\nexport function buildResponse(init: StubResponseInit): Response {\n const headers = new Headers(init.headers ?? {});\n let body: string | undefined;\n if (init.body !== undefined) {\n body = init.body;\n } else if (init.json !== undefined) {\n body = JSON.stringify(init.json);\n if (!headers.has('content-type')) {\n headers.set('content-type', 'application/json');\n }\n }\n return new Response(body, { status: init.status ?? 200, headers });\n}\n\nexport interface StubFetchResult {\n /** The `vi.fn<AnyFn>()` installed as `globalThis.fetch` — assert calls on it. */\n fetchMock: AnyMock;\n /** Restores the previous `globalThis.fetch`. */\n restore(): void;\n}\n\n/**\n * Replaces `globalThis.fetch` with a `vi.fn<AnyFn>()` driven by `handler`. Pass a\n * static {@link StubResponseInit} to answer every request identically, or a\n * {@link FetchHandler} to branch on url/method. Call `restore()` when done\n * (e.g. in `afterEach`).\n */\nexport function stubFetch(handler: FetchHandler | StubResponseInit): StubFetchResult {\n const previous = globalThis.fetch;\n const resolveInit: FetchHandler = typeof handler === 'function' ? handler : () => handler;\n\n const fetchMock = vi.fn<AnyFn>(async (input: RequestInfo | URL, init?: RequestInit) => {\n const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;\n const method = (init?.method ?? (input instanceof Request ? input.method : 'GET')).toUpperCase();\n const out = await resolveInit({ url, method, init });\n return out instanceof Response ? out : buildResponse(out);\n });\n\n globalThis.fetch = fetchMock as unknown as typeof fetch;\n return {\n fetchMock,\n restore() {\n globalThis.fetch = previous;\n },\n };\n}\n\nexport interface FakeTokenEndpointOptions {\n /** Only answer requests to this exact URL; other requests 404. Omit to answer any URL. */\n tokenUrl?: string;\n accessToken?: string;\n tokenType?: string;\n /** Seconds until expiry (OAuth `expires_in`). Set `null` to omit the field. */\n expiresIn?: number | null;\n /** Included as `refresh_token` when set (e.g. to assert rotation). */\n refreshToken?: string;\n /** Extra fields merged into the token response body. */\n extra?: Record<string, unknown>;\n}\n\n/**\n * A {@link FetchHandler} that emulates an OAuth token endpoint, returning\n * `{ access_token, token_type, expires_in, refresh_token? }`. Compose with\n * {@link stubFetch} to unit-test `oauth2-*` credentials' `resolve` / OAuth\n * `exchangeCode`.\n */\nexport function fakeTokenEndpoint(options: FakeTokenEndpointOptions = {}): FetchHandler {\n const { tokenUrl, accessToken = 'fake-access-token', tokenType = 'Bearer', expiresIn = 3600, refreshToken, extra } = options;\n\n return ({ url }) => {\n if (tokenUrl && url !== tokenUrl) {\n return { status: 404, json: { error: `no stub for ${url}` } };\n }\n const json: Record<string, unknown> = {\n access_token: accessToken,\n token_type: tokenType,\n ...(expiresIn !== null ? { expires_in: expiresIn } : {}),\n ...(refreshToken !== undefined ? { refresh_token: refreshToken } : {}),\n ...extra,\n };\n return { status: 200, json };\n };\n}\n","import type { ICredential, ICredentialContext, ICredentialResolveResult, ICredentialTestResult } from '@revenexx/integrations-node-sdk';\nimport { isOAuthAuthorizeCredential } from '@revenexx/integrations-node-sdk';\nimport { vi } from 'vitest';\nimport type { AnyFn, AnyMock } from './mock.js';\n\n/**\n * Harness for unit-testing a credential type's `test` / `resolve` / 3-legged\n * OAuth without the credentials broker or a real provider. Combine with\n * {@link stubFetch} / {@link fakeTokenEndpoint} to drive the token endpoint,\n * and inspect the returned `persistDurableCreds` spy to assert refresh-token\n * rotation.\n */\n\nexport type MockCredentialLogger = {\n info: AnyMock;\n warn: AnyMock;\n error: AnyMock;\n};\n\nexport type MockCredentialContext = ICredentialContext & {\n logger: MockCredentialLogger;\n /** Spy wired to `ctx.persistDurableCreds`; assert `.toHaveBeenCalledWith(...)`. */\n persistDurableCreds: AnyMock;\n};\n\nexport interface CreateCredentialContextOptions {\n signal?: AbortSignal;\n}\n\nexport function createCredentialContext(options: CreateCredentialContextOptions = {}): MockCredentialContext {\n const signal = options.signal ?? new AbortController().signal;\n const persistDurableCreds = vi.fn<AnyFn>(async (_durableCreds: Record<string, unknown>) => {});\n return {\n signal,\n logger: {\n info: vi.fn<AnyFn>(),\n warn: vi.fn<AnyFn>(),\n error: vi.fn<AnyFn>(),\n },\n persistDurableCreds,\n };\n}\n\nexport interface RunCredentialTestOptions {\n config: Record<string, unknown>;\n signal?: AbortSignal;\n}\n\n/** Runs a credential's `test(ctx, config)` and returns its result. */\nexport async function runCredentialTest(credential: ICredential, options: RunCredentialTestOptions): Promise<ICredentialTestResult> {\n const ctx = createCredentialContext({ signal: options.signal });\n return credential.test(ctx, options.config);\n}\n\nexport interface RunCredentialResolveOptions {\n config: Record<string, unknown>;\n /** System-managed long-lived secrets (e.g. an OAuth `refresh_token`). */\n durableCreds?: Record<string, unknown> | null;\n signal?: AbortSignal;\n}\n\nexport interface RunCredentialResolveResult {\n result: ICredentialResolveResult;\n /** Spy wired to `ctx.persistDurableCreds` — assert rotation happened. */\n persistDurableCreds: AnyMock;\n /** The context used, for further assertions (logger calls, etc.). */\n ctx: MockCredentialContext;\n}\n\n/** Runs a credential's `resolve(ctx, config, durableCreds)` and captures rotation. */\nexport async function runCredentialResolve(credential: ICredential, options: RunCredentialResolveOptions): Promise<RunCredentialResolveResult> {\n const ctx = createCredentialContext({ signal: options.signal });\n const result = await credential.resolve(ctx, options.config, options.durableCreds ?? null);\n return { result, persistDurableCreds: ctx.persistDurableCreds, ctx };\n}\n\nexport interface RunOAuthAuthorizeUrlOptions {\n config: Record<string, unknown>;\n redirectUri: string;\n state: string;\n signal?: AbortSignal;\n}\n\n/** Runs `buildAuthorizeUrl` on a 3-legged OAuth credential; throws if unsupported. */\nexport async function runOAuthAuthorizeUrl(credential: ICredential, options: RunOAuthAuthorizeUrlOptions): Promise<{ authorizeUrl: string; codeVerifier?: string }> {\n if (!isOAuthAuthorizeCredential(credential)) {\n throw new Error(`${credential.description.slug} is not a 3-legged OAuth credential`);\n }\n const ctx = createCredentialContext({ signal: options.signal });\n return credential.buildAuthorizeUrl(ctx, options.config, {\n redirectUri: options.redirectUri,\n state: options.state,\n });\n}\n\nexport interface RunOAuthExchangeCodeOptions {\n config: Record<string, unknown>;\n code: string;\n redirectUri: string;\n codeVerifier?: string;\n signal?: AbortSignal;\n}\n\n/** Runs `exchangeCode` on a 3-legged OAuth credential; throws if unsupported. */\nexport async function runOAuthExchangeCode(credential: ICredential, options: RunOAuthExchangeCodeOptions): Promise<{ durableCreds: Record<string, unknown> }> {\n if (!isOAuthAuthorizeCredential(credential)) {\n throw new Error(`${credential.description.slug} is not a 3-legged OAuth credential`);\n }\n const ctx = createCredentialContext({ signal: options.signal });\n return credential.exchangeCode(ctx, options.config, {\n code: options.code,\n redirectUri: options.redirectUri,\n codeVerifier: options.codeVerifier,\n });\n}\n"],"mappings":"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","names":["vi","vi","vi"]}
1
+ {"version":3,"sources":["../../src/testing/context.ts","../../src/testing/author.ts","../../src/testing/fetch.ts","../../src/testing/credentials.ts"],"sourcesContent":["import type { INodeContext } from '@revenexx/integrations-node-sdk';\nimport { vi } from 'vitest';\nimport type { AnyFn, AnyMock } from './mock.js';\nimport { assertNotRepointed, assertTtlInRange } from '../state-rules.js';\n\n/**\n * Drop-in replacement for the `createMockContext` helper that was, until this\n * package existed, copy-pasted byte-for-byte into every node repo's\n * `tests/helpers/context.ts`. Builds a full {@link INodeContext} with\n * `vi.fn<AnyFn>()`-backed `logger`, `secrets.get`, `credentials.get` and `state` so a\n * node's `execute` can be unit-tested in isolation.\n *\n * The state mock is **stateful on purpose**: what the node writes, it reads\n * back. A node's interesting behaviour is precisely the second run — the one\n * that finds the mapping it created the first time — and a mock that forgets\n * would only ever exercise the create branch. It is the one place an author can\n * test writes at all: in the real product, author-time execution is read-only.\n *\n * It reads back *when the store would let it*, which is not the same for all\n * four roles (SDK 1.0.0, `specs/workflow-state.md`): a mapping and a claim take\n * effect immediately, a cursor and a digest are staged and adopted only once the\n * run completes. So `cursor.get` after `cursor.set` still answers what the last\n * completed run left — call {@link MockContext.completeRun} between two\n * `execute` calls to play the second run, and leave it uncalled to play the run\n * that failed and left the watermark where it was.\n */\n\nexport type MockLogger = {\n info: AnyMock;\n warn: AnyMock;\n error: AnyMock;\n};\n\nexport type MockSecrets = {\n get: AnyMock;\n};\n\nexport type MockCredentials = {\n get: AnyMock;\n};\n\n/** Every state operation is a `vi.fn<AnyFn>()`, so calls can be asserted on. */\nexport type MockState = {\n mapping: { get: AnyMock; put: AnyMock };\n cursor: { get: AnyMock; set: AnyMock };\n claim: AnyMock;\n digest: { unchanged: AnyMock; set: AnyMock };\n};\n\n/**\n * What the store already knows when the node starts — the \"this ran before\"\n * half of any sync test.\n */\nexport interface MockStateSeed {\n /** namespace -> { leftKey: rightKey }; readable from either side. */\n mappings?: Record<string, Record<string, string>>;\n /** namespace -> partitionKey ('' for the unpartitioned one) -> watermark. */\n cursors?: Record<string, Record<string, unknown>>;\n /** namespace -> keys already claimed, so `claim` returns false for them. */\n claims?: Record<string, string[]>;\n /** namespace -> { entityKey: digest }. */\n digests?: Record<string, Record<string, string>>;\n}\n\nexport type MockContext = INodeContext & {\n logger: MockLogger;\n secrets: MockSecrets;\n credentials: MockCredentials;\n state: MockState;\n /**\n * Adopts what this run staged — the cursors and digests it set — the way the\n * engine does when a run completes. Not part of {@link INodeContext}: it is\n * the harness standing in for the run's own ending, and a node can never call\n * it. A test that never calls it has played a run that did not complete.\n */\n completeRun: () => void;\n};\n\nexport interface CreateMockContextOptions {\n signal?: AbortSignal;\n /** Secret key -> value returned by `secrets.get`. Unknown keys fall back to a deterministic stub. */\n secrets?: Record<string, string>;\n /** When set, `secrets.get` rejects with this error instead of resolving. */\n secretsError?: Error;\n /** Credential instance id -> resolved access data returned by `credentials.get`. */\n credentials?: Record<string, Record<string, unknown>>;\n /** When set, `credentials.get` rejects with this error instead of resolving. */\n credentialsError?: Error;\n /** What the state store already holds when the node starts. */\n state?: MockStateSeed;\n /**\n * When set, every state call rejects with this error — the shape of the\n * engine refusing a namespace the workflow never declared.\n */\n stateError?: Error;\n}\n\nexport function createMockContext(options: CreateMockContextOptions = {}): MockContext {\n const signal = options.signal ?? new AbortController().signal;\n const { state, completeRun } = createMockState(options.state, options.stateError);\n\n const secretsGet = options.secretsError\n ? vi.fn<AnyFn>(async () => {\n throw options.secretsError;\n })\n : vi.fn<AnyFn>(async (key: string) => {\n if (options.secrets && key in options.secrets) {\n return options.secrets[key];\n }\n return `secret-value-for-${key}`;\n });\n\n const credentialsGet = options.credentialsError\n ? vi.fn<AnyFn>(async () => {\n throw options.credentialsError;\n })\n : vi.fn<AnyFn>(async (id: string) => {\n if (options.credentials && id in options.credentials) {\n return options.credentials[id];\n }\n return {};\n });\n\n return {\n signal,\n logger: {\n info: vi.fn<AnyFn>(),\n warn: vi.fn<AnyFn>(),\n error: vi.fn<AnyFn>(),\n },\n secrets: {\n get: secretsGet,\n },\n credentials: {\n get: credentialsGet,\n },\n state,\n completeRun,\n };\n}\n\n/**\n * A tiny in-memory stand-in for the four state roles. Seeds are copied rather\n * than referenced, so a test that writes cannot leak into the next one.\n *\n * The write calls split the way the store does. A mapping and a claim land in\n * the committed maps at once; a cursor and a digest land in a staging map that\n * only `completeRun` folds in, so a read during the run answers what the last\n * completed one left. That is the whole reason there are four operations rather\n * than a generic get/set, and a mock that adopted everything immediately would\n * hide the case the rule exists for: the run that fails after advancing its\n * watermark.\n */\nfunction createMockState(seed: MockStateSeed = {}, error?: Error): { state: MockState; completeRun: () => void } {\n const mappings = new Map<string, Map<string, string>>();\n const cursors = new Map<string, Map<string, unknown>>();\n const claims = new Map<string, Set<string>>();\n const digests = new Map<string, Map<string, string>>();\n /** What this run has staged: adopted by `completeRun`, dropped otherwise. */\n const stagedCursors = new Map<string, Map<string, unknown>>();\n const stagedDigests = new Map<string, Map<string, string>>();\n\n for (const [namespace, pairs] of Object.entries(seed.mappings ?? {})) {\n mappings.set(namespace, new Map(Object.entries(pairs)));\n }\n for (const [namespace, partitions] of Object.entries(seed.cursors ?? {})) {\n cursors.set(namespace, new Map(Object.entries(partitions)));\n }\n for (const [namespace, keys] of Object.entries(seed.claims ?? {})) {\n claims.set(namespace, new Set(keys));\n }\n for (const [namespace, entries] of Object.entries(seed.digests ?? {})) {\n digests.set(namespace, new Map(Object.entries(entries)));\n }\n\n /** Wraps an operation so `stateError` short-circuits every one of them. */\n const op = <A extends unknown[], R>(fn: (...args: A) => R) =>\n vi.fn(async (...args: A): Promise<R> => {\n if (error) {\n throw error;\n }\n return fn(...args);\n });\n\n const state: MockState = {\n mapping: {\n get: op((namespace: string, key: string, side: 'left' | 'right' = 'left') => {\n const pairs = mappings.get(namespace);\n if (!pairs) {\n return null;\n }\n if (side === 'left') {\n return pairs.get(key) ?? null;\n }\n for (const [left, right] of pairs) {\n if (right === key) {\n return left;\n }\n }\n return null;\n }),\n put: op((namespace: string, left: string, right: string) => {\n const pairs = mappings.get(namespace) ?? new Map<string, string>();\n assertNotRepointed(namespace, pairs, left, right);\n pairs.set(left, right);\n mappings.set(namespace, pairs);\n }),\n },\n cursor: {\n // The committed watermark: what *this* run staged is deliberately not in\n // the answer, exactly as the real store describes it.\n get: op((namespace: string, partitionKey = '') => cursors.get(namespace)?.get(partitionKey)),\n set: op((namespace: string, value: unknown, partitionKey = '') => {\n const partitions = stagedCursors.get(namespace) ?? new Map<string, unknown>();\n partitions.set(partitionKey, value);\n stagedCursors.set(namespace, partitions);\n }),\n },\n // First caller wins, like the real claim — so a test can drive both the\n // fresh and the duplicate path without reconfiguring the mock. A claim is\n // never handed on here: a TTL is a wall-clock window, and no unit test\n // outlives the shortest one the store accepts.\n claim: op((namespace: string, key: string, opts?: { ttlSeconds?: number }) => {\n assertTtlInRange(opts?.ttlSeconds);\n const held = claims.get(namespace) ?? new Set<string>();\n if (held.has(key)) {\n return false;\n }\n held.add(key);\n claims.set(namespace, held);\n return true;\n }),\n digest: {\n unchanged: op((namespace: string, entityKey: string, digest: string) => digests.get(namespace)?.get(entityKey) === digest),\n set: op((namespace: string, entityKey: string, digest: string) => {\n const entries = stagedDigests.get(namespace) ?? new Map<string, string>();\n entries.set(entityKey, digest);\n stagedDigests.set(namespace, entries);\n }),\n },\n };\n\n const completeRun = (): void => {\n for (const [namespace, partitions] of stagedCursors) {\n const committed = cursors.get(namespace) ?? new Map<string, unknown>();\n for (const [partitionKey, value] of partitions) {\n committed.set(partitionKey, value);\n }\n cursors.set(namespace, committed);\n }\n for (const [namespace, entries] of stagedDigests) {\n const committed = digests.get(namespace) ?? new Map<string, string>();\n for (const [entityKey, digest] of entries) {\n committed.set(entityKey, digest);\n }\n digests.set(namespace, committed);\n }\n stagedCursors.clear();\n stagedDigests.clear();\n };\n\n return { state, completeRun };\n}\n","import type { INodeAuthorContext } from '@revenexx/integrations-node-sdk';\nimport { vi } from 'vitest';\nimport type { AnyFn, AnyMock } from './mock.js';\n\n/**\n * Builds an {@link INodeAuthorContext} for unit-testing a node's *author-time*\n * resolvers (`loadOptions`, `resolveConfigSchema`, `resolveOutputs`). Until this\n * package existed, this factory was reinvented inline in each repo's resolver\n * tests. Mirrors {@link createMockContext}: `secrets.get` / `credentials.get`\n * are `vi.fn<AnyFn>()`-backed and seedable.\n */\n\nexport type MockAuthorLogger = {\n info: AnyMock;\n warn: AnyMock;\n error: AnyMock;\n};\n\nexport type MockAuthorContext = INodeAuthorContext & {\n logger: MockAuthorLogger;\n secrets: { get: AnyMock };\n credentials: { get: AnyMock };\n};\n\nexport interface CreateAuthorContextOptions {\n signal?: AbortSignal;\n /** Preferred locale for resolved labels. */\n locale?: string;\n secrets?: Record<string, string>;\n secretsError?: Error;\n credentials?: Record<string, Record<string, unknown>>;\n credentialsError?: Error;\n}\n\nexport function createAuthorContext(config: Record<string, unknown> = {}, options: CreateAuthorContextOptions = {}): MockAuthorContext {\n const signal = options.signal ?? new AbortController().signal;\n\n const secretsGet = options.secretsError\n ? vi.fn<AnyFn>(async () => {\n throw options.secretsError;\n })\n : vi.fn<AnyFn>(async (key: string) => {\n if (options.secrets && key in options.secrets) {\n return options.secrets[key];\n }\n return `secret-value-for-${key}`;\n });\n\n const credentialsGet = options.credentialsError\n ? vi.fn<AnyFn>(async () => {\n throw options.credentialsError;\n })\n : vi.fn<AnyFn>(async (id: string) => {\n if (options.credentials && id in options.credentials) {\n return options.credentials[id];\n }\n return {};\n });\n\n return {\n signal,\n logger: {\n info: vi.fn<AnyFn>(),\n warn: vi.fn<AnyFn>(),\n error: vi.fn<AnyFn>(),\n },\n config,\n secrets: { get: secretsGet },\n credentials: { get: credentialsGet },\n locale: options.locale,\n };\n}\n","import dns from 'node:dns';\nimport { syncBuiltinESMExports } from 'node:module';\nimport { isIP } from 'node:net';\nimport { vi } from 'vitest';\nimport type { AnyFn, AnyMock } from './mock.js';\n\n/**\n * Utilities for stubbing the global `fetch` so a credential's `resolve` /\n * `test` (which reach an OAuth token endpoint via the SDK's `postForm`) or a\n * node's `execute` (which uses `safeFetch` → global `fetch`) can be\n * unit-tested without touching the network. Builds real `Response` objects so\n * `res.ok` / `res.status` / `res.text()` / `res.json()` all behave exactly as\n * in production.\n */\n\nexport interface StubResponseInit {\n status?: number;\n headers?: Record<string, string>;\n /** JSON body — serialized and served as `application/json` unless `body` is set. */\n json?: unknown;\n /** Raw string body. Takes precedence over `json`. */\n body?: string;\n}\n\nexport interface StubbedRequest {\n url: string;\n method: string;\n init?: RequestInit;\n}\n\nexport type FetchHandler = (request: StubbedRequest) => StubResponseInit | Response | Promise<StubResponseInit | Response>;\n\n/** Builds a real `Response` from a {@link StubResponseInit}. */\nexport function buildResponse(init: StubResponseInit): Response {\n const headers = new Headers(init.headers ?? {});\n let body: string | undefined;\n if (init.body !== undefined) {\n body = init.body;\n } else if (init.json !== undefined) {\n body = JSON.stringify(init.json);\n if (!headers.has('content-type')) {\n headers.set('content-type', 'application/json');\n }\n }\n return new Response(body, { status: init.status ?? 200, headers });\n}\n\nexport interface StubFetchOptions {\n /**\n * Answer DNS too, while the stub is active (default `true`). The SDK's\n * `safeFetch` resolves a request's host through `node:dns/promises` before it\n * calls `fetch`, to refuse private addresses — so without this, a test whose\n * `fetch` is stubbed still asks real DNS, and fails offline or on a slow\n * resolver. With it, every host but `localhost` and an IP literal resolves to\n * {@link STUB_DNS_ADDRESS}, a public address, so the guard lets the request\n * through to the stub.\n *\n * Pass `false` for a test that checks real resolution: this stub then takes\n * no hold on DNS (another active stub without it still keeps DNS stubbed until\n * it is restored). A `lookup` the test\n * already replaced on `node:dns/promises` with a vitest mock is left in place\n * either way, so a test that makes a host resolve to a private address keeps\n * its answer.\n */\n dns?: boolean;\n}\n\nexport interface StubFetchResult {\n /** The `vi.fn<AnyFn>()` installed as `globalThis.fetch` — assert calls on it. */\n fetchMock: AnyMock;\n /** Restores the previous `globalThis.fetch`, and the previous DNS `lookup` where it was replaced. */\n restore(): void;\n}\n\n/**\n * The address every host but `localhost` and an IP literal resolves to while\n * {@link stubFetch} answers DNS. Public, so the SDK's SSRF guard lets it through.\n * A lookup that asks for IPv6 only (`family: 6`) gets {@link STUB_DNS_ADDRESS_V6}.\n */\nexport const STUB_DNS_ADDRESS = '93.184.215.14';\n\n/** The IPv6 counterpart of {@link STUB_DNS_ADDRESS}, also public. */\nexport const STUB_DNS_ADDRESS_V6 = '2606:2800:21f:cb07:6820:80da:af6b:8b2c';\n\ntype PromisesLookup = typeof dns.promises.lookup;\n\n/**\n * The one DNS stub every active {@link stubFetch} shares, and how many of them\n * hold it. Counted rather than stacked, so restores in any order put the\n * original back once the last holder is gone.\n */\nlet sharedDnsStub: { original: PromisesLookup; stubbed: PromisesLookup; holders: number } | undefined;\n\nfunction stubbedAnswer(options: unknown): { address: string; family: number } {\n const family = typeof options === 'number' ? options : typeof options === 'object' && options !== null ? (options as { family?: unknown }).family : undefined;\n return family === 6 || family === 'IPv6' ? { address: STUB_DNS_ADDRESS_V6, family: 6 } : { address: STUB_DNS_ADDRESS, family: 4 };\n}\n\nfunction setLookup(lookup: PromisesLookup): void {\n dns.promises.lookup = lookup;\n syncBuiltinESMExports();\n}\n\n/**\n * Replaces `lookup` on `node:dns/promises` — the object `require` hands out and,\n * after `syncBuiltinESMExports()`, the ESM namespace an `import()` of it reads —\n * and returns the function that releases this hold on it.\n *\n * A lookup that is already a vitest mock is left alone: the test installed it to\n * answer DNS itself, often with a private address, and stubbing over it would\n * quietly make the SSRF guard pass.\n */\nfunction stubDnsLookup(): () => void {\n const current = dns.promises.lookup;\n if (sharedDnsStub !== undefined && current === sharedDnsStub.stubbed) {\n sharedDnsStub.holders += 1;\n } else if (vi.isMockFunction(current)) {\n return () => {};\n } else {\n const original = current;\n const stubbed = ((hostname: string, options?: unknown) => {\n if (hostname === 'localhost' || isIP(hostname) !== 0) {\n return (original as (h: string, o?: unknown) => Promise<unknown>)(hostname, options);\n }\n const address = stubbedAnswer(options);\n const all = typeof options === 'object' && options !== null && (options as { all?: unknown }).all === true;\n return Promise.resolve(all ? [address] : address);\n }) as PromisesLookup;\n sharedDnsStub = { original, stubbed, holders: 1 };\n setLookup(stubbed);\n }\n const held = sharedDnsStub;\n let released = false;\n return () => {\n if (released || held === undefined) return;\n released = true;\n held.holders -= 1;\n if (held.holders > 0) return;\n if (sharedDnsStub === held) sharedDnsStub = undefined;\n // Only undo our own replacement: a lookup somebody installed over it is\n // theirs to restore.\n if (dns.promises.lookup === held.stubbed) setLookup(held.original);\n };\n}\n\n/**\n * Replaces `globalThis.fetch` with a `vi.fn<AnyFn>()` driven by `handler`. Pass a\n * static {@link StubResponseInit} to answer every request identically, or a\n * {@link FetchHandler} to branch on url/method. Unless `options.dns` is `false`,\n * it answers DNS as well (see {@link StubFetchOptions.dns}), so a request through\n * the SDK's `safeFetch` never reaches the network. Call `restore()` when done\n * (e.g. in `afterEach`).\n */\nexport function stubFetch(handler: FetchHandler | StubResponseInit, options: StubFetchOptions = {}): StubFetchResult {\n const previous = globalThis.fetch;\n const restoreDns = options.dns === false ? () => {} : stubDnsLookup();\n const resolveInit: FetchHandler = typeof handler === 'function' ? handler : () => handler;\n\n const fetchMock = vi.fn<AnyFn>(async (input: RequestInfo | URL, init?: RequestInit) => {\n const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;\n const method = (init?.method ?? (input instanceof Request ? input.method : 'GET')).toUpperCase();\n const out = await resolveInit({ url, method, init });\n return out instanceof Response ? out : buildResponse(out);\n });\n\n globalThis.fetch = fetchMock as unknown as typeof fetch;\n return {\n fetchMock,\n restore() {\n globalThis.fetch = previous;\n restoreDns();\n },\n };\n}\n\nexport interface FakeTokenEndpointOptions {\n /** Only answer requests to this exact URL; other requests 404. Omit to answer any URL. */\n tokenUrl?: string;\n accessToken?: string;\n tokenType?: string;\n /** Seconds until expiry (OAuth `expires_in`). Set `null` to omit the field. */\n expiresIn?: number | null;\n /** Included as `refresh_token` when set (e.g. to assert rotation). */\n refreshToken?: string;\n /** Extra fields merged into the token response body. */\n extra?: Record<string, unknown>;\n}\n\n/**\n * A {@link FetchHandler} that emulates an OAuth token endpoint, returning\n * `{ access_token, token_type, expires_in, refresh_token? }`. Compose with\n * {@link stubFetch} to unit-test `oauth2-*` credentials' `resolve` / OAuth\n * `exchangeCode`.\n */\nexport function fakeTokenEndpoint(options: FakeTokenEndpointOptions = {}): FetchHandler {\n const { tokenUrl, accessToken = 'fake-access-token', tokenType = 'Bearer', expiresIn = 3600, refreshToken, extra } = options;\n\n return ({ url }) => {\n if (tokenUrl && url !== tokenUrl) {\n return { status: 404, json: { error: `no stub for ${url}` } };\n }\n const json: Record<string, unknown> = {\n access_token: accessToken,\n token_type: tokenType,\n ...(expiresIn !== null ? { expires_in: expiresIn } : {}),\n ...(refreshToken !== undefined ? { refresh_token: refreshToken } : {}),\n ...extra,\n };\n return { status: 200, json };\n };\n}\n","import type { ICredential, ICredentialContext, ICredentialResolveResult, ICredentialTestResult } from '@revenexx/integrations-node-sdk';\nimport { isOAuthAuthorizeCredential } from '@revenexx/integrations-node-sdk';\nimport { vi } from 'vitest';\nimport type { AnyFn, AnyMock } from './mock.js';\n\n/**\n * Harness for unit-testing a credential type's `test` / `resolve` / 3-legged\n * OAuth without the credentials broker or a real provider. Combine with\n * {@link stubFetch} / {@link fakeTokenEndpoint} to drive the token endpoint,\n * and inspect the returned `persistDurableCreds` spy to assert refresh-token\n * rotation.\n */\n\nexport type MockCredentialLogger = {\n info: AnyMock;\n warn: AnyMock;\n error: AnyMock;\n};\n\nexport type MockCredentialContext = ICredentialContext & {\n logger: MockCredentialLogger;\n /** Spy wired to `ctx.persistDurableCreds`; assert `.toHaveBeenCalledWith(...)`. */\n persistDurableCreds: AnyMock;\n};\n\nexport interface CreateCredentialContextOptions {\n signal?: AbortSignal;\n}\n\nexport function createCredentialContext(options: CreateCredentialContextOptions = {}): MockCredentialContext {\n const signal = options.signal ?? new AbortController().signal;\n const persistDurableCreds = vi.fn<AnyFn>(async (_durableCreds: Record<string, unknown>) => {});\n return {\n signal,\n logger: {\n info: vi.fn<AnyFn>(),\n warn: vi.fn<AnyFn>(),\n error: vi.fn<AnyFn>(),\n },\n persistDurableCreds,\n };\n}\n\nexport interface RunCredentialTestOptions {\n config: Record<string, unknown>;\n signal?: AbortSignal;\n}\n\n/** Runs a credential's `test(ctx, config)` and returns its result. */\nexport async function runCredentialTest(credential: ICredential, options: RunCredentialTestOptions): Promise<ICredentialTestResult> {\n const ctx = createCredentialContext({ signal: options.signal });\n return credential.test(ctx, options.config);\n}\n\nexport interface RunCredentialResolveOptions {\n config: Record<string, unknown>;\n /** System-managed long-lived secrets (e.g. an OAuth `refresh_token`). */\n durableCreds?: Record<string, unknown> | null;\n signal?: AbortSignal;\n}\n\nexport interface RunCredentialResolveResult {\n result: ICredentialResolveResult;\n /** Spy wired to `ctx.persistDurableCreds` — assert rotation happened. */\n persistDurableCreds: AnyMock;\n /** The context used, for further assertions (logger calls, etc.). */\n ctx: MockCredentialContext;\n}\n\n/** Runs a credential's `resolve(ctx, config, durableCreds)` and captures rotation. */\nexport async function runCredentialResolve(credential: ICredential, options: RunCredentialResolveOptions): Promise<RunCredentialResolveResult> {\n const ctx = createCredentialContext({ signal: options.signal });\n const result = await credential.resolve(ctx, options.config, options.durableCreds ?? null);\n return { result, persistDurableCreds: ctx.persistDurableCreds, ctx };\n}\n\nexport interface RunOAuthAuthorizeUrlOptions {\n config: Record<string, unknown>;\n redirectUri: string;\n state: string;\n signal?: AbortSignal;\n}\n\n/** Runs `buildAuthorizeUrl` on a 3-legged OAuth credential; throws if unsupported. */\nexport async function runOAuthAuthorizeUrl(credential: ICredential, options: RunOAuthAuthorizeUrlOptions): Promise<{ authorizeUrl: string; codeVerifier?: string }> {\n if (!isOAuthAuthorizeCredential(credential)) {\n throw new Error(`${credential.description.slug} is not a 3-legged OAuth credential`);\n }\n const ctx = createCredentialContext({ signal: options.signal });\n return credential.buildAuthorizeUrl(ctx, options.config, {\n redirectUri: options.redirectUri,\n state: options.state,\n });\n}\n\nexport interface RunOAuthExchangeCodeOptions {\n config: Record<string, unknown>;\n code: string;\n redirectUri: string;\n codeVerifier?: string;\n signal?: AbortSignal;\n}\n\n/** Runs `exchangeCode` on a 3-legged OAuth credential; throws if unsupported. */\nexport async function runOAuthExchangeCode(credential: ICredential, options: RunOAuthExchangeCodeOptions): Promise<{ durableCreds: Record<string, unknown> }> {\n if (!isOAuthAuthorizeCredential(credential)) {\n throw new Error(`${credential.description.slug} is not a 3-legged OAuth credential`);\n }\n const ctx = createCredentialContext({ signal: options.signal });\n return credential.exchangeCode(ctx, options.config, {\n code: options.code,\n redirectUri: options.redirectUri,\n codeVerifier: options.codeVerifier,\n });\n}\n"],"mappings":"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","names":["vi","vi","vi"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@revenexx/integrations-node-devkit",
3
- "version": "0.8.2",
3
+ "version": "0.9.0",
4
4
  "description": "Local development kit for Revenexx integration node packages — a mock Integrations API for previewing nodes/credentials/templates in the Cockpit UI, plus a unit-testing harness. Dev/CI only, never bundled.",
5
5
  "keywords": [
6
6
  "revenexx",
@@ -64,7 +64,7 @@
64
64
  "devDependencies": {
65
65
  "@biomejs/biome": "^2.5.0",
66
66
  "@changesets/cli": "^3.0.3",
67
- "@revenexx/integrations-node-sdk": ">=1.0.0",
67
+ "@revenexx/integrations-node-sdk": "^2.0.0",
68
68
  "@types/node": "^24.0.0",
69
69
  "tsup": "^9.0.0",
70
70
  "typescript": "^7.0.2",
@@ -82,7 +82,7 @@
82
82
  }
83
83
  },
84
84
  "engines": {
85
- "node": ">=20.3.0"
85
+ "node": ">=22.19.0"
86
86
  },
87
87
  "publishConfig": {
88
88
  "access": "public",
@@ -10,7 +10,7 @@
10
10
  "dependencies": {
11
11
  "@dagrejs/dagre": "^3.0.0",
12
12
  "@revenexx/studio": "^0.2.2",
13
- "@revenexx/studio-integrations": "2.8.1",
13
+ "@revenexx/studio-integrations": "3.4.0",
14
14
  "@revenexx/studio-shared": "^0.4.0",
15
15
  "@revenexx/talkback-js": "^0.3.0",
16
16
  "@solar-icons/nuxt": "^2.3.2",