@itshackers/utilix 0.0.0-stage → 0.3.0

package/dist/response/index.d.cts

@@ -0,0 +1,41 @@
+interface SuccessResponse<T = unknown> {
+    success: true;
+    message?: string;
+    data?: T;
+    meta?: unknown;
+    request_id?: string;
+}
+interface ErrorResponse {
+    success: false;
+    message?: string;
+    code?: string | number;
+    errors?: unknown;
+    details?: unknown;
+    request_id?: string;
+}
+interface CreateSuccessResponseOptions<T> {
+    data?: T;
+    message?: string;
+    meta?: unknown;
+    requestId?: string;
+}
+interface CreateErrorResponseOptions {
+    message?: string;
+    code?: string | number;
+    errors?: unknown;
+    details?: unknown;
+    requestId?: string;
+}
+/**
+ * Builds a framework-independent success payload.
+ * This does not write HTTP headers or call Express `res.json`.
+ */
+declare function createSuccessResponse<T>(options?: CreateSuccessResponseOptions<T>): SuccessResponse<T>;
+/**
+ * Builds a framework-independent error payload.
+ * This does not write HTTP headers or call Express `res.json`.
+ */
+declare function createErrorResponse(options?: CreateErrorResponseOptions): ErrorResponse;
+
+export { createErrorResponse, createSuccessResponse };
+export type { CreateErrorResponseOptions, CreateSuccessResponseOptions, ErrorResponse, SuccessResponse };

package/dist/response/index.d.ts

@@ -0,0 +1,41 @@
+interface SuccessResponse<T = unknown> {
+    success: true;
+    message?: string;
+    data?: T;
+    meta?: unknown;
+    request_id?: string;
+}
+interface ErrorResponse {
+    success: false;
+    message?: string;
+    code?: string | number;
+    errors?: unknown;
+    details?: unknown;
+    request_id?: string;
+}
+interface CreateSuccessResponseOptions<T> {
+    data?: T;
+    message?: string;
+    meta?: unknown;
+    requestId?: string;
+}
+interface CreateErrorResponseOptions {
+    message?: string;
+    code?: string | number;
+    errors?: unknown;
+    details?: unknown;
+    requestId?: string;
+}
+/**
+ * Builds a framework-independent success payload.
+ * This does not write HTTP headers or call Express `res.json`.
+ */
+declare function createSuccessResponse<T>(options?: CreateSuccessResponseOptions<T>): SuccessResponse<T>;
+/**
+ * Builds a framework-independent error payload.
+ * This does not write HTTP headers or call Express `res.json`.
+ */
+declare function createErrorResponse(options?: CreateErrorResponseOptions): ErrorResponse;
+
+export { createErrorResponse, createSuccessResponse };
+export type { CreateErrorResponseOptions, CreateSuccessResponseOptions, ErrorResponse, SuccessResponse };

package/dist/response/index.js

@@ -0,0 +1,40 @@
+// src/response/index.ts
+function createSuccessResponse(options = {}) {
+  const response = { success: true };
+  if (options.message) {
+    response.message = options.message;
+  }
+  if (options.data !== void 0) {
+    response.data = options.data;
+  }
+  if (options.meta !== void 0) {
+    response.meta = options.meta;
+  }
+  if (options.requestId) {
+    response.request_id = options.requestId;
+  }
+  return response;
+}
+function createErrorResponse(options = {}) {
+  const response = { success: false };
+  if (options.message) {
+    response.message = options.message;
+  }
+  if (options.code !== void 0) {
+    response.code = options.code;
+  }
+  if (options.errors !== void 0) {
+    response.errors = options.errors;
+  }
+  if (options.details !== void 0) {
+    response.details = options.details;
+  }
+  if (options.requestId) {
+    response.request_id = options.requestId;
+  }
+  return response;
+}
+
+export { createErrorResponse, createSuccessResponse };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/response/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/response/index.ts"],"names":[],"mappings":";AAoCO,SAAS,qBAAA,CACd,OAAA,GAA2C,EAAC,EACxB;AACpB,EAAA,MAAM,QAAA,GAA+B,EAAE,OAAA,EAAS,IAAA,EAAK;AAErD,EAAA,IAAI,QAAQ,OAAA,EAAS;AACnB,IAAA,QAAA,CAAS,UAAU,OAAA,CAAQ,OAAA;AAAA,EAC7B;AACA,EAAA,IAAI,OAAA,CAAQ,SAAS,MAAA,EAAW;AAC9B,IAAA,QAAA,CAAS,OAAO,OAAA,CAAQ,IAAA;AAAA,EAC1B;AACA,EAAA,IAAI,OAAA,CAAQ,SAAS,MAAA,EAAW;AAC9B,IAAA,QAAA,CAAS,OAAO,OAAA,CAAQ,IAAA;AAAA,EAC1B;AACA,EAAA,IAAI,QAAQ,SAAA,EAAW;AACrB,IAAA,QAAA,CAAS,aAAa,OAAA,CAAQ,SAAA;AAAA,EAChC;AAEA,EAAA,OAAO,QAAA;AACT;AAMO,SAAS,mBAAA,CAAoB,OAAA,GAAsC,EAAC,EAAkB;AAC3F,EAAA,MAAM,QAAA,GAA0B,EAAE,OAAA,EAAS,KAAA,EAAM;AAEjD,EAAA,IAAI,QAAQ,OAAA,EAAS;AACnB,IAAA,QAAA,CAAS,UAAU,OAAA,CAAQ,OAAA;AAAA,EAC7B;AACA,EAAA,IAAI,OAAA,CAAQ,SAAS,MAAA,EAAW;AAC9B,IAAA,QAAA,CAAS,OAAO,OAAA,CAAQ,IAAA;AAAA,EAC1B;AACA,EAAA,IAAI,OAAA,CAAQ,WAAW,MAAA,EAAW;AAChC,IAAA,QAAA,CAAS,SAAS,OAAA,CAAQ,MAAA;AAAA,EAC5B;AACA,EAAA,IAAI,OAAA,CAAQ,YAAY,MAAA,EAAW;AACjC,IAAA,QAAA,CAAS,UAAU,OAAA,CAAQ,OAAA;AAAA,EAC7B;AACA,EAAA,IAAI,QAAQ,SAAA,EAAW;AACrB,IAAA,QAAA,CAAS,aAAa,OAAA,CAAQ,SAAA;AAAA,EAChC;AAEA,EAAA,OAAO,QAAA;AACT","file":"index.js","sourcesContent":["export interface SuccessResponse<T = unknown> {\r\n  success: true;\r\n  message?: string;\r\n  data?: T;\r\n  meta?: unknown;\r\n  request_id?: string;\r\n}\r\n\r\nexport interface ErrorResponse {\r\n  success: false;\r\n  message?: string;\r\n  code?: string | number;\r\n  errors?: unknown;\r\n  details?: unknown;\r\n  request_id?: string;\r\n}\r\n\r\nexport interface CreateSuccessResponseOptions<T> {\r\n  data?: T;\r\n  message?: string;\r\n  meta?: unknown;\r\n  requestId?: string;\r\n}\r\n\r\nexport interface CreateErrorResponseOptions {\r\n  message?: string;\r\n  code?: string | number;\r\n  errors?: unknown;\r\n  details?: unknown;\r\n  requestId?: string;\r\n}\r\n\r\n/**\r\n * Builds a framework-independent success payload.\r\n * This does not write HTTP headers or call Express `res.json`.\r\n */\r\nexport function createSuccessResponse<T>(\r\n  options: CreateSuccessResponseOptions<T> = {},\r\n): SuccessResponse<T> {\r\n  const response: SuccessResponse<T> = { success: true };\r\n\r\n  if (options.message) {\r\n    response.message = options.message;\r\n  }\r\n  if (options.data !== undefined) {\r\n    response.data = options.data;\r\n  }\r\n  if (options.meta !== undefined) {\r\n    response.meta = options.meta;\r\n  }\r\n  if (options.requestId) {\r\n    response.request_id = options.requestId;\r\n  }\r\n\r\n  return response;\r\n}\r\n\r\n/**\r\n * Builds a framework-independent error payload.\r\n * This does not write HTTP headers or call Express `res.json`.\r\n */\r\nexport function createErrorResponse(options: CreateErrorResponseOptions = {}): ErrorResponse {\r\n  const response: ErrorResponse = { success: false };\r\n\r\n  if (options.message) {\r\n    response.message = options.message;\r\n  }\r\n  if (options.code !== undefined) {\r\n    response.code = options.code;\r\n  }\r\n  if (options.errors !== undefined) {\r\n    response.errors = options.errors;\r\n  }\r\n  if (options.details !== undefined) {\r\n    response.details = options.details;\r\n  }\r\n  if (options.requestId) {\r\n    response.request_id = options.requestId;\r\n  }\r\n\r\n  return response;\r\n}\r\n"]}

