sizebay-core-sdk 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [1.1.0](https://github.com/sizebay/events-sdk/compare/v1.0.1...v1.1.0) (2025-04-01)
+
+### Features
+
+* **tracker:** update TrackData types and documentation ([e7187f2](https://github.com/sizebay/events-sdk/commit/e7187f2ca7b5d0ecee3404b19bf3fa21f8c14953))
+
+## [1.0.1](https://github.com/sizebay/events-sdk/compare/v1.0.0...v1.0.1) (2025-04-01)
+
+### Bug Fixes
+
+* **ai-image-service:** correct endpoint configuration ([cc7c8f4](https://github.com/sizebay/events-sdk/commit/cc7c8f41b4961e6fdca62d87ef3de152351064cd))
+* **tracker:** update URL construction logic ([7be913c](https://github.com/sizebay/events-sdk/commit/7be913c8b81dfdd1543d4d843a83753955f5b83a))
+
 ## 1.0.0 (2025-03-31)
 
 ### Features

package/README.md

@@ -35,25 +35,63 @@ const client = createClient({
 
 ---
 
-### Tracker Module
+## Tracker Module
 
-#### `track(eventName: string, payload: EventPayload): Promise<any>`
-Sends an event to the designated API endpoint.
+#### `track(eventName: string, payload: TrackData): Promise<TrackResponse>`
+Sends an event to the designated API endpoint, returning a standardized response.
 
 **Parameters**
 
-| Parameter    | Type           | Required | Description                                      |
-|--------------|----------------|----------|--------------------------------------------------|
-| `eventName`  | `string`       | Yes      | The name of the event (e.g., "ADD_TO_CART", "ORDER").     |
-| `payload`    | `EventPayload` | Yes      | An object containing event data.               |
+| Parameter   | Type        | Required | Description                                                           |
+|-------------|-------------|----------|-----------------------------------------------------------------------|
+| `eventName` | `string`    | Yes      | The name of the event (e.g., "ADD_TO_CART", "ORDER").                 |
+| `payload`   | `TrackData` | Yes      | An object containing event data. See the structure of `TrackData` below. |
+
+**TrackData Structure**
+
+| Property    | Type                          | Required | Description                                                           |
+|-------------|-------------------------------|----------|-----------------------------------------------------------------------|
+| **sid**     | `string`                      | Yes      | Unique session identifier.                                            |
+| **tenantId**| `number`                      | Yes      | Identifier of the tenant (client) sending the event.                  |
+| **sessionId**| `number`                     | Yes      | Internal session identifier.                                          |
+| **permalink**| `string` (optional)          | No       | Product URL associated with the event. When the event is linked to product (e.g., ADD_TO_CART RECOMMENDATION_DONE), it is required.                              |
+| **properties**| `Record<string, JSONValue>` | Yes      | Object containing additional properties as key-value pairs.           |
+**Returns**
+
+- **201** – Event successfully created.
+  ```json
+  {
+    "statusCode": 201,
+    "message": "Event successfully created."
+  }
+  ```
+- **400** – Invalid or missing fields.
+  ```json
+  {
+    "statusCode": 400,
+    "error": "Bad Request",
+    "message": [
+      "tenantId must be an integer number"
+    ]
+  }
+  ```
+- **500** – Internal server error.
+  ```json
+  {
+    "statusCode": 500,
+    "error": "Internal server error",
+    "message": [
+      "Unexpected error on server side"
+    ]
+  }
+  ```
 
 **Example**
 
 ```typescript
-const eventPayload = {
+const eventPayload: TrackData = {
   sid: 'a0cf8559-926a-4a75-b4ca-7c4c13fed69c',
   tenantId: 123,
-  eventName: 'ADD_TO_CART',
   sessionId: 123,
   permalink: 'https://www.example.com/2IC-7370',
   properties: {
@@ -66,40 +104,63 @@ const eventPayload = {
 async function trackEvent() {
   try {
     const response = await client.track('ADD_TO_CART', eventPayload);
-    console.log('Event tracked successfully:', response);
+
+    if (response.statusCode === 201) {
+      console.log('Event tracked successfully:', response.message);
+    } else {
+      console.error(
+        `Error tracking event (${response.statusCode}):`,
+        response.error,
+        response.message
+      );
+    }
   } catch (error: any) {
-    console.error('Error tracking event:', error.message);
+    console.error('Unexpected error tracking event:', error.message);
   }
 }
 
 trackEvent();
 ```
 
----
+## AI Image Service Module
 
-### AI Image Service Module
+### `getSimilarProducts(params: GetSimilarProductsParams): Promise<GetSimilarProductsResponse>`
 
-#### `getSimilarProducts(params: GetSimilarProductsParams): Promise<GetSimilarProductsResponse>`
-Fetches similar products based on the provided image parameters.
+Fetches similar products based on the given parameters, returning a paginated result.
 
-**Parameters**
+#### Parameters
 
-| Parameter | Type                       | Required | Description                                                |
-|-----------|----------------------------|----------|------------------------------------------------------------|
-| `params`  | `GetSimilarProductsParams` | Yes      | An object containing parameters for fetching similar products. |
+| Parameter        | Type                           | Required | Description                                                                              |
+|------------------|--------------------------------|:--------:|------------------------------------------------------------------------------------------|
+| `tenantId`       | `number`                       | **Yes**  | The tenant ID that initiated the request.                                               |
+| `collectionName` | `string`                       | **Yes**  | The name of the relevant product collection.                                            |
+| `sessionId`      | `number`                       | **Yes**  | The session ID, typically required for internal event tracking.                         |
+| `permalink`      | `string`                       | **Yes**  | A permanent link representing the main product.                                         |
+| `page`           | `number` (optional)            | No       | Page number for pagination.                                                             |
+| `perPage`        | `number` (optional)            | No       | Number of items per page.                                                               |
 
-**Example**
+#### Returns
+
+**`Promise<GetSimilarProductsResponse>`**  
+An object containing:
+
+- `data`: An array of `Product` objects.
+- `page`: The current page number.
+- `perPage`: The number of items per page.
+- `total`: The total number of items available.
+
+#### Example
 
 ```typescript
-import { GetSimilarProductsParams } from 'sizebay-core-sdk/types/ai-image-service';
+import { GetSimilarProductsParams } from 'sizebay-core-sdk';
 
 const params: GetSimilarProductsParams = {
   tenantId: 123,
   permalink: 'https://example.com/product',
-  collectionName: 'summer-collection', // optional
-  sessionId: 456,                      // optional
-  page: 1,                             // optional
-  perPage: 10,                         // optional
+  collectionName: 'summer-collection',
+  sessionId: 456,
+  page: 1,
+  perPage: 10,
 };
 
 async function fetchSimilarProducts() {
@@ -112,4 +173,57 @@ async function fetchSimilarProducts() {
 }
 
 fetchSimilarProducts();
-```
+```
+
+---
+
+### `GetRecommendedSizeByProducts(payload: GetRecommendedSizeByProductsParams): Promise<GetRecommendedSizeByProductsResponse[]>`
+
+Retrieves the recommended sizes for one or more products based on the provided parameters.
+
+#### Parameters
+
+| Parameter    | Type                    | Required | Description                                                                                                    |
+|-------------:|-------------------------|:--------:|----------------------------------------------------------------------------------------------------------------|
+| `tenantId`   | `number`               | **Yes**  | The tenant ID that initiated the request.                                                                      |
+| `sid`        | `string` (optional)    | No       | The session ID for internal events, if needed.                                                                 |
+| `sizeSystem` | `string`               | **Yes**  | The size system (e.g., 'BR', 'US', 'EU').                                                                      |
+| `permalinks` | `string[]`             | **Yes**  | A list of product permalinks for which size recommendations are requested.                                     |
+
+#### Returns
+
+**`Promise<GetRecommendedSizeByProductsResponse[]>`**  
+An array of objects, each containing:
+
+- `id`: The internal identifier for the product.
+- `permalink`: The product permalink from the request.
+- `recommendedSize`: The recommended size (`string`) or `null` if no recommendation is available.
+
+#### Example
+
+```typescript
+import { GetRecommendedSizeByProductsParams } from 'sizebay-core-sdk';
+
+const payload: GetRecommendedSizeByProductsParams = {
+  tenantId: 123,
+  sid: '0c7f5233b325',
+  sizeSystem: 'BR',
+  permalinks: [
+    'https://example.com/product1',
+    'https://example.com/product2',
+  ],
+};
+
+async function fetchRecommendedSizes() {
+  try {
+    const response = await client.GetRecommendedSizeByProducts(payload);
+    response.forEach((item) => {
+      console.log(`Product ID: ${item.id}, Recommended Size: ${item.recommendedSize}`);
+    });
+  } catch (error: any) {
+    console.error('Error fetching recommended product sizes:', error.message);
+  }
+}
+
+fetchRecommendedSizes();
+``` 

package/dist/sizebay-core-sdk.es.js

@@ -1,101 +1,101 @@
 const c = {
   tracker: {
-    production: "https://data-event-service.internalsizebay.com/events",
-    development: "https://data-event-service.internalsizebay.com/events"
+    production: "https://data-event-service.internalsizebay.com",
+    development: "https://data-event-service.internalsizebay.com"
   },
   aiImageService: {
-    production: "https://ai-image-service.example.com/production",
-    development: "https://ai-image-service.example.com/development"
+    production: "https://ai-image-service.internalsizebay.com/",
+    development: "https://ai-image-service-dev.internalsizebay.com/"
   }
   // Adicione outros serviços conforme necessário
 };
 class a {
-  constructor(r) {
-    const o = r.env || "development";
-    this.serviceOverrides = r.services || {}, this.endpoints = {};
+  constructor(e) {
+    const n = e.env || "development";
+    this.serviceOverrides = e.services || {}, this.endpoints = {};
     for (const t in c)
       if (Object.prototype.hasOwnProperty.call(c, t)) {
-        const i = c[t][o];
-        if (!i)
+        const o = c[t][n];
+        if (!o)
           continue;
-        this.endpoints[t] = i;
+        this.endpoints[t] = o;
       }
   }
-  getEndpoint(r) {
-    const o = this.endpoints[r];
-    if (!o)
+  getEndpoint(e) {
+    const n = this.endpoints[e];
+    if (!n)
       throw new Error(
-        `Endpoint for service '${r}' is not configured.`
+        `Endpoint for service '${e}' is not configured.`
       );
-    return o;
+    return n;
   }
-  getServiceConfig(r) {
-    return this.serviceOverrides[r] || {};
+  getServiceConfig(e) {
+    return this.serviceOverrides[e] || {};
   }
 }
 class p {
-  constructor(r) {
-    this.endpoint = r.getEndpoint("tracker");
+  constructor(e) {
+    this.endpoint = e.getEndpoint("tracker");
   }
-  async track(r, o) {
+  async track(e, n) {
     const t = {
-      eventName: r,
-      ...o
-    };
+      eventName: e,
+      ...n
+    }, r = new URL(`${this.endpoint}/events`);
     try {
-      const e = await fetch(this.endpoint, {
+      const o = await fetch(r, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify(t)
       });
-      if (!e.ok) {
-        const i = await e.text();
-        throw new Error(`Request error: ${e.status} - ${i}`);
+      if (!o.ok) {
+        const i = await o.text();
+        throw new Error(`Request error: ${o.status} - ${i}`);
       }
-      return await e.json();
-    } catch (e) {
-      throw e;
+      return await o.json();
+    } catch (o) {
+      throw o;
     }
   }
 }
 class d {
-  constructor(r) {
-    this.endpoint = r.getEndpoint("aiImageService");
+  constructor(e) {
+    this.endpoint = e.getEndpoint("aiImageService");
   }
-  async getSimilarProducts(r) {
-    const o = new URL(`${this.endpoint}/recommendations/similar`);
-    Object.entries(r).forEach(([t, e]) => {
-      e !== void 0 && o.searchParams.append(t, String(e));
+  async getSimilarProducts(e) {
+    const n = new URL(`${this.endpoint}/recommendations/similar`);
+    Object.entries(e).forEach(([t, r]) => {
+      r !== void 0 && n.searchParams.append(t, String(r));
     });
     try {
-      const t = await fetch(o.toString(), {
+      const t = await fetch(n.toString(), {
         method: "GET",
         headers: {
           "Content-Type": "application/json"
         }
       });
       if (!t.ok) {
-        const e = await t.text();
-        throw new Error(`Request error: ${t.status} - ${e}`);
+        const r = await t.text();
+        throw new Error(`Request error: ${t.status} - ${r}`);
       }
       return await t.json();
     } catch (t) {
       throw new Error(`Error fetching similar products: ${t.message}`);
     }
   }
-  async getRecommendedProductSize(r) {
-    const o = new URL(`${this.endpoint}/recommendations/size-by-products`);
+  async getRecommendedSizeByProducts(e) {
+    const n = new URL(`${this.endpoint}/recommendations/size-by-products`);
     try {
-      const t = await fetch(o.toString(), {
+      const t = await fetch(n.toString(), {
         method: "POST",
         headers: {
           "Content-Type": "application/json"
         },
-        body: JSON.stringify(r)
+        body: JSON.stringify(e)
       });
       if (!t.ok) {
-        const e = await t.text();
-        throw new Error(`Request error: ${t.status} - ${e}`);
+        const r = await t.text();
+        throw new Error(`Request error: ${t.status} - ${r}`);
       }
       return await t.json();
     } catch (t) {
@@ -108,14 +108,14 @@ const h = [
   d
 ];
 function f(s) {
-  const r = new a(s), o = h.map((e) => new e(r)), t = { config: r };
-  return o.forEach((e) => {
-    Object.getOwnPropertyNames(e).forEach((n) => {
-      typeof e[n] == "function" && (t[n] = e[n].bind(e));
+  const e = new a(s), n = h.map((r) => new r(e)), t = { config: e };
+  return n.forEach((r) => {
+    Object.getOwnPropertyNames(r).forEach((i) => {
+      typeof r[i] == "function" && (t[i] = r[i].bind(r));
     });
-    const i = Object.getPrototypeOf(e);
-    Object.getOwnPropertyNames(i).forEach((n) => {
-      n !== "constructor" && typeof e[n] == "function" && (t[n] = e[n].bind(e));
+    const o = Object.getPrototypeOf(r);
+    Object.getOwnPropertyNames(o).forEach((i) => {
+      i !== "constructor" && typeof r[i] == "function" && (t[i] = r[i].bind(r));
     });
   }), t;
 }

package/dist/sizebay-core-sdk.umd.js

@@ -1 +1 @@
-(function(s,i){typeof exports=="object"&&typeof module<"u"?i(exports):typeof define=="function"&&define.amd?define(["exports"],i):(s=typeof globalThis<"u"?globalThis:s||self,i(s["sizebay-core-sdk"]={}))})(this,function(s){"use strict";const i={tracker:{production:"https://data-event-service.internalsizebay.com/events",development:"https://data-event-service.internalsizebay.com/events"},aiImageService:{production:"https://ai-image-service.example.com/production",development:"https://ai-image-service.example.com/development"}};class p{constructor(r){const o=r.env||"development";this.serviceOverrides=r.services||{},this.endpoints={};for(const e in i)if(Object.prototype.hasOwnProperty.call(i,e)){const c=i[e][o];if(!c)continue;this.endpoints[e]=c}}getEndpoint(r){const o=this.endpoints[r];if(!o)throw new Error(`Endpoint for service '${r}' is not configured.`);return o}getServiceConfig(r){return this.serviceOverrides[r]||{}}}class d{constructor(r){this.endpoint=r.getEndpoint("tracker")}async track(r,o){const e={eventName:r,...o};try{const t=await fetch(this.endpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(e)});if(!t.ok){const c=await t.text();throw new Error(`Request error: ${t.status} - ${c}`)}return await t.json()}catch(t){throw t}}}class f{constructor(r){this.endpoint=r.getEndpoint("aiImageService")}async getSimilarProducts(r){const o=new URL(`${this.endpoint}/recommendations/similar`);Object.entries(r).forEach(([e,t])=>{t!==void 0&&o.searchParams.append(e,String(t))});try{const e=await fetch(o.toString(),{method:"GET",headers:{"Content-Type":"application/json"}});if(!e.ok){const t=await e.text();throw new Error(`Request error: ${e.status} - ${t}`)}return await e.json()}catch(e){throw new Error(`Error fetching similar products: ${e.message}`)}}async getRecommendedProductSize(r){const o=new URL(`${this.endpoint}/recommendations/size-by-products`);try{const e=await fetch(o.toString(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(r)});if(!e.ok){const t=await e.text();throw new Error(`Request error: ${e.status} - ${t}`)}return await e.json()}catch(e){throw new Error(`Error fetching recommended product size: ${e.message}`)}}}const h=[d,f];function u(a){const r=new p(a),o=h.map(t=>new t(r)),e={config:r};return o.forEach(t=>{Object.getOwnPropertyNames(t).forEach(n=>{typeof t[n]=="function"&&(e[n]=t[n].bind(t))});const c=Object.getPrototypeOf(t);Object.getOwnPropertyNames(c).forEach(n=>{n!=="constructor"&&typeof t[n]=="function"&&(e[n]=t[n].bind(t))})}),e}s.createClient=u,Object.defineProperty(s,Symbol.toStringTag,{value:"Module"})});
+(function(c,s){typeof exports=="object"&&typeof module<"u"?s(exports):typeof define=="function"&&define.amd?define(["exports"],s):(c=typeof globalThis<"u"?globalThis:c||self,s(c["sizebay-core-sdk"]={}))})(this,function(c){"use strict";const s={tracker:{production:"https://data-event-service.internalsizebay.com",development:"https://data-event-service.internalsizebay.com"},aiImageService:{production:"https://ai-image-service.internalsizebay.com/",development:"https://ai-image-service-dev.internalsizebay.com/"}};class p{constructor(t){const n=t.env||"development";this.serviceOverrides=t.services||{},this.endpoints={};for(const e in s)if(Object.prototype.hasOwnProperty.call(s,e)){const o=s[e][n];if(!o)continue;this.endpoints[e]=o}}getEndpoint(t){const n=this.endpoints[t];if(!n)throw new Error(`Endpoint for service '${t}' is not configured.`);return n}getServiceConfig(t){return this.serviceOverrides[t]||{}}}class d{constructor(t){this.endpoint=t.getEndpoint("tracker")}async track(t,n){const e={eventName:t,...n},r=new URL(`${this.endpoint}/events`);try{const o=await fetch(r,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(e)});if(!o.ok){const i=await o.text();throw new Error(`Request error: ${o.status} - ${i}`)}return await o.json()}catch(o){throw o}}}class f{constructor(t){this.endpoint=t.getEndpoint("aiImageService")}async getSimilarProducts(t){const n=new URL(`${this.endpoint}/recommendations/similar`);Object.entries(t).forEach(([e,r])=>{r!==void 0&&n.searchParams.append(e,String(r))});try{const e=await fetch(n.toString(),{method:"GET",headers:{"Content-Type":"application/json"}});if(!e.ok){const r=await e.text();throw new Error(`Request error: ${e.status} - ${r}`)}return await e.json()}catch(e){throw new Error(`Error fetching similar products: ${e.message}`)}}async getRecommendedSizeByProducts(t){const n=new URL(`${this.endpoint}/recommendations/size-by-products`);try{const e=await fetch(n.toString(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)});if(!e.ok){const r=await e.text();throw new Error(`Request error: ${e.status} - ${r}`)}return await e.json()}catch(e){throw new Error(`Error fetching recommended product size: ${e.message}`)}}}const h=[d,f];function u(a){const t=new p(a),n=h.map(r=>new r(t)),e={config:t};return n.forEach(r=>{Object.getOwnPropertyNames(r).forEach(i=>{typeof r[i]=="function"&&(e[i]=r[i].bind(r))});const o=Object.getPrototypeOf(r);Object.getOwnPropertyNames(o).forEach(i=>{i!=="constructor"&&typeof r[i]=="function"&&(e[i]=r[i].bind(r))})}),e}c.createClient=u,Object.defineProperty(c,Symbol.toStringTag,{value:"Module"})});

package/dist/types/src/modules/ai-image-service.d.ts

@@ -1,8 +1,8 @@
 import { Config } from '../config';
-import { GetRecommendedProductSizeParams, GetRecommendedProductSizeResponse, GetSimilarProductsParams, GetSimilarProductsResponse } from '../types/ai-image-service.types';
+import { GetRecommendedSizeByProductsParams, GetRecommendedSizeByProductsResponse, GetSimilarProductsParams, GetSimilarProductsResponse } from '../types/ai-image-service.types';
 export declare class AIImageService {
     private endpoint;
     constructor(config: Config);
     getSimilarProducts(params: GetSimilarProductsParams): Promise<GetSimilarProductsResponse>;
-    getRecommendedProductSize(payload: GetRecommendedProductSizeParams): Promise<GetRecommendedProductSizeResponse>;
+    getRecommendedSizeByProducts(payload: GetRecommendedSizeByProductsParams): Promise<GetRecommendedSizeByProductsResponse[]>;
 }

package/dist/types/src/modules/tracker.d.ts

@@ -1,7 +1,7 @@
-import { TrackData } from '../types';
+import { TrackData, TrackResponse } from '../types';
 import { Config } from '../config';
 export declare class Tracker {
     private endpoint;
     constructor(config: Config);
-    track(eventName: string, payload: TrackData): Promise<any>;
+    track(eventName: string, payload: TrackData): Promise<TrackResponse>;
 }

package/dist/types/src/types/ai-image-service.types.d.ts

@@ -1,7 +1,7 @@
 export interface GetSimilarProductsParams {
     tenantId: number;
-    collectionName?: string;
-    sessionId?: number;
+    collectionName: string;
+    sessionId: number;
     permalink: string;
     page?: number;
     perPage?: number;
@@ -29,20 +29,14 @@ export interface GetSimilarProductsResponse {
     perPage: number;
     total: number;
 }
-export interface ProductRecommendedSize {
-    permalink: string;
-    analysisResponse: any | null;
-    productInfo: any | null;
-    recommendedSize: string;
-    recommendedComposedMeasure: any | null;
-    composedMeasureOrder: any | null;
-    productGender: string;
-    profileName: string;
+export interface GetRecommendedSizeByProductsParams {
+    tenantId: number;
+    sid?: string;
     sizeSystem: string;
+    permalinks: string[];
 }
-export interface GetRecommendedProductSizeParams {
-    products: ProductRecommendedSize[];
-}
-export interface GetRecommendedProductSizeResponse {
-    [key: string]: string | number | boolean;
+export interface GetRecommendedSizeByProductsResponse {
+    id: string;
+    permalink: string;
+    recommendedSize: string | null;
 }

package/dist/types/src/types/event.types.d.ts

@@ -11,3 +11,18 @@ export interface TrackData {
 export interface DataEventPayload extends TrackData {
     eventName: string;
 }
+export interface TrackSuccessResponse {
+    statusCode: 201;
+    message: 'Event successfully created.';
+}
+export interface TrackBadRequestResponse {
+    statusCode: 400;
+    error: 'Bad Request';
+    message: string[];
+}
+export interface TrackServerErrorResponse {
+    statusCode: 500;
+    error: 'Internal server error';
+    message: string[];
+}
+export type TrackResponse = TrackSuccessResponse | TrackBadRequestResponse | TrackServerErrorResponse;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sizebay-core-sdk",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "A SDK designed for integrating multiple services (such as event tracking, AI services, etc.) into your application.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/config/endpoints.ts

@@ -2,13 +2,13 @@ import { EndpointDefinition } from "@src/types";
 
 export const endpoints: Record<string, EndpointDefinition> = {
   tracker: {
-    production: 'https://data-event-service.internalsizebay.com/events',
-    development: 'https://data-event-service.internalsizebay.com/events',
+    production: 'https://data-event-service.internalsizebay.com',
+    development: 'https://data-event-service.internalsizebay.com',
   },
  
   aiImageService: {
-    production: 'https://ai-image-service.example.com/production',
-    development: 'https://ai-image-service.example.com/development',
+    production: 'https://ai-image-service.internalsizebay.com/',
+    development: 'https://ai-image-service-dev.internalsizebay.com/',
   },
   // Adicione outros serviços conforme necessário
 };

package/src/modules/ai-image-service.ts

@@ -1,7 +1,7 @@
 import { Config } from '@src/config';
 import {
-  GetRecommendedProductSizeParams,
-  GetRecommendedProductSizeResponse,
+  GetRecommendedSizeByProductsParams,
+  GetRecommendedSizeByProductsResponse,
   GetSimilarProductsParams,
   GetSimilarProductsResponse,
 } from '@src/types/ai-image-service.types';
@@ -42,9 +42,9 @@ export class AIImageService {
     }
   }
 
-  public async getRecommendedProductSize(
-    payload: GetRecommendedProductSizeParams,
-  ): Promise<GetRecommendedProductSizeResponse> {
+  public async getRecommendedSizeByProducts(
+    payload: GetRecommendedSizeByProductsParams,
+  ): Promise<GetRecommendedSizeByProductsResponse[]> {
     const url = new URL(`${this.endpoint}/recommendations/size-by-products`);
 
     try {
@@ -60,7 +60,7 @@ export class AIImageService {
         const errorText = await response.text();
         throw new Error(`Request error: ${response.status} - ${errorText}`);
       }
-      return (await response.json()) as GetRecommendedProductSizeResponse;
+      return (await response.json()) as GetRecommendedSizeByProductsResponse[];
     } catch (error: any) {
       throw new Error(`Error fetching recommended product size: ${error.message}`);
     }

package/src/modules/tracker.ts

@@ -1,24 +1,23 @@
-import { DataEventPayload, TrackData } from "../types";
+import { DataEventPayload, TrackData, TrackResponse } from "../types";
 import { Config } from "../config";
 
 export class Tracker {
   
   private endpoint: string;
 
-  constructor(config: Config) {
-    // Define "config" como não enumerável
-    
+  constructor(config: Config) {    
     this.endpoint =  config.getEndpoint('tracker');
   }
 
-  public async track(eventName: string, payload: TrackData): Promise<any> {
+  public async track(eventName: string, payload: TrackData): Promise<TrackResponse> {
     const data: DataEventPayload = {
       eventName,
       ...payload,
     };
+    const url = new URL(`${this.endpoint}/events`);
 
     try {
-      const response = await fetch(this.endpoint, {
+      const response = await fetch(url, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify(data),

package/src/types/ai-image-service.types.ts

@@ -1,11 +1,12 @@
 export interface GetSimilarProductsParams {
   tenantId: number;
-  collectionName?: string;
-  sessionId?: number;
+  collectionName: string;
+  sessionId: number;
   permalink: string;
   page?: number;
   perPage?: number;
 }
+
 export interface Product {
   id: string;
   title: string;
@@ -31,22 +32,16 @@ export interface GetSimilarProductsResponse {
   total: number;
 }
 
-export interface ProductRecommendedSize {
-  permalink: string;
-  analysisResponse: any | null;
-  productInfo: any | null;
-  recommendedSize: string;
-  recommendedComposedMeasure: any | null;
-  composedMeasureOrder: any | null;
-  productGender: string;
-  profileName: string;
+export interface GetRecommendedSizeByProductsParams {
+  tenantId: number;
+  sid?: string; 
   sizeSystem: string;
+  permalinks: string[];
 }
 
-export interface GetRecommendedProductSizeParams {
-  products: ProductRecommendedSize[];
-}
 
-export interface GetRecommendedProductSizeResponse {
-  [key: string]: string | number | boolean;
+export interface GetRecommendedSizeByProductsResponse {
+  id: string;
+  permalink: string;
+  recommendedSize: string | null;
 }

package/src/types/event.types.ts

@@ -1,6 +1,3 @@
-/**
- * Represents any valid JSON value.
- */
 export type JSONValue =
   | string
   | number
@@ -9,9 +6,6 @@ export type JSONValue =
   | JSONValue[]
   | { [key: string]: JSONValue };
 
-/**
- * Interface that defines the structure of a tracked event.
- */
 export interface TrackData {
   sid: string;
   tenantId: number;
@@ -20,9 +14,30 @@ export interface TrackData {
   properties: Record<string, JSONValue>;
 }
 
-/**
- * Payload for the track event.
- */
 export interface DataEventPayload extends TrackData {
   eventName: string;
-}
+}
+
+export interface TrackSuccessResponse {
+  statusCode: 201;
+  message: 'Event successfully created.';
+}
+
+export interface TrackBadRequestResponse {
+  statusCode: 400;
+  error: 'Bad Request';
+
+  message: string[];
+}
+
+export interface TrackServerErrorResponse {
+  statusCode: 500;
+  error: 'Internal server error';
+
+  message: string[];
+}
+
+export type TrackResponse =
+  | TrackSuccessResponse
+  | TrackBadRequestResponse
+  | TrackServerErrorResponse;

package/test/modules/ai-image-service.test.ts

@@ -2,27 +2,27 @@ import { AIImageService } from '@src/modules/ai-image-service';
 import {
   GetSimilarProductsParams,
   GetSimilarProductsResponse,
-  GetRecommendedProductSizeParams,
-  GetRecommendedProductSizeResponse,
+  GetRecommendedSizeByProductsParams,
+  GetRecommendedSizeByProductsResponse,
 } from '@src/types/ai-image-service.types';
 
 describe('AIImageService', () => {
-  // Use a valid base URL for constructing request URLs.
+
   const fakeEndpoint = 'https://example.com/ai-image-service';
   let fakeConfig: { getEndpoint: (serviceName: string) => string };
   let aiImageService: AIImageService;
 
   beforeEach(() => {
-    // Reinitialize the fake configuration for each test.
+
     fakeConfig = {
       getEndpoint: (serviceName: string) => fakeEndpoint,
     };
-    // Cast fakeConfig as any to bypass missing properties required by Config.
+
     aiImageService = new AIImageService(fakeConfig as any);
   });
 
   afterEach(() => {
-    // Reset global.fetch if it was set.
+
     if (global.fetch && (global.fetch as jest.Mock).mockReset) {
       (global.fetch as jest.Mock).mockReset();
     }
@@ -73,7 +73,6 @@ describe('AIImageService', () => {
 
       const result = await aiImageService.getSimilarProducts(params);
 
-      // Build expected URL with query parameters.
       const expectedUrl = new URL(`${fakeEndpoint}/recommendations/similar`);
       Object.entries(params).forEach(([key, value]) => {
         if (value !== undefined) {
@@ -131,12 +130,16 @@ describe('AIImageService', () => {
     });
   });
 
-  describe('getRecommendedProductSize', () => {
+  describe('getRecommendedSizeByProducts', () => {
     it('should send the POST request with the correct payload and return the JSON response', async () => {
-      const fakeResponseData: GetRecommendedProductSizeResponse = {
-        recommendedSize: 'M',
-        someOtherKey: 123,
-      };
+
+      const fakeResponseData: GetRecommendedSizeByProductsResponse[] = [
+        {
+          id: '1',
+          permalink: 'https://example.com/product/1',
+          recommendedSize: 'M',
+        },
+      ];
 
       const fakeFetchResponse = {
         ok: true,
@@ -145,23 +148,15 @@ describe('AIImageService', () => {
 
       global.fetch = jest.fn().mockResolvedValue(fakeFetchResponse as any);
 
-      const payload: GetRecommendedProductSizeParams = {
-        products: [
-          {
-            permalink: 'https://example.com/product/1',
-            analysisResponse: null,
-            productInfo: null,
-            recommendedSize: 'M',
-            recommendedComposedMeasure: null,
-            composedMeasureOrder: null,
-            productGender: 'unisex',
-            profileName: 'profile1',
-            sizeSystem: 'US',
-          },
-        ],
+      const payload: GetRecommendedSizeByProductsParams = {
+        tenantId: 123,
+
+        sid: 'some-session-id',
+        sizeSystem: 'US',
+        permalinks: ['https://example.com/product/1'],
       };
 
-      const result = await aiImageService.getRecommendedProductSize(payload);
+      const result = await aiImageService.getRecommendedSizeByProducts(payload);
 
       const expectedUrl = `${fakeEndpoint}/recommendations/size-by-products`;
 
@@ -183,24 +178,14 @@ describe('AIImageService', () => {
 
       global.fetch = jest.fn().mockResolvedValue(fakeFetchResponse as any);
 
-      const payload: GetRecommendedProductSizeParams = {
-        products: [
-          {
-            permalink: 'https://example.com/product/1',
-            analysisResponse: null,
-            productInfo: null,
-            recommendedSize: 'M',
-            recommendedComposedMeasure: null,
-            composedMeasureOrder: null,
-            productGender: 'unisex',
-            profileName: 'profile1',
-            sizeSystem: 'US',
-          },
-        ],
+      const payload: GetRecommendedSizeByProductsParams = {
+        tenantId: 123,
+        sizeSystem: 'US',
+        permalinks: ['https://example.com/product/1'],
       };
 
       await expect(
-        aiImageService.getRecommendedProductSize(payload),
+        aiImageService.getRecommendedSizeByProducts(payload),
       ).rejects.toThrow(`Request error: 500 - ${errorText}`);
     });
 
@@ -208,27 +193,17 @@ describe('AIImageService', () => {
       const errorMessage = 'Network error';
       global.fetch = jest.fn().mockRejectedValue(new Error(errorMessage));
 
-      const payload: GetRecommendedProductSizeParams = {
-        products: [
-          {
-            permalink: 'https://example.com/product/1',
-            analysisResponse: null,
-            productInfo: null,
-            recommendedSize: 'M',
-            recommendedComposedMeasure: null,
-            composedMeasureOrder: null,
-            productGender: 'unisex',
-            profileName: 'profile1',
-            sizeSystem: 'US',
-          },
-        ],
+      const payload: GetRecommendedSizeByProductsParams = {
+        tenantId: 123,
+        sizeSystem: 'US',
+        permalinks: ['https://example.com/product/1'],
       };
 
       await expect(
-        aiImageService.getRecommendedProductSize(payload),
+        aiImageService.getRecommendedSizeByProducts(payload),
       ).rejects.toThrow(
         `Error fetching recommended product size: ${errorMessage}`,
       );
     });
   });
-});
+});

package/test/modules/tracker.test.ts

@@ -14,7 +14,9 @@ describe('Tracker', () => {
   });
 
   afterEach(() => {
-    jest.resetAllMocks();
+    if (global.fetch && (global.fetch as jest.Mock).mockClear) {
+      (global.fetch as jest.Mock).mockClear();
+    }
   });
 
   it('should send the event and return the JSON response', async () => {
@@ -36,7 +38,8 @@ describe('Tracker', () => {
 
     const result = await tracker.track(eventName, payload);
 
-    expect(global.fetch).toHaveBeenCalledWith(fakeEndpoint, {
+    const expectedUrl = new URL(`${fakeEndpoint}/events`);
+    expect(global.fetch).toHaveBeenCalledWith(expectedUrl, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({ eventName, ...payload }),
@@ -46,7 +49,6 @@ describe('Tracker', () => {
 
   it('should throw an error if the response is not ok', async () => {
     const errorText = 'Internal Server Error';
-
     const fakeFetchResponse = {
       ok: false,
       status: 500,