velocious 1.0.595 → 1.0.597

package/build/mailer/delivery-operation-store.js

@@ -0,0 +1,152 @@
+// @ts-check
+
+import BackgroundJobsStore from "../background-jobs/store.js"
+import VelociousError from "../velocious-error.js"
+import {
+  MAIL_DELIVERY_OPERATIONS_TABLE,
+  mailDeliveryOperationKey,
+  validateAttemptPayload
+} from "./delivery-operation.js"
+
+/**
+ * Durable first-attempt and retention guard for required mail operations.
+ */
+export default class MailerDeliveryOperationStore {
+  /**
+   * Creates a durable mail-operation state guard.
+   * @param {object} args - Store input.
+   * @param {import("../configuration.js").default} args.configuration - Active configuration.
+   * @param {() => number} [args.clock] - Explicit clock dependency.
+   */
+  constructor({configuration, clock = () => Date.now()}) {
+    this.backgroundJobsStore = new BackgroundJobsStore({configuration})
+    this.clock = clock
+    this.configuration = configuration
+  }
+
+  /**
+   * Atomically starts the provider retention clock once and rejects expired attempts.
+   * @param {object} args - Attempt input.
+   * @param {import("./index.js").MailerDeliveryIdempotencyCapability} args.capability - Current backend capability.
+   * @param {import("./index.js").MailerDeliveryPayload} args.payload - Persisted payload.
+   * @returns {Promise<{expiresAtMs: number, firstAttemptStartedAtMs: number}>} - Attempt window.
+   */
+  async beginAttempt({capability, payload}) {
+    const operation = validateAttemptPayload({capability, payload})
+    const nowMs = this.clock()
+
+    if (!Number.isSafeInteger(nowMs) || nowMs < 0) throw new Error("Mailer delivery operation clock must return a non-negative safe integer")
+
+    const databaseIdentifier = this.backgroundJobsStore.getDatabaseIdentifier()
+
+    return await this.configuration.ensureConnections({
+      databaseIdentifiers: [databaseIdentifier],
+      name: "Mailer delivery operation attempt"
+    }, async (dbs) => {
+      const db = dbs[databaseIdentifier]
+
+      if (db.insideTransaction()) {
+        throw VelociousError.safe("Required mail delivery cannot start inside an existing database transaction.", {
+          code: "mail-delivery-idempotency-transaction-active"
+        })
+      }
+
+      await this.backgroundJobsStore.ensureSchema(db)
+
+      return await db.transaction(async () => {
+        const operationKey = mailDeliveryOperationKey(operation.id)
+
+        // A value-preserving structured update obtains the row's write lock on
+        // every driver before we inspect or initialize the one-shot timestamp.
+        await db.update({
+          tableName: MAIL_DELIVERY_OPERATIONS_TABLE,
+          data: {operation_key: operationKey},
+          conditions: {operation_key: operationKey}
+        })
+        let row = await this._operationRow(db, operation.id)
+
+        if (!row) throw new Error("Required mail delivery operation is not durably registered")
+        this._validateRow({operation, row})
+
+        let firstAttemptStartedAtMs = numberOrNull(row.first_attempt_started_at_ms)
+
+        if (firstAttemptStartedAtMs === null) {
+          await db.update({
+            tableName: MAIL_DELIVERY_OPERATIONS_TABLE,
+            data: {first_attempt_started_at_ms: nowMs},
+            conditions: {operation_key: operationKey}
+          })
+          row = await this._operationRow(db, operation.id)
+          firstAttemptStartedAtMs = row ? numberOrNull(row.first_attempt_started_at_ms) : null
+
+          if (firstAttemptStartedAtMs === null) throw new Error("Failed to durably start mail delivery provider retention")
+        }
+
+        const expiresAtMs = firstAttemptStartedAtMs + operation.providerRetentionMs
+
+        if (nowMs >= expiresAtMs) {
+          throw VelociousError.safe("The required mail delivery idempotency window expired before another attempt.", {
+            code: "mail-delivery-idempotency-expired",
+            details: {
+              expiresAtMs,
+              firstAttemptStartedAtMs,
+              operationId: operation.id,
+              providerKind: operation.providerKind
+            }
+          })
+        }
+
+        return {expiresAtMs, firstAttemptStartedAtMs}
+      })
+    })
+  }
+
+  /**
+   * Loads one operation by its fixed-size digest key.
+   * @param {import("../database/drivers/base.js").default} db - Database connection.
+   * @param {string} operationId - Operation id.
+   * @returns {Promise<Record<string, ReturnType<typeof JSON.parse>> | null>} - Row or null.
+   */
+  async _operationRow(db, operationId) {
+    const rows = await db
+      .newQuery()
+      .from(MAIL_DELIVERY_OPERATIONS_TABLE)
+      .where({operation_key: mailDeliveryOperationKey(operationId)})
+      .limit(1)
+      .results()
+
+    return rows[0] ? /** @type {Record<string, ReturnType<typeof JSON.parse>>} */ (rows[0]) : null
+  }
+
+  /**
+   * Validates immutable durable fields without including mail content in failures.
+   * @param {object} args - Validation input.
+   * @param {import("./index.js").MailerDeliveryOperation} args.operation - Persisted payload operation.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} args.row - Durable operation row.
+   * @returns {void}
+   */
+  _validateRow({operation, row}) {
+    const matches = String(row.operation_id) === operation.id
+      && String(row.payload_digest) === operation.payloadDigest
+      && String(row.provider_kind) === operation.providerKind
+      && numberOrNull(row.provider_retention_ms) === operation.providerRetentionMs
+
+    if (!matches) {
+      throw VelociousError.safe("The durable mail delivery operation does not match the persisted payload or provider.", {
+        code: "mail-delivery-idempotency-conflict"
+      })
+    }
+  }
+}
+
+/**
+ * Normalizes a database integer.
+ * @param {ReturnType<typeof JSON.parse>} value - Database value.
+ * @returns {number | null} - Number or null.
+ */
+function numberOrNull(value) {
+  if (value === null || value === undefined || value === "") return null
+  const number = Number(value)
+
+  return Number.isNaN(number) ? null : number
+}

package/build/mailer/delivery-operation.js

