@ryanstark24/sfgraph-core 1.1.8 → 1.4.0

package/dist/extractors/live-org/__tests__/wedge-isolation.test.js

@@ -0,0 +1,270 @@
+import { describe, expect, it } from "vitest";
+import { __testing as bulkRetrieveTesting } from "../bulk-retrieve.js";
+/**
+ * Phase 1.5 W1.5-01 + W1.5-02 unit tests.
+ *
+ * Contract under test:
+ *   - The watchdog clock for a `failSoft`-wrapped source starts at SLOT
+ *     ACQUISITION (body-entry of the wrapped async generator), not at
+ *     source REGISTRATION. A wedged source must not consume the clock
+ *     budget of queued-but-not-yet-executing neighbors.
+ *   - When the watchdog fires for a wedged source, the merger's slot is
+ *     released within ~one tick (the failSoft generator returns,
+ *     mergeAsyncIterablesParallel sees `done:true`, advance(nextIdx) runs).
+ *   - A namespaced warning is emitted into the shared `warnings` array.
+ *   - The wedged iterator is parked into a background-wedge set; if it
+ *     eventually yields, the record reaches the output stream with
+ *     `attributes.lateYield === true`.
+ *   - The background-wedge set is bounded by SFGRAPH_MAX_BACKGROUND_WEDGES.
+ *     When the cap is exceeded, the oldest entry's stopWaiting flag is
+ *     set and a `wedge:cap:backgroundWedgeAborted:...` warning fires.
+ *
+ * Tests run against `bulkRetrieve` end-to-end with a mock connection that
+ * causes specific sources to wedge. Real timers are used (not fake) so
+ * the watchdog's setTimeout interacts with real iterator promises; budgets
+ * are squeezed via env vars to keep the suite fast.
+ *
+ * Note on backgrounds-wedge cap test (test 3): the production cap is 4 by
+ * default; we set it to 2 via env var at module import time. We do NOT
+ * use vi.useFakeTimers() because the watchdog is implemented with real
+ * setTimeout — fake timers would prevent the iterator-vs-timeout race
+ * from advancing and the test would hang.
+ */
+/** Async generator: never yields, never resolves. Used as a wedge factory. */
+async function* hangForever() {
+    await new Promise(() => {
+        /* hang */
+    });
+    yield {
+        ref: {
+            category: "ApexClass",
+            memberType: "ApexClass",
+            memberName: "Never",
+            lastModifiedAt: null,
+            sourceUri: "",
+        },
+        content: "",
+    };
+}
+/** Async generator: hangs for `wedgeMs` ms then yields one record, then
+ *  ends. Used to simulate a source that eventually resolves AFTER the
+ *  watchdog has already released its slot — the late-yield case. */
+function delayedYield(wedgeMs, memberName) {
+    return async function* () {
+        await new Promise((r) => setTimeout(r, wedgeMs));
+        yield {
+            ref: {
+                category: "ApexClass",
+                memberType: "ApexClass",
+                memberName,
+                lastModifiedAt: null,
+                sourceUri: "",
+            },
+            content: "",
+        };
+    };
+}
+/** Async generator: yields N synthetic ApexClass records back-to-back, then
+ *  ends. Used as a healthy neighbor source. */
+function healthySource(count, prefix) {
+    return async function* () {
+        for (let i = 0; i < count; i += 1) {
+            yield {
+                ref: {
+                    category: "ApexClass",
+                    memberType: "ApexClass",
+                    memberName: `${prefix}-${i}`,
+                    lastModifiedAt: null,
+                    sourceUri: "",
+                },
+                content: "",
+            };
+        }
+    };
+}
+describe("W1.5-01: watchdog clock starts at slot acquisition", () => {
+    it("does not advance clock for queued sources while a wedged source holds its slot", async () => {
+        // Setup: 2 sources, concurrency=1 (set via env), source A wedges,
+        // source B is queued. Watchdog firstYield budget is 200ms (test-only
+        // tight budget). Expectation: source B starts EXECUTING only after
+        // A's slot is released by the watchdog. B's own clock starts at that
+        // moment, NOT 200ms earlier when the merger was registered.
+        const warnings = [];
+        const sourceALabel = "test:A";
+        const sourceBLabel = "test:B";
+        const aStartRef = { value: 0 };
+        const bStartRef = { value: 0 };
+        // failSoft is not exported; use the testing entry point.
+        const merger = bulkRetrieveTesting.mergeAsyncIterablesParallel;
+        const failSoft = bulkRetrieveTesting.failSoft;
+        const makeCoordinator = bulkRetrieveTesting.createWedgeCoordinator;
+        const coordinator = makeCoordinator(warnings);
+        // Tight test budget: 150ms first-yield.
+        bulkRetrieveTesting.setTestWatchdogBudgets({ firstYieldMs: 150, inactivityMs: 60_000 });
+        try {
+            // Concurrency=1 so B has to wait for A's slot.
+            const sources = [
+                failSoft(sourceALabel, hangForever, undefined, coordinator, aStartRef),
+                failSoft(sourceBLabel, healthySource(2, "B"), undefined, coordinator, bStartRef),
+            ];
+            const start = Date.now();
+            const out = [];
+            // Override concurrency via the merger's optional second arg (test
+            // hook): pass concurrency=1.
+            for await (const m of merger(sources, { concurrency: 1 })) {
+                out.push(m);
+            }
+            const elapsed = Date.now() - start;
+            // B's records should all be present (source A wedged, source B drained).
+            const bNames = out.map((m) => m.ref.memberName).filter((n) => n.startsWith("B-"));
+            expect(bNames.sort()).toEqual(["B-0", "B-1"]);
+            // Source A's clock should have started near `start` (it acquired the
+            // slot first).
+            expect(aStartRef.value).toBeGreaterThanOrEqual(start);
+            expect(aStartRef.value).toBeLessThan(start + 80);
+            // Source B's clock should have started AFTER A's watchdog fired —
+            // i.e., at least 150ms (firstYield budget) after A's start. NOT at
+            // registration time (which is `start`).
+            expect(bStartRef.value).toBeGreaterThanOrEqual(aStartRef.value + 140);
+            // Total elapsed: A wedges (~150ms) + B drains (~0ms) = ~150-300ms.
+            expect(elapsed).toBeLessThan(800);
+            // Exactly one wedge:test:A:firstYield:... warning fired.
+            const aWedges = warnings.filter((w) => w.startsWith(`wedge:${sourceALabel}:firstYield:`));
+            expect(aWedges.length).toBe(1);
+        }
+        finally {
+            bulkRetrieveTesting.resetTestWatchdogBudgets();
+        }
+    });
+});
+describe("W1.5-02: soft-isolate on wedge", () => {
+    it("releases slot, emits namespaced warning, runs queued neighbor", async () => {
+        const warnings = [];
+        const coordinator = bulkRetrieveTesting.createWedgeCoordinator(warnings);
+        bulkRetrieveTesting.setTestWatchdogBudgets({ firstYieldMs: 100, inactivityMs: 60_000 });
+        try {
+            const sources = [
+                bulkRetrieveTesting.failSoft("wedger", hangForever, undefined, coordinator),
+                bulkRetrieveTesting.failSoft("healthy", healthySource(3, "H"), undefined, coordinator),
+            ];
+            const out = [];
+            for await (const m of bulkRetrieveTesting.mergeAsyncIterablesParallel(sources, {
+                concurrency: 1,
+            })) {
+                out.push(m);
+            }
+            // Healthy source drained completely.
+            const hCount = out.filter((m) => m.ref.memberName.startsWith("H-")).length;
+            expect(hCount).toBe(3);
+            // Exactly one wedge warning emitted with the right shape.
+            const w = warnings.find((s) => s.startsWith("wedge:wedger:firstYield:"));
+            expect(w).toBeTruthy();
+            // <stageDetail> is `${firstYieldMs/1000}s`; with a 100ms test budget
+            // that's `0.1s` — the regex must accept decimals.
+            expect(w).toMatch(/^wedge:wedger:firstYield:[\d.]+s:lastYielded=<none>:wedgedForMs=\d+$/);
+            // No error propagated up — for-await completed normally.
+        }
+        finally {
+            bulkRetrieveTesting.resetTestWatchdogBudgets();
+        }
+    });
+});
+describe("W1.5-02: background-wedge cap", () => {
+    it("sets stopWaiting=true on oldest entries when SFGRAPH_MAX_BACKGROUND_WEDGES is exceeded", async () => {
+        const warnings = [];
+        // Override the cap to 2 via the test-only setter.
+        const coordinator = bulkRetrieveTesting.createWedgeCoordinator(warnings, {
+            maxBackgroundWedges: 2,
+        });
+        bulkRetrieveTesting.setTestWatchdogBudgets({ firstYieldMs: 80, inactivityMs: 60_000 });
+        try {
+            // 4 wedging sources. With concurrency=1 they wedge sequentially:
+            // - W1 wedges at ~80ms (slot released, registered as bg-wedge #1)
+            // - W2 acquires slot, wedges at ~160ms (bg-wedge #2; cap not exceeded)
+            // - W3 acquires slot, wedges at ~240ms (would be bg-wedge #3, cap=2,
+            //   so W1 evicted with stopWaiting=true)
+            // - W4 acquires slot, wedges at ~320ms (would be bg-wedge #4, cap=2,
+            //   so W2 evicted with stopWaiting=true)
+            const sources = [
+                bulkRetrieveTesting.failSoft("w1", hangForever, undefined, coordinator),
+                bulkRetrieveTesting.failSoft("w2", hangForever, undefined, coordinator),
+                bulkRetrieveTesting.failSoft("w3", hangForever, undefined, coordinator),
+                bulkRetrieveTesting.failSoft("w4", hangForever, undefined, coordinator),
+            ];
+            const out = [];
+            // Set the late-drain budget to 0 — we don't want to wait at the end.
+            coordinator.lateDrainBudgetMs = 0;
+            for await (const m of bulkRetrieveTesting.mergeAsyncIterablesParallel(sources, {
+                concurrency: 1,
+            })) {
+                out.push(m);
+            }
+            expect(out.length).toBe(0);
+            expect(coordinator.backgroundWedges.length).toBe(4);
+            // Find each entry by label.
+            const byLabel = new Map(coordinator.backgroundWedges.map((e) => [e.label, e]));
+            // Cap=2, with 4 wedges admitted in sequence: at the moment W3 is
+            // admitted the active count would become 3; oldest (W1) is evicted.
+            // When W4 is admitted the active count would become 3 again
+            // (W2 + W3 + W4); oldest active (W2) is evicted.
+            expect(byLabel.get("w1")?.stopWaitingRef.value).toBe(true);
+            expect(byLabel.get("w2")?.stopWaitingRef.value).toBe(true);
+            expect(byLabel.get("w3")?.stopWaitingRef.value).toBe(false);
+            expect(byLabel.get("w4")?.stopWaitingRef.value).toBe(false);
+            // Exactly 2 backgroundWedgeAborted warnings — one per eviction.
+            const aborts = warnings.filter((w) => w.startsWith("wedge:cap:backgroundWedgeAborted:"));
+            expect(aborts.length).toBe(2);
+            // First eviction names w1; second names w2.
+            expect(aborts[0]).toContain("source=w1");
+            expect(aborts[1]).toContain("source=w2");
+        }
+        finally {
+            bulkRetrieveTesting.resetTestWatchdogBudgets();
+        }
+    });
+});
+describe("W1.5-02: late-yield drain", () => {
+    it("drains late records with attributes.lateYield=true and emits resolvedLate warning", async () => {
+        const warnings = [];
+        const coordinator = bulkRetrieveTesting.createWedgeCoordinator(warnings);
+        // Late-drain budget: 600ms — generous enough to catch the delayed yield.
+        coordinator.lateDrainBudgetMs = 600;
+        bulkRetrieveTesting.setTestWatchdogBudgets({ firstYieldMs: 100, inactivityMs: 60_000 });
+        try {
+            // Wedger first-yields after 250ms — well past the 100ms watchdog —
+            // so it gets parked into background. The late-drain should observe
+            // its first record arriving and tag it.
+            const sources = [
+                bulkRetrieveTesting.failSoft("tardy", delayedYield(250, "T-late"), undefined, coordinator),
+                bulkRetrieveTesting.failSoft("fast", healthySource(1, "F"), undefined, coordinator),
+            ];
+            const out = [];
+            for await (const m of bulkRetrieveTesting.mergeAsyncIterablesParallel(sources, {
+                concurrency: 1,
+            })) {
+                out.push(m);
+            }
+            // The drainBackgroundWedge pass happens inside bulkRetrieve, not the
+            // merger. The merger test here doesn't run that pass — invoke it
+            // explicitly via the testing handle.
+            for (const entry of coordinator.backgroundWedges) {
+                for await (const m of bulkRetrieveTesting.drainBackgroundWedge(entry, coordinator.lateDrainBudgetMs, coordinator.warnings)) {
+                    out.push(m);
+                }
+            }
+            // Fast source's record is present, plus the late record with the tag.
+            const lateRecord = out.find((m) => m.ref.memberName === "T-late");
+            expect(lateRecord).toBeTruthy();
+            expect(lateRecord?.attributes?.lateYield).toBe(true);
+            // resolvedLate warning emitted.
+            const resolved = warnings.find((w) => w.startsWith("wedge:tardy:resolvedLate:"));
+            expect(resolved).toBeTruthy();
+            expect(resolved).toContain("records=1");
+            // No error propagated.
+        }
+        finally {
+            bulkRetrieveTesting.resetTestWatchdogBudgets();
+        }
+    });
+});
+//# sourceMappingURL=wedge-isolation.test.js.map

