feat(api): update spec (#4610)

Author: tothandras

api/spec/Makefile

@@ -13,6 +13,12 @@ generate: ## Generate OpenAPI spec
 			REF_VAL="$$AIP_REF/$$schema" SCHEMA="$$schema" yq -i '.components.schemas[strenv(SCHEMA)] = {"$$ref": strenv(REF_VAL)}' "$$FILE"; \
 		fi; \
 	done
+	# Prefix addon operationIds with `product-catalog-` for the v3 MeteringAndBilling output
+	@FILE="packages/aip/output/definitions/metering-and-billing/v3/openapi.MeteringAndBilling.yaml"; \
+	for op in list-addons create-addon update-addon get-addon delete-addon archive-addon publish-addon; do \
+		new_op="$${op/-addon/-product-catalog-addon}"; \
+		OLD_OP="$$op" NEW_OP="$$new_op" yq -i '(.paths[][] | select(.operationId == strenv(OLD_OP)) | .operationId) = strenv(NEW_OP)' "$$FILE"; \
+	done
 	pnpm --filter @openmeter/api-spec-aip exec openapi bundle output/definitions/metering-and-billing/v3/openapi.OpenMeter.yaml -o ../../../v3/openapi.yaml
 	cp packages/legacy/output/openapi.OpenMeter.yaml ../openapi.yaml
 	cp packages/legacy/output/openapi.OpenMeterCloud.yaml ../openapi.cloud.yaml

api/spec/packages/aip/src/invoices/operations.tsp

@@ -27,6 +27,9 @@ interface InvoicesOperations {
   @get
   @operationId("get-invoice")
   @summary("Get a billing invoice")
+  @extension(Shared.UnstableExtension, true)
+  @extension(Shared.InternalExtension, true)
+  @extension(Shared.PrivateExtension, true)
   get(@path invoiceId: Shared.ULID):
     | Shared.GetResponse<Invoice>
     | Common.NotFound

api/spec/packages/aip/src/konnect.tsp

@@ -24,7 +24,7 @@ using TypeSpec.OpenAPI;
  */
 @service(#{ title: "Konnect ${Shared.MeteringAndBillingTitle}" })
 @info(#{
-  version: "0.0.1",
+  version: "1.0.0",
   contact: #{ name: "Kong", url: "https://cloud.konghq.com" },
 })
 @server("https://us.api.konghq.com/v3", "United-States Production region")