@@ -0,0 +1,205 @@
+// @ts-check
+
+import {createHash} from "crypto"
+import VelociousError from "../velocious-error.js"
+import stableJsonStringify from "../utils/stable-json.js"
+
+export const MAIL_DELIVERY_JOB_NAME = "MailDeliveryJob"
+export const MAIL_DELIVERY_OPERATIONS_TABLE = "mailer_delivery_operations"
+const PAYLOAD_DIGEST_FORMAT = "velocious-mail-delivery-payload-v1"
+
+/**
+ * Reads and validates a backend's provider idempotency capability.
+ * @param {object} args - Capability input.
+ * @param {import("../configuration-types.js").MailerBackend | undefined} args.backend - Configured backend.
+ * @param {import("./index.js").MailerDeliveryOperationRequest | import("./index.js").MailerDeliveryOperation} args.deliveryOperation - Required operation.
+ * @param {import("./index.js").MailerDeliveryPayload} args.payload - Rendered or persisted payload.
+ * @returns {import("./index.js").MailerDeliveryIdempotencyCapability} - Capability.
+ */
+export function requireDeliveryIdempotencyCapability({backend, deliveryOperation, payload}) {
+  if (!backend || typeof backend.deliveryIdempotencyCapability !== "function") {
+    throw VelociousError.safe("The configured mailer backend does not support required provider idempotency.", {
+      code: "mail-delivery-idempotency-unsupported"
+    })
+  }
+
+  const capability = backend.deliveryIdempotencyCapability()
+
+  if (!capability || typeof capability.providerKind !== "string" || capability.providerKind.length === 0) {
+    throw new Error("Mailer backend delivery idempotency capability requires a non-empty providerKind")
+  }
+  if (!Number.isSafeInteger(capability.retentionMs) || capability.retentionMs <= 0) {
+    throw new Error("Mailer backend delivery idempotency capability requires a positive safe-integer retentionMs")
+  }
+
+  if (typeof backend.validateDeliveryOperation === "function") {
+    backend.validateDeliveryOperation({deliveryOperation, payload})
+  }
+
+  return capability
+}
+
+/**
+ * Normalizes one public required operation into immutable payload metadata.
+ * @param {object} args - Preparation input.
+ * @param {import("./index.js").MailerDeliveryIdempotencyCapability} args.capability - Backend capability.
+ * @param {import("./index.js").MailerDeliveryOperationRequest} args.deliveryOperation - Public operation request.
+ * @param {import("./index.js").MailerDeliveryPayload} args.payload - Rendered payload.
+ * @returns {import("./index.js").MailerDeliveryPayload} - Payload with immutable operation metadata.
+ */
+export function prepareRequiredDeliveryPayload({capability, deliveryOperation, payload}) {
+  validateDeliveryOperationRequest(deliveryOperation)
+  const payloadDigest = mailDeliveryPayloadDigest({operationId: deliveryOperation.id, payload})
+
+  return {
+    ...payload,
+    deliveryOperation: {
+      id: deliveryOperation.id,
+      idempotency: "required",
+      payloadDigest,
+      providerKind: capability.providerKind,
+      providerRetentionMs: capability.retentionMs
+    }
+  }
+}
+
+/**
+ * Builds the versioned digest for every recipient-visible/provider-relevant payload field.
+ * @param {object} args - Digest input.
+ * @param {string} args.operationId - Stable operation id.
+ * @param {import("./index.js").MailerDeliveryPayload} args.payload - Rendered payload.
+ * @returns {string} - Versioned SHA-256 digest.
+ */
+export function mailDeliveryPayloadDigest({operationId, payload}) {
+  const canonicalPayload = {
+    action: payload.action,
+    bcc: payload.bcc ?? null,
+    cc: payload.cc ?? null,
+    format: PAYLOAD_DIGEST_FORMAT,
+    from: payload.from ?? null,
+    headers: canonicalHeaders(payload.headers),
+    html: payload.html,
+    mailer: payload.mailer,
+    operationId,
+    replyTo: payload.replyTo ?? null,
+    subject: payload.subject,
+    to: payload.to
+  }
+  const digest = createHash("sha256").update(stableJsonStringify(canonicalPayload)).digest("hex")
+
+  return `sha256:v1:${digest}`
+}
+
+/**
+ * Extracts validated persisted operation metadata from a payload.
+ * @param {import("./index.js").MailerDeliveryPayload} payload - Mail payload.
+ * @returns {import("./index.js").MailerDeliveryOperation | null} - Operation or null.
+ */
+export function deliveryOperationFromPayload(payload) {
+  const operation = payload.deliveryOperation
+
+  if (!operation) return null
+  if (operation.idempotency !== "required") throw new Error("Persisted mail delivery operation idempotency must be required")
+  if (typeof operation.id !== "string" || operation.id.length === 0) throw new Error("Persisted mail delivery operation requires an id")
+  if (typeof operation.payloadDigest !== "string" || !operation.payloadDigest.startsWith("sha256:v1:")) throw new Error("Persisted mail delivery operation requires a versioned payload digest")
+  if (typeof operation.providerKind !== "string" || operation.providerKind.length === 0) throw new Error("Persisted mail delivery operation requires a provider kind")
+  if (!Number.isSafeInteger(operation.providerRetentionMs) || operation.providerRetentionMs <= 0) throw new Error("Persisted mail delivery operation requires a positive retention")
+
+  return operation
+}
+
+/**
+ * Extracts a built-in mail operation from generic job arguments.
+ * @param {string} jobName - Job class name.
+ * @param {Array<ReturnType<typeof JSON.parse>>} args - Job arguments.
+ * @returns {{operation: import("./index.js").MailerDeliveryOperation, payload: import("./index.js").MailerDeliveryPayload} | null} - Mail operation input.
+ */
+export function mailDeliveryOperationForJob(jobName, args) {
+  if (jobName !== MAIL_DELIVERY_JOB_NAME || !args[0] || typeof args[0] !== "object" || Array.isArray(args[0])) return null
+
+  const payload = /** @type {import("./index.js").MailerDeliveryPayload} */ (args[0])
+  const operation = deliveryOperationFromPayload(payload)
+
+  return operation ? {operation, payload} : null
+}
+
+/**
+ * Fixed-size primary key for a potentially long operation id.
+ * @param {string} operationId - Operation id.
+ * @returns {string} - SHA-256 operation key.
+ */
+export function mailDeliveryOperationKey(operationId) {
+  return createHash("sha256").update(`velocious-mail-delivery-operation:${operationId}`).digest("hex")
+}
+
+/**
+ * Validates provider compatibility and payload integrity before an attempt.
+ * @param {object} args - Validation input.
+ * @param {import("./index.js").MailerDeliveryIdempotencyCapability} args.capability - Current backend capability.
+ * @param {import("./index.js").MailerDeliveryPayload} args.payload - Persisted payload.
+ * @returns {import("./index.js").MailerDeliveryOperation} - Persisted operation.
+ */
+export function validateAttemptPayload({capability, payload}) {
+  const operation = deliveryOperationFromPayload(payload)
+
+  if (!operation) throw new Error("Expected a persisted mail delivery operation")
+  if (operation.providerKind !== capability.providerKind || operation.providerRetentionMs !== capability.retentionMs) {
+    throw VelociousError.safe("The configured mailer backend no longer matches the required delivery operation provider.", {
+      code: "mail-delivery-idempotency-provider-mismatch"
+    })
+  }
+
+  const currentDigest = mailDeliveryPayloadDigest({operationId: operation.id, payload})
+
+  if (currentDigest !== operation.payloadDigest) {
+    throw VelociousError.safe("The persisted mail delivery payload digest does not match its required operation.", {
+      code: "mail-delivery-idempotency-payload-mismatch"
+    })
+  }
+
+  return operation
+}
+
+/**
+ * Validates the public operation shape without accepting future semantics silently.
+ * @param {import("./index.js").MailerDeliveryOperationRequest} deliveryOperation - Public operation.
+ * @returns {void}
+ */
+function validateDeliveryOperationRequest(deliveryOperation) {
+  if (!deliveryOperation || typeof deliveryOperation !== "object" || Array.isArray(deliveryOperation)) {
+    throw VelociousError.safe("deliveryOperation must be an object.", {code: "mail-delivery-operation-invalid"})
+  }
+  if (typeof deliveryOperation.id !== "string" || deliveryOperation.id.length === 0) {
+    throw VelociousError.safe("deliveryOperation.id must be a non-empty string.", {code: "mail-delivery-operation-invalid"})
+  }
+  if (deliveryOperation.idempotency !== "required") {
+    throw VelociousError.safe('deliveryOperation.idempotency must be "required".', {code: "mail-delivery-operation-invalid"})
+  }
+
+  const keys = Object.keys(deliveryOperation)
+
+  if (keys.some((key) => key !== "id" && key !== "idempotency")) {
+    throw VelociousError.safe("deliveryOperation contains unsupported fields.", {code: "mail-delivery-operation-invalid"})
+  }
+}
+
+/**
+ * Canonicalizes case-insensitive custom headers without exposing values.
+ * @param {Record<string, string> | undefined} headers - Custom headers.
+ * @returns {Array<[string, string]>} - Sorted header pairs.
+ */
+function canonicalHeaders(headers) {
+  if (!headers) return []
+
+  const pairs = Object.entries(headers).map(([name, value]) => [name.toLowerCase(), value])
+  const names = new Set()
+
+  for (const [name] of pairs) {
+    if (names.has(name)) {
+      throw VelociousError.safe("Mail headers contain duplicate case-insensitive names.", {code: "mail-delivery-headers-invalid"})
+    }
+    names.add(name)
+  }
+
+  return /** @type {Array<[string, string]>} */ (pairs.sort(([left], [right]) => left.localeCompare(right)))
+}