package/dist/sanitize/index.cjs

@@ -0,0 +1,83 @@
+'use strict';
+
+// src/common/index.ts
+function isPlainObject(value) {
+  if (value === null || typeof value !== "object") {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === null || prototype === Object.prototype;
+}
+
+// src/sanitize/index.ts
+var DEFAULT_SENSITIVE_KEYS = [
+  "authorization",
+  "password",
+  "client_secret",
+  "otp",
+  "otp_hash",
+  "api_key",
+  "x-api-key",
+  "token",
+  "access_token",
+  "refresh_token",
+  "jwt",
+  "secret"
+];
+function resolveOptions(options = {}) {
+  return {
+    sensitiveKeys: new Set(
+      (options.sensitiveKeys ?? DEFAULT_SENSITIVE_KEYS).map((key) => key.toLowerCase())
+    ),
+    maxDepth: options.maxDepth ?? 6,
+    maxString: options.maxString ?? 2e3,
+    maxArray: options.maxArray ?? 50,
+    redactedValue: options.redactedValue ?? "[REDACTED]",
+    truncatedValue: options.truncatedValue ?? "[truncated]"
+  };
+}
+function sanitizeForLog(value, options = {}, depth = 0) {
+  const config = resolveOptions(options);
+  if (depth > config.maxDepth) {
+    return config.truncatedValue;
+  }
+  if (value == null || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "string") {
+    return value.length > config.maxString ? `${value.slice(0, config.maxString)}\u2026` : value;
+  }
+  if (Array.isArray(value)) {
+    return value.slice(0, config.maxArray).map((item) => sanitizeForLog(item, options, depth + 1));
+  }
+  if (isPlainObject(value)) {
+    const output = {};
+    for (const [key, nested] of Object.entries(value)) {
+      output[key] = config.sensitiveKeys.has(key.toLowerCase()) ? config.redactedValue : sanitizeForLog(nested, options, depth + 1);
+    }
+    return output;
+  }
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+  return String(value);
+}
+function sanitizeHeaders(headers, options = {}) {
+  const config = resolveOptions(options);
+  const output = {};
+  for (const [key, value] of Object.entries(headers)) {
+    if (config.sensitiveKeys.has(key.toLowerCase())) {
+      output[key] = config.redactedValue;
+    } else if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+      output[key] = value;
+    } else if (Array.isArray(value)) {
+      output[key] = value.map(String);
+    }
+  }
+  return output;
+}
+
+exports.sanitizeForLog = sanitizeForLog;
+exports.sanitizeHeaders = sanitizeHeaders;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/sanitize/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/common/index.ts","../../src/sanitize/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import { assertFiniteNumber } from \"../internal/validation.js\";\r\n\r\n/**\r\n * Returns `true` when the value is a plain object created by `{}`,\r\n * `Object.create(null)`, or `new Object()`. Arrays, `null`, and class\r\n * instances are rejected.\r\n */\r\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\r\n  if (value === null || typeof value !== \"object\") {\r\n    return false;\r\n  }\r\n\r\n  const prototype = Object.getPrototypeOf(value);\r\n  return prototype === null || prototype === Object.prototype;\r\n}\r\n\r\n/**\r\n * Returns `true` for `null`, `undefined`, and whitespace-only strings.\r\n * `0` and `false` are not treated as empty.\r\n */\r\nexport function isNilOrEmpty(value: unknown): boolean {\r\n  if (value == null) {\r\n    return true;\r\n  }\r\n\r\n  if (typeof value === \"string\") {\r\n    return value.trim().length === 0;\r\n  }\r\n\r\n  return false;\r\n}\r\n\r\n/**\r\n * Returns `value` unless it is `null` or `undefined`, in which case\r\n * `fallback` is returned.\r\n */\r\nexport function coalesce<T>(value: T | null | undefined, fallback: T): T {\r\n  return value ?? fallback;\r\n}\r\n\r\n/**\r\n * Coerces common truthy/falsey inputs to a boolean.\r\n * `null`, `undefined`, and empty or whitespace-only strings return `fallback`.\r\n *\r\n * @example\r\n * toBoolean(\"true\") // true\r\n * toBoolean(\"0\") // false\r\n * toBoolean(null, true) // true\r\n */\r\nexport function toBoolean(value: unknown, fallback = false): boolean {\r\n  if (value === true || value === 1 || value === \"1\") {\r\n    return true;\r\n  }\r\n\r\n  if (value === false || value === 0 || value === \"0\") {\r\n    return false;\r\n  }\r\n\r\n  if (typeof value === \"string\") {\r\n    const normalized = value.trim().toLowerCase();\r\n    if (normalized.length === 0) {\r\n      return fallback;\r\n    }\r\n    if (normalized === \"true\") {\r\n      return true;\r\n    }\r\n    if (normalized === \"false\") {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  if (value == null) {\r\n    return fallback;\r\n  }\r\n\r\n  return fallback;\r\n}\r\n\r\n/**\r\n * Recursively trims strings in arrays and plain objects.\r\n * Dates, class instances, and other non-plain objects are left unchanged.\r\n *\r\n * @example\r\n * deepTrim({ name: \"  Gold  \", tags: [\"  rsa  \"] })\r\n * // { name: \"Gold\", tags: [\"rsa\"] }\r\n */\r\nexport function deepTrim<T>(value: T): T {\r\n  if (typeof value === \"string\") {\r\n    return value.trim() as T;\r\n  }\r\n\r\n  if (Array.isArray(value)) {\r\n    return value.map((item) => deepTrim(item)) as T;\r\n  }\r\n\r\n  if (isPlainObject(value)) {\r\n    return Object.fromEntries(\r\n      Object.entries(value).map(([key, nested]) => [key, deepTrim(nested)]),\r\n    ) as T;\r\n  }\r\n\r\n  return value;\r\n}\r\n\r\n/**\r\n * Returns a shallow copy of a plain object without `null` or empty-string values.\r\n * Non-plain values are returned unchanged.\r\n *\r\n * @example\r\n * omitEmpty({ name: \"Gold\", note: \"\", city: null })\r\n * // { name: \"Gold\" }\r\n */\r\nexport function omitEmpty<T>(value: T): T {\r\n  if (!isPlainObject(value)) {\r\n    return value;\r\n  }\r\n\r\n  const cleaned = { ...value };\r\n  for (const key of Object.keys(cleaned)) {\r\n    if (cleaned[key] === \"\" || cleaned[key] === null) {\r\n      delete cleaned[key];\r\n    }\r\n  }\r\n\r\n  return cleaned as T;\r\n}\r\n\r\n/**\r\n * Returns `value` when it is one of the allowed values, otherwise `fallback`.\r\n *\r\n * @example\r\n * pickAllowed(\"hi\", [\"en\", \"hi\"] as const, \"en\") // \"hi\"\r\n * pickAllowed(\"fr\", [\"en\", \"hi\"] as const, \"en\") // \"en\"\r\n */\r\nexport function pickAllowed<T>(\r\n  value: unknown,\r\n  allowed: readonly T[],\r\n  fallback: T,\r\n): T {\r\n  return allowed.includes(value as T) ? (value as T) : fallback;\r\n}\r\n\r\n/**\r\n * Resolves after the given number of milliseconds.\r\n */\r\nexport function sleep(milliseconds: number): Promise<void> {\r\n  assertFiniteNumber(milliseconds, \"milliseconds\");\r\n\r\n  if (milliseconds < 0) {\r\n    throw new RangeError(\"milliseconds must be greater than or equal to 0\");\r\n  }\r\n\r\n  return new Promise((resolve) => {\r\n    setTimeout(resolve, milliseconds);\r\n  });\r\n}\r\n","import { isPlainObject } from \"../common/index.js\";\r\n\r\nconst DEFAULT_SENSITIVE_KEYS = [\r\n  \"authorization\",\r\n  \"password\",\r\n  \"client_secret\",\r\n  \"otp\",\r\n  \"otp_hash\",\r\n  \"api_key\",\r\n  \"x-api-key\",\r\n  \"token\",\r\n  \"access_token\",\r\n  \"refresh_token\",\r\n  \"jwt\",\r\n  \"secret\",\r\n] as const;\r\n\r\nexport interface SanitizeOptions {\r\n  sensitiveKeys?: readonly string[];\r\n  maxDepth?: number;\r\n  maxString?: number;\r\n  maxArray?: number;\r\n  redactedValue?: string;\r\n  truncatedValue?: string;\r\n}\r\n\r\nfunction resolveOptions(options: SanitizeOptions = {}) {\r\n  return {\r\n    sensitiveKeys: new Set(\r\n      (options.sensitiveKeys ?? DEFAULT_SENSITIVE_KEYS).map((key) => key.toLowerCase()),\r\n    ),\r\n    maxDepth: options.maxDepth ?? 6,\r\n    maxString: options.maxString ?? 2_000,\r\n    maxArray: options.maxArray ?? 50,\r\n    redactedValue: options.redactedValue ?? \"[REDACTED]\",\r\n    truncatedValue: options.truncatedValue ?? \"[truncated]\",\r\n  };\r\n}\r\n\r\n/**\r\n * Deep-clones a value and redacts configured secret keys for safe logging.\r\n * Arrays, string length, and recursion depth are truncated.\r\n */\r\nexport function sanitizeForLog(value: unknown, options: SanitizeOptions = {}, depth = 0): unknown {\r\n  const config = resolveOptions(options);\r\n  if (depth > config.maxDepth) {\r\n    return config.truncatedValue;\r\n  }\r\n\r\n  if (value == null || typeof value === \"number\" || typeof value === \"boolean\") {\r\n    return value;\r\n  }\r\n\r\n  if (typeof value === \"string\") {\r\n    return value.length > config.maxString ? `${value.slice(0, config.maxString)}…` : value;\r\n  }\r\n\r\n  if (Array.isArray(value)) {\r\n    return value\r\n      .slice(0, config.maxArray)\r\n      .map((item) => sanitizeForLog(item, options, depth + 1));\r\n  }\r\n\r\n  if (isPlainObject(value)) {\r\n    const output: Record<string, unknown> = {};\r\n    for (const [key, nested] of Object.entries(value)) {\r\n      output[key] = config.sensitiveKeys.has(key.toLowerCase())\r\n        ? config.redactedValue\r\n        : sanitizeForLog(nested, options, depth + 1);\r\n    }\r\n    return output;\r\n  }\r\n\r\n  if (value instanceof Date) {\r\n    return value.toISOString();\r\n  }\r\n\r\n  return String(value);\r\n}\r\n\r\n/**\r\n * Returns a shallow copy of headers with secret keys redacted.\r\n */\r\nexport function sanitizeHeaders(\r\n  headers: Record<string, unknown>,\r\n  options: SanitizeOptions = {},\r\n): Record<string, unknown> {\r\n  const config = resolveOptions(options);\r\n  const output: Record<string, unknown> = {};\r\n\r\n  for (const [key, value] of Object.entries(headers)) {\r\n    if (config.sensitiveKeys.has(key.toLowerCase())) {\r\n      output[key] = config.redactedValue;\r\n    } else if (typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\") {\r\n      output[key] = value;\r\n    } else if (Array.isArray(value)) {\r\n      output[key] = value.map(String);\r\n    }\r\n  }\r\n\r\n  return output;\r\n}\r\n"]}

