@stripchatdev/ext-helper 0.1.15 → 0.1.16

package/dist/index.d.ts

@@ -63,6 +63,9 @@ export declare type TExtPageResolverMethods = {
     };
 };
 
+/** Unique identifier for a guest user **/
+export declare type TGuestHash = string;
+
 export declare type TMethods = TV1Methods;
 
 export declare type TModelId = TUserId;
@@ -163,6 +166,52 @@ declare type TV1ExtEvents = {
     'v1.ext.whispered.local': TV1WhisperData;
 };
 
+/** Guest user (not logged in). */
+export declare type TV1ExtGuestUser = {
+    /** Unique identifier for a guest user. */
+    guestHash: TGuestHash;
+    /** User is a guest (not logged in). */
+    isGuest: true;
+};
+
+/** Logged-in user. */
+export declare type TV1ExtLoggedInUser = {
+    /** User's fan club data. Contains information regarding user's subscription to the model's fan club.  */
+    fanClub: TV1UsersFanClub;
+    /** User previously purchased tokens. */
+    hasPaidBefore: boolean;
+    /** User has tokens. */
+    hasTokens: boolean;
+    /** User currently has Ultimate membership. */
+    hasUltimateSubscription: boolean;
+    /** User ID. */
+    id: TUserId;
+    /** User is logged in. */
+    isGuest: false;
+    /** User is the highest tipper in the room over past 12 hours. */
+    isKing: boolean;
+    /** User is a knight of the model. */
+    isKnight: boolean;
+    /** Current user is a model. */
+    isModel: boolean;
+    /**
+     * Current show/session state for this user.
+     *
+     * - `public` — public broadcast context
+     * - `private` — private show context
+     * - `exclusivePrivate` — exclusive private show context
+     * - `groupShow` — group show context
+     * - `ticketShow` — ticket show context
+     * - `off` — offline
+     * - `spy` — spying on a private show
+     */
+    status: TV1UserStatus;
+    /** User username. */
+    username: string;
+    /** User activity ranking data when available. */
+    userRanking?: TV1UserRanking;
+};
+
 declare type TV1ExtMethods = {
     'v1.ext.actions.call': {
         params: TV1ActionRequestParams;
@@ -205,6 +254,7 @@ declare type TV1ExtMethods = {
             settings: TV1ExtSettings;
         };
     };
+    /** Opens Stripchat sign-up dialog for anonymous users. Use this when your extension requires a registered account to function */
     'v1.ext.signup.open': {
         params: {
             type: 'user';
@@ -269,34 +319,7 @@ export declare type TV1ExtModel = {
 
 export declare type TV1ExtSettings = unknown;
 
-export declare type TV1ExtUser = {
-    /** User previously purchased tokens */
-    hasPaidBefore: boolean;
-    /** User has tokens */
-    hasTokens: boolean;
-    /** User currently has Ultimate membership */
-    hasUltimateSubscription: boolean;
-    /** User ID. */
-    id: TUserId;
-    /** Current user is a model. */
-    isModel: boolean;
-    /**
-     * Current show/session state for this user.
-     *
-     * - `public` — public broadcast context
-     * - `private` — private show context
-     * - `exclusivePrivate` — exclusive private show context
-     * - `groupShow` — group show context
-     * - `ticketShow` — ticket show context
-     * - `off` — offline
-     * - `spy` — spying on a private show
-     */
-    status: TV1UserStatus;
-    /** User username. */
-    username: string;
-    /** User activity ranking data when available. */
-    userRanking?: TV1UserRanking;
-};
+export declare type TV1ExtUser = TV1ExtGuestUser | TV1ExtLoggedInUser;
 
 export declare type TV1Genders = 'male' | 'female' | 'group' | 'tranny';
 
@@ -692,6 +715,26 @@ export declare type TV1UserRanking = {
     level: number;
 };
 
+export declare type TV1UsersFanClub = TV1UsersFanClubSubscribed | TV1UsersFanClubNotSubscribed;
+
+export declare type TV1UsersFanClubNotSubscribed = {
+    /** Whether user is subscribed to the model's fan club or not */
+    isSubscribed: false;
+};
+
+export declare type TV1UsersFanClubSubscribed = {
+    /** Whether user is subscribed to the model's fan club or not */
+    isSubscribed: true;
+    /** The tier of the fan club subscription. Could be `soldier`, `lord` or `prince`.
+     *  The higher the tier, the more benefits the user gets.
+     *
+     * `Soldier` is the first tier. It has basic benefits
+     * `Lord` is the second tier. It has more benefits than `soldier`
+     * `Prince` is the third tier. It has the most benefits.
+     * **/
+    tier: 'soldier' | 'lord' | 'prince';
+};
+
 export declare type TV1UserStatus = Exclude<(typeof V1_SHOW_STATUSES)[keyof typeof V1_SHOW_STATUSES], 'idle'>;
 
 export declare type TV1WhisperData = TUnknownDictionary;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stripchatdev/ext-helper",
   "private": false,
-  "version": "0.1.15",
+  "version": "0.1.16",
   "license": "Apache-2.0",
   "type": "module",
   "module": "./dist/ext-helper.js",