@khester/create-dynamics-app 1.0.8 → 1.1.0

package/templates/dynamics-365-starter/src/components/Logging/logger.ts

@@ -0,0 +1,193 @@
+/**
+ * Logger function type definition
+ */
+export type LoggerFunction = (message: string, source?: string) => void;
+
+/**
+ * Centralized logger utility class
+ * Provides a singleton logger that can be configured to use different output methods
+ */
+export class Logger {
+  private static loggerFunction: LoggerFunction | null = null;
+
+  /**
+   * Set the logger function to be used for all logging operations
+   * @param loggerFn The function to use for logging
+   */
+  public static setLoggerFunction(loggerFn: LoggerFunction): void {
+    this.loggerFunction = loggerFn;
+  }
+
+  /**
+   * Log a message with optional source information
+   * @param message The message to log
+   * @param source Optional source identifier (e.g., component name, method name)
+   */
+  public static log(message: string, source?: string): void {
+    if (this.loggerFunction) {
+      // Use the configured logger function (typically from LoggingContext)
+      this.loggerFunction(message, source);
+    } else {
+      // Fallback to console.log with formatted output
+      const timestamp = new Date().toISOString();
+      const sourceText = source ? ` [${source}]` : '';
+      console.log(`${timestamp}${sourceText}: ${message}`);
+    }
+  }
+
+  /**
+   * Log an error message with optional source information
+   * @param message The error message to log
+   * @param source Optional source identifier
+   * @param error Optional error object for additional details
+   */
+  public static error(message: string, source?: string, error?: any): void {
+    let errorMessage = `ERROR: ${message}`;
+
+    if (error) {
+      if (error instanceof Error) {
+        errorMessage += ` - ${error.message}`;
+        if (error.stack) {
+          errorMessage += `\nStack: ${error.stack}`;
+        }
+      } else {
+        errorMessage += ` - ${JSON.stringify(error, null, 2)}`;
+      }
+    }
+
+    this.log(errorMessage, source);
+  }
+
+  /**
+   * Log a warning message with optional source information
+   * @param message The warning message to log
+   * @param source Optional source identifier
+   */
+  public static warn(message: string, source?: string): void {
+    this.log(`WARNING: ${message}`, source);
+  }
+
+  /**
+   * Log debug information (only in development)
+   * @param message The debug message to log
+   * @param source Optional source identifier
+   * @param data Optional data object to include
+   */
+  public static debug(message: string, source?: string, data?: any): void {
+    // Only log debug messages in development environment
+    if (process.env.NODE_ENV === 'development') {
+      let debugMessage = `DEBUG: ${message}`;
+
+      if (data) {
+        debugMessage += `\nData: ${JSON.stringify(data, null, 2)}`;
+      }
+
+      this.log(debugMessage, source);
+    }
+  }
+
+  /**
+   * Log information about API operations
+   * @param operation The API operation being performed
+   * @param entity The entity being operated on
+   * @param data Optional data related to the operation
+   * @param source Optional source identifier
+   */
+  public static apiOperation(
+    operation: 'CREATE' | 'READ' | 'UPDATE' | 'DELETE' | 'QUERY',
+    entity: string,
+    data?: any,
+    source?: string
+  ): void {
+    let message = `API ${operation}: ${entity}`;
+
+    if (data) {
+      if (operation === 'QUERY') {
+        message += `\nQuery: ${data}`;
+      } else if (operation === 'CREATE' || operation === 'UPDATE') {
+        message += `\nData: ${JSON.stringify(data, null, 2)}`;
+      } else if (operation === 'READ' && data.id) {
+        message += `\nID: ${data.id}`;
+      }
+    }
+
+    this.log(message, source || 'API');
+  }
+
+  /**
+   * Log FetchXML queries for debugging
+   * @param fetchXml The FetchXML query
+   * @param source Optional source identifier
+   */
+  public static fetchXml(fetchXml: string, source?: string): void {
+    this.log(`FetchXML Query:\n${fetchXml}`, source || 'FetchXML');
+  }
+
+  /**
+   * Log timing information for performance monitoring
+   * @param operation The operation being timed
+   * @param startTime The start time (from performance.now())
+   * @param source Optional source identifier
+   */
+  public static timing(
+    operation: string,
+    startTime: number,
+    source?: string
+  ): void {
+    const duration = performance.now() - startTime;
+    this.log(
+      `TIMING: ${operation} completed in ${duration.toFixed(2)}ms`,
+      source || 'Performance'
+    );
+  }
+
+  /**
+   * Log validation errors
+   * @param entity The entity being validated
+   * @param errors Array of validation error messages
+   * @param source Optional source identifier
+   */
+  public static validation(
+    entity: string,
+    errors: string[],
+    source?: string
+  ): void {
+    const message = `VALIDATION ERRORS for ${entity}:\n${errors.map((error) => `- ${error}`).join('\n')}`;
+    this.error(message, source || 'Validation');
+  }
+
+  /**
+   * Log user interactions for audit trail
+   * @param action The user action performed
+   * @param details Optional details about the action
+   * @param source Optional source identifier
+   */
+  public static userAction(
+    action: string,
+    details?: any,
+    source?: string
+  ): void {
+    let message = `USER ACTION: ${action}`;
+
+    if (details) {
+      message += `\nDetails: ${JSON.stringify(details, null, 2)}`;
+    }
+
+    this.log(message, source || 'UserAction');
+  }
+
+  /**
+   * Clear the configured logger function (revert to console.log)
+   */
+  public static clearLoggerFunction(): void {
+    this.loggerFunction = null;
+  }
+
+  /**
+   * Check if a custom logger function is configured
+   * @returns True if a custom logger is set, false if using console.log fallback
+   */
+  public static hasCustomLogger(): boolean {
+    return this.loggerFunction !== null;
+  }
+}

