@aglyn/plugins-commerce 1.0.0-beta.244 → 1.0.0-beta.247

package/src/lib/model/product-reviews.js

@@ -0,0 +1,133 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { orderEntitlesProduct } from "./commerce-orders.js";
+export const REVIEW_STATUSES = [
+    'pending',
+    'approved',
+    'hidden',
+    'rejected'
+];
+/**
+ * Why a merchant hid or rejected a review. Content reasons only: the FTC's
+ * 2024 rule on fake reviews bars suppressing an honest review for being
+ * negative, so "I don't like it" is not on the list.
+ */ export const REVIEW_MODERATION_REASONS = [
+    'spam',
+    'abusive',
+    'off_topic',
+    'private_information'
+];
+export const REVIEW_MODERATION_REASON_LABELS = {
+    spam: 'Spam or advertising',
+    abusive: 'Abusive or hateful',
+    off_topic: 'Not about the product',
+    private_information: 'Shares private information'
+};
+export function isReviewModerationReason(value) {
+    return REVIEW_MODERATION_REASONS.includes(String(value));
+}
+/** The review-request email's delay, in days after fulfilment. */ export const REVIEW_REQUEST_DELAY_DEFAULT_DAYS = 7;
+export const REVIEW_REQUEST_DELAY_MIN_DAYS = 3;
+export const REVIEW_REQUEST_DELAY_MAX_DAYS = 30;
+/** How long a review link from the email works. */ export const REVIEW_TOKEN_TTL_MS = 60 * 24 * 60 * 60 * 1000;
+const DAY_MS = 24 * 60 * 60 * 1000;
+/**
+ * Reads `hosts/{hostId}/settings/store.reviews`. Defensive in the safe
+ * direction: anything but an explicit `'anyone'` is `verified`, so every
+ * existing store (no map at all) is verified-only, and only an explicit
+ * `false` turns the email off — the transaction-email convention (AGL-3600).
+ */ export function reviewSettingsFrom(storeSettings) {
+    const raw = storeSettings && typeof storeSettings === 'object' ? storeSettings['reviews'] : undefined;
+    const days = Math.round(Number(raw == null ? void 0 : raw['requestDelayDays']));
+    return {
+        policy: (raw == null ? void 0 : raw['policy']) === 'anyone' ? 'anyone' : 'verified',
+        requestEmail: (raw == null ? void 0 : raw['requestEmail']) !== false,
+        requestDelayDays: Number.isFinite(days) ? Math.min(REVIEW_REQUEST_DELAY_MAX_DAYS, Math.max(REVIEW_REQUEST_DELAY_MIN_DAYS, days)) : REVIEW_REQUEST_DELAY_DEFAULT_DAYS
+    };
+}
+/**
+ * When an order fulfilled at `fulfilledAtMs` is owed its review request.
+ * The scheduler stamps the EARLIEST possible moment (the 3-day minimum) and
+ * the sweep re-reads the store's current delay, so a setting changed after
+ * fulfilment still applies.
+ */ export function reviewRequestDueAtMs(fulfilledAtMs, delayDays) {
+    return fulfilledAtMs + delayDays * DAY_MS;
+}
+export function reviewRequestEarliestDueAtMs(fulfilledAtMs) {
+    return reviewRequestDueAtMs(fulfilledAtMs, REVIEW_REQUEST_DELAY_MIN_DAYS);
+}
+/**
+ * Whether an order's buyer is asked for a review at all. A register sale is
+ * not (the address was given for a receipt at the counter), nor is an order
+ * sold on an outside marketplace (its reviews belong there).
+ */ export function orderTakesReviewRequest(order) {
+    if (order.channel === 'pos' || order.channel === 'marketplace') return false;
+    return ![
+        'pending',
+        'cancelled',
+        'refunded'
+    ].includes(String(order.status));
+}
+/**
+ * The products a review request lists: each distinct product on the order
+ * that the order still entitles — a line refunded by name is never asked
+ * about, and neither is a fully refunded or cancelled order.
+ */ export function reviewableProductIds(order) {
+    var _order_lineItems;
+    const ids = [];
+    for (const line of (_order_lineItems = order.lineItems) != null ? _order_lineItems : []){
+        var _ref;
+        const productId = String((_ref = line == null ? void 0 : line.productId) != null ? _ref : '');
+        if (!productId || ids.includes(productId)) continue;
+        if (orderEntitlesProduct(order, productId)) ids.push(productId);
+    }
+    return ids;
+}
+/** Error codes the reviews route answers with, for the storefront to word. */ export const REVIEW_ERROR_CODES = {
+    verifiedPurchaseRequired: 'verified_purchase_required',
+    tokenInvalid: 'review_token_invalid',
+    tokenUsed: 'review_token_used',
+    tokenExpired: 'review_token_expired',
+    rateLimited: 'review_rate_limited',
+    notEnabled: 'reviews_not_enabled',
+    memberSuspended: 'member_suspended',
+    alreadyReviewed: 'already_reviewed'
+};
+/**
+ * The eligibility answer from what the server established. Pure, so the
+ * storefront's three states are specified in one place.
+ */ export function reviewEligibility(input) {
+    const verifiedVia = input.tokenVerified ? 'token' : input.memberVerified ? 'member' : null;
+    const canReview = verifiedVia !== null || input.policy === 'anyone';
+    return _extends({
+        policy: input.policy,
+        signedIn: input.signedIn,
+        verifiedVia,
+        canReview,
+        // A signed-in member is never asked for an email: the account has one.
+        needsEmail: canReview && verifiedVia === null && !input.signedIn
+    }, input.tokenProblem ? {
+        tokenProblem: input.tokenProblem
+    } : {});
+}
+/** The status a new review is saved with. */ export function initialReviewStatus(verified) {
+    // Verified reviews publish at once (the FTC's 2024 rule); unverified ones,
+    // possible only under 'anyone', wait for the merchant.
+    return verified ? 'approved' : 'pending';
+}
+
+//# sourceMappingURL=product-reviews.js.map

