@domandigital/gbp 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.5.0
+
+### Minor Changes
+
+- 4588886: Read reviews from the file Doman Digital publishes, so a site needs no Google token.
+  
+  - **`getPublishedReviews({ client })`** fetches `https://files.domandigital.co.uk/reviews/<client>.json` (override with `baseUrl` or `GBP_REVIEWS_BASE_URL`). One collector reads every listing with the only Google credential and the portal publishes the file each night, so a dead token makes reviews stale, not missing.
+  - Same shape as `getBusinessReviews`: Google's own `averageRating` and `totalReviewCount` for the whole listing, plus `reviews` (four and five stars with words, replies Google shows). Adds `syncedAt`, when Google was last read.
+  - Throws `GbpPublishedError` (`http`, `invalid`, `unknown_schema`) instead of returning an empty result, so the caller keeps the copy it already has. Retries 429 and transient 5xx within the usual deadline.
+  - Defaults to newest first (`order: "api"`) and a daily Next.js revalidate tagged `google-reviews`.
+
 ## 0.4.0
 
 ### Minor Changes

package/README.md

@@ -61,6 +61,35 @@ remove such markup and "You won't get a manual action just for this"
 Showing the reviews on the page is unaffected. Just do not sell or expect the
 stars. `@domandigital/graph`'s `findGraphIssues` can flag the pattern.
 
+## Reading the published file (no Google token on the site)
+
+Client sites should read reviews from the file Doman Digital publishes rather
+than from Google. One collector holds the only Google credential, the portal
+stores what it reads, and each night it writes
+`https://files.domandigital.co.uk/reviews/<client-slug>.json`:
+
+```ts
+import { getPublishedReviews } from "@domandigital/gbp";
+
+// Throws when the file is missing or malformed: keep the copy you already have.
+const { averageRating, totalReviewCount, reviews, syncedAt } = await getPublishedReviews({
+  client: "chair-and-blade",
+});
+```
+
+The result has the same shape as `getBusinessReviews`, plus `syncedAt`. The
+file already holds only what a site shows (four and five stars, with words,
+and owner replies Google shows); `filterMinStars` can only raise that floor.
+
+It throws `GbpPublishedError` instead of returning an empty result. Catch it
+where the site has an older copy to fall back to (a Next.js fetch keeps its
+last good response; a static build should refuse to publish and leave the
+last deploy live), and render no rating, count or review section when there
+is no copy at all. Never fall back to a hardcoded number.
+
+A site that reads this file needs none of the `GBP_*` or `GOOGLE_BUSINESS_*`
+variables below.
+
 ## Why Business Profile API, not Places API
 
 Places API's `Review` object has no field for the business's reply, full

package/dist/index.cjs

@@ -21,19 +21,25 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   DEFAULT_MAX_PAGES: () => DEFAULT_MAX_PAGES,
+  DEFAULT_PUBLISHED_REVIEWS_BASE_URL: () => DEFAULT_PUBLISHED_REVIEWS_BASE_URL,
   DEFAULT_REQUEST_POLICY: () => DEFAULT_REQUEST_POLICY,
   GbpApiError: () => GbpApiError,
   GbpAuthError: () => GbpAuthError,
   GbpError: () => GbpError,
   GbpPaginationError: () => GbpPaginationError,
+  GbpPublishedError: () => GbpPublishedError,
   GbpTimeoutError: () => GbpTimeoutError,
+  PUBLISHED_REVIEWS_SCHEMA: () => PUBLISHED_REVIEWS_SCHEMA,
   getBusinessReviews: () => getBusinessReviews,
   getGoogleOAuthAccessToken: () => getGoogleOAuthAccessToken,
+  getPublishedReviews: () => getPublishedReviews,
   hasGoogleOAuthCredentials: () => hasGoogleOAuthCredentials,
   invalidateAccessToken: () => invalidateAccessToken,
   isBusinessProfileConfigured: () => isBusinessProfileConfigured,
   parseListReviewsResponse: () => parseListReviewsResponse,
-  parseRetryAfter: () => parseRetryAfter
+  parsePublishedReviews: () => parsePublishedReviews,
+  parseRetryAfter: () => parseRetryAfter,
+  publishedReviewsUrl: () => publishedReviewsUrl
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -85,6 +91,14 @@ function excerpt(text, max = 300) {
   const flat = text.replace(/\s+/g, " ").trim();
   return flat.length > max ? `${flat.slice(0, max)}...` : flat;
 }
