velocious 1.0.494 → 1.0.496

package/src/testing/test-runner.js

@@ -187,6 +187,8 @@ export default class TestRunner {
     this._testsCount = 0
     this._activeAfterAllScopes = []
     this._failedTestDetails = []
+    /** @type {{fullDescription: string, filePath: string, line: number} | null} */
+    this._lastTestContext = null
   }
 
   /**
@@ -638,16 +640,102 @@ export default class TestRunner {
    * Runs run.
    * @returns {Promise<void>} - Resolves when complete.
    */
+  /**
+   * Records an asynchronous crash (an unhandled promise rejection detached from
+   * any await, e.g. a `void connection.afterCommit(async () => broadcast(...))`
+   * frontend-model publish — or a synchronous throw inside a detached callback
+   * such as a driver socket or timer callback) as a real, visible, attributed
+   * test failure.
+   *
+   * Without this, such a rejection/exception has no handler, so on modern Node
+   * the process is TERMINATED — the run ends with no reported failures and CI
+   * just sees a crashed/retried shard with an empty result (the recurring
+   * "silent test-runner death": invisible and impossible to diagnose). Turning
+   * it into a failure makes the run go red with something debuggable instead of
+   * vanishing.
+   * @param {"uncaughtException" | "unhandledRejection"} kind - Async-crash kind.
+   * @param {unknown} reason - Rejection reason or thrown error.
+   * @returns {void}
+   */
+  recordAsyncCrash(kind, reason) {
+    const error = reason instanceof Error ? reason : new Error(`${kind}: ${String(reason)}`)
+    const near = this._lastTestContext
+    const attribution = near ? `, near test: ${near.fullDescription} (${near.filePath}:${near.line})` : ""
+
+    this._failedTests = (this._failedTests || 0) + 1
+    this._failedTestDetails.push({
+      fullDescription: `<${kind} during test run${attribution}>`,
+      filePath: near ? near.filePath : "<test runner>",
+      line: near ? near.line : 0,
+      error,
+      consoleOutput: undefined
+    })
+
+    console.error(picocolors.red(`\n[test-runner] ${kind} during the test run — this would otherwise terminate the process silently and surface only as a crashed/retried shard with zero reported failures.${attribution}`))
+    console.error(error)
+  }
+
   async run() {
-    await this.getConfiguration().ensureConnections({name: "Test runner suite"}, async () => {
-      await this.runTests({
-        afterEaches: [],
-        beforeEaches: [],
-        tests,
-        descriptions: [],
-        indentLevel: 0
+    /**
+     * Handles a process-level unhandled rejection during the run.
+     * @param {unknown} reason - Rejection reason.
+     * @returns {void}
+     */
+    const onUnhandledRejection = (reason) => {
+      // If a test attached its OWN unhandledRejection listener, it is
+      // intentionally observing/triggering the rejection (e.g. beacon
+      // error-reporting-spec.js) — Node dispatches to EVERY listener, so also
+      // failing the suite here would break those tests. Defer to the test's
+      // handler; only treat a rejection as a silent-death crash when ours is the
+      // sole listener (no persistent framework listener exists to mask this).
+      if (process.listenerCount("unhandledRejection") > 1) return
+
+      this.recordAsyncCrash("unhandledRejection", reason)
+    }
+
+    /**
+     * Handles a process-level uncaught exception during the run — a
+     * synchronous throw inside a detached callback (driver socket, timer,
+     * event emitter) that no test await observes. Same silent-death mode as
+     * unhandled rejections: without a handler the process dies mid-run and CI
+     * sees a crashed shard with zero reported failures.
+     * @param {unknown} error - Thrown error.
+     * @returns {void}
+     */
+    const onUncaughtException = (error) => {
+      // Mirror the unhandledRejection deferral: a test observing/triggering
+      // uncaught exceptions with its own listener owns them.
+      if (process.listenerCount("uncaughtException") > 1) return
+
+      this.recordAsyncCrash("uncaughtException", error)
+    }
+
+    process.on("unhandledRejection", onUnhandledRejection)
+    process.on("uncaughtException", onUncaughtException)
+
+    try {
+      await this.getConfiguration().ensureConnections({name: "Test runner suite"}, async () => {
+        await this.runTests({
+          afterEaches: [],
+          beforeEaches: [],
+          tests,
+          descriptions: [],
+          indentLevel: 0
+        })
+
+        // A rejection scheduled by the final test (a detached rejected promise,
+        // or an afterCommit callback rejecting as the suite drains) is reported
+        // by Node on a LATER turn. Drain a few turns while the handler is still
+        // attached — and connections still open — so those late rejections are
+        // recorded instead of escaping to the default crash path after cleanup.
+        for (let drainTurn = 0; drainTurn < 3; drainTurn++) {
+          await new Promise((resolve) => setImmediate(resolve))
+        }
       })
-    })
+    } finally {
+      process.off("unhandledRejection", onUnhandledRejection)
+      process.off("uncaughtException", onUncaughtException)
+    }
   }
 
   /**
@@ -798,6 +886,14 @@ export default class TestRunner {
                     await beforeEachData.callback({configuration: this.getConfiguration(), testArgs, testData})
                   }
 
+                  // Record which test is running so an async crash (an unhandled
+                  // rejection detached from any await) that fires during or shortly
+                  // after this test can be attributed to it in run()'s handler.
+                  this._lastTestContext = {
+                    fullDescription: this.buildFullDescription(descriptions, testDescription),
+                    filePath: testData.filePath ?? "<unknown>",
+                    line: testData.line ?? 0
+                  }
                   await testData.function(testArgs)
                   this._successfulTests++
                 } finally {

package/build/src/sync/sync-attribute-normalizer.d.ts

@@ -1,105 +0,0 @@
-/**
- * Builds the error thrown for a failed sync attribute validation.
- * @callback SyncAttributeErrorFactory
- * @param {string} message - Human-readable validation message.
- * @param {{cause?: Error, code: string}} details - Stable machine-readable code and optional cause.
- * @returns {Error} Error to throw.
- */
-/**
- * Declarative validation schema for one writable sync attribute.
- *
- * Keys are camelCase attribute names; each attribute also accepts its
- * snake_case column key on input (the camelCase key wins when both are given)
- * and is written under the snake_case column key on output. Error messages
- * default to `<label> ...` phrasings with `sync-<label>-...` codes, where the
- * label defaults to the camelCase attribute name; apps pin exact messages per
- * attribute through the `*Message` overrides.
- * @typedef {object} SyncAttributeSchemaEntry
- * @property {"date" | "json" | "raw" | "string"} type - Attribute value type.
- * @property {boolean} [required] - Whether present blank/absent values are rejected (strings reject blank-after-trim, dates reject null).
- * @property {number} [maxLength] - Maximum string length, checked after trimming.
- * @property {string} [label] - Label used in derived messages and codes.
- * @property {string} [column] - Output column key. Defaults to the snake_cased attribute name.
- * @property {string} [requiredMessage] - Pinned message for required rejections.
- * @property {string} [tooLongMessage] - Pinned message for too-long rejections.
- * @property {string} [invalidMessage] - Pinned message for invalid dates and non-object/non-string json values.
- * @property {string} [invalidJsonMessage] - Pinned message for unparseable json strings.
- */
-/**
- * Normalizes writable sync attributes against a declarative schema.
- *
- * Only present keys are validated, so required attributes may be absent —
- * create defaults own that concern. Input keys not declared in the schema are
- * rejected by default so misspelled or read-only attributes fail loudly
- * instead of being silently discarded (`unknownAttributes: "ignore"` opts
- * out). Validation failures throw through the given error factory so apps
- * control the raised error class.
- * @param {object} args - Options.
- * @param {Record<string, ?>} args.attributes - Raw incoming attributes (camelCase and/or snake_case keys).
- * @param {SyncAttributeErrorFactory} args.errorFactory - Maps validation failures to thrown errors.
- * @param {Record<string, SyncAttributeSchemaEntry>} args.schema - Attribute schema keyed by camelCase attribute name.
- * @param {"error" | "ignore"} [args.unknownAttributes] - Unknown input-key handling. Defaults to "error".
- * @returns {Record<string, ?>} Normalized values keyed by snake_case column names.
- */
-export default function normalizeAttributesWithSchema({ attributes, errorFactory, schema, unknownAttributes }: {
-    attributes: Record<string, unknown>;
-    errorFactory: SyncAttributeErrorFactory;
-    schema: Record<string, SyncAttributeSchemaEntry>;
-    unknownAttributes?: "error" | "ignore" | undefined;
-}): Record<string, unknown>;
-/**
- * Builds the error thrown for a failed sync attribute validation.
- */
-export type SyncAttributeErrorFactory = (message: string, details: {
-    cause?: Error;
-    code: string;
-}) => Error;
-/**
- * Declarative validation schema for one writable sync attribute.
- *
- * Keys are camelCase attribute names; each attribute also accepts its
- * snake_case column key on input (the camelCase key wins when both are given)
- * and is written under the snake_case column key on output. Error messages
- * default to `<label> ...` phrasings with `sync-<label>-...` codes, where the
- * label defaults to the camelCase attribute name; apps pin exact messages per
- * attribute through the `*Message` overrides.
- */
-export type SyncAttributeSchemaEntry = {
-    /**
-     * - Attribute value type.
-     */
-    type: "date" | "json" | "raw" | "string";
-    /**
-     * - Whether present blank/absent values are rejected (strings reject blank-after-trim, dates reject null).
-     */
-    required?: boolean | undefined;
-    /**
-     * - Maximum string length, checked after trimming.
-     */
-    maxLength?: number | undefined;
-    /**
-     * - Label used in derived messages and codes.
-     */
-    label?: string | undefined;
-    /**
-     * - Output column key. Defaults to the snake_cased attribute name.
-     */
-    column?: string | undefined;
-    /**
-     * - Pinned message for required rejections.
-     */
-    requiredMessage?: string | undefined;
-    /**
-     * - Pinned message for too-long rejections.
-     */
-    tooLongMessage?: string | undefined;
-    /**
-     * - Pinned message for invalid dates and non-object/non-string json values.
-     */
-    invalidMessage?: string | undefined;
-    /**
-     * - Pinned message for unparseable json strings.
-     */
-    invalidJsonMessage?: string | undefined;
-};
-//# sourceMappingURL=sync-attribute-normalizer.d.ts.map

package/build/src/sync/sync-attribute-normalizer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-attribute-normalizer.d.ts","sourceRoot":"","sources":["../../../src/sync/sync-attribute-normalizer.js"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,+GANG;IAAgC,UAAU,EAAlC,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC;IACe,YAAY,EAA5C,yBAAyB;IACsB,MAAM,EAArD,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC;IACd,iBAAiB;CACnD,GAAU,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAqC7B;;;;kDA7EU,MAAM,WACN;IAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,KAC3B,KAAK;;;;;;;;;;;;;;;UAaJ,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ"}

package/build/src/sync/sync-attribute-normalizer.js

@@ -1,172 +0,0 @@
-// @ts-check
-import { snakeCaseKey } from "typanic";
-/**
- * Builds the error thrown for a failed sync attribute validation.
- * @callback SyncAttributeErrorFactory
- * @param {string} message - Human-readable validation message.
- * @param {{cause?: Error, code: string}} details - Stable machine-readable code and optional cause.
- * @returns {Error} Error to throw.
- */
-/**
- * Declarative validation schema for one writable sync attribute.
- *
- * Keys are camelCase attribute names; each attribute also accepts its
- * snake_case column key on input (the camelCase key wins when both are given)
- * and is written under the snake_case column key on output. Error messages
- * default to `<label> ...` phrasings with `sync-<label>-...` codes, where the
- * label defaults to the camelCase attribute name; apps pin exact messages per
- * attribute through the `*Message` overrides.
- * @typedef {object} SyncAttributeSchemaEntry
- * @property {"date" | "json" | "raw" | "string"} type - Attribute value type.
- * @property {boolean} [required] - Whether present blank/absent values are rejected (strings reject blank-after-trim, dates reject null).
- * @property {number} [maxLength] - Maximum string length, checked after trimming.
- * @property {string} [label] - Label used in derived messages and codes.
- * @property {string} [column] - Output column key. Defaults to the snake_cased attribute name.
- * @property {string} [requiredMessage] - Pinned message for required rejections.
- * @property {string} [tooLongMessage] - Pinned message for too-long rejections.
- * @property {string} [invalidMessage] - Pinned message for invalid dates and non-object/non-string json values.
- * @property {string} [invalidJsonMessage] - Pinned message for unparseable json strings.
- */
-/**
- * Normalizes writable sync attributes against a declarative schema.
- *
- * Only present keys are validated, so required attributes may be absent —
- * create defaults own that concern. Input keys not declared in the schema are
- * rejected by default so misspelled or read-only attributes fail loudly
- * instead of being silently discarded (`unknownAttributes: "ignore"` opts
- * out). Validation failures throw through the given error factory so apps
- * control the raised error class.
- * @param {object} args - Options.
- * @param {Record<string, ?>} args.attributes - Raw incoming attributes (camelCase and/or snake_case keys).
- * @param {SyncAttributeErrorFactory} args.errorFactory - Maps validation failures to thrown errors.
- * @param {Record<string, SyncAttributeSchemaEntry>} args.schema - Attribute schema keyed by camelCase attribute name.
- * @param {"error" | "ignore"} [args.unknownAttributes] - Unknown input-key handling. Defaults to "error".
- * @returns {Record<string, ?>} Normalized values keyed by snake_case column names.
- */
-export default function normalizeAttributesWithSchema({ attributes, errorFactory, schema, unknownAttributes = "error" }) {
-    if (!attributes || typeof attributes != "object")
-        throw new Error(`normalizeAttributesWithSchema requires an attributes object, got: ${String(attributes)}`);
-    if (typeof errorFactory != "function")
-        throw new Error("normalizeAttributesWithSchema requires an errorFactory function");
-    if (!schema || typeof schema != "object")
-        throw new Error(`normalizeAttributesWithSchema requires a schema object, got: ${String(schema)}`);
-    if (unknownAttributes != "error" && unknownAttributes != "ignore") {
-        throw new Error(`normalizeAttributesWithSchema unknownAttributes must be "error" or "ignore", got: ${String(unknownAttributes)}`);
-    }
-    /** @type {Record<string, ?>} */
-    const normalized = {};
-    /** @type {Set<string>} */
-    const knownInputKeys = new Set();
-    for (const [attributeName, entry] of Object.entries(schema)) {
-        const column = entry.column ?? snakeCaseKey(attributeName);
-        const inputKeys = column == attributeName ? [attributeName] : [column, attributeName];
-        for (const inputKey of inputKeys) {
-            knownInputKeys.add(inputKey);
-            if (!Object.prototype.hasOwnProperty.call(attributes, inputKey))
-                continue;
-            normalized[column] = normalizeAttributeValue({ attributeName, entry, errorFactory, value: attributes[inputKey] });
-        }
-    }
-    if (unknownAttributes == "error") {
-        for (const inputKey of Object.keys(attributes)) {
-            if (!knownInputKeys.has(inputKey)) {
-                throw errorFactory(`Unknown attribute: ${inputKey}.`, { code: "sync-unknown-attribute" });
-            }
-        }
-    }
-    return normalized;
-}
-/**
- * Normalizes one present attribute value per its schema entry.
- * @param {object} args - Options.
- * @param {string} args.attributeName - camelCase attribute name.
- * @param {SyncAttributeSchemaEntry} args.entry - Schema entry.
- * @param {SyncAttributeErrorFactory} args.errorFactory - Error factory.
- * @param {?} args.value - Raw value.
- * @returns {?} Normalized value.
- */
-function normalizeAttributeValue({ attributeName, entry, errorFactory, value }) {
-    const label = entry.label ?? attributeName;
-    if (entry.type == "string")
-        return normalizeString({ entry, errorFactory, label, value });
-    if (entry.type == "date")
-        return normalizeDate({ entry, errorFactory, label, value });
-    if (entry.type == "json")
-        return normalizeJson({ entry, errorFactory, label, value });
-    if (entry.type == "raw")
-        return value;
-    throw new Error(`Unknown sync attribute schema type for ${attributeName}: ${String(entry.type)}`);
-}
-/**
- * Normalizes a string attribute: trims, rejects blank required values after trimming, maps empty optional values to null and bounds the trimmed length.
- * @param {object} args - Options.
- * @param {SyncAttributeSchemaEntry} args.entry - Schema entry.
- * @param {SyncAttributeErrorFactory} args.errorFactory - Error factory.
- * @param {string} args.label - Message/code label.
- * @param {?} args.value - Raw value.
- * @returns {string | null} Normalized string.
- */
-function normalizeString({ entry, errorFactory, label, value }) {
-    const requiredError = () => errorFactory(entry.requiredMessage ?? `${label} is required.`, { code: `sync-${label}-required` });
-    if (value === null || value === undefined || value === "") {
-        if (entry.required)
-            throw requiredError();
-        return null;
-    }
-    const stringValue = String(value).trim();
-    if (stringValue === "") {
-        if (entry.required)
-            throw requiredError();
-        return null;
-    }
-    if (entry.maxLength !== undefined && stringValue.length > entry.maxLength) {
-        throw errorFactory(entry.tooLongMessage ?? `${label} is too long (maximum is ${entry.maxLength} characters).`, { code: `sync-${label}-too-long` });
-    }
-    return stringValue;
-}
-/**
- * Normalizes a date attribute: Date instances pass through, strings/numbers are parsed and invalid or missing-required values are rejected.
- * @param {object} args - Options.
- * @param {SyncAttributeSchemaEntry} args.entry - Schema entry.
- * @param {SyncAttributeErrorFactory} args.errorFactory - Error factory.
- * @param {string} args.label - Message/code label.
- * @param {?} args.value - Raw value.
- * @returns {Date | null} Normalized date.
- */
-function normalizeDate({ entry, errorFactory, label, value }) {
-    if (!entry.required && (value === null || value === undefined || value === ""))
-        return null;
-    const dateValue = value instanceof Date ? value : typeof value == "string" || typeof value == "number" ? new Date(value) : null;
-    if (!dateValue || Number.isNaN(dateValue.getTime())) {
-        throw errorFactory(entry.invalidMessage ?? `${label} must be a valid datetime.`, { code: `sync-${label}-invalid-datetime` });
-    }
-    return dateValue;
-}
-/**
- * Normalizes a json attribute: empty values become null, objects pass through, strings must parse as JSON and other types are rejected.
- * @param {object} args - Options.
- * @param {SyncAttributeSchemaEntry} args.entry - Schema entry.
- * @param {SyncAttributeErrorFactory} args.errorFactory - Error factory.
- * @param {string} args.label - Message/code label.
- * @param {?} args.value - Raw value.
- * @returns {?} Normalized json value.
- */
-function normalizeJson({ entry, errorFactory, label, value }) {
-    if (value === null || value === undefined || value === "")
-        return null;
-    if (typeof value == "object")
-        return value;
-    if (typeof value == "string") {
-        try {
-            return JSON.parse(value);
-        }
-        catch (error) {
-            throw errorFactory(entry.invalidJsonMessage ?? `${label} must be valid JSON.`, {
-                cause: /** @type {Error} */ (error),
-                code: `sync-${label}-invalid-json`
-            });
-        }
-    }
-    throw errorFactory(entry.invalidMessage ?? `${label} must be an object or JSON string.`, { code: `sync-${label}-invalid` });
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3luYy1hdHRyaWJ1dGUtbm9ybWFsaXplci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9zeW5jL3N5bmMtYXR0cmlidXRlLW5vcm1hbGl6ZXIuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sRUFBQyxZQUFZLEVBQUMsTUFBTSxTQUFTLENBQUE7QUFFcEM7Ozs7OztHQU1HO0FBRUg7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FtQkc7QUFFSDs7Ozs7Ozs7Ozs7Ozs7O0dBZUc7QUFDSCxNQUFNLENBQUMsT0FBTyxVQUFVLDZCQUE2QixDQUFDLEVBQUMsVUFBVSxFQUFFLFlBQVksRUFBRSxNQUFNLEVBQUUsaUJBQWlCLEdBQUcsT0FBTyxFQUFDO0lBQ25ILElBQUksQ0FBQyxVQUFVLElBQUksT0FBTyxVQUFVLElBQUksUUFBUTtRQUFFLE1BQU0sSUFBSSxLQUFLLENBQUMscUVBQXFFLE1BQU0sQ0FBQyxVQUFVLENBQUMsRUFBRSxDQUFDLENBQUE7SUFDNUosSUFBSSxPQUFPLFlBQVksSUFBSSxVQUFVO1FBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyxpRUFBaUUsQ0FBQyxDQUFBO0lBQ3pILElBQUksQ0FBQyxNQUFNLElBQUksT0FBTyxNQUFNLElBQUksUUFBUTtRQUFFLE1BQU0sSUFBSSxLQUFLLENBQUMsZ0VBQWdFLE1BQU0sQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDLENBQUE7SUFDM0ksSUFBSSxpQkFBaUIsSUFBSSxPQUFPLElBQUksaUJBQWlCLElBQUksUUFBUSxFQUFFLENBQUM7UUFDbEUsTUFBTSxJQUFJLEtBQUssQ0FBQyxxRkFBcUYsTUFBTSxDQUFDLGlCQUFpQixDQUFDLEVBQUUsQ0FBQyxDQUFBO0lBQ25JLENBQUM7SUFFRCxnQ0FBZ0M7SUFDaEMsTUFBTSxVQUFVLEdBQUcsRUFBRSxDQUFBO0lBQ3JCLDBCQUEwQjtJQUMxQixNQUFNLGNBQWMsR0FBRyxJQUFJLEdBQUcsRUFBRSxDQUFBO0lBRWhDLEtBQUssTUFBTSxDQUFDLGFBQWEsRUFBRSxLQUFLLENBQUMsSUFBSSxNQUFNLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7UUFDNUQsTUFBTSxNQUFNLEdBQUcsS0FBSyxDQUFDLE1BQU0sSUFBSSxZQUFZLENBQUMsYUFBYSxDQUFDLENBQUE7UUFDMUQsTUFBTSxTQUFTLEdBQUcsTUFBTSxJQUFJLGFBQWEsQ0FBQyxDQUFDLENBQUMsQ0FBQyxhQUFhLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxNQUFNLEVBQUUsYUFBYSxDQUFDLENBQUE7UUFFckYsS0FBSyxNQUFNLFFBQVEsSUFBSSxTQUFTLEVBQUUsQ0FBQztZQUNqQyxjQUFjLENBQUMsR0FBRyxDQUFDLFFBQVEsQ0FBQyxDQUFBO1lBRTVCLElBQUksQ0FBQyxNQUFNLENBQUMsU0FBUyxDQUFDLGNBQWMsQ0FBQyxJQUFJLENBQUMsVUFBVSxFQUFFLFFBQVEsQ0FBQztnQkFBRSxTQUFRO1lBRXpFLFVBQVUsQ0FBQyxNQUFNLENBQUMsR0FBRyx1QkFBdUIsQ0FBQyxFQUFDLGFBQWEsRUFBRSxLQUFLLEVBQUUsWUFBWSxFQUFFLEtBQUssRUFBRSxVQUFVLENBQUMsUUFBUSxDQUFDLEVBQUMsQ0FBQyxDQUFBO1FBQ2pILENBQUM7SUFDSCxDQUFDO0lBRUQsSUFBSSxpQkFBaUIsSUFBSSxPQUFPLEVBQUUsQ0FBQztRQUNqQyxLQUFLLE1BQU0sUUFBUSxJQUFJLE1BQU0sQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLEVBQUUsQ0FBQztZQUMvQyxJQUFJLENBQUMsY0FBYyxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDO2dCQUNsQyxNQUFNLFlBQVksQ0FBQyxzQkFBc0IsUUFBUSxHQUFHLEVBQUUsRUFBQyxJQUFJLEVBQUUsd0JBQXdCLEVBQUMsQ0FBQyxDQUFBO1lBQ3pGLENBQUM7UUFDSCxDQUFDO0lBQ0gsQ0FBQztJQUVELE9BQU8sVUFBVSxDQUFBO0FBQ25CLENBQUM7QUFFRDs7Ozs7Ozs7R0FRRztBQUNILFNBQVMsdUJBQXVCLENBQUMsRUFBQyxhQUFhLEVBQUUsS0FBSyxFQUFFLFlBQVksRUFBRSxLQUFLLEVBQUM7SUFDMUUsTUFBTSxLQUFLLEdBQUcsS0FBSyxDQUFDLEtBQUssSUFBSSxhQUFhLENBQUE7SUFFMUMsSUFBSSxLQUFLLENBQUMsSUFBSSxJQUFJLFFBQVE7UUFBRSxPQUFPLGVBQWUsQ0FBQyxFQUFDLEtBQUssRUFBRSxZQUFZLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBQyxDQUFDLENBQUE7SUFDdkYsSUFBSSxLQUFLLENBQUMsSUFBSSxJQUFJLE1BQU07UUFBRSxPQUFPLGFBQWEsQ0FBQyxFQUFDLEtBQUssRUFBRSxZQUFZLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBQyxDQUFDLENBQUE7SUFDbkYsSUFBSSxLQUFLLENBQUMsSUFBSSxJQUFJLE1BQU07UUFBRSxPQUFPLGFBQWEsQ0FBQyxFQUFDLEtBQUssRUFBRSxZQUFZLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBQyxDQUFDLENBQUE7SUFDbkYsSUFBSSxLQUFLLENBQUMsSUFBSSxJQUFJLEtBQUs7UUFBRSxPQUFPLEtBQUssQ0FBQTtJQUVyQyxNQUFNLElBQUksS0FBSyxDQUFDLDBDQUEwQyxhQUFhLEtBQUssTUFBTSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLENBQUE7QUFDbkcsQ0FBQztBQUVEOzs7Ozs7OztHQVFHO0FBQ0gsU0FBUyxlQUFlLENBQUMsRUFBQyxLQUFLLEVBQUUsWUFBWSxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUM7SUFDMUQsTUFBTSxhQUFhLEdBQUcsR0FBRyxFQUFFLENBQUMsWUFBWSxDQUFDLEtBQUssQ0FBQyxlQUFlLElBQUksR0FBRyxLQUFLLGVBQWUsRUFBRSxFQUFDLElBQUksRUFBRSxRQUFRLEtBQUssV0FBVyxFQUFDLENBQUMsQ0FBQTtJQUU1SCxJQUFJLEtBQUssS0FBSyxJQUFJLElBQUksS0FBSyxLQUFLLFNBQVMsSUFBSSxLQUFLLEtBQUssRUFBRSxFQUFFLENBQUM7UUFDMUQsSUFB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LWNoZWNrXG5cbmltcG9ydCB7c25ha2VDYXNlS2V5fSBmcm9tIFwidHlwYW5pY1wiXG5cbi8qKlxuICogQnVpbGRzIHRoZSBlcnJvciB0aHJvd24gZm9yIGEgZmFpbGVkIHN5bmMgYXR0cmlidXRlIHZhbGlkYXRpb24uXG4gKiBAY2FsbGJhY2sgU3luY0F0dHJpYnV0ZUVycm9yRmFjdG9yeVxuICogQHBhcmFtIHtzdHJpbmd9IG1lc3NhZ2UgLSBIdW1hbi1yZWFkYWJsZSB2YWxpZGF0aW9uIG1lc3NhZ2UuXG4gKiBAcGFyYW0ge3tjYXVzZT86IEVycm9yLCBjb2RlOiBzdHJpbmd9fSBkZXRhaWxzIC0gU3RhYmxlIG1hY2hpbmUtcmVhZGFibGUgY29kZSBhbmQgb3B0aW9uYWwgY2F1c2UuXG4gKiBAcmV0dXJucyB7RXJyb3J9IEVycm9yIHRvIHRocm93LlxuICovXG5cbi8qKlxuICogRGVjbGFyYXRpdmUgdmFsaWRhdGlvbiBzY2hlbWEgZm9yIG9uZSB3cml0YWJsZSBzeW5jIGF0dHJpYnV0ZS5cbiAqXG4gKiBLZXlzIGFyZSBjYW1lbENhc2UgYXR0cmlidXRlIG5hbWVzOyBlYWNoIGF0dHJpYnV0ZSBhbHNvIGFjY2VwdHMgaXRzXG4gKiBzbmFrZV9jYXNlIGNvbHVtbiBrZXkgb24gaW5wdXQgKHRoZSBjYW1lbENhc2Uga2V5IHdpbnMgd2hlbiBib3RoIGFyZSBnaXZlbilcbiAqIGFuZCBpcyB3cml0dGVuIHVuZGVyIHRoZSBzbmFrZV9jYXNlIGNvbHVtbiBrZXkgb24gb3V0cHV0LiBFcnJvciBtZXNzYWdlc1xuICogZGVmYXVsdCB0byBgPGxhYmVsPiAuLi5gIHBocmFzaW5ncyB3aXRoIGBzeW5jLTxsYWJlbD4tLi4uYCBjb2Rlcywgd2hlcmUgdGhlXG4gKiBsYWJlbCBkZWZhdWx0cyB0byB0aGUgY2FtZWxDYXNlIGF0dHJpYnV0ZSBuYW1lOyBhcHBzIHBpbiBleGFjdCBtZXNzYWdlcyBwZXJcbiAqIGF0dHJpYnV0ZSB0aHJvdWdoIHRoZSBgKk1lc3NhZ2VgIG92ZXJyaWRlcy5cbiAqIEB0eXBlZGVmIHtvYmplY3R9IFN5bmNBdHRyaWJ1dGVTY2hlbWFFbnRyeVxuICogQHByb3BlcnR5IHtcImRhdGVcIiB8IFwianNvblwiIHwgXCJyYXdcIiB8IFwic3RyaW5nXCJ9IHR5cGUgLSBBdHRyaWJ1dGUgdmFsdWUgdHlwZS5cbiAqIEBwcm9wZXJ0eSB7Ym9vbGVhbn0gW3JlcXVpcmVkXSAtIFdoZXRoZXIgcHJlc2VudCBibGFuay9hYnNlbnQgdmFsdWVzIGFyZSByZWplY3RlZCAoc3RyaW5ncyByZWplY3QgYmxhbmstYWZ0ZXItdHJpbSwgZGF0ZXMgcmVqZWN0IG51bGwpLlxuICogQHByb3BlcnR5IHtudW1iZXJ9IFttYXhMZW5ndGhdIC0gTWF4aW11bSBzdHJpbmcgbGVuZ3RoLCBjaGVja2VkIGFmdGVyIHRyaW1taW5nLlxuICogQHByb3BlcnR5IHtzdHJpbmd9IFtsYWJlbF0gLSBMYWJlbCB1c2VkIGluIGRlcml2ZWQgbWVzc2FnZXMgYW5kIGNvZGVzLlxuICogQHByb3BlcnR5IHtzdHJpbmd9IFtjb2x1bW5dIC0gT3V0cHV0IGNvbHVtbiBrZXkuIERlZmF1bHRzIHRvIHRoZSBzbmFrZV9jYXNlZCBhdHRyaWJ1dGUgbmFtZS5cbiAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBbcmVxdWlyZWRNZXNzYWdlXSAtIFBpbm5lZCBtZXNzYWdlIGZvciByZXF1aXJlZCByZWplY3Rpb25zLlxuICogQHByb3BlcnR5IHtzdHJpbmd9IFt0b29Mb25nTWVzc2FnZV0gLSBQaW5uZWQgbWVzc2FnZSBmb3IgdG9vLWxvbmcgcmVqZWN0aW9ucy5cbiAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBbaW52YWxpZE1lc3NhZ2VdIC0gUGlubmVkIG1lc3NhZ2UgZm9yIGludmFsaWQgZGF0ZXMgYW5kIG5vbi1vYmplY3Qvbm9uLXN0cmluZyBqc29uIHZhbHVlcy5cbiAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBbaW52YWxpZEpzb25NZXNzYWdlXSAtIFBpbm5lZCBtZXNzYWdlIGZvciB1bnBhcnNlYWJsZSBqc29uIHN0cmluZ3MuXG4gKi9cblxuLyoqXG4gKiBOb3JtYWxpemVzIHdyaXRhYmxlIHN5bmMgYXR0cmlidXRlcyBhZ2FpbnN0IGEgZGVjbGFyYXRpdmUgc2NoZW1hLlxuICpcbiAqIE9ubHkgcHJlc2VudCBrZXlzIGFyZSB2YWxpZGF0ZWQsIHNvIHJlcXVpcmVkIGF0dHJpYnV0ZXMgbWF5IGJlIGFic2VudCDigJRcbiAqIGNyZWF0ZSBkZWZhdWx0cyBvd24gdGhhdCBjb25jZXJuLiBJbnB1dCBrZXlzIG5vdCBkZWNsYXJlZCBpbiB0aGUgc2NoZW1hIGFyZVxuICogcmVqZWN0ZWQgYnkgZGVmYXVsdCBzbyBtaXNzcGVsbGVkIG9yIHJlYWQtb25seSBhdHRyaWJ1dGVzIGZhaWwgbG91ZGx5XG4gKiBpbnN0ZWFkIG9mIGJlaW5nIHNpbGVudGx5IGRpc2NhcmRlZCAoYHVua25vd25BdHRyaWJ1dGVzOiBcImlnbm9yZVwiYCBvcHRzXG4gKiBvdXQpLiBWYWxpZGF0aW9uIGZhaWx1cmVzIHRocm93IHRocm91Z2ggdGhlIGdpdmVuIGVycm9yIGZhY3Rvcnkgc28gYXBwc1xuICogY29udHJvbCB0aGUgcmFpc2VkIGVycm9yIGNsYXNzLlxuICogQHBhcmFtIHtvYmplY3R9IGFyZ3MgLSBPcHRpb25zLlxuICogQHBhcmFtIHtSZWNvcmQ8c3RyaW5nLCA/Pn0gYXJncy5hdHRyaWJ1dGVzIC0gUmF3IGluY29taW5nIGF0dHJpYnV0ZXMgKGNhbWVsQ2FzZSBhbmQvb3Igc25ha2VfY2FzZSBrZXlzKS5cbiAqIEBwYXJhbSB7U3luY0F0dHJpYnV0ZUVycm9yRmFjdG9yeX0gYXJncy5lcnJvckZhY3RvcnkgLSBNYXBzIHZhbGlkYXRpb24gZmFpbHVyZXMgdG8gdGhyb3duIGVycm9ycy5cbiAqIEBwYXJhbSB7UmVjb3JkPHN0cmluZywgU3luY0F0dHJpYnV0ZVNjaGVtYUVudHJ5Pn0gYXJncy5zY2hlbWEgLSBBdHRyaWJ1dGUgc2NoZW1hIGtleWVkIGJ5IGNhbWVsQ2FzZSBhdHRyaWJ1dGUgbmFtZS5cbiAqIEBwYXJhbSB7XCJlcnJvclwiIHwgXCJpZ25vcmVcIn0gW2FyZ3MudW5rbm93bkF0dHJpYnV0ZXNdIC0gVW5rbm93biBpbnB1dC1rZXkgaGFuZGxpbmcuIERlZmF1bHRzIHRvIFwiZXJyb3JcIi5cbiAqIEByZXR1cm5zIHtSZWNvcmQ8c3RyaW5nLCA/Pn0gTm9ybWFsaXplZCB2YWx1ZXMga2V5ZWQgYnkgc25ha2VfY2FzZSBjb2x1bW4gbmFtZXMuXG4gKi9cbmV4cG9ydCBkZWZhdWx0IGZ1bmN0aW9uIG5vcm1hbGl6ZUF0dHJpYnV0ZXNXaXRoU2NoZW1hKHthdHRyaWJ1dGVzLCBlcnJvckZhY3RvcnksIHNjaGVtYSwgdW5rbm93bkF0dHJpYnV0ZXMgPSBcImVycm9yXCJ9KSB7XG4gIGlmICghYXR0cmlidXRlcyB8fCB0eXBlb2YgYXR0cmlidXRlcyAhPSBcIm9iamVjdFwiKSB0aHJvdyBuZXcgRXJyb3IoYG5vcm1hbGl6ZUF0dHJpYnV0ZXNXaXRoU2NoZW1hIHJlcXVpcmVzIGFuIGF0dHJpYnV0ZXMgb2JqZWN0LCBnb3Q6ICR7U3RyaW5nKGF0dHJpYnV0ZXMpfWApXG4gIGlmICh0eXBlb2YgZXJyb3JGYWN0b3J5ICE9IFwiZnVuY3Rpb25cIikgdGhyb3cgbmV3IEVycm9yKFwibm9ybWFsaXplQXR0cmlidXRlc1dpdGhTY2hlbWEgcmVxdWlyZXMgYW4gZXJyb3JGYWN0b3J5IGZ1bmN0aW9uXCIpXG4gIGlmICghc2NoZW1hIHx8IHR5cGVvZiBzY2hlbWEgIT0gXCJvYmplY3RcIikgdGhyb3cgbmV3IEVycm9yKGBub3JtYWxpemVBdHRyaWJ1dGVzV2l0aFNjaGVtYSByZXF1aXJlcyBhIHNjaGVtYSBvYmplY3QsIGdvdDogJHtTdHJpbmcoc2NoZW1hKX1gKVxuICBpZiAodW5rbm93bkF0dHJpYnV0ZXMgIT0gXCJlcnJvclwiICYmIHVua25vd25BdHRyaWJ1dGVzICE9IFwiaWdub3JlXCIpIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IoYG5vcm1hbGl6ZUF0dHJpYnV0ZXNXaXRoU2NoZW1hIHVua25vd25BdHRyaWJ1dGVzIG11c3QgYmUgXCJlcnJvclwiIG9yIFwiaWdub3JlXCIsIGdvdDogJHtTdHJpbmcodW5rbm93bkF0dHJpYnV0ZXMpfWApXG4gIH1cblxuICAvKiogQHR5cGUge1JlY29yZDxzdHJpbmcsID8+fSAqL1xuICBjb25zdCBub3JtYWxpemVkID0ge31cbiAgLyoqIEB0eXBlIHtTZXQ8c3RyaW5nPn0gKi9cbiAgY29uc3Qga25vd25JbnB1dEtleXMgPSBuZXcgU2V0KClcblxuICBmb3IgKGNvbnN0IFthdHRyaWJ1dGVOYW1lLCBlbnRyeV0gb2YgT2JqZWN0LmVudHJpZXMoc2NoZW1hKSkge1xuICAgIGNvbnN0IGNvbHVtbiA9IGVudHJ5LmNvbHVtbiA/PyBzbmFrZUNhc2VLZXkoYXR0cmlidXRlTmFtZSlcbiAgICBjb25zdCBpbnB1dEtleXMgPSBjb2x1bW4gPT0gYXR0cmlidXRlTmFtZSA/IFthdHRyaWJ1dGVOYW1lXSA6IFtjb2x1bW4sIGF0dHJpYnV0ZU5hbWVdXG5cbiAgICBmb3IgKGNvbnN0IGlucHV0S2V5IG9mIGlucHV0S2V5cykge1xuICAgICAga25vd25JbnB1dEtleXMuYWRkKGlucHV0S2V5KVxuXG4gICAgICBpZiAoIU9iamVjdC5wcm90b3R5cGUuaGFzT3duUHJvcGVydHkuY2FsbChhdHRyaWJ1dGVzLCBpbnB1dEtleSkpIGNvbnRpbnVlXG5cbiAgICAgIG5vcm1hbGl6ZWRbY29sdW1uXSA9IG5vcm1hbGl6ZUF0dHJpYnV0ZVZhbHVlKHthdHRyaWJ1dGVOYW1lLCBlbnRyeSwgZXJyb3JGYWN0b3J5LCB2YWx1ZTogYXR0cmlidXRlc1tpbnB1dEtleV19KVxuICAgIH1cbiAgfVxuXG4gIGlmICh1bmtub3duQXR0cmlidXRlcyA9PSBcImVycm9yXCIpIHtcbiAgICBmb3IgKGNvbnN0IGlucHV0S2V5IG9mIE9iamVjdC5rZXlzKGF0dHJpYnV0ZXMpKSB7XG4gICAgICBpZiAoIWtub3duSW5wdXRLZXlzLmhhcyhpbnB1dEtleSkpIHtcbiAgICAgICAgdGhyb3cgZXJyb3JGYWN0b3J5KGBVbmtub3duIGF0dHJpYnV0ZTogJHtpbnB1dEtleX0uYCwge2NvZGU6IFwic3luYy11bmtub3duLWF0dHJpYnV0ZVwifSlcbiAgICAgIH1cbiAgICB9XG4gIH1cblxuICByZXR1cm4gbm9ybWFsaXplZFxufVxuXG4vKipcbiAqIE5vcm1hbGl6ZXMgb25lIHByZXNlbnQgYXR0cmlidXRlIHZhbHVlIHBlciBpdHMgc2NoZW1hIGVudHJ5LlxuICogQHBhcmFtIHtvYmplY3R9IGFyZ3MgLSBPcHRpb25zLlxuICogQHBhcmFtIHtzdHJpbmd9IGFyZ3MuYXR0cmlidXRlTmFtZSAtIGNhbWVsQ2FzZSBhdHRyaWJ1dGUgbmFtZS5cbiAqIEBwYXJhbSB7U3luY0F0dHJpYnV0ZVNjaGVtYUVudHJ5fSBhcmdzLmVudHJ5IC0gU2NoZW1hIGVudHJ5LlxuICogQHBhcmFtIHtTeW5jQXR0cmlidXRlRXJyb3JGYWN0b3J5fSBhcmdzLmVycm9yRmFjdG9yeSAtIEVycm9yIGZhY3RvcnkuXG4gKiBAcGFyYW0gez99IGFyZ3MudmFsdWUgLSBSYXcgdmFsdWUuXG4gKiBAcmV0dXJucyB7P30gTm9ybWFsaXplZCB2YWx1ZS5cbiAqL1xuZnVuY3Rpb24gbm9ybWFsaXplQXR0cmlidXRlVmFsdWUoe2F0dHJpYnV0ZU5hbWUsIGVudHJ5LCBlcnJvckZhY3RvcnksIHZhbHVlfSkge1xuICBjb25zdCBsYWJlbCA9IGVudHJ5LmxhYmVsID8/IGF0dHJpYnV0ZU5hbWVcblxuICBpZiAoZW50cnkudHlwZSA9PSBcInN0cmluZ1wiKSByZXR1cm4gbm9ybWFsaXplU3RyaW5nKHtlbnRyeSwgZXJyb3JGYWN0b3J5LCBsYWJlbCwgdmFsdWV9KVxuICBpZiAoZW50cnkudHlwZSA9PSBcImRhdGVcIikgcmV0dXJuIG5vcm1hbGl6ZURhdGUoe2VudHJ5LCBlcnJvckZhY3RvcnksIGxhYmVsLCB2YWx1ZX0pXG4gIGlmIChlbnRyeS50eXBlID09IFwianNvblwiKSByZXR1cm4gbm9ybWFsaXplSnNvbih7ZW50cnksIGVycm9yRmFjdG9yeSwgbGFiZWwsIHZhbHVlfSlcbiAgaWYgKGVudHJ5LnR5cGUgPT0gXCJyYXdcIikgcmV0dXJuIHZhbHVlXG5cbiAgdGhyb3cgbmV3IEVycm9yKGBVbmtub3duIHN5bmMgYXR0cmlidXRlIHNjaGVtYSB0eXBlIGZvciAke2F0dHJpYnV0ZU5hbWV9OiAke1N0cmluZyhlbnRyeS50eXBlKX1gKVxufVxuXG4vKipcbiAqIE5vcm1hbGl6ZXMgYSBzdHJpbmcgYXR0cmlidXRlOiB0cmltcywgcmVqZWN0cyBibGFuayByZXF1aXJlZCB2YWx1ZXMgYWZ0ZXIgdHJpbW1pbmcsIG1hcHMgZW1wdHkgb3B0aW9uYWwgdmFsdWVzIHRvIG51bGwgYW5kIGJvdW5kcyB0aGUgdHJpbW1lZCBsZW5ndGguXG4gKiBAcGFyYW0ge29iamVjdH0gYXJncyAtIE9wdGlvbnMuXG4gKiBAcGFyYW0ge1N5bmNBdHRyaWJ1dGVTY2hlbWFFbnRyeX0gYXJncy5lbnRyeSAtIFNjaGVtYSBlbnRyeS5cbiAqIEBwYXJhbSB7U3luY0F0dHJpYnV0ZUVycm9yRmFjdG9yeX0gYXJncy5lcnJvckZhY3RvcnkgLSBFcnJvciBmYWN0b3J5LlxuICogQHBhcmFtIHtzdHJpbmd9IGFyZ3MubGFiZWwgLSBNZXNzYWdlL2NvZGUgbGFiZWwuXG4gKiBAcGFyYW0gez99IGFyZ3MudmFsdWUgLSBSYXcgdmFsdWUuXG4gKiBAcmV0dXJucyB7c3RyaW5nIHwgbnVsbH0gTm9ybWFsaXplZCBzdHJpbmcuXG4gKi9cbmZ1bmN0aW9uIG5vcm1hbGl6ZVN0cmluZyh7ZW50cnksIGVycm9yRmFjdG9yeSwgbGFiZWwsIHZhbHVlfSkge1xuICBjb25zdCByZXF1aXJlZEVycm9yID0gKCkgPT4gZXJyb3JGYWN0b3J5KGVudHJ5LnJlcXVpcmVkTWVzc2FnZSA/PyBgJHtsYWJlbH0gaXMgcmVxdWlyZWQuYCwge2NvZGU6IGBzeW5jLSR7bGFiZWx9LXJlcXVpcmVkYH0pXG5cbiAgaWYgKHZhbHVlID09PSBudWxsIHx8IHZhbHVlID09PSB1bmRlZmluZWQgfHwgdmFsdWUgPT09IFwiXCIpIHtcbiAgICBpZiAoZW50cnkucmVxdWlyZWQpIHRocm93IHJlcXVpcmVkRXJyb3IoKVxuXG4gICAgcmV0dXJuIG51bGxcbiAgfVxuXG4gIGNvbnN0IHN0cmluZ1ZhbHVlID0gU3RyaW5nKHZhbHVlKS50cmltKClcblxuICBpZiAoc3RyaW5nVmFsdWUgPT09IFwiXCIpIHtcbiAgICBpZiAoZW50cnkucmVxdWlyZWQpIHRocm93IHJlcXVpcmVkRXJyb3IoKVxuXG4gICAgcmV0dXJuIG51bGxcbiAgfVxuXG4gIGlmIChlbnRyeS5tYXhMZW5ndGggIT09IHVuZGVmaW5lZCAmJiBzdHJpbmdWYWx1ZS5sZW5ndGggPiBlbnRyeS5tYXhMZW5ndGgpIHtcbiAgICB0aHJvdyBlcnJvckZhY3RvcnkoZW50cnkudG9vTG9uZ01lc3NhZ2UgPz8gYCR7bGFiZWx9IGlzIHRvbyBsb25nIChtYXhpbXVtIGlzICR7ZW50cnkubWF4TGVuZ3RofSBjaGFyYWN0ZXJzKS5gLCB7Y29kZTogYHN5bmMtJHtsYWJlbH0tdG9vLWxvbmdgfSlcbiAgfVxuXG4gIHJldHVybiBzdHJpbmdWYWx1ZVxufVxuXG4vKipcbiAqIE5vcm1hbGl6ZXMgYSBkYXRlIGF0dHJpYnV0ZTogRGF0ZSBpbnN0YW5jZXMgcGFzcyB0aHJvdWdoLCBzdHJpbmdzL251bWJlcnMgYXJlIHBhcnNlZCBhbmQgaW52YWxpZCBvciBtaXNzaW5nLXJlcXVpcmVkIHZhbHVlcyBhcmUgcmVqZWN0ZWQuXG4gKiBAcGFyYW0ge29iamVjdH0gYXJncyAtIE9wdGlvbnMuXG4gKiBAcGFyYW0ge1N5bmNBdHRyaWJ1dGVTY2hlbWFFbnRyeX0gYXJncy5lbnRyeSAtIFNjaGVtYSBlbnRyeS5cbiAqIEBwYXJhbSB7U3luY0F0dHJpYnV0ZUVycm9yRmFjdG9yeX0gYXJncy5lcnJvckZhY3RvcnkgLSBFcnJvciBmYWN0b3J5LlxuICogQHBhcmFtIHtzdHJpbmd9IGFyZ3MubGFiZWwgLSBNZXNzYWdlL2NvZGUgbGFiZWwuXG4gKiBAcGFyYW0gez99IGFyZ3MudmFsdWUgLSBSYXcgdmFsdWUuXG4gKiBAcmV0dXJucyB7RGF0ZSB8IG51bGx9IE5vcm1hbGl6ZWQgZGF0ZS5cbiAqL1xuZnVuY3Rpb24gbm9ybWFsaXplRGF0ZSh7ZW50cnksIGVycm9yRmFjdG9yeSwgbGFiZWwsIHZhbHVlfSkge1xuICBpZiAoIWVudHJ5LnJlcXVpcmVkICYmICh2YWx1ZSA9PT0gbnVsbCB8fCB2YWx1ZSA9PT0gdW5kZWZpbmVkIHx8IHZhbHVlID09PSBcIlwiKSkgcmV0dXJuIG51bGxcblxuICBjb25zdCBkYXRlVmFsdWUgPSB2YWx1ZSBpbnN0YW5jZW9mIERhdGUgPyB2YWx1ZSA6IHR5cGVvZiB2YWx1ZSA9PSBcInN0cmluZ1wiIHx8IHR5cGVvZiB2YWx1ZSA9PSBcIm51bWJlclwiID8gbmV3IERhdGUodmFsdWUpIDogbnVsbFxuXG4gIGlmICghZGF0ZVZhbHVlIHx8IE51bWJlci5pc05hTihkYXRlVmFsdWUuZ2V0VGltZSgpKSkge1xuICAgIHRocm93IGVycm9yRmFjdG9yeShlbnRyeS5pbnZhbGlkTWVzc2FnZSA/PyBgJHtsYWJlbH0gbXVzdCBiZSBhIHZhbGlkIGRhdGV0aW1lLmAsIHtjb2RlOiBgc3luYy0ke2xhYmVsfS1pbnZhbGlkLWRhdGV0aW1lYH0pXG4gIH1cblxuICByZXR1cm4gZGF0ZVZhbHVlXG59XG5cbi8qKlxuICogTm9ybWFsaXplcyBhIGpzb24gYXR0cmlidXRlOiBlbXB0eSB2YWx1ZXMgYmVjb21lIG51bGwsIG9iamVjdHMgcGFzcyB0aHJvdWdoLCBzdHJpbmdzIG11c3QgcGFyc2UgYXMgSlNPTiBhbmQgb3RoZXIgdHlwZXMgYXJlIHJlamVjdGVkLlxuICogQHBhcmFtIHtvYmplY3R9IGFyZ3MgLSBPcHRpb25zLlxuICogQHBhcmFtIHtTeW5jQXR0cmlidXRlU2NoZW1hRW50cnl9IGFyZ3MuZW50cnkgLSBTY2hlbWEgZW50cnkuXG4gKiBAcGFyYW0ge1N5bmNBdHRyaWJ1dGVFcnJvckZhY3Rvcnl9IGFyZ3MuZXJyb3JGYWN0b3J5IC0gRXJyb3IgZmFjdG9yeS5cbiAqIEBwYXJhbSB7c3RyaW5nfSBhcmdzLmxhYmVsIC0gTWVzc2FnZS9jb2RlIGxhYmVsLlxuICogQHBhcmFtIHs/fSBhcmdzLnZhbHVlIC0gUmF3IHZhbHVlLlxuICogQHJldHVybnMgez99IE5vcm1hbGl6ZWQganNvbiB2YWx1ZS5cbiAqL1xuZnVuY3Rpb24gbm9ybWFsaXplSnNvbih7ZW50cnksIGVycm9yRmFjdG9yeSwgbGFiZWwsIHZhbHVlfSkge1xuICBpZiAodmFsdWUgPT09IG51bGwgfHwgdmFsdWUgPT09IHVuZGVmaW5lZCB8fCB2YWx1ZSA9PT0gXCJcIikgcmV0dXJuIG51bGxcbiAgaWYgKHR5cGVvZiB2YWx1ZSA9PSBcIm9iamVjdFwiKSByZXR1cm4gdmFsdWVcblxuICBpZiAodHlwZW9mIHZhbHVlID09IFwic3RyaW5nXCIpIHtcbiAgICB0cnkge1xuICAgICAgcmV0dXJuIEpTT04ucGFyc2UodmFsdWUpXG4gICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgIHRocm93IGVycm9yRmFjdG9yeShlbnRyeS5pbnZhbGlkSnNvbk1lc3NhZ2UgPz8gYCR7bGFiZWx9IG11c3QgYmUgdmFsaWQgSlNPTi5gLCB7XG4gICAgICAgIGNhdXNlOiAvKiogQHR5cGUge0Vycm9yfSAqLyAoZXJyb3IpLFxuICAgICAgICBjb2RlOiBgc3luYy0ke2xhYmVsfS1pbnZhbGlkLWpzb25gXG4gICAgICB9KVxuICAgIH1cbiAgfVxuXG4gIHRocm93IGVycm9yRmFjdG9yeShlbnRyeS5pbnZhbGlkTWVzc2FnZSA/PyBgJHtsYWJlbH0gbXVzdCBiZSBhbiBvYmplY3Qgb3IgSlNPTiBzdHJpbmcuYCwge2NvZGU6IGBzeW5jLSR7bGFiZWx9LWludmFsaWRgfSlcbn1cbiJdfQ==

package/build/sync/sync-attribute-normalizer.js

@@ -1,186 +0,0 @@
-// @ts-check
-
-import {snakeCaseKey} from "typanic"
-
-/**
- * Builds the error thrown for a failed sync attribute validation.
- * @callback SyncAttributeErrorFactory
- * @param {string} message - Human-readable validation message.
- * @param {{cause?: Error, code: string}} details - Stable machine-readable code and optional cause.
- * @returns {Error} Error to throw.
- */
-
-/**
- * Declarative validation schema for one writable sync attribute.
- *
- * Keys are camelCase attribute names; each attribute also accepts its
- * snake_case column key on input (the camelCase key wins when both are given)
- * and is written under the snake_case column key on output. Error messages
- * default to `<label> ...` phrasings with `sync-<label>-...` codes, where the
- * label defaults to the camelCase attribute name; apps pin exact messages per
- * attribute through the `*Message` overrides.
- * @typedef {object} SyncAttributeSchemaEntry
- * @property {"date" | "json" | "raw" | "string"} type - Attribute value type.
- * @property {boolean} [required] - Whether present blank/absent values are rejected (strings reject blank-after-trim, dates reject null).
- * @property {number} [maxLength] - Maximum string length, checked after trimming.
- * @property {string} [label] - Label used in derived messages and codes.
- * @property {string} [column] - Output column key. Defaults to the snake_cased attribute name.
- * @property {string} [requiredMessage] - Pinned message for required rejections.
- * @property {string} [tooLongMessage] - Pinned message for too-long rejections.
- * @property {string} [invalidMessage] - Pinned message for invalid dates and non-object/non-string json values.
- * @property {string} [invalidJsonMessage] - Pinned message for unparseable json strings.
- */
-
-/**
- * Normalizes writable sync attributes against a declarative schema.
- *
- * Only present keys are validated, so required attributes may be absent —
- * create defaults own that concern. Input keys not declared in the schema are
- * rejected by default so misspelled or read-only attributes fail loudly
- * instead of being silently discarded (`unknownAttributes: "ignore"` opts
- * out). Validation failures throw through the given error factory so apps
- * control the raised error class.
- * @param {object} args - Options.
- * @param {Record<string, ?>} args.attributes - Raw incoming attributes (camelCase and/or snake_case keys).
- * @param {SyncAttributeErrorFactory} args.errorFactory - Maps validation failures to thrown errors.
- * @param {Record<string, SyncAttributeSchemaEntry>} args.schema - Attribute schema keyed by camelCase attribute name.
- * @param {"error" | "ignore"} [args.unknownAttributes] - Unknown input-key handling. Defaults to "error".
- * @returns {Record<string, ?>} Normalized values keyed by snake_case column names.
- */
-export default function normalizeAttributesWithSchema({attributes, errorFactory, schema, unknownAttributes = "error"}) {
-  if (!attributes || typeof attributes != "object") throw new Error(`normalizeAttributesWithSchema requires an attributes object, got: ${String(attributes)}`)
-  if (typeof errorFactory != "function") throw new Error("normalizeAttributesWithSchema requires an errorFactory function")
-  if (!schema || typeof schema != "object") throw new Error(`normalizeAttributesWithSchema requires a schema object, got: ${String(schema)}`)
-  if (unknownAttributes != "error" && unknownAttributes != "ignore") {
-    throw new Error(`normalizeAttributesWithSchema unknownAttributes must be "error" or "ignore", got: ${String(unknownAttributes)}`)
-  }
-
-  /** @type {Record<string, ?>} */
-  const normalized = {}
-  /** @type {Set<string>} */
-  const knownInputKeys = new Set()
-
-  for (const [attributeName, entry] of Object.entries(schema)) {
-    const column = entry.column ?? snakeCaseKey(attributeName)
-    const inputKeys = column == attributeName ? [attributeName] : [column, attributeName]
-
-    for (const inputKey of inputKeys) {
-      knownInputKeys.add(inputKey)
-
-      if (!Object.prototype.hasOwnProperty.call(attributes, inputKey)) continue
-
-      normalized[column] = normalizeAttributeValue({attributeName, entry, errorFactory, value: attributes[inputKey]})
-    }
-  }
-
-  if (unknownAttributes == "error") {
-    for (const inputKey of Object.keys(attributes)) {
-      if (!knownInputKeys.has(inputKey)) {
-        throw errorFactory(`Unknown attribute: ${inputKey}.`, {code: "sync-unknown-attribute"})
-      }
-    }
-  }
-
-  return normalized
-}
-
-/**
- * Normalizes one present attribute value per its schema entry.
- * @param {object} args - Options.
- * @param {string} args.attributeName - camelCase attribute name.
- * @param {SyncAttributeSchemaEntry} args.entry - Schema entry.
- * @param {SyncAttributeErrorFactory} args.errorFactory - Error factory.
- * @param {?} args.value - Raw value.
- * @returns {?} Normalized value.
- */
-function normalizeAttributeValue({attributeName, entry, errorFactory, value}) {
-  const label = entry.label ?? attributeName
-
-  if (entry.type == "string") return normalizeString({entry, errorFactory, label, value})
-  if (entry.type == "date") return normalizeDate({entry, errorFactory, label, value})
-  if (entry.type == "json") return normalizeJson({entry, errorFactory, label, value})
-  if (entry.type == "raw") return value
-
-  throw new Error(`Unknown sync attribute schema type for ${attributeName}: ${String(entry.type)}`)
-}
-
-/**
- * Normalizes a string attribute: trims, rejects blank required values after trimming, maps empty optional values to null and bounds the trimmed length.
- * @param {object} args - Options.
- * @param {SyncAttributeSchemaEntry} args.entry - Schema entry.
- * @param {SyncAttributeErrorFactory} args.errorFactory - Error factory.
- * @param {string} args.label - Message/code label.
- * @param {?} args.value - Raw value.
- * @returns {string | null} Normalized string.
- */
-function normalizeString({entry, errorFactory, label, value}) {
-  const requiredError = () => errorFactory(entry.requiredMessage ?? `${label} is required.`, {code: `sync-${label}-required`})
-
-  if (value === null || value === undefined || value === "") {
-    if (entry.required) throw requiredError()
-
-    return null
-  }
-
-  const stringValue = String(value).trim()
-
-  if (stringValue === "") {
-    if (entry.required) throw requiredError()
-
-    return null
-  }
-
-  if (entry.maxLength !== undefined && stringValue.length > entry.maxLength) {
-    throw errorFactory(entry.tooLongMessage ?? `${label} is too long (maximum is ${entry.maxLength} characters).`, {code: `sync-${label}-too-long`})
-  }
-
-  return stringValue
-}
-
-/**
- * Normalizes a date attribute: Date instances pass through, strings/numbers are parsed and invalid or missing-required values are rejected.
- * @param {object} args - Options.
- * @param {SyncAttributeSchemaEntry} args.entry - Schema entry.
- * @param {SyncAttributeErrorFactory} args.errorFactory - Error factory.
- * @param {string} args.label - Message/code label.
- * @param {?} args.value - Raw value.
- * @returns {Date | null} Normalized date.
- */
-function normalizeDate({entry, errorFactory, label, value}) {
-  if (!entry.required && (value === null || value === undefined || value === "")) return null
-
-  const dateValue = value instanceof Date ? value : typeof value == "string" || typeof value == "number" ? new Date(value) : null
-
-  if (!dateValue || Number.isNaN(dateValue.getTime())) {
-    throw errorFactory(entry.invalidMessage ?? `${label} must be a valid datetime.`, {code: `sync-${label}-invalid-datetime`})
-  }
-
-  return dateValue
-}
-
-/**
- * Normalizes a json attribute: empty values become null, objects pass through, strings must parse as JSON and other types are rejected.
- * @param {object} args - Options.
- * @param {SyncAttributeSchemaEntry} args.entry - Schema entry.
- * @param {SyncAttributeErrorFactory} args.errorFactory - Error factory.
- * @param {string} args.label - Message/code label.
- * @param {?} args.value - Raw value.
- * @returns {?} Normalized json value.
- */
-function normalizeJson({entry, errorFactory, label, value}) {
-  if (value === null || value === undefined || value === "") return null
-  if (typeof value == "object") return value
-
-  if (typeof value == "string") {
-    try {
-      return JSON.parse(value)
-    } catch (error) {
-      throw errorFactory(entry.invalidJsonMessage ?? `${label} must be valid JSON.`, {
-        cause: /** @type {Error} */ (error),
-        code: `sync-${label}-invalid-json`
-      })
-    }
-  }
-
-  throw errorFactory(entry.invalidMessage ?? `${label} must be an object or JSON string.`, {code: `sync-${label}-invalid`})
-}