package/src/lib/model/product-reviews.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/product-reviews.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { HostOrder } from './commerce-orders'\nimport { orderEntitlesProduct } from './commerce-orders'\n\n/**\n * Storefront product reviews, verified buyers by default (AGL-3736).\n *\n * The industry standard (the Shopify review apps, Squarespace, Etsy): a review\n * carries \"Verified buyer\" only when the platform KNOWS the reviewer bought\n * the product — a signed-in customer whose orders hold it, or a one-time link\n * from the review-request email. A typed email proves nothing (anybody can\n * type anybody's address), so it no longer verifies anything.\n *\n * Pure: read by the storefront block, the console and the server.\n */\n\n/** Who may review a product on this store. */\nexport type ReviewPolicy = 'verified' | 'anyone'\n\n/** Every status a review document can hold. */\nexport type ReviewStatus = 'pending' | 'approved' | 'hidden' | 'rejected'\n\nexport const REVIEW_STATUSES: readonly ReviewStatus[] = [\n  'pending',\n  'approved',\n  'hidden',\n  'rejected',\n]\n\n/**\n * Why a merchant hid or rejected a review. Content reasons only: the FTC's\n * 2024 rule on fake reviews bars suppressing an honest review for being\n * negative, so \"I don't like it\" is not on the list.\n */\nexport const REVIEW_MODERATION_REASONS = [\n  'spam',\n  'abusive',\n  'off_topic',\n  'private_information',\n] as const\n\nexport type ReviewModerationReason = (typeof REVIEW_MODERATION_REASONS)[number]\n\nexport const REVIEW_MODERATION_REASON_LABELS: Readonly<\n  Record<ReviewModerationReason, string>\n> = {\n  spam: 'Spam or advertising',\n  abusive: 'Abusive or hateful',\n  off_topic: 'Not about the product',\n  private_information: 'Shares private information',\n}\n\nexport function isReviewModerationReason(value: unknown): value is ReviewModerationReason {\n  return (REVIEW_MODERATION_REASONS as readonly string[]).includes(String(value))\n}\n\n/** The review-request email's delay, in days after fulfilment. */\nexport const REVIEW_REQUEST_DELAY_DEFAULT_DAYS = 7\nexport const REVIEW_REQUEST_DELAY_MIN_DAYS = 3\nexport const REVIEW_REQUEST_DELAY_MAX_DAYS = 30\n\n/** How long a review link from the email works. */\nexport const REVIEW_TOKEN_TTL_MS = 60 * 24 * 60 * 60 * 1000\n\nconst DAY_MS = 24 * 60 * 60 * 1000\n\n/** A store's review settings, typed and bounded. */\nexport interface ReviewSettings {\n  policy: ReviewPolicy\n  /** Whether the review-request email goes out. On unless switched off. */\n  requestEmail: boolean\n  /** Days after fulfilment, 3–30. */\n  requestDelayDays: number\n}\n\n/**\n * Reads `hosts/{hostId}/settings/store.reviews`. Defensive in the safe\n * direction: anything but an explicit `'anyone'` is `verified`, so every\n * existing store (no map at all) is verified-only, and only an explicit\n * `false` turns the email off — the transaction-email convention (AGL-3600).\n */\nexport function reviewSettingsFrom(storeSettings: unknown): ReviewSettings {\n  const raw =\n    storeSettings && typeof storeSettings === 'object'\n      ? ((storeSettings as Record<string, unknown>)['reviews'] as\n          | Record<string, unknown>\n          | undefined)\n      : undefined\n  const days = Math.round(Number(raw?.['requestDelayDays']))\n  return {\n    policy: raw?.['policy'] === 'anyone' ? 'anyone' : 'verified',\n    requestEmail: raw?.['requestEmail'] !== false,\n    requestDelayDays: Number.isFinite(days)\n      ? Math.min(\n          REVIEW_REQUEST_DELAY_MAX_DAYS,\n          Math.max(REVIEW_REQUEST_DELAY_MIN_DAYS, days),\n        )\n      : REVIEW_REQUEST_DELAY_DEFAULT_DAYS,\n  }\n}\n\n/**\n * When an order fulfilled at `fulfilledAtMs` is owed its review request.\n * The scheduler stamps the EARLIEST possible moment (the 3-day minimum) and\n * the sweep re-reads the store's current delay, so a setting changed after\n * fulfilment still applies.\n */\nexport function reviewRequestDueAtMs(fulfilledAtMs: number, delayDays: number): number {\n  return fulfilledAtMs + delayDays * DAY_MS\n}\n\nexport function reviewRequestEarliestDueAtMs(fulfilledAtMs: number): number {\n  return reviewRequestDueAtMs(fulfilledAtMs, REVIEW_REQUEST_DELAY_MIN_DAYS)\n}\n\n/**\n * Whether an order's buyer is asked for a review at all. A register sale is\n * not (the address was given for a receipt at the counter), nor is an order\n * sold on an outside marketplace (its reviews belong there).\n */\nexport function orderTakesReviewRequest(\n  order: Pick<HostOrder, 'channel' | 'status'>,\n): boolean {\n  if (order.channel === 'pos' || order.channel === 'marketplace') return false\n  return !['pending', 'cancelled', 'refunded'].includes(String(order.status))\n}\n\n/**\n * The products a review request lists: each distinct product on the order\n * that the order still entitles — a line refunded by name is never asked\n * about, and neither is a fully refunded or cancelled order.\n */\nexport function reviewableProductIds(order: Partial<HostOrder>): string[] {\n  const ids: string[] = []\n  for (const line of order.lineItems ?? []) {\n    const productId = String(line?.productId ?? '')\n    if (!productId || ids.includes(productId)) continue\n    if (orderEntitlesProduct(order, productId)) ids.push(productId)\n  }\n  return ids\n}\n\n/** Error codes the reviews route answers with, for the storefront to word. */\nexport const REVIEW_ERROR_CODES = {\n  verifiedPurchaseRequired: 'verified_purchase_required',\n  tokenInvalid: 'review_token_invalid',\n  tokenUsed: 'review_token_used',\n  tokenExpired: 'review_token_expired',\n  rateLimited: 'review_rate_limited',\n  notEnabled: 'reviews_not_enabled',\n  memberSuspended: 'member_suspended',\n  alreadyReviewed: 'already_reviewed',\n} as const\n\nexport type ReviewErrorCode =\n  (typeof REVIEW_ERROR_CODES)[keyof typeof REVIEW_ERROR_CODES]\n\n/** What the storefront form is told before it draws itself. */\nexport interface ReviewEligibility {\n  /** The store's plan includes reviews. */\n  enabled?: boolean\n  policy: ReviewPolicy\n  /** A site member is signed in on this store. */\n  signedIn: boolean\n  /** The review would carry \"Verified buyer\", and through what. */\n  verifiedVia: 'member' | 'token' | null\n  /** The form may be submitted at all. */\n  canReview: boolean\n  /** The form must ask for a name and an email (an unverified visitor). */\n  needsEmail: boolean\n  /** Why a presented review link does not work, when it does not. */\n  tokenProblem?: ReviewErrorCode\n}\n\n/**\n * The eligibility answer from what the server established. Pure, so the\n * storefront's three states are specified in one place.\n */\nexport function reviewEligibility(input: {\n  policy: ReviewPolicy\n  signedIn: boolean\n  memberVerified: boolean\n  tokenVerified: boolean\n  tokenProblem?: ReviewErrorCode\n}): ReviewEligibility {\n  const verifiedVia = input.tokenVerified\n    ? 'token'\n    : input.memberVerified\n      ? 'member'\n      : null\n  const canReview = verifiedVia !== null || input.policy === 'anyone'\n  return {\n    policy: input.policy,\n    signedIn: input.signedIn,\n    verifiedVia,\n    canReview,\n    // A signed-in member is never asked for an email: the account has one.\n    needsEmail: canReview && verifiedVia === null && !input.signedIn,\n    ...(input.tokenProblem ? { tokenProblem: input.tokenProblem } : {}),\n  }\n}\n\n/** The status a new review is saved with. */\nexport function initialReviewStatus(verified: boolean): ReviewStatus {\n  // Verified reviews publish at once (the FTC's 2024 rule); unverified ones,\n  // possible only under 'anyone', wait for the merchant.\n  return verified ? 'approved' : 'pending'\n}\n"],"names":["orderEntitlesProduct","REVIEW_STATUSES","REVIEW_MODERATION_REASONS","REVIEW_MODERATION_REASON_LABELS","spam","abusive","off_topic","private_information","isReviewModerationReason","value","includes","String","REVIEW_REQUEST_DELAY_DEFAULT_DAYS","REVIEW_REQUEST_DELAY_MIN_DAYS","REVIEW_REQUEST_DELAY_MAX_DAYS","REVIEW_TOKEN_TTL_MS","DAY_MS","reviewSettingsFrom","storeSettings","raw","undefined","days","Math","round","Number","policy","requestEmail","requestDelayDays","isFinite","min","max","reviewRequestDueAtMs","fulfilledAtMs","delayDays","reviewRequestEarliestDueAtMs","orderTakesReviewRequest","order","channel","status","reviewableProductIds","ids","line","lineItems","productId","push","REVIEW_ERROR_CODES","verifiedPurchaseRequired","tokenInvalid","tokenUsed","tokenExpired","rateLimited","notEnabled","memberSuspended","alreadyReviewed","reviewEligibility","input","verifiedVia","tokenVerified","memberVerified","canReview","signedIn","needsEmail","tokenProblem","initialReviewStatus","verified"],"mappings":"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"}

package/src/lib/model/store-setup-content.d.ts

@@ -0,0 +1,145 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type ShippingTier } from './commerce-shipping';
+import type { PickupLocationSettings } from './order-local-fulfillment';
+/** The resource the writer is registered under; the commerce record route `store-settings` links it. */
+export declare const STORE_SETUP_RESOURCE = "store-settings";
+export declare const STORE_SETUP_SECTIONS: readonly ["shipping", "pickup", "local-delivery", "tax"];
+export type StoreSetupSection = (typeof STORE_SETUP_SECTIONS)[number];
+/** The rate kinds an AI change may set: every kind of the Shipping card except carrier rates. */
+export declare const STORE_SHIPPING_AI_KINDS: readonly ["flat", "free_over", "price_tiers", "weight_tiers"];
+export type StoreShippingAiKind = (typeof STORE_SHIPPING_AI_KINDS)[number];
+export declare const STORE_SHIPPING_ACTIONS: readonly ["set", "remove"];
+export declare const STORE_TAX_MODES: readonly ["manual", "stripe", "none"];
+export declare const STORE_SETUP_NAME_MAX = 80;
+export declare const STORE_SETUP_COUNTRIES_MAX = 60;
+export declare const STORE_SHIPPING_TIERS_MAX = 10;
+export declare const STORE_SETUP_LOCATION_MAX = 80;
+export declare const STORE_TAX_LABEL_MAX = 60;
+/** Grams; the heaviest tier a weight table may name (1,000 kg). */
+export declare const STORE_SHIPPING_MAX_GRAMS = 1000000;
+/** Two weeks, the longest preparation or lead time the cards keep. */
+export declare const STORE_SETUP_MAX_MINUTES: number;
+export interface StoreShippingChange {
+    section: 'shipping';
+    action: 'set' | 'remove';
+    zoneName: string;
+    countries?: string[];
+    rateName?: string;
+    kind?: StoreShippingAiKind;
+    amountCents?: number;
+    freeOverCents?: number;
+    tiers?: ShippingTier[];
+}
+export interface StorePickupChange {
+    section: 'pickup';
+    /** An inventory location's name, city or address; absent = the store-wide switch. */
+    location?: string;
+    enabled: boolean;
+    hours?: string;
+    instructions?: string;
+    readyWithinMinutes?: number;
+}
+export interface StoreLocalDeliveryChange {
+    section: 'local-delivery';
+    enabled: boolean;
+    country?: string;
+    location?: string;
+    zoneName?: string;
+    postcodes?: string[];
+    feeCents?: number;
+    minimumCents?: number;
+    freeOverCents?: number;
+    removeZone?: boolean;
+    windows?: string;
+    leadTimeMinutes?: number;
+    daysAhead?: number;
+    instructions?: string;
+}
+export interface StoreTaxChange {
+    section: 'tax';
+    mode?: 'manual' | 'stripe' | 'none';
+    pricesIncludeTax?: boolean;
+    originCountry?: string;
+    originState?: string;
+    rateCountry?: string;
+    rateState?: string;
+    ratePct?: number;
+    rateLabel?: string;
+    removeRate?: boolean;
+}
+export type StoreSetupChange = StoreShippingChange | StorePickupChange | StoreLocalDeliveryChange | StoreTaxChange;
+export type StoreSetupRead = {
+    ok: true;
+    value: StoreSetupChange;
+} | {
+    ok: false;
+    problems: string[];
+};
+type Raw = Readonly<Record<string, unknown>>;
+/** Reads a change from content; the problems name what is wrong, in words a person reads. */
+export declare function readStoreSetupChange(content: Raw): StoreSetupRead;
+/** An inventory location as the writer reads it. */
+export interface StoreSetupLocation {
+    id: string;
+    name?: string;
+    address?: string;
+    city?: string;
+    pickup?: unknown;
+}
+/** What the change writes: one map of the settings document, or one location's pickup. */
+export type StoreSetupWrite = {
+    target: 'settings';
+    field: 'shipping' | 'localDelivery' | 'tax';
+    value: Record<string, unknown>;
+} | {
+    target: 'location';
+    locationId: string;
+    value: PickupLocationSettings;
+};
+export type StoreSetupApplied = {
+    ok: true;
+    /** `null` when the settings already say what the change asks: nothing to write. */
+    write: StoreSetupWrite | null;
+    /** One sentence on what the store now does. */
+    summary: string;
+    /** What the person should know, in the console's words. */
+    warnings: string[];
+} | {
+    ok: false;
+    status: 400 | 404 | 409;
+    error: string;
+};
+export interface StoreSetupState {
+    /** `hosts/{hostId}/settings/store`, or `{}`. */
+    settings: Readonly<Record<string, unknown>>;
+    locations: readonly StoreSetupLocation[];
+}
+/** Ids for what a change creates, derived from the request so a retry makes the same ones. */
+export interface StoreSetupIds {
+    zoneId: string;
+    rateId: string;
+}
+/** Key-order-blind equality over plain JSON values. */
+export declare function sameSetting(a: unknown, b: unknown): boolean;
+/** The store's locations a phrase names: by exact name first, then by city or address. */
+export declare function matchStoreLocations(locations: readonly StoreSetupLocation[], phrase: string): StoreSetupLocation[];
+/** The settings after a change, what to write, and what the person is told. */
+export declare function applyStoreSetupChange(state: StoreSetupState, change: StoreSetupChange, ids: StoreSetupIds): StoreSetupApplied;
+/** What a reader is told about a store's setup, for the writer's `read`. */
+export declare function storeSetupFacts(settings: Readonly<Record<string, unknown>>): Record<string, unknown>;
+export {};