@robinpath/transform

Data transformation and mapping utilities: pick, omit, rename, coerce, flatten, merge, pipeline, and more

Why use this module?

The transform module lets you:

• Pick specific keys from an object (supports nested paths with dot notation)
• Create a copy of an object with specific keys removed
• Rename keys in an object
• Apply transformations to specific values in an object
• Coerce a value to a target type

All functions are callable directly from RobinPath scripts with a simple, consistent API.

Installation

npm install @robinpath/transform

Quick Start

No credentials needed — start using it right away:

transform.omit $data ["password", "secret"]

Available Functions

| Function | Description | |----------|-------------| | transform.pick | Pick specific keys from an object (supports nested paths with dot notation) | | transform.omit | Create a copy of an object with specific keys removed | | transform.rename | Rename keys in an object | | transform.mapValues | Apply transformations to specific values in an object | | transform.coerce | Coerce a value to a target type | | transform.flatten | Flatten a nested object into a single level with dot-notation keys | | transform.unflatten | Unflatten a dot-notation object back into a nested structure | | transform.merge | Deep merge multiple objects (later objects override earlier ones) | | transform.defaults | Fill in missing/null/undefined keys from default values | | transform.template | Render a template string with {{key}} placeholders replaced by data values | | transform.group | Group an array of objects by a key value | | transform.pipeline | Apply a series of transformation steps to data | | transform.mapArray | Map an array of objects to a new shape by specifying target-to-source key mapping | | transform.filter | Filter an array of objects by matching key-value conditions | | transform.sort | Sort an array of objects by a key |

Examples

Create a copy of an object with specific keys removed

transform.omit $data ["password", "secret"]

Rename keys in an object

transform.rename $data {"firstName": "first_name", "lastName": "last_name"}

Apply transformations to specific values in an object

transform.mapValues $data {"age": "toNumber", "name": "trim"}

Integration with RobinPath

import { RobinPath } from "@wiredwp/robinpath";
import Module from "@robinpath/transform";

const rp = new RobinPath();
rp.registerModule(Module.name, Module.functions);
rp.registerModuleMeta(Module.name, Module.functionMetadata);

const result = await rp.executeScript(`
  transform.omit $data ["password", "secret"]
`);

Full API Reference

See MODULE.md for complete documentation including all parameters, return types, error handling, and advanced examples.

Related Modules

• @robinpath/json — JSON module for complementary functionality

License

MIT