chore(shared): Add experimental JSDoc for org.getSubscriptions

.changeset/happy-apes-open.md

@@ -0,0 +1,6 @@
+---
+'@clerk/shared': patch
+'@clerk/types': patch
+---
+
+[Billing Beta] Add experimental JSDoc for `org.getSubscriptions`.

packages/shared/src/react/hooks/useOrganization.tsx

@@ -67,6 +67,7 @@ export type UseOrganizationParams = {
    */
   invitations?: true | PaginatedHookConfig<GetInvitationsParams>;
   /**
+   * @experimental This is an experimental API for the Billing feature that is available under a public beta, and the API is subject to change.
    * If set to `true`, all default properties will be used.<br />
    * Otherwise, accepts an object with the following optional properties:
    * <ul>
@@ -111,6 +112,7 @@ export type UseOrganizationReturn<T extends UseOrganizationParams> =
        */
       invitations: PaginatedResourcesWithDefault<OrganizationInvitationResource>;
       /**
+       * @experimental This is an experimental API for the Billing feature that is available under a public beta, and the API is subject to change.
        * Includes a paginated list of the organization's subscriptions.
        */
       subscriptions: PaginatedResourcesWithDefault<CommerceSubscriptionResource>;

packages/types/src/organization.ts

@@ -56,6 +56,9 @@ export interface OrganizationResource extends ClerkResource, CommercePaymentSour
   getMembershipRequests: (
     params?: GetMembershipRequestParams,
   ) => Promise<ClerkPaginatedResponse<OrganizationMembershipRequestResource>>;
+  /**
+   * @experimental This is an experimental API for the Billing feature that is available under a public beta, and the API is subject to change.
+   */
   getSubscriptions: (params?: GetSubscriptionsParams) => Promise<ClerkPaginatedResponse<CommerceSubscriptionResource>>;
   addMember: (params: AddMemberParams) => Promise<OrganizationMembershipResource>;
   inviteMember: (params: InviteMemberParams) => Promise<OrganizationInvitationResource>;