+var GbpPublishedError = class extends GbpError {
+  constructor(reason, client, detail, status) {
+    super(`Published reviews for ${client} unusable (${reason}): ${detail}`);
+    this.reason = reason;
+    this.client = client;
+    this.status = status;
+  }
+};
 
 // src/http.ts
 var DEFAULT_REQUEST_POLICY = {
@@ -395,20 +409,102 @@ async function getBusinessReviews(options = {}) {
     reviews: order === "api" ? reviews : shuffleArray(reviews)
   };
 }
+
+// src/published.ts
+var DEFAULT_PUBLISHED_REVIEWS_BASE_URL = "https://files.domandigital.co.uk/reviews";
+var PUBLISHED_REVIEWS_SCHEMA = 1;
+var isRecord2 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isTime = (v) => typeof v === "string" && !Number.isNaN(Date.parse(v));
+function parseReview2(v) {
+  if (!isRecord2(v)) return null;
+  const { id, author, rating, comment, createdAt, reply } = v;
+  if (typeof id !== "string" || typeof author !== "string" || typeof comment !== "string" || !comment) return null;
+  if (typeof rating !== "number" || !Number.isInteger(rating) || rating < 1 || rating > 5) return null;
+  const review = { id, author, rating, comment, createdAt: isTime(createdAt) ? createdAt : "" };
+  if (isRecord2(reply) && typeof reply.text === "string" && reply.text) {
+    review.reply = { text: reply.text, updatedAt: isTime(reply.updatedAt) ? reply.updatedAt : "" };
+  }
+  return review;
+}
+function parsePublishedReviews(body, client) {
+  if (!isRecord2(body)) throw new GbpPublishedError("invalid", client, "the file is not an object");
+  if (body.schema !== PUBLISHED_REVIEWS_SCHEMA) {
+    throw new GbpPublishedError("unknown_schema", client, `schema ${String(body.schema)}`);
+  }
+  if (body.client !== client) throw new GbpPublishedError("invalid", client, `the file is for ${String(body.client)}`);
+  const { rating, count } = body;
+  if (rating !== null && (typeof rating !== "number" || !(rating >= 0 && rating <= 5))) {
+    throw new GbpPublishedError("invalid", client, "rating out of range");
+  }
+  if (count !== null && (typeof count !== "number" || !Number.isInteger(count) || count < 0)) {
+    throw new GbpPublishedError("invalid", client, "count is not a whole number");
+  }
+  if (!isTime(body.synced_at) || !isTime(body.published_at) || !Array.isArray(body.reviews)) {
+    throw new GbpPublishedError("invalid", client, "synced_at, published_at or reviews missing");
+  }
+  return {
+    averageRating: rating,
+    totalReviewCount: count,
+    reviews: body.reviews.map(parseReview2).filter((r) => r !== null),
+    syncedAt: body.synced_at,
+    publishedAt: body.published_at
+  };
+}
+function shuffle(arr) {
+  const copy = [...arr];
+  for (let i = copy.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1));
+    [copy[i], copy[j]] = [copy[j], copy[i]];
+  }
+  return copy;
+}
+function publishedReviewsUrl(client, baseUrl) {
+  if (!/^[a-z0-9][a-z0-9-]{0,99}$/.test(client)) throw new RangeError(`not a client slug: ${client}`);
+  const base = (baseUrl ?? process.env.GBP_REVIEWS_BASE_URL ?? DEFAULT_PUBLISHED_REVIEWS_BASE_URL).replace(/\/+$/, "");
+  return `${base}/${client}.json`;
+}
+async function getPublishedReviews(options) {
+  const { client, filterMinStars, limit, order = "api", next, request } = options;
+  const url = publishedReviewsUrl(client, options.baseUrl);
+  const init = {
+    headers: { Accept: "application/json" },
+    next: next ?? { revalidate: 86400, tags: ["google-reviews"] }
+  };
+  const { response } = await fetchWithRetry(url, init, "reviews.published", resolvePolicy(request));
+  if (!response.ok) {
+    throw new GbpPublishedError("http", client, `${response.status} ${excerpt(await readErrorBody(response), 120)}`.trim(), response.status);
+  }
+  let body;
+  try {
+    body = await response.json();
+  } catch {
+    throw new GbpPublishedError("invalid", client, "the file is not JSON");
+  }
+  const result = parsePublishedReviews(body, client);
+  let reviews = filterMinStars === void 0 ? result.reviews : result.reviews.filter((r) => r.rating >= filterMinStars);
+  if (limit !== void 0) reviews = reviews.slice(0, limit);
+  return { ...result, reviews: order === "shuffle" ? shuffle(reviews) : reviews };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_MAX_PAGES,
+  DEFAULT_PUBLISHED_REVIEWS_BASE_URL,
   DEFAULT_REQUEST_POLICY,
   GbpApiError,
   GbpAuthError,
   GbpError,
   GbpPaginationError,
+  GbpPublishedError,
   GbpTimeoutError,
+  PUBLISHED_REVIEWS_SCHEMA,
   getBusinessReviews,
   getGoogleOAuthAccessToken,
+  getPublishedReviews,
   hasGoogleOAuthCredentials,
   invalidateAccessToken,
   isBusinessProfileConfigured,
   parseListReviewsResponse,
-  parseRetryAfter
+  parsePublishedReviews,
+  parseRetryAfter,
+  publishedReviewsUrl
 });

