@thefittingroom/sdk 0.0.8 → 0.0.10

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/api/utils.d.ts

@@ -1 +1 @@
-export declare const TestImage: (url: string) => Promise<boolean>;
+export declare const testImage: (url: string) => Promise<boolean>;

package/dist/esm/firebase/firebase-user.d.ts

@@ -11,7 +11,7 @@ export declare class FirebaseUser {
     setUser(user: firebaseAuth.User): void;
     getToken(): Promise<string>;
     getUserProfile(): Promise<DocumentData>;
-    watchUserProfileForChanges(predicate: (data: QuerySnapshot<DocumentData>) => boolean, timeout: number): Promise<DocumentData>;
+    watchUserProfileForChanges(predicate: (data: QuerySnapshot<DocumentData>) => Promise<boolean>, timeout: number): Promise<DocumentData>;
     login(username: string, password: string): Promise<void>;
     logout(): Promise<void>;
     sendPasswordResetEmail(email: string): Promise<void>;

package/dist/esm/index.js

@@ -1,5 +1,5 @@
 /*!
-* thefittingroom v0.0.8 (2023-07-19T17:34:22.852Z)
+* thefittingroom v0.0.10 (2023-07-31T23:26:47.153Z)
 * Copyright 2022-present, TheFittingRoom, Inc. All rights reserved.
 */
 /**
@@ -22824,8 +22824,8 @@ class FirebaseUser {
         const q = sl(Ta(this.firestore, 'users'), rl(Eh(), '==', this.id));
         const cancel = setTimeout(() => unsub(), timeout);
         return new Promise((resolve) => {
-            unsub = jl(q, (snapshot) => {
-                if (!predicate(snapshot))
+            unsub = jl(q, async (snapshot) => {
+                if (!(await predicate(snapshot)))
                     return;
                 clearTimeout(cancel);
                 unsub();
@@ -22941,7 +22941,7 @@ class Fetcher {
     }
 }
 
-const TestImage = (url) => {
+const testImage = (url) => {
     const img = new Image();
     img.src = url;
     return new Promise((resolve) => {
@@ -22993,11 +22993,11 @@ 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();
         try {
-            const res = await Fetcher.Get(this.user, `/styles/${brandStyleId}/recommendation`);
+            const res = await Fetcher.Get(this.user, `/styles/${styleId}/recommendation`);
             const json = await res.json();
             return json;
         }
@@ -23007,6 +23007,12 @@ class TfrShop {
             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)];
         if ((ids === null || ids === void 0 ? void 0 : ids.length) > 0)
@@ -23035,7 +23041,13 @@ class TfrShop {
         var _a, _b, _c, _d;
         if (!this.isLoggedIn)
             throw new UserNotLoggedInError();
-        const predicate = (data) => { var _a, _b, _c; return Boolean((_c = (_b = (_a = data.docs[0].data()) === null || _a === void 0 ? void 0 : _a.vto) === null || _b === void 0 ? void 0 : _b[this.brandId]) === null || _c === void 0 ? void 0 : _c[colorwaySizeAssetSKU]); };
+        const predicate = async (data) => {
+            var _a, _b, _c, _d;
+            const frames = (_d = (_c = (_b = (_a = data.docs[0].data()) === null || _a === void 0 ? void 0 : _a.vto) === null || _b === void 0 ? void 0 : _b[this.brandId]) === null || _c === void 0 ? void 0 : _c[colorwaySizeAssetSKU]) === null || _d === void 0 ? void 0 : _d.frames;
+            if (!(frames === null || frames === void 0 ? void 0 : frames.length))
+                return false;
+            return testImage(frames[0]);
+        };
         const userProfile = (await this.user.watchUserProfileForChanges(predicate, TfrShop.vtoTimeout));
         if (!((_d = (_c = (_b = (_a = userProfile === null || userProfile === void 0 ? void 0 : userProfile.vto) === null || _a === void 0 ? void 0 : _a[this.brandId]) === null || _b === void 0 ? void 0 : _b[colorwaySizeAssetSKU]) === null || _c === void 0 ? void 0 : _c.frames) === null || _d === void 0 ? void 0 : _d.length))
             throw new NoFramesFoundError();
@@ -23104,7 +23116,7 @@ class TfrShop {
         const frames = ((_c = (_b = (_a = userProfile === null || userProfile === void 0 ? void 0 : userProfile.vto) === null || _a === void 0 ? void 0 : _a[this.brandId]) === null || _b === void 0 ? void 0 : _b[colorwaySizeAssetSKU]) === null || _c === void 0 ? void 0 : _c.frames) || [];
         if (!frames.length)
             throw new NoFramesFoundError();
-        const testedImage = await TestImage(frames[0]);
+        const testedImage = await testImage(frames[0]);
         if (!testedImage)
             throw new NoFramesFoundError();
         return frames;