@jterrats/smart-deployment 1.0.3

package/lib/types/metadata.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Core Salesforce Metadata Types
+ *
+ * This union defines the most common metadata types (~78).
+ * Salesforce has 100+ types total and adds more each release.
+ *
+ * **Extensibility**: Runtime code handles unknown types via fallback logic.
+ * See: src/constants/deployment-order.ts (priority 99 for unknown types)
+ *
+ * @see https://developer.salesforce.com/docs/metadata-coverage/61
+ */
+export type MetadataType = 'GlobalValueSet' | 'StandardValueSet' | 'CustomLabels' | 'Translations' | 'StandardValueSetTranslation' | 'CustomObject' | 'CustomSetting' | 'DataCategoryGroup' | 'CustomMetadata' | 'CustomMetadataRecord' | 'CustomField' | 'ObjectTranslation' | 'RecordType' | 'BusinessProcess' | 'ValidationRule' | 'WorkflowRule' | 'OrgSettings' | 'CorsWhitelistOrigin' | 'CspTrustedSite' | 'Role' | 'DelegateGroup' | 'Group' | 'CustomPermission' | 'ExternalCredential' | 'NamedCredential' | 'DataSourceObject' | 'StaticResource' | 'Document' | 'ContentAsset' | 'EmailTemplate' | 'ApexClass' | 'VisualforceComponent' | 'VisualforcePage' | 'LightningComponentBundle' | 'AuraDefinitionBundle' | 'ApexTrigger' | 'ServicePresenceStatus' | 'PresenceUserConfig' | 'Queue' | 'ServiceChannel' | 'QueueRoutingConfig' | 'ChannelLayout' | 'MilestoneType' | 'EntitlementProcess' | 'GenAiFunction' | 'GenAiPromptTemplate' | 'GenAiPlannerBundle' | 'Flow' | 'PathAssistant' | 'Layout' | 'Bot' | 'BotVersion' | 'GenAiPlugin' | 'FlexiPage' | 'QuickAction' | 'CompactLayout' | 'ListView' | 'WebLink' | 'LightningApp' | 'SearchCustomization' | 'CustomNotificationType' | 'BrandingSet' | 'DigitalExperienceConfig' | 'Site' | 'DigitalExperience' | 'NetworkBranding' | 'Network' | 'EmbeddedServiceConfig' | 'MessagingChannel' | 'OmniSupervisorConfig' | 'SharingRules' | 'PermissionSet' | 'MutingPermissionSet' | 'PermissionSetGroup' | 'Profile' | 'ApexTestSuite' | 'DataPackageKitDefinition' | 'DataPackageKitObject';
+/**
+ * Base interface for all metadata components
+ */
+export type MetadataComponent = {
+    /** Component name (e.g., "SC_Account_Service") */
+    name: string;
+    /** Metadata type */
+    type: MetadataType;
+    /** File path relative to project root */
+    filePath: string;
+    /** Set of dependencies (node IDs: "Type:Name") */
+    dependencies: Set<string>;
+    /** Set of dependents (node IDs) */
+    dependents: Set<string>;
+    /** Priority boost for heuristics (negative = deploy earlier) */
+    priorityBoost: number;
+};
+/**
+ * Specialized metadata types
+ */
+export type ApexClass = MetadataComponent & {
+    type: 'ApexClass';
+    isTest: boolean;
+    isUtility: boolean;
+    isHandler: boolean;
+    isService: boolean;
+    isIntegration: boolean;
+};
+export type ApexTrigger = MetadataComponent & {
+    type: 'ApexTrigger';
+    sobject: string;
+    handlerClass?: string;
+};
+export type Flow = MetadataComponent & {
+    type: 'Flow';
+    referencedApexClasses: string[];
+    referencedPromptTemplates: string[];
+    referencedFlows: string[];
+};
+export type LightningComponentBundle = MetadataComponent & {
+    type: 'LightningComponentBundle';
+    referencedApexClasses: string[];
+    referencedLwcs: string[];
+    referencedSobjects: string[];
+};
+export type PermissionSet = MetadataComponent & {
+    type: 'PermissionSet';
+    apexClasses: string[];
+    flows: string[];
+    customObjects: string[];
+    customPermissions: string[];
+};
+export type CustomObject = MetadataComponent & {
+    type: 'CustomObject';
+    isCustomMetadataType: boolean;
+};
+export type CustomMetadataRecord = MetadataComponent & {
+    type: 'CustomMetadataRecord';
+    metadataTypeName: string;
+};
+/**
+ * Archivo de metadata físico en el proyecto
+ */
+export type ComponentFile = {
+    /** Path absoluto al archivo */
+    path: string;
+    /** Nombre del archivo */
+    fileName: string;
+    /** Tipo de metadata inferido del path */
+    metadataType: MetadataType;
+    /** Contenido del archivo (puede ser lazy-loaded) */
+    content?: string;
+};
+/**
+ * Resultado del parsing de un componente
+ */
+export type ParseResult<T extends MetadataComponent> = {
+    component: T;
+    errors: ParseError[];
+};
+/**
+ * Error durante el parsing
+ */
+export type ParseError = {
+    file: string;
+    message: string;
+    severity: 'warning' | 'error';
+    line?: number;
+};

