push neon reactor

CodeApp_NeonReactor/node_modules/@microsoft/power-apps-common/README.md

@@ -0,0 +1,69 @@
+# @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';`