payload-guard-filter 1.5.0 → 1.6.0

package/README.md

@@ -113,6 +113,21 @@ Creates a string builder with chained constraints:
 - `.transform(fn)` — Custom transformation function
 - `.validate(fn)` — Custom validation function (return `false` to fail)
 
+### Field Aliasing & Mapping (v1.6+)
+
+Rename fields from your database to match your frontend API:
+
+```typescript
+const userShape = guard.shape({
+  id: guard.string().from('_id'), // Map DB _id to id
+  workTime: guard.number().from('totalWorkTimeMs').transform(v => v / 1000),
+  name: 'string',
+});
+
+// Input: { _id: '123', totalWorkTimeMs: 5000, name: 'Sannu' }
+// Output: { id: '123', workTime: 5, name: 'Sannu' }
+```
+
 ---
 
 ## 🛡️ "Never Crash" Policy

package/dist/core/compiler.js

@@ -149,7 +149,9 @@ function compile(shape, opts = {}) {
         const result = {};
         for (const key of Object.keys(fieldFilters)) {
             try {
-                const sourceVal = source[key];
+                const config = shapeObj[key].__isBuilder ? shapeObj[key].config : shapeObj[key];
+                const sourceKey = (config && typeof config === 'object' && 'from' in config && config.from) ? config.from : key;
+                const sourceVal = source[sourceKey];
                 let outVal = fieldFilters[key](sourceVal);
                 // apply redact hook if provided
                 if (opts.redact) {

package/dist/core/filter.js

@@ -77,6 +77,7 @@ function createBuilder(type) {
         default(val) { config.default = val; return builder; },
         transform(fn) { config.transform = fn; return builder; },
         validate(fn) { config.validate = fn; return builder; },
+        from(key) { config.from = key; return builder; },
     };
     Object.setPrototypeOf(builder, proto);
     if (type === 'string') {

package/dist/core/types.d.ts

@@ -12,6 +12,8 @@ export interface FieldConfig<T extends PrimitiveType = PrimitiveType> {
     regex?: RegExp;
     email?: boolean;
     transform?: (v: any) => any;
+    /** Source field key name (aliasing) */
+    from?: string;
     /** Custom validation function: return false if invalid */
     validate?: (v: any) => boolean;
 }
@@ -24,6 +26,7 @@ export interface ShapeBuilder<T extends PrimitiveType> {
     default(val: InferPrimitive<T>): ShapeBuilder<T>;
     transform(fn: (v: InferPrimitive<T>) => any): ShapeBuilder<T>;
     validate(fn: (v: InferPrimitive<T>) => boolean): ShapeBuilder<T>;
+    from(key: string): ShapeBuilder<T>;
 }
 export interface StringBuilder extends ShapeBuilder<'string'> {
     min(len: number): StringBuilder;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "payload-guard-filter",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Lightweight, zero-dependency shape-based payload filtering and sanitization for Node.js and browser",
   "main": "dist/index.js",
   "module": "dist/index.js",