package/lib/types/metadata.js

@@ -0,0 +1,13 @@
+/**
+ * Core Salesforce Metadata Types
+ *
+ * This union defines the most common metadata types (~78).
+ * Salesforce has 100+ types total and adds more each release.
+ *
+ * **Extensibility**: Runtime code handles unknown types via fallback logic.
+ * See: src/constants/deployment-order.ts (priority 99 for unknown types)
+ *
+ * @see https://developer.salesforce.com/docs/metadata-coverage/61
+ */
+export {};
+//# sourceMappingURL=metadata.js.map

package/lib/types/metadata.js.map

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

package/lib/types/project.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Salesforce Project Structure Type Definitions
+ * Soporte para cualquier estructura de proyecto
+ */
+/**
+ * Definición de proyecto Salesforce (sfdx-project.json)
+ */
+export type SfdxProject = {
+    /** Versión del archivo de configuración */
+    sourceApiVersion: string;
+    /** Paths de packages */
+    packageDirectories: PackageDirectory[];
+    /** Namespace (opcional) */
+    namespace?: string;
+    /** Configuración de plugins */
+    plugins?: Record<string, unknown>;
+    /** Paths a incluir */
+    sourcePaths?: string[];
+};
+/**
+ * Directorio de package
+ */
+export type PackageDirectory = {
+    /** Path relativo al proyecto */
+    path: string;
+    /** Si es el package por defecto */
+    default?: boolean;
+    /** Nombre del package */
+    package?: string;
+    /** Versión del package */
+    versionName?: string;
+    /** Número de versión */
+    versionNumber?: string;
+    /** Dependencies */
+    dependencies?: PackageDependency[];
+};
+/**
+ * Dependencia de package
+ */
+export type PackageDependency = {
+    /** Nombre del package */
+    package: string;
+    /** Número de versión */
+    versionNumber?: string;
+};
+/**
+ * Estructura de proyecto detectada
+ */
+export type ProjectStructure = {
+    /** Tipo de estructura */
+    type: ProjectStructureType;
+    /** Path raíz del proyecto */
+    rootPath: string;
+    /** Paths donde se encuentra metadata */
+    metadataPaths: string[];
+    /** Formato de metadata */
+    format: MetadataFormat;
+    /** Packages detectados */
+    packages: DetectedPackage[];
+    /** Versión de API */
+    apiVersion: string;
+};
+/**
+ * Tipos de estructura de proyecto
+ */
+export type ProjectStructureType = 'sfdx-standard' | 'sfdx-multi-package' | 'metadata-api' | 'modular' | 'monorepo' | 'unknown';
+/**
+ * Formato de metadata
+ */
+export type MetadataFormat = 'source' | 'metadata' | 'mixed';
+/**
+ * Package detectado
+ */
+export type DetectedPackage = {
+    /** Nombre del package */
+    name: string;
+    /** Path al package */
+    path: string;
+    /** Es el package por defecto */
+    isDefault: boolean;
+    /** Tipo de package */
+    type: PackageType;
+    /** Subdirectorios de metadata */
+    metadataDirectories: string[];
+};
+/**
+ * Tipo de package
+ */
+export type PackageType = 'unlocked' | 'managed' | 'unmanaged' | 'source';
+/**
+ * Opciones de escaneo de proyecto
+ */
+export type ProjectScanOptions = {
+    /** Paths a incluir (override de sfdx-project.json) */
+    includePaths?: string[];
+    /** Paths a excluir */
+    excludePaths?: string[];
+    /** Seguir .forceignore */
+    respectForceignore?: boolean;
+    /** Escanear recursivamente */
+    recursive?: boolean;
+    /** Profundidad máxima de recursión */
+    maxDepth?: number;
+    /** Detectar packages automáticamente */
+    autoDetectPackages?: boolean;
+};
+/**
+ * Resultado del escaneo de proyecto
+ */
+export type ProjectScanResult = {
+    /** Estructura detectada */
+    structure: ProjectStructure;
+    /** Archivos de metadata encontrados */
+    metadataFiles: string[];
+    /** Estadísticas */
+    stats: ProjectStats;
+    /** Warnings */
+    warnings: string[];
+};
+/**
+ * Estadísticas del proyecto
+ */
+export type ProjectStats = {
+    /** Total de archivos de metadata */
+    totalFiles: number;
+    /** Archivos por tipo */
+    filesByType: Record<string, number>;
+    /** Tamaño total (bytes) */
+    totalSize: number;
+    /** Packages encontrados */
+    packagesFound: number;
+    /** Tiempo de escaneo (ms) */
+    scanTime: number;
+};
+/**
+ * Patrón de metadata
+ * Define cómo identificar cada tipo de metadata
+ */
+export type MetadataPattern = {
+    /** Tipo de metadata */
+    type: string;
+    /** Patrón de directorio (glob) */
+    directoryPattern: string;
+    /** Patrón de archivo (glob) */
+    filePattern: string;
+    /** Extensión de archivo */
+    fileExtension: string;
+    /** Formato (source o metadata) */
+    format: 'source' | 'metadata' | 'both';
+    /** Requiere directorio contenedor */
+    requiresContainer?: boolean;
+};
+/**
+ * Patrones de metadata conocidos
+ */
+export declare const METADATA_PATTERNS: MetadataPattern[];

