Power Platform Connectors Schema Development Instructions

# Power Platform Connectors Schema Development Instructions

## Project Overview
This workspace contains JSON Schema definitions for Power Platform Custom Connectors, specifically for the `paconn` (Power Apps Connector) tool. The schemas validate and provide IntelliSense for:

- **API Definitions** (Swagger 2.0 format)
- **API Properties** (connector metadata and configuration)
- **Settings** (environment and deployment configuration)

## File Structure Understanding

### 1. apiDefinition.swagger.json
- **Purpose**: This file contains Swagger 2.0 API definitions with Power Platform extensions.
- **Key Features**:
  - Standard Swagger 2.0 properties including info, paths, definitions, and more.
  - Microsoft-specific extensions that begin with `x-ms-*` prefixes.
  - Custom format types specifically designed for Power Platform such as `date-no-tz` and `html`.
  - Dynamic schema support that provides runtime flexibility.
  - Security definitions that support OAuth2, API Key, and Basic Auth authentication methods.

### 2. apiProperties.json
- **Purpose**: This file defines connector metadata, authentication configurations, and policy configurations.
- **Key Components**:
  - **Connection Parameters**: These support various authentication types including OAuth, API Key, and Gateway configurations.
  - **Policy Template Instances**: These handle data transformation and routing policies for the connector.