opticedge-cloud-utils 1.1.13 → 1.1.15

package/src/env.ts

@@ -1,8 +1,10 @@
-export function getEnv(name: string, fallback?: any): any {
-  const value = process.env[name]
-  if (!value) {
-    if (fallback !== undefined) return fallback
-    throw new Error(`Missing env var ${name}`)
-  }
-  return value
-}
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+export function getEnv(name: string, fallback?: any): any {
+  const value = process.env[name]
+  if (!value) {
+    if (fallback !== undefined) return fallback
+    throw new Error(`Missing env var ${name}`)
+  }
+  return value
+}

package/src/index.ts

@@ -1,13 +1,14 @@
-export * from './db/mongo'
-export * from './db/mongo2'
-export * from './db/mongo3'
-export * from './tw/utils'
-export * from './tw/wallet'
-export * from './auth'
-export * from './env'
-export * from './parser'
-export * from './regex'
-export * from './retry'
-export * from './secrets'
-export * from './task'
-export * from './validator'
+export * from './db/mongo'
+export * from './db/mongo2'
+export * from './db/mongo3'
+export * from './tw/utils'
+export * from './tw/wallet'
+export * from './auth'
+export * from './chunk'
+export * from './env'
+export * from './parser'
+export * from './regex'
+export * from './retry'
+export * from './secrets'
+export * from './task'
+export * from './validator'

package/src/parser.ts

@@ -1,9 +1,9 @@
-// Helper: accept number or numeric-string, return number or null
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-const toNumber = (v: any): number | null => {
-  if (typeof v === 'number' && Number.isFinite(v)) return v
-  if (typeof v === 'string' && /^\d+$/.test(v)) return Number(v)
-  return null
-}
-
-export { toNumber }
+// Helper: accept number or numeric-string, return number or null
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const toNumber = (v: any): number | null => {
+  if (typeof v === 'number' && Number.isFinite(v)) return v
+  if (typeof v === 'string' && /^\d+$/.test(v)) return Number(v)
+  return null
+}
+
+export { toNumber }

package/src/regex.ts

@@ -1,19 +1,19 @@
-/**
- * Escape user input so it can be safely used as a regex pattern string.
- *
- * - Escapes regex metacharacters.
- * - Replaces any run of whitespace with the token `\s+` so searches tolerate variable whitespace.
- * - Caps input length to avoid pathological long-input ReDoS vectors (default cap = 100).
- *
- * @param input - user-provided string to escape
- * @param maxLength - maximum number of characters to consider from input (default 100)
- * @returns a safe regex pattern string (do NOT wrap with // when passing to Mongo $regex)
- */
-export function escapeForRegex(input: string, maxLength = 100): string {
-  const safeStr = String(input ?? '')
-  const capped = safeStr.length > maxLength ? safeStr.slice(0, maxLength) : safeStr
-  // escape regex metacharacters: . * + ? ^ $ { } ( ) | [ ] \ /
-  const escaped = capped.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
-  // convert any whitespace run to the regex token \s+ (as a string)
-  return escaped.replace(/\s+/g, '\\s+')
-}
+/**
+ * Escape user input so it can be safely used as a regex pattern string.
+ *
+ * - Escapes regex metacharacters.
+ * - Replaces any run of whitespace with the token `\s+` so searches tolerate variable whitespace.
+ * - Caps input length to avoid pathological long-input ReDoS vectors (default cap = 100).
+ *
+ * @param input - user-provided string to escape
+ * @param maxLength - maximum number of characters to consider from input (default 100)
+ * @returns a safe regex pattern string (do NOT wrap with // when passing to Mongo $regex)
+ */
+export function escapeForRegex(input: string, maxLength = 100): string {
+  const safeStr = String(input ?? '')
+  const capped = safeStr.length > maxLength ? safeStr.slice(0, maxLength) : safeStr
+  // escape regex metacharacters: . * + ? ^ $ { } ( ) | [ ] \ /
+  const escaped = capped.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+  // convert any whitespace run to the regex token \s+ (as a string)
+  return escaped.replace(/\s+/g, '\\s+')
+}

