@reactionary/lipscore 0.9.22 → 0.9.23

package/capabilities/product-reviews.capability.js

@@ -18,7 +18,10 @@ import {
   error,
   success
 } from "@reactionary/core";
-import { LipscoreProductsResponseSchema } from "../schema/lipscore.schema.js";
+import {
+  LipscoreProductsListSchema,
+  LipscoreReviewsResponseSchema
+} from "../schema/lipscore.schema.js";
 class LipscoreProductReviewsCapability extends ProductReviewsCapability {
   constructor(cache, context, config, client, factory) {
     super(cache, context);
@@ -27,27 +30,42 @@ class LipscoreProductReviewsCapability extends ProductReviewsCapability {
     this.factory = factory;
   }
   async getRatingSummary(query) {
-    const response = await this.client.callGet(
-      this.getReviewsUrl(),
-      this.getRatingSummaryParams(query.product.key),
-      LipscoreProductsResponseSchema
+    const product = await this.getProduct(query.product.key);
+    return success(
+      this.factory.parseRatingSummary(this.context, {
+        productKey: query.product.key,
+        votes: product?.votes ?? null,
+        rating: product?.rating ?? null
+      })
     );
-    return success(this.factory.parseRatingSummary(this.context, response));
   }
   async findReviews(query) {
     const pageSize = query.paginationOptions?.pageSize ?? 10;
     const pageNumber = query.paginationOptions?.pageNumber ?? 1;
-    const response = await this.client.callGet(
-      this.getReviewsUrl(),
-      this.getReviewsParams(query.product.key),
-      LipscoreProductsResponseSchema
+    const product = await this.getProduct(query.product.key);
+    if (product === null) {
+      return success(
+        this.factory.parseReviewPaginatedResult(this.context, {
+          reviews: [],
+          productKey: query.product.key,
+          pageSize,
+          pageNumber,
+          totalReviewCount: 0
+        })
+      );
+    }
+    const reviews = await this.client.callGet(
+      this.getReviewsUrl(product.id),
+      this.getReviewsParams(pageSize, pageNumber),
+      LipscoreReviewsResponseSchema
     );
     return success(
       this.factory.parseReviewPaginatedResult(this.context, {
-        response,
+        reviews,
         productKey: query.product.key,
         pageSize,
-        pageNumber
+        pageNumber,
+        totalReviewCount: product.review_count ?? void 0
       })
     );
   }
@@ -60,17 +78,32 @@ class LipscoreProductReviewsCapability extends ProductReviewsCapability {
   // ---------------------------------------------------------------------------
   // Extension points — override in subclasses to customise API calls
   // ---------------------------------------------------------------------------
-  getReviewsUrl() {
+  async getProduct(productKey) {
+    const params = this.getProductsParams(productKey);
+    const products = await this.client.callGet(
+      this.getProductsUrl(),
+      params,
+      LipscoreProductsListSchema
+    );
+    return products[0] ?? null;
+  }
+  getProductsUrl() {
     return `${this.client.baseUrl}/products`;
   }
-  getReviewsParams(productId) {
+  getReviewsUrl(lipscoreProductId) {
+    return `${this.client.baseUrl}/products/${lipscoreProductId}/reviews`;
+  }
+  getProductsParams(productKey) {
     const params = new URLSearchParams();
-    params.set("internal_id[]", productId);
-    params.set("fields", "reviews");
+    params.set("internal_id", productKey);
+    params.set("fields", "rating,review_count");
     return params;
   }
-  getRatingSummaryParams(productId) {
-    return this.getReviewsParams(productId);
+  getReviewsParams(pageSize, pageNumber) {
+    const params = new URLSearchParams();
+    params.set("page", String(pageNumber));
+    params.set("per_page", String(pageSize));
+    return params;
   }
 }
 __decorateClass([

package/factories/product-reviews/product-reviews.factory.js

@@ -5,63 +5,37 @@ class LipscoreProductReviewsFactory {
     this.reviewPaginatedSchema = reviewPaginatedSchema;
   }
   parseRatingSummary(_context, data) {
-    const product = data[0];
-    const reviews = product?.reviews ?? [];
-    if (reviews.length === 0) {
-      return this.ratingSummarySchema.parse({
-        identifier: { product: { key: String(product?.internal_id ?? "") } },
-        averageRating: 0,
-        totalRatings: void 0,
-        ratingDistribution: void 0
-      });
-    }
-    const total = reviews.length;
-    const sum = reviews.reduce((acc, r) => acc + r.rating, 0);
-    const averageRating = Math.round(sum / total * 100) / 100;
-    const distribution = {
-      "1": 0,
-      "2": 0,
-      "3": 0,
-      "4": 0,
-      "5": 0
-    };
-    for (const review of reviews) {
-      const key = String(Math.min(5, Math.max(1, Math.round(review.rating))));
-      distribution[key] = (distribution[key] ?? 0) + 1;
-    }
+    const votes = data.votes ?? 0;
+    const averageRating = votes > 0 && data.rating ? Math.round(parseFloat(data.rating) * 100) / 100 : 0;
     return this.ratingSummarySchema.parse({
-      identifier: { product: { key: String(product?.internal_id ?? "") } },
+      identifier: { product: { key: data.productKey } },
       averageRating,
-      totalRatings: total,
-      ratingDistribution: distribution
+      totalRatings: votes > 0 ? votes : void 0,
+      ratingDistribution: void 0
     });
   }
   parseReview(_context, data) {
     return this.reviewSchema.parse({
       identifier: { key: String(data.id) },
-      product: { key: String(data.id) },
-      authorName: data.displayed_name ?? data.user?.name ?? "Anonymous",
+      product: { key: data.product?.internal_id ?? String(data.id) },
+      authorName: data.displayed_name ?? data.user?.short_name ?? data.user?.name ?? "Anonymous",
       authorId: data.user?.id != null ? String(data.user.id) : void 0,
       rating: data.rating,
       title: "",
       content: data.text ?? data.translated_text ?? "",
-      reply: typeof data.review_reply === "string" ? data.review_reply : void 0,
-      repliedAt: void 0,
+      reply: data.review_reply != null ? data.review_reply.text ?? void 0 : void 0,
+      repliedAt: data.review_reply != null ? data.review_reply.created_at ?? void 0 : void 0,
       createdAt: data.created_at,
       updatedAt: void 0,
-      verified: data.testimonial ?? false
+      verified: false
     });
   }
   parseReviewPaginatedResult(context, data) {
-    const product = data.response[0];
-    const allReviews = product?.reviews ?? [];
-    const totalCount = allReviews.length;
     const pageSize = data.pageSize > 0 ? data.pageSize : 10;
     const pageNumber = data.pageNumber > 0 ? data.pageNumber : 1;
+    const totalCount = data.totalReviewCount !== void 0 ? data.totalReviewCount : data.reviews.length < pageSize ? (pageNumber - 1) * pageSize + data.reviews.length : pageNumber * pageSize + 1;
     const totalPages = pageSize > 0 ? Math.ceil(totalCount / pageSize) : 1;
-    const offset = (pageNumber - 1) * pageSize;
-    const pageReviews = allReviews.slice(offset, offset + pageSize);
-    const items = pageReviews.map((r) => {
+    const items = data.reviews.map((r) => {
       const parsed = this.parseReview(context, r);
       return { ...parsed, product: { key: data.productKey } };
     });

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@reactionary/lipscore",
-  "version": "0.9.22",
+  "version": "0.9.23",
   "type": "module",
   "main": "./index.js",
   "types": "./src/index.d.ts",
   "dependencies": {
-    "@reactionary/core": "0.9.22",
+    "@reactionary/core": "0.9.23",
     "zod": "4.1.9"
   },
   "devDependencies": {

package/schema/configuration.schema.js

@@ -1,8 +1,8 @@
 import * as z from "zod";
 const LipscoreConfigurationSchema = z.looseObject({
   apiKey: z.string().meta({ description: "Lipscore public API key." }),
-  apiSecret: z.string().optional().meta({
-    description: "Lipscore server-side API secret. When set it is sent as the X-Authorization header."
+  apiSecret: z.string().meta({
+    description: "Lipscore server-side API secret. Sent as the X-Authorization header on all v2 API requests."
   }),
   apiUrl: z.string().default("https://api.lipscore.com").meta({ description: "Base Lipscore API URL." })
 });

package/schema/lipscore.schema.js

@@ -1,37 +1,77 @@
 import * as z from "zod";
-const LipscoreReviewUserSchema = z.looseObject({
+const LipscoreUserSchema = z.looseObject({
   id: z.number().optional(),
   name: z.string().optional(),
   short_name: z.string().optional(),
   email: z.string().optional()
 });
+const LipscoreProductEmbedSchema = z.looseObject({
+  name: z.string().nullable().optional(),
+  gtin: z.string().nullable().optional(),
+  sku: z.string().nullable().optional(),
+  variant_id: z.string().nullable().optional(),
+  mpn: z.string().nullable().optional(),
+  internal_id: z.string().nullable().optional()
+});
+const LipscoreRatingSchema = z.looseObject({
+  id: z.number(),
+  created_at: z.string(),
+  updated_at: z.string().optional(),
+  status: z.string().nullable().optional(),
+  lang: z.string().optional(),
+  origin: z.string().optional(),
+  rating: z.number(),
+  user: LipscoreUserSchema.optional(),
+  product: LipscoreProductEmbedSchema.optional(),
+  internal_order_id: z.string().nullable().optional(),
+  internal_customer_id: z.string().nullable().optional()
+});
+const LipscoreRatingsResponseSchema = z.array(LipscoreRatingSchema);
 const LipscoreReviewImageSchema = z.looseObject({
+  id: z.number().optional(),
   thumb_url: z.string().optional(),
   image_url: z.string().optional()
 });
+const LipscoreReviewReplySchema = z.looseObject({
+  text: z.string().optional(),
+  created_at: z.string().optional(),
+  translated_text: z.string().nullable().optional(),
+  member_site: z.string().optional(),
+  lang: z.string().optional()
+});
 const LipscoreReviewSchema = z.looseObject({
   id: z.number(),
-  text: z.string().optional(),
-  translated_text: z.string().optional(),
+  text: z.string().nullable().optional(),
+  translated_text: z.string().nullable().optional(),
   created_at: z.string(),
   votes_up: z.number().optional(),
   votes_down: z.number().optional(),
-  purchase_date: z.string().optional(),
+  purchase_date: z.string().nullable().optional(),
   rating: z.number(),
-  user: LipscoreReviewUserSchema.optional(),
+  user: LipscoreUserSchema.optional(),
   images: z.array(LipscoreReviewImageSchema).optional(),
-  review_reply: z.unknown().optional(),
-  displayed_name: z.string().optional(),
+  review_reply: z.union([LipscoreReviewReplySchema, z.null()]).optional(),
   testimonial: z.boolean().optional(),
+  displayed_name: z.string().nullable().optional(),
+  imported_at: z.string().optional(),
+  product: LipscoreProductEmbedSchema.optional(),
   attributes: z.array(z.unknown()).optional()
 });
-const LipscoreProductSchema = z.looseObject({
-  internal_id: z.union([z.string(), z.number()]).optional(),
+const LipscoreReviewsResponseSchema = z.array(LipscoreReviewSchema);
+const LipscoreProductListItemSchema = z.looseObject({
+  id: z.number(),
+  internal_id: z.string().optional(),
+  votes: z.number().nullable().optional(),
+  rating: z.string().nullable().optional(),
+  review_count: z.number().nullable().optional(),
   reviews: z.array(LipscoreReviewSchema).default([])
 });
-const LipscoreProductsResponseSchema = z.array(LipscoreProductSchema);
+const LipscoreProductsListSchema = z.array(LipscoreProductListItemSchema);
 export {
-  LipscoreProductSchema,
-  LipscoreProductsResponseSchema,
-  LipscoreReviewSchema
+  LipscoreProductListItemSchema,
+  LipscoreProductsListSchema,
+  LipscoreRatingSchema,
+  LipscoreRatingsResponseSchema,
+  LipscoreReviewSchema,
+  LipscoreReviewsResponseSchema
 };

package/src/capabilities/product-reviews.capability.d.ts

@@ -1,4 +1,5 @@
 import { ProductReviewsCapability, type Cache, type ProductReviewMutationSubmit, type ProductReviewsFactory, type ProductReviewsFactoryRatingOutput, type ProductReviewsFactoryReviewOutput, type ProductReviewsFactoryReviewPaginatedOutput, type ProductReviewsFactoryWithOutput, type ProductReviewsGetRatingSummaryQuery, type ProductReviewsListQuery, type RequestContext, type Result } from '@reactionary/core';
+import type { LipscoreProductListItem } from '../schema/lipscore.schema.js';
 import type { LipscoreConfiguration } from '../schema/configuration.schema.js';
 import type { LipscoreClient } from '../core/client.js';
 import type { LipscoreProductReviewsFactory } from '../factories/product-reviews/product-reviews.factory.js';
@@ -10,7 +11,9 @@ export declare class LipscoreProductReviewsCapability<TFactory extends ProductRe
     getRatingSummary(query: ProductReviewsGetRatingSummaryQuery): Promise<Result<ProductReviewsFactoryRatingOutput<TFactory>>>;
     findReviews(query: ProductReviewsListQuery): Promise<Result<ProductReviewsFactoryReviewPaginatedOutput<TFactory>>>;
     submitReview(mutation: ProductReviewMutationSubmit): Promise<Result<ProductReviewsFactoryReviewOutput<TFactory>>>;
-    protected getReviewsUrl(): string;
-    protected getReviewsParams(productId: string): URLSearchParams;
-    protected getRatingSummaryParams(productId: string): URLSearchParams;
+    protected getProduct(productKey: string): Promise<LipscoreProductListItem | null>;
+    protected getProductsUrl(): string;
+    protected getReviewsUrl(lipscoreProductId: number): string;
+    protected getProductsParams(productKey: string): URLSearchParams;
+    protected getReviewsParams(pageSize: number, pageNumber: number): URLSearchParams;
 }

package/src/factories/product-reviews/product-reviews.factory.d.ts

@@ -1,18 +1,24 @@
 import type * as z from 'zod';
 import type { AnyProductRatingSummarySchema, AnyProductReviewPaginatedSchema, AnyProductReviewSchema, ProductReviewsFactory, RequestContext, ProductRatingSummarySchema, ProductReviewSchema, ProductReviewPaginatedResultSchema } from '@reactionary/core';
-import type { LipscoreReview, LipscoreProductsResponse } from '../../schema/lipscore.schema.js';
+import type { LipscoreReview } from '../../schema/lipscore.schema.js';
+export interface LipscoreRatingSummaryData {
+    productKey: string;
+    votes: number | null;
+    rating: string | null;
+}
 export interface LipscoreReviewsPage {
-    response: LipscoreProductsResponse;
+    reviews: LipscoreReview[];
     productKey: string;
     pageSize: number;
     pageNumber: number;
+    totalReviewCount?: number;
 }
 export declare class LipscoreProductReviewsFactory<TRatingSummarySchema extends AnyProductRatingSummarySchema = typeof ProductRatingSummarySchema, TReviewSchema extends AnyProductReviewSchema = typeof ProductReviewSchema, TReviewPaginatedSchema extends AnyProductReviewPaginatedSchema = typeof ProductReviewPaginatedResultSchema> implements ProductReviewsFactory<TRatingSummarySchema, TReviewSchema, TReviewPaginatedSchema> {
     readonly ratingSummarySchema: TRatingSummarySchema;
     readonly reviewSchema: TReviewSchema;
     readonly reviewPaginatedSchema: TReviewPaginatedSchema;
     constructor(ratingSummarySchema: TRatingSummarySchema, reviewSchema: TReviewSchema, reviewPaginatedSchema: TReviewPaginatedSchema);
-    parseRatingSummary(_context: RequestContext, data: LipscoreProductsResponse): z.output<TRatingSummarySchema>;
+    parseRatingSummary(_context: RequestContext, data: LipscoreRatingSummaryData): z.output<TRatingSummarySchema>;
     parseReview(_context: RequestContext, data: LipscoreReview): z.output<TReviewSchema>;
     parseReviewPaginatedResult(context: RequestContext, data: LipscoreReviewsPage): z.output<TReviewPaginatedSchema>;
 }

package/src/schema/configuration.schema.d.ts

@@ -1,7 +1,7 @@
 import * as z from 'zod';
 export declare const LipscoreConfigurationSchema: z.ZodObject<{
     apiKey: z.ZodString;
-    apiSecret: z.ZodOptional<z.ZodString>;
+    apiSecret: z.ZodString;
     apiUrl: z.ZodDefault<z.ZodString>;
 }, z.core.$loose>;
 export type LipscoreConfiguration = z.infer<typeof LipscoreConfigurationSchema>;

package/src/schema/lipscore.schema.d.ts

@@ -1,12 +1,64 @@
 import * as z from 'zod';
+export declare const LipscoreRatingSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    created_at: z.ZodString;
+    updated_at: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lang: z.ZodOptional<z.ZodString>;
+    origin: z.ZodOptional<z.ZodString>;
+    rating: z.ZodNumber;
+    user: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodOptional<z.ZodString>;
+        short_name: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    product: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        gtin: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sku: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        variant_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        mpn: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        internal_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>;
+    internal_order_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    internal_customer_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>;
+export type LipscoreRating = z.infer<typeof LipscoreRatingSchema>;
+export declare const LipscoreRatingsResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodNumber;
+    created_at: z.ZodString;
+    updated_at: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lang: z.ZodOptional<z.ZodString>;
+    origin: z.ZodOptional<z.ZodString>;
+    rating: z.ZodNumber;
+    user: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodOptional<z.ZodString>;
+        short_name: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    product: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        gtin: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sku: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        variant_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        mpn: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        internal_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>;
+    internal_order_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    internal_customer_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>>;
+export type LipscoreRatingsResponse = z.infer<typeof LipscoreRatingsResponseSchema>;
 export declare const LipscoreReviewSchema: z.ZodObject<{
     id: z.ZodNumber;
-    text: z.ZodOptional<z.ZodString>;
-    translated_text: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    translated_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     created_at: z.ZodString;
     votes_up: z.ZodOptional<z.ZodNumber>;
     votes_down: z.ZodOptional<z.ZodNumber>;
-    purchase_date: z.ZodOptional<z.ZodString>;
+    purchase_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     rating: z.ZodNumber;
     user: z.ZodOptional<z.ZodObject<{
         id: z.ZodOptional<z.ZodNumber>;
@@ -15,25 +67,86 @@ export declare const LipscoreReviewSchema: z.ZodObject<{
         email: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
     images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodNumber>;
         thumb_url: z.ZodOptional<z.ZodString>;
         image_url: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>>;
-    review_reply: z.ZodOptional<z.ZodUnknown>;
-    displayed_name: z.ZodOptional<z.ZodString>;
+    review_reply: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+        created_at: z.ZodOptional<z.ZodString>;
+        translated_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        member_site: z.ZodOptional<z.ZodString>;
+        lang: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>, z.ZodNull]>>;
     testimonial: z.ZodOptional<z.ZodBoolean>;
+    displayed_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    imported_at: z.ZodOptional<z.ZodString>;
+    product: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        gtin: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sku: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        variant_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        mpn: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        internal_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>;
     attributes: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
 }, z.core.$loose>;
 export type LipscoreReview = z.infer<typeof LipscoreReviewSchema>;
-export declare const LipscoreProductSchema: z.ZodObject<{
-    internal_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+export declare const LipscoreReviewsResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodNumber;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    translated_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodString;
+    votes_up: z.ZodOptional<z.ZodNumber>;
+    votes_down: z.ZodOptional<z.ZodNumber>;
+    purchase_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    rating: z.ZodNumber;
+    user: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodOptional<z.ZodString>;
+        short_name: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodNumber>;
+        thumb_url: z.ZodOptional<z.ZodString>;
+        image_url: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    review_reply: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+        created_at: z.ZodOptional<z.ZodString>;
+        translated_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        member_site: z.ZodOptional<z.ZodString>;
+        lang: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>, z.ZodNull]>>;
+    testimonial: z.ZodOptional<z.ZodBoolean>;
+    displayed_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    imported_at: z.ZodOptional<z.ZodString>;
+    product: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        gtin: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sku: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        variant_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        mpn: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        internal_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>;
+    attributes: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$loose>>;
+export type LipscoreReviewsResponse = z.infer<typeof LipscoreReviewsResponseSchema>;
+export declare const LipscoreProductListItemSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    internal_id: z.ZodOptional<z.ZodString>;
+    votes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    rating: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    review_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     reviews: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodNumber;
-        text: z.ZodOptional<z.ZodString>;
-        translated_text: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        translated_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         created_at: z.ZodString;
         votes_up: z.ZodOptional<z.ZodNumber>;
         votes_down: z.ZodOptional<z.ZodNumber>;
-        purchase_date: z.ZodOptional<z.ZodString>;
+        purchase_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         rating: z.ZodNumber;
         user: z.ZodOptional<z.ZodObject<{
             id: z.ZodOptional<z.ZodNumber>;
@@ -42,26 +155,45 @@ export declare const LipscoreProductSchema: z.ZodObject<{
             email: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>;
         images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodNumber>;
             thumb_url: z.ZodOptional<z.ZodString>;
             image_url: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>>;
-        review_reply: z.ZodOptional<z.ZodUnknown>;
-        displayed_name: z.ZodOptional<z.ZodString>;
+        review_reply: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            text: z.ZodOptional<z.ZodString>;
+            created_at: z.ZodOptional<z.ZodString>;
+            translated_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            member_site: z.ZodOptional<z.ZodString>;
+            lang: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>, z.ZodNull]>>;
         testimonial: z.ZodOptional<z.ZodBoolean>;
+        displayed_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        imported_at: z.ZodOptional<z.ZodString>;
+        product: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            gtin: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            sku: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            variant_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            mpn: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            internal_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$loose>>;
         attributes: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
     }, z.core.$loose>>>;
 }, z.core.$loose>;
-export type LipscoreProduct = z.infer<typeof LipscoreProductSchema>;
-export declare const LipscoreProductsResponseSchema: z.ZodArray<z.ZodObject<{
-    internal_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+export declare const LipscoreProductsListSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodNumber;
+    internal_id: z.ZodOptional<z.ZodString>;
+    votes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    rating: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    review_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     reviews: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodNumber;
-        text: z.ZodOptional<z.ZodString>;
-        translated_text: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        translated_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         created_at: z.ZodString;
         votes_up: z.ZodOptional<z.ZodNumber>;
         votes_down: z.ZodOptional<z.ZodNumber>;
-        purchase_date: z.ZodOptional<z.ZodString>;
+        purchase_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         rating: z.ZodNumber;
         user: z.ZodOptional<z.ZodObject<{
             id: z.ZodOptional<z.ZodNumber>;
@@ -70,13 +202,29 @@ export declare const LipscoreProductsResponseSchema: z.ZodArray<z.ZodObject<{
             email: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>;
         images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodNumber>;
             thumb_url: z.ZodOptional<z.ZodString>;
             image_url: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>>;
-        review_reply: z.ZodOptional<z.ZodUnknown>;
-        displayed_name: z.ZodOptional<z.ZodString>;
+        review_reply: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            text: z.ZodOptional<z.ZodString>;
+            created_at: z.ZodOptional<z.ZodString>;
+            translated_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            member_site: z.ZodOptional<z.ZodString>;
+            lang: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>, z.ZodNull]>>;
         testimonial: z.ZodOptional<z.ZodBoolean>;
+        displayed_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        imported_at: z.ZodOptional<z.ZodString>;
+        product: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            gtin: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            sku: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            variant_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            mpn: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            internal_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$loose>>;
         attributes: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
     }, z.core.$loose>>>;
 }, z.core.$loose>>;
-export type LipscoreProductsResponse = z.infer<typeof LipscoreProductsResponseSchema>;
+export type LipscoreProductListItem = z.infer<typeof LipscoreProductListItemSchema>;