@xrmforge/typegen 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -574,6 +574,92 @@ interface EntityTypeInfo {
     manyToManyRelationships: ManyToManyRelationshipMetadata[];
 }
 
+/**
+ * @xrmforge/typegen - Custom API Metadata Types
+ *
+ * TypeScript interfaces for Dataverse Custom API definitions.
+ * These types model the JSON structures from the customapi,
+ * customapirequestparameter, and customapiresponseproperty tables.
+ *
+ * Used by the action-generator to produce typed Action/Function executors.
+ */
+/**
+ * Custom API parameter type (picklist values from customapirequestparameter.type).
+ *
+ * Maps to TypeScript types and OData metadata for getMetadata().
+ */
+declare const enum CustomApiParameterType {
+    Boolean = 0,
+    DateTime = 1,
+    Decimal = 2,
+    Entity = 3,
+    EntityCollection = 4,
+    EntityReference = 5,
+    Float = 6,
+    Integer = 7,
+    Money = 8,
+    Picklist = 9,
+    String = 10,
+    StringArray = 11,
+    Guid = 12
+}
+/**
+ * Custom API binding type (picklist values from customapi.bindingtype).
+ */
+declare const enum CustomApiBindingType {
+    /** Nicht an eine Entity gebunden (global aufrufbar) */
+    Global = 0,
+    /** An einen einzelnen Entity-Datensatz gebunden */
+    Entity = 1,
+    /** An eine Entity-Collection gebunden */
+    EntityCollection = 2
+}
+/** Custom API definition (from the customapi table) */
+interface CustomApiMetadata {
+    /** Unique message name (e.g. "markant_NormalizePhone") */
+    uniquename: string;
+    /** 0=Global, 1=Entity, 2=EntityCollection */
+    bindingtype: CustomApiBindingType;
+    /** true = Function (GET), false = Action (POST) */
+    isfunction: boolean;
+    /** Bound entity logical name (null for unbound) */
+    boundentitylogicalname: string | null;
+    /** Display name for documentation */
+    displayname?: string;
+    /** Description for JSDoc */
+    description?: string;
+}
+/** Custom API request parameter (from the customapirequestparameter table) */
+interface CustomApiRequestParameter {
+    /** Parameter name (e.g. "Input", "TargetId") */
+    uniquename: string;
+    /** Parameter type (0-12, see CustomApiParameterType) */
+    type: CustomApiParameterType;
+    /** Whether the parameter is optional */
+    isoptional: boolean;
+    /** Entity logical name (for Entity/EntityReference types) */
+    logicalentityname?: string | null;
+    /** Description for JSDoc */
+    description?: string;
+}
+/** Custom API response property (from the customapiresponseproperty table) */
+interface CustomApiResponseProperty {
+    /** Property name (e.g. "Normalized", "IsValid") */
+    uniquename: string;
+    /** Property type (0-12, see CustomApiParameterType) */
+    type: CustomApiParameterType;
+    /** Entity logical name (for Entity/EntityReference types) */
+    logicalentityname?: string | null;
+    /** Description for JSDoc */
+    description?: string;
+}
+/** Complete Custom API definition with parameters and response */
+interface CustomApiTypeInfo {
+    api: CustomApiMetadata;
+    requestParameters: CustomApiRequestParameter[];
+    responseProperties: CustomApiResponseProperty[];
+}
+
 /**
  * @xrmforge/typegen - Metadata Client
  *
@@ -668,6 +754,16 @@ declare class MetadataClient {
      * Respects the HTTP client's concurrency limit automatically.
      */
     getMultipleEntityTypeInfos(logicalNames: string[]): Promise<EntityTypeInfo[]>;
