@andrew_l/toolkit 0.3.6 → 0.3.7

package/dist/index.d.ts

@@ -466,6 +466,33 @@ declare namespace assert {
   export { assert_array as array, assert_arrayNumbers as arrayNumbers, assert_arrayStrings as arrayStrings, assert_boolean as boolean, assert_date as date, assert_equal as equal, assert_fn as fn, assert_greaterThan as greaterThan, assert_lessThan as lessThan, assert_notEmpty as notEmpty, assert_notEmptyString as notEmptyString, assert_number as number, assert_object as object, assert_ok as ok, assert_string as string };
 }
 
+/**
+ * Base62 encoder/decoder for binary data.
+ *
+ * @example Basic usage
+ * ```typescript
+ * const data = new Uint8Array([255, 128, 64]);
+ * const encoded = base62.encode(data);
+ * console.log(encoded);
+ *
+ * const decoded = base62.decode(encoded);
+ * console.log(decoded); // Uint8Array [255, 128, 64]
+ * ```
+ *
+ * @example Text encoding
+ * ```typescript
+ * const text = "Hello World!";
+ * const bytes = new TextEncoder().encode(text);
+ * const encoded = base62.encode(bytes);
+ * const decoded = base62.decode(encoded);
+ * const result = new TextDecoder().decode(decoded);
+ * console.log(result); // "Hello World!"
+ * ```
+ *
+ * @group Binary
+ */
+declare const base62: BaseX;
+
 interface BaseX {
     /**
      * Base alphabet
@@ -512,33 +539,6 @@ interface BaseX {
  */
 declare function basex(alphabet: string): BaseX;
 
-/**
- * Base62 encoder/decoder for binary data.
- *
- * @example Basic usage
- * ```typescript
- * const data = new Uint8Array([255, 128, 64]);
- * const encoded = base62.encode(data);
- * console.log(encoded);
- *
- * const decoded = base62.decode(encoded);
- * console.log(decoded); // Uint8Array [255, 128, 64]
- * ```
- *
- * @example Text encoding
- * ```typescript
- * const text = "Hello World!";
- * const bytes = new TextEncoder().encode(text);
- * const encoded = base62.encode(bytes);
- * const decoded = base62.decode(encoded);
- * const result = new TextDecoder().decode(decoded);
- * console.log(result); // "Hello World!"
- * ```
- *
- * @group Binary
- */
-declare const base62: BaseX;
-
 /**
  * Base62-like encoder/decoder for binary data but **super fast**. Useful for human readable tokens generation
  *
@@ -670,6 +670,11 @@ type Base64ToBytesOptions = {
      * Whether to enforce strict Base64 decoding.
      */
     strict?: boolean;
+    /**
+     * Prefer to use native `Uint8Array.fromBase64` and `Uint8Array.fromBase64` when possible
+     * @default true
+     */
+    native?: boolean;
 };
 /**
  * Decodes a Base64 or Base64URL encoded string into a `Uint8Array`.
@@ -700,7 +705,7 @@ type Base64ToBytesOptions = {
  *
  * @group Binary
  */
-declare function base64ToBytes(data: string, { encoding, strict }?: Base64ToBytesOptions): Uint8Array;
+declare function base64ToBytes(data: string, { encoding, strict, native }?: Base64ToBytesOptions): Uint8Array;
 
 /**
  * Converts a `bigint` value into a byte array (`Uint8Array`) in big-endian order.
@@ -947,7 +952,7 @@ interface Logger {
   error: (...args: unknown[]) => void;
   debug: (...args: unknown[]) => void;
   log: (...args: unknown[]) => void;
-  extend: (...args: unknown[]) => void;
+  extend: (...args: unknown[]) => Logger;
 }
 
 declare namespace BitPack {
@@ -992,6 +997,31 @@ type Plan = {
     value?: unknown;
     child?: Plan;
 };
+/**
+ * Define compact packed structure
+ * @group Binary
+ *
+ * @example
+ * ```typescript
+ * const snowflake = bitPack({
+ *   totalBits: 64,
+ *   fields: [
+ *     { name: 'timestamp', bits: 42, take: 'low' },
+ *     { name: 'workerId', bits: 5, take: 'low' },
+ *     { name: 'processId', bits: 5, take: 'low' },
+ *     { name: 'increment', bits: 12, take: 'low' },
+ *   ],
+ *   optimize: true,
+ * });
+ *
+ * const userId = snowflake.bigint({
+ *   timestamp: 1781295314562,
+ *   workerId: 1,
+ *   processId: 0,
+ *   increment: 0
+ * }); // 7471294063048785920n
+ * ```
+ */
 declare function bitPack<const TFields extends BitPack.Field[], TFieldNames extends string = BitPack.ExtractFieldNames<TFields>>(options: BitPack.Options<TFields>): BitPack.API<TFieldNames>;
 
 declare namespace BitUnpack {
@@ -1024,6 +1054,27 @@ declare namespace BitUnpack {
         [P in T]: number;
     };
 }
