@xrmforge/typegen 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -1362,6 +1362,36 @@ declare function generateEntityFieldsEnum(info: EntityTypeInfo, options?: Entity
  */
 declare function generateEntityNavigationProperties(info: EntityTypeInfo, options?: EntityFieldsGeneratorOptions): string;
 
+/**
+ * @xrmforge/typegen - Entity Names Enum Generator
+ *
+ * Generates a single const enum with all entity logical names.
+ * Eliminates raw strings in Xrm.WebApi calls.
+ *
+ * Output pattern:
+ * ```typescript
+ * declare namespace XrmForge {
+ *   const enum EntityNames {
+ *     Account = 'account',
+ *     Contact = 'contact',
+ *     Lead = 'lead',
+ *   }
+ * }
+ * ```
+ */
+interface EntityNamesGeneratorOptions {
+    /** Namespace (default: "XrmForge") */
+    namespace?: string;
+}
+/**
+ * Generate a const enum mapping entity PascalCase names to logical names.
+ *
+ * @param entityNames - Array of entity logical names
+ * @param options - Generator options
+ * @returns TypeScript declaration string
+ */
+declare function generateEntityNamesEnum(entityNames: string[], options?: EntityNamesGeneratorOptions): string;
+
 /**
  * @xrmforge/typegen - Web API Helper Functions
  *
@@ -1781,6 +1811,8 @@ interface GenerateConfig {
     generateOptionSets?: boolean;
     /** Whether to generate Custom API Action/Function executors (default: false) */
     generateActions?: boolean;
+    /** Filter Custom APIs by uniquename prefix (e.g. "markant_"). Only APIs matching the prefix are generated. */
+    actionsFilter?: string;
     /**
      * Whether to use metadata cache for faster re-generation.
      * @alpha Not yet implemented. Setting this to true will throw a ConfigError.
@@ -1880,4 +1912,4 @@ declare class TypeGenerationOrchestrator {
     private getPicklistAttributes;
 }
 
-export { type ActionGeneratorOptions, ApiRequestError, type AttributeMetadata, type AuthConfig, type AuthMethod, AuthenticationError, BindingType, type BoundActionExecutor, type BoundActionWithParamsExecutor, type BoundFunctionExecutor, type ClientCredentialsAuth, ClientState, ClientType, ConfigError, ConsoleLogSink, type CustomApiTypeInfo, DEFAULT_LABEL_CONFIG, DataverseHttpClient, type DateTimeAttributeMetadata, type DecimalAttributeMetadata, type DeviceCodeAuth, DisplayState, type EntityFieldsGeneratorOptions, type EntityGenerationResult, type EntityGeneratorOptions, type EntityMetadata, type EntityTypeInfo, ErrorCode, FastXmlParser, type FormControl, type FormGeneratorOptions, FormNotificationLevel, type FormSection, type FormTab, type GenerateConfig, type GeneratedFile, GenerationError, type GenerationResult, type GroupedCustomApis, type HttpClientOptions, type IntegerAttributeMetadata, type InteractiveAuth, JsonLogSink, type Label, type LabelConfig, type LocalizedLabel, type LogEntry, LogLevel, type LogSink, Logger, type LookupAttributeMetadata, type ManyToManyRelationshipMetadata, MetadataCache, MetadataClient, MetadataError, type MoneyAttributeMetadata, type OneToManyRelationshipMetadata, OperationType, type OptionMetadata, type OptionSetGeneratorOptions, type OptionSetMetadata, type ParameterMeta, type ParameterMetaMap, type ParsedForm, type PicklistAttributeMetadata, RequiredLevel, SaveMode, SilentLogSink, type SolutionComponent, type StateAttributeMetadata, type StatusAttributeMetadata, type StringAttributeMetadata, StructuralProperty, SubmitMode, type SystemFormMetadata, TypeGenerationOrchestrator, type UnboundActionExecutor, type UnboundActionWithParamsExecutor, type UnboundFunctionExecutor, type XmlElement, type XmlParser, XrmForgeError, configureLogging, createBoundAction, createBoundFunction, createCredential, createLogger, createUnboundAction, createUnboundFunction, defaultXmlParser, disambiguateEnumMembers, executeMultiple, executeRequest, extractControlFields, getJSDocLabel as formatDualLabel, generateActionDeclarations, generateActionModule, generateActivityPartyInterface, generateEntityFieldsEnum, generateEntityForms, generateEntityInterface, generateEntityNavigationProperties, generateEntityOptionSets, generateEnumMembers, generateFormInterface, generateOptionSetEnum, getEntityPropertyType, getFormAttributeType, getFormControlType, getFormMockValueType, getJSDocLabel, getLabelLanguagesParam, getPrimaryLabel, getSecondaryLabel, groupCustomApis, isLookupType, isPartyListType, isRateLimitError, isXrmForgeError, labelToIdentifier, parseForm, parseFormattedValue, parseLookup, parseLookups, select, selectExpand, shouldIncludeInEntityInterface, toLookupValueProperty, toPascalCase, toSafeIdentifier, withProgress };
+export { type ActionGeneratorOptions, ApiRequestError, type AttributeMetadata, type AuthConfig, type AuthMethod, AuthenticationError, BindingType, type BoundActionExecutor, type BoundActionWithParamsExecutor, type BoundFunctionExecutor, type ClientCredentialsAuth, ClientState, ClientType, ConfigError, ConsoleLogSink, type CustomApiTypeInfo, DEFAULT_LABEL_CONFIG, DataverseHttpClient, type DateTimeAttributeMetadata, type DecimalAttributeMetadata, type DeviceCodeAuth, DisplayState, type EntityFieldsGeneratorOptions, type EntityGenerationResult, type EntityGeneratorOptions, type EntityMetadata, type EntityNamesGeneratorOptions, type EntityTypeInfo, ErrorCode, FastXmlParser, type FormControl, type FormGeneratorOptions, FormNotificationLevel, type FormSection, type FormTab, type GenerateConfig, type GeneratedFile, GenerationError, type GenerationResult, type GroupedCustomApis, type HttpClientOptions, type IntegerAttributeMetadata, type InteractiveAuth, JsonLogSink, type Label, type LabelConfig, type LocalizedLabel, type LogEntry, LogLevel, type LogSink, Logger, type LookupAttributeMetadata, type ManyToManyRelationshipMetadata, MetadataCache, MetadataClient, MetadataError, type MoneyAttributeMetadata, type OneToManyRelationshipMetadata, OperationType, type OptionMetadata, type OptionSetGeneratorOptions, type OptionSetMetadata, type ParameterMeta, type ParameterMetaMap, type ParsedForm, type PicklistAttributeMetadata, RequiredLevel, SaveMode, SilentLogSink, type SolutionComponent, type StateAttributeMetadata, type StatusAttributeMetadata, type StringAttributeMetadata, StructuralProperty, SubmitMode, type SystemFormMetadata, TypeGenerationOrchestrator, type UnboundActionExecutor, type UnboundActionWithParamsExecutor, type UnboundFunctionExecutor, type XmlElement, type XmlParser, XrmForgeError, configureLogging, createBoundAction, createBoundFunction, createCredential, createLogger, createUnboundAction, createUnboundFunction, defaultXmlParser, disambiguateEnumMembers, executeMultiple, executeRequest, extractControlFields, getJSDocLabel as formatDualLabel, generateActionDeclarations, generateActionModule, generateActivityPartyInterface, generateEntityFieldsEnum, generateEntityForms, generateEntityInterface, generateEntityNamesEnum, generateEntityNavigationProperties, generateEntityOptionSets, generateEnumMembers, generateFormInterface, generateOptionSetEnum, getEntityPropertyType, getFormAttributeType, getFormControlType, getFormMockValueType, getJSDocLabel, getLabelLanguagesParam, getPrimaryLabel, getSecondaryLabel, groupCustomApis, isLookupType, isPartyListType, isRateLimitError, isXrmForgeError, labelToIdentifier, parseForm, parseFormattedValue, parseLookup, parseLookups, select, selectExpand, shouldIncludeInEntityInterface, toLookupValueProperty, toPascalCase, toSafeIdentifier, withProgress };

package/dist/index.js

@@ -2169,6 +2169,24 @@ function generateEntityNavigationProperties(info, options = {}) {
   return lines.join("\n");
 }
 
+// src/generators/entity-names-generator.ts
+function generateEntityNamesEnum(entityNames, options = {}) {
+  const namespace = options.namespace ?? "XrmForge";
+  const sorted = [...entityNames].sort();
+  const lines = [];
+  lines.push(`declare namespace ${namespace} {`);
+  lines.push("  /** Entity logical names for Xrm.WebApi calls (compile-time only, zero runtime) */");
+  lines.push("  const enum EntityNames {");
+  for (const name of sorted) {
+    const pascal = toPascalCase(name);
+    lines.push(`    ${pascal} = '${name}',`);
+  }
+  lines.push("  }");
+  lines.push("}");
+  lines.push("");
+  return lines.join("\n");
+}
+
 // src/generators/webapi-helpers.ts
 function select(...fields) {
   if (fields.length === 0) return "";
@@ -2739,6 +2757,7 @@ var TypeGenerationOrchestrator = class {
       generateForms: config.generateForms ?? true,
       generateOptionSets: config.generateOptionSets ?? true,
       generateActions: config.generateActions ?? false,
+      actionsFilter: config.actionsFilter ?? "",
       useCache: config.useCache ?? false,
       cacheDir: config.cacheDir ?? ".xrmforge/cache",
       namespacePrefix: config.namespacePrefix ?? "XrmForge"
@@ -2815,7 +2834,13 @@ var TypeGenerationOrchestrator = class {
     }
     if (this.config.generateActions && !signal?.aborted) {
       this.logger.info("Fetching Custom APIs...");
-      const customApis = await metadataClient.getCustomApis();
+      let customApis = await metadataClient.getCustomApis();
+      if (this.config.actionsFilter) {
+        const prefix = this.config.actionsFilter.toLowerCase();
+        const before = customApis.length;
+        customApis = customApis.filter((api) => api.api.uniquename.toLowerCase().startsWith(prefix));
+        this.logger.info(`Filtered Custom APIs by prefix "${this.config.actionsFilter}": ${before} -> ${customApis.length}`);
+      }
       if (customApis.length > 0) {
         const importPath = "@xrmforge/typegen";
         const grouped = groupCustomApis(customApis);
@@ -2854,6 +2879,16 @@ var TypeGenerationOrchestrator = class {
         this.logger.info("No Custom APIs found");
       }
     }
+    if (this.config.entities.length > 0) {
+      const entityNamesContent = generateEntityNamesEnum(this.config.entities, {
+        namespace: this.config.namespacePrefix
+      });
+      allFiles.push({
+        relativePath: "entity-names.d.ts",
+        content: addGeneratedHeader(entityNamesContent),
+        type: "entity"
+      });
+    }
     if (allFiles.length > 0) {
       const indexContent = generateBarrelIndex(allFiles);
       const indexFile = {
@@ -3025,6 +3060,7 @@ export {
   generateEntityFieldsEnum,
   generateEntityForms,
   generateEntityInterface,
+  generateEntityNamesEnum,
   generateEntityNavigationProperties,
   generateEntityOptionSets,
   generateEnumMembers,