package/dist/index.d.cts

@@ -240,6 +240,48 @@ declare function parseListReviewsResponse(body: unknown): ReviewsPage;
  */
 declare function getBusinessReviews(options?: GetBusinessReviewsOptions): Promise<BusinessReviewsResult>;
 
+/** Where Doman Digital's portal publishes review files. */
+declare const DEFAULT_PUBLISHED_REVIEWS_BASE_URL = "https://files.domandigital.co.uk/reviews";
+/** The file schema this reader understands. A newer file is refused rather than misread. */
+declare const PUBLISHED_REVIEWS_SCHEMA = 1;
+interface GetPublishedReviewsOptions {
+    /** The client's slug, e.g. `"chair-and-blade"`. */
+    client: string;
+    /** Default: `GBP_REVIEWS_BASE_URL` from the environment, else {@link DEFAULT_PUBLISHED_REVIEWS_BASE_URL}. */
+    baseUrl?: string;
+    /** Raise the published floor (four stars). Values at or below four change nothing. */
+    filterMinStars?: number;
+    /** Max reviews to return. Default: all of them. */
+    limit?: number;
+    /** `"api"` (default): newest first, as published. `"shuffle"`: random order, applied after `limit`. */
+    order?: ReviewOrder;
+    /** Cache hint passed to `fetch` for Next.js. Default: revalidate daily, tag `google-reviews`. */
+    next?: {
+        revalidate?: number;
+        tags?: string[];
+    };
+    /** Deadline and retry policy. */
+    request?: GbpRequestOptions;
+}
+interface PublishedReviewsResult extends BusinessReviewsResult {
+    /** When the collector last read Google in full. */
+    syncedAt: string;
+    /** When the file was written. */
+    publishedAt: string;
+}
+/**
+ * Validate a published file. A malformed review is skipped; a malformed file, a file for another client or a schema
+ * this reader does not know throws {@link GbpPublishedError}.
+ */
+declare function parsePublishedReviews(body: unknown, client: string): PublishedReviewsResult;
+/** The URL a client's file is read from. */
+declare function publishedReviewsUrl(client: string, baseUrl?: string): string;
+/**
+ * Fetch a client's published reviews. Retries 429 and transient 5xx within a deadline (see `request`), then throws:
+ * {@link GbpPublishedError} for a missing or malformed file, `GbpTimeoutError` for a deadline.
+ */
+declare function getPublishedReviews(options: GetPublishedReviewsOptions): Promise<PublishedReviewsResult>;
+
 /**
  * Typed failures, so a site can tell "reauthorise the Google account" from
  * "Google is having a bad minute" from "our code looped", and log the
@@ -303,5 +345,16 @@ declare class GbpPaginationError extends GbpError {
     readonly pagesFetched: number;
     constructor(reason: "repeated_token" | "page_limit", pagesFetched: number);
 }
+/**
+ * A published reviews file could not be used: the address answered an error (`http`, with `status`), the file was
+ * malformed or for another client (`invalid`), or it uses a schema this version does not read (`unknown_schema`,
+ * upgrade the package). The caller keeps the copy it already has.
+ */
+declare class GbpPublishedError extends GbpError {
+    readonly reason: "http" | "invalid" | "unknown_schema";
+    readonly client: string;
+    readonly status?: number;
+    constructor(reason: "http" | "invalid" | "unknown_schema", client: string, detail: string, status?: number);
+}
 
