@workflow/core 5.0.0-beta.35 → 5.0.0-beta.37

package/dist/step-hydration-cache.d.ts

@@ -1,148 +0,0 @@
-/**
- * Per-run memoization cache for hydrated step return values.
- *
- * ## Why
- *
- * The inline replay loop (`runtime.ts`) re-runs the workflow body from the top
- * on every iteration, re-consuming the full event log each time. For every
- * already-completed step, the step consumer (`step.ts`) re-runs
- * `hydrateStepReturnValue` — which AES-GCM-decrypts and devalue-parses the
- * serialized result — even though that exact result was already hydrated on
- * every prior replay. For a sequential workflow of N steps, replay K hydrates
- * K results, so the total work across a single invocation is O(N²)
- * decrypt+parse operations.
- *
- * This cache makes a completed step's hydrated result available in O(1) on
- * subsequent replays within the SAME invocation, turning the aggregate cost
- * into O(N).
- *
- * ## Scope / lifetime
- *
- * The cache is owned by the inline loop in `runtime.ts` (one per workflow run
- * invocation) and passed into `runWorkflow` so it survives across the loop's
- * iterations but never leaks across unrelated runs or process-level
- * invocations. A fresh `runWorkflow` / `WorkflowOrchestratorContext` is created
- * each iteration, so the cache must live OUTSIDE the per-iteration context.
- *
- * ## Keying
- *
- * Entries are keyed by the persisted event's `eventId` — a stable,
- * world-assigned identifier for the `step_completed` event whose serialized
- * `result` is being hydrated. The same event (same `eventId`) carries the same
- * immutable serialized bytes across every replay, so a hit is guaranteed to
- * correspond to the identical input.
- *
- * ## Identity safety (why primitives only)
- *
- * `hydrateStepReturnValue` (devalue.parse) produces a FRESH object graph on
- * every call, and each replay iteration runs in a FRESH workflow VM. The
- * current (uncached) behavior therefore hands the workflow a brand-new value
- * on every replay. If we cached and returned the SAME object reference across
- * replays, workflow code that mutates a step result (`const r = await step();
- * r.count++`) would observe the mutation from a previous replay on the next
- * replay — a non-deterministic divergence. Structured-cloning on each hit is
- * both lossy (revivers reconstruct stream handles, step-function proxies,
- * Request/Response, and AbortController/AbortSignal class instances that don't
- * survive a structured clone) and still O(size).
- *
- * So we only cache values for which returning the same reference on every
- * replay is provably indistinguishable from re-hydrating: JavaScript
- * primitives (string, number, boolean, bigint, symbol, null, undefined).
- * Primitives are immutable and compared by value, so sharing the reference is
- * byte-for-byte equivalent to re-parsing. Any non-primitive result falls
- * through to a full re-hydrate every replay, preserving current behavior
- * exactly. This trades some of the optimization away in the object-returning
- * case in exchange for keeping deterministic replay airtight.
- *
- * ## Memory characteristic
- *
- * Cached entries hold the decrypted/devalue-parsed *plaintext* of a step
- * result, which is retained for the rest of the invocation on top of the
- * serialized bytes already held in `cachedEvents`. So the residual cost is:
- *
- * - **Scoped to one workflow-run invocation.** A fresh `Map` is created per
- *   invocation (in `runtime.ts`) and is unreachable / GC'd when the invocation
- *   returns. Nothing accumulates across runs or across process-level
- *   invocations.
- * - **Bounded by the number of primitive-returning completed steps in that
- *   run** — at most one small entry per such step.
- * - **Primitives only, and additionally byte-bounded.** Most primitives
- *   (numbers, booleans, null/undefined, symbols, short ids/strings) are tiny
- *   and fixed-size. The only primitive that can be large is a string (or a
- *   pathologically long bigint), so to keep the doubled-residency worst case
- *   bounded we *do not* memoize string/bigint results whose character length
- *   exceeds {@link MAX_MEMOIZED_PRIMITIVE_LENGTH}. A large string is cheap to
- *   re-hydrate relative to its footprint, so letting it fall through to the
- *   existing per-replay re-hydrate path costs little and caps peak retained
- *   memory.
- *
- * (This is a much weaker concern than a *process-wide* cache: the dominant
- * residency — the full event log in `cachedEvents` — already exists for the
- * same lifetime, and everything here is freed together with it when the
- * invocation ends.)
- */
-/**
- * Upper bound, in characters, on a string/bigint primitive that may be
- * memoized. Beyond this, the value falls through to a fresh re-hydrate on every
- * replay so the cache never holds a large plaintext payload for the lifetime of
- * the invocation. 4 KiB comfortably covers ids, counts, flags, and typical
- * short string results while excluding the large-payload case the bound exists
- * to guard. Other primitive types (number, boolean, symbol, null, undefined)
- * are inherently small and are never length-checked.
- */
-export declare const MAX_MEMOIZED_PRIMITIVE_LENGTH = 4096;
-/**
- * Returns true for values that are safe to memoize and return by reference
- * across replays: JS primitives. Objects and functions are excluded because
- * sharing a mutable reference across replays could change observable behavior.
- *
- * Strings and bigints are additionally bounded by length: a value longer than
- * {@link MAX_MEMOIZED_PRIMITIVE_LENGTH} characters is treated as non-memoizable
- * so the cache never retains a large plaintext payload for the whole invocation
- * (see the module-level "Memory characteristic" docs). It re-hydrates fresh on
- * every replay instead — cheap relative to its footprint.
- *
- * Note: `typeof null === 'object'`, so it is handled explicitly. `undefined`,
- * `string`, `number`, `boolean`, `bigint`, and `symbol` are all primitives.
- */
-export declare function isMemoizablePrimitive(value: unknown): boolean;
-/**
- * Cache of hydrated step return values for a single workflow run invocation.
- *
- * Keyed by `step_completed` event id; the value is the already-hydrated
- * primitive result. Only successful, primitive hydrations are stored (see
- * {@link getOrHydrateStepReturnValue}), so a non-`undefined` `has(eventId)`
- * always means "this step completed with a memoizable primitive value".
- */
-export type StepHydrationCache = Map<string, unknown>;
-/**
- * Create an empty per-invocation step hydration cache.
- */
-export declare function createStepHydrationCache(): StepHydrationCache;
-/**
- * Return the hydrated step result for `eventId`, using `cache` as a per-run
- * memo. On a hit, the cached primitive is returned without re-running the
- * expensive decrypt + devalue-parse. On a miss, `hydrate()` runs and its
- * result is memoized only when it is a small primitive (see the module docs for
- * the identity-safety rationale and the length bound on string/bigint results).
- *
- * This always returns a `Promise` and `await`s `hydrate()` even on the miss
- * path, so the caller's `await` inside its serial `promiseQueue` slot keeps the
- * same scheduling on both hit and miss — a cache hit resolves through the exact
- * same promise-chain position a re-hydrate would have, preserving the
- * deterministic delivery order that `pendingDeliveries`, the delivery barriers,
- * and `Promise.race`/`Promise.all` replay all depend on.
- *
- * `has(eventId)` is used rather than `get(eventId) !== undefined` so that a
- * legitimately memoized `undefined` step result still registers as a hit.
- *
- * When `cache` or `eventId` is absent (lightweight test harnesses, or a context
- * that predates this plumbing), this degrades to calling `hydrate()` directly
- * with no memoization — identical to the previous behavior.
- *
- * Errors are intentionally never cached: a rejected hydrate propagates to the
- * caller (which rejects the step promise) and the next replay re-attempts it,
- * matching the uncached behavior and avoiding a parked rejected promise.
- */
-export declare function getOrHydrateStepReturnValue(cache: StepHydrationCache | undefined, eventId: string | undefined, hydrate: () => Promise<unknown>): Promise<unknown>;
-//# sourceMappingURL=step-hydration-cache.d.ts.map