package/dist/extractors/live-org/__tests__/wedge-isolation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wedge-isolation.test.js","sourceRoot":"","sources":["../../../../src/extractors/live-org/__tests__/wedge-isolation.test.ts"],"names":[],"mappings":"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"}

package/dist/extractors/live-org/bulk-retrieve.d.ts

@@ -12,6 +12,70 @@ export interface IngestSkipReport {
         category: SkipCategory;
     }>;
 }
+/**
+ * Phase 1.5 (W1.5-02): soft-isolate wedge coordination state.
+ *
+ * Threaded through the bulkRetrieve fan-out so `failSoft` wrappers can:
+ *   (a) push namespaced-string warnings into a shared sink (the warnings
+ *       eventually surface on LiveIngestResult.warnings),
+ *   (b) park the still-pending iterator from a wedged source into a bounded
+ *       background-wedge set (the merger's slot is released immediately,
+ *       so queued neighbors can proceed),
+ *   (c) yield late-arriving records from those background iterators with
+ *       `attributes.lateYield = true` so they still reach the output stream.
+ *
+ * One coordinator instance per bulkRetrieve invocation. Default sourced
+ * from `SFGRAPH_MAX_BACKGROUND_WEDGES` (default 4).
+ */
+export interface BackgroundWedgeEntry {
+    label: string;
+    /** Iterator that was wedged. Used by the late-drain loop to keep pumping
+     *  it after slot release. */
+    iterator: AsyncIterator<RawMember>;
+    /**
+     * The in-flight `it.next()` promise that was racing the watchdog at the
+     * moment the watchdog won. Async-generator semantics queue concurrent
+     * `.next()` calls — so if the drain loop calls `iterator.next()` while
+     * this promise is still pending, the drain will wait behind it AND
+     * "lose" the value it eventually resolves with (the first `.next()` gets
+     * it, then the drain's `.next()` advances to the NEXT yield). We must
+     * therefore consume this promise BEFORE calling `iterator.next()` again
+     * in the drain loop. After the drain consumes the first pending result,
+     * this field is set to null and subsequent calls go through the normal
+     * `iterator.next()` path.
+     */
+    pendingFirstNext: Promise<IteratorResult<RawMember>> | null;
+    /** Wall-clock epoch when this entry was registered (post slot-release). */
+    registeredAt: number;
+    /** Set true when the cap-eviction policy decides this wedge has outlived
+     *  its budget. The drain loop checks this each iteration and bails. The
+     *  pending HTTP request (if any) is NOT actively cancelled — that's the
+     *  job of W1.5-03. */
+    stopWaitingRef: {
+        value: boolean;
+    };
+}
+export interface WedgeCoordinator {
+    /** Shared namespaced-warning sink. Format documented in PLAN.md:
+     *  `wedge:<source>:<stage>:<detail>`. The warning strings reach the
+     *  surface via `bulkRetrieve` opts → `LiveIngestResult.warnings`. */
+    warnings: string[];
+    /** Active background-wedge set. Bounded by `maxBackgroundWedges`. When
+     *  a new wedge would exceed the cap, the OLDEST entry gets its
+     *  `stopWaitingRef.value = true` flag set + a `backgroundWedgeAborted`
+     *  warning is emitted. The old iterator is NOT removed from the set —
+     *  the late-drain loop sees the flag and bails. */
+    backgroundWedges: BackgroundWedgeEntry[];
+    /** Maximum simultaneous active background wedges. From
+     *  `SFGRAPH_MAX_BACKGROUND_WEDGES`, default 4. */
+    maxBackgroundWedges: number;
+    /** Bounded wall-clock budget for the post-merger late-drain pass. The
+     *  drain races each pending `it.next()` against this budget; whatever
+     *  arrives gets `attributes.lateYield = true`. Default 60 000ms; set to
+     *  0 to disable late-drain entirely (used by some tests). */
+    lateDrainBudgetMs: number;
+}
+declare function createWedgeCoordinator(warnings?: string[], overrides?: Partial<Pick<WedgeCoordinator, "maxBackgroundWedges" | "lateDrainBudgetMs">>): WedgeCoordinator;
 export type SkipCategory = "insufficient_access" | "not_found" | "rate_limit" | "network" | "unknown";
 /** Naive sequential merge — predictable order, simpler back-pressure semantics.
  *  Kept for back-compat and tests; production ingest uses
@@ -38,7 +102,71 @@ export declare function mergeAsyncIterables<T>(...iters: Array<AsyncIterable<T>>
  * Output ordering is non-deterministic. `live-ingest`'s processOne is
  * order-independent (idempotent per-record upserts), so this is safe.
  */
