@thefittingroom/sdk 0.0.7 → 0.0.9

package/README.md

@@ -58,30 +58,50 @@ const shop = initShop(brandId, env)
 await shop.onInit()
 
 // Login user with session
-shop.user.login(username, password)
+shop.user.login(email, password)
 
 // Logout current user
 shop.user.logout()
 
-// Submit telephone number for link to iOS app
+// In order for the user to create an avatar, they'll need to download the mobile application.
+// This will send an SMS to the given phone number with a link to the iOS app
 // No spaces and must include country code e.g. +18005551234
 shop.submitTelephoneNumber(tel)
+
+// await for the avatar creation
+// Returns boolean on whether the avatar is created or not after the configured `avatarTimeout` period
+shop.awaitAvatarCreated()
 ```
 
 #### Shop
 
+We'll make references to `sku` several times here. This is the unique identifier that matches a styles particular size
+from your inventory to our system.
+
 ```typescript
-// returns frames: types.TryOnFrames
-shop.tryOn(colorwaySizeAssetSku)
+// A good first step would be to ensure your style and size exists in the fitting room system before executing any of the
+// following functions. You'll get back some data about the style(s), such as the ID of the style, which you can use
+// for the getRecommendedSizes function below.
+// ids: number[] or skus: string[]
+// At least one parameter must not be null
+shop.getStyles(ids, skus)
 
-// await for the avatar creation
-shop.awaitAvatarCreated()
+// get recommended sizes for a particular style
+// The styleID can be extracted from the previous getStyles function call.
+const sizeRecommendation = shop.getRecommendedSizes(styleID)
 
-// get recommended sizes for use
-shop.getRecommendedSizes()
+// get recommended sizes label for a particular style
+// returns: { recommendedSizeLabel, availableSizeLabels }
+// recommendedSizeLabel: string
+// availableSizeLabels: string[]
+const { recommendedSizeLabel, availableSizeLabels } = shop.getRecommendedSizesLabels(styleID)
 
-// get available styles by ids: number[] or skus: string[]
-shop.getStyles(ids, skus)
+// Once the user has downloaded the mobile application and has created an avatar, they may now virtually try on a size.
+// The size they try on must be one of the recommended sizes from the previous function call. or an error will get returned.
+// returns frames: types.TryOnFrames
+// These `frames` are images that can be used to cycle through the VTO 360 degrees.
+// NOTE: this process can take a minute or two
+const frames = await this.shop.tryOn(sku)
 ```
 
 #### Errors

package/dist/esm/api/shop.d.ts

@@ -12,7 +12,11 @@ export declare class TfrShop {
     onInit(): Promise<boolean>;
     tryOn(colorwaySizeAssetSku: string): Promise<types.TryOnFrames>;
     awaitAvatarCreated(): Promise<boolean>;
-    getRecommendedSizes(brandStyleId: string): Promise<SizeRecommendation>;
+    getRecommendedSizes(styleId: string): Promise<SizeRecommendation>;
+    getRecommendedSizesLabels(styleId: string): Promise<{
+        recommendedSizeLabel: string;
+        availableSizeLabels: string[];
+    }>;
     getStyles(ids: number[], skus: string[]): Promise<Map<number, types.FirestoreStyle>>;
     submitTelephoneNumber(tel: string): Promise<void>;
     private awaitColorwaySizeAssetFrames;

package/dist/esm/helpers/errors.d.ts

@@ -6,6 +6,9 @@ export interface ErrorOutsideRecommendedSizes {
     recommended_size_id: number;
     available_size_ids: number[];
 }
+export declare class AvatarNotCreatedError extends Error {
+    constructor();
+}
 export declare class NoFramesFoundError extends Error {
     constructor();
 }
@@ -26,3 +29,4 @@ export declare class RecommendedAvailableSizesError extends Error {
     available_sizes: string[];
     constructor(recommended_size: string, available_sizes: string[]);
 }
+export declare const AvatarNotCreated = "avatar not created";

package/dist/esm/index.js

@@ -1,5 +1,5 @@
 /*!
-* thefittingroom v0.0.7 (2023-07-19T15:29:31.094Z)
+* thefittingroom v0.0.9 (2023-07-26T23:07:17.052Z)
 * Copyright 2022-present, TheFittingRoom, Inc. All rights reserved.
 */
 /**
@@ -22724,6 +22724,12 @@ function getAuth(app = getApp()) {
 }
 registerAuth("Browser" /* ClientPlatform.BROWSER */);
 
+class AvatarNotCreatedError extends Error {
+    constructor() {
+        super('Avatar not created');
+        this.name = 'AvatarNotCreatedError';
+    }
+}
 class NoFramesFoundError extends Error {
     constructor() {
         super('no frames found');
@@ -22762,15 +22768,19 @@ class RecommendedAvailableSizesError extends Error {
         this.available_sizes = available_sizes;
     }
 }
+// Backend responses
+const AvatarNotCreated = 'avatar not created';
 
 var errors = /*#__PURE__*/Object.freeze({
     __proto__: null,
+    AvatarNotCreatedError: AvatarNotCreatedError,
     NoFramesFoundError: NoFramesFoundError,
     RequestTimeoutError: RequestTimeoutError,
     UserNotLoggedInError: UserNotLoggedInError,
     NoColorwaySizeAssetsFoundError: NoColorwaySizeAssetsFoundError,
     NoStylesFoundError: NoStylesFoundError,
-    RecommendedAvailableSizesError: RecommendedAvailableSizesError
+    RecommendedAvailableSizesError: RecommendedAvailableSizesError,
+    AvatarNotCreated: AvatarNotCreated
 });
 
 class FirebaseUser {
@@ -22983,12 +22993,25 @@ class TfrShop {
         const userProfile = snapshot.docs[0].data();
         return userProfile.avatar_status === 'CREATED';
     }
-    async getRecommendedSizes(brandStyleId) {
+    async getRecommendedSizes(styleId) {
         if (!this.isLoggedIn)
             throw new UserNotLoggedInError();
-        const res = await Fetcher.Get(this.user, `/styles/${brandStyleId}/recommendation`);
-        const json = await res.json();
-        return json;
+        try {
+            const res = await Fetcher.Get(this.user, `/styles/${styleId}/recommendation`);
+            const json = await res.json();
+            return json;
+        }
+        catch (error) {
+            if ((error === null || error === void 0 ? void 0 : error.error) === AvatarNotCreated)
+                throw new AvatarNotCreatedError();
+            throw error;
+        }
+    }
+    async getRecommendedSizesLabels(styleId) {
+        const sizeRecommendation = await this.getRecommendedSizes(styleId);
+        const recommendedSizeLabel = sizeRecommendation.recommended_sizes.label || sizeRecommendation.recommended_sizes.size_value.size;
+        const availableSizeLabels = sizeRecommendation.available_sizes.map((size) => size.label || size.size_value.size);
+        return { recommendedSizeLabel, availableSizeLabels };
     }
     async getStyles(ids, skus) {
         const constraints = [rl('brand_id', '==', this.brandId)];
@@ -23034,6 +23057,8 @@ class TfrShop {
             return this.awaitColorwaySizeAssetFrames(colorwaySizeAssetSku);
         }
         catch (error) {
+            if ((error === null || error === void 0 ? void 0 : error.error) === AvatarNotCreated)
+                throw new AvatarNotCreatedError();
             if (!error.recommended_size_id)
                 throw new Error(error);
             const errorOutsideRecommended = error;