package/dist/sanitize/index.d.cts

@@ -0,0 +1,20 @@
+interface SanitizeOptions {
+    sensitiveKeys?: readonly string[];
+    maxDepth?: number;
+    maxString?: number;
+    maxArray?: number;
+    redactedValue?: string;
+    truncatedValue?: string;
+}
+/**
+ * Deep-clones a value and redacts configured secret keys for safe logging.
+ * Arrays, string length, and recursion depth are truncated.
+ */
+declare function sanitizeForLog(value: unknown, options?: SanitizeOptions, depth?: number): unknown;
+/**
+ * Returns a shallow copy of headers with secret keys redacted.
+ */
+declare function sanitizeHeaders(headers: Record<string, unknown>, options?: SanitizeOptions): Record<string, unknown>;
+
+export { sanitizeForLog, sanitizeHeaders };
+export type { SanitizeOptions };

package/dist/sanitize/index.d.ts

@@ -0,0 +1,20 @@
+interface SanitizeOptions {
+    sensitiveKeys?: readonly string[];
+    maxDepth?: number;
+    maxString?: number;
+    maxArray?: number;
+    redactedValue?: string;
+    truncatedValue?: string;
+}
+/**
+ * Deep-clones a value and redacts configured secret keys for safe logging.
+ * Arrays, string length, and recursion depth are truncated.
+ */
+declare function sanitizeForLog(value: unknown, options?: SanitizeOptions, depth?: number): unknown;
+/**
+ * Returns a shallow copy of headers with secret keys redacted.
+ */
+declare function sanitizeHeaders(headers: Record<string, unknown>, options?: SanitizeOptions): Record<string, unknown>;
+
+export { sanitizeForLog, sanitizeHeaders };
+export type { SanitizeOptions };