+export interface MergeParallelOptions {
+    /** Override the sliding-window size for this call. When omitted, the
+     *  env-var / default path applies as before. Used by unit tests that
+     *  need deterministic queue-vs-active ordering. */
+    concurrency?: number;
+}
 export declare function mergeAsyncIterablesParallel<T>(...iters: Array<AsyncIterable<T>>): AsyncIterable<T>;
+export declare function mergeAsyncIterablesParallel<T>(iters: Array<AsyncIterable<T>>, opts: MergeParallelOptions): AsyncIterable<T>;
+/** Read watchdog budgets per-call so unit tests can override via env vars
+ *  without restarting the process. Production env should leave these unset:
+ *  ordinary sources get the documented 90s first-yield / 5min inactivity;
+ *  a source in SOURCE_WATCHDOG_OVERRIDES gets its scoped budget instead. */
+declare function readWatchdogBudgets(label?: string): {
+    firstYieldMs: number;
+    inactivityMs: number;
+};
+/**
+ * Drain a single background-wedge iterator. Called once per wedged source,
+ * post-merger, with a wall-clock budget. Each iteration races the iterator's
+ * `it.next()` against the remaining budget. Records arriving inside the
+ * budget are yielded with `attributes.lateYield = true`. The pending HTTP
+ * request (if the wedge is on a network call) is NOT actively cancelled
+ * (W1.5-03's job); we just stop awaiting it.
+ *
+ * Bails immediately if `stopWaitingRef.value === true` (cap eviction).
+ */
+declare function drainBackgroundWedge(entry: BackgroundWedgeEntry, budgetMs: number, warnings: string[]): AsyncIterable<RawMember>;
+/**
+ * Wrap an iterable so a thrown error is captured + the stream ends cleanly
+ * instead of aborting the whole ingest. The error is recorded into a
+ * shared skip report (consumed at end-of-run) and a compact ✗ line is
+ * printed so the user sees something happened without the full error
+ * message scrolling past during the run.
+ *
+ * Phase 1.5 W1.5-01 + W1.5-02 contract:
+ *
+ *  - The watchdog clock starts when this generator's BODY first executes
+ *    (i.e., when the merger calls `.next()` on us for the first time —
+ *    that's slot-acquisition time). Queued sources still inside
+ *    `mergeAsyncIterablesParallel`'s waiting list accumulate ZERO clock
+ *    time. Implemented via an internal `startedAtRef` that's written once
+ *    on body entry; if the caller passes a `startedAtRef` we update it in
+ *    place so the merger can observe the slot-acquisition moment.
+ *
+ *  - On watchdog fire, we DO NOT throw (which would abort the merger's
+ *    Promise.race for our slot AND lose the still-pending iterator).
+ *    Instead we:
+ *       1. Emit a `wedge:<label>:firstYield:90s:...` (or `:inactivity:300s:`)
+ *          warning into coordinator.warnings.
+ *       2. Register the still-pending iterator into coordinator.background
+ *          Wedges with a stopWaitingRef. Enforce the cap (evict oldest).
+ *       3. RETURN from the generator. This cleanly releases the merger's
+ *          slot — `pending.delete(idx)` runs in mergeAsyncIterablesParallel
+ *          and the next queued source acquires the slot.
+ *    Post-merger, the bulkRetrieve top-level fan-out drains the background
+ *    wedge set; records arriving inside the late-drain budget are yielded
+ *    with `attributes.lateYield = true`.
+ */
+declare function failSoft<T extends RawMember>(label: string, factory: () => AsyncIterable<T>, onError?: (label: string, err: Error) => void, coordinator?: WedgeCoordinator, 
+/** Optional outer-visible clock cell. The merger does not currently read
+ *  this, but the contract is "set by failSoft on body entry"; tests use
+ *  it to assert slot-acquisition timing. */
+startedAtRef?: {
+    value: number;
+}): AsyncIterable<T>;
 export interface BulkRetrieveOpts {
     skipReport?: IngestSkipReport;
     /** When set, only invoke source labels in this set. Labels are the same
@@ -46,6 +174,54 @@ export interface BulkRetrieveOpts {
      *  'security', 'integration', 'vlocity', 'omnistudio', or
      *  'generic:<MetadataType>' for the long tail. */
     onlyLabels?: Set<string>;
+    /** Opt-in: invoke the OmniStudio-on-Core retrieve() extractor in addition
+     *  to the existing SOQL path. Default off — retrieve() consumes Metadata
+     *  API quota (10k/24h) and is slower; only enable when the higher-fidelity
+     *  XML envelope is actually needed by a downstream parser. */
+    enableOmnistudioRetrieve?: boolean;
+    /** API version string for the retrieve() request envelope. */
+    apiVersion?: string;
+    /**
+     * Phase 1.5 W1.5-02 warning sink. When provided, the watchdog soft-isolate
+     * path pushes namespaced wedge strings (`wedge:<source>:<stage>:...`) into
+     * this array. The caller (live-ingest) concatenates them onto
+     * LiveIngestResult.warnings. When omitted, wedge events fall through to
+     * the legacy `onSkip` / skipReport path so existing tests still see a
+     * skip entry.
+     */
+    warnings?: string[];
 }
 export declare function bulkRetrieve(conn: any, caps: OrgCapabilities, orgId: OrgId, opts?: BulkRetrieveOpts | IngestSkipReport): AsyncIterable<RawMember>;