package/build/mailer/delivery.js

@@ -1,5 +1,7 @@
 // @ts-check
 
+import restArgsError from "../utils/rest-args-error.js"
+
 /**
  * Represents a prepared mail delivery.
  */
@@ -52,19 +54,22 @@ export default class MailerDelivery {
 
   /**
    * Runs deliver later.
+   * @param {import("./index.js").MailerDeliveryLaterOptions} [options] - Delivery execution options.
    * @returns {Promise<string | import("./index.js").MailerDeliveryPayload | null>} - Job id or payload in test mode.
    */
-  async deliverLater() {
+  async deliverLater({deliveryOperation, ...restArgs} = {}) {
+    restArgsError(restArgs)
     const payload = await this.buildPayload()
 
-    return await this.mailer._enqueuePayload(payload)
+    return await this.mailer._enqueuePayload(payload, {deliveryOperation})
   }
 
   /**
    * Runs deliver laver.
+   * @param {import("./index.js").MailerDeliveryLaterOptions} [options] - Delivery execution options.
    * @returns {Promise<string | import("./index.js").MailerDeliveryPayload | null>} - Job id or payload in test mode.
    */
-  async deliverLaver() {
-    return await this.deliverLater()
+  async deliverLaver(options) {
+    return await this.deliverLater(options)
   }
 }

package/build/mailer/index.js

@@ -1,6 +1,10 @@
 // @ts-check
 
-/** @typedef {{to: ReturnType<typeof JSON.parse>, subject: string, from?: ReturnType<typeof JSON.parse>, cc?: ReturnType<typeof JSON.parse>, bcc?: ReturnType<typeof JSON.parse>, replyTo?: ReturnType<typeof JSON.parse>, headers?: Record<string, string>, html: string, mailer: string, action: string}} MailerDeliveryPayload */
+/** @typedef {{id: string, idempotency: "required"}} MailerDeliveryOperationRequest */
+/** @typedef {{id: string, idempotency: "required", payloadDigest: string, providerKind: string, providerRetentionMs: number}} MailerDeliveryOperation */
+/** @typedef {{providerKind: string, retentionMs: number}} MailerDeliveryIdempotencyCapability */
+/** @typedef {{deliveryOperation?: MailerDeliveryOperationRequest}} MailerDeliveryLaterOptions */
+/** @typedef {{to: ReturnType<typeof JSON.parse>, subject: string, from?: ReturnType<typeof JSON.parse>, cc?: ReturnType<typeof JSON.parse>, bcc?: ReturnType<typeof JSON.parse>, replyTo?: ReturnType<typeof JSON.parse>, headers?: Record<string, string>, html: string, mailer: string, action: string, deliveryOperation?: MailerDeliveryOperation}} MailerDeliveryPayload */
 
 import {
   clearDeliveries,

package/build/mailer.js

@@ -1,6 +1,10 @@
 // @ts-check
 
-/** @typedef {{to: ReturnType<typeof JSON.parse>, subject: string, from?: ReturnType<typeof JSON.parse>, cc?: ReturnType<typeof JSON.parse>, bcc?: ReturnType<typeof JSON.parse>, replyTo?: ReturnType<typeof JSON.parse>, headers?: Record<string, string>, html: string, mailer: string, action: string}} MailerDeliveryPayload */
+/** @typedef {import("./mailer/index.js").MailerDeliveryOperationRequest} MailerDeliveryOperationRequest */
+/** @typedef {import("./mailer/index.js").MailerDeliveryOperation} MailerDeliveryOperation */
+/** @typedef {import("./mailer/index.js").MailerDeliveryIdempotencyCapability} MailerDeliveryIdempotencyCapability */
+/** @typedef {import("./mailer/index.js").MailerDeliveryLaterOptions} MailerDeliveryLaterOptions */
+/** @typedef {import("./mailer/index.js").MailerDeliveryPayload} MailerDeliveryPayload */
 
 export {
   VelociousMailerBase,
@@ -12,4 +16,5 @@ export {
   setDeliveryHandler
 } from "./mailer/index.js"
 export {default as SmtpMailerBackend} from "./mailer/backends/smtp.js"
+export {default as ResendSmtpMailerBackend} from "./mailer/backends/resend-smtp.js"
 export {default} from "./mailer/index.js"

package/build/src/background-jobs/pooled-runner-broker-identity.d.ts

@@ -23,9 +23,10 @@ export default class PooledRunnerBrokerIdentity {
     /**
      * Prepares one identity, sharing an in-flight same-identity rotation.
      * @param {import("../testing/shared-transaction-proxy-driver.js").SharedTransactionBrokerJobConfig} config - Dispatch configuration.
+     * @param {boolean} [admissionReserved] - Whether the caller already reserved its active-user slot.
      * @returns {Promise<void>} - Resolves after stale connections close.
      */
-    prepare(config: import("../testing/shared-transaction-proxy-driver.js").SharedTransactionBrokerJobConfig): Promise<void>;
+    prepare(config: import("../testing/shared-transaction-proxy-driver.js").SharedTransactionBrokerJobConfig, admissionReserved?: boolean): Promise<void>;
     /**
      * Runs work while preventing a different identity from replacing its connections.
      * @template T
@@ -34,6 +35,14 @@ export default class PooledRunnerBrokerIdentity {
      * @returns {Promise<T>} - Job result.
      */
     run<T>(config: import("../testing/shared-transaction-proxy-driver.js").SharedTransactionBrokerJobConfig, callback: () => Promise<T>): Promise<T>;
+    /**
+     * Atomically prepares an attempt identity and reserves its active user. Without
+     * this admission turn, another capability can rotate connections after `prepare`
+     * resolves but before `run` increments `activeUsers`.
+     * @param {import("../testing/shared-transaction-proxy-driver.js").SharedTransactionBrokerJobConfig} config - Dispatch configuration.
+     * @returns {Promise<void>} - Resolves after admission is reserved.
+     */
+    admit(config: import("../testing/shared-transaction-proxy-driver.js").SharedTransactionBrokerJobConfig): Promise<void>;
     /**
      * Rotates retained connection state to an identity.
      * @param {string} identity - Target identity.

package/build/src/background-jobs/pooled-runner-broker-identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pooled-runner-broker-identity.d.ts","sourceRoot":"","sources":["../../../src/background-jobs/pooled-runner-broker-identity.js"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,OAAO,0BAA0B;IAMtC,gBAAgB,QAHa,OAAO,CAAC,IAAI,CAAC;IAI/C,iCAAiC;IAC5B,cAAc,EADR,MAAM,GAAG,SAAS;IAE7B,qEAAqE;IAChE,OAAO,EADD;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;KAAC,GAAG,SAAS;IAE5D,WAAW;IAVlB;;;OAGG;IACH,YAAY,EAAC,gBAAgB,EAAC,EAFnB;QAAC,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAEnB,EAO7B;IAED;;;OAGG;IACH,OAAO,IAFM,MAAM,GAAG,SAAS,CAES;IAExC;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAHT,OAAO,+CAA+C,EAAE,gCAG/C,GAFP,OAAO,CAAC,IAAI,CAAC,CAsBzB;IAED;;;;;;OAMG;IACG,GAAG,CALI,CAAC,EAKJ,MAAM,EAJL,OAAO,+CAA+C,EAAE,gCAInD,EAAE,QAAQ,EAHf,MAAM,OAAO,CAAC,CAAC,CAGA,GAFb,OAAO,CAAC,CAAC,CAAC,CAUtB;IAED;;;;OAIG;IACG,MAAM,CAAC,QAAQ,EAHV,MAGU,GAFR,OAAO,CAAC,IAAI,CAAC,CAKzB;CACF"}
+{"version":3,"file":"pooled-runner-broker-identity.d.ts","sourceRoot":"","sources":["../../../src/background-jobs/pooled-runner-broker-identity.js"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,OAAO,0BAA0B;IAMtC,gBAAgB,QAHa,OAAO,CAAC,IAAI,CAAC;IAI/C,iCAAiC;IAC5B,cAAc,EADR,MAAM,GAAG,SAAS;IAE7B,qEAAqE;IAChE,OAAO,EADD;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;KAAC,GAAG,SAAS;IAE5D,WAAW;IAVlB;;;OAGG;IACH,YAAY,EAAC,gBAAgB,EAAC,EAFnB;QAAC,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAEnB,EAO7B;IAED;;;OAGG;IACH,OAAO,IAFM,MAAM,GAAG,SAAS,CAES;IAExC;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAJT,OAAO,+CAA+C,EAAE,gCAI/C,EAAE,iBAAiB,AAHpC,CACA,EADQ,OAGoC,GAFlC,OAAO,CAAC,IAAI,CAAC,CAuBzB;IAED;;;;;;OAMG;IACG,GAAG,CALI,CAAC,EAKJ,MAAM,EAJL,OAAO,+CAA+C,EAAE,gCAInD,EAAE,QAAQ,EAHf,MAAM,OAAO,CAAC,CAAC,CAGA,GAFb,OAAO,CAAC,CAAC,CAAC,CAStB;IAED;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAHP,OAAO,+CAA+C,EAAE,gCAGjD,GAFL,OAAO,CAAC,IAAI,CAAC,CAUzB;IAED;;;;OAIG;IACG,MAAM,CAAC,QAAQ,EAHV,MAGU,GAFR,OAAO,CAAC,IAAI,CAAC,CAKzB;CACF"}

package/build/src/background-jobs/pooled-runner-broker-identity.js

@@ -20,9 +20,10 @@ export default class PooledRunnerBrokerIdentity {
     /**
      * Prepares one identity, sharing an in-flight same-identity rotation.
      * @param {import("../testing/shared-transaction-proxy-driver.js").SharedTransactionBrokerJobConfig} config - Dispatch configuration.
+     * @param {boolean} [admissionReserved] - Whether the caller already reserved its active-user slot.
      * @returns {Promise<void>} - Resolves after stale connections close.
      */
-    async prepare(config) {
+    async prepare(config, admissionReserved = false) {
         const identity = JSON.stringify(config);
         if (this.pending) {
             if (this.pending.identity !== identity)
@@ -31,7 +32,8 @@ export default class PooledRunnerBrokerIdentity {
         }
         if (this.activeIdentity === identity)
             return;
-        if (this.activeUsers > 0)
+        const otherActiveUsers = this.activeUsers - (admissionReserved ? 1 : 0);
+        if (otherActiveUsers > 0)
             throw new Error("Pooled runner cannot mix shared transaction broker capabilities concurrently");
         if (this.activeIdentity === undefined) {
             this.activeIdentity = identity;
@@ -54,8 +56,7 @@ export default class PooledRunnerBrokerIdentity {
      * @returns {Promise<T>} - Job result.
      */
     async run(config, callback) {
-        await this.prepare(config);
-        this.activeUsers++;
+        await this.admit(config);
         try {
             return await callback();
         }
@@ -63,6 +64,23 @@ export default class PooledRunnerBrokerIdentity {
             this.activeUsers--;
         }
     }
+    /**
+     * Atomically prepares an attempt identity and reserves its active user. Without
+     * this admission turn, another capability can rotate connections after `prepare`
+     * resolves but before `run` increments `activeUsers`.
+     * @param {import("../testing/shared-transaction-proxy-driver.js").SharedTransactionBrokerJobConfig} config - Dispatch configuration.
+     * @returns {Promise<void>} - Resolves after admission is reserved.
+     */
+    async admit(config) {
+        this.activeUsers++;
+        try {
+            await this.prepare(config, true);
+        }
+        catch (error) {
+            this.activeUsers--;
+            throw error;
+        }
+    }
     /**
      * Rotates retained connection state to an identity.
      * @param {string} identity - Target identity.
@@ -73,4 +91,4 @@ export default class PooledRunnerBrokerIdentity {
         this.activeIdentity = identity;
     }
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicG9vbGVkLXJ1bm5lci1icm9rZXItaWRlbnRpdHkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmFja2dyb3VuZC1qb2JzL3Bvb2xlZC1ydW5uZXItYnJva2VyLWlkZW50aXR5LmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLFlBQVk7QUFFWixNQUFNLENBQUMsT0FBTyxPQUFPLDBCQUEwQjtJQUM3Qzs7O09BR0c7SUFDSCxZQUFZLEVBQUMsZ0JBQWdCLEVBQUM7UUFDNUIsSUFBSSxDQUFDLGdCQUFnQixHQUFHLGdCQUFnQixDQUFBO1FBQ3hDLGlDQUFpQztRQUNqQyxJQUFJLENBQUMsY0FBYyxHQUFHLFNBQVMsQ0FBQTtRQUMvQixxRUFBcUU7UUFDckUsSUFBSSxDQUFDLE9BQU8sR0FBRyxTQUFTLENBQUE7UUFDeEIsSUFBSSxDQUFDLFdBQVcsR0FBRyxDQUFDLENBQUE7SUFDdEIsQ0FBQztJQUVEOzs7T0FHRztJQUNILE9BQU8sS0FBSyxPQUFPLElBQUksQ0FBQyxjQUFjLENBQUEsQ0FBQyxDQUFDO0lBRXhDOzs7O09BSUc7SUFDSCxLQUFLLENBQUMsT0FBTyxDQUFDLE1BQU07UUFDbEIsTUFBTSxRQUFRLEdBQUcsSUFBSSxDQUFDLFNBQVMsQ0FBQyxNQUFNLENBQUMsQ0FBQTtRQUN2QyxJQUFJLElBQUksQ0FBQyxPQUFPLEVBQUUsQ0FBQztZQUNqQixJQUFJLElBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxLQUFLLFFBQVE7Z0JBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyw4RUFBOEUsQ0FBQyxDQUFBO1lBQ3ZJLE9BQU8sTUFBTSxJQUFJLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQTtRQUNuQyxDQUFDO1FBQ0QsSUFBSSxJQUFJLENBQUMsY0FBYyxLQUFLLFFBQVE7WUFBRSxPQUFNO1FBQzVDLElBQUksSUFBSSxDQUFDLFdBQVcsR0FBRyxDQUFDO1lBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyw4RUFBOEUsQ0FBQyxDQUFBO1FBQ3pILElBQUksSUFBSSxDQUFDLGNBQWMsS0FBSyxTQUFTLEVBQUUsQ0FBQztZQUN0QyxJQUFJLENBQUMsY0FBYyxHQUFHLFFBQVEsQ0FBQTtZQUM5QixPQUFNO1FBQ1IsQ0FBQztRQUVELE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQyxNQUFNLENBQUMsUUFBUSxDQUFDLENBQUE7UUFDckMsSUFBSSxDQUFDLE9BQU8sR0FBRyxFQUFDLFFBQVEsRUFBRSxPQUFPLEVBQUMsQ0FBQTtRQUNsQyxJQUFJLENBQUM7WUFDSCxNQUFNLE9BQU8sQ0FBQTtRQUNmLENBQUM7Z0JBQVMsQ0FBQztZQUNULElBQUksQ0FBQyxPQUFPLEdBQUcsU0FBUyxDQUFBO1FBQzFCLENBQUM7SUFDSCxDQUFDO0lBRUQ7Ozs7OztPQU1HO0lBQ0gsS0FBSyxDQUFDLEdBQUcsQ0FBQyxNQUFNLEVBQUUsUUFBUTtRQUN4QixNQUFNLElBQUksQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLENBQUE7UUFDMUIsSUFBSSxDQUFDLFdBQVcsRUFBRSxDQUFBO1FBQ2xCLElBQUksQ0FBQztZQUNILE9BQU8sTUFBTSxRQUFRLEVBQUUsQ0FBQTtRQUN6QixDQUFDO2dCQUFTLENBQUM7WUFDVCxJQUFJLENBQUMsV0FBVyxFQUFFLENBQUE7UUFDcEIsQ0FBQztJQUNILENBQUM7SUFFRDs7OztPQUlHO0lBQ0gsS0FBSyxDQUFDLE1BQU0sQ0FBQyxRQUFRO1FBQ25CLE1BQU0sSUFBSSxDQUFDLGdCQUFnQixFQUFFLENBQUE7UUFDN0IsSUFBSSxDQUFDLGNBQWMsR0FBRyxRQUFRLENBQUE7SUFDaEMsQ0FBQztDQUNGIiwic291cmNlc0NvbnRlbnQiOlsiLy8gQHRzLWNoZWNrXG5cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIFBvb2xlZFJ1bm5lckJyb2tlcklkZW50aXR5IHtcbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBwb29sZWQgcnVubmVyIGlkZW50aXR5IGNvb3JkaW5hdG9yLlxuICAgKiBAcGFyYW0ge3tjbG9zZUNvbm5lY3Rpb25zOiAoKSA9PiBQcm9taXNlPHZvaWQ+fX0gYXJncyAtIENvbm5lY3Rpb24gY2xlYW51cCBob29rLlxuICAgKi9cbiAgY29uc3RydWN0b3Ioe2Nsb3NlQ29ubmVjdGlvbnN9KSB7XG4gICAgdGhpcy5jbG9zZUNvbm5lY3Rpb25zID0gY2xvc2VDb25uZWN0aW9uc1xuICAgIC8qKiBAdHlwZSB7c3RyaW5nIHwgdW5kZWZpbmVkfSAqL1xuICAgIHRoaXMuYWN0aXZlSWRlbnRpdHkgPSB1bmRlZmluZWRcbiAgICAvKiogQHR5cGUge3tpZGVudGl0eTogc3RyaW5nLCBwcm9taXNlOiBQcm9taXNlPHZvaWQ+fSB8IHVuZGVmaW5lZH0gKi9cbiAgICB0aGlzLnBlbmRpbmcgPSB1bmRlZmluZWRcbiAgICB0aGlzLmFjdGl2ZVVzZXJzID0gMFxuICB9XG5cbiAgLyoqXG4gICAqIEdldHMgdGhlIGN1cnJlbnQgcHJlcGFyZWQgaWRlbnRpdHkuXG4gICAqIEByZXR1cm5zIHtzdHJpbmcgfCB1bmRlZmluZWR9IC0gQ3VycmVudCBwcmVwYXJlZCBpZGVudGl0eS5cbiAgICovXG4gIGN1cnJlbnQoKSB7IHJldHVybiB0aGlzLmFjdGl2ZUlkZW50aXR5IH1cblxuICAvKipcbiAgICogUHJlcGFyZXMgb25lIGlkZW50aXR5LCBzaGFyaW5nIGFuIGluLWZsaWdodCBzYW1lLWlkZW50aXR5IHJvdGF0aW9uLlxuICAgKiBAcGFyYW0ge2ltcG9ydChcIi4uL3Rlc3Rpbmcvc2hhcmVkLXRyYW5zYWN0aW9uLXByb3h5LWRyaXZlci5qc1wiKS5TaGFyZWRUcmFuc2FjdGlvbkJyb2tlckpvYkNvbmZpZ30gY29uZmlnIC0gRGlzcGF0Y2ggY29uZmlndXJhdGlvbi5cbiAgICogQHJldHVybnMge1Byb21pc2U8dm9pZD59IC0gUmVzb2x2ZXMgYWZ0ZXIgc3RhbGUgY29ubmVjdGlvbnMgY2xvc2UuXG4gICAqL1xuICBhc3luYyBwcmVwYXJlKGNvbmZpZykge1xuICAgIGNvbnN0IGlkZW50aXR5ID0gSlNPTi5zdHJpbmdpZnkoY29uZmlnKVxuICAgIGlmICh0aGlzLnBlbmRpbmcpIHtcbiAgICAgIGlmICh0aGlzLnBlbmRpbmcuaWRlbnRpdHkgIT09IGlkZW50aXR5KSB0aHJvdyBuZXcgRXJyb3IoXCJQb29sZWQgcnVubmVyIGNhbm5vdCBtaXggc2hhcmVkIHRyYW5zYWN0aW9uIGJyb2tlciBjYXBhYmlsaXRpZXMgY29uY3VycmVudGx5XCIpXG4gICAgICByZXR1cm4gYXdhaXQgdGhpcy5wZW5kaW5nLnByb21pc2VcbiAgICB9XG4gICAgaWYgKHRoaXMuYWN0aXZlSWRlbnRpdHkgPT09IGlkZW50aXR5KSByZXR1cm5cbiAgICBpZiAodGhpcy5hY3RpdmVVc2VycyA+IDApIHRocm93IG5ldyBFcnJvcihcIlBvb2xlZCBydW5uZXIgY2Fubm90IG1peCBzaGFyZWQgdHJhbnNhY3Rpb24gYnJva2VyIGNhcGFiaWxpdGllcyBjb25jdXJyZW50bHlcIilcbiAgICBpZiAodGhpcy5hY3RpdmVJZGVudGl0eSA9PT0gdW5kZWZpbmVkKSB7XG4gICAgICB0aGlzLmFjdGl2ZUlkZW50aXR5ID0gaWRlbnRpdHlcbiAgICAgIHJldHVyblxuICAgIH1cblxuICAgIGNvbnN0IHByb21pc2UgPSB0aGlzLnJvdGF0ZShpZGVudGl0eSlcbiAgICB0aGlzLnBlbmRpbmcgPSB7aWRlbnRpdHksIHByb21pc2V9XG4gICAgdHJ5IHtcbiAgICAgIGF3YWl0IHByb21pc2VcbiAgICB9IGZpbmFsbHkge1xuICAgICAgdGhpcy5wZW5kaW5nID0gdW5kZWZpbmVkXG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIFJ1bnMgd29yayB3aGlsZSBwcmV2ZW50aW5nIGEgZGlmZmVyZW50IGlkZW50aXR5IGZyb20gcmVwbGFjaW5nIGl0cyBjb25uZWN0aW9ucy5cbiAgICogQHRlbXBsYXRlIFRcbiAgICogQHBhcmFtIHtpbXBvcnQoXCIuLi90ZXN0aW5nL3NoYXJlZC10cmFuc2FjdGlvbi1wcm94eS1kcml2ZXIuanNcIikuU2hhcmVkVHJhbnNhY3Rpb25Ccm9rZXJKb2JDb25maWd9IGNvbmZpZyAtIERpc3BhdGNoIGNvbmZpZ3VyYXRpb24uXG4gICAqIEBwYXJhbSB7KCkgPT4gUHJvbWlzZTxUPn0gY2FsbGJhY2sgLSBKb2IgY2FsbGJhY2suXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPFQ+fSAtIEpvYiByZXN1bHQuXG4gICAqL1xuICBhc3luYyBydW4oY29uZmlnLCBjYWxsYmFjaykge1xuICAgIGF3YWl0IHRoaXMucHJlcGFyZShjb25maWcpXG4gICAgdGhpcy5hY3RpdmVVc2VycysrXG4gICAgdHJ5IHtcbiAgICAgIHJldHVybiBhd2FpdCBjYWxsYmFjaygpXG4gICAgfSBmaW5hbGx5IHtcbiAgICAgIHRoaXMuYWN0aXZlVXNlcnMtLVxuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBSb3RhdGVzIHJldGFpbmVkIGNvbm5lY3Rpb24gc3RhdGUgdG8gYW4gaWRlbnRpdHkuXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBpZGVudGl0eSAtIFRhcmdldCBpZGVudGl0eS5cbiAgICogQHJldHVybnMge1Byb21pc2U8dm9pZD59IC0gUmVzb2x2ZXMgYWZ0ZXIgcm90YXRpb24uXG4gICAqL1xuICBhc3luYyByb3RhdGUoaWRlbnRpdHkpIHtcbiAgICBhd2FpdCB0aGlzLmNsb3NlQ29ubmVjdGlvbnMoKVxuICAgIHRoaXMuYWN0aXZlSWRlbnRpdHkgPSBpZGVudGl0eVxuICB9XG59XG4iXX0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicG9vbGVkLXJ1bm5lci1icm9rZXItaWRlbnRpdHkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmFja2dyb3VuZC1qb2JzL3Bvb2xlZC1ydW5uZXItYnJva2VyLWlkZW50aXR5LmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLFlBQVk7QUFFWixNQUFNLENBQUMsT0FBTyxPQUFPLDBCQUEwQjtJQUM3Qzs7O09BR0c7SUFDSCxZQUFZLEVBQUMsZ0JBQWdCLEVBQUM7UUFDNUIsSUFBSSxDQUFDLGdCQUFnQixHQUFHLGdCQUFnQixDQUFBO1FBQ3hDLGlDQUFpQztRQUNqQyxJQUFJLENBQUMsY0FBYyxHQUFHLFNBQVMsQ0FBQTtRQUMvQixxRUFBcUU7UUFDckUsSUFBSSxDQUFDLE9BQU8sR0FBRyxTQUFTLENBQUE7UUFDeEIsSUFBSSxDQUFDLFdBQVcsR0FBRyxDQUFDLENBQUE7SUFDdEIsQ0FBQztJQUVEOzs7T0FHRztJQUNILE9BQU8sS0FBSyxPQUFPLElBQUksQ0FBQyxjQUFjLENBQUEsQ0FBQyxDQUFDO0lBRXhDOzs7OztPQUtHO0lBQ0gsS0FBSyxDQUFDLE9BQU8sQ0FBQyxNQUFNLEVBQUUsaUJBQWlCLEdBQUcsS0FBSztRQUM3QyxNQUFNLFFBQVEsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDLE1BQU0sQ0FBQyxDQUFBO1FBQ3ZDLElBQUksSUFBSSxDQUFDLE9BQU8sRUFBRSxDQUFDO1lBQ2pCLElBQUksSUFBSSxDQUFDLE9BQU8sQ0FBQyxRQUFRLEtBQUssUUFBUTtnQkFBRSxNQUFNLElBQUksS0FBSyxDQUFDLDhFQUE4RSxDQUFDLENBQUE7WUFDdkksT0FBTyxNQUFNLElBQUksQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFBO1FBQ25DLENBQUM7UUFDRCxJQUFJLElBQUksQ0FBQyxjQUFjLEtBQUssUUFBUTtZQUFFLE9BQU07UUFDNUMsTUFBTSxnQkFBZ0IsR0FBRyxJQUFJLENBQUMsV0FBVyxHQUFHLENBQUMsaUJBQWlCLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUE7UUFDdkUsSUFBSSxnQkFBZ0IsR0FBRyxDQUFDO1lBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyw4RUFBOEUsQ0FBQyxDQUFBO1FBQ3pILElBQUksSUFBSSxDQUFDLGNBQWMsS0FBSyxTQUFTLEVBQUUsQ0FBQztZQUN0QyxJQUFJLENBQUMsY0FBYyxHQUFHLFFBQVEsQ0FBQTtZQUM5QixPQUFNO1FBQ1IsQ0FBQztRQUVELE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQyxNQUFNLENBQUMsUUFBUSxDQUFDLENBQUE7UUFDckMsSUFBSSxDQUFDLE9BQU8sR0FBRyxFQUFDLFFBQVEsRUFBRSxPQUFPLEVBQUMsQ0FBQTtRQUNsQyxJQUFJLENBQUM7WUFDSCxNQUFNLE9BQU8sQ0FBQTtRQUNmLENBQUM7Z0JBQVMsQ0FBQztZQUNULElBQUksQ0FBQyxPQUFPLEdBQUcsU0FBUyxDQUFBO1FBQzFCLENBQUM7SUFDSCxDQUFDO0lBRUQ7Ozs7OztPQU1HO0lBQ0gsS0FBSyxDQUFDLEdBQUcsQ0FBQyxNQUFNLEVBQUUsUUFBUTtRQUN4QixNQUFNLElBQUksQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLENBQUE7UUFDeEIsSUFBSSxDQUFDO1lBQ0gsT0FBTyxNQUFNLFFBQVEsRUFBRSxDQUFBO1FBQ3pCLENBQUM7Z0JBQVMsQ0FBQztZQUNULElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQTtRQUNwQixDQUFDO0lBQ0gsQ0FBQztJQUVEOzs7Ozs7T0FNRztJQUNILEtBQUssQ0FBQyxLQUFLLENBQUMsTUFBTTtRQUNoQixJQUFJLENBQUMsV0FBVyxFQUFFLENBQUE7UUFDbEIsSUFBSSxDQUFDO1lBQ0gsTUFBTSxJQUFJLENBQUMsT0FBTyxDQUFDLE1BQU0sRUFBRSxJQUFJLENBQUMsQ0FBQTtRQUNsQyxDQUFDO1FBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztZQUNmLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQTtZQUNsQixNQUFNLEtBQUssQ0FBQTtRQUNiLENBQUM7SUFDSCxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILEtBQUssQ0FBQyxNQUFNLENBQUMsUUFBUTtRQUNuQixNQUFNLElBQUksQ0FBQyxnQkFBZ0IsRUFBRSxDQUFBO1FBQzdCLElBQUksQ0FBQyxjQUFjLEdBQUcsUUFBUSxDQUFBO0lBQ2hDLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbIi8vIEB0cy1jaGVja1xuXG5leHBvcnQgZGVmYXVsdCBjbGFzcyBQb29sZWRSdW5uZXJCcm9rZXJJZGVudGl0eSB7XG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgcG9vbGVkIHJ1bm5lciBpZGVudGl0eSBjb29yZGluYXRvci5cbiAgICogQHBhcmFtIHt7Y2xvc2VDb25uZWN0aW9uczogKCkgPT4gUHJvbWlzZTx2b2lkPn19IGFyZ3MgLSBDb25uZWN0aW9uIGNsZWFudXAgaG9vay5cbiAgICovXG4gIGNvbnN0cnVjdG9yKHtjbG9zZUNvbm5lY3Rpb25zfSkge1xuICAgIHRoaXMuY2xvc2VDb25uZWN0aW9ucyA9IGNsb3NlQ29ubmVjdGlvbnNcbiAgICAvKiogQHR5cGUge3N0cmluZyB8IHVuZGVmaW5lZH0gKi9cbiAgICB0aGlzLmFjdGl2ZUlkZW50aXR5ID0gdW5kZWZpbmVkXG4gICAgLyoqIEB0eXBlIHt7aWRlbnRpdHk6IHN0cmluZywgcHJvbWlzZTogUHJvbWlzZTx2b2lkPn0gfCB1bmRlZmluZWR9ICovXG4gICAgdGhpcy5wZW5kaW5nID0gdW5kZWZpbmVkXG4gICAgdGhpcy5hY3RpdmVVc2VycyA9IDBcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXRzIHRoZSBjdXJyZW50IHByZXBhcmVkIGlkZW50aXR5LlxuICAgKiBAcmV0dXJucyB7c3RyaW5nIHwgdW5kZWZpbmVkfSAtIEN1cnJlbnQgcHJlcGFyZWQgaWRlbnRpdHkuXG4gICAqL1xuICBjdXJyZW50KCkgeyByZXR1cm4gdGhpcy5hY3RpdmVJZGVudGl0eSB9XG5cbiAgLyoqXG4gICAqIFByZXBhcmVzIG9uZSBpZGVudGl0eSwgc2hhcmluZyBhbiBpbi1mbGlnaHQgc2FtZS1pZGVudGl0eSByb3RhdGlvbi5cbiAgICogQHBhcmFtIHtpbXBvcnQoXCIuLi90ZXN0aW5nL3NoYXJlZC10cmFuc2FjdGlvbi1wcm94eS1kcml2ZXIuanNcIikuU2hhcmVkVHJhbnNhY3Rpb25Ccm9rZXJKb2JDb25maWd9IGNvbmZpZyAtIERpc3BhdGNoIGNvbmZpZ3VyYXRpb24uXG4gICAqIEBwYXJhbSB7Ym9vbGVhbn0gW2FkbWlzc2lvblJlc2VydmVkXSAtIFdoZXRoZXIgdGhlIGNhbGxlciBhbHJlYWR5IHJlc2VydmVkIGl0cyBhY3RpdmUtdXNlciBzbG90LlxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTx2b2lkPn0gLSBSZXNvbHZlcyBhZnRlciBzdGFsZSBjb25uZWN0aW9ucyBjbG9zZS5cbiAgICovXG4gIGFzeW5jIHByZXBhcmUoY29uZmlnLCBhZG1pc3Npb25SZXNlcnZlZCA9IGZhbHNlKSB7XG4gICAgY29uc3QgaWRlbnRpdHkgPSBKU09OLnN0cmluZ2lmeShjb25maWcpXG4gICAgaWYgKHRoaXMucGVuZGluZykge1xuICAgICAgaWYgKHRoaXMucGVuZGluZy5pZGVudGl0eSAhPT0gaWRlbnRpdHkpIHRocm93IG5ldyBFcnJvcihcIlBvb2xlZCBydW5uZXIgY2Fubm90IG1peCBzaGFyZWQgdHJhbnNhY3Rpb24gYnJva2VyIGNhcGFiaWxpdGllcyBjb25jdXJyZW50bHlcIilcbiAgICAgIHJldHVybiBhd2FpdCB0aGlzLnBlbmRpbmcucHJvbWlzZVxuICAgIH1cbiAgICBpZiAodGhpcy5hY3RpdmVJZGVudGl0eSA9PT0gaWRlbnRpdHkpIHJldHVyblxuICAgIGNvbnN0IG90aGVyQWN0aXZlVXNlcnMgPSB0aGlzLmFjdGl2ZVVzZXJzIC0gKGFkbWlzc2lvblJlc2VydmVkID8gMSA6IDApXG4gICAgaWYgKG90aGVyQWN0aXZlVXNlcnMgPiAwKSB0aHJvdyBuZXcgRXJyb3IoXCJQb29sZWQgcnVubmVyIGNhbm5vdCBtaXggc2hhcmVkIHRyYW5zYWN0aW9uIGJyb2tlciBjYXBhYmlsaXRpZXMgY29uY3VycmVudGx5XCIpXG4gICAgaWYgKHRoaXMuYWN0aXZlSWRlbnRpdHkgPT09IHVuZGVmaW5lZCkge1xuICAgICAgdGhpcy5hY3RpdmVJZGVudGl0eSA9IGlkZW50aXR5XG4gICAgICByZXR1cm5cbiAgICB9XG5cbiAgICBjb25zdCBwcm9taXNlID0gdGhpcy5yb3RhdGUoaWRlbnRpdHkpXG4gICAgdGhpcy5wZW5kaW5nID0ge2lkZW50aXR5LCBwcm9taXNlfVxuICAgIHRyeSB7XG4gICAgICBhd2FpdCBwcm9taXNlXG4gICAgfSBmaW5hbGx5IHtcbiAgICAgIHRoaXMucGVuZGluZyA9IHVuZGVmaW5lZFxuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBSdW5zIHdvcmsgd2hpbGUgcHJldmVudGluZyBhIGRpZmZlcmVudCBpZGVudGl0eSBmcm9tIHJlcGxhY2luZyBpdHMgY29ubmVjdGlvbnMuXG4gICAqIEB0ZW1wbGF0ZSBUXG4gICAqIEBwYXJhbSB7aW1wb3J0KFwiLi4vdGVzdGluZy9zaGFyZWQtdHJhbnNhY3Rpb24tcHJveHktZHJpdmVyLmpzXCIpLlNoYXJlZFRyYW5zYWN0aW9uQnJva2VySm9iQ29uZmlnfSBjb25maWcgLSBEaXNwYXRjaCBjb25maWd1cmF0aW9uLlxuICAgKiBAcGFyYW0geygpID0+IFByb21pc2U8VD59IGNhbGxiYWNrIC0gSm9iIGNhbGxiYWNrLlxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTxUPn0gLSBKb2IgcmVzdWx0LlxuICAgKi9cbiAgYXN5bmMgcnVuKGNvbmZpZywgY2FsbGJhY2spIHtcbiAgICBhd2FpdCB0aGlzLmFkbWl0KGNvbmZpZylcbiAgICB0cnkge1xuICAgICAgcmV0dXJuIGF3YWl0IGNhbGxiYWNrKClcbiAgICB9IGZpbmFsbHkge1xuICAgICAgdGhpcy5hY3RpdmVVc2Vycy0tXG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIEF0b21pY2FsbHkgcHJlcGFyZXMgYW4gYXR0ZW1wdCBpZGVudGl0eSBhbmQgcmVzZXJ2ZXMgaXRzIGFjdGl2ZSB1c2VyLiBXaXRob3V0XG4gICAqIHRoaXMgYWRtaXNzaW9uIHR1cm4sIGFub3RoZXIgY2FwYWJpbGl0eSBjYW4gcm90YXRlIGNvbm5lY3Rpb25zIGFmdGVyIGBwcmVwYXJlYFxuICAgKiByZXNvbHZlcyBidXQgYmVmb3JlIGBydW5gIGluY3JlbWVudHMgYGFjdGl2ZVVzZXJzYC5cbiAgICogQHBhcmFtIHtpbXBvcnQoXCIuLi90ZXN0aW5nL3NoYXJlZC10cmFuc2FjdGlvbi1wcm94eS1kcml2ZXIuanNcIikuU2hhcmVkVHJhbnNhY3Rpb25Ccm9rZXJKb2JDb25maWd9IGNvbmZpZyAtIERpc3BhdGNoIGNvbmZpZ3VyYXRpb24uXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPHZvaWQ+fSAtIFJlc29sdmVzIGFmdGVyIGFkbWlzc2lvbiBpcyByZXNlcnZlZC5cbiAgICovXG4gIGFzeW5jIGFkbWl0KGNvbmZpZykge1xuICAgIHRoaXMuYWN0aXZlVXNlcnMrK1xuICAgIHRyeSB7XG4gICAgICBhd2FpdCB0aGlzLnByZXBhcmUoY29uZmlnLCB0cnVlKVxuICAgIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgICB0aGlzLmFjdGl2ZVVzZXJzLS1cbiAgICAgIHRocm93IGVycm9yXG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIFJvdGF0ZXMgcmV0YWluZWQgY29ubmVjdGlvbiBzdGF0ZSB0byBhbiBpZGVudGl0eS5cbiAgICogQHBhcmFtIHtzdHJpbmd9IGlkZW50aXR5IC0gVGFyZ2V0IGlkZW50aXR5LlxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTx2b2lkPn0gLSBSZXNvbHZlcyBhZnRlciByb3RhdGlvbi5cbiAgICovXG4gIGFzeW5jIHJvdGF0ZShpZGVudGl0eSkge1xuICAgIGF3YWl0IHRoaXMuY2xvc2VDb25uZWN0aW9ucygpXG4gICAgdGhpcy5hY3RpdmVJZGVudGl0eSA9IGlkZW50aXR5XG4gIH1cbn1cbiJdfQ==