package/lib/types/project.js

@@ -0,0 +1,56 @@
+/**
+ * Salesforce Project Structure Type Definitions
+ * Soporte para cualquier estructura de proyecto
+ */
+/**
+ * Patrones de metadata conocidos
+ */
+export const METADATA_PATTERNS = [
+    {
+        type: 'ApexClass',
+        directoryPattern: '**/classes',
+        filePattern: '*.cls',
+        fileExtension: '.cls',
+        format: 'both',
+    },
+    {
+        type: 'ApexTrigger',
+        directoryPattern: '**/triggers',
+        filePattern: '*.trigger',
+        fileExtension: '.trigger',
+        format: 'both',
+    },
+    {
+        type: 'LightningComponentBundle',
+        directoryPattern: '**/lwc/*',
+        filePattern: '*.js',
+        fileExtension: '.js',
+        format: 'source',
+        requiresContainer: true,
+    },
+    {
+        type: 'AuraDefinitionBundle',
+        directoryPattern: '**/aura/*',
+        filePattern: '*.cmp',
+        fileExtension: '.cmp',
+        format: 'source',
+        requiresContainer: true,
+    },
+    {
+        type: 'Flow',
+        directoryPattern: '**/flows',
+        filePattern: '*.flow-meta.xml',
+        fileExtension: '.flow-meta.xml',
+        format: 'both',
+    },
+    {
+        type: 'CustomObject',
+        directoryPattern: '**/objects/*',
+        filePattern: '*.object-meta.xml',
+        fileExtension: '.object-meta.xml',
+        format: 'source',
+        requiresContainer: true,
+    },
+    // ... más patrones
+];
+//# sourceMappingURL=project.js.map