+    /**
+     * Fetch all Custom APIs with their request parameters and response properties.
+     *
+     * Queries the customapi, customapirequestparameter, and customapiresponseproperty
+     * tables and joins them into CustomApiTypeInfo objects.
+     *
+     * @param solutionFilter - Optional: filter by solution unique name
+     * @returns Array of complete Custom API definitions
+     */
+    getCustomApis(solutionFilter?: string): Promise<CustomApiTypeInfo[]>;
     private getRelationships;
 }
 
@@ -913,6 +1009,14 @@ declare function getFormAttributeType(attributeType: string): string;
  * @returns Fully qualified Xrm control type string
  */
 declare function getFormControlType(attributeType: string): string;
+/**
+ * Map Dataverse AttributeType to JavaScript value type for mock objects.
+ * Used by the form generator to create MockValues types for @xrmforge/testing.
+ *
+ * @param attributeType - The AttributeType from Dataverse metadata
+ * @returns TypeScript value type string (e.g. "string | null", "number | null")
+ */
+declare function getFormMockValueType(attributeType: string): string;
 /**
  * Convert a Dataverse LogicalName to a safe TypeScript identifier.
  * Validates that the result is a valid identifier.
@@ -945,6 +1049,12 @@ declare function toLookupValueProperty(logicalName: string): string;
  * not a single _fieldname_value property in the Web API.
  */
 declare function isLookupType(attributeType: string): boolean;
+/**
+ * Determine if an attribute is a PartyList (ActivityParty collection).
+ * PartyList fields (to, from, cc, bcc, requiredattendees, optionalattendees)
+ * are navigation properties in the Web API, not flat lookup properties.
+ */
+declare function isPartyListType(attributeType: string): boolean;
 /**
  * Determine if an attribute should be included in entity interfaces.
  * Excludes virtual/calculated fields that are not readable via Web API.
@@ -958,6 +1068,29 @@ declare function isLookupType(attributeType: string): boolean;
  */
 declare function shouldIncludeInEntityInterface(attr: AttributeMetadata): boolean;
 