-export { type AccessTokenOptions, type BusinessReview, type BusinessReviewsResult, DEFAULT_MAX_PAGES, DEFAULT_REQUEST_POLICY, GbpApiError, GbpAuthError, type GbpAuthErrorCode, GbpError, GbpPaginationError, type GbpRequestOptions, GbpTimeoutError, type GetBusinessReviewsOptions, type ReviewMedia, type ReviewOrder, type ReviewReply, type ReviewReplyState, getBusinessReviews, getGoogleOAuthAccessToken, hasGoogleOAuthCredentials, invalidateAccessToken, isBusinessProfileConfigured, parseListReviewsResponse, parseRetryAfter };
+export { type AccessTokenOptions, type BusinessReview, type BusinessReviewsResult, DEFAULT_MAX_PAGES, DEFAULT_PUBLISHED_REVIEWS_BASE_URL, DEFAULT_REQUEST_POLICY, GbpApiError, GbpAuthError, type GbpAuthErrorCode, GbpError, GbpPaginationError, GbpPublishedError, type GbpRequestOptions, GbpTimeoutError, type GetBusinessReviewsOptions, type GetPublishedReviewsOptions, PUBLISHED_REVIEWS_SCHEMA, type PublishedReviewsResult, type ReviewMedia, type ReviewOrder, type ReviewReply, type ReviewReplyState, getBusinessReviews, getGoogleOAuthAccessToken, getPublishedReviews, hasGoogleOAuthCredentials, invalidateAccessToken, isBusinessProfileConfigured, parseListReviewsResponse, parsePublishedReviews, parseRetryAfter, publishedReviewsUrl };

package/dist/index.d.ts

@@ -240,6 +240,48 @@ declare function parseListReviewsResponse(body: unknown): ReviewsPage;
  */
 declare function getBusinessReviews(options?: GetBusinessReviewsOptions): Promise<BusinessReviewsResult>;
 
+/** Where Doman Digital's portal publishes review files. */
+declare const DEFAULT_PUBLISHED_REVIEWS_BASE_URL = "https://files.domandigital.co.uk/reviews";
+/** The file schema this reader understands. A newer file is refused rather than misread. */
+declare const PUBLISHED_REVIEWS_SCHEMA = 1;
+interface GetPublishedReviewsOptions {
+    /** The client's slug, e.g. `"chair-and-blade"`. */
+    client: string;
+    /** Default: `GBP_REVIEWS_BASE_URL` from the environment, else {@link DEFAULT_PUBLISHED_REVIEWS_BASE_URL}. */
+    baseUrl?: string;
+    /** Raise the published floor (four stars). Values at or below four change nothing. */
+    filterMinStars?: number;
+    /** Max reviews to return. Default: all of them. */
+    limit?: number;
+    /** `"api"` (default): newest first, as published. `"shuffle"`: random order, applied after `limit`. */
+    order?: ReviewOrder;
+    /** Cache hint passed to `fetch` for Next.js. Default: revalidate daily, tag `google-reviews`. */
+    next?: {
+        revalidate?: number;
+        tags?: string[];
+    };
+    /** Deadline and retry policy. */
+    request?: GbpRequestOptions;
+}
+interface PublishedReviewsResult extends BusinessReviewsResult {
+    /** When the collector last read Google in full. */
+    syncedAt: string;
+    /** When the file was written. */
+    publishedAt: string;
+}
+/**
+ * Validate a published file. A malformed review is skipped; a malformed file, a file for another client or a schema
+ * this reader does not know throws {@link GbpPublishedError}.
+ */
+declare function parsePublishedReviews(body: unknown, client: string): PublishedReviewsResult;
+/** The URL a client's file is read from. */
+declare function publishedReviewsUrl(client: string, baseUrl?: string): string;
+/**
+ * Fetch a client's published reviews. Retries 429 and transient 5xx within a deadline (see `request`), then throws:
+ * {@link GbpPublishedError} for a missing or malformed file, `GbpTimeoutError` for a deadline.
+ */
+declare function getPublishedReviews(options: GetPublishedReviewsOptions): Promise<PublishedReviewsResult>;
+
 /**
  * Typed failures, so a site can tell "reauthorise the Google account" from
  * "Google is having a bad minute" from "our code looped", and log the
@@ -303,5 +345,16 @@ declare class GbpPaginationError extends GbpError {
     readonly pagesFetched: number;
     constructor(reason: "repeated_token" | "page_limit", pagesFetched: number);
 }
+/**
+ * A published reviews file could not be used: the address answered an error (`http`, with `status`), the file was
+ * malformed or for another client (`invalid`), or it uses a schema this version does not read (`unknown_schema`,
+ * upgrade the package). The caller keeps the copy it already has.
+ */
+declare class GbpPublishedError extends GbpError {
+    readonly reason: "http" | "invalid" | "unknown_schema";
+    readonly client: string;
+    readonly status?: number;
+    constructor(reason: "http" | "invalid" | "unknown_schema", client: string, detail: string, status?: number);
+}
 
