chore(clerk-js,types,shared): Deprecate __unstable methods for orga…

…nizations (#1879)

* chore(clerk-js,types,shared): Deprecate `__unstable` methods for organizations

* Update light-coats-brush.md

---------

Co-authored-by: Nikos Douvlis <nikosdouvlis@gmail.com>

.changeset/light-coats-brush.md

@@ -0,0 +1,7 @@
+---
+'@clerk/clerk-js': patch
+'@clerk/shared': patch
+'@clerk/types': patch
+---
+
+Deprecate the `organization.__unstable__invitationUpdate` and `organization.__unstable__membershipUpdate` methods.

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

@@ -170,7 +170,14 @@ export default class Clerk implements ClerkInterface {
   #fapiClient: FapiClient;
   #instanceType: InstanceType;
   #isReady = false;
+
+  /**
+   * @deprecated Although this being a private field, this is a reminder to drop it with the next major release
+   */
   #lastOrganizationInvitation: OrganizationInvitationResource | null = null;
+  /**
+   * @deprecated Although this being a private field, this is a reminder to drop it with the next major release
+   */
   #lastOrganizationMember: OrganizationMembershipResource | null = null;
   #listeners: Array<(emission: Resources) => void> = [];
   #options: ClerkOptions = {};
@@ -1185,12 +1192,28 @@ export default class Clerk implements ClerkInterface {
     this.#emit();
   };
 
+  /**
+   * @deprecated This method will be dropped in the next major release.
+   * This method is only used in another deprecated part: `invitationList` from useOrganization
+   */
   __unstable__invitationUpdate(invitation: OrganizationInvitationResource) {
+    deprecated(
+      '__unstable__invitationUpdate',
+      'We are completely dropping this method as it was introduced for internal use only',
+    );
     this.#lastOrganizationInvitation = invitation;
     this.#emit();
   }
 
+  /**
+   * @deprecated This method will be dropped in the next major release.
+   * This method is only used in another deprecated part: `membershipList` from useOrganization
+   */
   __unstable__membershipUpdate(membership: OrganizationMembershipResource) {
+    deprecated(
+      '__unstable__invitationUpdate',
+      'We are completely dropping this method as it was introduced for internal use only',
+    );
     this.#lastOrganizationMember = membership;
     this.#emit();
   }

packages/shared/src/hooks/contexts.tsx

@@ -25,7 +25,16 @@ const [SessionContext, useSessionContext] = createContextAndHook<ActiveSessionRe
 
 type OrganizationContextProps = {
   organization: OrganizationResource | null | undefined;
+
+  /**
+   * @deprecated This property will be dropped in the next major release.
+   * This property is only used in another deprecated part: `invitationList` from useOrganization
+   */
   lastOrganizationInvitation: OrganizationInvitationResource | null | undefined;
+  /**
+   * @deprecated This property will be dropped in the next major release.
+   * This property is only used in another deprecated part: `membershipList` from useOrganization
+   */
   lastOrganizationMember: OrganizationMembershipResource | null | undefined;
 };
 const [OrganizationContextInternal, useOrganizationContext] = createContextAndHook<{

packages/types/src/clerk.ts

@@ -554,7 +554,15 @@ export interface Resources {
   session?: ActiveSessionResource | null;
   user?: UserResource | null;
   organization?: OrganizationResource | null;
+  /**
+   * @deprecated This property will be dropped in the next major release.
+   * This property is only used in another deprecated part: `invitationList` from useOrganization
+   */
   lastOrganizationInvitation?: OrganizationInvitationResource | null;
+  /**
+   * @deprecated This property will be dropped in the next major release.
+   * This property is only used in another deprecated part: `membershipList` from useOrganization
+   */
   lastOrganizationMember?: OrganizationMembershipResource | null;
 }