@ztimson/utils 0.27.10 → 0.27.12

package/dist/path-events.d.ts

@@ -29,15 +29,15 @@ export declare function PE(str: TemplateStringsArray, ...args: any[]): PathEvent
  * @param {TemplateStringsArray} str
  * @param {string} args
  * @return {string}
- * @constructor
  */
 export declare function PES(str: TemplateStringsArray, ...args: any[]): string;
 export declare class PathError extends Error {
 }
 /**
- * A  event broken down into its core components for easy processing
- * Event Structure: `module/path/name:property:method`
+ * A event broken down into its core components for easy processing
+ * Event Structure: `module/path/name:method`
  * Example: `users/system:crud` or `storage/some/path/file.txt:r`
+ * Supports glob patterns: `users/*:r` or `storage/**:rw`
  */
 export declare class PathEvent {
     /** First directory in path */
@@ -46,12 +46,18 @@ export declare class PathEvent {
     fullPath: string;
     /** Path including the name, excluding the module */
     path: string;
-    /** Last sagment of path */
+    /** Last segment of path */
     name: string;
     /** List of methods */
     methods: ASet<Method>;
+    /** Whether this path contains glob patterns */
+    hasGlob: boolean;
     /** Internal cache for PathEvent instances to avoid redundant parsing */
     private static pathEventCache;
+    /** Cache for compiled permissions (path + required permissions → result) */
+    private static permissionCache;
+    /** Max size for permission cache before LRU eviction */
+    private static readonly MAX_PERMISSION_CACHE_SIZE;
     /** All/Wildcard specified */
     get all(): boolean;
     set all(v: boolean);
@@ -61,6 +67,9 @@ export declare class PathEvent {
     /** Create method specified */
     get create(): boolean;
     set create(v: boolean);
+    /** Execute method specified */
+    get execute(): boolean;
+    set execute(v: boolean);
     /** Read method specified */
     get read(): boolean;
     set read(v: boolean);
@@ -73,6 +82,18 @@ export declare class PathEvent {
     constructor(e: string | PathEvent);
     /** Clear the cache of all PathEvents */
     static clearCache(): void;
+    /** Clear the permission cache */
+    static clearPermissionCache(): void;
+    /**
+     * Score a path for specificity ranking (lower = more specific = higher priority)
+     * @private
+     */
+    private static scoreSpecificity;
+    /**
+     * Check if a path matches a glob pattern
+     * @private
+     */
+    private static pathMatchesGlob;
     /**
      * Combine multiple events into one parsed object. Longest path takes precedent, but all subsequent methods are
      * combined until a "none" is reached
@@ -85,10 +106,15 @@ export declare class PathEvent {
      * Filter a set of paths based on the target
      *
      * @param {string | PathEvent | (string | PathEvent)[]} target Array of events that will filtered
-     * @param filter {...PathEvent} Must container one of
-     * @return {boolean} Whether there is any overlap
+     * @param filter {...PathEvent} Must contain one of
+     * @return {PathEvent[]} Filtered results
      */
     static filter(target: string | PathEvent | (string | PathEvent)[], ...filter: (string | PathEvent)[]): PathEvent[];
+    /**
+     * Check if a filter pattern matches a target path
+     * @private
+     */
+    private static matches;
     /**
      * Squash 2 sets of paths & return true if any overlap is found
      *
@@ -102,20 +128,20 @@ export declare class PathEvent {
      *
      * @param {string | PathEvent | (string | PathEvent)[]} target Array of Events as strings or pre-parsed
      * @param has Target must have all these paths
-     * @return {boolean} Whether there is any overlap
+     * @return {boolean} Whether all are present
      */
     static hasAll(target: string | PathEvent | (string | PathEvent)[], ...has: (string | PathEvent)[]): boolean;
     /**
      * Same as `has` but raises an error if there is no overlap
      *
-     * @param {string | string[]} target Array of Events as strings or pre-parsed
+     * @param {string | PathEvent | (string | PathEvent)[]} target Array of Events as strings or pre-parsed
      * @param has Target must have at least one of these path
      */
     static hasFatal(target: string | PathEvent | (string | PathEvent)[], ...has: (string | PathEvent)[]): void;
     /**
      * Same as `hasAll` but raises an error if the target is missing any paths
      *
-     * @param {string | string[]} target Array of Events as strings or pre-parsed
+     * @param {string | PathEvent | (string | PathEvent)[]} target Array of Events as strings or pre-parsed
      * @param has Target must have all these paths
      */
     static hasAllFatal(target: string | PathEvent | (string | PathEvent)[], ...has: (string | PathEvent)[]): void;
@@ -138,7 +164,7 @@ export declare class PathEvent {
      * Squash 2 sets of paths & return true if the target has all paths
      *
      * @param has Target must have all these paths
-     * @return {boolean} Whether there is any overlap
+     * @return {boolean} Whether all are present
      */
     hasAll(...has: (string | PathEvent)[]): boolean;
     /**
@@ -157,7 +183,7 @@ export declare class PathEvent {
      * Filter a set of paths based on this event
      *
      * @param {string | PathEvent | (string | PathEvent)[]} target Array of events that will filtered
-     * @return {boolean} Whether there is any overlap
+     * @return {PathEvent[]} Filtered results
      */
     filter(target: string | PathEvent | (string | PathEvent)[]): PathEvent[];
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ztimson/utils",
-	"version": "0.27.10",
+	"version": "0.27.12",
 	"description": "Utility library",
 	"author": "Zak Timson",
 	"license": "MIT",
@@ -30,15 +30,15 @@
 		"var-persist": "^1.0.1"
 	},
 	"devDependencies": {
-		"@types/jest": "^29.5.12",
-		"fake-indexeddb": "^6.0.1",
-		"jest": "^29.7.0",
+		"@types/jest": "^30.0.0",
+		"fake-indexeddb": "^6.2.5",
+		"jest": "^30.2.0",
 		"jest-junit": "^16.0.0",
-		"ts-jest": "^29.1.2",
-		"typedoc": "^0.26.7",
-		"typescript": "^5.3.3",
-		"vite": "^5.0.12",
-		"vite-plugin-dts": "^4.5.3"
+		"ts-jest": "^29.4.5",
+		"typedoc": "^0.28.15",
+		"typescript": "^5.9.3",
+		"vite": "^7.2.4",
+		"vite-plugin-dts": "^4.5.4"
 	},
 	"files": [
 		"dist"