@acquis-consulting/asm 1.0.5

package/dist/tools/metadataRead.js

@@ -0,0 +1,52 @@
+import { z } from 'zod/v4';
+import { toolResponse } from '../utils/index.js';
+export const metadataReadTool = {
+    name: 'salesforce_read_metadata',
+    description: 'Read full metadata for specific components by their full API names. Essential for deep org analysis — retrieve complete definitions including formulas, logic, field mappings, and configurations. Automatically batches large requests to handle orgs with hundreds of components.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            metadataType: {
+                type: 'string',
+                description: 'The metadata type to read (e.g. "ValidationRule", "Flow").',
+            },
+            fullNames: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Array of full API names to read (e.g. ["Account.My_Rule", "Contact.Other_Rule"]).',
+            },
+        },
+        required: ['metadataType', 'fullNames'],
+    },
+};
+const BATCH_SIZE = 10;
+export async function handleMetadataRead(conn, args) {
+    const { metadataType, fullNames } = args;
+    try {
+        const allResults = [];
+        for (let i = 0; i < fullNames.length; i += BATCH_SIZE) {
+            const chunk = fullNames.slice(i, i + BATCH_SIZE);
+            const result = await conn.metadata.read(metadataType, chunk);
+            const items = Array.isArray(result) ? result : [result];
+            allResults.push(...items);
+        }
+        if (allResults.length === 0) {
+            return toolResponse(`No metadata found for type ${metadataType} with the given names.`);
+        }
+        return toolResponse(`${allResults.length} component(s) read for type ${metadataType}:\n\n${JSON.stringify(allResults, null, 2)}`);
+    }
+    catch (error) {
+        return toolResponse(`Metadata read failed: ${error.message}`, true);
+    }
+}
+export const metadataReadSchema = {
+    metadataType: z.string().describe('The metadata type to read (e.g. "ValidationRule", "Flow").'),
+    fullNames: z.array(z.string()).describe('Array of full API names to read (e.g. ["Account.My_Rule", "Contact.Other_Rule"]).'),
+};
+export const metadataReadDescriptor = {
+    name: 'salesforce_read_metadata',
+    description: metadataReadTool.description,
+    schema: metadataReadSchema,
+    handler: handleMetadataRead,
+};
+//# sourceMappingURL=metadataRead.js.map

package/dist/tools/metadataRead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadataRead.js","sourceRoot":"","sources":["../../src/tools/metadataRead.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,qRAAqR;IAClS,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4DAA4D;aAC1E;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,mFAAmF;aACjG;SACF;QACD,QAAQ,EAAE,CAAC,cAAc,EAAE,WAAW,CAAC;KACxC;CACF,CAAC;AAOF,MAAM,UAAU,GAAG,EAAE,CAAC;AAEtB,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAgB,EAAE,IAAsB;IAC/E,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAEzC,IAAI,CAAC;QACH,MAAM,UAAU,GAAU,EAAE,CAAC;QAE7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC;YACtD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,MAAO,IAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YACtE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACxD,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QAC5B,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,YAAY,CAAC,8BAA8B,YAAY,wBAAwB,CAAC,CAAC;QAC1F,CAAC;QAED,OAAO,YAAY,CACjB,GAAG,UAAU,CAAC,MAAM,+BAA+B,YAAY,QAAQ,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAC7G,CAAC;IACJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,YAAY,CAAC,yBAAyB,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;IAC/F,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,mFAAmF,CAAC;CAC7H,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,gBAAgB,CAAC,WAAW;IACzC,MAAM,EAAE,kBAAkB;IAC1B,OAAO,EAAE,kBAAkB;CAC5B,CAAC"}

package/dist/tools/metadataTypeSchema.d.ts

@@ -0,0 +1,44 @@
+import { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const metadataTypeSchemaTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            metadataType: {
+                type: string;
+                description: string;
+            };
+            maxDepth: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface MetadataTypeSchemaArgs {
+    metadataType: string;
+    maxDepth?: number;
+}
+export declare function handleMetadataTypeSchema(_conn: Connection, args: MetadataTypeSchemaArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const metadataTypeSchemaSchema: {
+    metadataType: z.ZodString;
+    maxDepth: z.ZodOptional<z.ZodNumber>;
+};
+export declare const metadataTypeSchemaDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        metadataType: z.ZodString;
+        maxDepth: z.ZodOptional<z.ZodNumber>;
+    };
+    handler: typeof handleMetadataTypeSchema;
+};

package/dist/tools/metadataTypeSchema.js

@@ -0,0 +1,101 @@
+import { z } from 'zod/v4';
+import { ApiSchemas } from 'jsforce/lib/api/metadata/schema.js';
+import { toolResponse } from '../utils/index.js';
+export const metadataTypeSchemaTool = {
+    name: 'salesforce_get_metadata_type_schema',
+    description: 'Returns the structure/schema for a Salesforce metadata type, showing all properties, their types, and whether they are required or optional. Use this before constructing metadata payloads for create/upsert operations to understand what fields are available. Recursively resolves nested type definitions.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            metadataType: {
+                type: 'string',
+                description: 'The metadata type name, e.g. "CustomObject", "Flow", "ValidationRule"',
+            },
+            maxDepth: {
+                type: 'number',
+                description: 'How deep to resolve nested types. Limits output size for complex types. Default: 3',
+            },
+        },
+        required: ['metadataType'],
+    },
+};
+const schemas = ApiSchemas;
+function resolveType(typeName, maxDepth, currentDepth, visited) {
+    const schema = schemas[typeName];
+    if (!schema)
+        return null;
+    const properties = {};
+    // Merge parent props first
+    if (schema.extends && schemas[schema.extends]) {
+        const parent = resolveType(schema.extends, maxDepth, currentDepth, visited);
+        if (parent) {
+            Object.assign(properties, parent.properties);
+        }
+    }
+    for (const [key, value] of Object.entries(schema.props)) {
+        if (Array.isArray(value)) {
+            // Array type: ["CustomField"]
+            const refType = value[0];
+            const prop = { type: refType, required: false, isArray: true };
+            if (!isPrimitive(refType) && currentDepth < maxDepth && !visited.has(refType)) {
+                visited.add(refType);
+                const nested = resolveType(refType, maxDepth, currentDepth + 1, visited);
+                visited.delete(refType);
+                if (nested) {
+                    prop.properties = nested.properties;
+                    if (nested.extends)
+                        prop.extends = nested.extends;
+                }
+            }
+            properties[key] = prop;
+        }
+        else {
+            const raw = value;
+            const optional = raw.startsWith('?');
+            const typeName = optional ? raw.slice(1) : raw;
+            const prop = { type: typeName, required: !optional };
+            if (!isPrimitive(typeName) && currentDepth < maxDepth && !visited.has(typeName)) {
+                visited.add(typeName);
+                const nested = resolveType(typeName, maxDepth, currentDepth + 1, visited);
+                visited.delete(typeName);
+                if (nested) {
+                    prop.properties = nested.properties;
+                    if (nested.extends)
+                        prop.extends = nested.extends;
+                }
+            }
+            properties[key] = prop;
+        }
+    }
+    const result = { type: schema.type, properties };
+    if (schema.extends)
+        result.extends = schema.extends;
+    return result;
+}
+function isPrimitive(type) {
+    return ['string', 'boolean', 'number', 'integer'].includes(type);
+}
+export async function handleMetadataTypeSchema(_conn, args) {
+    try {
+        const { metadataType, maxDepth = 3 } = args;
+        if (!schemas[metadataType]) {
+            return toolResponse(`Unknown metadata type: "${metadataType}". Use the salesforce_list_metadata_types tool to discover valid metadata type names.`, true);
+        }
+        const resolved = resolveType(metadataType, maxDepth, 0, new Set([metadataType]));
+        return toolResponse(JSON.stringify(resolved, null, 2));
+    }
+    catch (error) {
+        return toolResponse(`Failed to resolve metadata type schema: ${error.message}`, true);
+    }
+}
+export const metadataTypeSchemaSchema = {
+    metadataType: z.string().describe('The metadata type name, e.g. "CustomObject", "Flow", "ValidationRule"'),
+    maxDepth: z.number().describe('How deep to resolve nested types. Limits output size for complex types. Default: 3').optional(),
+};
+export const metadataTypeSchemaDescriptor = {
+    name: 'salesforce_get_metadata_type_schema',
+    description: metadataTypeSchemaTool.description,
+    schema: metadataTypeSchemaSchema,
+    handler: handleMetadataTypeSchema,
+};
+//# sourceMappingURL=metadataTypeSchema.js.map

package/dist/tools/metadataTypeSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadataTypeSchema.js","sourceRoot":"","sources":["../../src/tools/metadataTypeSchema.ts"],"names":[],"mappings":"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"}

package/dist/tools/metadataWsdl.d.ts

@@ -0,0 +1,19 @@
+import { Connection } from 'jsforce';
+export declare const metadataWsdlTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+};
+export interface MetadataWsdlArgs {
+}
+export declare function handleMetadataWsdl(conn: Connection, _args: MetadataWsdlArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/dist/tools/metadataWsdl.js

@@ -0,0 +1 @@
+import t from"fs";import e from"path";import a from"os";import{toolResponse as o}from"../utils/index.js";export const metadataWsdlTool={name:"salesforce_download_metadata_wsdl",description:"Downloads the Metadata WSDL file from the connected Salesforce org and saves it to the temp directory. Checks if the file already exists before downloading. The WSDL describes all metadata types and their structure, useful for understanding metadata operations.",inputSchema:{type:"object",properties:{},required:[]}};export async function handleMetadataWsdl(s,d){try{const d=s.version,r=e.join(a.tmpdir(),`metadata_${d}.wsdl`);if(t.existsSync(r))return o(`Metadata WSDL already cached at: ${r}`);const n=await fetch(`${s.instanceUrl}/services/wsdl/metadata`,{headers:{Authorization:`Bearer ${s.accessToken}`}});if(!n.ok)return o(`Failed to download Metadata WSDL: HTTP ${n.status} ${n.statusText}`,!0);const i=await n.text();return t.writeFileSync(r,i,"utf-8"),o(`Metadata WSDL downloaded and saved to: ${r}`)}catch(t){return o(`Metadata WSDL download failed: ${t.message}`,!0)}}

package/dist/tools/objectManagement.d.ts

@@ -0,0 +1,107 @@
+import { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const objectManagementTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            operation: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            objectName: {
+                type: string;
+                description: string;
+            };
+            label: {
+                type: string;
+                description: string;
+            };
+            pluralLabel: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            nameFieldLabel: {
+                type: string;
+                description: string;
+            };
+            nameFieldType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            nameFieldFormat: {
+                type: string;
+                description: string;
+            };
+            sharingModel: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface ObjectManagementArgs {
+    operation: 'create' | 'update';
+    objectName: string;
+    label?: string;
+    pluralLabel?: string;
+    description?: string;
+    nameFieldLabel?: string;
+    nameFieldType?: 'Text' | 'AutoNumber';
+    nameFieldFormat?: string;
+    sharingModel?: string;
+}
+export declare function handleObjectManagement(conn: Connection, args: ObjectManagementArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const objectManagementSchema: {
+    operation: z.ZodEnum<{
+        update: "update";
+        create: "create";
+    }>;
+    objectName: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    pluralLabel: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    nameFieldLabel: z.ZodOptional<z.ZodString>;
+    nameFieldType: z.ZodOptional<z.ZodEnum<{
+        Text: "Text";
+        AutoNumber: "AutoNumber";
+    }>>;
+    nameFieldFormat: z.ZodOptional<z.ZodString>;
+    sharingModel: z.ZodOptional<z.ZodString>;
+};
+export declare const objectManagementDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        operation: z.ZodEnum<{
+            update: "update";
+            create: "create";
+        }>;
+        objectName: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        pluralLabel: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        nameFieldLabel: z.ZodOptional<z.ZodString>;
+        nameFieldType: z.ZodOptional<z.ZodEnum<{
+            Text: "Text";
+            AutoNumber: "AutoNumber";
+        }>>;
+        nameFieldFormat: z.ZodOptional<z.ZodString>;
+        sharingModel: z.ZodOptional<z.ZodString>;
+    };
+    handler: typeof handleObjectManagement;
+};

package/dist/tools/objectManagement.js

@@ -0,0 +1,123 @@
+import { z } from 'zod/v4';
+import { toolResponse, formatMetadataErrors } from '../utils/index.js';
+export const objectManagementTool = {
+    name: 'salesforce_manage_object',
+    description: 'Create or update custom Salesforce objects via Metadata API. Object name should not include the __c suffix — it is added automatically.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['create', 'update'],
+                description: 'Create a new custom object or update an existing one.',
+            },
+            objectName: {
+                type: 'string',
+                description: 'Object name without __c suffix.',
+            },
+            label: {
+                type: 'string',
+                description: 'Object label (required for create).',
+            },
+            pluralLabel: {
+                type: 'string',
+                description: 'Plural label (required for create).',
+            },
+            description: {
+                type: 'string',
+                description: 'Object description.',
+            },
+            nameFieldLabel: {
+                type: 'string',
+                description: 'Label for the name field (default: object label + " Name").',
+            },
+            nameFieldType: {
+                type: 'string',
+                enum: ['Text', 'AutoNumber'],
+                description: 'Name field type. Default: Text.',
+            },
+            nameFieldFormat: {
+                type: 'string',
+                description: 'Display format for AutoNumber name fields. Example: "INV-{0000}"',
+            },
+            sharingModel: {
+                type: 'string',
+                description: 'Sharing model. Default: ReadWrite.',
+            },
+        },
+        required: ['operation', 'objectName'],
+    },
+};
+export async function handleObjectManagement(conn, args) {
+    const { operation, objectName } = args;
+    const fullName = objectName.endsWith('__c') ? objectName : `${objectName}__c`;
+    try {
+        if (operation === 'create') {
+            if (!args.label || !args.pluralLabel) {
+                return toolResponse('Create requires "label" and "pluralLabel" parameters.', true);
+            }
+            const nameField = {
+                label: args.nameFieldLabel || `${args.label} Name`,
+                type: args.nameFieldType || 'Text',
+            };
+            if (nameField.type === 'AutoNumber' && args.nameFieldFormat) {
+                nameField.displayFormat = args.nameFieldFormat;
+            }
+            const metadata = {
+                fullName,
+                label: args.label,
+                pluralLabel: args.pluralLabel,
+                nameField,
+                deploymentStatus: 'Deployed',
+                sharingModel: args.sharingModel || 'ReadWrite',
+                description: args.description,
+            };
+            const result = await conn.metadata.create('CustomObject', metadata);
+            if (result.success) {
+                return toolResponse(`Custom object "${fullName}" created successfully.`);
+            }
+            return toolResponse(`Failed to create object: ${formatMetadataErrors(result)}`, true);
+        }
+        // Update
+        const existing = await conn.metadata.read('CustomObject', [fullName]);
+        if (!existing || (Array.isArray(existing) && existing.length === 0)) {
+            return toolResponse(`Object "${fullName}" not found.`, true);
+        }
+        const current = Array.isArray(existing) ? existing[0] : existing;
+        const updated = { ...current };
+        if (args.label)
+            updated.label = args.label;
+        if (args.pluralLabel)
+            updated.pluralLabel = args.pluralLabel;
+        if (args.description !== undefined)
+            updated.description = args.description;
+        if (args.sharingModel)
+            updated.sharingModel = args.sharingModel;
+        const result = await conn.metadata.update('CustomObject', updated);
+        if (result.success) {
+            return toolResponse(`Custom object "${fullName}" updated successfully.`);
+        }
+        return toolResponse(`Failed to update object: ${formatMetadataErrors(result)}`, true);
+    }
+    catch (error) {
+        return toolResponse(`Object ${operation} failed: ${error.message}`, true);
+    }
+}
+export const objectManagementSchema = {
+    operation: z.enum(['create', 'update']).describe('Create a new custom object or update an existing one.'),
+    objectName: z.string().describe('Object name without __c suffix.'),
+    label: z.string().describe('Object label (required for create).').optional(),
+    pluralLabel: z.string().describe('Plural label (required for create).').optional(),
+    description: z.string().describe('Object description.').optional(),
+    nameFieldLabel: z.string().describe('Label for the name field (default: object label + " Name").').optional(),
+    nameFieldType: z.enum(['Text', 'AutoNumber']).describe('Name field type. Default: Text.').optional(),
+    nameFieldFormat: z.string().describe('Display format for AutoNumber name fields. Example: "INV-{0000}"').optional(),
+    sharingModel: z.string().describe('Sharing model. Default: ReadWrite.').optional(),
+};
+export const objectManagementDescriptor = {
+    name: 'salesforce_manage_object',
+    description: objectManagementTool.description,
+    schema: objectManagementSchema,
+    handler: handleObjectManagement,
+};
+//# sourceMappingURL=objectManagement.js.map