package/dist/sanitize/index.js

@@ -0,0 +1,80 @@
+// src/common/index.ts
+function isPlainObject(value) {
+  if (value === null || typeof value !== "object") {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === null || prototype === Object.prototype;
+}
+
+// src/sanitize/index.ts
+var DEFAULT_SENSITIVE_KEYS = [
+  "authorization",
+  "password",
+  "client_secret",
+  "otp",
+  "otp_hash",
+  "api_key",
+  "x-api-key",
+  "token",
+  "access_token",
+  "refresh_token",
+  "jwt",
+  "secret"
+];
+function resolveOptions(options = {}) {
+  return {
+    sensitiveKeys: new Set(
+      (options.sensitiveKeys ?? DEFAULT_SENSITIVE_KEYS).map((key) => key.toLowerCase())
+    ),
+    maxDepth: options.maxDepth ?? 6,
+    maxString: options.maxString ?? 2e3,
+    maxArray: options.maxArray ?? 50,
+    redactedValue: options.redactedValue ?? "[REDACTED]",
+    truncatedValue: options.truncatedValue ?? "[truncated]"
+  };
+}
+function sanitizeForLog(value, options = {}, depth = 0) {
+  const config = resolveOptions(options);
+  if (depth > config.maxDepth) {
+    return config.truncatedValue;
+  }
+  if (value == null || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "string") {
+    return value.length > config.maxString ? `${value.slice(0, config.maxString)}\u2026` : value;
+  }
+  if (Array.isArray(value)) {
+    return value.slice(0, config.maxArray).map((item) => sanitizeForLog(item, options, depth + 1));
+  }
+  if (isPlainObject(value)) {
+    const output = {};
+    for (const [key, nested] of Object.entries(value)) {
+      output[key] = config.sensitiveKeys.has(key.toLowerCase()) ? config.redactedValue : sanitizeForLog(nested, options, depth + 1);
+    }
+    return output;
+  }
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+  return String(value);
+}
+function sanitizeHeaders(headers, options = {}) {
+  const config = resolveOptions(options);
+  const output = {};
+  for (const [key, value] of Object.entries(headers)) {
+    if (config.sensitiveKeys.has(key.toLowerCase())) {
+      output[key] = config.redactedValue;
+    } else if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+      output[key] = value;
+    } else if (Array.isArray(value)) {
+      output[key] = value.map(String);
+    }
+  }
+  return output;
+}
+
+export { sanitizeForLog, sanitizeHeaders };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/sanitize/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/common/index.ts","../../src/sanitize/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { assertFiniteNumber } from \"../internal/validation.js\";\r\n\r\n/**\r\n * Returns `true` when the value is a plain object created by `{}`,\r\n * `Object.create(null)`, or `new Object()`. Arrays, `null`, and class\r\n * instances are rejected.\r\n */\r\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\r\n  if (value === null || typeof value !== \"object\") {\r\n    return false;\r\n  }\r\n\r\n  const prototype = Object.getPrototypeOf(value);\r\n  return prototype === null || prototype === Object.prototype;\r\n}\r\n\r\n/**\r\n * Returns `true` for `null`, `undefined`, and whitespace-only strings.\r\n * `0` and `false` are not treated as empty.\r\n */\r\nexport function isNilOrEmpty(value: unknown): boolean {\r\n  if (value == null) {\r\n    return true;\r\n  }\r\n\r\n  if (typeof value === \"string\") {\r\n    return value.trim().length === 0;\r\n  }\r\n\r\n  return false;\r\n}\r\n\r\n/**\r\n * Returns `value` unless it is `null` or `undefined`, in which case\r\n * `fallback` is returned.\r\n */\r\nexport function coalesce<T>(value: T | null | undefined, fallback: T): T {\r\n  return value ?? fallback;\r\n}\r\n\r\n/**\r\n * Coerces common truthy/falsey inputs to a boolean.\r\n * `null`, `undefined`, and empty or whitespace-only strings return `fallback`.\r\n *\r\n * @example\r\n * toBoolean(\"true\") // true\r\n * toBoolean(\"0\") // false\r\n * toBoolean(null, true) // true\r\n */\r\nexport function toBoolean(value: unknown, fallback = false): boolean {\r\n  if (value === true || value === 1 || value === \"1\") {\r\n    return true;\r\n  }\r\n\r\n  if (value === false || value === 0 || value === \"0\") {\r\n    return false;\r\n  }\r\n\r\n  if (typeof value === \"string\") {\r\n    const normalized = value.trim().toLowerCase();\r\n    if (normalized.length === 0) {\r\n      return fallback;\r\n    }\r\n    if (normalized === \"true\") {\r\n      return true;\r\n    }\r\n    if (normalized === \"false\") {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  if (value == null) {\r\n    return fallback;\r\n  }\r\n\r\n  return fallback;\r\n}\r\n\r\n/**\r\n * Recursively trims strings in arrays and plain objects.\r\n * Dates, class instances, and other non-plain objects are left unchanged.\r\n *\r\n * @example\r\n * deepTrim({ name: \"  Gold  \", tags: [\"  rsa  \"] })\r\n * // { name: \"Gold\", tags: [\"rsa\"] }\r\n */\r\nexport function deepTrim<T>(value: T): T {\r\n  if (typeof value === \"string\") {\r\n    return value.trim() as T;\r\n  }\r\n\r\n  if (Array.isArray(value)) {\r\n    return value.map((item) => deepTrim(item)) as T;\r\n  }\r\n\r\n  if (isPlainObject(value)) {\r\n    return Object.fromEntries(\r\n      Object.entries(value).map(([key, nested]) => [key, deepTrim(nested)]),\r\n    ) as T;\r\n  }\r\n\r\n  return value;\r\n}\r\n\r\n/**\r\n * Returns a shallow copy of a plain object without `null` or empty-string values.\r\n * Non-plain values are returned unchanged.\r\n *\r\n * @example\r\n * omitEmpty({ name: \"Gold\", note: \"\", city: null })\r\n * // { name: \"Gold\" }\r\n */\r\nexport function omitEmpty<T>(value: T): T {\r\n  if (!isPlainObject(value)) {\r\n    return value;\r\n  }\r\n\r\n  const cleaned = { ...value };\r\n  for (const key of Object.keys(cleaned)) {\r\n    if (cleaned[key] === \"\" || cleaned[key] === null) {\r\n      delete cleaned[key];\r\n    }\r\n  }\r\n\r\n  return cleaned as T;\r\n}\r\n\r\n/**\r\n * Returns `value` when it is one of the allowed values, otherwise `fallback`.\r\n *\r\n * @example\r\n * pickAllowed(\"hi\", [\"en\", \"hi\"] as const, \"en\") // \"hi\"\r\n * pickAllowed(\"fr\", [\"en\", \"hi\"] as const, \"en\") // \"en\"\r\n */\r\nexport function pickAllowed<T>(\r\n  value: unknown,\r\n  allowed: readonly T[],\r\n  fallback: T,\r\n): T {\r\n  return allowed.includes(value as T) ? (value as T) : fallback;\r\n}\r\n\r\n/**\r\n * Resolves after the given number of milliseconds.\r\n */\r\nexport function sleep(milliseconds: number): Promise<void> {\r\n  assertFiniteNumber(milliseconds, \"milliseconds\");\r\n\r\n  if (milliseconds < 0) {\r\n    throw new RangeError(\"milliseconds must be greater than or equal to 0\");\r\n  }\r\n\r\n  return new Promise((resolve) => {\r\n    setTimeout(resolve, milliseconds);\r\n  });\r\n}\r\n","import { isPlainObject } from \"../common/index.js\";\r\n\r\nconst DEFAULT_SENSITIVE_KEYS = [\r\n  \"authorization\",\r\n  \"password\",\r\n  \"client_secret\",\r\n  \"otp\",\r\n  \"otp_hash\",\r\n  \"api_key\",\r\n  \"x-api-key\",\r\n  \"token\",\r\n  \"access_token\",\r\n  \"refresh_token\",\r\n  \"jwt\",\r\n  \"secret\",\r\n] as const;\r\n\r\nexport interface SanitizeOptions {\r\n  sensitiveKeys?: readonly string[];\r\n  maxDepth?: number;\r\n  maxString?: number;\r\n  maxArray?: number;\r\n  redactedValue?: string;\r\n  truncatedValue?: string;\r\n}\r\n\r\nfunction resolveOptions(options: SanitizeOptions = {}) {\r\n  return {\r\n    sensitiveKeys: new Set(\r\n      (options.sensitiveKeys ?? DEFAULT_SENSITIVE_KEYS).map((key) => key.toLowerCase()),\r\n    ),\r\n    maxDepth: options.maxDepth ?? 6,\r\n    maxString: options.maxString ?? 2_000,\r\n    maxArray: options.maxArray ?? 50,\r\n    redactedValue: options.redactedValue ?? \"[REDACTED]\",\r\n    truncatedValue: options.truncatedValue ?? \"[truncated]\",\r\n  };\r\n}\r\n\r\n/**\r\n * Deep-clones a value and redacts configured secret keys for safe logging.\r\n * Arrays, string length, and recursion depth are truncated.\r\n */\r\nexport function sanitizeForLog(value: unknown, options: SanitizeOptions = {}, depth = 0): unknown {\r\n  const config = resolveOptions(options);\r\n  if (depth > config.maxDepth) {\r\n    return config.truncatedValue;\r\n  }\r\n\r\n  if (value == null || typeof value === \"number\" || typeof value === \"boolean\") {\r\n    return value;\r\n  }\r\n\r\n  if (typeof value === \"string\") {\r\n    return value.length > config.maxString ? `${value.slice(0, config.maxString)}…` : value;\r\n  }\r\n\r\n  if (Array.isArray(value)) {\r\n    return value\r\n      .slice(0, config.maxArray)\r\n      .map((item) => sanitizeForLog(item, options, depth + 1));\r\n  }\r\n\r\n  if (isPlainObject(value)) {\r\n    const output: Record<string, unknown> = {};\r\n    for (const [key, nested] of Object.entries(value)) {\r\n      output[key] = config.sensitiveKeys.has(key.toLowerCase())\r\n        ? config.redactedValue\r\n        : sanitizeForLog(nested, options, depth + 1);\r\n    }\r\n    return output;\r\n  }\r\n\r\n  if (value instanceof Date) {\r\n    return value.toISOString();\r\n  }\r\n\r\n  return String(value);\r\n}\r\n\r\n/**\r\n * Returns a shallow copy of headers with secret keys redacted.\r\n */\r\nexport function sanitizeHeaders(\r\n  headers: Record<string, unknown>,\r\n  options: SanitizeOptions = {},\r\n): Record<string, unknown> {\r\n  const config = resolveOptions(options);\r\n  const output: Record<string, unknown> = {};\r\n\r\n  for (const [key, value] of Object.entries(headers)) {\r\n    if (config.sensitiveKeys.has(key.toLowerCase())) {\r\n      output[key] = config.redactedValue;\r\n    } else if (typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\") {\r\n      output[key] = value;\r\n    } else if (Array.isArray(value)) {\r\n      output[key] = value.map(String);\r\n    }\r\n  }\r\n\r\n  return output;\r\n}\r\n"]}