+/**
+ * Define compact unpacked structure
+ * @group Binary
+ *
+ * @example
+ * ```typescript
+ * const snowflake = bitUnpack({
+ *   totalBits: 64,
+ *   fields: [
+ *     { name: 'timestamp', bits: 42, take: 'low' },
+ *     { name: 'workerId', bits: 5, take: 'low' },
+ *     { name: 'processId', bits: 5, take: 'low' },
+ *     { name: 'increment', bits: 12, take: 'low' },
+ *   ],
+ * });
+ *
+ * console.log(
+ *   snowflake.bigint(7471294063048785920n)
+ * ); // { timestamp: 1781295314562, workerId: 1, processId: 0, increment: 0 }
+ * ```
+ */
 declare function bitUnpack<const TFields extends BitUnpack.Field[], TFieldNames extends string = BitUnpack.ExtractFieldNames<TFields>>(options: BitUnpack.Options<TFields>): BitUnpack.API<TFieldNames>;
 
 type BytesToBase64Options = {
@@ -1035,6 +1086,11 @@ type BytesToBase64Options = {
      * Whether or not to include padding (`=`) in the encoded result. Defaults to `true` for Base64, `false` for Base64URL.
      */
     padding?: boolean;
+    /**
+     * Prefer to use native `Uint8Array.toBase64` and `Uint8Array.toBase64` when possible
+     * @default true
+     */
+    native?: boolean;
 };
 /**
  * Encodes a byte array (`Uint8Array`) into a Base64 or Base64URL encoded string.
@@ -1074,7 +1130,7 @@ type BytesToBase64Options = {
  *
  * @group Binary
  */
-declare function bytesToBase64(data: Uint8Array, { encoding, padding }?: BytesToBase64Options): string;
+declare function bytesToBase64(data: Uint8Array, { encoding, padding, native }?: BytesToBase64Options): string;
 
 /**
  * Compares two `Uint8Array` instances to check if their contents are identical.
@@ -3487,7 +3543,12 @@ type LogLevel = Exclude<keyof Logger, 'extend'>;
  * Set global log level.
  * @group Utility Functions
  */
-declare const loggerSetLevel: (level: LogLevel) => void;
+declare const setLoggerLevel: (level: LogLevel) => void;
+/**
+ * Set global log level.
+ * @group Utility Functions
+ */
+declare const getLoggerLevel: () => LogLevel;
 /**
  * Create pretty simple `console.log` wrapper interface.
  *
@@ -5199,6 +5260,78 @@ declare class ResourcePool<T = unknown> extends SimpleEventEmitter<ResourcePoolE
     private resolveDestroyQueue;
 }
 
+declare const SCHEDULER_JOB_FLAGS: {
+    readonly QUEUED: number;
+    readonly ALLOW_RECURSE: number;
+    readonly DISPOSED: number;
+};
+/**
+ * Creates a microtask scheduler that batches jobs and flushes them in
+ * priority order on the next tick.
+ *
+ * Jobs are functions queued via {@link Scheduler.queueJob}. Each job may carry
+ * an optional numeric `id` used to order the queue — lower `id` runs first,
+ * and jobs without an `id` run last. Re-queueing the same job within an
+ * active flush cycle is a no-op unless `SCHEDULER_JOB_FLAGS.ALLOW_RECURSE`
+ * is set on the job. Use {@link Scheduler.queueJobWait} when you need to
+ * await a job's result through a {@link CancellablePromise}, and the
+ * `onJob` / `onJobStart` / `onJobComplete` hooks to observe lifecycle.
+ *
+ * @example
+ * ```typescript
+ * const scheduler = createScheduler();
+ *
+ * const log = (msg: string) => () => console.log(msg);
+ *
+ * const first = log('first');
+ * first.id = 1;
+ * const second = log('second');
+ * second.id = 2;
+ *
+ * scheduler.queueJob(second);
+ * scheduler.queueJob(first);
+ *
+ * scheduler.nextTick().then(() => console.log('flushed'));
+ * // → first
+ * // → second
+ * // → flushed
+ * ```
+ *
+ * @group Promise
+ */
+declare function createScheduler(): Scheduler;
+declare namespace Scheduler {
+    type Job<T = any> = (() => T) & JobOptions;
+    type JobOptions = {
+        id?: number;
+        /**
+         * flags can technically be undefined, but it can still be used in bitwise
+         * operations just like 0.
+         */
+        flags?: number;
+        jobName?: string;
+    };
+}
+declare class Scheduler {
+    protected queue: Scheduler.Job[];
+    protected flushIndex: number;
+    protected resolvedPromise: Promise<any>;
+    protected currentFlushPromise: Promise<void> | null;
+    protected onJobCbs: ((job: Scheduler.JobOptions) => void)[];
+    protected onJobStartCbs: ((job: Scheduler.JobOptions) => void)[];
+    protected onJobCompleteCbs: ((job: Scheduler.JobOptions) => void)[];
+    constructor();
+    onJob(fn: (job: Scheduler.JobOptions) => void): void;
+    onJobStart(fn: (job: Scheduler.JobOptions) => void): void;
+    onJobComplete(fn: (job: Scheduler.JobOptions) => void): void;
+    nextTick(fn?: () => void): Promise<void>;
+    queueJob<T>(job: Scheduler.Job<T>, opts?: Scheduler.JobOptions): void;
+    queueJobWait<T>(job: Scheduler.Job<T>, opts?: Scheduler.JobOptions): CancellablePromise<Awaited<T>>;
+    protected findInsertionIndex(id: number): number;
+    protected flushJobs(): Promise<void>;
+    protected queueFlush(): void;
+}
+
 /**
  * Throws an error if the provided promise or callback is not resolved within the specified timeout period.
  *
@@ -5848,4 +5981,4 @@ declare function wrapText(value: string, maxLength?: number): string;
  */
 declare function toError<T>(value: T, unknownMessage?: string): T extends Error ? T : Error;
 
-export { type AnyFunction, AppError, type AppErrorOptions, type ArgumentsType, type Arrayable, AssertionError, AsyncIterableQueue, type Awaitable, type Base64ToBytesOptions, type BaseX, BitPack, BitUnpack, type BytesToBase64Options, CancellablePromise, type CatchErrorResult, Color, type ColorChannels, ColorParser, type Data, type DateObject, type DateObjectInput, type DebouncedFunction, type DeepPartial, type DeepReadonly, type Defer, instance as EJSON, EJSON as EJSONInstance, EJSONStream, type EJSONStreamOptions, type EJSONStreamOptionsWithPayload, type EJSONType, type EnvParser, type ExecResult, type ExecResultToSkip, type ExecResultToSuccess, type ExecSkip, type ExecSuccess, FindMean, FixedMap, FixedWeakMap, Fn, type FormatMoney, type FormatNumber, type FunctionArgs, type GenericObject, type IfAny, type IsAny, type LiteralUnion, type Logger, LruCache, type Nothing, type OverwriteWith, type Prettify, type Primitive, type PromisifyFn, Queue, type RandomizerOptions, ResourcePool, type ResourcePoolEventMap, type ResourcePoolOptions, type RetryOnErrorConfig, type SecureCustomizerOptions, type SelectOptionItem, type SelectOptions, type SimpleDefaultEventMap, SimpleEventEmitter, type SimpleEventMap, SortedArray, type SortedArrayCompareFn, _default as TWEMOJI_REGEX, type ThemeConfig, type ThrottledFunction, TimeBucket, type TimeBucketOptions, type TimeObject, type TimeObjectInput, TimeSpan, type TimeSpanUnit, type TimeString, type TimeValue, type TimestampMsInput, type TypeOf, type TypeOfMap, type ValuesOfObject, type WithCache, type WithCacheBucketBatchOptions, type WithCacheBucketOptions, type WithCacheFixedOptions, type WithCacheLruOptions, type WithCacheOptions, type WithCachePointer, type WithCacheResult, type WithCacheStorage, type WithCode, type WithCustomizer, type WithCustomizerFactory, type WithCustomizerValue, type WrrItem, alpha, arrayable, assert, asyncFilter, asyncFind, asyncForEach, asyncMap, avg, avgCircular, base62, base62Fast, base64, base64ToBytes, base64url, basex, bigIntBytes, bigIntFromBytes, bitPack, bitUnpack, blendColors, buildCssColor, bytesToBase64, cache, cacheBucket, cacheFixed, cacheLRU, camelCase, capitalize, captureStackTrace, catchError, channelsToHSL, channelsToHex, channelsToRGB, checkBitmask, chunk, chunkSeries, clamp, cleanEmpty, cleanObject, colorToChannels, compareBytes, concatenateBytes, contrastRatio, convertToUnit, crc32, createCustomizer, createCustomizerFactory, createDateObject, createDeepCloneWith, createEJSON, createEJSONStream, createEnvParser, createFunction, createRandomizer, createSecureCustomizer, createTimeObject, createTimeSpan, createWithCache, cssVariable, dateInDays, dateInSeconds, debounce, deepAssign, deepClone, deepCloneWith, deepDefaults, deepFreeze, def, defer, delay, difference, dropCache, env, escapeHtml, escapeNumeric, escapeRegExp, fastIdle, fastIdlePromise, fastRaf, findMean, flagsToMap, flatten, formatMoney, formatNumber, get, getFileExtension, getFileName, getInitials, getMostSpecificPaths, getRandomInt, getRandomTime, getWords, groupBy, has, hasOwn, hasProtocol, hex, hexToChannels, hmToSeconds, hslToChannels, humanFileSize, humanize, interpolateColor, intersection, intersectionBy, isBigInt, isBoolean, isCached, isClient, isColorChannels, isCustomizerFactory, isDate, isDateObject, isDef, isEmpty, isEqual, isError, isFunction, isInfinity, isMap, isNode, isNullOrUndefined, isNumber, isObject, isOneEmoji, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isSkip, isString, isSuccess, isSymbol, isTimeObject, isTimeString, isTimeValue, isValidWeekDay, isWeakMap, isWeakSet, isWithCache, isoToFlagEmoji, kebabCase, keyBy, logger, loggerSetLevel, lowerCase, luminance, maskingEmail, maskingPhone, maskingWords, nextTickIteration, noop, objectId, omit, omitPrefixed, orderBy, parseAllNumbers, parseAlpha, parsePercentage, percentOf, pick, pickPrefixed, qs, rafPromise, randomString, removeVS16s, retryOnError, rgbToChannels, rleDecode, rleEncode, round2digits, secondsToHm, set, shuffle, snakeCase, sprintf, startCase, strAssign, sum, textDecoder, textEncoder, throttle, timeFromMinutes, timeStringify, timeToMinutes, timeout, timestamp, timestampMs, timestampToDate, tintedTextColor, toError, toMap, truncate, typeOf, uint16ToUint8, uint32ToUint8, uint8ToUint16, uint8ToUint32, unflatten, union, uniq, uniqBy, unset, weeksInYear, weightedRoundRobin, withCache, withCacheBucket, withCacheBucketBatch, withCacheFixed, withCacheLRU, withDeepClone, withPointerCache, withResolve, wrapText };
+export { type AnyFunction, AppError, type AppErrorOptions, type ArgumentsType, type Arrayable, AssertionError, AsyncIterableQueue, type Awaitable, type Base64ToBytesOptions, type BaseX, BitPack, BitUnpack, type BytesToBase64Options, CancellablePromise, type CatchErrorResult, Color, type ColorChannels, ColorParser, type Data, type DateObject, type DateObjectInput, type DebouncedFunction, type DeepPartial, type DeepReadonly, type Defer, instance as EJSON, EJSON as EJSONInstance, EJSONStream, type EJSONStreamOptions, type EJSONStreamOptionsWithPayload, type EJSONType, type EnvParser, type ExecResult, type ExecResultToSkip, type ExecResultToSuccess, type ExecSkip, type ExecSuccess, FindMean, FixedMap, FixedWeakMap, Fn, type FormatMoney, type FormatNumber, type FunctionArgs, type GenericObject, type IfAny, type IsAny, type LiteralUnion, type LogLevel, type Logger, LruCache, type Nothing, type OverwriteWith, type Prettify, type Primitive, type PromisifyFn, Queue, type RandomizerOptions, ResourcePool, type ResourcePoolEventMap, type ResourcePoolOptions, type RetryOnErrorConfig, SCHEDULER_JOB_FLAGS, Scheduler, type SecureCustomizerOptions, type SelectOptionItem, type SelectOptions, type SimpleDefaultEventMap, SimpleEventEmitter, type SimpleEventMap, SortedArray, type SortedArrayCompareFn, _default as TWEMOJI_REGEX, type ThemeConfig, type ThrottledFunction, TimeBucket, type TimeBucketOptions, type TimeObject, type TimeObjectInput, TimeSpan, type TimeSpanUnit, type TimeString, type TimeValue, type TimestampMsInput, type TypeOf, type TypeOfMap, type ValuesOfObject, type WithCache, type WithCacheBucketBatchOptions, type WithCacheBucketOptions, type WithCacheFixedOptions, type WithCacheLruOptions, type WithCacheOptions, type WithCachePointer, type WithCacheResult, type WithCacheStorage, type WithCode, type WithCustomizer, type WithCustomizerFactory, type WithCustomizerValue, type WrrItem, alpha, arrayable, assert, asyncFilter, asyncFind, asyncForEach, asyncMap, avg, avgCircular, base62, base62Fast, base64, base64ToBytes, base64url, basex, bigIntBytes, bigIntFromBytes, bitPack, bitUnpack, blendColors, buildCssColor, bytesToBase64, cache, cacheBucket, cacheFixed, cacheLRU, camelCase, capitalize, captureStackTrace, catchError, channelsToHSL, channelsToHex, channelsToRGB, checkBitmask, chunk, chunkSeries, clamp, cleanEmpty, cleanObject, colorToChannels, compareBytes, concatenateBytes, contrastRatio, convertToUnit, crc32, createCustomizer, createCustomizerFactory, createDateObject, createDeepCloneWith, createEJSON, createEJSONStream, createEnvParser, createFunction, createRandomizer, createScheduler, createSecureCustomizer, createTimeObject, createTimeSpan, createWithCache, cssVariable, dateInDays, dateInSeconds, debounce, deepAssign, deepClone, deepCloneWith, deepDefaults, deepFreeze, def, defer, delay, difference, dropCache, env, escapeHtml, escapeNumeric, escapeRegExp, fastIdle, fastIdlePromise, fastRaf, findMean, flagsToMap, flatten, formatMoney, formatNumber, get, getFileExtension, getFileName, getInitials, getLoggerLevel, getMostSpecificPaths, getRandomInt, getRandomTime, getWords, groupBy, has, hasOwn, hasProtocol, hex, hexToChannels, hmToSeconds, hslToChannels, humanFileSize, humanize, interpolateColor, intersection, intersectionBy, isBigInt, isBoolean, isCached, isClient, isColorChannels, isCustomizerFactory, isDate, isDateObject, isDef, isEmpty, isEqual, isError, isFunction, isInfinity, isMap, isNode, isNullOrUndefined, isNumber, isObject, isOneEmoji, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isSkip, isString, isSuccess, isSymbol, isTimeObject, isTimeString, isTimeValue, isValidWeekDay, isWeakMap, isWeakSet, isWithCache, isoToFlagEmoji, kebabCase, keyBy, logger, lowerCase, luminance, maskingEmail, maskingPhone, maskingWords, nextTickIteration, noop, objectId, omit, omitPrefixed, orderBy, parseAllNumbers, parseAlpha, parsePercentage, percentOf, pick, pickPrefixed, qs, rafPromise, randomString, removeVS16s, retryOnError, rgbToChannels, rleDecode, rleEncode, round2digits, secondsToHm, set, setLoggerLevel, shuffle, snakeCase, sprintf, startCase, strAssign, sum, textDecoder, textEncoder, throttle, timeFromMinutes, timeStringify, timeToMinutes, timeout, timestamp, timestampMs, timestampToDate, tintedTextColor, toError, toMap, truncate, typeOf, uint16ToUint8, uint32ToUint8, uint8ToUint16, uint8ToUint32, unflatten, union, uniq, uniqBy, unset, weeksInYear, weightedRoundRobin, withCache, withCacheBucket, withCacheBucketBatch, withCacheFixed, withCacheLRU, withDeepClone, withPointerCache, withResolve, wrapText };

package/dist/index.mjs

@@ -1572,8 +1572,12 @@ class Base64Encoding {
     }
     this.alphabet = alphabet;
     this.padding = options?.padding ?? "=";
-    if (this.alphabet.includes(this.padding) || this.padding.length !== 1) {
-      throw new Error("Invalid padding");
+    if (this.padding) {
+      ok(
+        !this.alphabet.includes(this.padding),
+        "Padding cannot be a part of alphabet"
+      );
+      ok(this.padding.length === 1, "Padding length must be a 1");
     }
     for (let i = 0; i < alphabet.length; i++) {
       this.decodeMap.set(alphabet[i], i);
@@ -1592,26 +1596,24 @@ class Base64Encoding {
    * ```
    */
   encode(data, options) {
+    const includePadding = options?.includePadding ?? true;
     let result = "";
     let buffer = 0;
     let shift = 0;
-    for (let i = 0; i < data.length; i++) {
-      buffer = buffer << 8 | data[i];
+    for (const byte of data) {
+      buffer = buffer << 8 | byte;
       shift += 8;
       while (shift >= 6) {
-        shift += -6;
+        shift -= 6;
         result += this.alphabet[buffer >> shift & 63];
       }
     }
     if (shift > 0) {
       result += this.alphabet[buffer << 6 - shift & 63];
     }
-    const includePadding = options?.includePadding ?? true;
-    if (includePadding) {
+    if (includePadding && this.padding) {
       const padCount = (4 - result.length % 4) % 4;
-      for (let i = 0; i < padCount; i++) {
-        result += "=";
-      }
+      result += "=".repeat(padCount);
     }
     return result;
   }
@@ -1630,39 +1632,23 @@ class Base64Encoding {
    */
   decode(data, options) {
     const strict = options?.strict ?? true;
-    const chunkCount = Math.ceil(data.length / 4);
     const result = [];
-    for (let i = 0; i < chunkCount; i++) {
-      let padCount = 0;
-      let buffer = 0;
-      for (let j = 0; j < 4; j++) {
-        const encoded = data[i * 4 + j];
-        if (encoded === "=") {
-          if (i + 1 !== chunkCount) {
-            throw new Error(`Invalid character: ${encoded}`);
-          }
-          padCount += 1;
-          continue;
-        }
-        if (encoded === void 0) {
-          if (strict) {
-            throw new Error("Invalid data");
-          }
-          padCount += 1;
-          continue;
-        }
-        const value = this.decodeMap.get(encoded) ?? null;
-        if (value === null) {
-          throw new Error(`Invalid character: ${encoded}`);
-        }
-        buffer += value << 6 * (3 - j);
-      }
-      result.push(buffer >> 16 & 255);
-      if (padCount < 2) {
-        result.push(buffer >> 8 & 255);
+    let buffer = 0;
+    let bitsCollected = 0;
+    if (this.padding && strict) {
+      ok(data.length % 4 === 0, "Invalid Base64 data");
+    }
+    for (const char of data) {
+      if (char === this.padding) break;
+      const value = this.decodeMap.get(char);
+      if (value === void 0) {
+        throw new Error(`Invalid Base64 character: ${char}`);
       }
-      if (padCount < 1) {
-        result.push(buffer & 255);
+      buffer = buffer << 6 | value;
+      bitsCollected += 6;
+      if (bitsCollected >= 8) {
+        bitsCollected -= 8;
+        result.push(buffer >> bitsCollected & 255);
       }
     }
     return Uint8Array.from(result);
@@ -1676,10 +1662,22 @@ const base64url = new Base64Encoding(
   "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_"
 );
 
-function base64ToBytes(data, { encoding = "base64", strict } = {}) {
+function base64ToBytes(data, { encoding = "base64", strict, native = true } = {}) {
   if (encoding === "base64") {
+    if (native && isFunction(Uint8Array.fromBase64)) {
+      return Uint8Array.fromBase64(data, {
+        alphabet: "base64",
+        lastChunkHandling: strict ?? true ? "strict" : "loose"
+      });
+    }
     return base64.decode(data, { strict: strict ?? true });
   } else if (encoding === "base64url") {
+    if (native && isFunction(Uint8Array.fromBase64)) {
+      return Uint8Array.fromBase64(data, {
+        alphabet: "base64url",
+        lastChunkHandling: strict ?? false ? "strict" : "loose"
+      });
+    }
     return base64url.decode(data, { strict: strict ?? false });
   }
   ok(false, "Invalid encoding options: " + encoding);
@@ -2143,10 +2141,22 @@ function buildFieldsInfo(fields, totalBits) {
   return result;
 }
 
-function bytesToBase64(data, { encoding = "base64", padding } = {}) {
+function bytesToBase64(data, { encoding = "base64", padding, native = true } = {}) {
   if (encoding === "base64") {
+    if (native && isFunction(data.toBase64)) {
+      return data.toBase64({
+        alphabet: "base64",
+        omitPadding: !(padding ?? true)
+      });
+    }
     return base64.encode(data, { includePadding: padding ?? true });
   } else if (encoding === "base64url") {
+    if (native && isFunction(data.toBase64)) {
+      return data.toBase64({
+        alphabet: "base64url",
+        omitPadding: !(padding ?? false)
+      });
+    }
     return base64url.encode(data, { includePadding: padding ?? false });
   }
   ok(false, "Invalid encoding options: " + encoding);
@@ -5197,17 +5207,28 @@ function throttle(func, throttleMs, { signal, edges = ["leading", "trailing"] }
   return throttled;
 }
 
-const LEVEL_NUM = {
+const LEVEL_NAME_TO_NUM = {
   debug: 0,
   log: 1,
   info: 2,
   warn: 3,
   error: 4
 };
-let currentLogLevel = LEVEL_NUM.log;
-const loggerSetLevel = (level) => {
-  number$1(LEVEL_NUM[level], `Invalid log level: ${level}`);
-  currentLogLevel = LEVEL_NUM[level];
+const LEVEL_NUM_TO_NAME = {
+  0: "debug",
+  1: "log",
+  2: "info",
+  3: "warn",
+  4: "error"
+};
+const LOG_LEVEL = env.string("LOG_LEVEL", "info");
+let currentLogLevel = LOG_LEVEL in LEVEL_NAME_TO_NUM ? LEVEL_NAME_TO_NUM[LOG_LEVEL] : LEVEL_NAME_TO_NUM.log;
+const setLoggerLevel = (level) => {
+  number$1(LEVEL_NAME_TO_NUM[level], `Invalid log level: ${level}`);
+  currentLogLevel = LEVEL_NAME_TO_NUM[level];
+};
+const getLoggerLevel = () => {
+  return LEVEL_NUM_TO_NAME[currentLogLevel];
 };
 const logger = (...baseArgs) => {
   if (isString(baseArgs[0]?.url)) {
@@ -5217,7 +5238,7 @@ const logger = (...baseArgs) => {
     baseArgs[0] = `[${baseArgs[0].split("/").at(-1).split("?", 1)[0]}]`;
   }
   const writeLog = (level, ...[pattern, ...args]) => {
-    const levelNum = LEVEL_NUM[level];
+    const levelNum = LEVEL_NAME_TO_NUM[level];
     if (levelNum < currentLogLevel) {
       return;
     }
@@ -5945,6 +5966,135 @@ class ResourcePool extends SimpleEventEmitter {
   }
 }
 
+const SCHEDULER_JOB_FLAGS = {
+  QUEUED: 1 << 0,
+  ALLOW_RECURSE: 1 << 2,
+  DISPOSED: 1 << 3
+};
+function createScheduler() {
+  return new Scheduler();
+}
+class Scheduler {
+  queue = [];
+  flushIndex = -1;
+  resolvedPromise = Promise.resolve();
+  currentFlushPromise = null;
+  onJobCbs = [];
+  onJobStartCbs = [];
+  onJobCompleteCbs = [];
+  constructor() {
+    for (const methodName of Object.getOwnPropertyNames(
+      Object.getPrototypeOf(this)
+    )) {
+      this[methodName] = this[methodName].bind(this);
+    }
+  }
+  onJob(fn) {
+    this.onJobCbs.push(fn);
+  }
+  onJobStart(fn) {
+    this.onJobStartCbs.push(fn);
+  }
+  onJobComplete(fn) {
+    this.onJobCompleteCbs.push(fn);
+  }
+  nextTick(fn) {
+    const p = this.currentFlushPromise || this.resolvedPromise;
+    return fn ? p.then(this ? fn.bind(this) : fn) : p;
+  }
+  queueJob(job, opts) {
+    if (opts) {
+      Object.assign(job, opts);
+    }
+    if (!(job.flags & SCHEDULER_JOB_FLAGS.QUEUED)) {
+      const jobId = getId(job);
+      const lastJob = this.queue[this.queue.length - 1];
+      if (!lastJob || jobId >= getId(lastJob)) {
+        this.queue.push(job);
+      } else {
+        this.queue.splice(this.findInsertionIndex(jobId), 0, job);
+      }
+      job.flags |= SCHEDULER_JOB_FLAGS.QUEUED;
+      this.queueFlush();
+      for (const hookFn of this.onJobCbs) {
+        hookFn(job);
+      }
+    }
+  }
+  queueJobWait(job, opts) {
+    return new CancellablePromise((resolve, reject, onCancel) => {
+      onCancel(() => {
+        job.flags |= SCHEDULER_JOB_FLAGS.DISPOSED;
+        reject(new Error("Canceled"));
+      });
+      const fn = () => {
+        return Promise.resolve().then(() => job()).then(resolve).catch(reject);
+      };
+      fn.id = job.id;
+      fn.flags = job.flags;
+      this.queueJob(fn, opts);
+    });
+  }
+  findInsertionIndex(id) {
+    let start = this.flushIndex + 1;
+    let end = this.queue.length;
+    while (start < end) {
+      const middle = start + end >>> 1;
+      const middleJob = this.queue[middle];
+      const middleJobId = getId(middleJob);
+      if (middleJobId < id) {
+        start = middle + 1;
+      } else {
+        end = middle;
+      }
+    }
+    return start;
+  }
+  async flushJobs() {
+    try {
+      for (this.flushIndex = 0; this.flushIndex < this.queue.length; this.flushIndex++) {
+        const job = this.queue[this.flushIndex];
+        if (job && !(job.flags & SCHEDULER_JOB_FLAGS.DISPOSED)) {
+          if (job.flags & SCHEDULER_JOB_FLAGS.ALLOW_RECURSE) {
+            job.flags &= ~SCHEDULER_JOB_FLAGS.QUEUED;
+          }
+          for (const hookFn of this.onJobStartCbs) {
+            hookFn(job);
+          }
+          await job();
+          for (const hookFn of this.onJobCompleteCbs) {
+            hookFn(job);
+          }
+          if (!(job.flags & SCHEDULER_JOB_FLAGS.ALLOW_RECURSE)) {
+            job.flags &= ~SCHEDULER_JOB_FLAGS.QUEUED;
+          }
+        }
+      }
+    } finally {
+      for (; this.flushIndex < this.queue.length; this.flushIndex++) {
+        const job = this.queue[this.flushIndex];
+        if (job) {
+          job.flags &= ~SCHEDULER_JOB_FLAGS.QUEUED;
+        }
+      }
+      this.flushIndex = -1;
+      this.queue.length = 0;
+      this.currentFlushPromise = null;
+      if (this.queue.length) {
+        return this.flushJobs();
+      }
+    }
+  }
+  queueFlush() {
+    if (!this.currentFlushPromise) {
+      this.currentFlushPromise = this.resolvedPromise.then(this.flushJobs);
+    }
+  }
+}
+function getId(job) {
+  return job.id == null ? Infinity : job.id;
+}
+
 function timeout(ms, promiseOrCallback, timeoutError = new AppError(408)) {
   const abortController = new AbortController();
   let taskResult;
@@ -6029,5 +6179,5 @@ function withResolve(fn, getCacheKey) {
   }
 }
 
-export { AppError, AssertionError, AsyncIterableQueue, CancellablePromise, ColorParser, instance as EJSON, EJSON as EJSONInstance, EJSONStream, FindMean, FixedMap, FixedWeakMap, LruCache, Queue, ResourcePool, SimpleEventEmitter, SortedArray, TWEMOJI_REGEX, TimeBucket, TimeSpan, alpha, arrayable, assert, asyncFilter, asyncFind, asyncForEach, asyncMap, avg, avgCircular, base62, base62Fast, base64, base64ToBytes, base64url, basex, bigIntBytes, bigIntFromBytes, bitPack, bitUnpack, blendColors, buildCssColor, bytesToBase64, cache, cacheBucket, cacheFixed, cacheLRU, camelCase, capitalize, captureStackTrace, catchError, channelsToHSL, channelsToHex, channelsToRGB, checkBitmask, chunk, chunkSeries, clamp, cleanEmpty, cleanObject, colorToChannels, compareBytes, concatenateBytes, contrastRatio, convertToUnit, crc32, createCustomizer, createCustomizerFactory, createDateObject, createDeepCloneWith, createEJSON, createEJSONStream, createEnvParser, createFunction, createRandomizer, createSecureCustomizer, createTimeObject, createTimeSpan, createWithCache, cssVariable, dateInDays, dateInSeconds, debounce, deepAssign, deepClone, deepCloneWith, deepDefaults, deepFreeze, def, defer, delay, difference, dropCache, env, escapeHtml, escapeNumeric, escapeRegExp, fastIdle, fastIdlePromise, fastRaf, findMean, flagsToMap, flatten, formatMoney, formatNumber, get, getFileExtension, getFileName, getInitials, getMostSpecificPaths, getRandomInt, getRandomTime, getWords, groupBy, has, hasOwn, hasProtocol, hex, hexToChannels, hmToSeconds, hslToChannels, humanFileSize, humanize, interpolateColor, intersection, intersectionBy, isBigInt, isBoolean, isCached, isClient, isColorChannels, isCustomizerFactory, isDate, isDateObject, isDef, isEmpty, isEqual, isError, isFunction, isInfinity, isMap, isNode, isNullOrUndefined, isNumber, isObject, isOneEmoji, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isSkip, isString, isSuccess, isSymbol, isTimeObject, isTimeString, isTimeValue, isValidWeekDay, isWeakMap, isWeakSet, isWithCache, isoToFlagEmoji, kebabCase, keyBy, logger, loggerSetLevel, lowerCase, luminance, maskingEmail, maskingPhone, maskingWords, nextTickIteration, noop, objectId, omit, omitPrefixed, orderBy, parseAllNumbers, parseAlpha, parsePercentage, percentOf, pick, pickPrefixed, qs, rafPromise, randomString, removeVS16s, retryOnError, rgbToChannels, rleDecode, rleEncode, round2digits, secondsToHm, set, shuffle, snakeCase, sprintf, startCase, strAssign, sum, textDecoder, textEncoder, throttle, timeFromMinutes, timeStringify, timeToMinutes, timeout, timestamp, timestampMs, timestampToDate, tintedTextColor, toError, toMap, truncate, typeOf, uint16ToUint8, uint32ToUint8, uint8ToUint16, uint8ToUint32, unflatten, union, uniq, uniqBy, unset, weeksInYear, weightedRoundRobin, withCache, withCacheBucket, withCacheBucketBatch, withCacheFixed, withCacheLRU, withDeepClone, withPointerCache, withResolve, wrapText };
+export { AppError, AssertionError, AsyncIterableQueue, CancellablePromise, ColorParser, instance as EJSON, EJSON as EJSONInstance, EJSONStream, FindMean, FixedMap, FixedWeakMap, LruCache, Queue, ResourcePool, SCHEDULER_JOB_FLAGS, Scheduler, SimpleEventEmitter, SortedArray, TWEMOJI_REGEX, TimeBucket, TimeSpan, alpha, arrayable, assert, asyncFilter, asyncFind, asyncForEach, asyncMap, avg, avgCircular, base62, base62Fast, base64, base64ToBytes, base64url, basex, bigIntBytes, bigIntFromBytes, bitPack, bitUnpack, blendColors, buildCssColor, bytesToBase64, cache, cacheBucket, cacheFixed, cacheLRU, camelCase, capitalize, captureStackTrace, catchError, channelsToHSL, channelsToHex, channelsToRGB, checkBitmask, chunk, chunkSeries, clamp, cleanEmpty, cleanObject, colorToChannels, compareBytes, concatenateBytes, contrastRatio, convertToUnit, crc32, createCustomizer, createCustomizerFactory, createDateObject, createDeepCloneWith, createEJSON, createEJSONStream, createEnvParser, createFunction, createRandomizer, createScheduler, createSecureCustomizer, createTimeObject, createTimeSpan, createWithCache, cssVariable, dateInDays, dateInSeconds, debounce, deepAssign, deepClone, deepCloneWith, deepDefaults, deepFreeze, def, defer, delay, difference, dropCache, env, escapeHtml, escapeNumeric, escapeRegExp, fastIdle, fastIdlePromise, fastRaf, findMean, flagsToMap, flatten, formatMoney, formatNumber, get, getFileExtension, getFileName, getInitials, getLoggerLevel, getMostSpecificPaths, getRandomInt, getRandomTime, getWords, groupBy, has, hasOwn, hasProtocol, hex, hexToChannels, hmToSeconds, hslToChannels, humanFileSize, humanize, interpolateColor, intersection, intersectionBy, isBigInt, isBoolean, isCached, isClient, isColorChannels, isCustomizerFactory, isDate, isDateObject, isDef, isEmpty, isEqual, isError, isFunction, isInfinity, isMap, isNode, isNullOrUndefined, isNumber, isObject, isOneEmoji, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isSkip, isString, isSuccess, isSymbol, isTimeObject, isTimeString, isTimeValue, isValidWeekDay, isWeakMap, isWeakSet, isWithCache, isoToFlagEmoji, kebabCase, keyBy, logger, lowerCase, luminance, maskingEmail, maskingPhone, maskingWords, nextTickIteration, noop, objectId, omit, omitPrefixed, orderBy, parseAllNumbers, parseAlpha, parsePercentage, percentOf, pick, pickPrefixed, qs, rafPromise, randomString, removeVS16s, retryOnError, rgbToChannels, rleDecode, rleEncode, round2digits, secondsToHm, set, setLoggerLevel, shuffle, snakeCase, sprintf, startCase, strAssign, sum, textDecoder, textEncoder, throttle, timeFromMinutes, timeStringify, timeToMinutes, timeout, timestamp, timestampMs, timestampToDate, tintedTextColor, toError, toMap, truncate, typeOf, uint16ToUint8, uint32ToUint8, uint8ToUint16, uint8ToUint32, unflatten, union, uniq, uniqBy, unset, weeksInYear, weightedRoundRobin, withCache, withCacheBucket, withCacheBucketBatch, withCacheFixed, withCacheLRU, withDeepClone, withPointerCache, withResolve, wrapText };
 //# sourceMappingURL=index.mjs.map