feat(api): update v3 spec (#4640)

Author: tothandras

api/spec/Makefile

@@ -19,6 +19,9 @@ generate: ## Generate OpenAPI spec
 		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
+	# Strip Go codegen vendor extensions from the v3 MeteringAndBilling output
+	@FILE="packages/aip/output/definitions/metering-and-billing/v3/openapi.MeteringAndBilling.yaml"; \
+	yq -i 'del(.. | select(has("x-go-type"))["x-go-type"], .. | select(has("x-go-type-import"))["x-go-type-import"])' "$$FILE"
 	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/customers/charges/operations.tsp

@@ -41,7 +41,6 @@ namespace Charges {
      * usage-based charges.
      */
     @extension(Shared.UnstableExtension, true)
-    @extension(Shared.InternalExtension, true)
     @get
     @operationId("list-customer-charges")
     @summary("List customer charges")
@@ -89,7 +88,6 @@ namespace Charges {
      * Create customer charge.
      */
     @extension(Shared.UnstableExtension, true)
-    @extension(Shared.InternalExtension, true)
     @post
     @operationId("create-customer-charges")
     @summary("Create customer charge")

api/spec/packages/aip/src/customers/credits/operations.tsp

@@ -43,7 +43,6 @@ namespace Credits.Grants {
      * credits to a customer.
      */
     @extension(Shared.UnstableExtension, true)
-    @extension(Shared.InternalExtension, true)
     @post
     @operationId("create-credit-grant")
     @summary("Create a new credit grant")
@@ -60,7 +59,6 @@ namespace Credits.Grants {
      * Get a credit grant.
      */
     @extension(Shared.UnstableExtension, true)
-    @extension(Shared.InternalExtension, true)
     @get
     @operationId("get-credit-grant")
     @summary("Get a credit grant")
@@ -73,7 +71,6 @@ namespace Credits.Grants {
      * List credit grants.
      */
     @extension(Shared.UnstableExtension, true)
-    @extension(Shared.InternalExtension, true)
     @get
     @operationId("list-credit-grants")
     @summary("List credit grants")
@@ -133,7 +130,6 @@ namespace Credits.Grants {
      * the system so that revenue recognition and credit availability work as expected.
      */
     @extension(Shared.UnstableExtension, true)
-    @extension(Shared.InternalExtension, true)
     @post
     @operationId("update-credit-grant-external-settlement")
     @summary("Update credit grant external settlement status")
@@ -171,7 +167,6 @@ namespace Credits.Balance {
      * Get a credit balance.
      */
     @extension(Shared.UnstableExtension, true)
-    @extension(Shared.InternalExtension, true)
     @get
     @operationId("get-customer-credit-balance")
     @summary("Get a customer's credit balance")
@@ -230,7 +225,6 @@ namespace Credits.Transactions {
      * by default.
      */
     @extension(Shared.UnstableExtension, true)
-    @extension(Shared.InternalExtension, true)
     @get
     @operationId("list-credit-transactions")
     @summary("List credit transactions")
@@ -261,7 +255,6 @@ namespace Credits.Adjustments {
      * - Usage correction
      */
     @extension(Shared.UnstableExtension, true)
-    @extension(Shared.InternalExtension, true)
     @post
     @operationId("create-credit-adjustment")
     @summary("Create a credit adjustment")

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

@@ -16,7 +16,6 @@ interface OrganizationDefaultTaxCodesOperations {
   @operationId("get-organization-default-tax-codes")
   @summary("Get organization default tax codes")
   @extension(Shared.UnstableExtension, true)
-  @extension(Shared.InternalExtension, true)
   get():
     | Shared.GetResponse<OrganizationDefaultTaxCodes>
     | Common.NotFound
@@ -26,7 +25,6 @@ interface OrganizationDefaultTaxCodesOperations {
   @operationId("update-organization-default-tax-codes")
   @summary("Update organization default tax codes")
   @extension(Shared.UnstableExtension, true)
-  @extension(Shared.InternalExtension, true)
   update(@body body: Shared.UpdateRequest<OrganizationDefaultTaxCodes>):
     | Shared.UpsertResponse<OrganizationDefaultTaxCodes>
     | Common.NotFound

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

@@ -17,7 +17,6 @@ interface TaxCodesOperations {
   @post
   @operationId("create-tax-code")
   @summary("Create tax code")
-  @extension(Shared.InternalExtension, true)
   @extension(Shared.UnstableExtension, true)
   create(
     @body
@@ -27,7 +26,6 @@ interface TaxCodesOperations {
   @get
   @operationId("get-tax-code")
   @summary("Get tax code")
-  @extension(Shared.InternalExtension, true)
   @extension(Shared.UnstableExtension, true)
   get(@path taxCodeId: Shared.ULID):
     | Shared.GetResponse<TaxCode>
@@ -37,7 +35,6 @@ interface TaxCodesOperations {
   @get
   @operationId("list-tax-codes")
   @summary("List tax codes")
-  @extension(Shared.InternalExtension, true)
   @extension(Shared.UnstableExtension, true)
   list(
     ...Common.PagePaginationQuery,
@@ -52,7 +49,6 @@ interface TaxCodesOperations {
   @put
   @operationId("upsert-tax-code")
   @summary("Upsert tax code")
-  @extension(Shared.InternalExtension, true)
   @extension(Shared.UnstableExtension, true)
   upsert(
     @path taxCodeId: Shared.ULID,
@@ -68,7 +64,6 @@ interface TaxCodesOperations {
   @delete
   @operationId("delete-tax-code")
   @summary("Delete tax code")
-  @extension(Shared.InternalExtension, true)
   @extension(Shared.UnstableExtension, true)
   delete(@path taxCodeId: Shared.ULID):
     | Shared.DeleteResponse

api/spec/packages/legacy/package.json

@@ -28,6 +28,7 @@
     "@typespec/openapi3": "1.11.0",
     "@typespec/prettier-plugin-typespec": "1.12.0",
     "@typespec/rest": "0.81.0",
+    "@typespec/streams": "0.81.0",
     "@typespec/versioning": "0.81.0"
   },
   "private": true,