{"_id":"@data-prism/utils","_rev":"9-ebf869d5120583617a38929ba2e2cb64","name":"@data-prism/utils","dist-tags":{"latest":"0.0.8"},"versions":{"0.0.1":{"name":"@data-prism/utils","version":"0.0.1","keywords":[],"author":{"name":"Jake Sower"},"_id":"@data-prism/utils@0.0.1","maintainers":[{"name":"blossomlib","email":"kind.salt4683@fastmail.com"}],"dist":{"shasum":"ee78d70cdeea9e42085c1a723f7b8d16562eeaa7","tarball":"https://registry.npmjs.org/@data-prism/utils/-/utils-0.0.1.tgz","fileCount":4,"integrity":"sha512-ne8d1Ri8XIFrSNK/hDysrtRqZZmi6yYibrpPYjnH3yiNi/6VlvOFilis7yXMaOarOACQQTMTEZ7oMCMlvQstLQ==","signatures":[{"sig":"MEQCICeKpUKUK5rQDf9vp2mvlyB9Xr+ZvMBPxLeSaw0liKJTAiBOk+uyS1cUGHNLTKYeTc/PiinBFxKW8DuxwIPEbsqhMA==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":2563},"main":"./src/utils.js","type":"module","types":"./src/utils.d.ts","exports":{".":"./src/utils.ts"},"gitHead":"f6583a2150216a1bb65b2caf7e835741b1556308","private":false,"scripts":{"test":"NODE_ENV=test vitest","build":"tsc -p ./tsconfig.json"},"_npmUser":{"name":"blossomlib","email":"kind.salt4683@fastmail.com"},"_npmVersion":"9.5.0","directories":{},"_nodeVersion":"18.15.0","dependencies":{"lodash-es":"^4.17.21"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^8.38.0","vitest":"^0.29.8","prettier":"^2.8.7","typescript":"^5.0.4","typescript-eslint":"^0.0.1-alpha.0","eslint-config-prettier":"^8.8.0","eslint-config-standard":"^17.0.0","@typescript-eslint/parser":"^5.57.1","@typescript-eslint/eslint-plugin":"^5.57.1"},"_npmOperationalInternal":{"tmp":"tmp/utils_0.0.1_1684855498175_0.23241851502971356","host":"s3://npm-registry-packages"}},"0.0.2":{"name":"@data-prism/utils","version":"0.0.2","keywords":[],"author":{"name":"Jake Sower"},"_id":"@data-prism/utils@0.0.2","maintainers":[{"name":"blossomlib","email":"kind.salt4683@fastmail.com"}],"dist":{"shasum":"0fd5518d2ac03ab2a56a66e74018dbfef5d452b7","tarball":"https://registry.npmjs.org/@data-prism/utils/-/utils-0.0.2.tgz","fileCount":4,"integrity":"sha512-nirjdshbLumMObXVoQI0mc6YoD+O4Y3kOJtmQXdouY2QuxDAUYkSOOf3WzutURzLLA3616iQQv8eB0HJ80wYng==","signatures":[{"sig":"MEQCIAbP66wkHtjTqMhtpjus+nE7a5t4V9kZ1jZLfE6gWUnXAiAOYaM6ty4i/SNNLX9xrX9rXqeT/RPWI869DGocIaMczA==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":2563},"main":"./src/utils.js","type":"module","types":"./src/utils.d.ts","exports":{".":"./src/utils.ts"},"gitHead":"7b71b813ef3acbe5b1086ed04db9c6ba8ffb77b3","private":false,"scripts":{"test":"NODE_ENV=test vitest","build":"tsc -p ./tsconfig.json"},"_npmUser":{"name":"blossomlib","email":"kind.salt4683@fastmail.com"},"_npmVersion":"9.5.0","directories":{},"_nodeVersion":"18.15.0","dependencies":{"lodash-es":"^4.17.21"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^8.41.0","vitest":"^0.31.4","prettier":"^2.8.8","typescript":"^5.1.3","typescript-eslint":"^0.0.1-alpha.0","eslint-config-prettier":"^8.8.0","eslint-config-standard":"^17.1.0","@typescript-eslint/parser":"^5.59.8","@typescript-eslint/eslint-plugin":"^5.59.8"},"_npmOperationalInternal":{"tmp":"tmp/utils_0.0.2_1691080783391_0.08963641598366956","host":"s3://npm-registry-packages"}},"0.0.3":{"name":"@data-prism/utils","version":"0.0.3","keywords":[],"author":{"name":"Jake Sower"},"_id":"@data-prism/utils@0.0.3","maintainers":[{"name":"blossomlib","email":"kind.salt4683@fastmail.com"}],"dist":{"shasum":"6d2aef08cd4fd406bb12019ae1e7e7259f8be9e2","tarball":"https://registry.npmjs.org/@data-prism/utils/-/utils-0.0.3.tgz","fileCount":11,"integrity":"sha512-0we6jN4hWez9afWoTAiOQrNDYoNuHEGpbOt9gHSHY5rurhe8Ug64kSDedkrBejXuvyLBFqrLJrhhql2PlkoW7g==","signatures":[{"sig":"MEQCIF0qKspWeRdfoS4NY3Ff5LGIzXEVi7f0GSYhBT82L9f9AiALB7qi+r/5DFDJ0F7RoGudc3eGss1NFtW6WpNuRkN8Og==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":79191},"main":"./src/utils.js","type":"module","types":"./src/utils.d.ts","exports":{".":"./src/utils.ts"},"gitHead":"7b71b813ef3acbe5b1086ed04db9c6ba8ffb77b3","private":false,"scripts":{"test":"NODE_ENV=test vitest","build":"tsc -p ./tsconfig.json"},"_npmUser":{"name":"blossomlib","email":"kind.salt4683@fastmail.com"},"_npmVersion":"9.5.0","directories":{},"_nodeVersion":"18.15.0","dependencies":{"lodash-es":"^4.17.21"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^8.41.0","vitest":"^0.31.4","prettier":"^2.8.8","typescript":"^5.1.3","typescript-eslint":"^0.0.1-alpha.0","eslint-config-prettier":"^8.8.0","eslint-config-standard":"^17.1.0","@typescript-eslint/parser":"^5.59.8","@typescript-eslint/eslint-plugin":"^5.59.8"},"_npmOperationalInternal":{"tmp":"tmp/utils_0.0.3_1691080993760_0.2726450257417561","host":"s3://npm-registry-packages"}},"0.0.4":{"name":"@data-prism/utils","version":"0.0.4","keywords":[],"author":{"name":"Jake Sower"},"_id":"@data-prism/utils@0.0.4","maintainers":[{"name":"blossomlib","email":"kind.salt4683@fastmail.com"}],"dist":{"shasum":"52623ce9e0d9a3d927fa389a2f79e513720506a7","tarball":"https://registry.npmjs.org/@data-prism/utils/-/utils-0.0.4.tgz","fileCount":11,"integrity":"sha512-JSzgqmuItOFwiRCBrWOwgB9I0ZXowwVrGcih+DYi+jjzR14V5FilWs2xvvD7FeNGOYGcAPPYWgJtGvU5+8JE9w==","signatures":[{"sig":"MEUCIQCv0YZBzR+ACwdMDWFK0I5o8kfRHMs5SQ2IQ90j2SxzCQIgdfZel1mSYzRjlqs+saaPHS+pXB7BkQFLgvtX5ajeb8k=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":79800},"main":"./src/utils.js","type":"module","types":"./src/utils.d.ts","exports":{".":"./src/utils.ts"},"gitHead":"917ecf96529e65809c5bcc2c71330dc554b26637","private":false,"scripts":{"test":"NODE_ENV=test vitest","build":"tsc -p ./tsconfig.json"},"_npmUser":{"name":"blossomlib","email":"kind.salt4683@fastmail.com"},"_npmVersion":"9.8.1","directories":{},"_nodeVersion":"18.15.0","dependencies":{"lodash-es":"^4.17.21"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^8.41.0","vitest":"^0.31.4","prettier":"^2.8.8","typescript":"^5.1.3","typescript-eslint":"^0.0.1-alpha.0","eslint-config-prettier":"^8.8.0","eslint-config-standard":"^17.1.0","@typescript-eslint/parser":"^5.59.8","@typescript-eslint/eslint-plugin":"^5.59.8"},"_npmOperationalInternal":{"tmp":"tmp/utils_0.0.4_1693509410943_0.6317918229911601","host":"s3://npm-registry-packages"}},"0.0.5":{"name":"@data-prism/utils","version":"0.0.5","keywords":[],"author":{"name":"Jake Sower"},"_id":"@data-prism/utils@0.0.5","maintainers":[{"name":"blossomlib","email":"kind.salt4683@fastmail.com"}],"dist":{"shasum":"ea5bbe64c55b79dec6cffdb9755c2762000d2b1f","tarball":"https://registry.npmjs.org/@data-prism/utils/-/utils-0.0.5.tgz","fileCount":11,"integrity":"sha512-sQ0n3Of7ECTaeDNeOxgVm1iyrOTCnI5wP4W9Y/IP6mDXbNuEcOphg55XA5PLSEvglq7opG1sFCFdXlZS7rSVOQ==","signatures":[{"sig":"MEQCIE8ZahSCWvW8HIVVmPR9HZbr8df1D0N6GvZykLXYH/p+AiAMk7Msgfb7Gg6RXMY/9JipGT7VhLsVWrXweQAKGeIeFw==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":79819},"main":"./src/utils.js","type":"module","types":"./src/utils.d.ts","exports":{".":"./dist/utils.js"},"gitHead":"7385728384ce084b1ca5de1c8c1f4dfd3c4ec74a","private":false,"scripts":{"test":"NODE_ENV=test vitest","build":"tsc -p ./tsconfig.json"},"_npmUser":{"name":"blossomlib","email":"kind.salt4683@fastmail.com"},"_npmVersion":"9.8.1","directories":{},"_nodeVersion":"18.15.0","dependencies":{"lodash-es":"^4.17.21"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^8.41.0","vitest":"^0.31.4","prettier":"^2.8.8","typescript":"^5.1.3","typescript-eslint":"^0.0.1-alpha.0","eslint-config-prettier":"^8.8.0","eslint-config-standard":"^17.1.0","@typescript-eslint/parser":"^5.59.8","@typescript-eslint/eslint-plugin":"^5.59.8"},"_npmOperationalInternal":{"tmp":"tmp/utils_0.0.5_1697130670177_0.15947672245084954","host":"s3://npm-registry-packages"}},"0.0.6":{"name":"@data-prism/utils","version":"0.0.6","keywords":[],"author":{"name":"Jake Sower"},"_id":"@data-prism/utils@0.0.6","maintainers":[{"name":"blossomlib","email":"kind.salt4683@fastmail.com"}],"dist":{"shasum":"56434a5c553527b86e773b35d707eac3152b41d5","tarball":"https://registry.npmjs.org/@data-prism/utils/-/utils-0.0.6.tgz","fileCount":11,"integrity":"sha512-3TZHJ0F24KGAzIBhbkR1iIGI7dgQprUcISIVAEGfA5hj6LKiOhCX+YejmOprwaysyNe/Apb5X2JqI8NGIzsK2w==","signatures":[{"sig":"MEYCIQC9kuwEAIOMUvlxb9ExjAnyS7TpkfL9tG8lVVLyUcewBgIhAK9rl6VdBQdhhUyv1YZ/41u4VsPDvywAgVV9zC1kXJg+","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":79819},"main":"./src/utils.js","type":"module","types":"./src/utils.d.ts","exports":{".":"./dist/utils.js"},"gitHead":"7385728384ce084b1ca5de1c8c1f4dfd3c4ec74a","private":false,"scripts":{"test":"NODE_ENV=test vitest","build":"tsc -p ./tsconfig.json"},"_npmUser":{"name":"blossomlib","email":"kind.salt4683@fastmail.com"},"_npmVersion":"9.8.1","directories":{},"_nodeVersion":"18.15.0","dependencies":{"lodash-es":"^4.17.21"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^8.41.0","vitest":"^0.31.4","prettier":"^2.8.8","typescript":"^5.1.3","typescript-eslint":"^0.0.1-alpha.0","eslint-config-prettier":"^8.8.0","eslint-config-standard":"^17.1.0","@typescript-eslint/parser":"^5.59.8","@typescript-eslint/eslint-plugin":"^5.59.8"},"_npmOperationalInternal":{"tmp":"tmp/utils_0.0.6_1697131007516_0.8169246958142347","host":"s3://npm-registry-packages"}},"0.1.0":{"name":"@data-prism/utils","version":"0.1.0","keywords":[],"author":{"name":"Jake Sower"},"_id":"@data-prism/utils@0.1.0","maintainers":[{"name":"blossomlib","email":"kind.salt4683@fastmail.com"}],"dist":{"shasum":"038ef8ad28b3708685c88f3354a954e3c43b042c","tarball":"https://registry.npmjs.org/@data-prism/utils/-/utils-0.1.0.tgz","fileCount":13,"integrity":"sha512-KO3bUcBm5uC8ROpGvJ2TBWsT44kKtDSoKZbgc0rfuyf9IX+axhW5o3H5hjbY257TrOsm4TNTu+fO4rSqr+1PCQ==","signatures":[{"sig":"MEYCIQCQGF2QMbduiiAMCRFh3yOrf+AQFdiQYdEm8/cf7u9gdwIhAPF9O+Pk6m/hWT7Sg5drOHeOygiO+wSukL8Y+mNrluK9","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":82609},"main":"./build/cjs/src/index.js","type":"module","types":"./build/cjs/src/index.d.ts","module":"./build/mjs/src/index.js","exports":{"import":"./build/esm/src/index.js","require":"./build/cjs/src/index.js"},"gitHead":"0fdff3d84050afbd09cb406aa6ecd60c0f08d077","private":false,"scripts":{"test":"NODE_ENV=test vitest","build":"tsc -p ./tsconfig.json"},"_npmUser":{"name":"blossomlib","email":"kind.salt4683@fastmail.com"},"_npmVersion":"9.8.1","directories":{},"_nodeVersion":"18.15.0","dependencies":{"lodash-es":"^4.17.21"},"publishConfig":{"access":"public","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}}},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^8.54.0","vitest":"^0.34.6","prettier":"^3.1.0","typescript":"^5.3.2","typescript-eslint":"^0.0.1-alpha.0","eslint-config-prettier":"^9.0.0","eslint-config-standard":"^17.1.0","@typescript-eslint/parser":"^6.13.0","@typescript-eslint/eslint-plugin":"^6.13.0"},"_npmOperationalInternal":{"tmp":"tmp/utils_0.1.0_1701192730650_0.5451355358358638","host":"s3://npm-registry-packages"}},"0.0.7":{"name":"@data-prism/utils","version":"0.0.7","keywords":[],"author":{"name":"Jake Sower"},"_id":"@data-prism/utils@0.0.7","maintainers":[{"name":"blossomlib","email":"kind.salt4683@fastmail.com"}],"dist":{"shasum":"8afb9a79d1d0ce8167102d3db01190b05d838694","tarball":"https://registry.npmjs.org/@data-prism/utils/-/utils-0.0.7.tgz","fileCount":4,"integrity":"sha512-Xi2oqernhzD/jxgOXk688r0kth+TLtPRNgVJSBxTZpjAyUQP6IYDclZ15TLbHmk8wMDMAb4cvl523CddsEp8uw==","signatures":[{"sig":"MEQCIFLY6BSnzj6sNOvInsWT0qU7LT7OR9DK05HCD/+DC+FXAiB7WkYoO8gcnlaqQoG6voAhY+HHsDkwzXturV2UdFlo3w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":7568},"main":"./dist/index.cjs.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.esm.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.esm.js","require":"./dist/index.cjs.js"}},"gitHead":"b996596e1fad67a85585166ba1344dc8e8bba75e","private":false,"scripts":{"lint":"eslint src/ test/","test":"NODE_ENV=test vitest run --coverage","build":"npm run clean && rollup -c && cp index.d.ts dist/","clean":"rm -rf dist","test:watch":"vitest","prepublishOnly":"npm run lint && npm run test"},"_npmUser":{"name":"blossomlib","email":"kind.salt4683@fastmail.com"},"_npmVersion":"11.4.2","directories":{},"sideEffects":false,"_nodeVersion":"23.6.0","dependencies":{},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"rollup":"^4.28.1","vitest":"^3.2.4","@vitest/coverage-v8":"^3.2.4","@rollup/plugin-commonjs":"^28.0.1","@rollup/plugin-node-resolve":"^16.0.0"},"_npmOperationalInternal":{"tmp":"tmp/utils_0.0.7_1755634017226_0.40271024415928225","host":"s3://npm-registry-packages-npm-production"}},"0.0.8":{"name":"@data-prism/utils","version":"0.0.8","deprecated":"This package has been renamed to '@spectragraph/utils'. Please use '@spectragraph/utils' instead.","type":"module","main":"./dist/index.cjs.js","module":"./dist/index.esm.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.esm.js","require":"./dist/index.cjs.js"}},"scripts":{"build":"npm run clean && rollup -c && cp index.d.ts dist/","clean":"rm -rf dist","format:check":"prettier --check \"src/**/*.{js,jsx,ts,tsx,json,css,md}\"","format:fix":"prettier --write \"src/**/*.{js,jsx,ts,tsx,json,css,md}\"","lint":"eslint src/ test/","lint:fix":"eslint --fix src/ test/","prepublishOnly":"npm run lint && npm run test","test":"NODE_ENV=test vitest run --coverage","test:watch":"vitest"},"keywords":[],"author":{"name":"Jake Sower"},"devDependencies":{"@rollup/plugin-commonjs":"^28.0.1","@rollup/plugin-node-resolve":"^16.0.0","@vitest/coverage-v8":"^3.2.4","rollup":"^4.28.1","vitest":"^3.2.4"},"publishConfig":{"access":"public"},"private":false,"sideEffects":false,"dependencies":{},"_id":"@data-prism/utils@0.0.8","gitHead":"d90da54a8b4c84ca0cde531e924f44836e9be871","description":"Common utility functions used across the Data Prism ecosystem. This package provides lightweight helper functions for functional programming patterns, data transformation, and common operations that are shared between Data Prism packages.","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-aoiAokA9UCNABjSB9zJ9BPKfiM2cYjTe4/jLexvs079HnT0YgeL2JbgyHesU4KPHRxDrEP/JZ9aL1sV9N3miww==","shasum":"d6e1f3767fb34f5128615aab958562a30f2f9fda","tarball":"https://registry.npmjs.org/@data-prism/utils/-/utils-0.0.8.tgz","fileCount":5,"unpackedSize":17665,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFLMKKA1ot5ZZKhvMWP7XvFAjx2rntNSRio04o5oWuhOAiEA696u53nFariE0itwyDE8DHu9vBXW3ZIZPcCZdtZw+go="}]},"_npmUser":{"name":"blossomlib","email":"kind.salt4683@fastmail.com"},"directories":{},"maintainers":[{"name":"blossomlib","email":"kind.salt4683@fastmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/utils_0.0.8_1757801632545_0.4249267569326125"},"_hasShrinkwrap":false}},"time":{"created":"2023-05-23T15:24:58.081Z","modified":"2025-09-13T22:13:52.991Z","0.0.1":"2023-05-23T15:24:58.331Z","0.0.2":"2023-08-03T16:39:43.562Z","0.0.3":"2023-08-03T16:43:14.009Z","0.0.4":"2023-08-31T19:16:51.107Z","0.0.5":"2023-10-12T17:11:10.414Z","0.0.6":"2023-10-12T17:16:47.852Z","0.1.0":"2023-11-28T17:32:10.838Z","0.0.7":"2025-08-19T20:06:57.440Z","0.0.8":"2025-09-13T22:13:52.754Z"},"author":{"name":"Jake Sower"},"keywords":[],"maintainers":[{"name":"blossomlib","email":"kind.salt4683@fastmail.com"}],"readme":"# Data Prism Utils\n\nCommon utility functions used across the Data Prism ecosystem. This package provides lightweight helper functions for functional programming patterns, data transformation, and common operations that are shared between Data Prism packages.\n\n## Overview\n\nData Prism Utils is built around several key principles:\n\n- **Functional**: Pure functions with predictable behavior and no side effects\n- **Type-safe**: Comprehensive TypeScript support with generic type definitions\n- **Null-safe**: Graceful handling of null and undefined values\n- **Minimal**: Small, focused utilities without external dependencies\n\n## Installation\n\n```bash\nnpm install @data-prism/utils\n```\n\n## Core Concepts\n\n### Utility Functions\n\nThe package provides utility functions that handle common patterns in data processing:\n\n- **Mapping**: Apply functions to single items or arrays uniformly\n- **Piping**: Chain operations together in a functional style\n- **Null handling**: Safe operations that gracefully handle null/undefined values\n\n## API Reference\n\n### `applyOrMap(itemItemsOrNull, fn)`\n\nApplies a function to an item or maps it over an array of items. Handles null and undefined gracefully by returning them unchanged.\n\n**Parameters:**\n\n- `itemItemsOrNull` (T | T[] | null | undefined) - Single item, array of items, or null/undefined\n- `fn` (Function) - Function to apply to each item\n\n**Returns:** Result of applying fn to the item(s), or null/undefined if input was null/undefined\n\n```javascript\nimport { applyOrMap } from \"@data-prism/utils\";\n\n// Single item\napplyOrMap(5, x => x * 2);           // Returns: 10\n\n// Array of items  \napplyOrMap([1, 2, 3], x => x * 2);   // Returns: [2, 4, 6]\n\n// Null/undefined handling\napplyOrMap(null, x => x * 2);        // Returns: null\napplyOrMap(undefined, x => x * 2);   // Returns: undefined\n```\n\n### `applyOrMapAsync(itemItemsOrNull, asyncFn)`\n\nApplies an async function to an item or maps it over an array of items. Handles null and undefined gracefully.\n\n**Parameters:**\n\n- `itemItemsOrNull` (T | T[] | null | undefined) - Single item, array of items, or null/undefined  \n- `asyncFn` (Function) - Async function to apply to each item\n\n**Returns:** Promise resolving to the result of applying asyncFn to the item(s), or null/undefined if input was null/undefined\n\n```javascript\nimport { applyOrMapAsync } from \"@data-prism/utils\";\n\n// Single item\nawait applyOrMapAsync(5, async x => x * 2);           // Returns: 10\n\n// Array of items\nawait applyOrMapAsync([1, 2, 3], async x => x * 2);   // Returns: [2, 4, 6]\n\n// Null/undefined handling\napplyOrMapAsync(null, async x => x * 2);              // Returns: null\napplyOrMapAsync(undefined, async x => x * 2);         // Returns: undefined\n```\n\n### `pipeThru(init, fns)`\n\nPipes a value through a series of functions in sequence. Each function receives the result of the previous function.\n\n**Parameters:**\n\n- `init` (T) - Initial value to pipe through the functions\n- `fns` (Function[]) - Array of functions to pipe the value through\n\n**Returns:** The result after applying all functions in sequence\n\n```javascript\nimport { pipeThru } from \"@data-prism/utils\";\n\nconst add5 = x => x + 5;\nconst multiply2 = x => x * 2;\nconst toString = x => x.toString();\n\npipeThru(10, [add5, multiply2, toString]); // Returns: \"30\"\n```\n\n## Examples\n\n### Data Transformation\n\n```javascript\nimport { applyOrMap, pipeThru } from \"@data-prism/utils\";\n\n// Transform data that might be a single item or array\nconst data = [{ name: \"John\" }, { name: \"Jane\" }];\n\nconst addGreeting = person => ({ ...person, greeting: `Hello, ${person.name}` });\nconst toUpperCase = person => ({ ...person, name: person.name.toUpperCase() });\n\nconst result = applyOrMap(data, person => \n  pipeThru(person, [addGreeting, toUpperCase])\n);\n\nconsole.log(result);\n// [\n//   { name: \"JOHN\", greeting: \"Hello, John\" },\n//   { name: \"JANE\", greeting: \"Hello, Jane\" }\n// ]\n```\n\n### Async Data Processing\n\n```javascript\nimport { applyOrMapAsync } from \"@data-prism/utils\";\n\nasync function fetchUserDetails(userId) {\n  const response = await fetch(`/api/users/${userId}`);\n  return response.json();\n}\n\n// Works with both single IDs and arrays of IDs\nconst userIds = [\"user-1\", \"user-2\", \"user-3\"];\nconst userDetails = await applyOrMapAsync(userIds, fetchUserDetails);\n\n// Also works with a single ID\nconst singleUser = await applyOrMapAsync(\"user-1\", fetchUserDetails);\n```\n\n### Pipeline Processing\n\n```javascript\nimport { pipeThru } from \"@data-prism/utils\";\n\n// Define transformation steps\nconst parseJson = str => JSON.parse(str);\nconst extractUsers = data => data.users;\nconst filterActive = users => users.filter(u => u.active);\nconst sortByName = users => users.sort((a, b) => a.name.localeCompare(b.name));\n\n// Process data through the pipeline\nconst rawData = '{\"users\": [{\"name\": \"Bob\", \"active\": true}, {\"name\": \"Alice\", \"active\": false}]}';\n\nconst result = pipeThru(rawData, [\n  parseJson,\n  extractUsers,\n  filterActive,\n  sortByName\n]);\n\nconsole.log(result); // [{ name: \"Bob\", active: true }]\n```\n\n### Null-Safe Operations\n\n```javascript\nimport { applyOrMap } from \"@data-prism/utils\";\n\n// Safely handle potentially null/undefined data\nfunction processUserData(userData) {\n  return applyOrMap(userData, user => ({\n    ...user,\n    displayName: user.firstName + \" \" + user.lastName\n  }));\n}\n\nprocessUserData(null);        // Returns: null\nprocessUserData(undefined);   // Returns: undefined\nprocessUserData(user);        // Returns: processed user\nprocessUserData([user1, user2]); // Returns: [processed user1, processed user2]\n```\n\n### Resource Processing in Data Prism\n\n```javascript\nimport { applyOrMap, pipeThru } from \"@data-prism/utils\";\n\n// Common pattern in Data Prism packages\nfunction normalizeResources(resources) {\n  const addType = resource => ({ ...resource, type: resource.type || \"unknown\" });\n  const addId = resource => ({ ...resource, id: resource.id || generateId() });\n  const validateRequired = resource => {\n    if (!resource.attributes) throw new Error(\"Missing attributes\");\n    return resource;\n  };\n\n  return applyOrMap(resources, resource =>\n    pipeThru(resource, [addType, addId, validateRequired])\n  );\n}\n\n// Works with single resources or arrays\nconst singleResource = { attributes: { name: \"Test\" } };\nconst multipleResources = [\n  { attributes: { name: \"Test 1\" } },\n  { attributes: { name: \"Test 2\" } }\n];\n\nconst normalizedSingle = normalizeResources(singleResource);\nconst normalizedMultiple = normalizeResources(multipleResources);\n```\n\n## TypeScript Support\n\nData Prism Utils includes comprehensive TypeScript definitions:\n\n```typescript\nimport { applyOrMap, applyOrMapAsync, pipeThru } from \"@data-prism/utils\";\n\n// Type-safe transformations\nconst numbers: number[] = [1, 2, 3];\nconst doubled: number[] = applyOrMap(numbers, x => x * 2);\n\n// Async operations\nconst asyncResult: Promise<string[]> = applyOrMapAsync(\n  [\"a\", \"b\", \"c\"], \n  async (str: string): Promise<string> => str.toUpperCase()\n);\n\n// Pipeline with type inference\nconst result: string = pipeThru(\n  42,\n  [\n    (x: number) => x * 2,      // number -> number\n    (x: number) => x.toString(), // number -> string\n    (x: string) => x.padStart(4, '0') // string -> string\n  ]\n);\n```\n\n## Performance Considerations\n\n### Functional Programming Benefits\n\n- **Immutability**: Functions don't modify input data, reducing bugs\n- **Composability**: Small functions can be combined in different ways\n- **Testability**: Pure functions are easy to test in isolation\n- **Predictability**: Same inputs always produce same outputs\n\n### Memory Efficiency\n\n- **No dependencies**: Minimal memory footprint\n- **Small functions**: Only include what you need\n- **Lazy evaluation**: Operations are only performed when needed\n\n### Usage Patterns\n\n```javascript\n// Efficient: Process in pipelines\nconst result = pipeThru(data, [transform1, transform2, transform3]);\n\n// Less efficient: Multiple intermediate variables\nconst step1 = transform1(data);\nconst step2 = transform2(step1);\nconst step3 = transform3(step2);\n```\n\n## Related Packages\n\n- `@data-prism/core` - Uses utils for resource and query processing\n- `@data-prism/memory-store` - Uses utils for data transformations\n- `@data-prism/postgres-store` - Uses utils for SQL query building\n","readmeFilename":"README.md","description":"Common utility functions used across the Data Prism ecosystem. This package provides lightweight helper functions for functional programming patterns, data transformation, and common operations that are shared between Data Prism packages."}