-export { type AccessTokenOptions, type BusinessReview, type BusinessReviewsResult, DEFAULT_MAX_PAGES, DEFAULT_REQUEST_POLICY, GbpApiError, GbpAuthError, type GbpAuthErrorCode, GbpError, GbpPaginationError, type GbpRequestOptions, GbpTimeoutError, type GetBusinessReviewsOptions, type ReviewMedia, type ReviewOrder, type ReviewReply, type ReviewReplyState, getBusinessReviews, getGoogleOAuthAccessToken, hasGoogleOAuthCredentials, invalidateAccessToken, isBusinessProfileConfigured, parseListReviewsResponse, parseRetryAfter };
+export { type AccessTokenOptions, type BusinessReview, type BusinessReviewsResult, DEFAULT_MAX_PAGES, DEFAULT_PUBLISHED_REVIEWS_BASE_URL, DEFAULT_REQUEST_POLICY, GbpApiError, GbpAuthError, type GbpAuthErrorCode, GbpError, GbpPaginationError, GbpPublishedError, type GbpRequestOptions, GbpTimeoutError, type GetBusinessReviewsOptions, type GetPublishedReviewsOptions, PUBLISHED_REVIEWS_SCHEMA, type PublishedReviewsResult, type ReviewMedia, type ReviewOrder, type ReviewReply, type ReviewReplyState, getBusinessReviews, getGoogleOAuthAccessToken, getPublishedReviews, hasGoogleOAuthCredentials, invalidateAccessToken, isBusinessProfileConfigured, parseListReviewsResponse, parsePublishedReviews, parseRetryAfter, publishedReviewsUrl };

package/dist/index.js

@@ -46,6 +46,14 @@ function excerpt(text, max = 300) {
   const flat = text.replace(/\s+/g, " ").trim();
   return flat.length > max ? `${flat.slice(0, max)}...` : flat;
 }
+var GbpPublishedError = class extends GbpError {
+  constructor(reason, client, detail, status) {
+    super(`Published reviews for ${client} unusable (${reason}): ${detail}`);
+    this.reason = reason;
+    this.client = client;
+    this.status = status;
+  }
+};
 
 // src/http.ts
 var DEFAULT_REQUEST_POLICY = {
@@ -356,19 +364,101 @@ async function getBusinessReviews(options = {}) {
     reviews: order === "api" ? reviews : shuffleArray(reviews)
   };
 }