package/dist/step-hydration-cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"step-hydration-cache.d.ts","sourceRoot":"","sources":["../src/step-hydration-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkFG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAY7D;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,kBAAkB,GAAG,SAAS,EACrC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAkBlB"}

package/dist/step-hydration-cache.js

@@ -1,171 +0,0 @@
-/**
- * Per-run memoization cache for hydrated step return values.
- *
- * ## Why
- *
- * The inline replay loop (`runtime.ts`) re-runs the workflow body from the top
- * on every iteration, re-consuming the full event log each time. For every
- * already-completed step, the step consumer (`step.ts`) re-runs
- * `hydrateStepReturnValue` — which AES-GCM-decrypts and devalue-parses the
- * serialized result — even though that exact result was already hydrated on
- * every prior replay. For a sequential workflow of N steps, replay K hydrates
- * K results, so the total work across a single invocation is O(N²)
- * decrypt+parse operations.
- *
- * This cache makes a completed step's hydrated result available in O(1) on
- * subsequent replays within the SAME invocation, turning the aggregate cost
- * into O(N).
- *
- * ## Scope / lifetime
- *
- * The cache is owned by the inline loop in `runtime.ts` (one per workflow run
- * invocation) and passed into `runWorkflow` so it survives across the loop's
- * iterations but never leaks across unrelated runs or process-level
- * invocations. A fresh `runWorkflow` / `WorkflowOrchestratorContext` is created
- * each iteration, so the cache must live OUTSIDE the per-iteration context.
- *
- * ## Keying
- *
- * Entries are keyed by the persisted event's `eventId` — a stable,
- * world-assigned identifier for the `step_completed` event whose serialized
- * `result` is being hydrated. The same event (same `eventId`) carries the same
- * immutable serialized bytes across every replay, so a hit is guaranteed to
- * correspond to the identical input.
- *
- * ## Identity safety (why primitives only)
- *
- * `hydrateStepReturnValue` (devalue.parse) produces a FRESH object graph on
- * every call, and each replay iteration runs in a FRESH workflow VM. The
- * current (uncached) behavior therefore hands the workflow a brand-new value
- * on every replay. If we cached and returned the SAME object reference across
- * replays, workflow code that mutates a step result (`const r = await step();
- * r.count++`) would observe the mutation from a previous replay on the next
- * replay — a non-deterministic divergence. Structured-cloning on each hit is
- * both lossy (revivers reconstruct stream handles, step-function proxies,
- * Request/Response, and AbortController/AbortSignal class instances that don't
- * survive a structured clone) and still O(size).
- *
- * So we only cache values for which returning the same reference on every
- * replay is provably indistinguishable from re-hydrating: JavaScript
- * primitives (string, number, boolean, bigint, symbol, null, undefined).
- * Primitives are immutable and compared by value, so sharing the reference is
- * byte-for-byte equivalent to re-parsing. Any non-primitive result falls
- * through to a full re-hydrate every replay, preserving current behavior
- * exactly. This trades some of the optimization away in the object-returning
- * case in exchange for keeping deterministic replay airtight.
- *
- * ## Memory characteristic
- *
- * Cached entries hold the decrypted/devalue-parsed *plaintext* of a step
- * result, which is retained for the rest of the invocation on top of the
- * serialized bytes already held in `cachedEvents`. So the residual cost is:
- *
- * - **Scoped to one workflow-run invocation.** A fresh `Map` is created per
- *   invocation (in `runtime.ts`) and is unreachable / GC'd when the invocation
- *   returns. Nothing accumulates across runs or across process-level
- *   invocations.
- * - **Bounded by the number of primitive-returning completed steps in that
- *   run** — at most one small entry per such step.
- * - **Primitives only, and additionally byte-bounded.** Most primitives
- *   (numbers, booleans, null/undefined, symbols, short ids/strings) are tiny
- *   and fixed-size. The only primitive that can be large is a string (or a
- *   pathologically long bigint), so to keep the doubled-residency worst case
- *   bounded we *do not* memoize string/bigint results whose character length
- *   exceeds {@link MAX_MEMOIZED_PRIMITIVE_LENGTH}. A large string is cheap to
- *   re-hydrate relative to its footprint, so letting it fall through to the
- *   existing per-replay re-hydrate path costs little and caps peak retained
- *   memory.
- *
- * (This is a much weaker concern than a *process-wide* cache: the dominant
- * residency — the full event log in `cachedEvents` — already exists for the
- * same lifetime, and everything here is freed together with it when the
- * invocation ends.)
- */
-/**
- * Upper bound, in characters, on a string/bigint primitive that may be
- * memoized. Beyond this, the value falls through to a fresh re-hydrate on every
- * replay so the cache never holds a large plaintext payload for the lifetime of
- * the invocation. 4 KiB comfortably covers ids, counts, flags, and typical
- * short string results while excluding the large-payload case the bound exists
- * to guard. Other primitive types (number, boolean, symbol, null, undefined)
- * are inherently small and are never length-checked.
- */
-export const MAX_MEMOIZED_PRIMITIVE_LENGTH = 4096;
-/**
- * Returns true for values that are safe to memoize and return by reference
- * across replays: JS primitives. Objects and functions are excluded because
- * sharing a mutable reference across replays could change observable behavior.
- *
- * Strings and bigints are additionally bounded by length: a value longer than
- * {@link MAX_MEMOIZED_PRIMITIVE_LENGTH} characters is treated as non-memoizable
- * so the cache never retains a large plaintext payload for the whole invocation
- * (see the module-level "Memory characteristic" docs). It re-hydrates fresh on
- * every replay instead — cheap relative to its footprint.
- *
- * Note: `typeof null === 'object'`, so it is handled explicitly. `undefined`,
- * `string`, `number`, `boolean`, `bigint`, and `symbol` are all primitives.
- */
-export function isMemoizablePrimitive(value) {
-    if (value === null)
-        return true;
-    const t = typeof value;
-    if (t === 'object' || t === 'function')
-        return false;
-    // Bound the only primitive types that can carry a large payload.
-    if (t === 'string') {
-        return value.length <= MAX_MEMOIZED_PRIMITIVE_LENGTH;
-    }
-    if (t === 'bigint') {
-        return value.toString().length <= MAX_MEMOIZED_PRIMITIVE_LENGTH;
-    }
-    return true;
-}
-/**
- * Create an empty per-invocation step hydration cache.
- */
-export function createStepHydrationCache() {
-    return new Map();
-}
-/**
- * Return the hydrated step result for `eventId`, using `cache` as a per-run
- * memo. On a hit, the cached primitive is returned without re-running the
- * expensive decrypt + devalue-parse. On a miss, `hydrate()` runs and its
- * result is memoized only when it is a small primitive (see the module docs for
- * the identity-safety rationale and the length bound on string/bigint results).
- *
- * This always returns a `Promise` and `await`s `hydrate()` even on the miss
- * path, so the caller's `await` inside its serial `promiseQueue` slot keeps the
- * same scheduling on both hit and miss — a cache hit resolves through the exact
- * same promise-chain position a re-hydrate would have, preserving the
- * deterministic delivery order that `pendingDeliveries`, the delivery barriers,
- * and `Promise.race`/`Promise.all` replay all depend on.
- *
- * `has(eventId)` is used rather than `get(eventId) !== undefined` so that a
- * legitimately memoized `undefined` step result still registers as a hit.
- *
- * When `cache` or `eventId` is absent (lightweight test harnesses, or a context
- * that predates this plumbing), this degrades to calling `hydrate()` directly
- * with no memoization — identical to the previous behavior.
- *
- * Errors are intentionally never cached: a rejected hydrate propagates to the
- * caller (which rejects the step promise) and the next replay re-attempts it,
- * matching the uncached behavior and avoiding a parked rejected promise.
- */
-export async function getOrHydrateStepReturnValue(cache, eventId, hydrate) {
-    if (!cache || eventId === undefined) {
-        return hydrate();
-    }
-    if (cache.has(eventId)) {
-        return cache.get(eventId);
-    }
-    const value = await hydrate();
-    // Only memoize values that are safe to return by reference across replays
-    // AND small enough to retain for the invocation. Non-primitives and
-    // oversized string/bigint values fall through and are re-hydrated fresh on
-    // every replay (see isMemoizablePrimitive / MAX_MEMOIZED_PRIMITIVE_LENGTH).
-    if (isMemoizablePrimitive(value)) {
-        cache.set(eventId, value);
-    }
-    return value;
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RlcC1oeWRyYXRpb24tY2FjaGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvc3RlcC1oeWRyYXRpb24tY2FjaGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FrRkc7QUFFSDs7Ozs7Ozs7R0FRRztBQUNILE1BQU0sQ0FBQyxNQUFNLDZCQUE2QixHQUFHLElBQUksQ0FBQztBQUVsRDs7Ozs7Ozs7Ozs7OztHQWFHO0FBQ0gsTUFBTSxVQUFVLHFCQUFxQixDQUFDLEtBQWM7SUFDbEQsSUFBSSxLQUFLLEtBQUssSUFBSTtRQUFFLE9BQU8sSUFBSSxDQUFDO0lBQ2hDLE1BQU0sQ0FBQyxHQUFHLE9BQU8sS0FBSyxDQUFDO0lBQ3ZCLElBQUksQ0FBQyxLQUFLLFFBQVEsSUFBSSxDQUFDLEtBQUssVUFBVTtRQUFFLE9BQU8sS0FBSyxDQUFDO0lBQ3JELGlFQUFpRTtJQUNqRSxJQUFJLENBQUMsS0FBSyxRQUFRLEVBQUUsQ0FBQztRQUNuQixPQUFRLEtBQWdCLENBQUMsTUFBTSxJQUFJLDZCQUE2QixDQUFDO0lBQ25FLENBQUM7SUFDRCxJQUFJLENBQUMsS0FBSyxRQUFRLEVBQUUsQ0FBQztRQUNuQixPQUFRLEtBQWdCLENBQUMsUUFBUSxFQUFFLENBQUMsTUFBTSxJQUFJLDZCQUE2QixDQUFDO0lBQzlFLENBQUM7SUFDRCxPQUFPLElBQUksQ0FBQztBQUNkLENBQUM7QUFZRDs7R0FFRztBQUNILE1BQU0sVUFBVSx3QkFBd0I7SUFDdEMsT0FBTyxJQUFJLEdBQUcsRUFBRSxDQUFDO0FBQ25CLENBQUM7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBd0JHO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSwyQkFBMkIsQ0FDL0MsS0FBcUMsRUFDckMsT0FBMkIsRUFDM0IsT0FBK0I7SUFFL0IsSUFBSSxDQUFDLEtBQUssSUFBSSxPQUFPLEtBQUssU0FBUyxFQUFFLENBQUM7UUFDcEMsT0FBTyxPQUFPLEVBQUUsQ0FBQztJQUNuQixDQUFDO0lBRUQsSUFBSSxLQUFLLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUM7UUFDdkIsT0FBTyxLQUFLLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQzVCLENBQUM7SUFFRCxNQUFNLEtBQUssR0FBRyxNQUFNLE9BQU8sRUFBRSxDQUFDO0lBQzlCLDBFQUEwRTtJQUMxRSxvRUFBb0U7SUFDcEUsMkVBQTJFO0lBQzNFLDRFQUE0RTtJQUM1RSxJQUFJLHFCQUFxQixDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDakMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxPQUFPLEVBQUUsS0FBSyxDQUFDLENBQUM7SUFDNUIsQ0FBQztJQUNELE9BQU8sS0FBSyxDQUFDO0FBQ2YsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogUGVyLXJ1biBtZW1vaXphdGlvbiBjYWNoZSBmb3IgaHlkcmF0ZWQgc3RlcCByZXR1cm4gdmFsdWVzLlxuICpcbiAqICMjIFdoeVxuICpcbiAqIFRoZSBpbmxpbmUgcmVwbGF5IGxvb3AgKGBydW50aW1lLnRzYCkgcmUtcnVucyB0aGUgd29ya2Zsb3cgYm9keSBmcm9tIHRoZSB0b3BcbiAqIG9uIGV2ZXJ5IGl0ZXJhdGlvbiwgcmUtY29uc3VtaW5nIHRoZSBmdWxsIGV2ZW50IGxvZyBlYWNoIHRpbWUuIEZvciBldmVyeVxuICogYWxyZWFkeS1jb21wbGV0ZWQgc3RlcCwgdGhlIHN0ZXAgY29uc3VtZXIgKGBzdGVwLnRzYCkgcmUtcnVuc1xuICogYGh5ZHJhdGVTdGVwUmV0dXJuVmFsdWVgIOKAlCB3aGljaCBBRVMtR0NNLWRlY3J5cHRzIGFuZCBkZXZhbHVlLXBhcnNlcyB0aGVcbiAqIHNlcmlhbGl6ZWQgcmVzdWx0IOKAlCBldmVuIHRob3VnaCB0aGF0IGV4YWN0IHJlc3VsdCB3YXMgYWxyZWFkeSBoeWRyYXRlZCBvblxuICogZXZlcnkgcHJpb3IgcmVwbGF5LiBGb3IgYSBzZXF1ZW50aWFsIHdvcmtmbG93IG9mIE4gc3RlcHMsIHJlcGxheSBLIGh5ZHJhdGVzXG4gKiBLIHJlc3VsdHMsIHNvIHRoZSB0b3RhbCB3b3JrIGFjcm9zcyBhIHNpbmdsZSBpbnZvY2F0aW9uIGlzIE8oTsKyKVxuICogZGVjcnlwdCtwYXJzZSBvcGVyYXRpb25zLlxuICpcbiAqIFRoaXMgY2FjaGUgbWFrZXMgYSBjb21wbGV0ZWQgc3RlcCdzIGh5ZHJhdGVkIHJlc3VsdCBhdmFpbGFibGUgaW4gTygxKSBvblxuICogc3Vic2VxdWVudCByZXBsYXlzIHdpdGhpbiB0aGUgU0FNRSBpbnZvY2F0aW9uLCB0dXJuaW5nIHRoZSBhZ2dyZWdhdGUgY29zdFxuICogaW50byBPKE4pLlxuICpcbiAqICMjIFNjb3BlIC8gbGlmZXRpbWVcbiAqXG4gKiBUaGUgY2FjaGUgaXMgb3duZWQgYnkgdGhlIGlubGluZSBsb29wIGluIGBydW50aW1lLnRzYCAob25lIHBlciB3b3JrZmxvdyBydW5cbiAqIGludm9jYXRpb24pIGFuZCBwYXNzZWQgaW50byBgcnVuV29ya2Zsb3dgIHNvIGl0IHN1cnZpdmVzIGFjcm9zcyB0aGUgbG9vcCdzXG4gKiBpdGVyYXRpb25zIGJ1dCBuZXZlciBsZWFrcyBhY3Jvc3MgdW5yZWxhdGVkIHJ1bnMgb3IgcHJvY2Vzcy1sZXZlbFxuICogaW52b2NhdGlvbnMuIEEgZnJlc2ggYHJ1bldvcmtmbG93YCAvIGBXb3JrZmxvd09yY2hlc3RyYXRvckNvbnRleHRgIGlzIGNyZWF0ZWRcbiAqIGVhY2ggaXRlcmF0aW9uLCBzbyB0aGUgY2FjaGUgbXVzdCBsaXZlIE9VVFNJREUgdGhlIHBlci1pdGVyYXRpb24gY29udGV4dC5cbiAqXG4gKiAjIyBLZXlpbmdcbiAqXG4gKiBFbnRyaWVzIGFyZSBrZXllZCBieSB0aGUgcGVyc2lzdGVkIGV2ZW50J3MgYGV2ZW50SWRgIOKAlCBhIHN0YWJsZSxcbiAqIHdvcmxkLWFzc2lnbmVkIGlkZW50aWZpZXIgZm9yIHRoZSBgc3RlcF9jb21wbGV0ZWRgIGV2ZW50IHdob3NlIHNlcmlhbGl6ZWRcbiAqIGByZXN1bHRgIGlzIGJlaW5nIGh5ZHJhdGVkLiBUaGUgc2FtZSBldmVudCAoc2FtZSBgZXZlbnRJZGApIGNhcnJpZXMgdGhlIHNhbWVcbiAqIGltbXV0YWJsZSBzZXJpYWxpemVkIGJ5dGVzIGFjcm9zcyBldmVyeSByZXBsYXksIHNvIGEgaGl0IGlzIGd1YXJhbnRlZWQgdG9cbiAqIGNvcnJlc3BvbmQgdG8gdGhlIGlkZW50aWNhbCBpbnB1dC5cbiAqXG4gKiAjIyBJZGVudGl0eSBzYWZldHkgKHdoeSBwcmltaXRpdmVzIG9ubHkpXG4gKlxuICogYGh5ZHJhdGVTdGVwUmV0dXJuVmFsdWVgIChkZXZhbHVlLnBhcnNlKSBwcm9kdWNlcyBhIEZSRVNIIG9iamVjdCBncmFwaCBvblxuICogZXZlcnkgY2FsbCwgYW5kIGVhY2ggcmVwbGF5IGl0ZXJhdGlvbiBydW5zIGluIGEgRlJFU0ggd29ya2Zsb3cgVk0uIFRoZVxuICogY3VycmVudCAodW5jYWNoZWQpIGJlaGF2aW9yIHRoZXJlZm9yZSBoYW5kcyB0aGUgd29ya2Zsb3cgYSBicmFuZC1uZXcgdmFsdWVcbiAqIG9uIGV2ZXJ5IHJlcGxheS4gSWYgd2UgY2FjaGVkIGFuZCByZXR1cm5lZCB0aGUgU0FNRSBvYmplY3QgcmVmZXJlbmNlIGFjcm9zc1xuICogcmVwbGF5cywgd29ya2Zsb3cgY29kZSB0aGF0IG11dGF0ZXMgYSBzdGVwIHJlc3VsdCAoYGNvbnN0IHIgPSBhd2FpdCBzdGVwKCk7XG4gKiByLmNvdW50KytgKSB3b3VsZCBvYnNlcnZlIHRoZSBtdXRhdGlvbiBmcm9tIGEgcHJldmlvdXMgcmVwbGF5IG9uIHRoZSBuZXh0XG4gKiByZXBsYXkg4oCUIGEgbm9uLWRldGVybWluaXN0aWMgZGl2ZXJnZW5jZS4gU3RydWN0dXJlZC1jbG9uaW5nIG9uIGVhY2ggaGl0IGlzXG4gKiBib3RoIGxvc3N5IChyZXZpdmVycyByZWNvbnN0cnVjdCBzdHJlYW0gaGFuZGxlcywgc3RlcC1mdW5jdGlvbiBwcm94aWVzLFxuICogUmVxdWVzdC9SZXNwb25zZSwgYW5kIEFib3J0Q29udHJvbGxlci9BYm9ydFNpZ25hbCBjbGFzcyBpbnN0YW5jZXMgdGhhdCBkb24ndFxuICogc3Vydml2ZSBhIHN0cnVjdHVyZWQgY2xvbmUpIGFuZCBzdGlsbCBPKHNpemUpLlxuICpcbiAqIFNvIHdlIG9ubHkgY2FjaGUgdmFsdWVzIGZvciB3aGljaCByZXR1cm5pbmcgdGhlIHNhbWUgcmVmZXJlbmNlIG9uIGV2ZXJ5XG4gKiByZXBsYXkgaXMgcHJvdmFibHkgaW5kaXN0aW5ndWlzaGFibGUgZnJvbSByZS1oeWRyYXRpbmc6IEphdmFTY3JpcHRcbiAqIHByaW1pdGl2ZXMgKHN0cmluZywgbnVtYmVyLCBib29sZWFuLCBiaWdpbnQsIHN5bWJvbCwgbnVsbCwgdW5kZWZpbmVkKS5cbiAqIFByaW1pdGl2ZXMgYXJlIGltbXV0YWJsZSBhbmQgY29tcGFyZWQgYnkgdmFsdWUsIHNvIHNoYXJpbmcgdGhlIHJlZmVyZW5jZSBpc1xuICogYnl0ZS1mb3ItYnl0ZSBlcXVpdmFsZW50IHRvIHJlLXBhcnNpbmcuIEFueSBub24tcHJpbWl0aXZlIHJlc3VsdCBmYWxsc1xuICogdGhyb3VnaCB0byBhIGZ1bGwgcmUtaHlkcmF0ZSBldmVyeSByZXBsYXksIHByZXNlcnZpbmcgY3VycmVudCBiZWhhdmlvclxuICogZXhhY3RseS4gVGhpcyB0cmFkZXMgc29tZSBvZiB0aGUgb3B0aW1pemF0aW9uIGF3YXkgaW4gdGhlIG9iamVjdC1yZXR1cm5pbmdcbiAqIGNhc2UgaW4gZXhjaGFuZ2UgZm9yIGtlZXBpbmcgZGV0ZXJtaW5pc3RpYyByZXBsYXkgYWlydGlnaHQuXG4gKlxuICogIyMgTWVtb3J5IGNoYXJhY3RlcmlzdGljXG4gKlxuICogQ2FjaGVkIGVudHJpZXMgaG9sZCB0aGUgZGVjcnlwdGVkL2RldmFsdWUtcGFyc2VkICpwbGFpbnRleHQqIG9mIGEgc3RlcFxuICogcmVzdWx0LCB3aGljaCBpcyByZXRhaW5lZCBmb3IgdGhlIHJlc3Qgb2YgdGhlIGludm9jYXRpb24gb24gdG9wIG9mIHRoZVxuICogc2VyaWFsaXplZCBieXRlcyBhbHJlYWR5IGhlbGQgaW4gYGNhY2hlZEV2ZW50c2AuIFNvIHRoZSByZXNpZHVhbCBjb3N0IGlzOlxuICpcbiAqIC0gKipTY29wZWQgdG8gb25lIHdvcmtmbG93LXJ1biBpbnZvY2F0aW9uLioqIEEgZnJlc2ggYE1hcGAgaXMgY3JlYXRlZCBwZXJcbiAqICAgaW52b2NhdGlvbiAoaW4gYHJ1bnRpbWUudHNgKSBhbmQgaXMgdW5yZWFjaGFibGUgLyBHQydkIHdoZW4gdGhlIGludm9jYXRpb25cbiAqICAgcmV0dXJucy4gTm90aGluZyBhY2N1bXVsYXRlcyBhY3Jvc3MgcnVucyBvciBhY3Jvc3MgcHJvY2Vzcy1sZXZlbFxuICogICBpbnZvY2F0aW9ucy5cbiAqIC0gKipCb3VuZGVkIGJ5IHRoZSBudW1iZXIgb2YgcHJpbWl0aXZlLXJldHVybmluZyBjb21wbGV0ZWQgc3RlcHMgaW4gdGhhdFxuICogICBydW4qKiDigJQgYXQgbW9zdCBvbmUgc21hbGwgZW50cnkgcGVyIHN1Y2ggc3RlcC5cbiAqIC0gKipQcmltaXRpdmVzIG9ubHksIGFuZCBhZGRpdGlvbmFsbHkgYnl0ZS1ib3VuZGVkLioqIE1vc3QgcHJpbWl0aXZlc1xuICogICAobnVtYmVycywgYm9vbGVhbnMsIG51bGwvdW5kZWZpbmVkLCBzeW1ib2xzLCBzaG9ydCBpZHMvc3RyaW5ncykgYXJlIHRpbnlcbiAqICAgYW5kIGZpeGVkLXNpemUuIFRoZSBvbmx5IHByaW1pdGl2ZSB0aGF0IGNhbiBiZSBsYXJnZSBpcyBhIHN0cmluZyAob3IgYVxuICogICBwYXRob2xvZ2ljYWxseSBsb25nIGJpZ2ludCksIHNvIHRvIGtlZXAgdGhlIGRvdWJsZWQtcmVzaWRlbmN5IHdvcnN0IGNhc2VcbiAqICAgYm91bmRlZCB3ZSAqZG8gbm90KiBtZW1vaXplIHN0cmluZy9iaWdpbnQgcmVzdWx0cyB3aG9zZSBjaGFyYWN0ZXIgbGVuZ3RoXG4gKiAgIGV4Y2VlZHMge0BsaW5rIE1BWF9NRU1PSVpFRF9QUklNSVRJVkVfTEVOR1RIfS4gQSBsYXJnZSBzdHJpbmcgaXMgY2hlYXAgdG9cbiAqICAgcmUtaHlkcmF0ZSByZWxhdGl2ZSB0byBpdHMgZm9vdHByaW50LCBzbyBsZXR0aW5nIGl0IGZhbGwgdGhyb3VnaCB0byB0aGVcbiAqICAgZXhpc3RpbmcgcGVyLXJlcGxheSByZS1oeWRyYXRlIHBhdGggY29zdHMgbGl0dGxlIGFuZCBjYXBzIHBlYWsgcmV0YWluZWRcbiAqICAgbWVtb3J5LlxuICpcbiAqIChUaGlzIGlzIGEgbXVjaCB3ZWFrZXIgY29uY2VybiB0aGFuIGEgKnByb2Nlc3Mtd2lkZSogY2FjaGU6IHRoZSBkb21pbmFudFxuICogcmVzaWRlbmN5IOKAlCB0aGUgZnVsbCBldmVudCBsb2cgaW4gYGNhY2hlZEV2ZW50c2Ag4oCUIGFscmVhZHkgZXhpc3RzIGZvciB0aGVcbiAqIHNhbWUgbGlmZXRpbWUsIGFuZCBldmVyeXRoaW5nIGhlcmUgaXMgZnJlZWQgdG9nZXRoZXIgd2l0aCBpdCB3aGVuIHRoZVxuICogaW52b2NhdGlvbiBlbmRzLilcbiAqL1xuXG4vKipcbiAqIFVwcGVyIGJvdW5kLCBpbiBjaGFyYWN0ZXJzLCBvbiBhIHN0cmluZy9iaWdpbnQgcHJpbWl0aXZlIHRoYXQgbWF5IGJlXG4gKiBtZW1vaXplZC4gQmV5b25kIHRoaXMsIHRoZSB2YWx1ZSBmYWxscyB0aHJvdWdoIHRvIGEgZnJlc2ggcmUtaHlkcmF0ZSBvbiBldmVyeVxuICogcmVwbGF5IHNvIHRoZSBjYWNoZSBuZXZlciBob2xkcyBhIGxhcmdlIHBsYWludGV4dCBwYXlsb2FkIGZvciB0aGUgbGlmZXRpbWUgb2ZcbiAqIHRoZSBpbnZvY2F0aW9uLiA0IEtpQiBjb21mb3J0YWJseSBjb3ZlcnMgaWRzLCBjb3VudHMsIGZsYWdzLCBhbmQgdHlwaWNhbFxuICogc2hvcnQgc3RyaW5nIHJlc3VsdHMgd2hpbGUgZXhjbHVkaW5nIHRoZSBsYXJnZS1wYXlsb2FkIGNhc2UgdGhlIGJvdW5kIGV4aXN0c1xuICogdG8gZ3VhcmQuIE90aGVyIHByaW1pdGl2ZSB0eXBlcyAobnVtYmVyLCBib29sZWFuLCBzeW1ib2wsIG51bGwsIHVuZGVmaW5lZClcbiAqIGFyZSBpbmhlcmVudGx5IHNtYWxsIGFuZCBhcmUgbmV2ZXIgbGVuZ3RoLWNoZWNrZWQuXG4gKi9cbmV4cG9ydCBjb25zdCBNQVhfTUVNT0laRURfUFJJTUlUSVZFX0xFTkdUSCA9IDQwOTY7XG5cbi8qKlxuICogUmV0dXJucyB0cnVlIGZvciB2YWx1ZXMgdGhhdCBhcmUgc2FmZSB0byBtZW1vaXplIGFuZCByZXR1cm4gYnkgcmVmZXJlbmNlXG4gKiBhY3Jvc3MgcmVwbGF5czogSlMgcHJpbWl0aXZlcy4gT2JqZWN0cyBhbmQgZnVuY3Rpb25zIGFyZSBleGNsdWRlZCBiZWNhdXNlXG4gKiBzaGFyaW5nIGEgbXV0YWJsZSByZWZlcmVuY2UgYWNyb3NzIHJlcGxheXMgY291bGQgY2hhbmdlIG9ic2VydmFibGUgYmVoYXZpb3IuXG4gKlxuICogU3RyaW5ncyBhbmQgYmlnaW50cyBhcmUgYWRkaXRpb25hbGx5IGJvdW5kZWQgYnkgbGVuZ3RoOiBhIHZhbHVlIGxvbmdlciB0aGFuXG4gKiB7QGxpbmsgTUFYX01FTU9JWkVEX1BSSU1JVElWRV9MRU5HVEh9IGNoYXJhY3RlcnMgaXMgdHJlYXRlZCBhcyBub24tbWVtb2l6YWJsZVxuICogc28gdGhlIGNhY2hlIG5ldmVyIHJldGFpbnMgYSBsYXJnZSBwbGFpbnRleHQgcGF5bG9hZCBmb3IgdGhlIHdob2xlIGludm9jYXRpb25cbiAqIChzZWUgdGhlIG1vZHVsZS1sZXZlbCBcIk1lbW9yeSBjaGFyYWN0ZXJpc3RpY1wiIGRvY3MpLiBJdCByZS1oeWRyYXRlcyBmcmVzaCBvblxuICogZXZlcnkgcmVwbGF5IGluc3RlYWQg4oCUIGNoZWFwIHJlbGF0aXZlIHRvIGl0cyBmb290cHJpbnQuXG4gKlxuICogTm90ZTogYHR5cGVvZiBudWxsID09PSAnb2JqZWN0J2AsIHNvIGl0IGlzIGhhbmRsZWQgZXhwbGljaXRseS4gYHVuZGVmaW5lZGAsXG4gKiBgc3RyaW5nYCwgYG51bWJlcmAsIGBib29sZWFuYCwgYGJpZ2ludGAsIGFuZCBgc3ltYm9sYCBhcmUgYWxsIHByaW1pdGl2ZXMuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc01lbW9pemFibGVQcmltaXRpdmUodmFsdWU6IHVua25vd24pOiBib29sZWFuIHtcbiAgaWYgKHZhbHVlID09PSBudWxsKSByZXR1cm4gdHJ1ZTtcbiAgY29uc3QgdCA9IHR5cGVvZiB2YWx1ZTtcbiAgaWYgKHQgPT09ICdvYmplY3QnIHx8IHQgPT09ICdmdW5jdGlvbicpIHJldHVybiBmYWxzZTtcbiAgLy8gQm91bmQgdGhlIG9ubHkgcHJpbWl0aXZlIHR5cGVzIHRoYXQgY2FuIGNhcnJ5IGEgbGFyZ2UgcGF5bG9hZC5cbiAgaWYgKHQgPT09ICdzdHJpbmcnKSB7XG4gICAgcmV0dXJuICh2YWx1ZSBhcyBzdHJpbmcpLmxlbmd0aCA8PSBNQVhfTUVNT0laRURfUFJJTUlUSVZFX0xFTkdUSDtcbiAgfVxuICBpZiAodCA9PT0gJ2JpZ2ludCcpIHtcbiAgICByZXR1cm4gKHZhbHVlIGFzIGJpZ2ludCkudG9TdHJpbmcoKS5sZW5ndGggPD0gTUFYX01FTU9JWkVEX1BSSU1JVElWRV9MRU5HVEg7XG4gIH1cbiAgcmV0dXJuIHRydWU7XG59XG5cbi8qKlxuICogQ2FjaGUgb2YgaHlkcmF0ZWQgc3RlcCByZXR1cm4gdmFsdWVzIGZvciBhIHNpbmdsZSB3b3JrZmxvdyBydW4gaW52b2NhdGlvbi5cbiAqXG4gKiBLZXllZCBieSBgc3RlcF9jb21wbGV0ZWRgIGV2ZW50IGlkOyB0aGUgdmFsdWUgaXMgdGhlIGFscmVhZHktaHlkcmF0ZWRcbiAqIHByaW1pdGl2ZSByZXN1bHQuIE9ubHkgc3VjY2Vzc2Z1bCwgcHJpbWl0aXZlIGh5ZHJhdGlvbnMgYXJlIHN0b3JlZCAoc2VlXG4gKiB7QGxpbmsgZ2V0T3JIeWRyYXRlU3RlcFJldHVyblZhbHVlfSksIHNvIGEgbm9uLWB1bmRlZmluZWRgIGBoYXMoZXZlbnRJZClgXG4gKiBhbHdheXMgbWVhbnMgXCJ0aGlzIHN0ZXAgY29tcGxldGVkIHdpdGggYSBtZW1vaXphYmxlIHByaW1pdGl2ZSB2YWx1ZVwiLlxuICovXG5leHBvcnQgdHlwZSBTdGVwSHlkcmF0aW9uQ2FjaGUgPSBNYXA8c3RyaW5nLCB1bmtub3duPjtcblxuLyoqXG4gKiBDcmVhdGUgYW4gZW1wdHkgcGVyLWludm9jYXRpb24gc3RlcCBoeWRyYXRpb24gY2FjaGUuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBjcmVhdGVTdGVwSHlkcmF0aW9uQ2FjaGUoKTogU3RlcEh5ZHJhdGlvbkNhY2hlIHtcbiAgcmV0dXJuIG5ldyBNYXAoKTtcbn1cblxuLyoqXG4gKiBSZXR1cm4gdGhlIGh5ZHJhdGVkIHN0ZXAgcmVzdWx0IGZvciBgZXZlbnRJZGAsIHVzaW5nIGBjYWNoZWAgYXMgYSBwZXItcnVuXG4gKiBtZW1vLiBPbiBhIGhpdCwgdGhlIGNhY2hlZCBwcmltaXRpdmUgaXMgcmV0dXJuZWQgd2l0aG91dCByZS1ydW5uaW5nIHRoZVxuICogZXhwZW5zaXZlIGRlY3J5cHQgKyBkZXZhbHVlLXBhcnNlLiBPbiBhIG1pc3MsIGBoeWRyYXRlKClgIHJ1bnMgYW5kIGl0c1xuICogcmVzdWx0IGlzIG1lbW9pemVkIG9ubHkgd2hlbiBpdCBpcyBhIHNtYWxsIHByaW1pdGl2ZSAoc2VlIHRoZSBtb2R1bGUgZG9jcyBmb3JcbiAqIHRoZSBpZGVudGl0eS1zYWZldHkgcmF0aW9uYWxlIGFuZCB0aGUgbGVuZ3RoIGJvdW5kIG9uIHN0cmluZy9iaWdpbnQgcmVzdWx0cykuXG4gKlxuICogVGhpcyBhbHdheXMgcmV0dXJucyBhIGBQcm9taXNlYCBhbmQgYGF3YWl0YHMgYGh5ZHJhdGUoKWAgZXZlbiBvbiB0aGUgbWlzc1xuICogcGF0aCwgc28gdGhlIGNhbGxlcidzIGBhd2FpdGAgaW5zaWRlIGl0cyBzZXJpYWwgYHByb21pc2VRdWV1ZWAgc2xvdCBrZWVwcyB0aGVcbiAqIHNhbWUgc2NoZWR1bGluZyBvbiBib3RoIGhpdCBhbmQgbWlzcyDigJQgYSBjYWNoZSBoaXQgcmVzb2x2ZXMgdGhyb3VnaCB0aGUgZXhhY3RcbiAqIHNhbWUgcHJvbWlzZS1jaGFpbiBwb3NpdGlvbiBhIHJlLWh5ZHJhdGUgd291bGQgaGF2ZSwgcHJlc2VydmluZyB0aGVcbiAqIGRldGVybWluaXN0aWMgZGVsaXZlcnkgb3JkZXIgdGhhdCBgcGVuZGluZ0RlbGl2ZXJpZXNgLCB0aGUgZGVsaXZlcnkgYmFycmllcnMsXG4gKiBhbmQgYFByb21pc2UucmFjZWAvYFByb21pc2UuYWxsYCByZXBsYXkgYWxsIGRlcGVuZCBvbi5cbiAqXG4gKiBgaGFzKGV2ZW50SWQpYCBpcyB1c2VkIHJhdGhlciB0aGFuIGBnZXQoZXZlbnRJZCkgIT09IHVuZGVmaW5lZGAgc28gdGhhdCBhXG4gKiBsZWdpdGltYXRlbHkgbWVtb2l6ZWQgYHVuZGVmaW5lZGAgc3RlcCByZXN1bHQgc3RpbGwgcmVnaXN0ZXJzIGFzIGEgaGl0LlxuICpcbiAqIFdoZW4gYGNhY2hlYCBvciBgZXZlbnRJZGAgaXMgYWJzZW50IChsaWdodHdlaWdodCB0ZXN0IGhhcm5lc3Nlcywgb3IgYSBjb250ZXh0XG4gKiB0aGF0IHByZWRhdGVzIHRoaXMgcGx1bWJpbmcpLCB0aGlzIGRlZ3JhZGVzIHRvIGNhbGxpbmcgYGh5ZHJhdGUoKWAgZGlyZWN0bHlcbiAqIHdpdGggbm8gbWVtb2l6YXRpb24g4oCUIGlkZW50aWNhbCB0byB0aGUgcHJldmlvdXMgYmVoYXZpb3IuXG4gKlxuICogRXJyb3JzIGFyZSBpbnRlbnRpb25hbGx5IG5ldmVyIGNhY2hlZDogYSByZWplY3RlZCBoeWRyYXRlIHByb3BhZ2F0ZXMgdG8gdGhlXG4gKiBjYWxsZXIgKHdoaWNoIHJlamVjdHMgdGhlIHN0ZXAgcHJvbWlzZSkgYW5kIHRoZSBuZXh0IHJlcGxheSByZS1hdHRlbXB0cyBpdCxcbiAqIG1hdGNoaW5nIHRoZSB1bmNhY2hlZCBiZWhhdmlvciBhbmQgYXZvaWRpbmcgYSBwYXJrZWQgcmVqZWN0ZWQgcHJvbWlzZS5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGdldE9ySHlkcmF0ZVN0ZXBSZXR1cm5WYWx1ZShcbiAgY2FjaGU6IFN0ZXBIeWRyYXRpb25DYWNoZSB8IHVuZGVmaW5lZCxcbiAgZXZlbnRJZDogc3RyaW5nIHwgdW5kZWZpbmVkLFxuICBoeWRyYXRlOiAoKSA9PiBQcm9taXNlPHVua25vd24+XG4pOiBQcm9taXNlPHVua25vd24+IHtcbiAgaWYgKCFjYWNoZSB8fCBldmVudElkID09PSB1bmRlZmluZWQpIHtcbiAgICByZXR1cm4gaHlkcmF0ZSgpO1xuICB9XG5cbiAgaWYgKGNhY2hlLmhhcyhldmVudElkKSkge1xuICAgIHJldHVybiBjYWNoZS5nZXQoZXZlbnRJZCk7XG4gIH1cblxuICBjb25zdCB2YWx1ZSA9IGF3YWl0IGh5ZHJhdGUoKTtcbiAgLy8gT25seSBtZW1vaXplIHZhbHVlcyB0aGF0IGFyZSBzYWZlIHRvIHJldHVybiBieSByZWZlcmVuY2UgYWNyb3NzIHJlcGxheXNcbiAgLy8gQU5EIHNtYWxsIGVub3VnaCB0byByZXRhaW4gZm9yIHRoZSBpbnZvY2F0aW9uLiBOb24tcHJpbWl0aXZlcyBhbmRcbiAgLy8gb3ZlcnNpemVkIHN0cmluZy9iaWdpbnQgdmFsdWVzIGZhbGwgdGhyb3VnaCBhbmQgYXJlIHJlLWh5ZHJhdGVkIGZyZXNoIG9uXG4gIC8vIGV2ZXJ5IHJlcGxheSAoc2VlIGlzTWVtb2l6YWJsZVByaW1pdGl2ZSAvIE1BWF9NRU1PSVpFRF9QUklNSVRJVkVfTEVOR1RIKS5cbiAgaWYgKGlzTWVtb2l6YWJsZVByaW1pdGl2ZSh2YWx1ZSkpIHtcbiAgICBjYWNoZS5zZXQoZXZlbnRJZCwgdmFsdWUpO1xuICB9XG4gIHJldHVybiB2YWx1ZTtcbn1cbiJdfQ==