package/dist/slug/index.cjs

@@ -0,0 +1,33 @@
+'use strict';
+
+// src/internal/validation.ts
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// src/slug/index.ts
+function slugify(value, options = {}) {
+  const separator = options.separator ?? "-";
+  const preserveUnicode = options.preserveUnicode ?? true;
+  const { maxLength } = options;
+  if (typeof separator !== "string" || separator.length === 0 || /\s/u.test(separator)) {
+    throw new TypeError("separator must be a non-empty string without whitespace");
+  }
+  if (options.preserveUnicode !== void 0 && typeof options.preserveUnicode !== "boolean") {
+    throw new TypeError("preserveUnicode must be a boolean");
+  }
+  if (maxLength !== void 0 && (!Number.isInteger(maxLength) || maxLength <= 0)) {
+    throw new RangeError("maxLength must be a positive integer");
+  }
+  const escapedSeparator = escapeRegExp(separator);
+  const disallowedPattern = preserveUnicode ? /[^\p{L}\p{N}]+/gu : /[^a-z0-9]+/g;
+  let slug = value.normalize("NFD").replace(/\p{M}/gu, "").toLowerCase().replace(disallowedPattern, separator).replace(new RegExp(`${escapedSeparator}+`, "g"), separator).replace(new RegExp(`^${escapedSeparator}|${escapedSeparator}$`, "g"), "");
+  if (maxLength !== void 0 && slug.length > maxLength) {
+    slug = slug.slice(0, maxLength).replace(new RegExp(`${escapedSeparator}+$`, "g"), "");
+  }
+  return slug;
+}
+
+exports.slugify = slugify;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/slug/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/validation.ts","../../src/slug/index.ts"],"names":[],"mappings":";;;AASO,SAAS,aAAa,KAAA,EAAuB;AAClD,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,qBAAA,EAAuB,MAAM,CAAA;AACpD;;;AC0BO,SAAS,OAAA,CAAQ,KAAA,EAAe,OAAA,GAA0B,EAAC,EAAW;AAC3E,EAAA,MAAM,SAAA,GAAY,QAAQ,SAAA,IAAa,GAAA;AACvC,EAAA,MAAM,eAAA,GAAkB,QAAQ,eAAA,IAAmB,IAAA;AACnD,EAAA,MAAM,EAAE,WAAU,GAAI,OAAA;AAEtB,EAAA,IAAI,OAAO,cAAc,QAAA,IAAY,SAAA,CAAU,WAAW,CAAA,IAAK,KAAA,CAAM,IAAA,CAAK,SAAS,CAAA,EAAG;AACpF,IAAA,MAAM,IAAI,UAAU,yDAAyD,CAAA;AAAA,EAC/E;AAEA,EAAA,IAAI,QAAQ,eAAA,KAAoB,MAAA,IAAa,OAAO,OAAA,CAAQ,oBAAoB,SAAA,EAAW;AACzF,IAAA,MAAM,IAAI,UAAU,mCAAmC,CAAA;AAAA,EACzD;AAEA,EAAA,IAAI,SAAA,KAAc,WAAc,CAAC,MAAA,CAAO,UAAU,SAAS,CAAA,IAAK,aAAa,CAAA,CAAA,EAAI;AAC/E,IAAA,MAAM,IAAI,WAAW,sCAAsC,CAAA;AAAA,EAC7D;AAEA,EAAA,MAAM,gBAAA,GAAmB,aAAa,SAAS,CAAA;AAC/C,EAAA,MAAM,iBAAA,GAAoB,kBAAkB,kBAAA,GAAqB,aAAA;AAEjE,EAAA,IAAI,IAAA,GAAO,KAAA,CACR,SAAA,CAAU,KAAK,EACf,OAAA,CAAQ,SAAA,EAAW,EAAE,CAAA,CACrB,aAAY,CACZ,OAAA,CAAQ,iBAAA,EAAmB,SAAS,EACpC,OAAA,CAAQ,IAAI,MAAA,CAAO,CAAA,EAAG,gBAAgB,CAAA,CAAA,CAAA,EAAK,GAAG,CAAA,EAAG,SAAS,EAC1D,OAAA,CAAQ,IAAI,MAAA,CAAO,CAAA,CAAA,EAAI,gBAAgB,CAAA,CAAA,EAAI,gBAAgB,CAAA,CAAA,CAAA,EAAK,GAAG,GAAG,EAAE,CAAA;AAE3E,EAAA,IAAI,SAAA,KAAc,MAAA,IAAa,IAAA,CAAK,MAAA,GAAS,SAAA,EAAW;AACtD,IAAA,IAAA,GAAO,IAAA,CACJ,KAAA,CAAM,CAAA,EAAG,SAAS,CAAA,CAClB,OAAA,CAAQ,IAAI,MAAA,CAAO,CAAA,EAAG,gBAAgB,CAAA,EAAA,CAAA,EAAM,GAAG,GAAG,EAAE,CAAA;AAAA,EACzD;AAEA,EAAA,OAAO,IAAA;AACT","file":"index.cjs","sourcesContent":["export function assertFiniteNumber(\r\n  value: unknown,\r\n  name: string,\r\n): asserts value is number {\r\n  if (typeof value !== \"number\" || !Number.isFinite(value)) {\r\n    throw new TypeError(`${name} must be a finite number`);\r\n  }\r\n}\r\n\r\nexport function escapeRegExp(value: string): string {\r\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\r\n}\r\n","import { escapeRegExp } from \"../internal/validation.js\";\r\n\r\nexport interface SlugifyOptions {\r\n  /**\r\n   * Word separator used in the generated slug.\r\n   * Must be a non-empty string that contains no whitespace.\r\n   * @default \"-\"\r\n   */\r\n  separator?: string;\r\n  /**\r\n   * Maximum slug length. Trailing separators are removed after truncation.\r\n   */\r\n  maxLength?: number;\r\n  /**\r\n   * When `true`, Unicode letters and numbers are kept after diacritic stripping.\r\n   * When `false`, only ASCII `[a-z0-9]` characters remain.\r\n   * @default true\r\n   */\r\n  preserveUnicode?: boolean;\r\n}\r\n\r\n/**\r\n * Converts text into a URL-friendly slug.\r\n *\r\n * The result is lowercased. Unicode is normalized with NFD and combining\r\n * marks are removed, so `\"Café\"` becomes `\"cafe\"`. This is not full\r\n * language transliteration, and generated slugs are not guaranteed unique.\r\n *\r\n * @throws {TypeError} When `separator` is empty or contains whitespace.\r\n * @throws {TypeError} When `preserveUnicode` is not a boolean.\r\n * @throws {RangeError} When `maxLength` is not a positive integer.\r\n *\r\n * @example\r\n * slugify(\"Cavalo Care — RSA Plans\") // \"cavalo-care-rsa-plans\"\r\n * slugify(\"Hello World\", { separator: \"_\" }) // \"hello_world\"\r\n * slugify(\"Café Products\") // \"cafe-products\"\r\n */\r\nexport function slugify(value: string, options: SlugifyOptions = {}): string {\r\n  const separator = options.separator ?? \"-\";\r\n  const preserveUnicode = options.preserveUnicode ?? true;\r\n  const { maxLength } = options;\r\n\r\n  if (typeof separator !== \"string\" || separator.length === 0 || /\\s/u.test(separator)) {\r\n    throw new TypeError(\"separator must be a non-empty string without whitespace\");\r\n  }\r\n\r\n  if (options.preserveUnicode !== undefined && typeof options.preserveUnicode !== \"boolean\") {\r\n    throw new TypeError(\"preserveUnicode must be a boolean\");\r\n  }\r\n\r\n  if (maxLength !== undefined && (!Number.isInteger(maxLength) || maxLength <= 0)) {\r\n    throw new RangeError(\"maxLength must be a positive integer\");\r\n  }\r\n\r\n  const escapedSeparator = escapeRegExp(separator);\r\n  const disallowedPattern = preserveUnicode ? /[^\\p{L}\\p{N}]+/gu : /[^a-z0-9]+/g;\r\n\r\n  let slug = value\r\n    .normalize(\"NFD\")\r\n    .replace(/\\p{M}/gu, \"\")\r\n    .toLowerCase()\r\n    .replace(disallowedPattern, separator)\r\n    .replace(new RegExp(`${escapedSeparator}+`, \"g\"), separator)\r\n    .replace(new RegExp(`^${escapedSeparator}|${escapedSeparator}$`, \"g\"), \"\");\r\n\r\n  if (maxLength !== undefined && slug.length > maxLength) {\r\n    slug = slug\r\n      .slice(0, maxLength)\r\n      .replace(new RegExp(`${escapedSeparator}+$`, \"g\"), \"\");\r\n  }\r\n\r\n  return slug;\r\n}\r\n"]}