package/src/retry.ts

@@ -1,155 +1,155 @@
-// src/retry.ts
-/* eslint-disable @typescript-eslint/no-explicit-any */
-
-import axios from 'axios'
-
-export type RetryOptions = {
-  retries?: number
-  baseDelayMs?: number
-  maxDelayMs?: number
-  timeoutMs?: number
-  signal?: AbortSignal | null
-  isRetryable?: (err: any) => boolean
-  onRetry?: (err: any, attempt: number, nextDelayMs: number) => void
-}
-
-export async function sleep(ms: number, signal?: AbortSignal | null) {
-  return new Promise<void>((resolve, reject) => {
-    if (signal?.aborted) return reject(new Error('Aborted'))
-    const t = setTimeout(() => {
-      signal?.removeEventListener?.('abort', onAbort)
-      resolve()
-    }, ms)
-
-    function onAbort() {
-      clearTimeout(t)
-      signal?.removeEventListener?.('abort', onAbort)
-      reject(new Error('Aborted'))
-    }
-
-    signal?.addEventListener?.('abort', onAbort)
-  })
-}
-
-export function isRetryableDefault(err: any): boolean {
-  if (!err) return false
-
-  // gRPC numeric code for UNAVAILABLE is 14
-  if (err?.code === 14 || err?.grpcCode === 14) return true
-
-  // Common Node network error codes
-  const syscode = String(err?.code ?? '').toLowerCase()
-  if (
-    syscode === 'econnreset' ||
-    syscode === 'etimedout' ||
-    syscode === 'econnrefused' ||
-    syscode === 'enotfound' ||
-    syscode === 'enetunreach' ||
-    syscode === 'eai_again' ||
-    syscode === 'ehostunreach' ||
-    syscode === 'epipe'
-  ) {
-    return true
-  }
-
-  // HTTP/Fetch style errors (axios / fetch)
-  const status = err?.response?.status ?? err?.status
-  if (typeof status === 'number') {
-    // retry on 429 (rate limit) and 5xx (server errors)
-    if (status === 429 || (status >= 500 && status < 600)) return true
-  }
-
-  // Message-based heuristics: include variants like "timed out" as well as "timeout"
-  const msg = String(err?.message ?? '').toLowerCase()
-
-  // Check for common retryable phrases:
-  // - timeout, timed out, time out
-  // - temporary
-  // - unavailable
-  if (/(timeout|timed out|time out|temporary|unavailable)/.test(msg)) return true
-
-  // Also accept explicit substrings for network-errno-like messages
-  if (msg.includes('econnreset') || msg.includes('etimedout')) return true
-
-  return false
-}
-
-export function isRetryableAxios(err: any): boolean {
-  if (!err) return false
-
-  // If axios knows about it:
-  if (axios.isAxiosError(err)) {
-    // No response -> network error / timeout -> retry
-    if (!err.response) return true
-
-    const status = err.response.status
-    // retry on 429 or 5xx
-    if (status === 429 || (status >= 500 && status < 600)) return true
-
-    // 4xx client errors -> do not retry
-    return false
-  }
-
-  // Fallback to your existing heuristics (gRPC codes, node syscodes, etc.)
-  return isRetryableDefault(err)
-}
-
-export async function retry<T>(fn: () => Promise<T>, opts: RetryOptions = {}): Promise<T> {
-  const retries = opts.retries ?? 4
-  const base = opts.baseDelayMs ?? 200
-  const max = opts.maxDelayMs ?? 5000
-  const timeoutMs = opts.timeoutMs
-  const signal = opts.signal ?? null
-  const isRetryable = opts.isRetryable ?? isRetryableDefault
-  const onRetry = opts.onRetry
-
-  const start = Date.now()
-
-  let attempt = 0
-  let lastErr: any
-
-  // attempt = number of retries already performed; initial try is attempt==0
-  while (attempt <= retries) {
-    if (signal?.aborted) throw new Error('Aborted')
-
-    try {
-      return await fn()
-    } catch (err) {
-      lastErr = err
-
-      if (!isRetryable(err)) {
-        throw err
-      }
-
-      if (attempt >= retries) break
-
-      // compute next retry (1-based)
-      const nextAttempt = attempt + 1
-      const exp = Math.min(max, base * Math.pow(2, nextAttempt - 1))
-      const delay = Math.floor(Math.random() * exp)
-
-      if (typeof timeoutMs === 'number') {
-        const elapsed = Date.now() - start
-        if (elapsed + delay > timeoutMs) {
-          break
-        }
-      }
-
-      try {
-        // pass 1-based attempt to onRetry to mean "this is the upcoming retry number"
-        onRetry?.(err, nextAttempt, delay)
-      } catch {
-        /* ignore onRetry errors */
-      }
-
-      await sleep(delay, signal)
-      attempt = nextAttempt
-    }
-  }
-
-  const finalErr = new Error(
-    `Retry failed after ${attempt} retries: ${String(lastErr?.message ?? lastErr)}`
-  )
-  ;(finalErr as any).original = lastErr
-  throw finalErr
-}
+// src/retry.ts
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+import axios from 'axios'
+
+export type RetryOptions = {
+  retries?: number
+  baseDelayMs?: number
+  maxDelayMs?: number
+  timeoutMs?: number
+  signal?: AbortSignal | null
+  isRetryable?: (err: any) => boolean
+  onRetry?: (err: any, attempt: number, nextDelayMs: number) => void
+}
+
+export async function sleep(ms: number, signal?: AbortSignal | null) {
+  return new Promise<void>((resolve, reject) => {
+    if (signal?.aborted) return reject(new Error('Aborted'))
+    const t = setTimeout(() => {
+      signal?.removeEventListener?.('abort', onAbort)
+      resolve()
+    }, ms)
+
+    function onAbort() {
+      clearTimeout(t)
+      signal?.removeEventListener?.('abort', onAbort)
+      reject(new Error('Aborted'))
+    }
+
+    signal?.addEventListener?.('abort', onAbort)
+  })
+}
+
+export function isRetryableDefault(err: any): boolean {
+  if (!err) return false
+
+  // gRPC numeric code for UNAVAILABLE is 14
+  if (err?.code === 14 || err?.grpcCode === 14) return true
+
+  // Common Node network error codes
+  const syscode = String(err?.code ?? '').toLowerCase()
+  if (
+    syscode === 'econnreset' ||
+    syscode === 'etimedout' ||
+    syscode === 'econnrefused' ||
+    syscode === 'enotfound' ||
+    syscode === 'enetunreach' ||
+    syscode === 'eai_again' ||
+    syscode === 'ehostunreach' ||
+    syscode === 'epipe'
+  ) {
+    return true
+  }
+
+  // HTTP/Fetch style errors (axios / fetch)
+  const status = err?.response?.status ?? err?.status
+  if (typeof status === 'number') {
+    // retry on 429 (rate limit) and 5xx (server errors)
+    if (status === 429 || (status >= 500 && status < 600)) return true
+  }
+
+  // Message-based heuristics: include variants like "timed out" as well as "timeout"
+  const msg = String(err?.message ?? '').toLowerCase()
+
+  // Check for common retryable phrases:
+  // - timeout, timed out, time out
+  // - temporary
+  // - unavailable
+  if (/(timeout|timed out|time out|temporary|unavailable)/.test(msg)) return true
+
+  // Also accept explicit substrings for network-errno-like messages
+  if (msg.includes('econnreset') || msg.includes('etimedout')) return true
+
+  return false
+}
+
+export function isRetryableAxios(err: any): boolean {
+  if (!err) return false
+
+  // If axios knows about it:
+  if (axios.isAxiosError(err)) {
+    // No response -> network error / timeout -> retry
+    if (!err.response) return true
+
+    const status = err.response.status
+    // retry on 429 or 5xx
+    if (status === 429 || (status >= 500 && status < 600)) return true
+
+    // 4xx client errors -> do not retry
+    return false
+  }
+
+  // Fallback to your existing heuristics (gRPC codes, node syscodes, etc.)
+  return isRetryableDefault(err)
+}
+
+export async function retry<T>(fn: () => Promise<T>, opts: RetryOptions = {}): Promise<T> {
+  const retries = opts.retries ?? 4
+  const base = opts.baseDelayMs ?? 200
+  const max = opts.maxDelayMs ?? 5000
+  const timeoutMs = opts.timeoutMs
+  const signal = opts.signal ?? null
+  const isRetryable = opts.isRetryable ?? isRetryableDefault
+  const onRetry = opts.onRetry
+
+  const start = Date.now()
+
+  let attempt = 0
+  let lastErr: any
+
+  // attempt = number of retries already performed; initial try is attempt==0
+  while (attempt <= retries) {
+    if (signal?.aborted) throw new Error('Aborted')
+
+    try {
+      return await fn()
+    } catch (err) {
+      lastErr = err
+
+      if (!isRetryable(err)) {
+        throw err
+      }
+
+      if (attempt >= retries) break
+
+      // compute next retry (1-based)
+      const nextAttempt = attempt + 1
+      const exp = Math.min(max, base * Math.pow(2, nextAttempt - 1))
+      const delay = Math.floor(Math.random() * exp)
+
+      if (typeof timeoutMs === 'number') {
+        const elapsed = Date.now() - start
+        if (elapsed + delay > timeoutMs) {
+          break
+        }
+      }
+
+      try {
+        // pass 1-based attempt to onRetry to mean "this is the upcoming retry number"
+        onRetry?.(err, nextAttempt, delay)
+      } catch {
+        /* ignore onRetry errors */
+      }
+
+      await sleep(delay, signal)
+      attempt = nextAttempt
+    }
+  }
+
+  const finalErr = new Error(
+    `Retry failed after ${attempt} retries: ${String(lastErr?.message ?? lastErr)}`
+  )
+  ;(finalErr as any).original = lastErr
+  throw finalErr
+}