package/templates/dynamics-365-starter/src/constants/account.ts

@@ -0,0 +1,410 @@
+/**
+ * Account entity constants for Dynamics 365.
+ * Contains entity names and field definitions with metadata.
+ */
+export class AccountConstants {
+  /** Entity name for single account */
+  public static readonly EntityName: string = 'account';
+
+  /** Entity collection name for multiple accounts */
+  public static readonly EntityCollectionName: string = 'accounts';
+
+  /** Type: Guid, Primary key for Account records */
+  public static readonly PrimaryKey: string = 'accountid';
+
+  /** Type: String, RequiredLevel: ApplicationRequired, MaxLength: 160, Format: Text */
+  public static readonly PrimaryName: string = 'name';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: 0, MaxValue: 1000000000 */
+  public static readonly AccountCategoryCode: string = 'accountcategorycode';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: 0, MaxValue: 1000000000 */
+  public static readonly AccountClassificationCode: string =
+    'accountclassificationcode';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 20, Format: Text */
+  public static readonly AccountNumber: string = 'accountnumber';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: 0, MaxValue: 1000000000 */
+  public static readonly AccountRatingCode: string = 'accountratingcode';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 250, Format: Text */
+  public static readonly Address1_AddressTypeCode: string =
+    'address1_addresstypecode';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 80, Format: Text */
+  public static readonly Address1_City: string = 'address1_city';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 80, Format: Text */
+  public static readonly Address1_Country: string = 'address1_country';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 50, Format: Text */
+  public static readonly Address1_County: string = 'address1_county';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 50, Format: Text */
+  public static readonly Address1_Fax: string = 'address1_fax';
+
+  /** Type: Double, RequiredLevel: None, MinValue: -90, MaxValue: 90 */
+  public static readonly Address1_Latitude: string = 'address1_latitude';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 250, Format: Text */
+  public static readonly Address1_Line1: string = 'address1_line1';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 250, Format: Text */
+  public static readonly Address1_Line2: string = 'address1_line2';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 250, Format: Text */
+  public static readonly Address1_Line3: string = 'address1_line3';
+
+  /** Type: Double, RequiredLevel: None, MinValue: -180, MaxValue: 180 */
+  public static readonly Address1_Longitude: string = 'address1_longitude';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 200, Format: Text */
+  public static readonly Address1_Name: string = 'address1_name';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 20, Format: Text */
+  public static readonly Address1_PostalCode: string = 'address1_postalcode';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 100, Format: Text */
+  public static readonly Address1_PostOfficeBox: string =
+    'address1_postofficebox';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 100, Format: Text */
+  public static readonly Address1_PrimaryContactName: string =
+    'address1_primarycontactname';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: 0, MaxValue: 1000000000 */
+  public static readonly Address1_ShippingMethodCode: string =
+    'address1_shippingmethodcode';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 50, Format: Text */
+  public static readonly Address1_StateOrProvince: string =
+    'address1_stateorprovince';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 50, Format: Text */
+  public static readonly Address1_Telephone1: string = 'address1_telephone1';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 50, Format: Text */
+  public static readonly Address1_Telephone2: string = 'address1_telephone2';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 50, Format: Text */
+  public static readonly Address1_Telephone3: string = 'address1_telephone3';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 4, Format: Text */
+  public static readonly Address1_UPSZone: string = 'address1_upszone';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: -2147483648, MaxValue: 2147483647 */
+  public static readonly Address1_UTCOffset: string = 'address1_utcoffset';
+
+  /** Type: Money, RequiredLevel: None, MinValue: 0, MaxValue: 1000000000000 */
+  public static readonly CreditLimit: string = 'creditlimit';
+
+  /** Type: Boolean, RequiredLevel: None */
+  public static readonly CreditOnHold: string = 'creditonhold';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: 0, MaxValue: 1000000000 */
+  public static readonly CustomerSizeCode: string = 'customersizecode';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: 0, MaxValue: 1000000000 */
+  public static readonly CustomerTypeCode: string = 'customertypecode';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 2000, Format: TextArea */
+  public static readonly Description: string = 'description';
+
+  /** Type: Boolean, RequiredLevel: None */
+  public static readonly DoNotBulkEMail: string = 'donotbulkemail';
+
+  /** Type: Boolean, RequiredLevel: None */
+  public static readonly DoNotEMail: string = 'donotemail';
+
+  /** Type: Boolean, RequiredLevel: None */
+  public static readonly DoNotFax: string = 'donotfax';
+
+  /** Type: Boolean, RequiredLevel: None */
+  public static readonly DoNotPhone: string = 'donotphone';
+
+  /** Type: Boolean, RequiredLevel: None */
+  public static readonly DoNotPostalMail: string = 'donotpostalmail';
+
+  /** Type: Boolean, RequiredLevel: None */
+  public static readonly DoNotSendMM: string = 'donotsendmm';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 100, Format: Email */
+  public static readonly EMailAddress1: string = 'emailaddress1';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 100, Format: Email */
+  public static readonly EMailAddress2: string = 'emailaddress2';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 100, Format: Email */
+  public static readonly EMailAddress3: string = 'emailaddress3';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 50, Format: Text */
+  public static readonly Fax: string = 'fax';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 200, Format: Text */
+  public static readonly FtpSiteURL: string = 'ftpsiteurl';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: 0, MaxValue: 1000000000 */
+  public static readonly IndustryCode: string = 'industrycode';
+
+  /** Type: DateTime, RequiredLevel: None, Format: DateOnly */
+  public static readonly LastUsedInCampaign: string = 'lastusedincampaign';
+
+  /** Type: Money, RequiredLevel: None, MinValue: 0, MaxValue: 100000000000000 */
+  public static readonly MarketCap: string = 'marketcap';
+
+  /** Type: Boolean, RequiredLevel: None */
+  public static readonly MarketingOnly: string = 'marketingonly';
+
+  /** Type: Guid, RequiredLevel: None */
+  public static readonly MasterId: string = 'masterid';
+
+  /** Type: Boolean, RequiredLevel: None */
+  public static readonly Merged: string = 'merged';
+
+  /** Type: Guid, RequiredLevel: SystemRequired */
+  public static readonly ModifiedBy: string = 'modifiedby';
+
+  /** Type: DateTime, RequiredLevel: None, Format: DateAndTime */
+  public static readonly ModifiedOn: string = 'modifiedon';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: -2147483648, MaxValue: 2147483647 */
+  public static readonly NumberOfEmployees: string = 'numberofemployees';
+
+  /** Type: Guid, RequiredLevel: ApplicationRequired */
+  public static readonly OwnerId: string = 'ownerid';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: 0, MaxValue: 1000000000 */
+  public static readonly OwnershipCode: string = 'ownershipcode';
+
+  /** Type: Guid, RequiredLevel: None */
+  public static readonly ParentAccountId: string = 'parentaccountid';
+
+  /** Type: Boolean, RequiredLevel: None */
+  public static readonly ParticipatesInWorkflow: string =
+    'participatesinworkflow';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: 0, MaxValue: 5 */
+  public static readonly PaymentTermsCode: string = 'paymenttermscode';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: 0, MaxValue: 1000000000 */
+  public static readonly PreferredAppointmentDayCode: string =
+    'preferredappointmentdaycode';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: 0, MaxValue: 1000000000 */
+  public static readonly PreferredAppointmentTimeCode: string =
+    'preferredappointmenttimecode';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: 0, MaxValue: 1000000000 */
+  public static readonly PreferredContactMethodCode: string =
+    'preferredcontactmethodcode';
+
+  /** Type: Guid, RequiredLevel: None */
+  public static readonly PreferredSystemUserId: string =
+    'preferredsystemuserid';
+
+  /** Type: Guid, RequiredLevel: None */
+  public static readonly PrimaryContactId: string = 'primarycontactid';
+
+  /** Type: Money, RequiredLevel: None, MinValue: -922337203685477, MaxValue: 922337203685477 */
+  public static readonly Revenue: string = 'revenue';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: 0, MaxValue: 1 */
+  public static readonly SharesOutstanding: string = 'sharesoutstanding';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: 0, MaxValue: 1000000000 */
+  public static readonly ShippingMethodCode: string = 'shippingmethodcode';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 10, Format: Text */
+  public static readonly SIC: string = 'sic';
+
+  /** Type: Guid, RequiredLevel: None */
+  public static readonly SLAId: string = 'slaid';
+
+  /** Type: State, RequiredLevel: SystemRequired */
+  public static readonly StateCode: string = 'statecode';
+
+  /** Type: Status, RequiredLevel: None */
+  public static readonly StatusCode: string = 'statuscode';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 100, Format: Text */
+  public static readonly StockExchange: string = 'stockexchange';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 50, Format: Text */
+  public static readonly Telephone1: string = 'telephone1';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 50, Format: Text */
+  public static readonly Telephone2: string = 'telephone2';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 50, Format: Text */
+  public static readonly Telephone3: string = 'telephone3';
+
+  /** Type: Integer, RequiredLevel: None, MinValue: 0, MaxValue: 1000000000 */
+  public static readonly TerritoryCode: string = 'territorycode';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 10, Format: Text */
+  public static readonly TickerSymbol: string = 'tickersymbol';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 2083, Format: Url */
+  public static readonly WebSiteURL: string = 'websiteurl';
+
+  /** Type: String, RequiredLevel: None, MaxLength: 200, Format: Text */
+  public static readonly YomiName: string = 'yominame';
+
+  /** Type: Guid, RequiredLevel: SystemRequired */
+  public static readonly CreatedBy: string = 'createdby';
+
+  /** Type: DateTime, RequiredLevel: None, Format: DateAndTime */
+  public static readonly CreatedOn: string = 'createdon';
+
+  /** Type: Guid, RequiredLevel: None */
+  public static readonly TransactionCurrencyId: string =
+    'transactioncurrencyid';
+}
+
+/**
+ * Account Category Code OptionSet
+ */
+export enum AccountCategoryCode_OptionSet {
+  PreferredCustomer = 1,
+  Standard = 2,
+}
+
+/**
+ * Account Classification Code OptionSet
+ */
+export enum AccountClassificationCode_OptionSet {
+  DefaultValue = 1,
+}
+
+/**
+ * Account Rating Code OptionSet
+ */
+export enum AccountRatingCode_OptionSet {
+  DefaultValue = 1,
+}
+
+/**
+ * Customer Size Code OptionSet
+ */
+export enum CustomerSizeCode_OptionSet {
+  DefaultValue = 1,
+}
+
+/**
+ * Customer Type Code OptionSet
+ */
+export enum CustomerTypeCode_OptionSet {
+  Competitor = 1,
+  Consultant = 2,
+  Customer = 3,
+  Investor = 4,
+  Partner = 5,
+  Influencer = 6,
+  Press = 7,
+  Prospect = 8,
+  Reseller = 9,
+  Supplier = 10,
+  Vendor = 11,
+  Other = 12,
+}
+
+/**
+ * Industry Code OptionSet
+ */
+export enum IndustryCode_OptionSet {
+  Accounting = 1,
+  AgricultureAndNonPetrolNaturalResourceExtraction = 2,
+  BroadcastingPrintingAndPublishing = 3,
+  Brokers = 4,
+  BuildingSupplyRetail = 5,
+  BusinessServices = 6,
+  Consulting = 7,
+  ConsumerServices = 8,
+  DesignDirectionAndCreativeManagement = 9,
+  DistributorsDispatchersAndProcessors = 10,
+  DoctorsOfficesAndClinics = 11,
+  DurableManufacturing = 12,
+  EatingAndDrinkingPlaces = 13,
+  EntertainmentRetail = 14,
+  EquipmentRentalAndLeasing = 15,
+  Financial = 16,
+  FoodAndTobaccoProcessing = 17,
+  InboundCapitalIntensiveProcessing = 18,
+  InboundRepairAndServices = 19,
+  Insurance = 20,
+  LegalServices = 21,
+  NonDurableMerchandiseRetail = 22,
+  OutboundConsumerService = 23,
+  PetrochemicalExtractionAndDistribution = 24,
+  ServiceRetail = 25,
+  SIGAffiliations = 26,
+  SocialServices = 27,
+  SpecialOutboundTradeContractors = 28,
+  SpecialtyRealty = 29,
+  Transportation = 30,
+  UtilityCreationAndDistribution = 31,
+  VehicleRetail = 32,
+  Wholesale = 33,
+}
+
+/**
+ * Ownership Code OptionSet
+ */
+export enum OwnershipCode_OptionSet {
+  Public = 1,
+  Private = 2,
+  Subsidiary = 3,
+  Other = 4,
+}
+
+/**
+ * Payment Terms Code OptionSet
+ */
+export enum PaymentTermsCode_OptionSet {
+  Net30 = 1,
+  TwoTenNet30 = 2,
+  Net45 = 3,
+  Net60 = 4,
+}
+
+/**
+ * Preferred Contact Method Code OptionSet
+ */
+export enum PreferredContactMethodCode_OptionSet {
+  Any = 1,
+  Email = 2,
+  Phone = 3,
+  Fax = 4,
+  Mail = 5,
+}
+
+/**
+ * Shipping Method Code OptionSet
+ */
+export enum ShippingMethodCode_OptionSet {
+  DefaultValue = 1,
+}
+
+/**
+ * State Code OptionSet
+ */
+export enum StateCode_OptionSet {
+  Active = 0,
+  Inactive = 1,
+}
+
+/**
+ * Status Code OptionSet
+ */
+export enum StatusCode_OptionSet {
+  Active = 1,
+  Inactive = 2,
+}
+
+/**
+ * Territory Code OptionSet
+ */
+export enum TerritoryCode_OptionSet {
+  DefaultValue = 1,
+}