chore(clerk-js,backend): Replace /commerce endpoints with /billing endpoints

Author: panteliselef

.changeset/young-nails-matter.md

@@ -0,0 +1,6 @@
+---
+'@clerk/clerk-js': patch
+'@clerk/backend': patch
+---
+
+Replace `/commerce` endpoints with `/billing` endpoints.

packages/backend/src/api/endpoints/BillingApi.ts

@@ -7,7 +7,7 @@ import type { BillingSubscriptionItem } from '../resources/CommerceSubscriptionI
 import type { PaginatedResourceResponse } from '../resources/Deserializer';
 import { AbstractAPI } from './AbstractApi';
 
-const basePath = '/commerce';
+const basePath = '/billing';
 const organizationBasePath = '/organizations';
 const userBasePath = '/users';
 

packages/clerk-js/src/core/modules/billing/namespace.ts

@@ -28,7 +28,7 @@ import {
 } from '../../resources/internal';
 
 export class Billing implements BillingNamespace {
-  static readonly #pathRoot = '/commerce';
+  static readonly #pathRoot = '/billing';
   static path(subPath: string, param?: { orgId?: string }): string {
     const { orgId } = param || {};
     const prefix = orgId ? `/organizations/${orgId}` : '/me';
@@ -39,7 +39,7 @@ export class Billing implements BillingNamespace {
     const { for: forParam, ...safeParams } = params || {};
     const searchParams = { ...safeParams, payer_type: forParam === 'organization' ? 'org' : 'user' };
     return await BaseResource._fetch({
-      path: `/commerce/plans`,
+      path: Billing.path('/plans'),
       method: 'GET',
       search: convertPageToOffsetSearchParams(searchParams),
     }).then(res => {
@@ -55,15 +55,15 @@ export class Billing implements BillingNamespace {
   // Inconsistent API
   getPlan = async (params: { id: string }): Promise<BillingPlanResource> => {
     const plan = (await BaseResource._fetch({
-      path: `/commerce/plans/${params.id}`,
+      path: Billing.path(`/plans/${params.id}`),
       method: 'GET',
     })) as unknown as BillingPlanJSON;
     return new BillingPlan(plan);
   };
 
   getSubscription = async (params: GetSubscriptionParams): Promise<BillingSubscriptionResource> => {
     return await BaseResource._fetch({
-      path: params.orgId ? `/organizations/${params.orgId}/commerce/subscription` : `/me/commerce/subscription`,
+      path: Billing.path(`/subscription`, { orgId: params.orgId }),
       method: 'GET',
     }).then(res => new BillingSubscription(res?.response as BillingSubscriptionJSON));
   };
@@ -72,7 +72,7 @@ export class Billing implements BillingNamespace {
     const { orgId, ...rest } = params;
 
     return await BaseResource._fetch({
-      path: orgId ? `/organizations/${orgId}/commerce/statements` : `/me/commerce/statements`,
+      path: Billing.path(`/statements`, { orgId }),
       method: 'GET',
       search: convertPageToOffsetSearchParams(rest),
     }).then(res => {
@@ -89,9 +89,7 @@ export class Billing implements BillingNamespace {
   getStatement = async (params: { id: string; orgId?: string }): Promise<BillingStatementResource> => {
     const statement = (
       await BaseResource._fetch({
-        path: params.orgId
-          ? `/organizations/${params.orgId}/commerce/statements/${params.id}`
-          : `/me/commerce/statements/${params.id}`,
+        path: Billing.path(`/statements/${params.id}`, { orgId: params.orgId }),
         method: 'GET',
       })
     )?.response as unknown as BillingStatementJSON;
@@ -104,7 +102,7 @@ export class Billing implements BillingNamespace {
     const { orgId, ...rest } = params;
 
     return await BaseResource._fetch({
-      path: orgId ? `/organizations/${orgId}/commerce/payment_attempts` : `/me/commerce/payment_attempts`,
+      path: Billing.path(`/payment_attempts`, { orgId }),
       method: 'GET',
       search: convertPageToOffsetSearchParams(rest),
     }).then(res => {
@@ -119,9 +117,7 @@ export class Billing implements BillingNamespace {
 
   getPaymentAttempt = async (params: { id: string; orgId?: string }): Promise<BillingPaymentResource> => {
     const paymentAttempt = (await BaseResource._fetch({
-      path: params.orgId
-        ? `/organizations/${params.orgId}/commerce/payment_attempts/${params.id}`
-        : `/me/commerce/payment_attempts/${params.id}`,
+      path: Billing.path(`/payment_attempts/${params.id}`, { orgId: params.orgId }),
       method: 'GET',
     })) as unknown as BillingPaymentJSON;
     return new BillingPayment(paymentAttempt);
@@ -131,7 +127,7 @@ export class Billing implements BillingNamespace {
     const { orgId, ...rest } = params;
     const json = (
       await BaseResource._fetch<BillingCheckoutJSON>({
-        path: orgId ? `/organizations/${orgId}/commerce/checkouts` : `/me/commerce/checkouts`,
+        path: Billing.path(`/checkouts`, { orgId }),
         method: 'POST',
         body: rest as any,
       })

packages/clerk-js/src/core/resources/BillingCheckout.ts

@@ -13,6 +13,7 @@ import type {
 import { unixEpochToDate } from '@/utils/date';
 
 import { billingTotalsFromJSON } from '../../utils';
+import { Billing } from '../modules/billing/namespace';
 import { BillingPayer } from './BillingPayer';
 import { BaseResource, BillingPaymentMethod, BillingPlan } from './internal';
 
@@ -62,9 +63,7 @@ export class BillingCheckout extends BaseResource implements BillingCheckoutReso
     return retry(
       () =>
         this._basePatch({
-          path: this.payer.organizationId
-            ? `/organizations/${this.payer.organizationId}/commerce/checkouts/${this.id}/confirm`
-            : `/me/commerce/checkouts/${this.id}/confirm`,
+          path: Billing.path(`/checkouts/${this.id}/confirm`, { orgId: this.payer.organizationId }),
           body: params as any,
         }),
       {

packages/clerk-js/src/core/resources/BillingPaymentSource.ts

@@ -9,6 +9,7 @@ import type {
   RemovePaymentMethodParams,
 } from '@clerk/types';
 
+import { Billing } from '../modules/billing/namespace';
 import { BaseResource, DeletedObject } from './internal';
 
 export class BillingPaymentMethod extends BaseResource implements BillingPaymentMethodResource {
@@ -47,9 +48,7 @@ export class BillingPaymentMethod extends BaseResource implements BillingPayment
     const { orgId } = params ?? {};
     const json = (
       await BaseResource._fetch({
-        path: orgId
-          ? `/organizations/${orgId}/commerce/payment_sources/${this.id}`
-          : `/me/commerce/payment_sources/${this.id}`,
+        path: Billing.path(`/payment_sources/${this.id}`, { orgId }),
         method: 'DELETE',
       })
     )?.response as unknown as DeletedObjectJSON;
@@ -60,9 +59,7 @@ export class BillingPaymentMethod extends BaseResource implements BillingPayment
   public async makeDefault(params?: MakeDefaultPaymentMethodParams) {
     const { orgId } = params ?? {};
     await BaseResource._fetch({
-      path: orgId
-        ? `/organizations/${orgId}/commerce/payers/default_payment_source`
-        : `/me/commerce/payers/default_payment_source`,
+      path: Billing.path(`/payers/default_payment_source`, { orgId }),
       method: 'PUT',
       body: { payment_source_id: this.id } as any,
     });

packages/clerk-js/src/core/resources/BillingSubscription.ts

@@ -13,6 +13,7 @@ import type {
 import { unixEpochToDate } from '@/utils/date';
 
 import { billingMoneyAmountFromJSON } from '../../utils';
+import { Billing } from '../modules/billing/namespace';
 import { BaseResource, BillingPlan, DeletedObject } from './internal';
 
 export class BillingSubscription extends BaseResource implements BillingSubscriptionResource {
@@ -110,9 +111,7 @@ export class BillingSubscriptionItem extends BaseResource implements BillingSubs
     const { orgId } = params;
     const json = (
       await BaseResource._fetch({
-        path: orgId
-          ? `/organizations/${orgId}/commerce/subscription_items/${this.id}`
-          : `/me/commerce/subscription_items/${this.id}`,
+        path: Billing.path(`/subscription_items/${this.id}`, { orgId }),
         method: 'DELETE',
       })
     )?.response as unknown as DeletedObjectJSON;