Function assertIdempotencyKey

src/lib/validate.ts:160–180

(key: string | undefined)

 * @param key  The raw flag value, or `undefined` when the key is auto-minted.
 */
export function assertIdempotencyKey(key: string | undefined): void {
  if (key === undefined) return;
  // ASCII-printable check: every codepoint must be in U+0020–U+007E (space through tilde).
  // Non-ASCII chars (codepoint > 127) trigger a TypeError in Node's fetch ByteString header.
  if (key.length === 0 || !/^[ -~]+$/.test(key)) {
    throw localValidationError(
      'idempotencyKey',
      'must be 1–256 printable ASCII characters (no non-ASCII, control chars, or empty string)',
      undefined,
      'flag',
    );
  }
  if (key.length > 256) {
    throw localValidationError(
      'idempotencyKey',
      'must be at most 256 characters',
      undefined,
      'flag',
    );
  }
}

/**
 * Assert that `arr` is an Array and that its length is within the given