@memberjunction/global 2.63.1 → 2.65.0

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from './ObjectCache';
 export * from './BaseSingleton';
 export * from './DeepDiff';
 export * from './ClassUtils';
+export * from './util/PatternUtils';
 export * from './Global';
 export * from './RegisterClass';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChE,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAG5B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChE,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA"}

package/dist/index.js

@@ -25,6 +25,7 @@ __exportStar(require("./ObjectCache"), exports);
 __exportStar(require("./BaseSingleton"), exports);
 __exportStar(require("./DeepDiff"), exports);
 __exportStar(require("./ClassUtils"), exports);
+__exportStar(require("./util/PatternUtils"), exports);
 // Export the main classes
 __exportStar(require("./Global"), exports);
 __exportStar(require("./RegisterClass"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iCAAiC;AACjC,+CAAgE;AAAvD,4GAAA,YAAY,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AACxC,8CAA2B;AAC3B,yCAAsB;AACtB,gDAA6B;AAC7B,kDAA+B;AAC/B,6CAA0B;AAC1B,+CAA4B;AAE5B,0BAA0B;AAC1B,2CAAwB;AACxB,kDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iCAAiC;AACjC,+CAAgE;AAAvD,4GAAA,YAAY,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AACxC,8CAA2B;AAC3B,yCAAsB;AACtB,gDAA6B;AAC7B,kDAA+B;AAC/B,6CAA0B;AAC1B,+CAA4B;AAC5B,sDAAoC;AAEpC,0BAA0B;AAC1B,2CAAwB;AACxB,kDAA+B"}

package/dist/util/PatternUtils.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview Pattern matching utility functions for MemberJunction
+ *
+ * This module provides functions for converting string patterns to RegExp objects,
+ * supporting both simple wildcard patterns and full regex syntax.
+ * Works in both Node.js and browser environments.
+ *
+ * @module @memberjunction/global/PatternUtils
+ */
+/**
+ * Converts a string pattern to a RegExp object.
+ * Supports both regex strings and simple wildcard patterns.
+ *
+ * @param pattern - The pattern string to convert
+ * @returns A RegExp object
+ *
+ * @example
+ * // Regex pattern (starts with /)
+ * parsePattern("/spCreate.*Run/i") // Returns: /spCreate.*Run/i
+ *
+ * // Simple wildcard patterns
+ * parsePattern("*AIPrompt*") // Returns: /AIPrompt/i
+ * parsePattern("spCreate*") // Returns: /^spCreate/i
+ * parsePattern("*Run") // Returns: /Run$/i
+ * parsePattern("exact") // Returns: /^exact$/i
+ */
+export declare function parsePattern(pattern: string): RegExp;
+/**
+ * Converts an array of string patterns to RegExp objects
+ *
+ * @param patterns - Array of pattern strings
+ * @returns Array of RegExp objects
+ */
+export declare function parsePatterns(patterns: string[]): RegExp[];
+/**
+ * Converts a pattern (string or RegExp) to a RegExp object
+ *
+ * @param pattern - String pattern or RegExp object
+ * @returns RegExp object
+ */
+export declare function ensureRegExp(pattern: string | RegExp): RegExp;
+/**
+ * Converts an array of patterns (strings or RegExps) to RegExp objects
+ *
+ * @param patterns - Array of string patterns or RegExp objects
+ * @returns Array of RegExp objects
+ */
+export declare function ensureRegExps(patterns: (string | RegExp)[]): RegExp[];
+/**
+ * Tests if a string matches any of the provided patterns
+ *
+ * @param text - The text to test
+ * @param patterns - Array of patterns (strings or RegExps)
+ * @returns true if any pattern matches
+ */
+export declare function matchesAnyPattern(text: string, patterns: (string | RegExp)[]): boolean;
+/**
+ * Tests if a string matches all of the provided patterns
+ *
+ * @param text - The text to test
+ * @param patterns - Array of patterns (strings or RegExps)
+ * @returns true if all patterns match
+ */
+export declare function matchesAllPatterns(text: string, patterns: (string | RegExp)[]): boolean;
+//# sourceMappingURL=PatternUtils.d.ts.map

package/dist/util/PatternUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PatternUtils.d.ts","sourceRoot":"","sources":["../../src/util/PatternUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsCpD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAGtF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAGvF"}

package/dist/util/PatternUtils.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * @fileoverview Pattern matching utility functions for MemberJunction
+ *
+ * This module provides functions for converting string patterns to RegExp objects,
+ * supporting both simple wildcard patterns and full regex syntax.
+ * Works in both Node.js and browser environments.
+ *
+ * @module @memberjunction/global/PatternUtils
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchesAllPatterns = exports.matchesAnyPattern = exports.ensureRegExps = exports.ensureRegExp = exports.parsePatterns = exports.parsePattern = void 0;
+/**
+ * Converts a string pattern to a RegExp object.
+ * Supports both regex strings and simple wildcard patterns.
+ *
+ * @param pattern - The pattern string to convert
+ * @returns A RegExp object
+ *
+ * @example
+ * // Regex pattern (starts with /)
+ * parsePattern("/spCreate.*Run/i") // Returns: /spCreate.*Run/i
+ *
+ * // Simple wildcard patterns
+ * parsePattern("*AIPrompt*") // Returns: /AIPrompt/i
+ * parsePattern("spCreate*") // Returns: /^spCreate/i
+ * parsePattern("*Run") // Returns: /Run$/i
+ * parsePattern("exact") // Returns: /^exact$/i
+ */
+function parsePattern(pattern) {
+    // Check if it's already a regex pattern (starts with /)
+    if (pattern.startsWith('/')) {
+        // Extract pattern and flags from regex string like "/pattern/flags"
+        const lastSlash = pattern.lastIndexOf('/');
+        if (lastSlash > 0) {
+            const regexPattern = pattern.slice(1, lastSlash);
+            const flags = pattern.slice(lastSlash + 1);
+            return new RegExp(regexPattern, flags);
+        }
+        // If no closing slash, treat as literal pattern
+        return new RegExp(pattern.slice(1), 'i');
+    }
+    // Convert simple wildcard pattern to regex
+    // Escape special regex characters except for *
+    let regexPattern = pattern.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
+    // Handle wildcards
+    const hasLeadingWildcard = pattern.startsWith('*');
+    const hasTrailingWildcard = pattern.endsWith('*');
+    // Remove wildcards for processing
+    regexPattern = regexPattern.replace(/^\*/, '').replace(/\*$/, '');
+    // Replace internal wildcards with .*
+    regexPattern = regexPattern.replace(/\*/g, '.*');
+    // Add anchors based on wildcards
+    if (!hasLeadingWildcard) {
+        regexPattern = '^' + regexPattern;
+    }
+    if (!hasTrailingWildcard) {
+        regexPattern = regexPattern + '$';
+    }
+    // Simple patterns are case-insensitive by default
+    return new RegExp(regexPattern, 'i');
+}
+exports.parsePattern = parsePattern;
+/**
+ * Converts an array of string patterns to RegExp objects
+ *
+ * @param patterns - Array of pattern strings
+ * @returns Array of RegExp objects
+ */
+function parsePatterns(patterns) {
+    return patterns.map(parsePattern);
+}
+exports.parsePatterns = parsePatterns;
+/**
+ * Converts a pattern (string or RegExp) to a RegExp object
+ *
+ * @param pattern - String pattern or RegExp object
+ * @returns RegExp object
+ */
+function ensureRegExp(pattern) {
+    return pattern instanceof RegExp ? pattern : parsePattern(pattern);
+}
+exports.ensureRegExp = ensureRegExp;
+/**
+ * Converts an array of patterns (strings or RegExps) to RegExp objects
+ *
+ * @param patterns - Array of string patterns or RegExp objects
+ * @returns Array of RegExp objects
+ */
+function ensureRegExps(patterns) {
+    return patterns.map(ensureRegExp);
+}
+exports.ensureRegExps = ensureRegExps;
+/**
+ * Tests if a string matches any of the provided patterns
+ *
+ * @param text - The text to test
+ * @param patterns - Array of patterns (strings or RegExps)
+ * @returns true if any pattern matches
+ */
+function matchesAnyPattern(text, patterns) {
+    const regexps = ensureRegExps(patterns);
+    return regexps.some(pattern => pattern.test(text));
+}
+exports.matchesAnyPattern = matchesAnyPattern;
+/**
+ * Tests if a string matches all of the provided patterns
+ *
+ * @param text - The text to test
+ * @param patterns - Array of patterns (strings or RegExps)
+ * @returns true if all patterns match
+ */
+function matchesAllPatterns(text, patterns) {
+    const regexps = ensureRegExps(patterns);
+    return regexps.every(pattern => pattern.test(text));
+}
+exports.matchesAllPatterns = matchesAllPatterns;
+//# sourceMappingURL=PatternUtils.js.map

package/dist/util/PatternUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PatternUtils.js","sourceRoot":"","sources":["../../src/util/PatternUtils.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,YAAY,CAAC,OAAe;IAC1C,wDAAwD;IACxD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,oEAAoE;QACpE,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;YAC3C,OAAO,IAAI,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;QACD,gDAAgD;QAChD,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED,2CAA2C;IAC3C,+CAA+C;IAC/C,IAAI,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IAEjE,mBAAmB;IACnB,MAAM,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAElD,kCAAkC;IAClC,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAElE,qCAAqC;IACrC,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAEjD,iCAAiC;IACjC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,YAAY,GAAG,GAAG,GAAG,YAAY,CAAC;IACpC,CAAC;IACD,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,YAAY,GAAG,YAAY,GAAG,GAAG,CAAC;IACpC,CAAC;IAED,kDAAkD;IAClD,OAAO,IAAI,MAAM,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC;AAtCD,oCAsCC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,QAAkB;IAC9C,OAAO,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAFD,sCAEC;AAED;;;;;GAKG;AACH,SAAgB,YAAY,CAAC,OAAwB;IACnD,OAAO,OAAO,YAAY,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;AACrE,CAAC;AAFD,oCAEC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,QAA6B;IACzD,OAAO,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAFD,sCAEC;AAED;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,IAAY,EAAE,QAA6B;IAC3E,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACrD,CAAC;AAHD,8CAGC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,IAAY,EAAE,QAA6B;IAC5E,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACtD,CAAC;AAHD,gDAGC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/global",
-  "version": "2.63.1",
+  "version": "2.65.0",
   "description": "MemberJunction: Global Object - Needed for ALL other MJ components",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/readme.md

@@ -18,7 +18,7 @@ The `@memberjunction/global` library serves as the foundation for cross-componen
 - **Object Caching** - In-memory object cache for application lifetime
 - **Class Reflection Utilities** - Runtime class hierarchy inspection and analysis
 - **Deep Diff Engine** - Comprehensive object comparison and change tracking
-- **Utility Functions** - Common string manipulation, JSON parsing (including recursive nested JSON parsing), and formatting utilities
+- **Utility Functions** - Common string manipulation, JSON parsing (including recursive nested JSON parsing), pattern matching, and formatting utilities
 
 ## Core Components
 
@@ -359,6 +359,92 @@ const html = ConvertMarkdownStringToHtmlList('Unordered', '- Item 1\n- Item 2\n-
 // Returns: <ul><li>Item 1</li><li>Item 2</li><li>Item 3</li></ul>
 ```
 
+### Pattern Matching Utilities
+
+Convert string patterns to RegExp objects with support for simple wildcards and full regex syntax:
+
+```typescript
+import { 
+  parsePattern, 
+  parsePatterns, 
+  ensureRegExp, 
+  ensureRegExps,
+  matchesAnyPattern,
+  matchesAllPatterns
+} from '@memberjunction/global';
+
+// Parse simple wildcard patterns
+parsePattern('*AIPrompt*');    // Returns: /AIPrompt/i (case-insensitive)
+parsePattern('spCreate*');     // Returns: /^spCreate/i
+parsePattern('*Run');          // Returns: /Run$/i
+parsePattern('exact');         // Returns: /^exact$/i
+
+// Parse regex string patterns
+parsePattern('/spCreate.*Run/i');        // Returns: /spCreate.*Run/i
+parsePattern('/^SELECT.*FROM.*vw/');     // Returns: /^SELECT.*FROM.*vw/
+parsePattern('/INSERT INTO (Users|Roles)/i'); // Returns: /INSERT INTO (Users|Roles)/i
+
+// Parse multiple patterns at once
+const patterns = parsePatterns([
+  '*User*',              // Simple wildcard
+  '/^EXEC sp_/i',        // Regex string
+  '*EntityFieldValue*'   // Simple wildcard
+]);
+
+// Convert mixed string/RegExp arrays
+const mixed = ['*User*', /^Admin/i, '/DELETE.*WHERE/i'];
+const regexps = ensureRegExps(mixed);  // All converted to RegExp objects
+
+// Test if text matches any pattern
+const sql = 'SELECT * FROM Users WHERE Active = 1';
+matchesAnyPattern(sql, ['*User*', '*Role*', '/^UPDATE/i']);  // true
+
+// Test if text matches all patterns
+const filename = 'UserRoleManager.ts';
+matchesAllPatterns(filename, ['*User*', '*Role*', '*.ts']);  // true
+```
+
+#### Pattern Syntax
+
+**Simple Wildcard Patterns** (Recommended for most users):
+- `*` acts as a wildcard matching any characters
+- Case-insensitive by default
+- Examples:
+  - `*pattern*` - Contains "pattern" anywhere
+  - `pattern*` - Starts with "pattern"
+  - `*pattern` - Ends with "pattern"
+  - `pattern` - Exact match only
+
+**Regex String Patterns** (For advanced users):
+- Must start with `/` to be recognized as regex
+- Optionally end with flags like `/pattern/i`
+- Full JavaScript regex syntax supported
+- Examples:
+  - `/^start/i` - Case-insensitive start match
+  - `/end$/` - Case-sensitive end match
+  - `/(option1|option2)/` - Match alternatives
+
+#### Common Use Cases
+
+```typescript
+// SQL statement filtering
+const sqlFilters = [
+  '*AIPrompt*',           // Exclude AI prompt operations
+  '/^EXEC sp_/i',         // Exclude system stored procedures
+  '*EntityFieldValue*'    // Exclude field value operations
+];
+
+const shouldLog = !matchesAnyPattern(sqlStatement, sqlFilters);
+
+// File pattern matching
+const includePatterns = ['*.ts', '*.js', '/^(?!test)/'];  // TS/JS files not starting with "test"
+const shouldProcess = matchesAnyPattern(filename, includePatterns);
+
+// User input validation
+const allowedFormats = ['*@*.com', '*@*.org', '*@company.net'];
+const isValidEmail = matchesAnyPattern(email, allowedFormats);
+```
+
 ### Global Object Store
 
 Access the global object store for cross-module state sharing: