@jterrats/smart-deployment 1.0.3

package/lib/types/salesforce/permission.d.ts

@@ -0,0 +1,289 @@
+/**
+ * Type definitions for Salesforce Permission metadata
+ * Represents PermissionSet and Profile metadata structures
+ */
+/**
+ * Permission Set metadata (.permissionset-meta.xml)
+ */
+export type PermissionSetMetadata = {
+    description?: string;
+    hasActivationRequired?: boolean;
+    label: string;
+    license?: string;
+    applicationVisibilities?: PermissionSetApplicationVisibility[];
+    classAccesses?: PermissionSetApexClassAccess[];
+    customMetadataTypeAccesses?: PermissionSetCustomMetadataTypeAccess[];
+    customPermissions?: PermissionSetCustomPermissions[];
+    customSettingAccesses?: PermissionSetCustomSettingAccess[];
+    externalDataSourceAccesses?: PermissionSetExternalDataSourceAccess[];
+    fieldPermissions?: PermissionSetFieldPermissions[];
+    flowAccesses?: PermissionSetFlowAccess[];
+    objectPermissions?: PermissionSetObjectPermissions[];
+    pageAccesses?: PermissionSetApexPageAccess[];
+    recordTypeVisibilities?: PermissionSetRecordTypeVisibility[];
+    tabSettings?: PermissionSetTabVisibility[];
+    userPermissions?: PermissionSetUserPermission[];
+};
+/**
+ * Profile metadata (.profile-meta.xml)
+ */
+export type ProfileMetadata = {
+    custom?: boolean;
+    description?: string;
+    userLicense?: string;
+    applicationVisibilities?: ProfileApplicationVisibility[];
+    classAccesses?: ProfileApexClassAccess[];
+    customMetadataTypeAccesses?: ProfileCustomMetadataTypeAccess[];
+    customPermissions?: ProfileCustomPermissions[];
+    customSettingAccesses?: ProfileCustomSettingAccess[];
+    externalDataSourceAccesses?: ProfileExternalDataSourceAccess[];
+    fieldPermissions?: ProfileFieldPermissions[];
+    flowAccesses?: ProfileFlowAccess[];
+    layoutAssignments?: ProfileLayoutAssignment[];
+    loginHours?: ProfileLoginHours;
+    loginIpRanges?: ProfileLoginIpRange[];
+    objectPermissions?: ProfileObjectPermissions[];
+    pageAccesses?: ProfileApexPageAccess[];
+    recordTypeVisibilities?: ProfileRecordTypeVisibility[];
+    tabVisibilities?: ProfileTabVisibility[];
+    userPermissions?: ProfileUserPermission[];
+};
+/**
+ * Permission Set Application Visibility
+ */
+export type PermissionSetApplicationVisibility = {
+    application: string;
+    visible: boolean;
+};
+/**
+ * Profile Application Visibility
+ */
+export type ProfileApplicationVisibility = {
+    application: string;
+    default: boolean;
+    visible: boolean;
+};
+/**
+ * Permission Set Apex Class Access
+ */
+export type PermissionSetApexClassAccess = {
+    apexClass: string;
+    enabled: boolean;
+};
+/**
+ * Profile Apex Class Access
+ */
+export type ProfileApexClassAccess = {
+    apexClass: string;
+    enabled: boolean;
+};
+/**
+ * Permission Set Custom Metadata Type Access
+ */
+export type PermissionSetCustomMetadataTypeAccess = {
+    enabled: boolean;
+    name: string;
+};
+/**
+ * Profile Custom Metadata Type Access
+ */
+export type ProfileCustomMetadataTypeAccess = {
+    enabled: boolean;
+    name: string;
+};
+/**
+ * Permission Set Custom Permissions
+ */
+export type PermissionSetCustomPermissions = {
+    enabled: boolean;
+    name: string;
+};
+/**
+ * Profile Custom Permissions
+ */
+export type ProfileCustomPermissions = {
+    enabled: boolean;
+    name: string;
+};
+/**
+ * Permission Set Custom Setting Access
+ */
+export type PermissionSetCustomSettingAccess = {
+    enabled: boolean;
+    name: string;
+};
+/**
+ * Profile Custom Setting Access
+ */
+export type ProfileCustomSettingAccess = {
+    enabled: boolean;
+    name: string;
+};
+/**
+ * Permission Set External Data Source Access
+ */
+export type PermissionSetExternalDataSourceAccess = {
+    enabled: boolean;
+    externalDataSource: string;
+};
+/**
+ * Profile External Data Source Access
+ */
+export type ProfileExternalDataSourceAccess = {
+    enabled: boolean;
+    externalDataSource: string;
+};
+/**
+ * Permission Set Field Permissions
+ */
+export type PermissionSetFieldPermissions = {
+    editable: boolean;
+    field: string;
+    readable?: boolean;
+};
+/**
+ * Profile Field Permissions
+ */
+export type ProfileFieldPermissions = {
+    editable: boolean;
+    field: string;
+    readable?: boolean;
+};
+/**
+ * Permission Set Flow Access
+ */
+export type PermissionSetFlowAccess = {
+    enabled: boolean;
+    flow: string;
+};
+/**
+ * Profile Flow Access
+ */
+export type ProfileFlowAccess = {
+    enabled: boolean;
+    flow: string;
+};
+/**
+ * Permission Set Object Permissions
+ */
+export type PermissionSetObjectPermissions = {
+    allowCreate: boolean;
+    allowDelete: boolean;
+    allowEdit: boolean;
+    allowRead: boolean;
+    modifyAllRecords: boolean;
+    object: string;
+    viewAllRecords: boolean;
+};
+/**
+ * Profile Object Permissions
+ */
+export type ProfileObjectPermissions = {
+    allowCreate: boolean;
+    allowDelete: boolean;
+    allowEdit: boolean;
+    allowRead: boolean;
+    modifyAllRecords: boolean;
+    object: string;
+    viewAllRecords: boolean;
+};
+/**
+ * Permission Set Apex Page Access
+ */
+export type PermissionSetApexPageAccess = {
+    apexPage: string;
+    enabled: boolean;
+};
+/**
+ * Profile Apex Page Access
+ */
+export type ProfileApexPageAccess = {
+    apexPage: string;
+    enabled: boolean;
+};
+/**
+ * Permission Set Record Type Visibility
+ */
+export type PermissionSetRecordTypeVisibility = {
+    recordType: string;
+    visible: boolean;
+};
+/**
+ * Profile Record Type Visibility
+ */
+export type ProfileRecordTypeVisibility = {
+    default: boolean;
+    personAccountDefault?: boolean;
+    recordType: string;
+    visible: boolean;
+};
+/**
+ * Permission Set Tab Visibility
+ */
+export type PermissionSetTabVisibility = {
+    tab: string;
+    visibility: PermissionSetTabSettingsVisibility;
+};
+/**
+ * Permission Set Tab Settings Visibility
+ */
+export type PermissionSetTabSettingsVisibility = 'Visible' | 'Available' | 'None';
+/**
+ * Profile Tab Visibility
+ */
+export type ProfileTabVisibility = {
+    tab: string;
+    visibility: ProfileTabVisibilityType;
+};
+/**
+ * Profile Tab Visibility Type
+ */
+export type ProfileTabVisibilityType = 'DefaultOn' | 'DefaultOff' | 'Hidden';
+/**
+ * Permission Set User Permission
+ */
+export type PermissionSetUserPermission = {
+    enabled: boolean;
+    name: string;
+};
+/**
+ * Profile User Permission
+ */
+export type ProfileUserPermission = {
+    enabled: boolean;
+    name: string;
+};
+/**
+ * Profile Layout Assignment
+ */
+export type ProfileLayoutAssignment = {
+    layout: string;
+    recordType?: string;
+};
+/**
+ * Profile Login Hours
+ */
+export type ProfileLoginHours = {
+    fridayEnd?: string;
+    fridayStart?: string;
+    mondayEnd?: string;
+    mondayStart?: string;
+    saturdayEnd?: string;
+    saturdayStart?: string;
+    sundayEnd?: string;
+    sundayStart?: string;
+    thursdayEnd?: string;
+    thursdayStart?: string;
+    tuesdayEnd?: string;
+    tuesdayStart?: string;
+    wednesdayEnd?: string;
+    wednesdayStart?: string;
+};
+/**
+ * Profile Login IP Range
+ */
+export type ProfileLoginIpRange = {
+    description?: string;
+    endAddress: string;
+    startAddress: string;
+};

package/lib/types/salesforce/permission.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for Salesforce Permission metadata
+ * Represents PermissionSet and Profile metadata structures
+ */
+export {};
+//# sourceMappingURL=permission.js.map

package/lib/types/salesforce/permission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.js","sourceRoot":"","sources":["../../../src/types/salesforce/permission.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/lib/types/salesforce/resource.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Type definitions for Salesforce Resource metadata
+ * Represents StaticResource, CustomLabel, and related metadata structures
+ */
+/**
+ * Static Resource metadata (.resource-meta.xml)
+ */
+export type StaticResourceMetadata = {
+    cacheControl: StaticResourceCacheControl;
+    contentType: string;
+    description?: string;
+};
+/**
+ * Static Resource Cache Control
+ */
+export type StaticResourceCacheControl = 'Private' | 'Public';
+/**
+ * Custom Labels metadata (CustomLabels.labels-meta.xml)
+ */
+export type CustomLabelsMetadata = {
+    labels: CustomLabel[];
+};
+/**
+ * Custom Label
+ */
+export type CustomLabel = {
+    fullName: string;
+    categories?: string;
+    language: string;
+    protected: boolean;
+    shortDescription: string;
+    value: string;
+};
+/**
+ * Custom Label language codes
+ */
+export type CustomLabelLanguage = 'en_US' | 'de' | 'es' | 'fr' | 'it' | 'ja' | 'sv' | 'ko' | 'zh_TW' | 'zh_CN' | 'pt_BR' | 'nl_NL' | 'da' | 'th' | 'fi' | 'ru' | 'es_MX' | 'no';
+/**
+ * Document metadata (for Document folder)
+ */
+export type DocumentMetadata = {
+    description?: string;
+    internalUseOnly: boolean;
+    keywords?: string;
+    name: string;
+    public: boolean;
+};
+/**
+ * Content Asset metadata
+ */
+export type ContentAssetMetadata = {
+    format?: ContentAssetFormat;
+    isVisibleByExternalUsers?: boolean;
+    language: string;
+    masterLabel: string;
+    relationships?: ContentAssetRelationships;
+    versions?: ContentAssetVersions;
+};
+/**
+ * Content Asset Format
+ */
+export type ContentAssetFormat = 'Original' | 'ZippedVersions';
+/**
+ * Content Asset Relationships
+ */
+export type ContentAssetRelationships = {
+    emailTemplate?: ContentAssetLink[];
+    insightType?: ContentAssetLink[];
+    organization?: ContentAssetLink[];
+    userEmailPreferredPerson?: ContentAssetLink[];
+    workspace?: ContentAssetLink[];
+};
+/**
+ * Content Asset Link
+ */
+export type ContentAssetLink = {
+    cascade?: boolean;
+    name: string;
+};
+/**
+ * Content Asset Versions
+ */
+export type ContentAssetVersions = {
+    version: ContentAssetVersion[];
+};
+/**
+ * Content Asset Version
+ */
+export type ContentAssetVersion = {
+    number: string;
+    pathOnClient: string;
+    zipEntry?: string;
+};

package/lib/types/salesforce/resource.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for Salesforce Resource metadata
+ * Represents StaticResource, CustomLabel, and related metadata structures
+ */
+export {};
+//# sourceMappingURL=resource.js.map

package/lib/types/salesforce/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../../src/types/salesforce/resource.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/lib/types/salesforce/visualforce.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Type definitions for Visualforce metadata
+ * Represents ApexPage and ApexComponent metadata structures
+ */
+import type { PackageVersion } from './common.js';
+/**
+ * Visualforce Page metadata (.page-meta.xml)
+ */
+export type VisualforcePageMetadata = {
+    apiVersion: string;
+    label: string;
+    description?: string;
+    availableInTouch?: boolean;
+    confirmationTokenRequired?: boolean;
+    packageVersions?: PackageVersion[];
+};
+/**
+ * Visualforce Component metadata (.component-meta.xml)
+ */
+export type VisualforceComponentMetadata = {
+    apiVersion: string;
+    label: string;
+    description?: string;
+    packageVersions?: PackageVersion[];
+};
+/**
+ * Visualforce tag types
+ */
+export type VisualforceTagType = 'apex' | 'c' | 'chatter' | 'flow' | 'ideas' | 'knowledge' | 'messaging' | 'site' | 'support' | 'topics';
+/**
+ * Visualforce standard controller
+ */
+export type VisualforceStandardController = string;
+/**
+ * Visualforce attribute
+ */
+export type VisualforceAttribute = {
+    name: string;
+    type: VisualforceAttributeType;
+    required?: boolean;
+    default?: string;
+    description?: string;
+};
+/**
+ * Visualforce attribute type
+ * For SObject types, use the SObject API name directly (e.g., 'Account', 'Contact')
+ */
+export type VisualforceAttributeType = 'String' | 'Boolean' | 'Integer' | 'Double' | 'Date' | 'DateTime' | 'Id' | 'Object' | `${string}__c` | 'Account' | 'Contact' | 'Lead' | 'Opportunity' | 'Case' | 'User' | (string & NonNullable<unknown>);
+/**
+ * Visualforce tag reference
+ */
+export type VisualforceTagReference = {
+    namespace: string;
+    tagName: string;
+    attributes?: Record<string, string>;
+};
+/**
+ * Visualforce controller reference
+ */
+export type VisualforceControllerReference = {
+    type: 'standard' | 'custom' | 'extension';
+    name: string;
+};
+/**
+ * Visualforce action reference
+ */
+export type VisualforceActionReference = {
+    controller: string;
+    method: string;
+};

package/lib/types/salesforce/visualforce.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for Visualforce metadata
+ * Represents ApexPage and ApexComponent metadata structures
+ */
+export {};
+//# sourceMappingURL=visualforce.js.map

package/lib/types/salesforce/visualforce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualforce.js","sourceRoot":"","sources":["../../../src/types/salesforce/visualforce.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/lib/utils/cache-manager.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Cache entry with TTL (Time To Live)
+ */
+export type CacheEntry<T> = {
+    value: T;
+    expiresAt: number;
+    createdAt: number;
+    hits: number;
+};
+/**
+ * Cache statistics for monitoring
+ */
+export type CacheStats = {
+    hits: number;
+    misses: number;
+    hitRate: number;
+    size: number;
+    evictions: number;
+    memorySizeBytes: number;
+};
+/**
+ * Cache configuration
+ */
+export type CacheConfig = {
+    /** Max entries in cache */
+    maxSize: number;
+    /** Time to live in milliseconds */
+    ttlMs: number;
+    /** Enable persistent cache (disk) */
+    enablePersistence: boolean;
+    /** Cache directory for persistent cache */
+    cacheDirectory?: string;
+    /** Enable file locking to prevent concurrent access */
+    enableLocking: boolean;
+};
+/**
+ * Singleton Cache Manager with TTL, persistence, and locking
+ *
+ * **Singleton Pattern**: Ensures only one instance exists per process
+ * **File Locking**: Prevents concurrent access across processes
+ * **Thread-safe**: Safe for concurrent operations within same process
+ *
+ * @example
+ * ```typescript
+ * const cache = CacheManager.getInstance();
+ * await cache.set('key', { data: 'value' });
+ * const value = await cache.get('key');
+ * ```
+ */
+export declare class CacheManager {
+    private static instance;
+    private static lockFilePath;
+    private cache;
+    private config;
+    private stats;
+    private lockFileHandle;
+    /**
+     * Private constructor - use getInstance() instead
+     * Singleton pattern prevents multiple instances
+     */
+    private constructor();
+    /**
+     * Get singleton instance
+     * Thread-safe within same process
+     */
+    static getInstance(config?: Partial<CacheConfig>): CacheManager;
+    /**
+     * Reset singleton (for testing only)
+     */
+    static resetInstance(): void;
+    /**
+     * Acquire file lock to prevent concurrent access across processes
+     *
+     * @param orgAlias - Salesforce org alias to lock
+     * @returns True if lock acquired, false if already locked
+     */
+    acquireLock(orgAlias: string): Promise<boolean>;
+    /**
+     * Release file lock
+     */
+    releaseLock(): Promise<void>;
+    /**
+     * Check if another instance is running for the same org
+     */
+    isLocked(orgAlias: string): Promise<false | {
+        pid: number;
+        timestamp: string;
+        hostname: string;
+    }>;
+    /**
+     * Get value from cache
+     */
+    get<T>(key: string): T | null;
+    /**
+     * Set value in cache with TTL
+     */
+    set<T>(key: string, value: T, ttlMs?: number): Promise<void>;
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Delete specific key
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Clear all cache entries
+     */
+    clear(): Promise<void>;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Load cache from disk
+     */
+    loadFromDisk(): Promise<number>;
+    /**
+     * Clean expired entries (garbage collection)
+     */
+    cleanExpired(): Promise<number>;
+    /**
+     * Get all keys in cache
+     */
+    keys(): string[];
+    /**
+     * Get cache size
+     */
+    size(): number;
+    /**
+     * Update configuration
+     */
+    configure(config: Partial<CacheConfig>): void;
+    /**
+     * Evict oldest entry (LRU-like)
+     */
+    private evictOldest;
+    /**
+     * Update hit rate calculation
+     */
+    private updateHitRate;
+    /**
+     * Estimate memory size
+     */
+    private updateMemorySize;
+    /**
+     * Persist entry to disk
+     */
+    private persistEntry;
+    /**
+     * Delete persisted entry
+     */
+    private deletePersistedEntry;
+}
+/**
+ * Get default cache instance (singleton)
+ */
+export declare function getCacheManager(config?: Partial<CacheConfig>): CacheManager;