payload-sanitizer 0.1.0 → 0.2.0

package/README.md

@@ -4,6 +4,8 @@
 [![npm downloads](https://img.shields.io/npm/dm/payload-sanitizer.svg)](https://www.npmjs.com/package/payload-sanitizer)
 [![license](https://img.shields.io/npm/l/payload-sanitizer.svg)](./LICENSE)
 
+[![CI](https://github.com/mohit838/payload-sanitizer/actions/workflows/ci.yml/badge.svg)](https://github.com/mohit838/payload-sanitizer/actions/workflows/ci.yml)
+
 Tiny zero‑dependency sanitizer for JS/TS payloads that removes common junk (empty strings, whitespace-only strings, `null`, `undefined`, optional dash marker, `NaN`) without mutating the original value. Works in both frontend and backend code.
 
 ## Install
@@ -45,6 +47,8 @@ console.log(clean);
 // }
 ```
 
+See `examples/` for frontend + backend usage.
+
 ## Why this instead of validation libraries?
 
 Validation libs (e.g., Zod) parse **against a schema**. `payload-sanitizer` just **cleans/normalizes** data with simple rules—no schema required. They pair well:
@@ -69,7 +73,9 @@ Returns a cleaned clone of `payload` (objects and arrays) without mutating the i
 - `dropEmptyObjects` (default `false`): remove objects that become empty after sanitizing.
 - `dropEmptyArrays` (default `false`): remove arrays that become empty after sanitizing.
 - `keepKeys`: key names to always keep even if value looks droppable.
+- `keepPaths`: exact paths to always keep (e.g., `"filters.status"`).
 - `dropKeys`: key names to always remove.
+- `dropPaths`: exact paths to always drop (e.g., `"meta.debug"`).
 - `dropValues`: explicit values to remove (uses `Object.is`).
 - `shouldDrop(value, keyPath)`: custom predicate; return `true` to drop. `keyPath` is an array of keys/indexes from root.
 
@@ -88,6 +94,15 @@ sanitize(payload, {
 });
 ```
 
+Example with path-based rules:
+
+```ts
+sanitize(payload, {
+  keepPaths: ["filters.status"],
+  dropPaths: ["meta.debug"],
+});
+```
+
 ### `sanitize.with(baseOptions)`
 
 Creates a preconfigured sanitizer.

package/dist/index.cjs

@@ -61,11 +61,37 @@ function shouldDropExact(value, exactValues) {
 function hasKey(list, key) {
   return !!list && list.includes(key);
 }
+function toKeyPath(path) {
+  if (Array.isArray(path)) return path;
+  if (path.trim() === "") return [];
+  return path.split(".").map((seg) => {
+    const n = Number(seg);
+    return Number.isInteger(n) && String(n) === seg ? n : seg;
+  });
+}
+function pathEquals(a, b) {
+  if (a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i++) {
+    if (a[i] !== b[i]) return false;
+  }
+  return true;
+}
+function hasPath(list, path) {
+  if (!list || list.length === 0) return false;
+  for (const item of list) {
+    if (pathEquals(toKeyPath(item), path)) return true;
+  }
+  return false;
+}
 function sanitizeAny(input, options, path) {
   const normalized = normalizeValue(input, options);
-  if (shouldDropPreset(normalized, options.drop)) return void 0;
-  if (shouldDropExact(normalized, options.dropValues)) return void 0;
-  if (options.shouldDrop?.(normalized, path)) return void 0;
+  if (hasPath(options.dropPaths, path)) return void 0;
+  const isKeptPath = hasPath(options.keepPaths, path);
+  if (!isKeptPath) {
+    if (shouldDropPreset(normalized, options.drop)) return void 0;
+    if (shouldDropExact(normalized, options.dropValues)) return void 0;
+    if (options.shouldDrop?.(normalized, path)) return void 0;
+  }
   if (Array.isArray(normalized)) {
     if (!options.cleanArrays) return normalized.slice();
     const out = [];

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["out"],"mappings":";;;AAgCA,IAAM,YAAA,GAA6B;AAAA,EACjC,WAAA;AAAA,EACA,MAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF,CAAA;AAEA,IAAM,eAAA,GAAkB;AAAA,EACtB,IAAA,EAAM,IAAA;AAAA,EACN,WAAA,EAAa,IAAA;AAAA,EACb,WAAA,EAAa,IAAA;AAAA,EACb,gBAAA,EAAkB,KAAA;AAAA,EAClB,eAAA,EAAiB,KAAA;AAAA,EACjB,IAAA,EAAM;AACR,CAAA;AAWA,SAAS,cAAc,KAAA,EAAkD;AACvE,EAAA,IAAI,KAAA,KAAU,IAAA,IAAQ,OAAO,KAAA,KAAU,UAAU,OAAO,KAAA;AACxD,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,cAAA,CAAe,KAAK,CAAA;AACzC,EAAA,OAAO,KAAA,KAAU,MAAA,CAAO,SAAA,IAAa,KAAA,KAAU,IAAA;AACjD;AAEA,SAAS,cAAA,CAAe,OAAgB,IAAA,EAA8B;AACpE,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,IAAA,CAAK,WAAA,EAAa;AACjD,IAAA,OAAO,MAAM,IAAA,EAAK;AAAA,EACpB;AACA,EAAA,OAAO,KAAA;AACT;AAEA,SAAS,gBAAA,CAAiB,OAAgB,IAAA,EAA6B;AACrE,EAAA,KAAA,MAAW,KAAK,IAAA,EAAM;AACpB,IAAA,QAAQ,CAAA;AAAG,MACT,KAAK,WAAA;AACH,QAAA,IAAI,KAAA,KAAU,QAAW,OAAO,IAAA;AAChC,QAAA;AAAA,MACF,KAAK,MAAA;AACH,QAAA,IAAI,KAAA,KAAU,MAAM,OAAO,IAAA;AAC3B,QAAA;AAAA,MACF,KAAK,aAAA;AACH,QAAA,IAAI,KAAA,KAAU,IAAI,OAAO,IAAA;AACzB,QAAA;AAAA,MACF,KAAK,kBAAA;AAEH,QAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,MAAM,IAAA,EAAK,KAAM,IAAI,OAAO,IAAA;AAC7D,QAAA;AAAA,MACF,KAAK,MAAA;AACH,QAAA,IAAI,KAAA,KAAU,KAAK,OAAO,IAAA;AAC1B,QAAA;AAAA,MACF,KAAK,KAAA;AACH,QAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,OAAO,KAAA,CAAM,KAAK,GAAG,OAAO,IAAA;AAC7D,QAAA;AAAA;AACJ,EACF;AACA,EAAA,OAAO,KAAA;AACT;AAEA,SAAS,eAAA,CAAgB,OAAgB,WAAA,EAAkC;AACzE,EAAA,IAAI,CAAC,WAAA,IAAe,WAAA,CAAY,MAAA,KAAW,GAAG,OAAO,KAAA;AACrD,EAAA,KAAA,MAAW,KAAK,WAAA,EAAa;AAC3B,IAAA,IAAI,MAAA,CAAO,EAAA,CAAG,KAAA,EAAO,CAAC,GAAG,OAAO,IAAA;AAAA,EAClC;AACA,EAAA,OAAO,KAAA;AACT;AAEA,SAAS,MAAA,CAAO,MAA4B,GAAA,EAAsB;AAChE,EAAA,OAAO,CAAC,CAAC,IAAA,IAAQ,IAAA,CAAK,SAAS,GAAG,CAAA;AACpC;AAEA,SAAS,WAAA,CACP,KAAA,EACA,OAAA,EACA,IAAA,EACS;AACT,EAAA,MAAM,UAAA,GAAa,cAAA,CAAe,KAAA,EAAO,OAAO,CAAA;AAEhD,EAAA,IAAI,gBAAA,CAAiB,UAAA,EAAY,OAAA,CAAQ,IAAI,GAAG,OAAO,MAAA;AACvD,EAAA,IAAI,eAAA,CAAgB,UAAA,EAAY,OAAA,CAAQ,UAAU,GAAG,OAAO,MAAA;AAC5D,EAAA,IAAI,OAAA,CAAQ,UAAA,GAAa,UAAA,EAAY,IAAI,GAAG,OAAO,MAAA;AAEnD,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,UAAU,CAAA,EAAG;AAC7B,IAAA,IAAI,CAAC,OAAA,CAAQ,WAAA,EAAa,OAAO,WAAW,KAAA,EAAM;AAClD,IAAA,MAAM,MAAiB,EAAC;AACxB,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,UAAA,CAAW,QAAQ,CAAA,EAAA,EAAK;AAC1C,MAAA,MAAM,IAAA,GAAO,YAAY,UAAA,CAAW,CAAC,GAAG,OAAA,EAAS,IAAA,CAAK,MAAA,CAAO,CAAC,CAAC,CAAA;AAC/D,MAAA,IAAI,IAAA,KAAS,MAAA,EAAW,GAAA,CAAI,IAAA,CAAK,IAAI,CAAA;AAAA,IACvC;AACA,IAAA,IAAI,OAAA,CAAQ,eAAA,IAAmB,GAAA,CAAI,MAAA,KAAW,GAAG,OAAO,MAAA;AACxD,IAAA,OAAO,GAAA;AAAA,EACT;AAEA,EAAA,IAAI,aAAA,CAAc,UAAU,CAAA,EAAG;AAC7B,IAAA,IAAI,CAAC,QAAQ,IAAA,EAAM;AACjB,MAAA,MAAMA,OAA+B,EAAC;AACtC,MAAA,KAAA,MAAW,CAAC,CAAA,EAAG,CAAC,KAAK,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,EAAG;AAC/C,QAAA,IAAI,MAAA,CAAO,OAAA,CAAQ,QAAA,EAAU,CAAC,CAAA,EAAG;AACjC,QAAA,IAAI,MAAA,CAAO,OAAA,CAAQ,QAAA,EAAU,CAAC,CAAA,EAAG;AAC/B,UAAAA,IAAAA,CAAI,CAAC,CAAA,GAAI,CAAA;AACT,UAAA;AAAA,QACF;AACA,QAAA,MAAM,OAAO,WAAA,CAAY,CAAA,EAAG,SAAS,IAAA,CAAK,MAAA,CAAO,CAAC,CAAC,CAAA;AACnD,QAAA,IAAI,IAAA,KAAS,MAAA,EAAWA,IAAAA,CAAI,CAAC,CAAA,GAAI,IAAA;AAAA,MACnC;AACA,MAAA,IAAI,QAAQ,gBAAA,IAAoB,MAAA,CAAO,IAAA,CAAKA,IAAG,EAAE,MAAA,KAAW,CAAA;AAC1D,QAAA,OAAO,MAAA;AACT,MAAA,OAAOA,IAAAA;AAAA,IACT;AAEA,IAAA,MAAM,MAA+B,EAAC;AACtC,IAAA,KAAA,MAAW,CAAC,CAAA,EAAG,CAAC,KAAK,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,EAAG;AAC/C,MAAA,IAAI,MAAA,CAAO,OAAA,CAAQ,QAAA,EAAU,CAAC,CAAA,EAAG;AAEjC,MAAA,IAAI,MAAA,CAAO,OAAA,CAAQ,QAAA,EAAU,CAAC,CAAA,EAAG;AAC/B,QAAA,GAAA,CAAI,CAAC,CAAA,GAAI,CAAA;AACT,QAAA;AAAA,MACF;AAEA,MAAA,MAAM,OAAO,WAAA,CAAY,CAAA,EAAG,SAAS,IAAA,CAAK,MAAA,CAAO,CAAC,CAAC,CAAA;AACnD,MAAA,IAAI,IAAA,KAAS,MAAA,EAAW,GAAA,CAAI,CAAC,CAAA,GAAI,IAAA;AAAA,IACnC;AACA,IAAA,IAAI,QAAQ,gBAAA,IAAoB,MAAA,CAAO,IAAA,CAAK,GAAG,EAAE,MAAA,KAAW,CAAA;AAC1D,MAAA,OAAO,MAAA;AACT,IAAA,OAAO,GAAA;AAAA,EACT;AAEA,EAAA,OAAO,UAAA;AACT;AAEO,SAAS,QAAA,CAAY,OAAA,EAAY,OAAA,GAA2B,EAAC,EAAM;AACxE,EAAA,MAAM,MAAA,GAAS;AAAA,IACb,GAAG,eAAA;AAAA,IACH,GAAG,OAAA;AAAA,IACH,IAAA,EAAM,OAAA,CAAQ,IAAA,IAAQ,eAAA,CAAgB;AAAA,GACxC;AAEA,EAAA,MAAM,MAAA,GAAS,WAAA;AAAA,IACb,OAAA;AAAA,IACA,MAAA;AAAA,IACA;AAAC,GACH;AAEA,EAAA,IAAI,WAAW,MAAA,EAAW;AACxB,IAAA,IAAI,aAAA,CAAc,OAAO,CAAA,EAAG,OAAO,EAAC;AACpC,IAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAA,SAAU,EAAC;AACpC,IAAA,OAAO,OAAA;AAAA,EACT;AAEA,EAAA,OAAO,MAAA;AACT;AAOO,IAAM,eAAA,GAAkB,CAAC,WAAA,GAA+B,EAAC,KAAM;AACpE,EAAA,OAAO,CAAI,OAAA,EAAY,OAAA,GAA2B,EAAC,KACjD,QAAA,CAAS,OAAA,EAAS,EAAE,GAAG,WAAA,EAAa,GAAG,OAAA,EAAS,CAAA;AACpD;AAEC,QAAA,CAAyB,OAAO,CAAC,WAAA,GAA+B,EAAC,KAChE,gBAAgB,WAAW,CAAA;AAEtB,IAAM,eAAgB,QAAA,CAAyB","file":"index.cjs","sourcesContent":["export type DropPreset =\n  | \"null\"\n  | \"undefined\"\n  | \"emptyString\"\n  | \"whitespaceString\"\n  | \"dash\"\n  | \"nan\";\n\nexport type KeyPath = Array<string | number>;\n\nexport type SanitizeOptions = {\n  deep?: boolean;\n  trimStrings?: boolean;\n  cleanArrays?: boolean;\n  drop?: DropPreset[];\n  keepKeys?: string[];\n  dropKeys?: string[];\n  dropValues?: unknown[];\n  shouldDrop?: (value: unknown, keyPath: KeyPath) => boolean;\n  /**\n   * Drop objects that become empty after sanitizing.\n   * Default: false\n   */\n  dropEmptyObjects?: boolean;\n\n  /**\n   * Drop arrays that become empty after sanitizing.\n   * Default: false\n   */\n  dropEmptyArrays?: boolean;\n};\n\nconst DEFAULT_DROP: DropPreset[] = [\n  \"undefined\",\n  \"null\",\n  \"emptyString\",\n  \"whitespaceString\",\n];\n\nconst DEFAULT_OPTIONS = {\n  deep: true,\n  trimStrings: true,\n  cleanArrays: true,\n  dropEmptyObjects: false,\n  dropEmptyArrays: false,\n  drop: DEFAULT_DROP,\n} satisfies Required<\n  Pick<\n    SanitizeOptions,\n    | \"deep\"\n    | \"trimStrings\"\n    | \"cleanArrays\"\n    | \"dropEmptyObjects\"\n    | \"dropEmptyArrays\"\n  >\n> & { drop: DropPreset[] };\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (value === null || typeof value !== \"object\") return false;\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n}\n\nfunction normalizeValue(value: unknown, opts: typeof DEFAULT_OPTIONS) {\n  if (typeof value === \"string\" && opts.trimStrings) {\n    return value.trim();\n  }\n  return value;\n}\n\nfunction shouldDropPreset(value: unknown, drop: DropPreset[]): boolean {\n  for (const d of drop) {\n    switch (d) {\n      case \"undefined\":\n        if (value === undefined) return true;\n        break;\n      case \"null\":\n        if (value === null) return true;\n        break;\n      case \"emptyString\":\n        if (value === \"\") return true;\n        break;\n      case \"whitespaceString\":\n        // only matters if trimStrings is false; but still safe:\n        if (typeof value === \"string\" && value.trim() === \"\") return true;\n        break;\n      case \"dash\":\n        if (value === \"-\") return true;\n        break;\n      case \"nan\":\n        if (typeof value === \"number\" && Number.isNaN(value)) return true;\n        break;\n    }\n  }\n  return false;\n}\n\nfunction shouldDropExact(value: unknown, exactValues?: unknown[]): boolean {\n  if (!exactValues || exactValues.length === 0) return false;\n  for (const v of exactValues) {\n    if (Object.is(value, v)) return true;\n  }\n  return false;\n}\n\nfunction hasKey(list: string[] | undefined, key: string): boolean {\n  return !!list && list.includes(key);\n}\n\nfunction sanitizeAny(\n  input: unknown,\n  options: typeof DEFAULT_OPTIONS & SanitizeOptions,\n  path: KeyPath,\n): unknown {\n  const normalized = normalizeValue(input, options);\n\n  if (shouldDropPreset(normalized, options.drop)) return undefined;\n  if (shouldDropExact(normalized, options.dropValues)) return undefined;\n  if (options.shouldDrop?.(normalized, path)) return undefined;\n\n  if (Array.isArray(normalized)) {\n    if (!options.cleanArrays) return normalized.slice();\n    const out: unknown[] = [];\n    for (let i = 0; i < normalized.length; i++) {\n      const next = sanitizeAny(normalized[i], options, path.concat(i));\n      if (next !== undefined) out.push(next);\n    }\n    if (options.dropEmptyArrays && out.length === 0) return undefined;\n    return out;\n  }\n\n  if (isPlainObject(normalized)) {\n    if (!options.deep) {\n      const out: Record<string, unknown> = {};\n      for (const [k, v] of Object.entries(normalized)) {\n        if (hasKey(options.dropKeys, k)) continue;\n        if (hasKey(options.keepKeys, k)) {\n          out[k] = v;\n          continue;\n        }\n        const next = sanitizeAny(v, options, path.concat(k));\n        if (next !== undefined) out[k] = next;\n      }\n      if (options.dropEmptyObjects && Object.keys(out).length === 0)\n        return undefined;\n      return out;\n    }\n\n    const out: Record<string, unknown> = {};\n    for (const [k, v] of Object.entries(normalized)) {\n      if (hasKey(options.dropKeys, k)) continue;\n\n      if (hasKey(options.keepKeys, k)) {\n        out[k] = v;\n        continue;\n      }\n\n      const next = sanitizeAny(v, options, path.concat(k));\n      if (next !== undefined) out[k] = next;\n    }\n    if (options.dropEmptyObjects && Object.keys(out).length === 0)\n      return undefined;\n    return out;\n  }\n\n  return normalized;\n}\n\nexport function sanitize<T>(payload: T, options: SanitizeOptions = {}): T {\n  const merged = {\n    ...DEFAULT_OPTIONS,\n    ...options,\n    drop: options.drop ?? DEFAULT_OPTIONS.drop,\n  };\n\n  const result = sanitizeAny(\n    payload,\n    merged as typeof DEFAULT_OPTIONS & SanitizeOptions,\n    [],\n  );\n\n  if (result === undefined) {\n    if (isPlainObject(payload)) return {} as T;\n    if (Array.isArray(payload)) return [] as T;\n    return payload;\n  }\n\n  return result as T;\n}\n\ntype SanitizerFn = {\n  <T>(payload: T, options?: SanitizeOptions): T;\n  with: (baseOptions?: SanitizeOptions) => ReturnType<typeof createSanitizer>;\n};\n\nexport const createSanitizer = (baseOptions: SanitizeOptions = {}) => {\n  return <T>(payload: T, options: SanitizeOptions = {}) =>\n    sanitize(payload, { ...baseOptions, ...options });\n};\n\n(sanitize as SanitizerFn).with = (baseOptions: SanitizeOptions = {}) =>\n  createSanitizer(baseOptions);\n\nexport const sanitizeWith = (sanitize as SanitizerFn).with;\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["out"],"mappings":"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","file":"index.cjs","sourcesContent":["export type DropPreset =\n  | \"null\"\n  | \"undefined\"\n  | \"emptyString\"\n  | \"whitespaceString\"\n  | \"dash\"\n  | \"nan\";\n\nexport type KeyPath = Array<string | number>;\n\nexport type SanitizeOptions = {\n  deep?: boolean;\n  trimStrings?: boolean;\n  cleanArrays?: boolean;\n  drop?: DropPreset[];\n  keepKeys?: string[];\n  dropKeys?: string[];\n  dropValues?: unknown[];\n  /**\n   * Always keep these paths (even if value is droppable).\n   * Supports \"a.b.c\" or [\"a\",\"b\",\"c\"].\n   */\n  keepPaths?: Array<string | KeyPath>;\n  /**\n   * Always drop these paths (even if value is meaningful).\n   * Supports \"a.b.c\" or [\"a\",\"b\",\"c\"].\n   */\n  dropPaths?: Array<string | KeyPath>;\n  shouldDrop?: (value: unknown, keyPath: KeyPath) => boolean;\n  /**\n   * Drop objects that become empty after sanitizing.\n   * Default: false\n   */\n  dropEmptyObjects?: boolean;\n\n  /**\n   * Drop arrays that become empty after sanitizing.\n   * Default: false\n   */\n  dropEmptyArrays?: boolean;\n};\n\nconst DEFAULT_DROP: DropPreset[] = [\n  \"undefined\",\n  \"null\",\n  \"emptyString\",\n  \"whitespaceString\",\n];\n\nconst DEFAULT_OPTIONS = {\n  deep: true,\n  trimStrings: true,\n  cleanArrays: true,\n  dropEmptyObjects: false,\n  dropEmptyArrays: false,\n  drop: DEFAULT_DROP,\n} satisfies Required<\n  Pick<\n    SanitizeOptions,\n    | \"deep\"\n    | \"trimStrings\"\n    | \"cleanArrays\"\n    | \"dropEmptyObjects\"\n    | \"dropEmptyArrays\"\n  >\n> & { drop: DropPreset[] };\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (value === null || typeof value !== \"object\") return false;\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n}\n\nfunction normalizeValue(value: unknown, opts: typeof DEFAULT_OPTIONS) {\n  if (typeof value === \"string\" && opts.trimStrings) {\n    return value.trim();\n  }\n  return value;\n}\n\nfunction shouldDropPreset(value: unknown, drop: DropPreset[]): boolean {\n  for (const d of drop) {\n    switch (d) {\n      case \"undefined\":\n        if (value === undefined) return true;\n        break;\n      case \"null\":\n        if (value === null) return true;\n        break;\n      case \"emptyString\":\n        if (value === \"\") return true;\n        break;\n      case \"whitespaceString\":\n        // only matters if trimStrings is false; but still safe:\n        if (typeof value === \"string\" && value.trim() === \"\") return true;\n        break;\n      case \"dash\":\n        if (value === \"-\") return true;\n        break;\n      case \"nan\":\n        if (typeof value === \"number\" && Number.isNaN(value)) return true;\n        break;\n    }\n  }\n  return false;\n}\n\nfunction shouldDropExact(value: unknown, exactValues?: unknown[]): boolean {\n  if (!exactValues || exactValues.length === 0) return false;\n  for (const v of exactValues) {\n    if (Object.is(value, v)) return true;\n  }\n  return false;\n}\n\nfunction hasKey(list: string[] | undefined, key: string): boolean {\n  return !!list && list.includes(key);\n}\n\nfunction toKeyPath(path: string | KeyPath): KeyPath {\n  if (Array.isArray(path)) return path;\n  if (path.trim() === \"\") return [];\n  return path.split(\".\").map((seg) => {\n    const n = Number(seg);\n    return Number.isInteger(n) && String(n) === seg ? n : seg;\n  });\n}\n\nfunction pathEquals(a: KeyPath, b: KeyPath): boolean {\n  if (a.length !== b.length) return false;\n  for (let i = 0; i < a.length; i++) {\n    if (a[i] !== b[i]) return false;\n  }\n  return true;\n}\n\nfunction hasPath(list: Array<string | KeyPath> | undefined, path: KeyPath): boolean {\n  if (!list || list.length === 0) return false;\n  for (const item of list) {\n    if (pathEquals(toKeyPath(item), path)) return true;\n  }\n  return false;\n}\n\nfunction sanitizeAny(\n  input: unknown,\n  options: typeof DEFAULT_OPTIONS & SanitizeOptions,\n  path: KeyPath,\n): unknown {\n  const normalized = normalizeValue(input, options);\n\n  // Path-based overrides (highest priority)\n  if (hasPath(options.dropPaths, path)) return undefined;\n\n  const isKeptPath = hasPath(options.keepPaths, path);\n\n  if (!isKeptPath) {\n    if (shouldDropPreset(normalized, options.drop)) return undefined;\n    if (shouldDropExact(normalized, options.dropValues)) return undefined;\n    if (options.shouldDrop?.(normalized, path)) return undefined;\n  }\n\n  if (Array.isArray(normalized)) {\n    if (!options.cleanArrays) return normalized.slice();\n    const out: unknown[] = [];\n    for (let i = 0; i < normalized.length; i++) {\n      const next = sanitizeAny(normalized[i], options, path.concat(i));\n      if (next !== undefined) out.push(next);\n    }\n    if (options.dropEmptyArrays && out.length === 0) return undefined;\n    return out;\n  }\n\n  if (isPlainObject(normalized)) {\n    if (!options.deep) {\n      const out: Record<string, unknown> = {};\n      for (const [k, v] of Object.entries(normalized)) {\n        if (hasKey(options.dropKeys, k)) continue;\n        if (hasKey(options.keepKeys, k)) {\n          out[k] = v;\n          continue;\n        }\n        const next = sanitizeAny(v, options, path.concat(k));\n        if (next !== undefined) out[k] = next;\n      }\n      if (options.dropEmptyObjects && Object.keys(out).length === 0)\n        return undefined;\n      return out;\n    }\n\n    const out: Record<string, unknown> = {};\n    for (const [k, v] of Object.entries(normalized)) {\n      if (hasKey(options.dropKeys, k)) continue;\n\n      if (hasKey(options.keepKeys, k)) {\n        out[k] = v;\n        continue;\n      }\n\n      const next = sanitizeAny(v, options, path.concat(k));\n      if (next !== undefined) out[k] = next;\n    }\n    if (options.dropEmptyObjects && Object.keys(out).length === 0)\n      return undefined;\n    return out;\n  }\n\n  return normalized;\n}\n\nexport function sanitize<T>(payload: T, options: SanitizeOptions = {}): T {\n  const merged = {\n    ...DEFAULT_OPTIONS,\n    ...options,\n    drop: options.drop ?? DEFAULT_OPTIONS.drop,\n  };\n\n  const result = sanitizeAny(\n    payload,\n    merged as typeof DEFAULT_OPTIONS & SanitizeOptions,\n    [],\n  );\n\n  if (result === undefined) {\n    if (isPlainObject(payload)) return {} as T;\n    if (Array.isArray(payload)) return [] as T;\n    return payload;\n  }\n\n  return result as T;\n}\n\ntype SanitizerFn = {\n  <T>(payload: T, options?: SanitizeOptions): T;\n  with: (baseOptions?: SanitizeOptions) => ReturnType<typeof createSanitizer>;\n};\n\nexport const createSanitizer = (baseOptions: SanitizeOptions = {}) => {\n  return <T>(payload: T, options: SanitizeOptions = {}) =>\n    sanitize(payload, { ...baseOptions, ...options });\n};\n\n(sanitize as SanitizerFn).with = (baseOptions: SanitizeOptions = {}) =>\n  createSanitizer(baseOptions);\n\nexport const sanitizeWith = (sanitize as SanitizerFn).with;\n"]}

package/dist/index.d.cts

@@ -8,6 +8,16 @@ type SanitizeOptions = {
     keepKeys?: string[];
     dropKeys?: string[];
     dropValues?: unknown[];
+    /**
+     * Always keep these paths (even if value is droppable).
+     * Supports "a.b.c" or ["a","b","c"].
+     */
+    keepPaths?: Array<string | KeyPath>;
+    /**
+     * Always drop these paths (even if value is meaningful).
+     * Supports "a.b.c" or ["a","b","c"].
+     */
+    dropPaths?: Array<string | KeyPath>;
     shouldDrop?: (value: unknown, keyPath: KeyPath) => boolean;
     /**
      * Drop objects that become empty after sanitizing.

package/dist/index.d.ts

@@ -8,6 +8,16 @@ type SanitizeOptions = {
     keepKeys?: string[];
     dropKeys?: string[];
     dropValues?: unknown[];
+    /**
+     * Always keep these paths (even if value is droppable).
+     * Supports "a.b.c" or ["a","b","c"].
+     */
+    keepPaths?: Array<string | KeyPath>;
+    /**
+     * Always drop these paths (even if value is meaningful).
+     * Supports "a.b.c" or ["a","b","c"].
+     */
+    dropPaths?: Array<string | KeyPath>;
     shouldDrop?: (value: unknown, keyPath: KeyPath) => boolean;
     /**
      * Drop objects that become empty after sanitizing.

package/dist/index.js

@@ -59,11 +59,37 @@ function shouldDropExact(value, exactValues) {
 function hasKey(list, key) {
   return !!list && list.includes(key);
 }
+function toKeyPath(path) {
+  if (Array.isArray(path)) return path;
+  if (path.trim() === "") return [];
+  return path.split(".").map((seg) => {
+    const n = Number(seg);
+    return Number.isInteger(n) && String(n) === seg ? n : seg;
+  });
+}
+function pathEquals(a, b) {
+  if (a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i++) {
+    if (a[i] !== b[i]) return false;
+  }
+  return true;
+}
+function hasPath(list, path) {
+  if (!list || list.length === 0) return false;
+  for (const item of list) {
+    if (pathEquals(toKeyPath(item), path)) return true;
+  }
+  return false;
+}
 function sanitizeAny(input, options, path) {
   const normalized = normalizeValue(input, options);
-  if (shouldDropPreset(normalized, options.drop)) return void 0;
-  if (shouldDropExact(normalized, options.dropValues)) return void 0;
-  if (options.shouldDrop?.(normalized, path)) return void 0;
+  if (hasPath(options.dropPaths, path)) return void 0;
+  const isKeptPath = hasPath(options.keepPaths, path);
+  if (!isKeptPath) {
+    if (shouldDropPreset(normalized, options.drop)) return void 0;
+    if (shouldDropExact(normalized, options.dropValues)) return void 0;
+    if (options.shouldDrop?.(normalized, path)) return void 0;
+  }
   if (Array.isArray(normalized)) {
     if (!options.cleanArrays) return normalized.slice();
     const out = [];

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["out"],"mappings":"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","file":"index.js","sourcesContent":["export type DropPreset =\n  | \"null\"\n  | \"undefined\"\n  | \"emptyString\"\n  | \"whitespaceString\"\n  | \"dash\"\n  | \"nan\";\n\nexport type KeyPath = Array<string | number>;\n\nexport type SanitizeOptions = {\n  deep?: boolean;\n  trimStrings?: boolean;\n  cleanArrays?: boolean;\n  drop?: DropPreset[];\n  keepKeys?: string[];\n  dropKeys?: string[];\n  dropValues?: unknown[];\n  shouldDrop?: (value: unknown, keyPath: KeyPath) => boolean;\n  /**\n   * Drop objects that become empty after sanitizing.\n   * Default: false\n   */\n  dropEmptyObjects?: boolean;\n\n  /**\n   * Drop arrays that become empty after sanitizing.\n   * Default: false\n   */\n  dropEmptyArrays?: boolean;\n};\n\nconst DEFAULT_DROP: DropPreset[] = [\n  \"undefined\",\n  \"null\",\n  \"emptyString\",\n  \"whitespaceString\",\n];\n\nconst DEFAULT_OPTIONS = {\n  deep: true,\n  trimStrings: true,\n  cleanArrays: true,\n  dropEmptyObjects: false,\n  dropEmptyArrays: false,\n  drop: DEFAULT_DROP,\n} satisfies Required<\n  Pick<\n    SanitizeOptions,\n    | \"deep\"\n    | \"trimStrings\"\n    | \"cleanArrays\"\n    | \"dropEmptyObjects\"\n    | \"dropEmptyArrays\"\n  >\n> & { drop: DropPreset[] };\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (value === null || typeof value !== \"object\") return false;\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n}\n\nfunction normalizeValue(value: unknown, opts: typeof DEFAULT_OPTIONS) {\n  if (typeof value === \"string\" && opts.trimStrings) {\n    return value.trim();\n  }\n  return value;\n}\n\nfunction shouldDropPreset(value: unknown, drop: DropPreset[]): boolean {\n  for (const d of drop) {\n    switch (d) {\n      case \"undefined\":\n        if (value === undefined) return true;\n        break;\n      case \"null\":\n        if (value === null) return true;\n        break;\n      case \"emptyString\":\n        if (value === \"\") return true;\n        break;\n      case \"whitespaceString\":\n        // only matters if trimStrings is false; but still safe:\n        if (typeof value === \"string\" && value.trim() === \"\") return true;\n        break;\n      case \"dash\":\n        if (value === \"-\") return true;\n        break;\n      case \"nan\":\n        if (typeof value === \"number\" && Number.isNaN(value)) return true;\n        break;\n    }\n  }\n  return false;\n}\n\nfunction shouldDropExact(value: unknown, exactValues?: unknown[]): boolean {\n  if (!exactValues || exactValues.length === 0) return false;\n  for (const v of exactValues) {\n    if (Object.is(value, v)) return true;\n  }\n  return false;\n}\n\nfunction hasKey(list: string[] | undefined, key: string): boolean {\n  return !!list && list.includes(key);\n}\n\nfunction sanitizeAny(\n  input: unknown,\n  options: typeof DEFAULT_OPTIONS & SanitizeOptions,\n  path: KeyPath,\n): unknown {\n  const normalized = normalizeValue(input, options);\n\n  if (shouldDropPreset(normalized, options.drop)) return undefined;\n  if (shouldDropExact(normalized, options.dropValues)) return undefined;\n  if (options.shouldDrop?.(normalized, path)) return undefined;\n\n  if (Array.isArray(normalized)) {\n    if (!options.cleanArrays) return normalized.slice();\n    const out: unknown[] = [];\n    for (let i = 0; i < normalized.length; i++) {\n      const next = sanitizeAny(normalized[i], options, path.concat(i));\n      if (next !== undefined) out.push(next);\n    }\n    if (options.dropEmptyArrays && out.length === 0) return undefined;\n    return out;\n  }\n\n  if (isPlainObject(normalized)) {\n    if (!options.deep) {\n      const out: Record<string, unknown> = {};\n      for (const [k, v] of Object.entries(normalized)) {\n        if (hasKey(options.dropKeys, k)) continue;\n        if (hasKey(options.keepKeys, k)) {\n          out[k] = v;\n          continue;\n        }\n        const next = sanitizeAny(v, options, path.concat(k));\n        if (next !== undefined) out[k] = next;\n      }\n      if (options.dropEmptyObjects && Object.keys(out).length === 0)\n        return undefined;\n      return out;\n    }\n\n    const out: Record<string, unknown> = {};\n    for (const [k, v] of Object.entries(normalized)) {\n      if (hasKey(options.dropKeys, k)) continue;\n\n      if (hasKey(options.keepKeys, k)) {\n        out[k] = v;\n        continue;\n      }\n\n      const next = sanitizeAny(v, options, path.concat(k));\n      if (next !== undefined) out[k] = next;\n    }\n    if (options.dropEmptyObjects && Object.keys(out).length === 0)\n      return undefined;\n    return out;\n  }\n\n  return normalized;\n}\n\nexport function sanitize<T>(payload: T, options: SanitizeOptions = {}): T {\n  const merged = {\n    ...DEFAULT_OPTIONS,\n    ...options,\n    drop: options.drop ?? DEFAULT_OPTIONS.drop,\n  };\n\n  const result = sanitizeAny(\n    payload,\n    merged as typeof DEFAULT_OPTIONS & SanitizeOptions,\n    [],\n  );\n\n  if (result === undefined) {\n    if (isPlainObject(payload)) return {} as T;\n    if (Array.isArray(payload)) return [] as T;\n    return payload;\n  }\n\n  return result as T;\n}\n\ntype SanitizerFn = {\n  <T>(payload: T, options?: SanitizeOptions): T;\n  with: (baseOptions?: SanitizeOptions) => ReturnType<typeof createSanitizer>;\n};\n\nexport const createSanitizer = (baseOptions: SanitizeOptions = {}) => {\n  return <T>(payload: T, options: SanitizeOptions = {}) =>\n    sanitize(payload, { ...baseOptions, ...options });\n};\n\n(sanitize as SanitizerFn).with = (baseOptions: SanitizeOptions = {}) =>\n  createSanitizer(baseOptions);\n\nexport const sanitizeWith = (sanitize as SanitizerFn).with;\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["out"],"mappings":";AA0CA,IAAM,YAAA,GAA6B;AAAA,EACjC,WAAA;AAAA,EACA,MAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF,CAAA;AAEA,IAAM,eAAA,GAAkB;AAAA,EACtB,IAAA,EAAM,IAAA;AAAA,EACN,WAAA,EAAa,IAAA;AAAA,EACb,WAAA,EAAa,IAAA;AAAA,EACb,gBAAA,EAAkB,KAAA;AAAA,EAClB,eAAA,EAAiB,KAAA;AAAA,EACjB,IAAA,EAAM;AACR,CAAA;AAWA,SAAS,cAAc,KAAA,EAAkD;AACvE,EAAA,IAAI,KAAA,KAAU,IAAA,IAAQ,OAAO,KAAA,KAAU,UAAU,OAAO,KAAA;AACxD,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,cAAA,CAAe,KAAK,CAAA;AACzC,EAAA,OAAO,KAAA,KAAU,MAAA,CAAO,SAAA,IAAa,KAAA,KAAU,IAAA;AACjD;AAEA,SAAS,cAAA,CAAe,OAAgB,IAAA,EAA8B;AACpE,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,IAAA,CAAK,WAAA,EAAa;AACjD,IAAA,OAAO,MAAM,IAAA,EAAK;AAAA,EACpB;AACA,EAAA,OAAO,KAAA;AACT;AAEA,SAAS,gBAAA,CAAiB,OAAgB,IAAA,EAA6B;AACrE,EAAA,KAAA,MAAW,KAAK,IAAA,EAAM;AACpB,IAAA,QAAQ,CAAA;AAAG,MACT,KAAK,WAAA;AACH,QAAA,IAAI,KAAA,KAAU,QAAW,OAAO,IAAA;AAChC,QAAA;AAAA,MACF,KAAK,MAAA;AACH,QAAA,IAAI,KAAA,KAAU,MAAM,OAAO,IAAA;AAC3B,QAAA;AAAA,MACF,KAAK,aAAA;AACH,QAAA,IAAI,KAAA,KAAU,IAAI,OAAO,IAAA;AACzB,QAAA;AAAA,MACF,KAAK,kBAAA;AAEH,QAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,MAAM,IAAA,EAAK,KAAM,IAAI,OAAO,IAAA;AAC7D,QAAA;AAAA,MACF,KAAK,MAAA;AACH,QAAA,IAAI,KAAA,KAAU,KAAK,OAAO,IAAA;AAC1B,QAAA;AAAA,MACF,KAAK,KAAA;AACH,QAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,OAAO,KAAA,CAAM,KAAK,GAAG,OAAO,IAAA;AAC7D,QAAA;AAAA;AACJ,EACF;AACA,EAAA,OAAO,KAAA;AACT;AAEA,SAAS,eAAA,CAAgB,OAAgB,WAAA,EAAkC;AACzE,EAAA,IAAI,CAAC,WAAA,IAAe,WAAA,CAAY,MAAA,KAAW,GAAG,OAAO,KAAA;AACrD,EAAA,KAAA,MAAW,KAAK,WAAA,EAAa;AAC3B,IAAA,IAAI,MAAA,CAAO,EAAA,CAAG,KAAA,EAAO,CAAC,GAAG,OAAO,IAAA;AAAA,EAClC;AACA,EAAA,OAAO,KAAA;AACT;AAEA,SAAS,MAAA,CAAO,MAA4B,GAAA,EAAsB;AAChE,EAAA,OAAO,CAAC,CAAC,IAAA,IAAQ,IAAA,CAAK,SAAS,GAAG,CAAA;AACpC;AAEA,SAAS,UAAU,IAAA,EAAiC;AAClD,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,EAAG,OAAO,IAAA;AAChC,EAAA,IAAI,IAAA,CAAK,IAAA,EAAK,KAAM,EAAA,SAAW,EAAC;AAChC,EAAA,OAAO,KAAK,KAAA,CAAM,GAAG,CAAA,CAAE,GAAA,CAAI,CAAC,GAAA,KAAQ;AAClC,IAAA,MAAM,CAAA,GAAI,OAAO,GAAG,CAAA;AACpB,IAAA,OAAO,MAAA,CAAO,UAAU,CAAC,CAAA,IAAK,OAAO,CAAC,CAAA,KAAM,MAAM,CAAA,GAAI,GAAA;AAAA,EACxD,CAAC,CAAA;AACH;AAEA,SAAS,UAAA,CAAW,GAAY,CAAA,EAAqB;AACnD,EAAA,IAAI,CAAA,CAAE,MAAA,KAAW,CAAA,CAAE,MAAA,EAAQ,OAAO,KAAA;AAClC,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,CAAA,CAAE,QAAQ,CAAA,EAAA,EAAK;AACjC,IAAA,IAAI,EAAE,CAAC,CAAA,KAAM,CAAA,CAAE,CAAC,GAAG,OAAO,KAAA;AAAA,EAC5B;AACA,EAAA,OAAO,IAAA;AACT;AAEA,SAAS,OAAA,CAAQ,MAA2C,IAAA,EAAwB;AAClF,EAAA,IAAI,CAAC,IAAA,IAAQ,IAAA,CAAK,MAAA,KAAW,GAAG,OAAO,KAAA;AACvC,EAAA,KAAA,MAAW,QAAQ,IAAA,EAAM;AACvB,IAAA,IAAI,WAAW,SAAA,CAAU,IAAI,CAAA,EAAG,IAAI,GAAG,OAAO,IAAA;AAAA,EAChD;AACA,EAAA,OAAO,KAAA;AACT;AAEA,SAAS,WAAA,CACP,KAAA,EACA,OAAA,EACA,IAAA,EACS;AACT,EAAA,MAAM,UAAA,GAAa,cAAA,CAAe,KAAA,EAAO,OAAO,CAAA;AAGhD,EAAA,IAAI,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,IAAI,GAAG,OAAO,MAAA;AAE7C,EAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,OAAA,CAAQ,SAAA,EAAW,IAAI,CAAA;AAElD,EAAA,IAAI,CAAC,UAAA,EAAY;AACf,IAAA,IAAI,gBAAA,CAAiB,UAAA,EAAY,OAAA,CAAQ,IAAI,GAAG,OAAO,MAAA;AACvD,IAAA,IAAI,eAAA,CAAgB,UAAA,EAAY,OAAA,CAAQ,UAAU,GAAG,OAAO,MAAA;AAC5D,IAAA,IAAI,OAAA,CAAQ,UAAA,GAAa,UAAA,EAAY,IAAI,GAAG,OAAO,MAAA;AAAA,EACrD;AAEA,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,UAAU,CAAA,EAAG;AAC7B,IAAA,IAAI,CAAC,OAAA,CAAQ,WAAA,EAAa,OAAO,WAAW,KAAA,EAAM;AAClD,IAAA,MAAM,MAAiB,EAAC;AACxB,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,UAAA,CAAW,QAAQ,CAAA,EAAA,EAAK;AAC1C,MAAA,MAAM,IAAA,GAAO,YAAY,UAAA,CAAW,CAAC,GAAG,OAAA,EAAS,IAAA,CAAK,MAAA,CAAO,CAAC,CAAC,CAAA;AAC/D,MAAA,IAAI,IAAA,KAAS,MAAA,EAAW,GAAA,CAAI,IAAA,CAAK,IAAI,CAAA;AAAA,IACvC;AACA,IAAA,IAAI,OAAA,CAAQ,eAAA,IAAmB,GAAA,CAAI,MAAA,KAAW,GAAG,OAAO,MAAA;AACxD,IAAA,OAAO,GAAA;AAAA,EACT;AAEA,EAAA,IAAI,aAAA,CAAc,UAAU,CAAA,EAAG;AAC7B,IAAA,IAAI,CAAC,QAAQ,IAAA,EAAM;AACjB,MAAA,MAAMA,OAA+B,EAAC;AACtC,MAAA,KAAA,MAAW,CAAC,CAAA,EAAG,CAAC,KAAK,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,EAAG;AAC/C,QAAA,IAAI,MAAA,CAAO,OAAA,CAAQ,QAAA,EAAU,CAAC,CAAA,EAAG;AACjC,QAAA,IAAI,MAAA,CAAO,OAAA,CAAQ,QAAA,EAAU,CAAC,CAAA,EAAG;AAC/B,UAAAA,IAAAA,CAAI,CAAC,CAAA,GAAI,CAAA;AACT,UAAA;AAAA,QACF;AACA,QAAA,MAAM,OAAO,WAAA,CAAY,CAAA,EAAG,SAAS,IAAA,CAAK,MAAA,CAAO,CAAC,CAAC,CAAA;AACnD,QAAA,IAAI,IAAA,KAAS,MAAA,EAAWA,IAAAA,CAAI,CAAC,CAAA,GAAI,IAAA;AAAA,MACnC;AACA,MAAA,IAAI,QAAQ,gBAAA,IAAoB,MAAA,CAAO,IAAA,CAAKA,IAAG,EAAE,MAAA,KAAW,CAAA;AAC1D,QAAA,OAAO,MAAA;AACT,MAAA,OAAOA,IAAAA;AAAA,IACT;AAEA,IAAA,MAAM,MAA+B,EAAC;AACtC,IAAA,KAAA,MAAW,CAAC,CAAA,EAAG,CAAC,KAAK,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,EAAG;AAC/C,MAAA,IAAI,MAAA,CAAO,OAAA,CAAQ,QAAA,EAAU,CAAC,CAAA,EAAG;AAEjC,MAAA,IAAI,MAAA,CAAO,OAAA,CAAQ,QAAA,EAAU,CAAC,CAAA,EAAG;AAC/B,QAAA,GAAA,CAAI,CAAC,CAAA,GAAI,CAAA;AACT,QAAA;AAAA,MACF;AAEA,MAAA,MAAM,OAAO,WAAA,CAAY,CAAA,EAAG,SAAS,IAAA,CAAK,MAAA,CAAO,CAAC,CAAC,CAAA;AACnD,MAAA,IAAI,IAAA,KAAS,MAAA,EAAW,GAAA,CAAI,CAAC,CAAA,GAAI,IAAA;AAAA,IACnC;AACA,IAAA,IAAI,QAAQ,gBAAA,IAAoB,MAAA,CAAO,IAAA,CAAK,GAAG,EAAE,MAAA,KAAW,CAAA;AAC1D,MAAA,OAAO,MAAA;AACT,IAAA,OAAO,GAAA;AAAA,EACT;AAEA,EAAA,OAAO,UAAA;AACT;AAEO,SAAS,QAAA,CAAY,OAAA,EAAY,OAAA,GAA2B,EAAC,EAAM;AACxE,EAAA,MAAM,MAAA,GAAS;AAAA,IACb,GAAG,eAAA;AAAA,IACH,GAAG,OAAA;AAAA,IACH,IAAA,EAAM,OAAA,CAAQ,IAAA,IAAQ,eAAA,CAAgB;AAAA,GACxC;AAEA,EAAA,MAAM,MAAA,GAAS,WAAA;AAAA,IACb,OAAA;AAAA,IACA,MAAA;AAAA,IACA;AAAC,GACH;AAEA,EAAA,IAAI,WAAW,MAAA,EAAW;AACxB,IAAA,IAAI,aAAA,CAAc,OAAO,CAAA,EAAG,OAAO,EAAC;AACpC,IAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAA,SAAU,EAAC;AACpC,IAAA,OAAO,OAAA;AAAA,EACT;AAEA,EAAA,OAAO,MAAA;AACT;AAOO,IAAM,eAAA,GAAkB,CAAC,WAAA,GAA+B,EAAC,KAAM;AACpE,EAAA,OAAO,CAAI,OAAA,EAAY,OAAA,GAA2B,EAAC,KACjD,QAAA,CAAS,OAAA,EAAS,EAAE,GAAG,WAAA,EAAa,GAAG,OAAA,EAAS,CAAA;AACpD;AAEC,QAAA,CAAyB,OAAO,CAAC,WAAA,GAA+B,EAAC,KAChE,gBAAgB,WAAW,CAAA;AAEtB,IAAM,eAAgB,QAAA,CAAyB","file":"index.js","sourcesContent":["export type DropPreset =\n  | \"null\"\n  | \"undefined\"\n  | \"emptyString\"\n  | \"whitespaceString\"\n  | \"dash\"\n  | \"nan\";\n\nexport type KeyPath = Array<string | number>;\n\nexport type SanitizeOptions = {\n  deep?: boolean;\n  trimStrings?: boolean;\n  cleanArrays?: boolean;\n  drop?: DropPreset[];\n  keepKeys?: string[];\n  dropKeys?: string[];\n  dropValues?: unknown[];\n  /**\n   * Always keep these paths (even if value is droppable).\n   * Supports \"a.b.c\" or [\"a\",\"b\",\"c\"].\n   */\n  keepPaths?: Array<string | KeyPath>;\n  /**\n   * Always drop these paths (even if value is meaningful).\n   * Supports \"a.b.c\" or [\"a\",\"b\",\"c\"].\n   */\n  dropPaths?: Array<string | KeyPath>;\n  shouldDrop?: (value: unknown, keyPath: KeyPath) => boolean;\n  /**\n   * Drop objects that become empty after sanitizing.\n   * Default: false\n   */\n  dropEmptyObjects?: boolean;\n\n  /**\n   * Drop arrays that become empty after sanitizing.\n   * Default: false\n   */\n  dropEmptyArrays?: boolean;\n};\n\nconst DEFAULT_DROP: DropPreset[] = [\n  \"undefined\",\n  \"null\",\n  \"emptyString\",\n  \"whitespaceString\",\n];\n\nconst DEFAULT_OPTIONS = {\n  deep: true,\n  trimStrings: true,\n  cleanArrays: true,\n  dropEmptyObjects: false,\n  dropEmptyArrays: false,\n  drop: DEFAULT_DROP,\n} satisfies Required<\n  Pick<\n    SanitizeOptions,\n    | \"deep\"\n    | \"trimStrings\"\n    | \"cleanArrays\"\n    | \"dropEmptyObjects\"\n    | \"dropEmptyArrays\"\n  >\n> & { drop: DropPreset[] };\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (value === null || typeof value !== \"object\") return false;\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n}\n\nfunction normalizeValue(value: unknown, opts: typeof DEFAULT_OPTIONS) {\n  if (typeof value === \"string\" && opts.trimStrings) {\n    return value.trim();\n  }\n  return value;\n}\n\nfunction shouldDropPreset(value: unknown, drop: DropPreset[]): boolean {\n  for (const d of drop) {\n    switch (d) {\n      case \"undefined\":\n        if (value === undefined) return true;\n        break;\n      case \"null\":\n        if (value === null) return true;\n        break;\n      case \"emptyString\":\n        if (value === \"\") return true;\n        break;\n      case \"whitespaceString\":\n        // only matters if trimStrings is false; but still safe:\n        if (typeof value === \"string\" && value.trim() === \"\") return true;\n        break;\n      case \"dash\":\n        if (value === \"-\") return true;\n        break;\n      case \"nan\":\n        if (typeof value === \"number\" && Number.isNaN(value)) return true;\n        break;\n    }\n  }\n  return false;\n}\n\nfunction shouldDropExact(value: unknown, exactValues?: unknown[]): boolean {\n  if (!exactValues || exactValues.length === 0) return false;\n  for (const v of exactValues) {\n    if (Object.is(value, v)) return true;\n  }\n  return false;\n}\n\nfunction hasKey(list: string[] | undefined, key: string): boolean {\n  return !!list && list.includes(key);\n}\n\nfunction toKeyPath(path: string | KeyPath): KeyPath {\n  if (Array.isArray(path)) return path;\n  if (path.trim() === \"\") return [];\n  return path.split(\".\").map((seg) => {\n    const n = Number(seg);\n    return Number.isInteger(n) && String(n) === seg ? n : seg;\n  });\n}\n\nfunction pathEquals(a: KeyPath, b: KeyPath): boolean {\n  if (a.length !== b.length) return false;\n  for (let i = 0; i < a.length; i++) {\n    if (a[i] !== b[i]) return false;\n  }\n  return true;\n}\n\nfunction hasPath(list: Array<string | KeyPath> | undefined, path: KeyPath): boolean {\n  if (!list || list.length === 0) return false;\n  for (const item of list) {\n    if (pathEquals(toKeyPath(item), path)) return true;\n  }\n  return false;\n}\n\nfunction sanitizeAny(\n  input: unknown,\n  options: typeof DEFAULT_OPTIONS & SanitizeOptions,\n  path: KeyPath,\n): unknown {\n  const normalized = normalizeValue(input, options);\n\n  // Path-based overrides (highest priority)\n  if (hasPath(options.dropPaths, path)) return undefined;\n\n  const isKeptPath = hasPath(options.keepPaths, path);\n\n  if (!isKeptPath) {\n    if (shouldDropPreset(normalized, options.drop)) return undefined;\n    if (shouldDropExact(normalized, options.dropValues)) return undefined;\n    if (options.shouldDrop?.(normalized, path)) return undefined;\n  }\n\n  if (Array.isArray(normalized)) {\n    if (!options.cleanArrays) return normalized.slice();\n    const out: unknown[] = [];\n    for (let i = 0; i < normalized.length; i++) {\n      const next = sanitizeAny(normalized[i], options, path.concat(i));\n      if (next !== undefined) out.push(next);\n    }\n    if (options.dropEmptyArrays && out.length === 0) return undefined;\n    return out;\n  }\n\n  if (isPlainObject(normalized)) {\n    if (!options.deep) {\n      const out: Record<string, unknown> = {};\n      for (const [k, v] of Object.entries(normalized)) {\n        if (hasKey(options.dropKeys, k)) continue;\n        if (hasKey(options.keepKeys, k)) {\n          out[k] = v;\n          continue;\n        }\n        const next = sanitizeAny(v, options, path.concat(k));\n        if (next !== undefined) out[k] = next;\n      }\n      if (options.dropEmptyObjects && Object.keys(out).length === 0)\n        return undefined;\n      return out;\n    }\n\n    const out: Record<string, unknown> = {};\n    for (const [k, v] of Object.entries(normalized)) {\n      if (hasKey(options.dropKeys, k)) continue;\n\n      if (hasKey(options.keepKeys, k)) {\n        out[k] = v;\n        continue;\n      }\n\n      const next = sanitizeAny(v, options, path.concat(k));\n      if (next !== undefined) out[k] = next;\n    }\n    if (options.dropEmptyObjects && Object.keys(out).length === 0)\n      return undefined;\n    return out;\n  }\n\n  return normalized;\n}\n\nexport function sanitize<T>(payload: T, options: SanitizeOptions = {}): T {\n  const merged = {\n    ...DEFAULT_OPTIONS,\n    ...options,\n    drop: options.drop ?? DEFAULT_OPTIONS.drop,\n  };\n\n  const result = sanitizeAny(\n    payload,\n    merged as typeof DEFAULT_OPTIONS & SanitizeOptions,\n    [],\n  );\n\n  if (result === undefined) {\n    if (isPlainObject(payload)) return {} as T;\n    if (Array.isArray(payload)) return [] as T;\n    return payload;\n  }\n\n  return result as T;\n}\n\ntype SanitizerFn = {\n  <T>(payload: T, options?: SanitizeOptions): T;\n  with: (baseOptions?: SanitizeOptions) => ReturnType<typeof createSanitizer>;\n};\n\nexport const createSanitizer = (baseOptions: SanitizeOptions = {}) => {\n  return <T>(payload: T, options: SanitizeOptions = {}) =>\n    sanitize(payload, { ...baseOptions, ...options });\n};\n\n(sanitize as SanitizerFn).with = (baseOptions: SanitizeOptions = {}) =>\n  createSanitizer(baseOptions);\n\nexport const sanitizeWith = (sanitize as SanitizerFn).with;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "payload-sanitizer",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Tiny zero-dependency payload sanitizer for JS/TS (frontend + backend).",
   "keywords": [
     "sanitize",