+/**
+ * @xrmforge/typegen - ActivityParty Base Interface
+ *
+ * ActivityParty is a Dataverse system entity that represents participants
+ * in activities (email, appointment, phonecall, fax, etc.).
+ *
+ * PartyList fields (to, from, cc, bcc, requiredattendees, optionalattendees)
+ * are collection-valued navigation properties that return ActivityParty arrays.
+ *
+ * This interface is generated once and referenced by all Activity entities
+ * that have PartyList fields.
+ *
+ * @see https://learn.microsoft.com/en-us/power-apps/developer/data-platform/reference/entities/activityparty
+ */
+/**
+ * Generate the ActivityParty base interface declaration.
+ * This is a fixed structure (system entity, never customized).
+ *
+ * @param namespace - Namespace for the interface (default: "XrmForge.Entities")
+ * @returns TypeScript declaration string
+ */
+declare function generateActivityPartyInterface(namespace?: string): string;
+
 /**
  * @xrmforge/typegen - Generator-specific Label Utilities
  *
@@ -1169,6 +1302,489 @@ declare function generateEntityForms(forms: ParsedForm[], entityLogicalName: str
     content: string;
 }>;
 
+/**
+ * @xrmforge/typegen - Entity Fields Enum Generator
+ *
+ * Generates a const enum with ALL entity fields for use with Xrm.WebApi.
+ * Unlike form-specific Fields enums, this contains every readable attribute.
+ *
+ * Output pattern:
+ * ```typescript
+ * declare namespace XrmForge.Entities {
+ *   const enum AccountFields {
+ *     /** Account Name | Firmenname *\/
+ *     Name = 'name',
+ *     /** Main Phone | Haupttelefon *\/
+ *     Telephone1 = 'telephone1',
+ *   }
+ * }
+ * ```
+ */
+
+/** Options for entity fields enum generation */
+interface EntityFieldsGeneratorOptions {
+    /** Label configuration for dual-language JSDoc comments */
+    labelConfig?: LabelConfig;
+    /** Namespace for generated enums (default: "XrmForge.Entities") */
+    namespace?: string;
+}
+/**
+ * Generate a const enum with all entity fields for Web API usage.
+ * Includes ALL readable fields (not form-specific).
+ *
+ * @param info - Complete entity metadata
+ * @param options - Generator options
+ * @returns TypeScript declaration string
+ */
+declare function generateEntityFieldsEnum(info: EntityTypeInfo, options?: EntityFieldsGeneratorOptions): string;
+/**
+ * Generate a const enum with navigation property names for all lookup fields.
+ * Used with parseLookup() and $expand queries.
+ *
+ * Unlike EntityFields (which uses _fieldname_value format), this enum
+ * contains the plain LogicalName (= navigation property name for non-polymorphic lookups).
+ *
+ * @param info - Complete entity metadata
+ * @param options - Generator options
+ * @returns TypeScript declaration string
+ *
+ * @example
+ * ```typescript
+ * // Generated:
+ * const enum AccountNavigationProperties {
+ *   Country = 'markant_address1_countryid',
+ *   PrimaryContact = 'primarycontactid',
+ * }
+ *
+ * // Usage:
+ * parseLookup(response, AccountNav.Country);
+ * ```
+ */
+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
+ *
+ * Lightweight utility functions for building OData query strings
+ * with type-safe field names from generated Fields enums.
+ *
+ * Zero runtime overhead when used with const enums (values are inlined).
+ *
+ * @example
+ * ```typescript
+ * import { select } from '@xrmforge/typegen';
+ *
+ * Xrm.WebApi.retrieveRecord(ref.entityType, ref.id, select(
+ *   AccountFields.Name,
+ *   AccountFields.WebsiteUrl,
+ *   AccountFields.Address1Line1,
+ * ));
+ * ```
+ */
+/**
+ * Build an OData $select query string from field names.
+ *
+ * @param fields - Field names (use generated Fields enum for type safety)
+ * @returns OData query string (e.g. "?$select=name,websiteurl,address1_line1")
+ */
+declare function select(...fields: string[]): string;
+/**
+ * Parse a lookup field from a Dataverse Web API response into a LookupValue.
+ *
+ * Dataverse returns lookups as `_fieldname_value` with OData annotations:
+ * - `_fieldname_value` (GUID)
+ * - `_fieldname_value@OData.Community.Display.V1.FormattedValue` (display name)
+ * - `_fieldname_value@Microsoft.Dynamics.CRM.lookuplogicalname` (entity type)
+ *
+ * This function extracts all three into an `Xrm.LookupValue` object.
+ *
+ * @param response - The raw Web API response object
+ * @param navigationProperty - Navigation property name (use NavigationProperties enum for type safety)
+ * @returns Xrm.LookupValue or null if the lookup is empty
+ *
+ * @example
+ * ```typescript
+ * // Mit NavigationProperties-Enum (empfohlen, keine Raw-Strings):
+ * parseLookup(result, AccountNav.Country);
+ *
+ * // Oder mit Navigation Property Name direkt:
+ * parseLookup(result, 'markant_address1_countryid');
+ * ```
+ */
+declare function parseLookup(response: Record<string, unknown>, navigationProperty: string): {
+    id: string;
+    name: string;
+    entityType: string;
+} | null;
+/**
+ * Parse multiple lookup fields from a Dataverse Web API response at once.
+ *
+ * @param response - The raw Web API response object
+ * @param navigationProperties - Navigation property names to parse
+ * @returns Map of navigation property name to LookupValue (null entries omitted)
+ *
+ * @example
+ * ```typescript
+ * const lookups = parseLookups(result, ['markant_address1_countryid', 'parentaccountid']);
+ * formContext.getAttribute(Fields.Country).setValue(
+ *   lookups.markant_address1_countryid ? [lookups.markant_address1_countryid] : null
+ * );
+ * ```
+ */
+declare function parseLookups(response: Record<string, unknown>, navigationProperties: string[]): Record<string, {
+    id: string;
+    name: string;
+    entityType: string;
+} | null>;
+/**
+ * Get the formatted (display) value of any field from a Web API response.
+ *
+ * Works for OptionSets, Lookups, DateTimes, Money, and other formatted fields.
+ *
+ * @param response - The raw Web API response object
+ * @param fieldName - The field logical name (e.g. "statecode", "createdon")
+ * @returns The formatted string value, or null if not available
+ *
+ * @example
+ * ```typescript
+ * const status = parseFormattedValue(result, 'statecode');
+ * // "Active" (statt 0)
+ * ```
+ */
+declare function parseFormattedValue(response: Record<string, unknown>, fieldName: string): string | null;
+/**
+ * Build an OData $select and $expand query string.
+ *
+ * @param fields - Field names to select
+ * @param expand - Navigation property to expand (optional)
+ * @returns OData query string
+ *
+ * @example
+ * ```typescript
+ * Xrm.WebApi.retrieveRecord("account", id, selectExpand(
+ *   [AccountFields.Name, AccountFields.WebsiteUrl],
+ *   "primarycontactid($select=fullname,emailaddress1)"
+ * ));
+ * ```
+ */
+declare function selectExpand(fields: string[], expand: string): string;
+
+/**
+ * @xrmforge/typegen - Xrm API Constants
+ *
+ * Const enums for all common Xrm string/number constants.
+ * Eliminates raw strings in D365 form scripts.
+ *
+ * @types/xrm defines these as string literal types for compile-time checking,
+ * but does NOT provide runtime constants (XrmEnum is not available at runtime).
+ * These const enums are erased at compile time (zero runtime overhead).
+ *
+ * @example
+ * ```typescript
+ * // Statt Raw-String:
+ * if (tab.getDisplayState() === 'expanded') { ... }
+ *
+ * // Mit XrmForge-Konstante:
+ * if (tab.getDisplayState() === XrmConstants.DisplayState.Expanded) { ... }
+ * ```
+ */
+/** Tab/Section display state */
+declare const enum DisplayState {
+    Expanded = "expanded",
+    Collapsed = "collapsed"
+}
+/** Form notification level (formContext.ui.setFormNotification) */
+declare const enum FormNotificationLevel {
+    Error = "ERROR",
+    Warning = "WARNING",
+    Info = "INFO"
+}
+/** Attribute required level (attribute.setRequiredLevel) */
+declare const enum RequiredLevel {
+    None = "none",
+    Required = "required",
+    Recommended = "recommended"
+}
+/** Attribute submit mode (attribute.setSubmitMode) */
+declare const enum SubmitMode {
+    Always = "always",
+    Never = "never",
+    Dirty = "dirty"
+}
+/** Save mode (eventArgs.getSaveMode()) */
+declare const enum SaveMode {
+    Save = 1,
+    SaveAndClose = 2,
+    Deactivate = 5,
+    Reactivate = 6,
+    Send = 7,
+    Disqualify = 15,
+    Qualify = 16,
+    Assign = 47,
+    SaveAsCompleted = 58,
+    SaveAndNew = 59,
+    AutoSave = 70
+}
+/** Client type (Xrm.Utility.getGlobalContext().client.getClient()) */
+declare const enum ClientType {
+    Web = "Web",
+    Outlook = "Outlook",
+    Mobile = "Mobile"
+}
+/** Client state (Xrm.Utility.getGlobalContext().client.getClientState()) */
+declare const enum ClientState {
+    Online = "Online",
+    Offline = "Offline"
+}
+/** Operation type for Xrm.WebApi.execute getMetadata().operationType */
+declare const enum OperationType {
+    /** Custom Action or OOB Action (POST) */
+    Action = 0,
+    /** Custom Function or OOB Function (GET) */
+    Function = 1,
+    /** CRUD operation (Create, Retrieve, Update, Delete) */
+    CRUD = 2
+}
+/** Structural property for getMetadata().parameterTypes[].structuralProperty */
+declare const enum StructuralProperty {
+    Unknown = 0,
+    PrimitiveType = 1,
+    ComplexType = 2,
+    EnumerationType = 3,
+    Collection = 4,
+    EntityType = 5
+}
+/** Binding type for Custom API definitions */
+declare const enum BindingType {
+    /** Nicht an eine Entity gebunden (global aufrufbar) */
+    Global = 0,
+    /** An einen einzelnen Entity-Datensatz gebunden */
+    Entity = 1,
+    /** An eine Entity-Collection gebunden */
+    EntityCollection = 2
+}
+
+/**
+ * @xrmforge/typegen - Action/Function Runtime Helpers
+ *
+ * Factory functions for type-safe Custom API execution.
+ * These are imported by generated action/function modules.
+ *
+ * Design:
+ * - `createBoundAction` / `createUnboundAction`: Produce executor objects
+ *   with `.execute()` (calls Xrm.WebApi) and `.request()` (for executeMultiple)
+ * - `executeRequest`: Central execute wrapper (single place for the `as any` cast)
+ * - `withProgress`: Convenience wrapper with progress indicator + error dialog
+ *
+ * @example
+ * ```typescript
+ * // Generated code (in generated/actions/quote.ts):
+ * export const WinQuote = createBoundAction('markant_winquote', 'quote');
+ *
+ * // Developer code (in quote-form.ts):
+ * import { WinQuote } from '../generated/actions/quote';
+ * const response = await WinQuote.execute(recordId);
+ * ```
+ */
+/** Parameter metadata for getMetadata().parameterTypes */
+interface ParameterMeta {
+    typeName: string;
+    structuralProperty: number;
+}
+/** Map of parameter names to their OData metadata */
+type ParameterMetaMap = Record<string, ParameterMeta>;
+/** Executor for a bound action without additional parameters */
+interface BoundActionExecutor {
+    execute(recordId: string): Promise<Response>;
+    request(recordId: string): Record<string, unknown>;
+}
+/** Executor for a bound action with typed parameters */
+interface BoundActionWithParamsExecutor<TParams> {
+    execute(recordId: string, params: TParams): Promise<Response>;
+    request(recordId: string, params: TParams): Record<string, unknown>;
+}
+/** Executor for an unbound action without parameters */
+interface UnboundActionExecutor {
+    execute(): Promise<Response>;
+    request(): Record<string, unknown>;
+}
+/** Executor for an unbound action with typed parameters and optional typed response */
+interface UnboundActionWithParamsExecutor<TParams, TResult = void> {
+    execute(params: TParams): Promise<TResult extends void ? Response : TResult>;
+    request(params: TParams): Record<string, unknown>;
+}
+/** Executor for an unbound function with typed response */
+interface UnboundFunctionExecutor<TResult> {
+    execute(): Promise<TResult>;
+    request(): Record<string, unknown>;
+}
+/** Executor for a bound function with typed response */
+interface BoundFunctionExecutor<TResult> {
+    execute(recordId: string): Promise<TResult>;
+    request(recordId: string): Record<string, unknown>;
+}
+/**
+ * Execute a single request via Xrm.WebApi.online.execute().
+ *
+ * This is the ONLY place in the entire framework where the `as any` cast happens.
+ * All generated executors call this function internally.
+ */
+declare function executeRequest(request: Record<string, unknown>): Promise<Response>;
+/**
+ * Execute multiple requests via Xrm.WebApi.online.executeMultiple().
+ *
+ * @param requests - Array of request objects (from `.request()` factories).
+ *   Wrap a subset in an inner array for transactional changeset execution.
+ */
+declare function executeMultiple(requests: Array<Record<string, unknown> | Array<Record<string, unknown>>>): Promise<Response[]>;
+/**
+ * Create an executor for a bound action (entity-bound).
+ *
+ * @param operationName - Custom API unique name (e.g. "markant_winquote")
+ * @param entityLogicalName - Entity logical name (e.g. "quote")
+ */
+declare function createBoundAction(operationName: string, entityLogicalName: string): BoundActionExecutor;
+/**
+ * Create an executor for a bound action with typed parameters.
+ *
+ * @param operationName - Custom API unique name
+ * @param entityLogicalName - Entity logical name
+ * @param paramMeta - Parameter metadata map (parameter name to OData type info)
+ */
+declare function createBoundAction<TParams extends Record<string, unknown>>(operationName: string, entityLogicalName: string, paramMeta: ParameterMetaMap): BoundActionWithParamsExecutor<TParams>;
+/**
+ * Create an executor for an unbound (global) action without parameters.
+ *
+ * @param operationName - Custom API unique name
+ */
+declare function createUnboundAction(operationName: string): UnboundActionExecutor;
+/**
+ * Create an executor for an unbound action with typed parameters and response.
+ *
+ * @param operationName - Custom API unique name
+ * @param paramMeta - Parameter metadata map
+ */
+declare function createUnboundAction<TParams extends Record<string, unknown>, TResult = void>(operationName: string, paramMeta: ParameterMetaMap): UnboundActionWithParamsExecutor<TParams, TResult>;
+/**
+ * Create an executor for an unbound (global) function with typed response.
+ *
+ * @param operationName - Function name (e.g. "WhoAmI")
+ */
+declare function createUnboundFunction<TResult>(operationName: string): UnboundFunctionExecutor<TResult>;
+/**
+ * Create an executor for a bound function with typed response.
+ *
+ * @param operationName - Function name
+ * @param entityLogicalName - Entity logical name
+ */
+declare function createBoundFunction<TResult>(operationName: string, entityLogicalName: string): BoundFunctionExecutor<TResult>;
+/**
+ * Execute an async operation with Xrm progress indicator.
+ *
+ * Shows a progress spinner before the operation, closes it after,
+ * and shows an error dialog on failure.
+ *
+ * @param message - Progress indicator message (e.g. "Angebot wird gewonnen...")
+ * @param operation - Async function to execute
+ * @returns The result of the operation
+ *
+ * @example
+ * ```typescript
+ * await withProgress('Angebot wird gewonnen...', () => WinQuote.execute(recordId));
+ * ```
+ */
+declare function withProgress<T>(message: string, operation: () => Promise<T>): Promise<T>;
+
+/**
+ * @xrmforge/typegen - Action/Function Generator
+ *
+ * Generates TypeScript files for type-safe Custom API execution:
+ * - .d.ts: Parameter/Response interfaces and executor types
+ * - .ts: Runtime modules that import factory functions from @xrmforge/typegen
+ *
+ * Input: CustomApiTypeInfo[] (from fixture JSON or live Dataverse query)
+ * Output: Grouped by entity (bound) or "global" (unbound)
+ *
+ * @example Generated output for markant_NormalizePhone (unbound action):
+ * ```typescript
+ * // global.d.ts
+ * declare namespace XrmForge.Actions {
+ *   interface NormalizePhoneParams { Input: string; AllowSuspicious?: boolean; }
+ *   interface NormalizePhoneResult { Normalized: string; Status: number; Message: string; }
+ * }
+ *
+ * // global.ts
+ * import { createUnboundAction } from '@xrmforge/typegen';
+ * export const NormalizePhone = createUnboundAction<...>('markant_NormalizePhone', { ... });
+ * ```
+ */
+
+/** Options for action/function generation */
+interface ActionGeneratorOptions {
+    /** Import path for @xrmforge/typegen (default: "@xrmforge/typegen") */
+    importPath?: string;
+    /** Namespace for generated types (default: "XrmForge.Actions" / "XrmForge.Functions") */
+    actionsNamespace?: string;
+    functionsNamespace?: string;
+}
+/**
+ * Generate .d.ts content for a group of Custom APIs.
+ *
+ * @param apis - Custom APIs to generate (all in the same group: same entity or all global)
+ * @param isFunction - true for functions namespace, false for actions
+ * @param entityName - Entity name for bound APIs, undefined for global
+ * @param options - Generator options
+ */
+declare function generateActionDeclarations(apis: CustomApiTypeInfo[], isFunction: boolean, entityName?: string, options?: ActionGeneratorOptions): string;
+/**
+ * Generate .ts content with runtime executors for a group of Custom APIs.
+ *
+ * @param apis - Custom APIs to generate
+ * @param isFunction - true for functions, false for actions
+ * @param options - Generator options
+ */
+declare function generateActionModule(apis: CustomApiTypeInfo[], isFunction: boolean, options?: ActionGeneratorOptions): string;
+/** Group result: key is entity logical name or "global" for unbound */
+interface GroupedCustomApis {
+    actions: Map<string, CustomApiTypeInfo[]>;
+    functions: Map<string, CustomApiTypeInfo[]>;
+}
+/**
+ * Group Custom APIs by entity (bound) or "global" (unbound),
+ * and separate actions from functions.
+ */
+declare function groupCustomApis(apis: CustomApiTypeInfo[]): GroupedCustomApis;
+
 /**
  * @xrmforge/typegen - Orchestrator Types
  *
@@ -1193,6 +1809,10 @@ interface GenerateConfig {
     generateForms?: boolean;
     /** Whether to generate OptionSet enums (default: true) */
     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.