package/dist/slug/index.d.cts

@@ -0,0 +1,38 @@
+interface SlugifyOptions {
+    /**
+     * Word separator used in the generated slug.
+     * Must be a non-empty string that contains no whitespace.
+     * @default "-"
+     */
+    separator?: string;
+    /**
+     * Maximum slug length. Trailing separators are removed after truncation.
+     */
+    maxLength?: number;
+    /**
+     * When `true`, Unicode letters and numbers are kept after diacritic stripping.
+     * When `false`, only ASCII `[a-z0-9]` characters remain.
+     * @default true
+     */
+    preserveUnicode?: boolean;
+}
+/**
+ * Converts text into a URL-friendly slug.
+ *
+ * The result is lowercased. Unicode is normalized with NFD and combining
+ * marks are removed, so `"Café"` becomes `"cafe"`. This is not full
+ * language transliteration, and generated slugs are not guaranteed unique.
+ *
+ * @throws {TypeError} When `separator` is empty or contains whitespace.
+ * @throws {TypeError} When `preserveUnicode` is not a boolean.
+ * @throws {RangeError} When `maxLength` is not a positive integer.
+ *
+ * @example
+ * slugify("Cavalo Care — RSA Plans") // "cavalo-care-rsa-plans"
+ * slugify("Hello World", { separator: "_" }) // "hello_world"
+ * slugify("Café Products") // "cafe-products"
+ */
+declare function slugify(value: string, options?: SlugifyOptions): string;
+
+export { slugify };
+export type { SlugifyOptions };

