@brandlab-digital/site-next 1.0.0-rc.2 → 1.0.0-rc.21

package/dist/google-reviews-server.js

@@ -0,0 +1,151 @@
+import 'server-only';
+import { createGooglePlaceReviewsUnavailableSnapshot, fetchGooglePlaceReviewsSnapshot, normalizeGooglePlaceId, normalizeGooglePlaceReviewsMode, } from '@brandlab-digital/site-core/google-reviews';
+import { createRedisGooglePlaceReviewsQuotaGuard } from './google-reviews-durable.js';
+import { createBrandlabUpstashRedisEvalClient } from './redis-rest.js';
+export const BRANDLAB_GOOGLE_REVIEWS_PRODUCTION_RUNTIME = 'brandlab-google-reviews-production-v1';
+export const BRANDLAB_GOOGLE_REVIEWS_ENVIRONMENT_NAMES = {
+    apiKey: 'GOOGLE_MAPS_PLATFORM_API_KEY',
+    redisRestUrl: 'UPSTASH_REDIS_REST_URL',
+    redisRestToken: 'UPSTASH_REDIS_REST_TOKEN',
+};
+export const GOOGLE_PLACE_REVIEWS_UNAVAILABLE_HEADERS = {
+    'Cache-Control': 'private, no-store, max-age=0',
+    Pragma: 'no-cache',
+    'X-Content-Type-Options': 'nosniff',
+};
+export const GOOGLE_PLACE_REVIEWS_AVAILABLE_HEADERS = GOOGLE_PLACE_REVIEWS_UNAVAILABLE_HEADERS;
+const inFlightByFetcher = new WeakMap();
+function coalescingKey(options) {
+    return JSON.stringify([
+        normalizeGooglePlaceId(options.placeId) ?? '',
+        normalizeGooglePlaceReviewsMode(options.mode),
+        options.maxReviews ?? null,
+        options.fallbackGoogleMapsUri ?? '',
+    ]);
+}
+async function loadGooglePlaceReviewsSnapshot(options) {
+    const placeId = normalizeGooglePlaceId(options.placeId);
+    const mode = normalizeGooglePlaceReviewsMode(options.mode);
+    if (!options.apiKey?.trim() || !placeId) {
+        return { snapshot: await fetchGooglePlaceReviewsSnapshot(options) };
+    }
+    if (typeof options.quotaGuard !== 'function') {
+        return {
+            snapshot: createGooglePlaceReviewsUnavailableSnapshot('quota-guard-unavailable', options.fallbackGoogleMapsUri, mode),
+            forcedStatus: 503,
+        };
+    }
+    let decision;
+    try {
+        decision = await options.quotaGuard({ placeId });
+        if (typeof decision?.allowed !== 'boolean' ||
+            (decision.retryAfterSeconds !== undefined && (!Number.isSafeInteger(decision.retryAfterSeconds) ||
+                decision.retryAfterSeconds < 1 ||
+                decision.retryAfterSeconds > 86_400))) {
+            throw new Error('Invalid quota decision.');
+        }
+    }
+    catch {
+        return {
+            snapshot: createGooglePlaceReviewsUnavailableSnapshot('quota-guard-unavailable', options.fallbackGoogleMapsUri, mode),
+            forcedStatus: 503,
+        };
+    }
+    if (!decision.allowed) {
+        return {
+            snapshot: createGooglePlaceReviewsUnavailableSnapshot('quota-exhausted', options.fallbackGoogleMapsUri, mode),
+            forcedStatus: 429,
+            ...(decision.retryAfterSeconds
+                ? { retryAfterSeconds: decision.retryAfterSeconds }
+                : {}),
+        };
+    }
+    return { snapshot: await fetchGooglePlaceReviewsSnapshot(options) };
+}
+function getGooglePlaceReviewsRequest(options) {
+    const fetcher = options.fetcher ?? fetch;
+    const requests = inFlightByFetcher.get(fetcher) ?? new Map();
+    inFlightByFetcher.set(fetcher, requests);
+    const key = coalescingKey(options);
+    const existing = requests.get(key);
+    if (existing)
+        return existing;
+    const request = loadGooglePlaceReviewsSnapshot(options).finally(() => {
+        requests.delete(key);
+        if (requests.size === 0)
+            inFlightByFetcher.delete(fetcher);
+    });
+    requests.set(key, request);
+    return request;
+}
+/** Low-level route response for tests and approved custom adapters. */
+export async function createGooglePlaceReviewsRouteResponse(options) {
+    const result = await getGooglePlaceReviewsRequest(options);
+    const headers = new Headers(options.responseInit?.headers);
+    Object.entries(GOOGLE_PLACE_REVIEWS_AVAILABLE_HEADERS).forEach(([name, value]) => {
+        headers.set(name, value);
+    });
+    if (result.retryAfterSeconds) {
+        headers.set('Retry-After', String(result.retryAfterSeconds));
+    }
+    return Response.json(result.snapshot, {
+        ...options.responseInit,
+        status: result.forcedStatus ?? options.responseInit?.status,
+        headers,
+    });
+}
+function requiredEnvironment(environment, name) {
+    const value = environment[name];
+    if (typeof value !== 'string' ||
+        value.length < 1 ||
+        value.length > 8_192 ||
+        /[\u0000-\u001f\u007f]/.test(value)) {
+        throw new Error(`Required Google reviews environment variable ${name} is unavailable.`);
+    }
+    return value;
+}
+/**
+ * Creates the one approved production route: live no-store Places data,
+ * durable per-project quota protection and no persisted review content.
+ */
+export function createBrandlabGooglePlaceReviewsProductionRuntime(options) {
+    if ((options.fetcher || options.now) &&
+        options.environment.NODE_ENV !== 'test') {
+        throw new Error('Google reviews transport and clock overrides are available only in test mode.');
+    }
+    const apiKey = requiredEnvironment(options.environment, BRANDLAB_GOOGLE_REVIEWS_ENVIRONMENT_NAMES.apiKey);
+    const redisRestUrl = requiredEnvironment(options.environment, BRANDLAB_GOOGLE_REVIEWS_ENVIRONMENT_NAMES.redisRestUrl);
+    const redisRestToken = requiredEnvironment(options.environment, BRANDLAB_GOOGLE_REVIEWS_ENVIRONMENT_NAMES.redisRestToken);
+    const fetcher = options.fetcher ?? fetch;
+    const redis = createBrandlabUpstashRedisEvalClient({
+        url: redisRestUrl,
+        token: redisRestToken,
+        fetcher,
+    });
+    const quotaGuard = createRedisGooglePlaceReviewsQuotaGuard({
+        redis,
+        projectId: options.projectId,
+        monthlyRequestLimit: options.monthlyRequestLimit,
+        ...(options.namespace ? { namespace: options.namespace } : {}),
+        ...(options.now ? { now: options.now } : {}),
+    });
+    const mode = normalizeGooglePlaceReviewsMode(options.mode);
+    return {
+        runtimeKind: BRANDLAB_GOOGLE_REVIEWS_PRODUCTION_RUNTIME,
+        mode,
+        routeHandler: () => createGooglePlaceReviewsRouteResponse({
+            apiKey,
+            placeId: options.placeId,
+            mode,
+            ...(mode === 'full' && options.maxReviews !== undefined
+                ? { maxReviews: options.maxReviews }
+                : {}),
+            ...(options.fallbackGoogleMapsUri
+                ? { fallbackGoogleMapsUri: options.fallbackGoogleMapsUri }
+                : {}),
+            quotaGuard,
+            fetcher,
+        }),
+    };
+}
+//# sourceMappingURL=google-reviews-server.js.map

package/dist/google-reviews-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-reviews-server.js","sourceRoot":"","sources":["../src/google-reviews-server.ts"],"names":[],"mappings":"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"}