@ztimson/utils 0.27.9 → 0.27.11

package/dist/path-events.d.ts

@@ -35,9 +35,10 @@ 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 +47,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 +68,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 +83,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 +107,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 +129,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 +165,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 +184,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.9",
+	"version": "0.27.11",
 	"description": "Utility library",
 	"author": "Zak Timson",
 	"license": "MIT",