@peektravel/app-utilities 0.9.1 → 0.9.2

package/dist/index.d.cts

@@ -914,6 +914,16 @@ interface CreateBookingInput {
      * Default: `false`.
      */
     requireRequiredQuestions?: boolean;
+    /**
+     * When `true`, a `customQuestionAnswers` entry whose `questionIdOrText` is a
+     * `cq_…` id is accepted even if that id is **not** among the activity's custom
+     * questions — the check that a question id must match the activity's list is
+     * skipped, and the answer is sent as-is (as a text answer). Entries given by
+     * question **name** are unaffected: they still must match a question, so the
+     * activity's questions are fetched only when a by-name answer (or
+     * `requireRequiredQuestions`) needs them. Default: `false`.
+     */
+    acceptAllCustomQuestionIds?: boolean;
     /** Suppress the customer confirmation email. Default: false. */
     skipCustomerEmail?: boolean;
     /** Clone the quote from an existing order. */
@@ -1295,7 +1305,9 @@ declare class BookingService {
      * Resolves the input's custom-question answers into the quote's
      * `questionAnswers` payload (each tagged with a fresh `refid`), or `null` when
      * none were supplied. Fetches the activity's custom questions to validate
-     * against; throws on the first unmatched/ambiguous/invalid answer.
+     * against; throws on the first unmatched/ambiguous/invalid answer. When
+     * `acceptAllCustomQuestionIds` is set the fetch is skipped if every answer is
+     * given by id (a by-name answer still needs the list to resolve).
      */
     private buildQuestionAnswers;
     private markCreatedBookingPaid;
@@ -1822,6 +1834,31 @@ interface Review {
     /** Free-text review. May be null. */
     comment: string | null;
 }
+/**
+ * Aggregate review statistics for a single activity (product), as returned by
+ * {@link ReviewService.getAllReviewSummaries}. Carries no per-review detail or
+ * PII — just the rating distribution and average.
+ */
+interface ProductReviewSummary {
+    /** Activity (product) id the summary is for. */
+    productId: string;
+    /** Activity (product) name. */
+    productName: string;
+    /** Average star rating as a decimal, or `null` when there are no ratings. */
+    avgRating: number | null;
+    /** Total number of reviews. */
+    countTotal: number;
+    /** Number of 1-star reviews. */
+    countOneStar: number;
+    /** Number of 2-star reviews. */
+    countTwoStar: number;
+    /** Number of 3-star reviews. */
+    countThreeStar: number;
+    /** Number of 4-star reviews. */
+    countFourStar: number;
+    /** Number of 5-star reviews. */
+    countFiveStar: number;
+}
 
 /**
  * Reads activity reviews from the gateway, which returns them newest-first
@@ -1862,6 +1899,22 @@ declare class ReviewService {
      * ```
      */
     getReviews(productId: string, reviewCount?: number, reviewOffset?: number): Promise<Review[]>;
+    /**
+     * Returns an aggregate review summary for **every** activity — its average
+     * rating and the count of reviews at each star level. This reads the same
+     * activity list as `getAllProducts`; it carries no per-review detail or PII, so
+     * it is unaffected by `fullCustomerAccess`. An activity with no reviews comes
+     * back with a `null` `avgRating` and zero counts.
+     *
+     * @example
+     * ```ts
+     * const summaries = await peek.getReviewService().getAllReviewSummaries();
+     * for (const s of summaries) {
+     *   console.log(s.productName, s.avgRating, s.countTotal);
+     * }
+     * ```
+     */
+    getAllReviewSummaries(): Promise<ProductReviewSummary[]>;
     private validate;
 }
 
@@ -2990,4 +3043,4 @@ declare class AcmeApiError extends Error {
     constructor(statusCode: number, body: unknown, message?: string);
 }
 
-export { ACTIVITY_PRODUCT_TYPE, ADD_ON_PRODUCT_TYPE, type AccessOptions, type AccountUser, AccountUserService, type AccountUserServiceOptions, AcmeAccessService, type AcmeAccessServiceConfig, type AcmeActivity, type AcmeActivityTicket, AcmeApiError, AcmeProductService, type Activity, type ActivityOverrides, type ActivityTicket, type AddAddonInput, AdminAccountRequiredError, type Agent, type AssignGuideResult, type AssignedActivity, type AssignedResource, type Availability, AvailabilityService, type AvailabilityTime, type AvailabilityTimesQuery, type Booking, type BookingAddon, type BookingAddonMoney, type BookingAddonOption, type BookingAddons, type BookingAddonsMutationResult, type BookingPaymentsOnFile, type BookingReadOptions, type BookingSearchBy, BookingService, type BookingServiceOptions, type BookingTimeRangeSearch, type CancelBookingResult, type Channel, type ClearOverridesInput, CngAccessService, type CngAccessServiceConfig, CngApiError, CngPermissionError, CngProductService, type CreateBookingGuest, type CreateBookingInput, type CreateBookingTicket, type CreateEngineInput, type CreatePromoCodeInput, type CreatedBooking, type CreatedPricingEngine, type CreatedPromoCode, type CustomQuestion, type CustomQuestionAnswer, type CustomQuestionAnswerInput, type CustomQuestionOption, type DailyNote, DailyNoteService, type Duration, type Guest, type GuestMetadata, type Guide, type GuideAssignment, INSTALL_STATUSES, type InstallAccessConfig, type InstallAccessService, type InstallAccessTarget, type InstallStatus, type InstallWebhook, type InstallWebhookAccount, type InstallWebhookClaims, type InvoiceLinkResult, type Logger, type MakePaymentInput, type MakePaymentResult, type Membership, type MembershipPurchaseInput, MembershipService, type NoteMode, type Payment, type PaymentSource, PeekAccessService, type PeekAccessServiceConfig, type PeekAuthTokenClaims, type PeekAuthTokenUser, PeekGraphQLError, PeekHttpError, type PeekPlatform, PiiAccessDisabledError, type Price, type PricingActivityContext, type PricingEngine, type PricingMoney, type PricingNamedRef, type PricingOverride, type PricingOverrideFilter, PricingService, type Product, type ProductMeetingLocation, ProductService, type ProductServiceOptions, type ProductTicket, type PromoCode, type PromoCodeFixedAmount, PromoCodeService, type PromoCodeServiceOptions, type PurchasedMembership, RENTAL_PRODUCT_TYPE, RateLimitError, type RefundInput, type RefundResult, ResellerService, type ResolvedOverride, type ResolvedPricingOverride, type ResolvedResourceOption, type Resource, type ResourceOptionOverride, type ResourceOptionQuantity, type ResourcePool, type ResourcePoolAccountUser, type ResourcePoolAssignment, type ResourcePoolMode, ResourcePoolService, type Review, ReviewService, type Ticket, type Timeslot, type TimeslotFilter, TimeslotService, type UpdateEngineInput, type UpdateTimeslotResult, type UpsertOverridesInput, type UpsertOverridesResult, type Waiver, createAccessServiceForInstall, noopLogger, parseBookingWebhook, parseInstallWebhook, parseWaiverWebhook, verifyInstallWebhook };
+export { ACTIVITY_PRODUCT_TYPE, ADD_ON_PRODUCT_TYPE, type AccessOptions, type AccountUser, AccountUserService, type AccountUserServiceOptions, AcmeAccessService, type AcmeAccessServiceConfig, type AcmeActivity, type AcmeActivityTicket, AcmeApiError, AcmeProductService, type Activity, type ActivityOverrides, type ActivityTicket, type AddAddonInput, AdminAccountRequiredError, type Agent, type AssignGuideResult, type AssignedActivity, type AssignedResource, type Availability, AvailabilityService, type AvailabilityTime, type AvailabilityTimesQuery, type Booking, type BookingAddon, type BookingAddonMoney, type BookingAddonOption, type BookingAddons, type BookingAddonsMutationResult, type BookingPaymentsOnFile, type BookingReadOptions, type BookingSearchBy, BookingService, type BookingServiceOptions, type BookingTimeRangeSearch, type CancelBookingResult, type Channel, type ClearOverridesInput, CngAccessService, type CngAccessServiceConfig, CngApiError, CngPermissionError, CngProductService, type CreateBookingGuest, type CreateBookingInput, type CreateBookingTicket, type CreateEngineInput, type CreatePromoCodeInput, type CreatedBooking, type CreatedPricingEngine, type CreatedPromoCode, type CustomQuestion, type CustomQuestionAnswer, type CustomQuestionAnswerInput, type CustomQuestionOption, type DailyNote, DailyNoteService, type Duration, type Guest, type GuestMetadata, type Guide, type GuideAssignment, INSTALL_STATUSES, type InstallAccessConfig, type InstallAccessService, type InstallAccessTarget, type InstallStatus, type InstallWebhook, type InstallWebhookAccount, type InstallWebhookClaims, type InvoiceLinkResult, type Logger, type MakePaymentInput, type MakePaymentResult, type Membership, type MembershipPurchaseInput, MembershipService, type NoteMode, type Payment, type PaymentSource, PeekAccessService, type PeekAccessServiceConfig, type PeekAuthTokenClaims, type PeekAuthTokenUser, PeekGraphQLError, PeekHttpError, type PeekPlatform, PiiAccessDisabledError, type Price, type PricingActivityContext, type PricingEngine, type PricingMoney, type PricingNamedRef, type PricingOverride, type PricingOverrideFilter, PricingService, type Product, type ProductMeetingLocation, type ProductReviewSummary, ProductService, type ProductServiceOptions, type ProductTicket, type PromoCode, type PromoCodeFixedAmount, PromoCodeService, type PromoCodeServiceOptions, type PurchasedMembership, RENTAL_PRODUCT_TYPE, RateLimitError, type RefundInput, type RefundResult, ResellerService, type ResolvedOverride, type ResolvedPricingOverride, type ResolvedResourceOption, type Resource, type ResourceOptionOverride, type ResourceOptionQuantity, type ResourcePool, type ResourcePoolAccountUser, type ResourcePoolAssignment, type ResourcePoolMode, ResourcePoolService, type Review, ReviewService, type Ticket, type Timeslot, type TimeslotFilter, TimeslotService, type UpdateEngineInput, type UpdateTimeslotResult, type UpsertOverridesInput, type UpsertOverridesResult, type Waiver, createAccessServiceForInstall, noopLogger, parseBookingWebhook, parseInstallWebhook, parseWaiverWebhook, verifyInstallWebhook };

package/dist/index.d.ts

@@ -914,6 +914,16 @@ interface CreateBookingInput {
      * Default: `false`.
      */
     requireRequiredQuestions?: boolean;
+    /**
+     * When `true`, a `customQuestionAnswers` entry whose `questionIdOrText` is a
+     * `cq_…` id is accepted even if that id is **not** among the activity's custom
+     * questions — the check that a question id must match the activity's list is
+     * skipped, and the answer is sent as-is (as a text answer). Entries given by
+     * question **name** are unaffected: they still must match a question, so the
+     * activity's questions are fetched only when a by-name answer (or
+     * `requireRequiredQuestions`) needs them. Default: `false`.
+     */
+    acceptAllCustomQuestionIds?: boolean;
     /** Suppress the customer confirmation email. Default: false. */
     skipCustomerEmail?: boolean;
     /** Clone the quote from an existing order. */
@@ -1295,7 +1305,9 @@ declare class BookingService {
      * Resolves the input's custom-question answers into the quote's
      * `questionAnswers` payload (each tagged with a fresh `refid`), or `null` when
      * none were supplied. Fetches the activity's custom questions to validate
-     * against; throws on the first unmatched/ambiguous/invalid answer.
+     * against; throws on the first unmatched/ambiguous/invalid answer. When
+     * `acceptAllCustomQuestionIds` is set the fetch is skipped if every answer is
+     * given by id (a by-name answer still needs the list to resolve).
      */
     private buildQuestionAnswers;
     private markCreatedBookingPaid;
@@ -1822,6 +1834,31 @@ interface Review {
     /** Free-text review. May be null. */
     comment: string | null;
 }
+/**
+ * Aggregate review statistics for a single activity (product), as returned by
+ * {@link ReviewService.getAllReviewSummaries}. Carries no per-review detail or
+ * PII — just the rating distribution and average.
+ */
+interface ProductReviewSummary {
+    /** Activity (product) id the summary is for. */
+    productId: string;
+    /** Activity (product) name. */
+    productName: string;
+    /** Average star rating as a decimal, or `null` when there are no ratings. */
+    avgRating: number | null;
+    /** Total number of reviews. */
+    countTotal: number;
+    /** Number of 1-star reviews. */
+    countOneStar: number;
+    /** Number of 2-star reviews. */
+    countTwoStar: number;
+    /** Number of 3-star reviews. */
+    countThreeStar: number;
+    /** Number of 4-star reviews. */
+    countFourStar: number;
+    /** Number of 5-star reviews. */
+    countFiveStar: number;
+}
 
 /**
  * Reads activity reviews from the gateway, which returns them newest-first
@@ -1862,6 +1899,22 @@ declare class ReviewService {
      * ```
      */
     getReviews(productId: string, reviewCount?: number, reviewOffset?: number): Promise<Review[]>;
+    /**
+     * Returns an aggregate review summary for **every** activity — its average
+     * rating and the count of reviews at each star level. This reads the same
+     * activity list as `getAllProducts`; it carries no per-review detail or PII, so
+     * it is unaffected by `fullCustomerAccess`. An activity with no reviews comes
+     * back with a `null` `avgRating` and zero counts.
+     *
+     * @example
+     * ```ts
+     * const summaries = await peek.getReviewService().getAllReviewSummaries();
+     * for (const s of summaries) {
+     *   console.log(s.productName, s.avgRating, s.countTotal);
+     * }
+     * ```
+     */
+    getAllReviewSummaries(): Promise<ProductReviewSummary[]>;
     private validate;
 }
 
@@ -2990,4 +3043,4 @@ declare class AcmeApiError extends Error {
     constructor(statusCode: number, body: unknown, message?: string);
 }
 
-export { ACTIVITY_PRODUCT_TYPE, ADD_ON_PRODUCT_TYPE, type AccessOptions, type AccountUser, AccountUserService, type AccountUserServiceOptions, AcmeAccessService, type AcmeAccessServiceConfig, type AcmeActivity, type AcmeActivityTicket, AcmeApiError, AcmeProductService, type Activity, type ActivityOverrides, type ActivityTicket, type AddAddonInput, AdminAccountRequiredError, type Agent, type AssignGuideResult, type AssignedActivity, type AssignedResource, type Availability, AvailabilityService, type AvailabilityTime, type AvailabilityTimesQuery, type Booking, type BookingAddon, type BookingAddonMoney, type BookingAddonOption, type BookingAddons, type BookingAddonsMutationResult, type BookingPaymentsOnFile, type BookingReadOptions, type BookingSearchBy, BookingService, type BookingServiceOptions, type BookingTimeRangeSearch, type CancelBookingResult, type Channel, type ClearOverridesInput, CngAccessService, type CngAccessServiceConfig, CngApiError, CngPermissionError, CngProductService, type CreateBookingGuest, type CreateBookingInput, type CreateBookingTicket, type CreateEngineInput, type CreatePromoCodeInput, type CreatedBooking, type CreatedPricingEngine, type CreatedPromoCode, type CustomQuestion, type CustomQuestionAnswer, type CustomQuestionAnswerInput, type CustomQuestionOption, type DailyNote, DailyNoteService, type Duration, type Guest, type GuestMetadata, type Guide, type GuideAssignment, INSTALL_STATUSES, type InstallAccessConfig, type InstallAccessService, type InstallAccessTarget, type InstallStatus, type InstallWebhook, type InstallWebhookAccount, type InstallWebhookClaims, type InvoiceLinkResult, type Logger, type MakePaymentInput, type MakePaymentResult, type Membership, type MembershipPurchaseInput, MembershipService, type NoteMode, type Payment, type PaymentSource, PeekAccessService, type PeekAccessServiceConfig, type PeekAuthTokenClaims, type PeekAuthTokenUser, PeekGraphQLError, PeekHttpError, type PeekPlatform, PiiAccessDisabledError, type Price, type PricingActivityContext, type PricingEngine, type PricingMoney, type PricingNamedRef, type PricingOverride, type PricingOverrideFilter, PricingService, type Product, type ProductMeetingLocation, ProductService, type ProductServiceOptions, type ProductTicket, type PromoCode, type PromoCodeFixedAmount, PromoCodeService, type PromoCodeServiceOptions, type PurchasedMembership, RENTAL_PRODUCT_TYPE, RateLimitError, type RefundInput, type RefundResult, ResellerService, type ResolvedOverride, type ResolvedPricingOverride, type ResolvedResourceOption, type Resource, type ResourceOptionOverride, type ResourceOptionQuantity, type ResourcePool, type ResourcePoolAccountUser, type ResourcePoolAssignment, type ResourcePoolMode, ResourcePoolService, type Review, ReviewService, type Ticket, type Timeslot, type TimeslotFilter, TimeslotService, type UpdateEngineInput, type UpdateTimeslotResult, type UpsertOverridesInput, type UpsertOverridesResult, type Waiver, createAccessServiceForInstall, noopLogger, parseBookingWebhook, parseInstallWebhook, parseWaiverWebhook, verifyInstallWebhook };
+export { ACTIVITY_PRODUCT_TYPE, ADD_ON_PRODUCT_TYPE, type AccessOptions, type AccountUser, AccountUserService, type AccountUserServiceOptions, AcmeAccessService, type AcmeAccessServiceConfig, type AcmeActivity, type AcmeActivityTicket, AcmeApiError, AcmeProductService, type Activity, type ActivityOverrides, type ActivityTicket, type AddAddonInput, AdminAccountRequiredError, type Agent, type AssignGuideResult, type AssignedActivity, type AssignedResource, type Availability, AvailabilityService, type AvailabilityTime, type AvailabilityTimesQuery, type Booking, type BookingAddon, type BookingAddonMoney, type BookingAddonOption, type BookingAddons, type BookingAddonsMutationResult, type BookingPaymentsOnFile, type BookingReadOptions, type BookingSearchBy, BookingService, type BookingServiceOptions, type BookingTimeRangeSearch, type CancelBookingResult, type Channel, type ClearOverridesInput, CngAccessService, type CngAccessServiceConfig, CngApiError, CngPermissionError, CngProductService, type CreateBookingGuest, type CreateBookingInput, type CreateBookingTicket, type CreateEngineInput, type CreatePromoCodeInput, type CreatedBooking, type CreatedPricingEngine, type CreatedPromoCode, type CustomQuestion, type CustomQuestionAnswer, type CustomQuestionAnswerInput, type CustomQuestionOption, type DailyNote, DailyNoteService, type Duration, type Guest, type GuestMetadata, type Guide, type GuideAssignment, INSTALL_STATUSES, type InstallAccessConfig, type InstallAccessService, type InstallAccessTarget, type InstallStatus, type InstallWebhook, type InstallWebhookAccount, type InstallWebhookClaims, type InvoiceLinkResult, type Logger, type MakePaymentInput, type MakePaymentResult, type Membership, type MembershipPurchaseInput, MembershipService, type NoteMode, type Payment, type PaymentSource, PeekAccessService, type PeekAccessServiceConfig, type PeekAuthTokenClaims, type PeekAuthTokenUser, PeekGraphQLError, PeekHttpError, type PeekPlatform, PiiAccessDisabledError, type Price, type PricingActivityContext, type PricingEngine, type PricingMoney, type PricingNamedRef, type PricingOverride, type PricingOverrideFilter, PricingService, type Product, type ProductMeetingLocation, type ProductReviewSummary, ProductService, type ProductServiceOptions, type ProductTicket, type PromoCode, type PromoCodeFixedAmount, PromoCodeService, type PromoCodeServiceOptions, type PurchasedMembership, RENTAL_PRODUCT_TYPE, RateLimitError, type RefundInput, type RefundResult, ResellerService, type ResolvedOverride, type ResolvedPricingOverride, type ResolvedResourceOption, type Resource, type ResourceOptionOverride, type ResourceOptionQuantity, type ResourcePool, type ResourcePoolAccountUser, type ResourcePoolAssignment, type ResourcePoolMode, ResourcePoolService, type Review, ReviewService, type Ticket, type Timeslot, type TimeslotFilter, TimeslotService, type UpdateEngineInput, type UpdateTimeslotResult, type UpsertOverridesInput, type UpsertOverridesResult, type Waiver, createAccessServiceForInstall, noopLogger, parseBookingWebhook, parseInstallWebhook, parseWaiverWebhook, verifyInstallWebhook };

package/dist/index.js

@@ -1090,6 +1090,9 @@ var QUESTION_TYPE_SELECT_ONE = "SELECT_ONE";
 var QUESTION_TYPE_LOCATION = "LOCATION";
 var QUESTION_ID_REGEX = /^cq_[a-z0-9]+$/;
 var OPTION_ID_REGEX = /^cqao_[a-z0-9]+$/;
+function isCustomQuestionId(idOrText) {
+  return QUESTION_ID_REGEX.test(idOrText);
+}
 var CHECKBOX_TRUE = /* @__PURE__ */ new Set(["yes", "true"]);
 var CHECKBOX_VALID = /* @__PURE__ */ new Set(["yes", "no", "true", "false"]);
 var CHECKBOX_TEXT_TRUE = "Yes";
@@ -1107,10 +1110,13 @@ var errMissingRequired = (text, id) => `Custom question "${text}" (${id}) is req
 function normalize(value) {
   return value.toLowerCase().replace(/[^a-z0-9]/g, "");
 }
-function resolveQuestion(idOrText, questions) {
+function resolveQuestion(idOrText, questions, acceptAllIds) {
   if (QUESTION_ID_REGEX.test(idOrText)) {
     const byId = questions.find((question) => question.id === idOrText);
-    if (!byId) throw new Error(errUnknownQuestionId(idOrText));
+    if (!byId) {
+      if (acceptAllIds) return null;
+      throw new Error(errUnknownQuestionId(idOrText));
+    }
     return byId;
   }
   const target = normalize(idOrText);
@@ -1135,8 +1141,11 @@ function resolveOption(value, question) {
   if (matches.length > 1) throw new Error(errAmbiguousOption(value, question.id));
   return matches[0];
 }
-function resolveOne(answer, questions) {
-  const question = resolveQuestion(answer.questionIdOrText, questions);
+function resolveOne(answer, questions, acceptAllIds) {
+  const question = resolveQuestion(answer.questionIdOrText, questions, acceptAllIds);
+  if (!question) {
+    return { questionId: answer.questionIdOrText, questionAnswerText: answer.value };
+  }
   if (question.perGuest) {
     throw new Error(errPerGuestUnsupported(question.id));
   }
@@ -1169,7 +1178,8 @@ function resolveOne(answer, questions) {
   }
 }
 function resolveCustomQuestionAnswers(answers, questions, options) {
-  const resolved = answers.map((answer) => resolveOne(answer, questions));
+  const acceptAllIds = options?.acceptAllIds ?? false;
+  const resolved = answers.map((answer) => resolveOne(answer, questions, acceptAllIds));
   if (options?.requireRequired) {
     assertRequiredAnswered(resolved, questions);
   }
@@ -1777,19 +1787,22 @@ ${note}`;
    * Resolves the input's custom-question answers into the quote's
    * `questionAnswers` payload (each tagged with a fresh `refid`), or `null` when
    * none were supplied. Fetches the activity's custom questions to validate
-   * against; throws on the first unmatched/ambiguous/invalid answer.
+   * against; throws on the first unmatched/ambiguous/invalid answer. When
+   * `acceptAllCustomQuestionIds` is set the fetch is skipped if every answer is
+   * given by id (a by-name answer still needs the list to resolve).
    */
   async buildQuestionAnswers(input) {
     const answers = input.customQuestionAnswers ?? [];
     const requireRequired = input.requireRequiredQuestions ?? false;
+    const acceptAllIds = input.acceptAllCustomQuestionIds ?? false;
     if (answers.length === 0 && !requireRequired) {
       return null;
     }
-    const questions = await this.deps.productService.getCustomQuestions(
-      input.activityId
-    );
+    const needsQuestions = !acceptAllIds || requireRequired || answers.some((answer) => !isCustomQuestionId(answer.questionIdOrText));
+    const questions = needsQuestions ? await this.deps.productService.getCustomQuestions(input.activityId) : [];
     const resolved = resolveCustomQuestionAnswers(answers, questions, {
-      requireRequired
+      requireRequired,
+      acceptAllIds
     });
     if (resolved.length === 0) {
       return null;
@@ -2162,7 +2175,7 @@ async function requestWithRetry(http, url, init, label, onResponse) {
 // src/internal/sdk-headers.ts
 var SDK_HEADER_NAME = "x-peek-sdk";
 var SDK_PLATFORM = "js";
-var SDK_VERSION = "0.9.1";
+var SDK_VERSION = "0.9.2";
 var SDK_HEADER_VALUE = `${SDK_PLATFORM}-${SDK_VERSION}`;
 
 // src/internal/peek/graphql-client.ts
@@ -2587,6 +2600,23 @@ function fromReviewNode(node) {
     comment: node.comment ?? null
   };
 }
+function fromActivityReviewSummaryNode(node) {
+  const meta = node.reviewMeta;
+  return {
+    productId: node.id,
+    productName: node.name,
+    avgRating: meta?.avgRating ?? null,
+    countTotal: meta?.count ?? 0,
+    countOneStar: meta?.oneStar ?? 0,
+    countTwoStar: meta?.twoStar ?? 0,
+    countThreeStar: meta?.threeStar ?? 0,
+    countFourStar: meta?.fourStar ?? 0,
+    countFiveStar: meta?.fiveStar ?? 0
+  };
+}
+function fromActivityReviewSummaryNodes(nodes) {
+  return nodes.map(fromActivityReviewSummaryNode);
+}
 
 // src/internal/peek/reviews/review-cursor.ts
 function encodeCursor(offset, pageSize) {
@@ -2622,6 +2652,23 @@ function buildReviewsQuery(fullCustomerAccess) {
   }
 `;
 }
+var REVIEW_SUMMARIES_QUERY = `
+  query ReviewSummaries {
+    activities {
+      id
+      name
+      reviewMeta {
+        avgRating
+        count
+        fiveStar
+        fourStar
+        threeStar
+        twoStar
+        oneStar
+      }
+    }
+  }
+`;
 function buildReviewsVariables(params) {
   return {
     first: params.first,
@@ -2681,6 +2728,29 @@ var ReviewService = class {
     const edges = body.data?.reviews?.edges ?? [];
     return edges.map((edge) => fromReviewNode(edge.node));
   }
+  /**
+   * Returns an aggregate review summary for **every** activity — its average
+   * rating and the count of reviews at each star level. This reads the same
+   * activity list as `getAllProducts`; it carries no per-review detail or PII, so
+   * it is unaffected by `fullCustomerAccess`. An activity with no reviews comes
+   * back with a `null` `avgRating` and zero counts.
+   *
+   * @example
+   * ```ts
+   * const summaries = await peek.getReviewService().getAllReviewSummaries();
+   * for (const s of summaries) {
+   *   console.log(s.productName, s.avgRating, s.countTotal);
+   * }
+   * ```
+   */
+  async getAllReviewSummaries() {
+    const body = await this.client.request(
+      SALES_ENDPOINT,
+      REVIEW_SUMMARIES_QUERY,
+      {}
+    );
+    return fromActivityReviewSummaryNodes(body.data?.activities ?? []);
+  }
   validate(productId, reviewCount, reviewOffset) {
     if (!productId) {
       throw new Error(ERROR_PRODUCT_ID_REQUIRED);