Feature/add policy fragment and product

[simonkurtz-MSFT]

Resolves #19

[github-actions]

Python 3.13 Test Results

101 tests  +12   101 ✅ +12   1s ⏱️ ±0s
  1 suites ± 0     0 💤 ± 0 
  1 files   ± 0     0 ❌ ± 0 

Results for commit 9927f28. ± Comparison against base commit 001feeb.

[github-actions]

Python 3.12 Test Results

101 tests  +12   101 ✅ +12   1s ⏱️ ±0s
  1 suites ± 0     0 💤 ± 0 
  1 files   ± 0     0 ❌ ± 0 

Results for commit 9927f28. ± Comparison against base commit 001feeb.

[Copilot]

Pull Request Overview

Adds support for reusable policy fragments and product associations in APIM modules and samples.

• Introduces a new policy-fragment.bicep module to create/manage APIM policy fragments.
• Extends api.bicep with a productNames parameter, conditional resource association to products, and related outputs.
• Updates sample Bicep and XML policy files to wire in policy fragments, product links, and use !empty() checks.

Reviewed Changes

Copilot reviewed 23 out of 23 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
shared/bicep/modules/apim/v1/policy-fragment.bicep	New module for defining and outputting APIM policy fragments
shared/bicep/modules/apim/v1/api.bicep	Added productNames param, refined conditions for policies/operations, and product association resource and outputs
shared/apim-policies/fragments/pf-http-response-200.xml	Added HTTP-200 response policy fragment
shared/apim-policies/fragments/pf-authz-match-any.xml	Added authorization match-any policy fragment
samples/*/main.bicep & _TEMPLATE/main.bicep	Switched length(...) > 0 to !empty(...) for arrays in sample modules
samples/authX-pro/main.bicep & related XML/IPython notebooks	Wired in policy fragments, products, and updated README link
README.md	Added AuthX Pro sample entry

Comments suppressed due to low confidence (2)

shared/bicep/modules/apim/v1/policy-fragment.bicep:60

• [nitpick] The output policyFragmentName shadows the input parameter name; consider renaming the output (e.g., createdPolicyFragmentName) to avoid confusion.

output policyFragmentName string = policyFragment.name

shared/bicep/modules/apim/v1/api.bicep:149

• There are two closing braces on this line which appears to over-close the backend and properties blocks; remove the extra } to balance the resource declaration.

    }  }

[Copilot]

The link path uses lowercase authx-pro, but the folder is named authX-pro; adjust casing so the link resolves correctly on case-sensitive file systems.

[Copilot]

[nitpick] These commented-out outputs for associated products and count should be either removed if obsolete or uncommented and implemented to avoid dead code clutter.

Suggested change

	// @description('Array of product names this API is associated with.')
	// output associatedProducts string[] = productNames
	// @description('Number of products this API is associated with.')
	// output productAssociationCount int = length(productNames)
	@description('Array of product names this API is associated with.')
	output associatedProducts string[] = productNames
	@description('Number of products this API is associated with.')
	output productAssociationCount int = length(productNames)

[Copilot]

[nitpick] Consider adding a module-level header comment to document the new productNames parameter alongside the existing parameters section for consistency.