package/lib/types/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/types/project.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA+KH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD;QACE,IAAI,EAAE,WAAW;QACjB,gBAAgB,EAAE,YAAY;QAC9B,WAAW,EAAE,OAAO;QACpB,aAAa,EAAE,MAAM;QACrB,MAAM,EAAE,MAAM;KACf;IACD;QACE,IAAI,EAAE,aAAa;QACnB,gBAAgB,EAAE,aAAa;QAC/B,WAAW,EAAE,WAAW;QACxB,aAAa,EAAE,UAAU;QACzB,MAAM,EAAE,MAAM;KACf;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,gBAAgB,EAAE,UAAU;QAC5B,WAAW,EAAE,MAAM;QACnB,aAAa,EAAE,KAAK;QACpB,MAAM,EAAE,QAAQ;QAChB,iBAAiB,EAAE,IAAI;KACxB;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,gBAAgB,EAAE,WAAW;QAC7B,WAAW,EAAE,OAAO;QACpB,aAAa,EAAE,MAAM;QACrB,MAAM,EAAE,QAAQ;QAChB,iBAAiB,EAAE,IAAI;KACxB;IACD;QACE,IAAI,EAAE,MAAM;QACZ,gBAAgB,EAAE,UAAU;QAC5B,WAAW,EAAE,iBAAiB;QAC9B,aAAa,EAAE,gBAAgB;QAC/B,MAAM,EAAE,MAAM;KACf;IACD;QACE,IAAI,EAAE,cAAc;QACpB,gBAAgB,EAAE,cAAc;QAChC,WAAW,EAAE,mBAAmB;QAChC,aAAa,EAAE,kBAAkB;QACjC,MAAM,EAAE,QAAQ;QAChB,iBAAiB,EAAE,IAAI;KACxB;IACD,mBAAmB;CACpB,CAAC"}

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

@@ -0,0 +1,94 @@
+/**
+ * Type definitions for Salesforce Apex metadata
+ * Represents ApexClass and ApexTrigger metadata structures
+ */
+import type { PackageVersion } from './common.js';
+/**
+ * Apex Class metadata (ApexClass.cls-meta.xml)
+ */
+export type ApexClassMetadata = {
+    apiVersion: string;
+    status: ApexStatus;
+    packageVersions?: PackageVersion[];
+};
+/**
+ * Apex Trigger metadata (ApexTrigger.trigger-meta.xml)
+ */
+export type ApexTriggerMetadata = {
+    apiVersion: string;
+    status: ApexStatus;
+    packageVersions?: PackageVersion[];
+};
+/**
+ * Apex status values
+ */
+export type ApexStatus = 'Active' | 'Inactive' | 'Deleted';
+/**
+ * Apex sharing mode
+ */
+export type ApexSharingMode = 'with sharing' | 'without sharing' | 'inherited sharing';
+/**
+ * Apex access modifier
+ */
+export type ApexAccessModifier = 'public' | 'global' | 'private' | 'protected';
+/**
+ * Apex annotation
+ */
+export type ApexAnnotation = {
+    name: string;
+    parameters?: Record<string, string | number | boolean>;
+};
+/**
+ * Apex method signature
+ */
+export type ApexMethodSignature = {
+    name: string;
+    returnType: string;
+    parameters: ApexParameter[];
+    accessModifier: ApexAccessModifier;
+    isStatic: boolean;
+    isTestMethod: boolean;
+    annotations: ApexAnnotation[];
+};
+/**
+ * Apex parameter
+ */
+export type ApexParameter = {
+    name: string;
+    type: string;
+};
+/**
+ * Apex property
+ */
+export type ApexProperty = {
+    name: string;
+    type: string;
+    accessModifier: ApexAccessModifier;
+    isStatic: boolean;
+    hasGetter: boolean;
+    hasSetter: boolean;
+};
+/**
+ * Apex inner class
+ */
+export type ApexInnerClass = {
+    name: string;
+    accessModifier: ApexAccessModifier;
+    isVirtual: boolean;
+    isAbstract: boolean;
+    extends?: string;
+    implements: string[];
+};
+/**
+ * Apex trigger event
+ */
+export type ApexTriggerEvent = 'before insert' | 'before update' | 'before delete' | 'after insert' | 'after update' | 'after delete' | 'after undelete';
+/**
+ * Apex trigger metadata structure
+ */
+export type ApexTriggerInfo = {
+    name: string;
+    objectName: string;
+    events: ApexTriggerEvent[];
+    isActive: boolean;
+};

package/lib/types/salesforce/apex.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for Salesforce Apex metadata
+ * Represents ApexClass and ApexTrigger metadata structures
+ */
+export {};
+//# sourceMappingURL=apex.js.map

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

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

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

