@memberjunction/field-rules-transforms 0.0.1 → 5.44.0

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Registers the `jsonpath` and `xpath` transforms into the global FieldTransform registry so any
+ * {@link import('@memberjunction/global').FieldTransformEngine} in the process can run them. Idempotent.
+ *
+ * Importing this package runs it for its side effect, but call it explicitly from a startup/registration
+ * path to keep aggressive bundlers from tree-shaking the import away (the MJ `Load*()` convention).
+ */
+export declare function RegisterFieldRulesTransforms(): void;
+export { jsonPathTransform } from './jsonpath-transform.js';
+export { xPathTransform } from './xpath-transform.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAOnD;AAKD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+import { RegisterFieldTransform } from '@memberjunction/global';
+import { jsonPathTransform } from './jsonpath-transform.js';
+import { xPathTransform } from './xpath-transform.js';
+let registered = false;
+/**
+ * Registers the `jsonpath` and `xpath` transforms into the global FieldTransform registry so any
+ * {@link import('@memberjunction/global').FieldTransformEngine} in the process can run them. Idempotent.
+ *
+ * Importing this package runs it for its side effect, but call it explicitly from a startup/registration
+ * path to keep aggressive bundlers from tree-shaking the import away (the MJ `Load*()` convention).
+ */
+export function RegisterFieldRulesTransforms() {
+    if (registered) {
+        return;
+    }
+    RegisterFieldTransform('jsonpath', jsonPathTransform);
+    RegisterFieldTransform('xpath', xPathTransform);
+    registered = true;
+}
+// Side-effect registration on import.
+RegisterFieldRulesTransforms();
+export { jsonPathTransform } from './jsonpath-transform.js';
+export { xPathTransform } from './xpath-transform.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B;IACxC,IAAI,UAAU,EAAE,CAAC;QACb,OAAO;IACX,CAAC;IACD,sBAAsB,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IACtD,sBAAsB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAChD,UAAU,GAAG,IAAI,CAAC;AACtB,CAAC;AAED,sCAAsC;AACtC,4BAA4B,EAAE,CAAC;AAE/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/jsonpath-transform.d.ts

@@ -0,0 +1,10 @@
+import type { FieldTransformPlugin } from '@memberjunction/global';
+/**
+ * `jsonpath` transform — extracts value(s) from a JSON value via a JSONPath expression.
+ *
+ * The input may be a JSON string (it is `JSON.parse`d) or an already-parsed object/array. By default the
+ * FIRST match is returned (the common "grab one value" case); set `First: false` to get the full array
+ * of matches. Lives here, not in `@memberjunction/global`, because it needs `jsonpath-plus`.
+ */
+export declare const jsonPathTransform: FieldTransformPlugin;
+//# sourceMappingURL=jsonpath-transform.d.ts.map

package/dist/jsonpath-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonpath-transform.d.ts","sourceRoot":"","sources":["../src/jsonpath-transform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAkB,MAAM,wBAAwB,CAAC;AAEnF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,oBAQ/B,CAAC"}

package/dist/jsonpath-transform.js

@@ -0,0 +1,18 @@
+import { JSONPath } from 'jsonpath-plus';
+/**
+ * `jsonpath` transform — extracts value(s) from a JSON value via a JSONPath expression.
+ *
+ * The input may be a JSON string (it is `JSON.parse`d) or an already-parsed object/array. By default the
+ * FIRST match is returned (the common "grab one value" case); set `First: false` to get the full array
+ * of matches. Lives here, not in `@memberjunction/global`, because it needs `jsonpath-plus`.
+ */
+export const jsonPathTransform = (value, _fields, config) => {
+    const c = config;
+    const json = typeof value === 'string' ? JSON.parse(value) : value;
+    const matches = JSONPath({ path: c.Path, json: json, wrap: true });
+    if (c.First === false) {
+        return matches;
+    }
+    return Array.isArray(matches) && matches.length > 0 ? matches[0] : null;
+};
+//# sourceMappingURL=jsonpath-transform.js.map

package/dist/jsonpath-transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonpath-transform.js","sourceRoot":"","sources":["../src/jsonpath-transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;IAC9E,MAAM,CAAC,GAAG,MAAwB,CAAC;IACnC,MAAM,IAAI,GAAY,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5E,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAc,EAAE,IAAI,EAAE,IAAI,EAAE,CAAc,CAAC;IAC1F,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5E,CAAC,CAAC"}

