{
  "schema": "https://ai-atoms.com/schemas/skill-v1.json",
  "type": "skill",
  "id": "skill/azure-appconfiguration-ts",
  "version": "1.0.0",
  "name": "Azure Appconfiguration Ts",
  "description": "Build applications using Azure App Configuration SDK for JavaScript (@azure/app-configuration). Use when working with configuration settings, feature flags, Key Vault references, dynamic refresh, o...",
  "system_prompt_fragment": "# Azure App Configuration SDK for TypeScript\n\nCentralized configuration management with feature flags and dynamic refresh.\n\n## Installation\n\n```bash\n# Low-level CRUD SDK\nnpm install @azure/app-configuration @azure/identity\n\n# High-level provider (recommended for apps)\nnpm install @azure/app-configuration-provider @azure/identity\n\n# Feature flag management\nnpm install @microsoft/feature-management\n```\n\n## Environment Variables\n\n```bash\nAZURE_APPCONFIG_ENDPOINT=https://<your-resource>.azconfig.io\n# OR\nAZURE_APPCONFIG_CONNECTION_STRING=Endpoint=https://...;Id=...;Secret=...\n```\n\n## Authentication\n\n```typescript\nimport { AppConfigurationClient } from \"@azure/app-configuration\";\nimport { DefaultAzureCredential } from \"@azure/identity\";\n\n// DefaultAzureCredential (recommended)\nconst client = new AppConfigurationClient(\n  process.env.AZURE_APPCONFIG_ENDPOINT!,\n  new DefaultAzureCredential()\n);\n\n// Connection string\nconst client2 = new AppConfigurationClient(\n  process.env.AZURE_APPCONFIG_CONNECTION_STRING!\n);\n```\n\n## CRUD Operations\n\n### Create/Update Settings\n\n```typescript\n// Add new (fails if exists)\nawait client.addConfigurationSetting({\n  key: \"app:settings:message\",\n  value: \"Hello World\",\n  label: \"production\",\n  contentType: \"text/plain\",\n  tags: { environment: \"prod\" },\n});\n\n// Set (create or update)\nawait client.setConfigurationSetting({\n  key: \"app:settings:message\",\n  value: \"Updated value\",\n  label: \"production\",\n});\n\n// Update with optimistic concurrency\nconst existing = await client.getConfigurationSetting({ key: \"myKey\" });\nexisting.value = \"new value\";\nawait client.setConfigurationSetting(existing, { onlyIfUnchanged: true });\n```\n\n### Read Settings\n\n```typescript\n// Get single setting\nconst setting = await client.getConfigurationSetting({\n  key: \"app:settings:message\",\n  label: \"production\",  // optional\n});\nconsole.log(setting.value);\n\n// List with filters\nconst settings = client.listConfigurationSettings({\n  keyFilter: \"app:*\",\n  labelFilter: \"production\",\n});\n\nfor await (const setting of settings) {\n  console.log(`${setting.key}: ${setting.value}`);\n}\n```\n\n### Delete Settings\n\n```typescript\nawait client.deleteConfigurationSetting({\n  key: \"app:settings:message\",\n  label: \"production\",\n});\n```\n\n### Lock/Unlock (Read-Only)\n\n```typescript\n// Lock\nawait client.setReadOnly({ key: \"myKey\", label: \"prod\" }, true);\n\n// Unlock\nawait client.setReadOnly({ key: \"myKey\", label: \"prod\" }, false);\n```\n\n## App Configuration Provider\n\n### Load Configuration\n\n```typescript\nimport { load } from \"@azure/app-configuration-provider\";\nimport { DefaultAzureCredential } from \"@azure/identity\";\n\nconst appConfig = await load(\n  process.env.AZURE_APPCONFIG_ENDPOINT!,\n  new DefaultAzureCredential(),\n  {\n    selectors: [\n      { keyFilter: \"app:*\", labelFilter: \"production\" },\n    ],\n    trimKeyPrefixes: [\"app:\"],\n  }\n);\n\n// Map-style access\nconst value = appConfig.get(\"settings:message\");\n\n// Object-style access\nconst config = appConfig.constructConfigurationObject({ separator: \":\" });\nconsole.log(config.settings.message);\n```\n\n### Dynamic Refresh\n\n```typescript\nconst appConfig = await load(endpoint, credential, {\n  selectors: [{ keyFilter: \"app:*\" }],\n  refreshOptions: {\n    enabled: true,\n    refreshIntervalInMs: 30_000,  // 30 seconds\n  },\n});\n\n// Trigger refresh (non-blocking)\nappConfig.refresh();\n\n// Listen for refresh events\nconst disposer = appConfig.onRefresh(() => {\n  console.log(\"Configuration refreshed!\");\n});\n\n// Express middleware pattern\napp.use((req, res, next) => {\n  appConfig.refresh();\n  next();\n});\n```\n\n### Key Vault References\n\n```typescript\nconst appConfig = await load(endpoint, credential, {\n  selectors: [{ keyFilter: \"app:*\" }],\n  keyVaultOptions: {\n    credential: new DefaultAzureCredential(),\n    secretRefreshIntervalInMs: 7200_000,  // 2 hours\n  },\n});\n\n// Secrets are automatically resolved\nconst dbPassword = appConfig.get(\"database:password\");\n```\n\n## Feature Flags\n\n### Create Feature Flag (Low-Level)\n\n```typescript\nimport {\n  featureFlagPrefix,\n  featureFlagContentType,\n  FeatureFlagValue,\n  ConfigurationSetting,\n} from \"@azure/app-configuration\";\n\nconst flag: ConfigurationSetting<FeatureFlagValue> = {\n  key: `${featureFlagPrefix}Beta`,\n  contentType: featureFlagContentType,\n  value: {\n    id: \"Beta\",\n    enabled: true,\n    description: \"Beta feature\",\n    conditions: {\n      clientFilters: [\n        {\n          name: \"Microsoft.Targeting\",\n          parameters: {\n            Audience: {\n              Users: [\"user@example.com\"],\n              Groups: [{ Name: \"beta-testers\", RolloutPercentage: 50 }],\n              DefaultRolloutPercentage: 0,\n            },\n          },\n        },\n      ],\n    },\n  },\n};\n\nawait client.addConfigurationSetting(flag);\n```\n\n### Load and Evaluate Feature Flags\n\n```typescript\nimport { load } from \"@azure/app-configuration-provider\";\nimport {\n  ConfigurationMapFeatureFlagProvider,\n  FeatureManager,\n} from \"@microsoft/feature-management\";\n\nconst appConfig = await load(endpoint, credential, {\n  featureFlagOptions: {\n    enabled: true,\n    selectors: [{ keyFilter: \"*\" }],\n    refresh: {\n      enabled: true,\n      refreshIntervalInMs: 30_000,\n    },\n  },\n});\n\nconst featureProvider = new ConfigurationMapFeatureFlagProvider(appConfig);\nconst featureManager = new FeatureManager(featureProvider);\n\n// Simple check\nconst isEnabled = await featureManager.isEnabled(\"Beta\");\n\n// With targeting context\nconst isEnabledForUser = await featureManager.isEnabled(\"Beta\", {\n  userId: \"user@example.com\",\n  groups: [\"beta-testers\"],\n});\n```\n\n## Snapshots\n\n```typescript\n// Create snapshot\nconst snapshot = await client.beginCreateSnapshotAndWait({\n  name: \"release-v1.0\",\n  retentionPeriod: 2592000,  // 30 days\n  filters: [{ keyFilter: \"app:*\", labelFilter: \"production\" }],\n});\n\n// Get snapshot\nconst snap = await client.getSnapshot(\"release-v1.0\");\n\n// List settings in snapshot\nconst settings = client.listConfigurationSettingsForSnapshot(\"release-v1.0\");\nfor await (const setting of settings) {\n  console.log(`${setting.key}: ${setting.value}`);\n}\n\n// Archive/recover\nawait client.archiveSnapshot(\"release-v1.0\");\nawait client.recoverSnapshot(\"release-v1.0\");\n\n// Load from snapshot (provider)\nconst config = await load(endpoint, credential, {\n  selectors: [{ snapshotName: \"release-v1.0\" }],\n});\n```\n\n## Labels\n\n```typescript\n// Create settings with labels\nawait client.setConfigurationSetting({\n  key: \"database:host\",\n  value: \"dev-db.example.com\",\n  label: \"development\",\n});\n\nawait client.setConfigurationSetting({\n  key: \"database:host\",\n  value: \"prod-db.example.com\",\n  label: \"production\",\n});\n\n// Filter by label\nconst prodSettings = client.listConfigurationSettings({\n  keyFilter: \"*\",\n  labelFilter: \"production\",\n});\n\n// No label (null label)\nconst noLabelSettings = client.listConfigurationSettings({\n  labelFilter: \"\\0\",\n});\n\n// List available labels\nfor await (const label of client.listLabels()) {\n  console.log(label.name);\n}\n```\n\n## Key Types\n\n```typescript\nimport {\n  AppConfigurationClient,\n  ConfigurationSetting,\n  FeatureFlagValue,\n  SecretReferenceValue,\n  featureFlagPrefix,\n  featureFlagContentType,\n  secretReferenceContentType,\n  ListConfigurationSettingsOptions,\n} from \"@azure/app-configuration\";\n\nimport { load } from \"@azure/app-configuration-provider\";\n\nimport {\n  FeatureManager,\n  ConfigurationMapFeatureFlagProvider,\n} from \"@microsoft/feature-management\";\n```\n\n## Best Practices\n\n1. **Use provider for apps** - `@azure/app-configuration-provider` for runtime config\n2. **Use low-level for management** - `@azure/app-configuration` for CRUD operations\n3. **Enable refresh** - For dynamic configuration updates\n4. **Use labels** - Separate configurations by environment\n5. **Use snapshots** - For immutable release configurations\n6. **Sentinel pattern** - Use a sentinel key to trigger full refresh\n7. **RBAC roles** - `App Configuration Data Reader` for read-only access\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.",
  "applicable_domains": [
    "devops"
  ],
  "category": "devops",
  "invocation": [
    "/azure-appconfiguration-ts"
  ],
  "authored_by": "claudeskills.in community",
  "source_url": "https://claudeskills.in/skill/azure-appconfiguration-ts",
  "provenance": {
    "source": "claudeskills.in",
    "source_url": "https://claudeskills.in/skill/azure-appconfiguration-ts",
    "license": "unknown",
    "imported_at": "2026-09-03",
    "notes": "Aggregated by claudeskills.in from community GitHub lists."
  },
  "tags": [
    "claudeskills",
    "devops"
  ],
  "lifecycle": "draft"
}