payload-sanitizer 0.0.2 → 0.1.0

package/README.md

@@ -66,6 +66,8 @@ Returns a cleaned clone of `payload` (objects and arrays) without mutating the i
 - `trimStrings` (default `true`): `value.trim()` on strings before checks.
 - `cleanArrays` (default `true`): sanitize array items and drop ones that should be removed.
 - `drop` (defaults to `["undefined","null","emptyString","whitespaceString"]`): presets to remove. Presets: `"undefined" | "null" | "emptyString" | "whitespaceString" | "dash" | "nan"`.
+- `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.
 - `dropKeys`: key names to always remove.
 - `dropValues`: explicit values to remove (uses `Object.is`).
@@ -76,6 +78,16 @@ Notes:
 - `0`, `false`, and `""` inside `keepKeys` are preserved by design.
 - If everything is dropped, arrays become `[]`, objects become `{}`; primitives are returned as-is.
 
+Example with empty-object/array dropping:
+
+```ts
+sanitize(payload, {
+  drop: ["undefined", "null", "emptyString", "whitespaceString", "dash"],
+  dropEmptyObjects: true,
+  dropEmptyArrays: true,
+});
+```
+
 ### `sanitize.with(baseOptions)`
 
 Creates a preconfigured sanitizer.
@@ -132,6 +144,15 @@ pnpm test
 pnpm build
 ```
 
+## Contributing
+
+Contributions are welcome!  
+If you have ideas, edge cases, or want to improve performance/docs, please open an issue or PR.
+
+- Read: `CONTRIBUTING.md`
+- Report bugs: GitHub Issues
+- Feature requests: GitHub Issues
+
 ## License
 
 MIT

package/dist/index.cjs

@@ -11,6 +11,8 @@ var DEFAULT_OPTIONS = {
   deep: true,
   trimStrings: true,
   cleanArrays: true,
+  dropEmptyObjects: false,
+  dropEmptyArrays: false,
   drop: DEFAULT_DROP
 };
 function isPlainObject(value) {
@@ -71,6 +73,7 @@ function sanitizeAny(input, options, path) {
       const next = sanitizeAny(normalized[i], options, path.concat(i));
       if (next !== void 0) out.push(next);
     }
+    if (options.dropEmptyArrays && out.length === 0) return void 0;
     return out;
   }
   if (isPlainObject(normalized)) {
@@ -85,6 +88,8 @@ function sanitizeAny(input, options, path) {
         const next = sanitizeAny(v, options, path.concat(k));
         if (next !== void 0) out2[k] = next;
       }
+      if (options.dropEmptyObjects && Object.keys(out2).length === 0)
+        return void 0;
       return out2;
     }
     const out = {};
@@ -97,6 +102,8 @@ function sanitizeAny(input, options, path) {
       const next = sanitizeAny(v, options, path.concat(k));
       if (next !== void 0) out[k] = next;
     }
+    if (options.dropEmptyObjects && Object.keys(out).length === 0)
+      return void 0;
     return out;
   }
   return normalized;
@@ -107,7 +114,11 @@ function sanitize(payload, options = {}) {
     ...options,
     drop: options.drop ?? DEFAULT_OPTIONS.drop
   };
-  const result = sanitizeAny(payload, merged, []);
+  const result = sanitizeAny(
+    payload,
+    merged,
+    []
+  );
   if (result === void 0) {
     if (isPlainObject(payload)) return {};
     if (Array.isArray(payload)) return [];

package/dist/index.cjs.map

@@ -1 +1 @@
-{"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  shouldDrop?: (value: unknown, keyPath: KeyPath) => boolean;\n};\n\nconst DEFAULT_DROP: DropPreset[] = [\n  \"undefined\",\n  \"null\",\n  \"emptyString\",\n  \"whitespaceString\",\n];\n\nconst DEFAULT_OPTIONS: Required<\n  Pick<SanitizeOptions, \"deep\" | \"trimStrings\" | \"cleanArrays\">\n> & { drop: DropPreset[] } = {\n  deep: true,\n  trimStrings: true,\n  cleanArrays: true,\n  drop: DEFAULT_DROP,\n};\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(\n  value: unknown,\n  opts: Required<typeof DEFAULT_OPTIONS>,\n) {\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: Required<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    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      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    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(payload, merged, []);\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  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"]}