package/dist/xpath-transform.d.ts

@@ -0,0 +1,11 @@
+import type { FieldTransformPlugin } from '@memberjunction/global';
+/**
+ * `xpath` transform — extracts value(s) from an XML string via an XPath expression.
+ *
+ * The input is parsed with `@xmldom/xmldom`. For node-set expressions, each match is reduced to its text
+ * (`nodeValue`/`textContent`); for scalar expressions (e.g. `count(...)`, `.../text()`) the scalar is
+ * returned. By default the FIRST match is returned; set `First: false` to get the full array. Lives here,
+ * not in `@memberjunction/global`, because it needs `xpath` + `@xmldom/xmldom`.
+ */
+export declare const xPathTransform: FieldTransformPlugin;
+//# sourceMappingURL=xpath-transform.d.ts.map

package/dist/xpath-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpath-transform.d.ts","sourceRoot":"","sources":["../src/xpath-transform.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAe,MAAM,wBAAwB,CAAC;AAYhF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,oBAS5B,CAAC"}

package/dist/xpath-transform.js

@@ -0,0 +1,32 @@
+import * as xpath from 'xpath';
+import { DOMParser } from '@xmldom/xmldom';
+/** Coerces an XPath node/result to a scalar value (element/attr text, or the raw scalar). */
+function nodeValue(n) {
+    if (n && typeof n === 'object') {
+        const node = n;
+        if (node.nodeValue != null)
+            return node.nodeValue;
+        if (node.textContent != null)
+            return node.textContent;
+    }
+    return n;
+}
+/**
+ * `xpath` transform — extracts value(s) from an XML string via an XPath expression.
+ *
+ * The input is parsed with `@xmldom/xmldom`. For node-set expressions, each match is reduced to its text
+ * (`nodeValue`/`textContent`); for scalar expressions (e.g. `count(...)`, `.../text()`) the scalar is
+ * returned. By default the FIRST match is returned; set `First: false` to get the full array. Lives here,
+ * not in `@memberjunction/global`, because it needs `xpath` + `@xmldom/xmldom`.
+ */
+export const xPathTransform = (value, _fields, config) => {
+    const c = config;
+    const doc = new DOMParser().parseFromString(String(value ?? ''), 'text/xml');
+    const result = xpath.select(c.Path, doc);
+    if (Array.isArray(result)) {
+        const values = result.map(nodeValue);
+        return c.First === false ? values : (values.length > 0 ? values[0] : null);
+    }
+    return result ?? null; // string / number / boolean (e.g. count(), normalize-space())
+};
+//# sourceMappingURL=xpath-transform.js.map

package/dist/xpath-transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpath-transform.js","sourceRoot":"","sources":["../src/xpath-transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,6FAA6F;AAC7F,SAAS,SAAS,CAAC,CAAU;IACzB,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,CAA+D,CAAC;QAC7E,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC;QAClD,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1D,CAAC;IACD,OAAO,CAAC,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;IAC3E,MAAM,CAAC,GAAG,MAAqB,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,GAAsB,CAAC,CAAC;IAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,OAAO,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,MAAM,IAAI,IAAI,CAAC,CAAC,8DAA8D;AACzF,CAAC,CAAC"}

package/package.json

@@ -1,10 +1,34 @@
 {
   "name": "@memberjunction/field-rules-transforms",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @memberjunction/field-rules-transforms",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+  "type": "module",
+  "version": "5.44.0",
+  "description": "MemberJunction: extended field-rules transform plugins (jsonpath, xpath) that register into the @memberjunction/global FieldTransform registry. Owns the heavier parsing libraries so global stays dependency-light.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "build": "tsc && tsc-alias -f",
+    "watch": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "author": "MemberJunction.com",
+  "license": "ISC",
+  "dependencies": {
+    "@memberjunction/global": "5.44.0",
+    "@xmldom/xmldom": "^0.8.11",
+    "jsonpath-plus": "^10.3.0",
+    "xpath": "^0.0.34"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.11",
+    "typescript": "^5.9.3",
+    "vitest": "^3.1.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/MJ"
+  }
 }

package/README.md

@@ -1,45 +0,0 @@
-# @memberjunction/field-rules-transforms
-
-## ⚠️ IMPORTANT NOTICE ⚠️
-
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@memberjunction/field-rules-transforms`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**