+
+// src/published.ts
+var DEFAULT_PUBLISHED_REVIEWS_BASE_URL = "https://files.domandigital.co.uk/reviews";
+var PUBLISHED_REVIEWS_SCHEMA = 1;
+var isRecord2 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isTime = (v) => typeof v === "string" && !Number.isNaN(Date.parse(v));
+function parseReview2(v) {
+  if (!isRecord2(v)) return null;
+  const { id, author, rating, comment, createdAt, reply } = v;
+  if (typeof id !== "string" || typeof author !== "string" || typeof comment !== "string" || !comment) return null;
+  if (typeof rating !== "number" || !Number.isInteger(rating) || rating < 1 || rating > 5) return null;
+  const review = { id, author, rating, comment, createdAt: isTime(createdAt) ? createdAt : "" };
+  if (isRecord2(reply) && typeof reply.text === "string" && reply.text) {
+    review.reply = { text: reply.text, updatedAt: isTime(reply.updatedAt) ? reply.updatedAt : "" };
+  }
+  return review;
+}
+function parsePublishedReviews(body, client) {
+  if (!isRecord2(body)) throw new GbpPublishedError("invalid", client, "the file is not an object");
+  if (body.schema !== PUBLISHED_REVIEWS_SCHEMA) {
+    throw new GbpPublishedError("unknown_schema", client, `schema ${String(body.schema)}`);
+  }
+  if (body.client !== client) throw new GbpPublishedError("invalid", client, `the file is for ${String(body.client)}`);
+  const { rating, count } = body;
+  if (rating !== null && (typeof rating !== "number" || !(rating >= 0 && rating <= 5))) {
+    throw new GbpPublishedError("invalid", client, "rating out of range");
+  }
+  if (count !== null && (typeof count !== "number" || !Number.isInteger(count) || count < 0)) {
+    throw new GbpPublishedError("invalid", client, "count is not a whole number");
+  }
+  if (!isTime(body.synced_at) || !isTime(body.published_at) || !Array.isArray(body.reviews)) {
+    throw new GbpPublishedError("invalid", client, "synced_at, published_at or reviews missing");
+  }
+  return {
+    averageRating: rating,
+    totalReviewCount: count,
+    reviews: body.reviews.map(parseReview2).filter((r) => r !== null),
+    syncedAt: body.synced_at,
+    publishedAt: body.published_at
+  };
+}
+function shuffle(arr) {
+  const copy = [...arr];
+  for (let i = copy.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1));
+    [copy[i], copy[j]] = [copy[j], copy[i]];
+  }
+  return copy;
+}
+function publishedReviewsUrl(client, baseUrl) {
+  if (!/^[a-z0-9][a-z0-9-]{0,99}$/.test(client)) throw new RangeError(`not a client slug: ${client}`);
+  const base = (baseUrl ?? process.env.GBP_REVIEWS_BASE_URL ?? DEFAULT_PUBLISHED_REVIEWS_BASE_URL).replace(/\/+$/, "");
+  return `${base}/${client}.json`;
+}
+async function getPublishedReviews(options) {
+  const { client, filterMinStars, limit, order = "api", next, request } = options;
+  const url = publishedReviewsUrl(client, options.baseUrl);
+  const init = {
+    headers: { Accept: "application/json" },
+    next: next ?? { revalidate: 86400, tags: ["google-reviews"] }
+  };
+  const { response } = await fetchWithRetry(url, init, "reviews.published", resolvePolicy(request));
+  if (!response.ok) {
+    throw new GbpPublishedError("http", client, `${response.status} ${excerpt(await readErrorBody(response), 120)}`.trim(), response.status);
+  }
+  let body;
+  try {
+    body = await response.json();
+  } catch {
+    throw new GbpPublishedError("invalid", client, "the file is not JSON");
+  }
+  const result = parsePublishedReviews(body, client);
+  let reviews = filterMinStars === void 0 ? result.reviews : result.reviews.filter((r) => r.rating >= filterMinStars);
+  if (limit !== void 0) reviews = reviews.slice(0, limit);
+  return { ...result, reviews: order === "shuffle" ? shuffle(reviews) : reviews };
+}
 export {
   DEFAULT_MAX_PAGES,
+  DEFAULT_PUBLISHED_REVIEWS_BASE_URL,
   DEFAULT_REQUEST_POLICY,
   GbpApiError,
   GbpAuthError,
   GbpError,
   GbpPaginationError,
+  GbpPublishedError,
   GbpTimeoutError,
+  PUBLISHED_REVIEWS_SCHEMA,
   getBusinessReviews,
   getGoogleOAuthAccessToken,
+  getPublishedReviews,
   hasGoogleOAuthCredentials,
   invalidateAccessToken,
   isBusinessProfileConfigured,
   parseListReviewsResponse,
-  parseRetryAfter
+  parsePublishedReviews,
+  parseRetryAfter,
+  publishedReviewsUrl
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domandigital/gbp",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "private": false,
   "description": "Zero-dependency Google Business Profile client: OAuth refresh-token auth and a reviews (with owner replies) fetch, shared across Doman Digital / IDS client sites.",
   "license": "Apache-2.0",
@@ -32,7 +32,7 @@
     "@types/node": "^20",
     "tsup": "^8.3.5",
     "typescript": "^5.6.3",
-    "vitest": "^2.1.9"
+    "vitest": "^4.0.0"
   },
   "engines": {
     "node": ">=22.12"