package/dist/tools/objectManagement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectManagement.js","sourceRoot":"","sources":["../../src/tools/objectManagement.ts"],"names":[],"mappings":"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"}

package/dist/tools/objectPermissions.d.ts

@@ -0,0 +1,101 @@
+import { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+declare const PERMISSION_KEYS: readonly ["create", "read", "edit", "delete", "viewAll", "modifyAll"];
+type PermKey = typeof PERMISSION_KEYS[number];
+export declare const objectPermissionsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            operation: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            objectName: {
+                type: string;
+                description: string;
+            };
+            profileNames: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            permissionSetNames: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            permissions: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface ObjectPermissionsArgs {
+    operation: 'grant' | 'revoke' | 'list';
+    objectName: string;
+    profileNames?: string[];
+    permissionSetNames?: string[];
+    permissions?: PermKey[];
+}
+export declare function handleObjectPermissions(conn: Connection, args: ObjectPermissionsArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const objectPermissionsSchema: {
+    operation: z.ZodEnum<{
+        grant: "grant";
+        revoke: "revoke";
+        list: "list";
+    }>;
+    objectName: z.ZodString;
+    profileNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    permissionSetNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        create: "create";
+        delete: "delete";
+        read: "read";
+        edit: "edit";
+        viewAll: "viewAll";
+        modifyAll: "modifyAll";
+    }>>>;
+};
+export declare const objectPermissionsDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        operation: z.ZodEnum<{
+            grant: "grant";
+            revoke: "revoke";
+            list: "list";
+        }>;
+        objectName: z.ZodString;
+        profileNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        permissionSetNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        permissions: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            create: "create";
+            delete: "delete";
+            read: "read";
+            edit: "edit";
+            viewAll: "viewAll";
+            modifyAll: "modifyAll";
+        }>>>;
+    };
+    handler: typeof handleObjectPermissions;
+};
+export {};