@microsoft/power-apps-common

Shared types, utilities, and services for Power Platform Managed Host packages.

Note: This package is published internally via Azure Artifacts. It is subject to frequent breaking changes and is not intended for standalone production use outside of the Power Platform Managed Host ecosystem.

Exports

Types

• AppMetadata, App, AppProperties, Environment - App metadata types
• PowerConfig - Power Platform configuration
• ClusterCategory - Cluster environment enum (Production, Test, Dev)
• ConnectionReference, RpConnection - Connection reference types
• HostError, HostErrorCode - Structured error types
• ConnectionInstance, ConnectionUsage - Connection domain types (shared with host)
• UserConsent, AuthResource - Consent domain types (shared with host)
• AppConnectionContext - Context passed to connection loading
• CdsDatabaseReference, DatasetReference, DataSourceInfo - Data source types
• Api, NestedAction, ParameterHint, ListAppPackageOperationDetails - API metadata types

Plugin Definitions

• PluginMap - Central type mapping action keys to typed function signatures
• PluginKey, PluginParams<K>, PluginResponse<K>, PluginHandler<K> - Utility types for typed plugin handlers
• PluginAction - Action name constants (derived from definition keys)
• PluginDefinition - Generic mapped type for defining plugin entries
• GetContextKey, GetCdsKey, GetAppConnectionsKey, HttpSendKey, MessagingGetVersionInfoKey, MessagingSendKey - Dot-namespaced action key constants
• PluginAliases - Legacy wire-format key to canonical key map
• IContext - Response type for AppLifecycle.getContext
• SendHttpRequest, SendHttpResponse - Types for Http.send

HTTP

• HttpClient - Fetch wrapper with interceptors, base URL, and default headers
• HttpClientOptions - Configuration for HttpClient
• HttpError - Error class for non-OK HTTP responses
• HttpRequestConfig, HttpResponse - Request/response types
• RequestInterceptor, ResponseInterceptor - Interceptor types

Telemetry

• TelemetryLogger - Logger for telemetry events
• LogLevel - Enum for log severity levels
• TelemetryEvent - Interface for telemetry event data

Utilities

• parseQueryParams(url) - Parse query parameters from a URL string
• buildUrl(base, params) - Build a URL with query parameters

Scripts

| Script | Description | | ------------- | ----------------------------- | | build | Compile TypeScript to dist/ | | dev | Watch mode compilation | | check-types | Type-check without emitting | | lint | Run ESLint on src/ | | test | Run Bun tests (src/) | | clean | Remove dist/ and .turbo/ |

Test Utilities

Shared mock factories live in src/__tests__/testUtils/:

• createMockConnection(overrides?) — returns a ConnectionInstance with sensible defaults

Import from the barrel: import { createMockConnection } from '../../__tests__/testUtils';