@@ -0,0 +1,150 @@
+/**
+ * Type definitions for Aura Component Framework metadata
+ * Represents AuraDefinitionBundle metadata structures
+ */
+/**
+ * Aura component metadata (.cmp, .app, .evt, .intf)
+ */
+export type AuraComponentMetadata = {
+    apiVersion?: string;
+    description?: string;
+    access?: AuraAccess;
+    controller?: string;
+    design?: string;
+    documentation?: string;
+    helper?: string;
+    renderer?: string;
+    style?: string;
+    svg?: string;
+};
+/**
+ * Aura access level
+ */
+export type AuraAccess = 'GLOBAL' | 'PUBLIC' | 'PRIVATE' | 'INTERNAL';
+/**
+ * Aura component type
+ */
+export type AuraComponentType = 'component' | 'application' | 'event' | 'interface';
+/**
+ * Aura event type
+ */
+export type AuraEventType = 'APPLICATION' | 'COMPONENT';
+/**
+ * Aura attribute
+ */
+export type AuraAttribute = {
+    name: string;
+    type: AuraAttributeType;
+    required?: boolean;
+    default?: string;
+    description?: string;
+    access?: AuraAccess;
+};
+/**
+ * Aura attribute type
+ * For SObject types, use the SObject API name directly (e.g., 'Account', 'Contact')
+ */
+export type AuraAttributeType = 'String' | 'Integer' | 'Long' | 'Double' | 'Decimal' | 'Boolean' | 'Date' | 'DateTime' | 'Object' | 'Function' | 'List' | 'Set' | 'Map' | 'Aura.Component' | 'Aura.Component[]' | `${string}__c` | 'Account' | 'Contact' | 'Lead' | 'Opportunity' | 'Case' | 'User' | (string & NonNullable<unknown>);
+/**
+ * Aura handler
+ */
+export type AuraHandler = {
+    name?: string;
+    event?: string;
+    action: string;
+    value?: string;
+    phase?: 'capture' | 'bubble';
+};
+/**
+ * Aura method
+ */
+export type AuraMethod = {
+    name: string;
+    action: string;
+    description?: string;
+    access?: AuraAccess;
+    parameters?: AuraMethodParameter[];
+};
+/**
+ * Aura method parameter
+ */
+export type AuraMethodParameter = {
+    name: string;
+    type: AuraAttributeType;
+    description?: string;
+    required?: boolean;
+};
+/**
+ * Aura interface
+ */
+export type AuraInterface = {
+    name: string;
+    namespace?: string;
+    attributes?: AuraAttribute[];
+    methods?: AuraMethod[];
+};
+/**
+ * Aura extends relationship
+ */
+export type AuraExtends = {
+    componentName: string;
+    namespace?: string;
+};
+/**
+ * Aura implements relationship
+ */
+export type AuraImplements = {
+    interfaces: string[];
+};
+/**
+ * Aura design attribute
+ */
+export type AuraDesignAttribute = {
+    name: string;
+    label?: string;
+    description?: string;
+    required?: boolean;
+    default?: string;
+    placeholder?: string;
+    min?: number;
+    max?: number;
+    datasource?: string;
+};
+/**
+ * Aura design template
+ */
+export type AuraDesignTemplate = {
+    name: string;
+    label?: string;
+};
+/**
+ * Aura SVG resource
+ */
+export type AuraSVGResource = {
+    width?: number;
+    height?: number;
+    viewBox?: string;
+};
+/**
+ * Aura dependency
+ */
+export type AuraDependencyInfo = {
+    resource: string;
+    type: AuraDependencyType;
+    namespace?: string;
+};
+/**
+ * Aura dependency type
+ */
+export type AuraDependencyType = 'apex_controller' | 'child_component' | 'event' | 'interface' | 'extends' | 'helper';
+/**
+ * Aura token
+ */
+export type AuraToken = {
+    name: string;
+    value: string;
+};
+/**
+ * Aura lightning component interface
+ */
+export type AuraLightningInterface = 'flexipage:availableForAllPageTypes' | 'flexipage:availableForRecordHome' | 'force:appHostable' | 'force:hasRecordId' | 'force:hasSObjectName' | 'force:lightningQuickAction' | 'force:lightningQuickActionWithoutHeader' | 'forceCommunity:availableForAllPageTypes' | 'ltng:allowGuestAccess';

package/lib/types/salesforce/aura.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for Aura Component Framework metadata
+ * Represents AuraDefinitionBundle metadata structures
+ */
+export {};
+//# sourceMappingURL=aura.js.map

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

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