+/**
+ * Internal-surface exports for unit tests in `__tests__/`. Not part of the
+ * public package API — these are intentionally namespaced under `__testing`
+ * so they don't appear in the package's exports surface to downstream
+ * consumers. (They're still importable, but the underscore convention
+ * signals "test only".)
+ *
+ * Exposed:
+ *   - `failSoft`: wrap an iterable with the W1.5-01/02 watchdog + soft-isolate.
+ *   - `createWedgeCoordinator`: build a coordinator + warnings sink with
+ *      optional cap/drain overrides for deterministic tests.
+ *   - `drainBackgroundWedge`: run the post-merger late-drain pass against
+ *      a single background-wedge entry.
+ *   - `mergeAsyncIterablesParallel`: re-export for symmetry; the (array,
+ *      opts) overload is what tests use to fix concurrency.
+ *   - `setTestWatchdogBudgets` / `resetTestWatchdogBudgets`: env-var-backed
+ *      knobs to squeeze the watchdog budget for fast tests. Always paired
+ *      via try/finally in tests so the environment is left clean.
+ */
+export declare const __testing: {
+    failSoft: typeof failSoft;
+    createWedgeCoordinator: typeof createWedgeCoordinator;
+    drainBackgroundWedge: typeof drainBackgroundWedge;
+    mergeAsyncIterablesParallel: typeof mergeAsyncIterablesParallel;
+    readWatchdogBudgets: typeof readWatchdogBudgets;
+    setTestWatchdogBudgets(opts: {
+        firstYieldMs: number;
+        inactivityMs: number;
+    }): void;
+    resetTestWatchdogBudgets(): void;
+};
+export {};
 //# sourceMappingURL=bulk-retrieve.d.ts.map