package/dist/slug/index.d.ts

@@ -0,0 +1,38 @@
+interface SlugifyOptions {
+    /**
+     * Word separator used in the generated slug.
+     * Must be a non-empty string that contains no whitespace.
+     * @default "-"
+     */
+    separator?: string;
+    /**
+     * Maximum slug length. Trailing separators are removed after truncation.
+     */
+    maxLength?: number;
+    /**
+     * When `true`, Unicode letters and numbers are kept after diacritic stripping.
+     * When `false`, only ASCII `[a-z0-9]` characters remain.
+     * @default true
+     */
+    preserveUnicode?: boolean;
+}
+/**
+ * Converts text into a URL-friendly slug.
+ *
+ * The result is lowercased. Unicode is normalized with NFD and combining
+ * marks are removed, so `"Café"` becomes `"cafe"`. This is not full
+ * language transliteration, and generated slugs are not guaranteed unique.
+ *
+ * @throws {TypeError} When `separator` is empty or contains whitespace.
+ * @throws {TypeError} When `preserveUnicode` is not a boolean.
+ * @throws {RangeError} When `maxLength` is not a positive integer.
+ *
+ * @example
+ * slugify("Cavalo Care — RSA Plans") // "cavalo-care-rsa-plans"
+ * slugify("Hello World", { separator: "_" }) // "hello_world"
+ * slugify("Café Products") // "cafe-products"
+ */
+declare function slugify(value: string, options?: SlugifyOptions): string;
+
+export { slugify };
+export type { SlugifyOptions };

package/dist/slug/index.js