@@ -1226,7 +1846,7 @@ interface GeneratedFile {
     /** File content */
     content: string;
     /** Type of generated content */
-    type: 'entity' | 'optionset' | 'form';
+    type: 'entity' | 'optionset' | 'form' | 'action';
 }
 /** Overall result of the generation process */
 interface GenerationResult {
@@ -1292,4 +1912,4 @@ declare class TypeGenerationOrchestrator {
     private getPicklistAttributes;
 }
 
-export { ApiRequestError, type AttributeMetadata, type AuthConfig, type AuthMethod, AuthenticationError, type ClientCredentialsAuth, ConfigError, ConsoleLogSink, DEFAULT_LABEL_CONFIG, DataverseHttpClient, type DateTimeAttributeMetadata, type DecimalAttributeMetadata, type DeviceCodeAuth, type EntityGenerationResult, type EntityGeneratorOptions, type EntityMetadata, type EntityTypeInfo, ErrorCode, FastXmlParser, type FormControl, type FormGeneratorOptions, type FormSection, type FormTab, type GenerateConfig, type GeneratedFile, GenerationError, type GenerationResult, 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, type OptionMetadata, type OptionSetGeneratorOptions, type OptionSetMetadata, type ParsedForm, type PicklistAttributeMetadata, SilentLogSink, type SolutionComponent, type StateAttributeMetadata, type StatusAttributeMetadata, type StringAttributeMetadata, type SystemFormMetadata, TypeGenerationOrchestrator, type XmlElement, type XmlParser, XrmForgeError, configureLogging, createCredential, createLogger, defaultXmlParser, disambiguateEnumMembers, extractControlFields, getJSDocLabel as formatDualLabel, generateEntityForms, generateEntityInterface, generateEntityOptionSets, generateEnumMembers, generateFormInterface, generateOptionSetEnum, getEntityPropertyType, getFormAttributeType, getFormControlType, getJSDocLabel, getLabelLanguagesParam, getPrimaryLabel, getSecondaryLabel, isLookupType, isRateLimitError, isXrmForgeError, labelToIdentifier, parseForm, shouldIncludeInEntityInterface, toLookupValueProperty, toPascalCase, toSafeIdentifier };
+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 };