package/dist/extractors/live-org/bulk-retrieve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bulk-retrieve.d.ts","sourceRoot":"","sources":["../../../src/extractors/live-org/bulk-retrieve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAazD;;;wCAGwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;CACzE;AAED,MAAM,MAAM,YAAY,GACpB,qBAAqB,GACrB,WAAW,GACX,YAAY,GACZ,SAAS,GACT,SAAS,CAAC;AAgBd;;;4EAG4E;AAC5E,wBAAuB,mBAAmB,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAIjG;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAuB,2BAA2B,CAAC,CAAC,EAClD,GAAG,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAChC,aAAa,CAAC,CAAC,CAAC,CA+ClB;AAuND,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;;sDAGkD;IAClD,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED,wBAAuB,YAAY,CACjC,IAAI,EAAE,GAAG,EACT,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,KAAK,EACZ,IAAI,GAAE,gBAAgB,GAAG,gBAAqB,GAC7C,aAAa,CAAC,SAAS,CAAC,CAiH1B"}
+{"version":3,"file":"bulk-retrieve.d.ts","sourceRoot":"","sources":["../../../src/extractors/live-org/bulk-retrieve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAezD;;;wCAGwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;CACzE;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd;iCAC6B;IAC7B,QAAQ,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACnC;;;;;;;;;;;OAWG;IACH,gBAAgB,EAAE,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC;IAC5D,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;IACrB;;;0BAGsB;IACtB,cAAc,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B;;yEAEqE;IACrE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;uDAImD;IACnD,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;IACzC;sDACkD;IAClD,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;iEAG6D;IAC7D,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,iBAAS,sBAAsB,CAC7B,QAAQ,GAAE,MAAM,EAAO,EACvB,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,qBAAqB,GAAG,mBAAmB,CAAC,CAAC,GACvF,gBAAgB,CAoBlB;AAED,MAAM,MAAM,YAAY,GACpB,qBAAqB,GACrB,WAAW,GACX,YAAY,GACZ,SAAS,GACT,SAAS,CAAC;AAgBd;;;4EAG4E;AAC5E,wBAAuB,mBAAmB,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAIjG;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,oBAAoB;IACnC;;uDAEmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AACpG,wBAAgB,2BAA2B,CAAC,CAAC,EAC3C,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAC9B,IAAI,EAAE,oBAAoB,GACzB,aAAa,CAAC,CAAC,CAAC,CAAC;AA0HpB;;;4EAG4E;AAC5E,iBAAS,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAc3F;AAgDD;;;;;;;;;GASG;AACH,iBAAgB,oBAAoB,CAClC,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,GACjB,aAAa,CAAC,SAAS,CAAC,CAiE1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,iBAAgB,QAAQ,CAAC,CAAC,SAAS,SAAS,EAC1C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,aAAa,CAAC,CAAC,CAAC,EAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,KAAK,IAAI,EAC7C,WAAW,CAAC,EAAE,gBAAgB;AAC9B;;4CAE4C;AAC5C,YAAY,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B,aAAa,CAAC,CAAC,CAAC,CA2JlB;AA+ID,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;;sDAGkD;IAClD,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB;;;kEAG8D;IAC9D,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAuB,YAAY,CACjC,IAAI,EAAE,GAAG,EACT,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,KAAK,EACZ,IAAI,GAAE,gBAAgB,GAAG,gBAAqB,GAC7C,aAAa,CAAC,SAAS,CAAC,CAsM1B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,SAAS;;;;;;iCAMS;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;gCAItD,IAAI;CASjC,CAAC"}