package/src/secrets.ts

@@ -1,21 +1,21 @@
-import { SecretManagerServiceClient } from '@google-cloud/secret-manager'
-
-/**
- * Returns the latest value of a Secret Manager secret.
- *
- * @param projectId   – GCP project that owns the secret.
- * @param secretName  – Secret name (without version).
- * @returns           – UTF-8 string value.
- */
-export async function getSecret(projectId: string, secretName: string): Promise<string> {
-  if (!projectId) throw new Error('projectId is required')
-  if (!secretName) throw new Error('secretName is required')
-
-  const secretClient = new SecretManagerServiceClient()
-
-  const [version] = await secretClient.accessSecretVersion({
-    name: `projects/${projectId}/secrets/${secretName}/versions/latest`
-  })
-
-  return (version.payload?.data as Buffer)?.toString('utf-8') ?? ''
-}
+import { SecretManagerServiceClient } from '@google-cloud/secret-manager'
+
+/**
+ * Returns the latest value of a Secret Manager secret.
+ *
+ * @param projectId   – GCP project that owns the secret.
+ * @param secretName  – Secret name (without version).
+ * @returns           – UTF-8 string value.
+ */
+export async function getSecret(projectId: string, secretName: string): Promise<string> {
+  if (!projectId) throw new Error('projectId is required')
+  if (!secretName) throw new Error('secretName is required')
+
+  const secretClient = new SecretManagerServiceClient()
+
+  const [version] = await secretClient.accessSecretVersion({
+    name: `projects/${projectId}/secrets/${secretName}/versions/latest`
+  })
+
+  return (version.payload?.data as Buffer)?.toString('utf-8') ?? ''
+}