package/dist/index.d.cts

@@ -9,6 +9,16 @@ type SanitizeOptions = {
     dropKeys?: string[];
     dropValues?: unknown[];
     shouldDrop?: (value: unknown, keyPath: KeyPath) => boolean;
+    /**
+     * Drop objects that become empty after sanitizing.
+     * Default: false
+     */
+    dropEmptyObjects?: boolean;
+    /**
+     * Drop arrays that become empty after sanitizing.
+     * Default: false
+     */
+    dropEmptyArrays?: boolean;
 };
 declare function sanitize<T>(payload: T, options?: SanitizeOptions): T;
 declare const createSanitizer: (baseOptions?: SanitizeOptions) => <T>(payload: T, options?: SanitizeOptions) => T;

package/dist/index.d.ts

@@ -9,6 +9,16 @@ type SanitizeOptions = {
     dropKeys?: string[];
     dropValues?: unknown[];
     shouldDrop?: (value: unknown, keyPath: KeyPath) => boolean;
+    /**
+     * Drop objects that become empty after sanitizing.
+     * Default: false
+     */
+    dropEmptyObjects?: boolean;
+    /**
+     * Drop arrays that become empty after sanitizing.
+     * Default: false
+     */
+    dropEmptyArrays?: boolean;
 };
 declare function sanitize<T>(payload: T, options?: SanitizeOptions): T;
 declare const createSanitizer: (baseOptions?: SanitizeOptions) => <T>(payload: T, options?: SanitizeOptions) => T;

package/dist/index.js

@@ -9,6 +9,8 @@ var DEFAULT_OPTIONS = {
   deep: true,
   trimStrings: true,
   cleanArrays: true,
+  dropEmptyObjects: false,
+  dropEmptyArrays: false,
   drop: DEFAULT_DROP
 };
 function isPlainObject(value) {
@@ -69,6 +71,7 @@ function sanitizeAny(input, options, path) {
       const next = sanitizeAny(normalized[i], options, path.concat(i));
       if (next !== void 0) out.push(next);
     }
+    if (options.dropEmptyArrays && out.length === 0) return void 0;
     return out;
   }
   if (isPlainObject(normalized)) {
@@ -83,6 +86,8 @@ function sanitizeAny(input, options, path) {
         const next = sanitizeAny(v, options, path.concat(k));
         if (next !== void 0) out2[k] = next;
       }
+      if (options.dropEmptyObjects && Object.keys(out2).length === 0)
+        return void 0;
       return out2;
     }
     const out = {};
@@ -95,6 +100,8 @@ function sanitizeAny(input, options, path) {
       const next = sanitizeAny(v, options, path.concat(k));
       if (next !== void 0) out[k] = next;
     }
+    if (options.dropEmptyObjects && Object.keys(out).length === 0)
+      return void 0;
     return out;
   }
   return normalized;
@@ -105,7 +112,11 @@ function sanitize(payload, options = {}) {
     ...options,
     drop: options.drop ?? DEFAULT_OPTIONS.drop
   };
-  const result = sanitizeAny(payload, merged, []);
+  const result = sanitizeAny(
+    payload,
+    merged,
+    []
+  );
   if (result === void 0) {
     if (isPlainObject(payload)) return {};
     if (Array.isArray(payload)) return [];

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\nconst DEFAULT_DROP: DropPreset[] = [\n  \"undefined\",\n  \"null\",\n  \"emptyString\",\n  \"whitespaceString\",\n];\n\nconst DEFAULT_OPTIONS: Required<\n  Pick<SanitizeOptions, \"deep\" | \"trimStrings\" | \"cleanArrays\">\n> & { drop: DropPreset[] } = {\n  deep: true,\n  trimStrings: true,\n  cleanArrays: true,\n  drop: DEFAULT_DROP,\n};\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(\n  value: unknown,\n  opts: Required<typeof DEFAULT_OPTIONS>,\n) {\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: Required<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    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      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    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(payload, merged, []);\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":";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.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"]}

package/package.json

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