@@ -0,0 +1,31 @@
+// src/internal/validation.ts
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// src/slug/index.ts
+function slugify(value, options = {}) {
+  const separator = options.separator ?? "-";
+  const preserveUnicode = options.preserveUnicode ?? true;
+  const { maxLength } = options;
+  if (typeof separator !== "string" || separator.length === 0 || /\s/u.test(separator)) {
+    throw new TypeError("separator must be a non-empty string without whitespace");
+  }
+  if (options.preserveUnicode !== void 0 && typeof options.preserveUnicode !== "boolean") {
+    throw new TypeError("preserveUnicode must be a boolean");
+  }
+  if (maxLength !== void 0 && (!Number.isInteger(maxLength) || maxLength <= 0)) {
+    throw new RangeError("maxLength must be a positive integer");
+  }
+  const escapedSeparator = escapeRegExp(separator);
+  const disallowedPattern = preserveUnicode ? /[^\p{L}\p{N}]+/gu : /[^a-z0-9]+/g;
+  let slug = value.normalize("NFD").replace(/\p{M}/gu, "").toLowerCase().replace(disallowedPattern, separator).replace(new RegExp(`${escapedSeparator}+`, "g"), separator).replace(new RegExp(`^${escapedSeparator}|${escapedSeparator}$`, "g"), "");
+  if (maxLength !== void 0 && slug.length > maxLength) {
+    slug = slug.slice(0, maxLength).replace(new RegExp(`${escapedSeparator}+$`, "g"), "");
+  }
+  return slug;
+}
+
+export { slugify };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/slug/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/validation.ts","../../src/slug/index.ts"],"names":[],"mappings":";AASO,SAAS,aAAa,KAAA,EAAuB;AAClD,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,qBAAA,EAAuB,MAAM,CAAA;AACpD;;;AC0BO,SAAS,OAAA,CAAQ,KAAA,EAAe,OAAA,GAA0B,EAAC,EAAW;AAC3E,EAAA,MAAM,SAAA,GAAY,QAAQ,SAAA,IAAa,GAAA;AACvC,EAAA,MAAM,eAAA,GAAkB,QAAQ,eAAA,IAAmB,IAAA;AACnD,EAAA,MAAM,EAAE,WAAU,GAAI,OAAA;AAEtB,EAAA,IAAI,OAAO,cAAc,QAAA,IAAY,SAAA,CAAU,WAAW,CAAA,IAAK,KAAA,CAAM,IAAA,CAAK,SAAS,CAAA,EAAG;AACpF,IAAA,MAAM,IAAI,UAAU,yDAAyD,CAAA;AAAA,EAC/E;AAEA,EAAA,IAAI,QAAQ,eAAA,KAAoB,MAAA,IAAa,OAAO,OAAA,CAAQ,oBAAoB,SAAA,EAAW;AACzF,IAAA,MAAM,IAAI,UAAU,mCAAmC,CAAA;AAAA,EACzD;AAEA,EAAA,IAAI,SAAA,KAAc,WAAc,CAAC,MAAA,CAAO,UAAU,SAAS,CAAA,IAAK,aAAa,CAAA,CAAA,EAAI;AAC/E,IAAA,MAAM,IAAI,WAAW,sCAAsC,CAAA;AAAA,EAC7D;AAEA,EAAA,MAAM,gBAAA,GAAmB,aAAa,SAAS,CAAA;AAC/C,EAAA,MAAM,iBAAA,GAAoB,kBAAkB,kBAAA,GAAqB,aAAA;AAEjE,EAAA,IAAI,IAAA,GAAO,KAAA,CACR,SAAA,CAAU,KAAK,EACf,OAAA,CAAQ,SAAA,EAAW,EAAE,CAAA,CACrB,aAAY,CACZ,OAAA,CAAQ,iBAAA,EAAmB,SAAS,EACpC,OAAA,CAAQ,IAAI,MAAA,CAAO,CAAA,EAAG,gBAAgB,CAAA,CAAA,CAAA,EAAK,GAAG,CAAA,EAAG,SAAS,EAC1D,OAAA,CAAQ,IAAI,MAAA,CAAO,CAAA,CAAA,EAAI,gBAAgB,CAAA,CAAA,EAAI,gBAAgB,CAAA,CAAA,CAAA,EAAK,GAAG,GAAG,EAAE,CAAA;AAE3E,EAAA,IAAI,SAAA,KAAc,MAAA,IAAa,IAAA,CAAK,MAAA,GAAS,SAAA,EAAW;AACtD,IAAA,IAAA,GAAO,IAAA,CACJ,KAAA,CAAM,CAAA,EAAG,SAAS,CAAA,CAClB,OAAA,CAAQ,IAAI,MAAA,CAAO,CAAA,EAAG,gBAAgB,CAAA,EAAA,CAAA,EAAM,GAAG,GAAG,EAAE,CAAA;AAAA,EACzD;AAEA,EAAA,OAAO,IAAA;AACT","file":"index.js","sourcesContent":["export function assertFiniteNumber(\r\n  value: unknown,\r\n  name: string,\r\n): asserts value is number {\r\n  if (typeof value !== \"number\" || !Number.isFinite(value)) {\r\n    throw new TypeError(`${name} must be a finite number`);\r\n  }\r\n}\r\n\r\nexport function escapeRegExp(value: string): string {\r\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\r\n}\r\n","import { escapeRegExp } from \"../internal/validation.js\";\r\n\r\nexport interface SlugifyOptions {\r\n  /**\r\n   * Word separator used in the generated slug.\r\n   * Must be a non-empty string that contains no whitespace.\r\n   * @default \"-\"\r\n   */\r\n  separator?: string;\r\n  /**\r\n   * Maximum slug length. Trailing separators are removed after truncation.\r\n   */\r\n  maxLength?: number;\r\n  /**\r\n   * When `true`, Unicode letters and numbers are kept after diacritic stripping.\r\n   * When `false`, only ASCII `[a-z0-9]` characters remain.\r\n   * @default true\r\n   */\r\n  preserveUnicode?: boolean;\r\n}\r\n\r\n/**\r\n * Converts text into a URL-friendly slug.\r\n *\r\n * The result is lowercased. Unicode is normalized with NFD and combining\r\n * marks are removed, so `\"Café\"` becomes `\"cafe\"`. This is not full\r\n * language transliteration, and generated slugs are not guaranteed unique.\r\n *\r\n * @throws {TypeError} When `separator` is empty or contains whitespace.\r\n * @throws {TypeError} When `preserveUnicode` is not a boolean.\r\n * @throws {RangeError} When `maxLength` is not a positive integer.\r\n *\r\n * @example\r\n * slugify(\"Cavalo Care — RSA Plans\") // \"cavalo-care-rsa-plans\"\r\n * slugify(\"Hello World\", { separator: \"_\" }) // \"hello_world\"\r\n * slugify(\"Café Products\") // \"cafe-products\"\r\n */\r\nexport function slugify(value: string, options: SlugifyOptions = {}): string {\r\n  const separator = options.separator ?? \"-\";\r\n  const preserveUnicode = options.preserveUnicode ?? true;\r\n  const { maxLength } = options;\r\n\r\n  if (typeof separator !== \"string\" || separator.length === 0 || /\\s/u.test(separator)) {\r\n    throw new TypeError(\"separator must be a non-empty string without whitespace\");\r\n  }\r\n\r\n  if (options.preserveUnicode !== undefined && typeof options.preserveUnicode !== \"boolean\") {\r\n    throw new TypeError(\"preserveUnicode must be a boolean\");\r\n  }\r\n\r\n  if (maxLength !== undefined && (!Number.isInteger(maxLength) || maxLength <= 0)) {\r\n    throw new RangeError(\"maxLength must be a positive integer\");\r\n  }\r\n\r\n  const escapedSeparator = escapeRegExp(separator);\r\n  const disallowedPattern = preserveUnicode ? /[^\\p{L}\\p{N}]+/gu : /[^a-z0-9]+/g;\r\n\r\n  let slug = value\r\n    .normalize(\"NFD\")\r\n    .replace(/\\p{M}/gu, \"\")\r\n    .toLowerCase()\r\n    .replace(disallowedPattern, separator)\r\n    .replace(new RegExp(`${escapedSeparator}+`, \"g\"), separator)\r\n    .replace(new RegExp(`^${escapedSeparator}|${escapedSeparator}$`, \"g\"), \"\");\r\n\r\n  if (maxLength !== undefined && slug.length > maxLength) {\r\n    slug = slug\r\n      .slice(0, maxLength)\r\n      .replace(new RegExp(`${escapedSeparator}+$`, \"g\"), \"\");\r\n  }\r\n\r\n  return slug;\r\n}\r\n"]}