@tmlmobilidade/types 20260121.2332.6 → 20260128.2248.28

package/dist/organization.d.ts

@@ -6,20 +6,20 @@ export declare const HomeLinkSchema: z.ZodObject<{
     title: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     title: string;
-    href: string;
     icon: string;
+    href: string;
     order: number;
 }, {
     title: string;
-    href: string;
     icon: string;
+    href: string;
     order: number;
 }>;
 export type HomeLink = z.infer<typeof HomeLinkSchema>;
 export declare const OrganizationSchema: z.ZodObject<{
     _id: z.ZodString;
     created_at: z.ZodEffects<z.ZodNumber, import("./index.js").UnixTimestamp, number>;
-    created_by: z.ZodOptional<z.ZodString>;
+    created_by: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     is_locked: z.ZodDefault<z.ZodBoolean>;
     updated_at: z.ZodEffects<z.ZodNumber, import("./index.js").UnixTimestamp, number>;
     updated_by: z.ZodOptional<z.ZodString>;
@@ -31,13 +31,13 @@ export declare const OrganizationSchema: z.ZodObject<{
         title: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         title: string;
-        href: string;
         icon: string;
+        href: string;
         order: number;
     }, {
         title: string;
-        href: string;
         icon: string;
+        href: string;
         order: number;
     }>, "many">>;
     home_wikis: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -51,6 +51,7 @@ export declare const OrganizationSchema: z.ZodObject<{
     created_at: number & {
         __brand: "UnixTimestamp";
     };
+    created_by: string | null;
     is_locked: boolean;
     updated_at: number & {
         __brand: "UnixTimestamp";
@@ -58,8 +59,8 @@ export declare const OrganizationSchema: z.ZodObject<{
     short_name: string;
     home_links: {
         title: string;
-        href: string;
         icon: string;
+        href: string;
         order: number;
     }[];
     home_wikis: string[];
@@ -67,7 +68,6 @@ export declare const OrganizationSchema: z.ZodObject<{
     logo_light: string | null;
     long_name: string;
     theme: string | null;
-    created_by?: string | undefined;
     updated_by?: string | undefined;
 }, {
     _id: string;
@@ -75,13 +75,13 @@ export declare const OrganizationSchema: z.ZodObject<{
     updated_at: number;
     short_name: string;
     long_name: string;
-    created_by?: string | undefined;
+    created_by?: string | null | undefined;
     is_locked?: boolean | undefined;
     updated_by?: string | undefined;
     home_links?: {
         title: string;
-        href: string;
         icon: string;
+        href: string;
         order: number;
     }[] | undefined;
     home_wikis?: string[] | undefined;
@@ -92,7 +92,7 @@ export declare const OrganizationSchema: z.ZodObject<{
 export declare const CreateOrganizationSchema: z.ZodObject<Omit<{
     _id: z.ZodString;
     created_at: z.ZodEffects<z.ZodNumber, import("./index.js").UnixTimestamp, number>;
-    created_by: z.ZodOptional<z.ZodString>;
+    created_by: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     is_locked: z.ZodDefault<z.ZodBoolean>;
     updated_at: z.ZodEffects<z.ZodNumber, import("./index.js").UnixTimestamp, number>;
     updated_by: z.ZodOptional<z.ZodString>;
@@ -104,13 +104,13 @@ export declare const CreateOrganizationSchema: z.ZodObject<Omit<{
         title: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         title: string;
-        href: string;
         icon: string;
+        href: string;
         order: number;
     }, {
         title: string;
-        href: string;
         icon: string;
+        href: string;
         order: number;
     }>, "many">>;
     home_wikis: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -120,12 +120,13 @@ export declare const CreateOrganizationSchema: z.ZodObject<Omit<{
     short_name: z.ZodString;
     theme: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 }, "_id" | "created_at" | "updated_at">, "strip", z.ZodTypeAny, {
+    created_by: string | null;
     is_locked: boolean;
     short_name: string;
     home_links: {
         title: string;
-        href: string;
         icon: string;
+        href: string;
         order: number;
     }[];
     home_wikis: string[];
@@ -133,18 +134,17 @@ export declare const CreateOrganizationSchema: z.ZodObject<Omit<{
     logo_light: string | null;
     long_name: string;
     theme: string | null;
-    created_by?: string | undefined;
     updated_by?: string | undefined;
 }, {
     short_name: string;
     long_name: string;
-    created_by?: string | undefined;
+    created_by?: string | null | undefined;
     is_locked?: boolean | undefined;
     updated_by?: string | undefined;
     home_links?: {
         title: string;
-        href: string;
         icon: string;
+        href: string;
         order: number;
     }[] | undefined;
     home_wikis?: string[] | undefined;
@@ -163,13 +163,13 @@ export declare const UpdateOrganizationSchema: z.ZodObject<{
         title: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         title: string;
-        href: string;
         icon: string;
+        href: string;
         order: number;
     }, {
         title: string;
-        href: string;
         icon: string;
+        href: string;
         order: number;
     }>, "many">>>;
     home_wikis: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
@@ -183,8 +183,8 @@ export declare const UpdateOrganizationSchema: z.ZodObject<{
     short_name?: string | undefined;
     home_links?: {
         title: string;
-        href: string;
         icon: string;
+        href: string;
         order: number;
     }[] | undefined;
     home_wikis?: string[] | undefined;
@@ -198,8 +198,8 @@ export declare const UpdateOrganizationSchema: z.ZodObject<{
     short_name?: string | undefined;
     home_links?: {
         title: string;
-        href: string;
         icon: string;
+        href: string;
         order: number;
     }[] | undefined;
     home_wikis?: string[] | undefined;

package/dist/permissions/alerts.d.ts

@@ -1,36 +1,30 @@
 import { z } from 'zod';
-export declare const AlertsScheduledPermissionSchema: z.ZodObject<{
-    action: z.ZodEnum<["create", "delete", "read", "lock", "update"]>;
-    scope: z.ZodLiteral<"alerts_scheduled">;
-}, "strip", z.ZodTypeAny, {
-    scope: "alerts_scheduled";
-    action: "create" | "update" | "delete" | "read" | "lock";
-}, {
-    scope: "alerts_scheduled";
-    action: "create" | "update" | "delete" | "read" | "lock";
-}>;
-export type AlertsScheduledPermission = z.infer<typeof AlertsScheduledPermissionSchema>;
-export declare const AlertsRealtimePermissionSchema: z.ZodObject<{
-    action: z.ZodEnum<["create", "delete", "read", "lock", "update"]>;
+export declare const AlertsPermissionSchema: z.ZodObject<{
+    action: z.ZodEnum<["create", "delete", "read", "lock", "update", "update_texts", "update_dates", "update_publish_status"]>;
     resources: z.ZodDefault<z.ZodObject<{
         agency_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        reference_types: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         agency_ids: string[];
+        reference_types: string[];
     }, {
         agency_ids?: string[] | undefined;
+        reference_types?: string[] | undefined;
     }>>;
-    scope: z.ZodLiteral<"alerts_realtime">;
+    scope: z.ZodLiteral<"alerts">;
 }, "strip", z.ZodTypeAny, {
-    scope: "alerts_realtime";
-    action: "create" | "update" | "delete" | "read" | "lock";
+    scope: "alerts";
+    action: "create" | "update" | "delete" | "read" | "lock" | "update_texts" | "update_dates" | "update_publish_status";
     resources: {
         agency_ids: string[];
+        reference_types: string[];
     };
 }, {
-    scope: "alerts_realtime";
-    action: "create" | "update" | "delete" | "read" | "lock";
+    scope: "alerts";
+    action: "create" | "update" | "delete" | "read" | "lock" | "update_texts" | "update_dates" | "update_publish_status";
     resources?: {
         agency_ids?: string[] | undefined;
+        reference_types?: string[] | undefined;
     } | undefined;
 }>;
-export type AlertsRealtimePermission = z.infer<typeof AlertsRealtimePermissionSchema>;
+export type AlertsPermission = z.infer<typeof AlertsPermissionSchema>;

package/dist/permissions/alerts.js

@@ -1,25 +1,20 @@
 /* * */
 import { z } from 'zod';
 /* * */
-export const AlertsScheduledPermissionSchema = z.object({
-    action: z.enum(['create',
-        'delete',
-        'read',
-        'lock',
-        'update',
-    ]),
-    scope: z.literal('alerts_scheduled'),
-});
-/* * */
-export const AlertsRealtimePermissionSchema = z.object({
-    action: z.enum(['create',
+export const AlertsPermissionSchema = z.object({
+    action: z.enum([
+        'create',
         'delete',
         'read',
         'lock',
         'update',
+        'update_texts',
+        'update_dates',
+        'update_publish_status',
     ]),
     resources: z.object({
         agency_ids: z.array(z.string()).default([]),
+        reference_types: z.array(z.string()).default([]),
     }).default({}),
-    scope: z.literal('alerts_realtime'),
+    scope: z.literal('alerts'),
 });

package/dist/permissions/annotations.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+export declare const AnnotationsPermissionSchema: z.ZodObject<{
+    action: z.ZodEnum<["create", "delete", "read", "lock", "update"]>;
+    resources: z.ZodDefault<z.ZodObject<{
+        agency_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        agency_ids: string[];
+    }, {
+        agency_ids?: string[] | undefined;
+    }>>;
+    scope: z.ZodLiteral<"annotations">;
+}, "strip", z.ZodTypeAny, {
+    scope: "annotations";
+    action: "create" | "update" | "delete" | "read" | "lock";
+    resources: {
+        agency_ids: string[];
+    };
+}, {
+    scope: "annotations";
+    action: "create" | "update" | "delete" | "read" | "lock";
+    resources?: {
+        agency_ids?: string[] | undefined;
+    } | undefined;
+}>;
+export type AnnotationsPermission = z.infer<typeof AnnotationsPermissionSchema>;

package/dist/permissions/annotations.js

@@ -0,0 +1,16 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const AnnotationsPermissionSchema = z.object({
+    action: z.enum([
+        'create',
+        'delete',
+        'read',
+        'lock',
+        'update',
+    ]),
+    resources: z.object({
+        agency_ids: z.array(z.string()).default([]),
+    }).default({}),
+    scope: z.literal('annotations'),
+});

package/dist/permissions/fares.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+export declare const FaresPermissionSchema: z.ZodObject<{
+    action: z.ZodEnum<["create", "delete", "read", "lock", "update"]>;
+    resources: z.ZodDefault<z.ZodObject<{
+        agency_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        agency_ids: string[];
+    }, {
+        agency_ids?: string[] | undefined;
+    }>>;
+    scope: z.ZodLiteral<"fares">;
+}, "strip", z.ZodTypeAny, {
+    scope: "fares";
+    action: "create" | "update" | "delete" | "read" | "lock";
+    resources: {
+        agency_ids: string[];
+    };
+}, {
+    scope: "fares";
+    action: "create" | "update" | "delete" | "read" | "lock";
+    resources?: {
+        agency_ids?: string[] | undefined;
+    } | undefined;
+}>;
+export type FaresPermission = z.infer<typeof FaresPermissionSchema>;

package/dist/permissions/fares.js

@@ -0,0 +1,16 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const FaresPermissionSchema = z.object({
+    action: z.enum([
+        'create',
+        'delete',
+        'read',
+        'lock',
+        'update',
+    ]),
+    resources: z.object({
+        agency_ids: z.array(z.string()).default([]),
+    }).default({}),
+    scope: z.literal('fares'),
+});

package/dist/permissions/index.d.ts

@@ -9,35 +9,31 @@ export declare const PermissionSchema: z.ZodDiscriminatedUnion<"scope", [z.ZodOb
     scope: "agencies";
     action: "create" | "update" | "delete" | "read" | "lock";
 }>, z.ZodObject<{
-    action: z.ZodEnum<["create", "delete", "read", "lock", "update"]>;
-    scope: z.ZodLiteral<"alerts_scheduled">;
-}, "strip", z.ZodTypeAny, {
-    scope: "alerts_scheduled";
-    action: "create" | "update" | "delete" | "read" | "lock";
-}, {
-    scope: "alerts_scheduled";
-    action: "create" | "update" | "delete" | "read" | "lock";
-}>, z.ZodObject<{
-    action: z.ZodEnum<["create", "delete", "read", "lock", "update"]>;
+    action: z.ZodEnum<["create", "delete", "read", "lock", "update", "update_texts", "update_dates", "update_publish_status"]>;
     resources: z.ZodDefault<z.ZodObject<{
         agency_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        reference_types: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         agency_ids: string[];
+        reference_types: string[];
     }, {
         agency_ids?: string[] | undefined;
+        reference_types?: string[] | undefined;
     }>>;
-    scope: z.ZodLiteral<"alerts_realtime">;
+    scope: z.ZodLiteral<"alerts">;
 }, "strip", z.ZodTypeAny, {
-    scope: "alerts_realtime";
-    action: "create" | "update" | "delete" | "read" | "lock";
+    scope: "alerts";
+    action: "create" | "update" | "delete" | "read" | "lock" | "update_texts" | "update_dates" | "update_publish_status";
     resources: {
         agency_ids: string[];
+        reference_types: string[];
     };
 }, {
-    scope: "alerts_realtime";
-    action: "create" | "update" | "delete" | "read" | "lock";
+    scope: "alerts";
+    action: "create" | "update" | "delete" | "read" | "lock" | "update_texts" | "update_dates" | "update_publish_status";
     resources?: {
         agency_ids?: string[] | undefined;
+        reference_types?: string[] | undefined;
     } | undefined;
 }>, z.ZodObject<{
     action: z.ZodEnum<["acceptance_change_status", "acceptance_justify", "acceptance_lock", "acceptance_read", "analsys_lock", "analysis_lock", "analysis_read", "analysis_reprocess", "analysis_update", "audit_lock", "audit_read", "audit_update"]>;
@@ -187,7 +183,29 @@ export declare const PermissionSchema: z.ZodDiscriminatedUnion<"scope", [z.ZodOb
     scope: "users";
     action: "create" | "update" | "delete" | "read" | "lock";
 }>, z.ZodObject<{
-    action: z.ZodEnum<["create_annotations", "delete_annotations", "read_annotations", "update_annotations", "lock_annotations"]>;
+    action: z.ZodEnum<["create", "delete", "read", "lock", "update"]>;
+    resources: z.ZodDefault<z.ZodObject<{
+        agency_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        agency_ids: string[];
+    }, {
+        agency_ids?: string[] | undefined;
+    }>>;
+    scope: z.ZodLiteral<"vehicles">;
+}, "strip", z.ZodTypeAny, {
+    scope: "vehicles";
+    action: "create" | "update" | "delete" | "read" | "lock";
+    resources: {
+        agency_ids: string[];
+    };
+}, {
+    scope: "vehicles";
+    action: "create" | "update" | "delete" | "read" | "lock";
+    resources?: {
+        agency_ids?: string[] | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    action: z.ZodEnum<["create", "delete", "read", "lock", "update"]>;
     resources: z.ZodDefault<z.ZodObject<{
         agency_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
@@ -195,16 +213,126 @@ export declare const PermissionSchema: z.ZodDiscriminatedUnion<"scope", [z.ZodOb
     }, {
         agency_ids?: string[] | undefined;
     }>>;
-    scope: z.ZodLiteral<"dates">;
+    scope: z.ZodLiteral<"fares">;
 }, "strip", z.ZodTypeAny, {
-    scope: "dates";
-    action: "create_annotations" | "delete_annotations" | "read_annotations" | "update_annotations" | "lock_annotations";
+    scope: "fares";
+    action: "create" | "update" | "delete" | "read" | "lock";
     resources: {
         agency_ids: string[];
     };
 }, {
-    scope: "dates";
-    action: "create_annotations" | "delete_annotations" | "read_annotations" | "update_annotations" | "lock_annotations";
+    scope: "fares";
+    action: "create" | "update" | "delete" | "read" | "lock";
+    resources?: {
+        agency_ids?: string[] | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    action: z.ZodEnum<["create", "delete", "read", "lock", "update"]>;
+    resources: z.ZodDefault<z.ZodObject<{
+        agency_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        agency_ids: string[];
+    }, {
+        agency_ids?: string[] | undefined;
+    }>>;
+    scope: z.ZodLiteral<"annotations">;
+}, "strip", z.ZodTypeAny, {
+    scope: "annotations";
+    action: "create" | "update" | "delete" | "read" | "lock";
+    resources: {
+        agency_ids: string[];
+    };
+}, {
+    scope: "annotations";
+    action: "create" | "update" | "delete" | "read" | "lock";
+    resources?: {
+        agency_ids?: string[] | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    action: z.ZodEnum<["create", "delete", "read", "lock", "update"]>;
+    resources: z.ZodDefault<z.ZodObject<{
+        agency_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        agency_ids: string[];
+    }, {
+        agency_ids?: string[] | undefined;
+    }>>;
+    scope: z.ZodLiteral<"periods">;
+}, "strip", z.ZodTypeAny, {
+    scope: "periods";
+    action: "create" | "update" | "delete" | "read" | "lock";
+    resources: {
+        agency_ids: string[];
+    };
+}, {
+    scope: "periods";
+    action: "create" | "update" | "delete" | "read" | "lock";
+    resources?: {
+        agency_ids?: string[] | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    action: z.ZodEnum<["create", "delete", "read", "lock", "update"]>;
+    resources: z.ZodDefault<z.ZodObject<{
+        agency_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        agency_ids: string[];
+    }, {
+        agency_ids?: string[] | undefined;
+    }>>;
+    scope: z.ZodLiteral<"zones">;
+}, "strip", z.ZodTypeAny, {
+    scope: "zones";
+    action: "create" | "update" | "delete" | "read" | "lock";
+    resources: {
+        agency_ids: string[];
+    };
+}, {
+    scope: "zones";
+    action: "create" | "update" | "delete" | "read" | "lock";
+    resources?: {
+        agency_ids?: string[] | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    action: z.ZodEnum<["create", "delete", "read", "lock", "update"]>;
+    resources: z.ZodDefault<z.ZodObject<{
+        agency_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        agency_ids: string[];
+    }, {
+        agency_ids?: string[] | undefined;
+    }>>;
+    scope: z.ZodLiteral<"typologies">;
+}, "strip", z.ZodTypeAny, {
+    scope: "typologies";
+    action: "create" | "update" | "delete" | "read" | "lock";
+    resources: {
+        agency_ids: string[];
+    };
+}, {
+    scope: "typologies";
+    action: "create" | "update" | "delete" | "read" | "lock";
+    resources?: {
+        agency_ids?: string[] | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    action: z.ZodEnum<["create", "delete", "read", "lock", "update"]>;
+    resources: z.ZodDefault<z.ZodObject<{
+        agency_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        agency_ids: string[];
+    }, {
+        agency_ids?: string[] | undefined;
+    }>>;
+    scope: z.ZodLiteral<"lines">;
+}, "strip", z.ZodTypeAny, {
+    scope: "lines";
+    action: "create" | "update" | "delete" | "read" | "lock";
+    resources: {
+        agency_ids: string[];
+    };
+}, {
+    scope: "lines";
+    action: "create" | "update" | "delete" | "read" | "lock";
     resources?: {
         agency_ids?: string[] | undefined;
     } | undefined;
@@ -232,6 +360,24 @@ export interface HasPermissionResourceArgs {
     scope: string;
     value: unknown;
 }
+/**
+ * Arguments for getScopePermissions function.
+ */
+export interface GetScopePermissionsArgs<S extends Permission['scope']> {
+    actions: PermissionCatalogType[S]['actions'];
+    permissions: Permission[];
+    resource?: {
+        key: string;
+        requireAll?: boolean;
+        value: unknown;
+    };
+    scope: S;
+}
+/**
+ * Result object containing permission checks for a scope.
+ * Maps each action of the scope to a boolean indicating if the user has that permission.
+ */
+export type ScopePermissions<S extends Permission['scope']> = Record<ActionsOf<S>, boolean>;
 /**
  * PermissionCatalog provides a structured catalog of all available permissions
  * in the system, categorized by scope and their respective actions.
@@ -256,6 +402,14 @@ export declare class PermissionCatalog {
         action: ActionsOf<S>;
         scope: S;
     }> | undefined;
+    /**
+     * Get all permissions for a given scope and set of actions in one call.
+     * More efficient than calling hasPermission or hasPermissionResource multiple times.
+     * @param args Arguments object containing permissions, scope, actions, and optional resource.
+     * @param args.resource.requireAll If true, uses hasPermissionResourceAll (user must have permission for ALL values in array). If false/undefined, uses hasPermissionResource (user needs permission for ANY value).
+     * @returns Object with boolean values for each action in the scope.
+     */
+    static getScopePermissions<S extends Permission['scope']>({ actions, permissions, resource, scope }: GetScopePermissionsArgs<S>): ScopePermissions<S>;
     /**
      * Check if a list of permission entries has the requested scope/action pair.
      * @param permissionEntries The list of permission entries to check against.
@@ -279,6 +433,19 @@ export declare class PermissionCatalog {
      * @returns The permission.
      */
     static hasPermissionResource({ action, permissions, resource_key, scope, value }: HasPermissionResourceArgs): boolean;
+    /**
+     * Checks whether the user has permission to perform a specific action
+     * within a specific scope for ALL values in an array.
+     * This is stricter than `hasPermissionResource` which only requires permission for ANY value.
+     * Use this for operations like update/delete where the user must have permission for all agencies involved.
+     * @param permissions The list of permissions (from a user or request).
+     * @param value The permission value(s) to check against - if array, ALL values must be permitted.
+     * @param resource_key The key of the resource.
+     * @param scope The scope of the permission.
+     * @param action The action of the permission.
+     * @returns True if user has permission for ALL values, false otherwise.
+     */
+    static hasPermissionResourceAll({ action, permissions, resource_key, scope, value }: HasPermissionResourceArgs): boolean;
     /**
      * Sanitizes a list of permissions by removing any entries
      * that do not correspond to valid scopes and actions
@@ -287,4 +454,12 @@ export declare class PermissionCatalog {
      * @return A cleaned array containing only valid permissions.
      */
     static sanitize(existingEntries: Permission[]): Permission[];
+    /**
+     * Sanitizes a list of permissions by removing any entries
+     * that do not correspond to valid scopes and actions
+     * defined in the PermissionCatalog.
+     * @param existingEntries Array of Permission objects to sanitize.
+     * @return A cleaned array containing only valid permissions.
+     */
+    static updatePermissionResource<S extends Permission['scope']>(permissionEntries: Permission[], scope: S, action: ActionsOf<S>, resources: Record<string, unknown>): Permission[];
 }