@withpotter/lib 0.13.0-next.101

package/dist/media-service.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/media-service.ts"],"sourcesContent":["import { BRAND_PRIMARY } from '@withpotter/lib/brand';\n\n/**\n * Media Service - Handles image uploads via Box API proxy.\n *\n * Uploads are sent to `/api/proxy/media/upload`, where the backend handles\n * storage + Cloudinary integration and usage metering.\n */\n\n// Cloudinary configuration\nexport const CLOUDINARY_CONFIG = {\n  cloudName: process.env.NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME || '',\n  uploadPreset: process.env.NEXT_PUBLIC_CLOUDINARY_UPLOAD_PRESET || '',\n};\n\nexport const isCloudinaryEnabled = Boolean(CLOUDINARY_CONFIG.cloudName);\n\n// Cloudinary transformation presets\nexport const CLOUDINARY_TRANSFORMS = {\n  thumbnail: 'w_200,h_200,c_fill,q_auto',\n  preview: 'w_400,h_400,c_limit,q_auto',\n  product: 'w_800,h_800,c_limit,q_auto',\n  hero: 'w_1920,h_1080,c_fill,q_auto',\n  full: 'q_auto',\n};\n\n/**\n * Build Cloudinary URL with transformations\n */\nexport function buildCloudinaryUrl(\n  publicId: string,\n  transform: keyof typeof CLOUDINARY_TRANSFORMS | string = 'preview',\n): string {\n  if (!CLOUDINARY_CONFIG.cloudName) return publicId;\n\n  const transformation =\n    CLOUDINARY_TRANSFORMS[transform as keyof typeof CLOUDINARY_TRANSFORMS] ||\n    transform;\n\n  return `https://res.cloudinary.com/${CLOUDINARY_CONFIG.cloudName}/image/upload/${transformation}/${publicId}`;\n}\n\n/**\n * Derive a favicon URL from a logo URL.\n *\n * If the logo is hosted on Cloudinary (`res.cloudinary.com/<cloud>/image/upload/...`),\n * we inject a square padded transform so any logo shape (wide wordmark, tall mark)\n * renders cleanly at 32×32 in a browser tab. If the URL is not Cloudinary we return\n * it as-is — browsers will still accept it and downscale.\n *\n * The transform replaces any existing transform segment immediately after `/upload/`,\n * so calling this on an already-derived favicon URL is idempotent.\n */\nexport function deriveFaviconUrl(\n  logoUrl: string | undefined | null,\n): string | undefined {\n  if (!logoUrl) return undefined;\n\n  // Match the Cloudinary upload URL shape and capture the transform segment (if any)\n  // followed by the asset path.\n  // e.g. https://res.cloudinary.com/<cloud>/image/upload/<transform>/v123/path.png\n  //  or  https://res.cloudinary.com/<cloud>/image/upload/v123/path.png (no transform)\n  const cloudinaryPattern =\n    /^(https?:\\/\\/res\\.cloudinary\\.com\\/[^/]+\\/image\\/upload\\/)([^/]+\\/)?(.+)$/;\n  const match = logoUrl.match(cloudinaryPattern);\n  if (!match) return logoUrl;\n\n  const [, prefix, maybeTransform, rest] = match;\n  // A version segment looks like `v123456`. If the captured segment is a version\n  // (not a transform), keep it as part of the asset path.\n  const transformSegment = maybeTransform ?? '';\n  const isVersion = /^v\\d+\\/$/.test(transformSegment);\n  const assetPath = isVersion ? `${transformSegment}${rest}` : rest;\n\n  const faviconTransform = 'w_180,h_180,c_pad,b_transparent,f_png,q_auto';\n  return `${prefix}${faviconTransform}/${assetPath}`;\n}\n\n/**\n * Compress and resize image to prevent browser crashes from large base64 strings\n * Used as fallback when Cloudinary is not configured\n */\nexport async function compressImage(\n  file: File,\n  maxWidth = 1200,\n  maxHeight = 1200,\n  quality = 0.8,\n): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const img = document.createElement('img');\n    const canvas = document.createElement('canvas');\n    const ctx = canvas.getContext('2d');\n\n    img.onload = () => {\n      URL.revokeObjectURL(img.src);\n\n      let { width, height } = img;\n\n      // Scale down if needed\n      if (width > maxWidth || height > maxHeight) {\n        const ratio = Math.min(maxWidth / width, maxHeight / height);\n        width = Math.round(width * ratio);\n        height = Math.round(height * ratio);\n      }\n\n      canvas.width = width;\n      canvas.height = height;\n\n      if (!ctx) {\n        reject(new Error('Could not get canvas context'));\n        return;\n      }\n\n      // Draw image on canvas\n      ctx.drawImage(img, 0, 0, width, height);\n\n      // Convert to compressed JPEG or keep PNG for transparency\n      const mimeType = file.type === 'image/png' ? 'image/png' : 'image/jpeg';\n      const dataUrl = canvas.toDataURL(mimeType, quality);\n\n      resolve(dataUrl);\n    };\n\n    img.onerror = () => {\n      URL.revokeObjectURL(img.src);\n      reject(new Error('Failed to load image'));\n    };\n\n    img.src = URL.createObjectURL(file);\n  });\n}\n\n/**\n * Upload image result type\n */\nexport interface UploadResult {\n  url: string;\n  publicId?: string; // Cloudinary public ID for transformations\n  width?: number;\n  height?: number;\n  resourceType?: 'image' | 'video';\n  duration?: number;\n  thumbnail?: string;\n  format?: string;\n  isCloudinary: boolean;\n}\n\nfunction getStoredTenantSlug(): string {\n  if (typeof window === 'undefined') {\n    return '';\n  }\n\n  const directKeys = ['pb_current_tenant', 'currentWorkspace'];\n  for (const key of directKeys) {\n    const value = localStorage.getItem(key)?.trim();\n    if (value) {\n      return value;\n    }\n  }\n\n  const tenantJson = localStorage.getItem('tenant');\n  if (tenantJson) {\n    try {\n      const tenant = JSON.parse(tenantJson) as { slug?: string };\n      if (tenant.slug?.trim()) {\n        return tenant.slug.trim();\n      }\n    } catch {\n      // Ignore malformed persisted tenant state and keep falling back.\n    }\n  }\n\n  return '';\n}\n\n/**\n * Upload image via Box API proxy.\n */\nexport async function uploadImage(file: File): Promise<UploadResult> {\n  return uploadViaApi(file);\n}\n\n/**\n * Upload via Box API proxy with progress tracking\n */\nfunction uploadViaApi(\n  file: File,\n  onProgress?: (progress: number) => void,\n): Promise<UploadResult> {\n  return new Promise((resolve, reject) => {\n    const formData = new FormData();\n    formData.append('file', file);\n\n    const tenantSlug = getStoredTenantSlug();\n\n    const xhr = new XMLHttpRequest();\n\n    xhr.upload.addEventListener('progress', (event) => {\n      if (event.lengthComputable && onProgress) {\n        const progress = Math.round((event.loaded / event.total) * 100);\n        onProgress(progress);\n      }\n    });\n\n    xhr.addEventListener('load', () => {\n      if (xhr.status >= 200 && xhr.status < 300) {\n        try {\n          const data = JSON.parse(xhr.responseText);\n          resolve({\n            url: data.url,\n            publicId: data.publicId,\n            width: data.width,\n            height: data.height,\n            resourceType: data.resourceType,\n            duration: data.duration,\n            thumbnail: data.thumbnail,\n            isCloudinary: true,\n          });\n        } catch {\n          reject(new Error('Failed to parse upload response'));\n        }\n      } else {\n        let message = `Upload failed: ${xhr.status}`;\n        try {\n          const err = JSON.parse(xhr.responseText);\n          if (err?.message) message = err.message;\n        } catch {\n          // Keep the status-based message when the response is not JSON.\n        }\n        reject(new UploadHttpError(xhr.status, message));\n      }\n    });\n\n    xhr.addEventListener('error', () => {\n      reject(new UploadHttpError(0, 'Upload failed - network error'));\n    });\n\n    xhr.open('POST', '/api/proxy/media/upload');\n    if (tenantSlug) {\n      xhr.setRequestHeader('x-tenant-slug', tenantSlug);\n    }\n    xhr.send(formData);\n  });\n}\n\n/**\n * Upload image with progress tracking\n */\nexport async function uploadImageWithProgress(\n  file: File,\n  onProgress?: (progress: number) => void,\n): Promise<UploadResult> {\n  return uploadViaApi(file, onProgress);\n}\n\nexport class UploadHttpError extends Error {\n  constructor(public readonly status: number, message: string) {\n    super(message);\n    this.name = 'UploadHttpError';\n  }\n}\n\n/** Say what went wrong: only a dropped connection is the merchant's to fix. */\nexport function voiceUploadProblem(error: unknown): string {\n  if (error instanceof UploadHttpError) {\n    if (error.status === 0) return 'Check your connection and try again.';\n    if (error.status === 413) return 'The recording is too long. Try a shorter one.';\n    if (error.status === 401 || error.status === 403)\n      return 'Your session ended. Sign in again and retry.';\n    return `The upload was refused (${error.status}). Try again, or type your message instead.`;\n  }\n  return 'Check your connection and try again.';\n}\n\nexport async function uploadImageWithAutoCompress(\n  file: File,\n  onProgress?: (progress: number) => void,\n): Promise<UploadResult> {\n  if (!file.type.startsWith('image/')) {\n    return uploadViaApi(file, onProgress);\n  }\n\n  const steps: Array<[number, number]> = [\n    [1600, 0.85],\n    [1280, 0.78],\n    [1024, 0.72],\n    [800, 0.65],\n  ];\n  const skipFirstCompress = file.size <= 500_000;\n  let lastError: unknown;\n\n  for (let index = 0; index < steps.length; index += 1) {\n    let candidate = file;\n    if (!(skipFirstCompress && index === 0)) {\n      try {\n        const [maxDimension, quality] = steps[index];\n        const dataUrl = await compressImage(\n          file,\n          maxDimension,\n          maxDimension,\n          quality,\n        );\n        const blob = await (await fetch(dataUrl)).blob();\n        candidate = new File([blob], file.name, { type: 'image/jpeg' });\n      } catch {\n        candidate = file;\n      }\n    }\n\n    try {\n      return await uploadViaApi(candidate, onProgress);\n    } catch (error) {\n      lastError = error;\n      if (error instanceof UploadHttpError && error.status === 413) continue;\n      throw error;\n    }\n  }\n\n  if (lastError instanceof UploadHttpError && lastError.status === 413) {\n    throw new UploadHttpError(\n      413,\n      'Image is too large to upload, even after compressing. Try a smaller photo or one with lower resolution.',\n    );\n  }\n  throw lastError ?? new Error('Upload failed');\n}\n\n/**\n * Send a recorded voice note to the same media endpoint images use.\n *\n * A Blob is not a File, and the proxy reads a filename off the multipart part\n * to infer an extension, so the container has to be named rather than left to\n * whatever `blob` defaults to. The mimetype is the recorder's own — it varies\n * by browser (webm/opus on Chrome, mp4 on Safari) and the API matches on the\n * base type with parameters stripped.\n */\nexport async function uploadAudio(\n  blob: Blob,\n  mimeType: string,\n): Promise<UploadResult> {\n  const ext = mimeType.includes('mp4')\n    ? 'm4a'\n    : mimeType.includes('ogg')\n      ? 'ogg'\n      : 'webm';\n  // Parameters (\"audio/webm;codecs=opus\") are the recorder's detail; servers\n  // that allow-list by exact type reject them, so send the base type only.\n  const baseType = mimeType.split(';')[0].trim() || 'audio/webm';\n  const file = new File([blob], `voice-note.${ext}`, { type: baseType });\n  return uploadViaApi(file);\n}\n\n/**\n * Open Cloudinary Upload Widget\n * Requires the Cloudinary widget script to be loaded\n */\nexport interface CloudinaryWidgetOptions {\n  onSuccess: (result: UploadResult) => void;\n  onError?: (error: Error) => void;\n  maxFiles?: number;\n  resourceType?: 'image' | 'video' | 'auto';\n  cropping?: boolean;\n  croppingAspectRatio?: number;\n  showAdvancedOptions?: boolean;\n  sources?: ('local' | 'url' | 'camera')[];\n}\n\nexport function openCloudinaryWidget(options: CloudinaryWidgetOptions): void {\n  // Check if Cloudinary widget is available\n\n  const cloudinary = (\n    window as unknown as {\n      cloudinary?: {\n        createUploadWidget: (...args: any[]) => {\n          open: () => void;\n          close: () => void;\n        };\n      };\n    }\n  ).cloudinary;\n\n  if (!cloudinary || !isCloudinaryEnabled) {\n    options.onError?.(new Error('Cloudinary widget not available'));\n    return;\n  }\n\n  const widget = cloudinary.createUploadWidget(\n    {\n      cloudName: CLOUDINARY_CONFIG.cloudName,\n      uploadPreset: CLOUDINARY_CONFIG.uploadPreset,\n      sources: options.sources || ['local', 'url', 'camera'],\n      multiple: (options.maxFiles || 1) > 1,\n      maxFiles: options.maxFiles || 1,\n      resourceType: options.resourceType || 'image',\n      cropping: options.cropping ?? true,\n      croppingAspectRatio: options.croppingAspectRatio,\n      showAdvancedOptions: options.showAdvancedOptions ?? false,\n      styles: {\n        palette: {\n          window: '#FFFFFF',\n          windowBorder: '#90A0B3',\n          tabIcon: BRAND_PRIMARY,\n          menuIcons: '#5A616A',\n          textDark: '#000000',\n          textLight: '#FFFFFF',\n          link: BRAND_PRIMARY,\n          action: BRAND_PRIMARY,\n          inactiveTabIcon: '#0E2F5A',\n          error: '#F44235',\n          inProgress: BRAND_PRIMARY,\n          complete: '#20B832',\n          sourceBg: '#F4F5F5',\n        },\n      },\n    },\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (error: Error | null, result: any) => {\n      if (error) {\n        options.onError?.(error);\n        return;\n      }\n\n      if (result.event === 'success') {\n        options.onSuccess({\n          url: result.info.secure_url,\n          publicId: result.info.public_id,\n          width: result.info.width,\n          height: result.info.height,\n          format: result.info.format,\n          isCloudinary: true,\n        });\n        widget.close();\n      }\n    },\n  );\n\n  widget.open();\n}\n\n/**\n * Script tag for Cloudinary widget - add to page if using widget\n */\nexport const CLOUDINARY_WIDGET_SCRIPT =\n  'https://widget.cloudinary.com/v2.0/global/all.js';\n"],"mappings":"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","names":[]}

package/dist/media-utils.d.ts

@@ -0,0 +1,51 @@
+import type { ProductMedia } from './product-types';
+export interface ProductGalleryItem extends ProductMedia {
+    id: string;
+}
+export declare const MAX_GALLERY_ITEMS = 20;
+export declare function normalizeMediaItem(input: unknown): ProductMedia | null;
+/**
+ * Strip a payload of keys the media DTO will refuse.
+ *
+ * Reported from staging: creating an event failed with
+ * `image.id: property id should not exist`. `ProductGalleryItem` extends
+ * `ProductMedia` with an `id` so a local list can key its rows, and that id
+ * rides along when the cover is sent as `image`. The same trap is set for
+ * `publicId` and `isCloudinary`, which the gallery field also carries.
+ *
+ * Fixed at the boundary rather than at each field, because the failure is not
+ * one field's bug — it is the shape of the whole class: anything that hands a
+ * client-side media object straight to the API is one extra property away from
+ * a rejected request, and the rejection names a key nobody deliberately sent.
+ *
+ * Only objects that look like media are touched — a string `url` is the tell —
+ * so content's own free-form fields keep any ids they legitimately carry.
+ */
+export declare function stripNonMediaKeys<T>(value: T): T;
+export declare function normalizeMediaList(input: unknown): ProductMedia[];
+export declare function createGalleryItemId(url: string): string;
+export declare function toGalleryItems(media: ProductMedia[]): ProductGalleryItem[];
+export declare function stripGalleryItemIds(items: ProductGalleryItem[]): ProductMedia[];
+/**
+ * ONE LIST OF MEDIA, WHOSE FIRST IMAGE IS THE COVER.
+ *
+ * `image` and `gallery` are stored as separate fields and were edited as two
+ * separate controls — a hero dropzone above a gallery strip — with a "Hero"
+ * button on each gallery tile that *copied* the tile into the hero rather than
+ * moving it. Upload a picture as the hero and again into the gallery and you
+ * had it twice, with nothing on screen saying they were the same field's two
+ * halves. The merchant's question is "which picture do people see first", and
+ * two controls cannot answer it.
+ *
+ * So the editor works one list, and the storage stays exactly as it was: these
+ * two functions are the seam. `mergeCover` is the read — cover first, then the
+ * rest, deduped by url because an older product may well have its hero sitting
+ * in the gallery too. `coverOf`/`galleryWithoutCover` are the write.
+ *
+ * The cover is the first *image*, not simply the first item: a video cannot be
+ * a cover (nothing renders a poster frame for it), and a list that opens with
+ * one must still have a cover rather than silently losing it.
+ */
+export declare function mergeCover(cover: ProductMedia | null, gallery: ProductMedia[]): ProductMedia[];
+export declare function coverOf(items: ProductMedia[]): ProductMedia | null;
+export declare function galleryWithoutCover(items: ProductGalleryItem[]): ProductGalleryItem[];

package/dist/media-utils.js

@@ -0,0 +1,85 @@
+const MAX_GALLERY_ITEMS = 20;
+function normalizeMediaItem(input) {
+  if (!input) return null;
+  if (typeof input === "string") {
+    return { url: input, type: "image" };
+  }
+  if (typeof input !== "object") return null;
+  const item = input;
+  if (typeof item.url !== "string" || item.url.trim().length === 0) return null;
+  return {
+    url: item.url,
+    type: item.type === "video" ? "video" : "image",
+    alt: typeof item.alt === "string" ? item.alt : void 0,
+    width: typeof item.width === "number" ? item.width : void 0,
+    height: typeof item.height === "number" ? item.height : void 0,
+    thumbnail: typeof item.thumbnail === "string" ? item.thumbnail : void 0,
+    duration: typeof item.duration === "number" ? item.duration : void 0
+  };
+}
+const MEDIA_KEYS = [
+  "url",
+  "type",
+  "alt",
+  "width",
+  "height",
+  "thumbnail",
+  "duration"
+];
+function stripNonMediaKeys(value) {
+  if (Array.isArray(value)) {
+    return value.map((v) => stripNonMediaKeys(v));
+  }
+  if (!value || typeof value !== "object") return value;
+  const record = value;
+  const isMedia = typeof record.url === "string";
+  const out = {};
+  for (const [key, v] of Object.entries(record)) {
+    if (isMedia && !MEDIA_KEYS.includes(key)) continue;
+    out[key] = stripNonMediaKeys(v);
+  }
+  return out;
+}
+function normalizeMediaList(input) {
+  if (!Array.isArray(input)) return [];
+  return input.map((item) => normalizeMediaItem(item)).filter((item) => item !== null);
+}
+function createGalleryItemId(url) {
+  return `${url}-${Math.random().toString(36).slice(2, 10)}`;
+}
+function toGalleryItems(media) {
+  return media.map((item) => ({
+    ...item,
+    id: createGalleryItemId(item.url)
+  }));
+}
+function stripGalleryItemIds(items) {
+  return items.map(({ id, ...rest }) => rest);
+}
+function mergeCover(cover, gallery) {
+  if (!cover) return gallery;
+  const rest = gallery.filter((item) => item.url !== cover.url);
+  return [cover, ...rest];
+}
+function coverOf(items) {
+  return items.find((item) => item.type !== "video") ?? null;
+}
+function galleryWithoutCover(items) {
+  const cover = coverOf(items);
+  if (!cover) return items;
+  const index = items.findIndex((item) => item.url === cover.url);
+  return index < 0 ? items : items.filter((_, i) => i !== index);
+}
+export {
+  MAX_GALLERY_ITEMS,
+  coverOf,
+  createGalleryItemId,
+  galleryWithoutCover,
+  mergeCover,
+  normalizeMediaItem,
+  normalizeMediaList,
+  stripGalleryItemIds,
+  stripNonMediaKeys,
+  toGalleryItems
+};
+//# sourceMappingURL=media-utils.js.map

package/dist/media-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/media-utils.ts"],"sourcesContent":["import type { ProductMedia } from './product-types';\n\n// ============================================================================\n// TYPES\n// ============================================================================\n\nexport interface ProductGalleryItem extends ProductMedia {\n  id: string;\n}\n\nexport const MAX_GALLERY_ITEMS = 20;\n\n// ============================================================================\n// NORMALIZATION\n// ============================================================================\n\nexport function normalizeMediaItem(input: unknown): ProductMedia | null {\n  if (!input) return null;\n  if (typeof input === 'string') {\n    return { url: input, type: 'image' };\n  }\n\n  if (typeof input !== 'object') return null;\n  const item = input as Record<string, unknown>;\n  if (typeof item.url !== 'string' || item.url.trim().length === 0) return null;\n\n  return {\n    url: item.url,\n    type: item.type === 'video' ? 'video' : 'image',\n    alt: typeof item.alt === 'string' ? item.alt : undefined,\n    width: typeof item.width === 'number' ? item.width : undefined,\n    height: typeof item.height === 'number' ? item.height : undefined,\n    thumbnail: typeof item.thumbnail === 'string' ? item.thumbnail : undefined,\n    duration: typeof item.duration === 'number' ? item.duration : undefined,\n  };\n}\n\n/**\n * The only keys the API's media DTO accepts.\n *\n * `ContentMediaDto` declares url, type, alt, width, height, thumbnail and\n * duration — and the API runs `forbidNonWhitelisted: true`, so ANY other key\n * rejects the whole request rather than being ignored.\n */\nconst MEDIA_KEYS = [\n  'url',\n  'type',\n  'alt',\n  'width',\n  'height',\n  'thumbnail',\n  'duration',\n] as const;\n\n/**\n * Strip a payload of keys the media DTO will refuse.\n *\n * Reported from staging: creating an event failed with\n * `image.id: property id should not exist`. `ProductGalleryItem` extends\n * `ProductMedia` with an `id` so a local list can key its rows, and that id\n * rides along when the cover is sent as `image`. The same trap is set for\n * `publicId` and `isCloudinary`, which the gallery field also carries.\n *\n * Fixed at the boundary rather than at each field, because the failure is not\n * one field's bug — it is the shape of the whole class: anything that hands a\n * client-side media object straight to the API is one extra property away from\n * a rejected request, and the rejection names a key nobody deliberately sent.\n *\n * Only objects that look like media are touched — a string `url` is the tell —\n * so content's own free-form fields keep any ids they legitimately carry.\n */\nexport function stripNonMediaKeys<T>(value: T): T {\n  if (Array.isArray(value)) {\n    return value.map((v) => stripNonMediaKeys(v)) as unknown as T;\n  }\n  if (!value || typeof value !== 'object') return value;\n\n  const record = value as Record<string, unknown>;\n  const isMedia = typeof record.url === 'string';\n\n  const out: Record<string, unknown> = {};\n  for (const [key, v] of Object.entries(record)) {\n    if (isMedia && !(MEDIA_KEYS as readonly string[]).includes(key)) continue;\n    out[key] = stripNonMediaKeys(v);\n  }\n  return out as T;\n}\n\nexport function normalizeMediaList(input: unknown): ProductMedia[] {\n  if (!Array.isArray(input)) return [];\n  return input\n    .map((item) => normalizeMediaItem(item))\n    .filter((item): item is ProductMedia => item !== null);\n}\n\n// ============================================================================\n// GALLERY ITEM HELPERS\n// ============================================================================\n\nexport function createGalleryItemId(url: string): string {\n  return `${url}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport function toGalleryItems(media: ProductMedia[]): ProductGalleryItem[] {\n  return media.map((item) => ({\n    ...item,\n    id: createGalleryItemId(item.url),\n  }));\n}\n\nexport function stripGalleryItemIds(\n  items: ProductGalleryItem[],\n): ProductMedia[] {\n  return items.map(({ id, ...rest }) => rest);\n}\n\n// ============================================================================\n// COVER\n// ============================================================================\n\n/**\n * ONE LIST OF MEDIA, WHOSE FIRST IMAGE IS THE COVER.\n *\n * `image` and `gallery` are stored as separate fields and were edited as two\n * separate controls — a hero dropzone above a gallery strip — with a \"Hero\"\n * button on each gallery tile that *copied* the tile into the hero rather than\n * moving it. Upload a picture as the hero and again into the gallery and you\n * had it twice, with nothing on screen saying they were the same field's two\n * halves. The merchant's question is \"which picture do people see first\", and\n * two controls cannot answer it.\n *\n * So the editor works one list, and the storage stays exactly as it was: these\n * two functions are the seam. `mergeCover` is the read — cover first, then the\n * rest, deduped by url because an older product may well have its hero sitting\n * in the gallery too. `coverOf`/`galleryWithoutCover` are the write.\n *\n * The cover is the first *image*, not simply the first item: a video cannot be\n * a cover (nothing renders a poster frame for it), and a list that opens with\n * one must still have a cover rather than silently losing it.\n */\nexport function mergeCover(\n  cover: ProductMedia | null,\n  gallery: ProductMedia[],\n): ProductMedia[] {\n  if (!cover) return gallery;\n  const rest = gallery.filter((item) => item.url !== cover.url);\n  return [cover, ...rest];\n}\n\nexport function coverOf(items: ProductMedia[]): ProductMedia | null {\n  return items.find((item) => item.type !== 'video') ?? null;\n}\n\nexport function galleryWithoutCover(\n  items: ProductGalleryItem[],\n): ProductGalleryItem[] {\n  const cover = coverOf(items);\n  if (!cover) return items;\n  // By identity of url — the cover is one of these objects, not a copy.\n  const index = items.findIndex((item) => item.url === cover.url);\n  return index < 0 ? items : items.filter((_, i) => i !== index);\n}\n"],"mappings":"AAUO,MAAM,oBAAoB;AAM1B,SAAS,mBAAmB,OAAqC;AACtE,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,EAAE,KAAK,OAAO,MAAM,QAAQ;AAAA,EACrC;AAEA,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,OAAO;AACb,MAAI,OAAO,KAAK,QAAQ,YAAY,KAAK,IAAI,KAAK,EAAE,WAAW,EAAG,QAAO;AAEzE,SAAO;AAAA,IACL,KAAK,KAAK;AAAA,IACV,MAAM,KAAK,SAAS,UAAU,UAAU;AAAA,IACxC,KAAK,OAAO,KAAK,QAAQ,WAAW,KAAK,MAAM;AAAA,IAC/C,OAAO,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ;AAAA,IACrD,QAAQ,OAAO,KAAK,WAAW,WAAW,KAAK,SAAS;AAAA,IACxD,WAAW,OAAO,KAAK,cAAc,WAAW,KAAK,YAAY;AAAA,IACjE,UAAU,OAAO,KAAK,aAAa,WAAW,KAAK,WAAW;AAAA,EAChE;AACF;AASA,MAAM,aAAa;AAAA,EACjB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAmBO,SAAS,kBAAqB,OAAa;AAChD,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,IAAI,CAAC,MAAM,kBAAkB,CAAC,CAAC;AAAA,EAC9C;AACA,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAEhD,QAAM,SAAS;AACf,QAAM,UAAU,OAAO,OAAO,QAAQ;AAEtC,QAAM,MAA+B,CAAC;AACtC,aAAW,CAAC,KAAK,CAAC,KAAK,OAAO,QAAQ,MAAM,GAAG;AAC7C,QAAI,WAAW,CAAE,WAAiC,SAAS,GAAG,EAAG;AACjE,QAAI,GAAG,IAAI,kBAAkB,CAAC;AAAA,EAChC;AACA,SAAO;AACT;AAEO,SAAS,mBAAmB,OAAgC;AACjE,MAAI,CAAC,MAAM,QAAQ,KAAK,EAAG,QAAO,CAAC;AACnC,SAAO,MACJ,IAAI,CAAC,SAAS,mBAAmB,IAAI,CAAC,EACtC,OAAO,CAAC,SAA+B,SAAS,IAAI;AACzD;AAMO,SAAS,oBAAoB,KAAqB;AACvD,SAAO,GAAG,GAAG,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,EAAE,CAAC;AAC1D;AAEO,SAAS,eAAe,OAA6C;AAC1E,SAAO,MAAM,IAAI,CAAC,UAAU;AAAA,IAC1B,GAAG;AAAA,IACH,IAAI,oBAAoB,KAAK,GAAG;AAAA,EAClC,EAAE;AACJ;AAEO,SAAS,oBACd,OACgB;AAChB,SAAO,MAAM,IAAI,CAAC,EAAE,IAAI,GAAG,KAAK,MAAM,IAAI;AAC5C;AA0BO,SAAS,WACd,OACA,SACgB;AAChB,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,OAAO,QAAQ,OAAO,CAAC,SAAS,KAAK,QAAQ,MAAM,GAAG;AAC5D,SAAO,CAAC,OAAO,GAAG,IAAI;AACxB;AAEO,SAAS,QAAQ,OAA4C;AAClE,SAAO,MAAM,KAAK,CAAC,SAAS,KAAK,SAAS,OAAO,KAAK;AACxD;AAEO,SAAS,oBACd,OACsB;AACtB,QAAM,QAAQ,QAAQ,KAAK;AAC3B,MAAI,CAAC,MAAO,QAAO;AAEnB,QAAM,QAAQ,MAAM,UAAU,CAAC,SAAS,KAAK,QAAQ,MAAM,GAAG;AAC9D,SAAO,QAAQ,IAAI,QAAQ,MAAM,OAAO,CAAC,GAAG,MAAM,MAAM,KAAK;AAC/D;","names":[]}

package/dist/member-presence.d.ts

@@ -0,0 +1,40 @@
+/**
+ * What state a person on the team is actually in.
+ *
+ * The team page listed members and their roles, which answers "who has keys"
+ * and not "who is here" — and those are different questions. The second is the
+ * one a manager asks continuously, and could otherwise only answer by texting
+ * somebody.
+ *
+ * The state that matters most is the one nothing surfaced at all: an invite
+ * sent on Monday that nobody opened is, on Friday, indistinguishable from one
+ * sent an hour ago. That is the failure most worth noticing, and an owner
+ * currently discovers it by asking the person they hired why they never
+ * started.
+ *
+ * Pure, so the thresholds can be tested rather than eyeballed against a
+ * clock — and so `people-card.tsx`, already over the 500-line house limit,
+ * does not grow a second job.
+ */
+export type MemberPresence = 'unknown' | 'here' | 'today' | 'away' | 'never' | 'invited' | 'invite-expiring' | 'invite-expired' | 'removed';
+export interface PresenceReading {
+    state: MemberPresence;
+    /** One short phrase for the row. Empty when there is nothing worth saying. */
+    label: string;
+    /** True when this row is asking the manager to do something. */
+    needsAttention: boolean;
+}
+/** Within this, someone counts as being at the counter right now. */
+export declare const HERE_WINDOW_MS: number;
+/** An invite this close to lapsing is worth flagging before it does. */
+export declare const EXPIRING_WINDOW_MS: number;
+interface MemberLike {
+    status?: string | null;
+    lastActiveAt?: string | null;
+    inviteExpiresAt?: string | null;
+    joinedAt?: string | null;
+}
+export declare function readPresence(member: MemberLike, now?: number): PresenceReading;
+/** How many rows are asking for something, for the card's subtitle. */
+export declare function countNeedingAttention(members: MemberLike[], now?: number): number;
+export {};

package/dist/member-presence.js

@@ -0,0 +1,77 @@
+const HERE_WINDOW_MS = 5 * 60 * 1e3;
+const EXPIRING_WINDOW_MS = 48 * 60 * 60 * 1e3;
+const parse = (value) => {
+  if (!value) return null;
+  const t = new Date(value).getTime();
+  return Number.isNaN(t) ? null : t;
+};
+function days(ms) {
+  return Math.floor(ms / (24 * 60 * 60 * 1e3));
+}
+function readPresence(member, now = Date.now()) {
+  if (member.status === "removed") {
+    return { state: "removed", label: "removed", needsAttention: false };
+  }
+  if (member.status === "invited") {
+    const expires = parse(member.inviteExpiresAt);
+    if (expires === null) {
+      return { state: "invited", label: "invite sent", needsAttention: false };
+    }
+    if (expires <= now) {
+      return {
+        state: "invite-expired",
+        label: "invite expired",
+        needsAttention: true
+      };
+    }
+    if (expires - now <= EXPIRING_WINDOW_MS) {
+      const hours = Math.max(1, Math.round((expires - now) / (60 * 60 * 1e3)));
+      return {
+        state: "invite-expiring",
+        label: `invite expires in ${hours}h`,
+        needsAttention: true
+      };
+    }
+    const left = days(expires - now);
+    return {
+      state: "invited",
+      label: left <= 1 ? "invite expires tomorrow" : `invite expires in ${left}d`,
+      needsAttention: false
+    };
+  }
+  if (member.lastActiveAt === void 0) {
+    return { state: "unknown", label: "", needsAttention: false };
+  }
+  const last = parse(member.lastActiveAt);
+  if (last === null) {
+    return {
+      state: "never",
+      label: "not signed in yet",
+      needsAttention: false
+    };
+  }
+  const ago = now - last;
+  if (ago <= HERE_WINDOW_MS) {
+    return { state: "here", label: "here now", needsAttention: false };
+  }
+  const d = days(ago);
+  if (d === 0) {
+    const hours = Math.max(1, Math.round(ago / (60 * 60 * 1e3)));
+    return { state: "today", label: `${hours}h ago`, needsAttention: false };
+  }
+  return {
+    state: "away",
+    label: d === 1 ? "yesterday" : `${d} days ago`,
+    needsAttention: false
+  };
+}
+function countNeedingAttention(members, now = Date.now()) {
+  return members.filter((m) => readPresence(m, now).needsAttention).length;
+}
+export {
+  EXPIRING_WINDOW_MS,
+  HERE_WINDOW_MS,
+  countNeedingAttention,
+  readPresence
+};
+//# sourceMappingURL=member-presence.js.map

package/dist/member-presence.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/member-presence.ts"],"sourcesContent":["/**\n * What state a person on the team is actually in.\n *\n * The team page listed members and their roles, which answers \"who has keys\"\n * and not \"who is here\" — and those are different questions. The second is the\n * one a manager asks continuously, and could otherwise only answer by texting\n * somebody.\n *\n * The state that matters most is the one nothing surfaced at all: an invite\n * sent on Monday that nobody opened is, on Friday, indistinguishable from one\n * sent an hour ago. That is the failure most worth noticing, and an owner\n * currently discovers it by asking the person they hired why they never\n * started.\n *\n * Pure, so the thresholds can be tested rather than eyeballed against a\n * clock — and so `people-card.tsx`, already over the 500-line house limit,\n * does not grow a second job.\n */\n\nexport type MemberPresence =\n  | 'unknown' // the api did not say — not the same as \"never\"\n  | 'here' // active within the last few minutes\n  | 'today' // active earlier today\n  | 'away' // active, but not recently\n  | 'never' // accepted and never came back\n  | 'invited' // waiting, with time left\n  | 'invite-expiring' // waiting, about to lapse\n  | 'invite-expired' // lapsed unused — the silent failure\n  | 'removed';\n\nexport interface PresenceReading {\n  state: MemberPresence;\n  /** One short phrase for the row. Empty when there is nothing worth saying. */\n  label: string;\n  /** True when this row is asking the manager to do something. */\n  needsAttention: boolean;\n}\n\n/** Within this, someone counts as being at the counter right now. */\nexport const HERE_WINDOW_MS = 5 * 60 * 1000;\n/** An invite this close to lapsing is worth flagging before it does. */\nexport const EXPIRING_WINDOW_MS = 48 * 60 * 60 * 1000;\n\ninterface MemberLike {\n  status?: string | null;\n  lastActiveAt?: string | null;\n  inviteExpiresAt?: string | null;\n  joinedAt?: string | null;\n}\n\nconst parse = (value: string | null | undefined): number | null => {\n  if (!value) return null;\n  const t = new Date(value).getTime();\n  return Number.isNaN(t) ? null : t;\n};\n\nfunction days(ms: number): number {\n  return Math.floor(ms / (24 * 60 * 60 * 1000));\n}\n\nexport function readPresence(\n  member: MemberLike,\n  now: number = Date.now(),\n): PresenceReading {\n  if (member.status === 'removed') {\n    return { state: 'removed', label: 'removed', needsAttention: false };\n  }\n\n  if (member.status === 'invited') {\n    const expires = parse(member.inviteExpiresAt);\n    // An invite with no recorded expiry is treated as simply waiting rather\n    // than as expired. Guessing \"expired\" would tell a manager to chase\n    // something that may be perfectly fine.\n    if (expires === null) {\n      return { state: 'invited', label: 'invite sent', needsAttention: false };\n    }\n    if (expires <= now) {\n      return {\n        state: 'invite-expired',\n        label: 'invite expired',\n        needsAttention: true,\n      };\n    }\n    if (expires - now <= EXPIRING_WINDOW_MS) {\n      const hours = Math.max(1, Math.round((expires - now) / (60 * 60 * 1000)));\n      return {\n        state: 'invite-expiring',\n        label: `invite expires in ${hours}h`,\n        needsAttention: true,\n      };\n    }\n    const left = days(expires - now);\n    return {\n      state: 'invited',\n      label:\n        left <= 1 ? 'invite expires tomorrow' : `invite expires in ${left}d`,\n      needsAttention: false,\n    };\n  }\n\n  // ABSENT is not the same as NULL, and conflating them shipped a lie.\n  //\n  // `lastActiveAt` was added to the api response in api#414, which has not\n  // deployed. Until it does the field is simply missing — and treating missing\n  // as \"never active\" put \"not signed in yet\" beside the owner's name while\n  // they were signed in, reading the page. A roster that is confidently wrong\n  // about the person reading it is worse than one that says nothing.\n  //\n  //   undefined  the api did not tell us       -> say nothing\n  //   null       the api says: never active    -> \"not signed in yet\"\n  if (member.lastActiveAt === undefined) {\n    return { state: 'unknown', label: '', needsAttention: false };\n  }\n\n  const last = parse(member.lastActiveAt);\n  if (last === null) {\n    // Accepted, then never opened it again. Worth seeing, not worth alarming\n    // about — plenty of people are invited and simply have not started.\n    return {\n      state: 'never',\n      label: 'not signed in yet',\n      needsAttention: false,\n    };\n  }\n\n  const ago = now - last;\n  // A clock that has gone backwards must not read as \"active in the future\".\n  if (ago <= HERE_WINDOW_MS) {\n    return { state: 'here', label: 'here now', needsAttention: false };\n  }\n\n  const d = days(ago);\n  if (d === 0) {\n    const hours = Math.max(1, Math.round(ago / (60 * 60 * 1000)));\n    return { state: 'today', label: `${hours}h ago`, needsAttention: false };\n  }\n  return {\n    state: 'away',\n    label: d === 1 ? 'yesterday' : `${d} days ago`,\n    needsAttention: false,\n  };\n}\n\n/** How many rows are asking for something, for the card's subtitle. */\nexport function countNeedingAttention(\n  members: MemberLike[],\n  now: number = Date.now(),\n): number {\n  return members.filter((m) => readPresence(m, now).needsAttention).length;\n}\n"],"mappings":"AAuCO,MAAM,iBAAiB,IAAI,KAAK;AAEhC,MAAM,qBAAqB,KAAK,KAAK,KAAK;AASjD,MAAM,QAAQ,CAAC,UAAoD;AACjE,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,IAAI,IAAI,KAAK,KAAK,EAAE,QAAQ;AAClC,SAAO,OAAO,MAAM,CAAC,IAAI,OAAO;AAClC;AAEA,SAAS,KAAK,IAAoB;AAChC,SAAO,KAAK,MAAM,MAAM,KAAK,KAAK,KAAK,IAAK;AAC9C;AAEO,SAAS,aACd,QACA,MAAc,KAAK,IAAI,GACN;AACjB,MAAI,OAAO,WAAW,WAAW;AAC/B,WAAO,EAAE,OAAO,WAAW,OAAO,WAAW,gBAAgB,MAAM;AAAA,EACrE;AAEA,MAAI,OAAO,WAAW,WAAW;AAC/B,UAAM,UAAU,MAAM,OAAO,eAAe;AAI5C,QAAI,YAAY,MAAM;AACpB,aAAO,EAAE,OAAO,WAAW,OAAO,eAAe,gBAAgB,MAAM;AAAA,IACzE;AACA,QAAI,WAAW,KAAK;AAClB,aAAO;AAAA,QACL,OAAO;AAAA,QACP,OAAO;AAAA,QACP,gBAAgB;AAAA,MAClB;AAAA,IACF;AACA,QAAI,UAAU,OAAO,oBAAoB;AACvC,YAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,OAAO,UAAU,QAAQ,KAAK,KAAK,IAAK,CAAC;AACxE,aAAO;AAAA,QACL,OAAO;AAAA,QACP,OAAO,qBAAqB,KAAK;AAAA,QACjC,gBAAgB;AAAA,MAClB;AAAA,IACF;AACA,UAAM,OAAO,KAAK,UAAU,GAAG;AAC/B,WAAO;AAAA,MACL,OAAO;AAAA,MACP,OACE,QAAQ,IAAI,4BAA4B,qBAAqB,IAAI;AAAA,MACnE,gBAAgB;AAAA,IAClB;AAAA,EACF;AAYA,MAAI,OAAO,iBAAiB,QAAW;AACrC,WAAO,EAAE,OAAO,WAAW,OAAO,IAAI,gBAAgB,MAAM;AAAA,EAC9D;AAEA,QAAM,OAAO,MAAM,OAAO,YAAY;AACtC,MAAI,SAAS,MAAM;AAGjB,WAAO;AAAA,MACL,OAAO;AAAA,MACP,OAAO;AAAA,MACP,gBAAgB;AAAA,IAClB;AAAA,EACF;AAEA,QAAM,MAAM,MAAM;AAElB,MAAI,OAAO,gBAAgB;AACzB,WAAO,EAAE,OAAO,QAAQ,OAAO,YAAY,gBAAgB,MAAM;AAAA,EACnE;AAEA,QAAM,IAAI,KAAK,GAAG;AAClB,MAAI,MAAM,GAAG;AACX,UAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,KAAK,KAAK,IAAK,CAAC;AAC5D,WAAO,EAAE,OAAO,SAAS,OAAO,GAAG,KAAK,SAAS,gBAAgB,MAAM;AAAA,EACzE;AACA,SAAO;AAAA,IACL,OAAO;AAAA,IACP,OAAO,MAAM,IAAI,cAAc,GAAG,CAAC;AAAA,IACnC,gBAAgB;AAAA,EAClB;AACF;AAGO,SAAS,sBACd,SACA,MAAc,KAAK,IAAI,GACf;AACR,SAAO,QAAQ,OAAO,CAAC,MAAM,aAAa,GAAG,GAAG,EAAE,cAAc,EAAE;AACpE;","names":[]}

package/dist/member-subscription-enrollment.d.ts

@@ -0,0 +1,16 @@
+interface EnrollMemberInPlanInput {
+    tenantSlug: string;
+    planId: string;
+    memberId: string;
+    memberEmail: string;
+    origin: string;
+}
+export declare function getMemberDetailPath(memberId: string, tab?: 'subscriptions'): string;
+export declare function getMemberSubscriptionCallbackUrl(origin: string, memberId: string): string;
+export declare function enrollMemberInPlan({ tenantSlug, planId, memberId, memberEmail, origin, }: EnrollMemberInPlanInput): Promise<{
+    subscription: import("@withpotter/lib/api").CustomerSubscription;
+    paymentRequired: boolean;
+    authorizationUrl?: string;
+    reference?: string;
+}>;
+export {};

package/dist/member-subscription-enrollment.js

@@ -0,0 +1,32 @@
+import { merchantSubscriptionsApi } from "@withpotter/lib/api";
+function getMemberDetailPath(memberId, tab) {
+  const path = `/dashboard/customers/${encodeURIComponent(memberId)}`;
+  return tab ? `${path}?tab=${tab}` : path;
+}
+function getMemberSubscriptionCallbackUrl(origin, memberId) {
+  return new URL(
+    getMemberDetailPath(memberId, "subscriptions"),
+    origin
+  ).toString();
+}
+function enrollMemberInPlan({
+  tenantSlug,
+  planId,
+  memberId,
+  memberEmail,
+  origin
+}) {
+  const request = {
+    planId,
+    customerId: memberId,
+    customerEmail: memberEmail,
+    callbackUrl: getMemberSubscriptionCallbackUrl(origin, memberId)
+  };
+  return merchantSubscriptionsApi.createSubscription(tenantSlug, request);
+}
+export {
+  enrollMemberInPlan,
+  getMemberDetailPath,
+  getMemberSubscriptionCallbackUrl
+};
+//# sourceMappingURL=member-subscription-enrollment.js.map

package/dist/member-subscription-enrollment.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/member-subscription-enrollment.ts"],"sourcesContent":["import { merchantSubscriptionsApi } from '@withpotter/lib/api';\n\ninterface EnrollMemberInPlanInput {\n  tenantSlug: string;\n  planId: string;\n  memberId: string;\n  memberEmail: string;\n  origin: string;\n}\n\nexport function getMemberDetailPath(memberId: string, tab?: 'subscriptions') {\n  const path = `/dashboard/customers/${encodeURIComponent(memberId)}`;\n  return tab ? `${path}?tab=${tab}` : path;\n}\n\nexport function getMemberSubscriptionCallbackUrl(\n  origin: string,\n  memberId: string,\n) {\n  return new URL(\n    getMemberDetailPath(memberId, 'subscriptions'),\n    origin,\n  ).toString();\n}\n\nexport function enrollMemberInPlan({\n  tenantSlug,\n  planId,\n  memberId,\n  memberEmail,\n  origin,\n}: EnrollMemberInPlanInput) {\n  const request = {\n    planId,\n    customerId: memberId,\n    customerEmail: memberEmail,\n    callbackUrl: getMemberSubscriptionCallbackUrl(origin, memberId),\n  };\n\n  return merchantSubscriptionsApi.createSubscription(tenantSlug, request);\n}\n"],"mappings":"AAAA,SAAS,gCAAgC;AAUlC,SAAS,oBAAoB,UAAkB,KAAuB;AAC3E,QAAM,OAAO,wBAAwB,mBAAmB,QAAQ,CAAC;AACjE,SAAO,MAAM,GAAG,IAAI,QAAQ,GAAG,KAAK;AACtC;AAEO,SAAS,iCACd,QACA,UACA;AACA,SAAO,IAAI;AAAA,IACT,oBAAoB,UAAU,eAAe;AAAA,IAC7C;AAAA,EACF,EAAE,SAAS;AACb;AAEO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA4B;AAC1B,QAAM,UAAU;AAAA,IACd;AAAA,IACA,YAAY;AAAA,IACZ,eAAe;AAAA,IACf,aAAa,iCAAiC,QAAQ,QAAQ;AAAA,EAChE;AAEA,SAAO,yBAAyB,mBAAmB,YAAY,OAAO;AACxE;","names":[]}

package/dist/membership-freshness.d.ts

@@ -0,0 +1,31 @@
+/**
+ * When a cached membership is stale enough to be worth re-asking for, and what
+ * a failed re-ask means.
+ *
+ * `usePermissions` fetched once per tenant change and then never again. A
+ * merchant who demoted someone, or removed them outright, had no effect on that
+ * person's open tab until they happened to reload: the nav still offered rows
+ * the api had already started refusing, and the removed member kept a working
+ * dashboard for a business they were no longer in.
+ *
+ * Pure so it can be tested without a renderer.
+ */
+/** Below this, a refocus is someone alt-tabbing, not a session worth re-checking. */
+export declare const MEMBERSHIP_STALE_AFTER_MS = 30000;
+export declare function isMembershipStale(lastFetchedAt: number | null, now: number, staleAfterMs?: number): boolean;
+export type MembershipOutcome = 'active' | 'removed' | 'unknown';
+/**
+ * What a failed `/team/me` means.
+ *
+ * 403 and 404 are the api saying this account is not a member of this tenant,
+ * which is a real answer and should lock the session down. Anything else — a
+ * timeout, a 500, an offline tab — is not an answer, and must NOT be treated as
+ * removal, or a flaky connection would eject people from their own workspace.
+ */
+export declare function classifyMembershipError(error: unknown): MembershipOutcome;
+/**
+ * A `null` body from `/team/me` is the other way the api says "not a member" —
+ * it answers 200 with no membership. Distinguished from an error because it is
+ * a successful response, but it means the same thing.
+ */
+export declare function outcomeForMember(member: unknown): MembershipOutcome;

package/dist/membership-freshness.js

@@ -0,0 +1,21 @@
+const MEMBERSHIP_STALE_AFTER_MS = 3e4;
+function isMembershipStale(lastFetchedAt, now, staleAfterMs = MEMBERSHIP_STALE_AFTER_MS) {
+  if (lastFetchedAt === null) return true;
+  if (now < lastFetchedAt) return true;
+  return now - lastFetchedAt >= staleAfterMs;
+}
+function classifyMembershipError(error) {
+  const status = typeof error === "object" && error !== null && "status" in error ? error.status : void 0;
+  if (status === 403 || status === 404) return "removed";
+  return "unknown";
+}
+function outcomeForMember(member) {
+  return member ? "active" : "removed";
+}
+export {
+  MEMBERSHIP_STALE_AFTER_MS,
+  classifyMembershipError,
+  isMembershipStale,
+  outcomeForMember
+};
+//# sourceMappingURL=membership-freshness.js.map

package/dist/membership-freshness.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/membership-freshness.ts"],"sourcesContent":["/**\n * When a cached membership is stale enough to be worth re-asking for, and what\n * a failed re-ask means.\n *\n * `usePermissions` fetched once per tenant change and then never again. A\n * merchant who demoted someone, or removed them outright, had no effect on that\n * person's open tab until they happened to reload: the nav still offered rows\n * the api had already started refusing, and the removed member kept a working\n * dashboard for a business they were no longer in.\n *\n * Pure so it can be tested without a renderer.\n */\n\n/** Below this, a refocus is someone alt-tabbing, not a session worth re-checking. */\nexport const MEMBERSHIP_STALE_AFTER_MS = 30_000;\n\nexport function isMembershipStale(\n  lastFetchedAt: number | null,\n  now: number,\n  staleAfterMs: number = MEMBERSHIP_STALE_AFTER_MS,\n): boolean {\n  if (lastFetchedAt === null) return true;\n  // A clock that has gone backwards (system time change, a paused laptop\n  // resuming) must not read as \"fetched in the future\" and pin the membership\n  // as fresh forever.\n  if (now < lastFetchedAt) return true;\n  return now - lastFetchedAt >= staleAfterMs;\n}\n\nexport type MembershipOutcome = 'active' | 'removed' | 'unknown';\n\n/**\n * What a failed `/team/me` means.\n *\n * 403 and 404 are the api saying this account is not a member of this tenant,\n * which is a real answer and should lock the session down. Anything else — a\n * timeout, a 500, an offline tab — is not an answer, and must NOT be treated as\n * removal, or a flaky connection would eject people from their own workspace.\n */\nexport function classifyMembershipError(error: unknown): MembershipOutcome {\n  const status =\n    typeof error === 'object' && error !== null && 'status' in error\n      ? (error as { status?: unknown }).status\n      : undefined;\n\n  if (status === 403 || status === 404) return 'removed';\n  return 'unknown';\n}\n\n/**\n * A `null` body from `/team/me` is the other way the api says \"not a member\" —\n * it answers 200 with no membership. Distinguished from an error because it is\n * a successful response, but it means the same thing.\n */\nexport function outcomeForMember(member: unknown): MembershipOutcome {\n  return member ? 'active' : 'removed';\n}\n"],"mappings":"AAcO,MAAM,4BAA4B;AAElC,SAAS,kBACd,eACA,KACA,eAAuB,2BACd;AACT,MAAI,kBAAkB,KAAM,QAAO;AAInC,MAAI,MAAM,cAAe,QAAO;AAChC,SAAO,MAAM,iBAAiB;AAChC;AAYO,SAAS,wBAAwB,OAAmC;AACzE,QAAM,SACJ,OAAO,UAAU,YAAY,UAAU,QAAQ,YAAY,QACtD,MAA+B,SAChC;AAEN,MAAI,WAAW,OAAO,WAAW,IAAK,QAAO;AAC7C,SAAO;AACT;AAOO,SAAS,iBAAiB,QAAoC;AACnE,SAAO,SAAS,WAAW;AAC7B;","names":[]}

package/dist/mobile-header-context.d.ts

@@ -0,0 +1,32 @@
+import type { LucideIcon } from 'lucide-react';
+interface DetailHeaderConfig {
+    title: string;
+    onBack?: () => void;
+    action?: {
+        label: string;
+        icon?: LucideIcon;
+        onClick: () => void;
+    };
+}
+interface ScreenHeaderConfig {
+    title?: string;
+    subtitle?: string;
+    action?: {
+        label: string;
+        icon?: LucideIcon;
+        onClick: () => void;
+    };
+}
+interface MobileHeaderContextValue {
+    detailConfig: DetailHeaderConfig | null;
+    setDetailHeader: (config: DetailHeaderConfig) => void;
+    clearDetailHeader: () => void;
+    screenConfig: ScreenHeaderConfig | null;
+    setScreenHeader: (config: ScreenHeaderConfig) => void;
+    clearScreenHeader: () => void;
+}
+export declare function MobileHeaderProvider({ children, }: {
+    children: React.ReactNode;
+}): import("react").JSX.Element;
+export declare function useMobileHeaderContext(): MobileHeaderContextValue;
+export {};

package/dist/mobile-header-context.js

@@ -0,0 +1,59 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { createContext, useContext, useState, useCallback } from "react";
+const MobileHeaderContext = createContext({
+  detailConfig: null,
+  setDetailHeader: () => {
+  },
+  clearDetailHeader: () => {
+  },
+  screenConfig: null,
+  setScreenHeader: () => {
+  },
+  clearScreenHeader: () => {
+  }
+});
+function MobileHeaderProvider({
+  children
+}) {
+  const [detailConfig, setDetailConfig] = useState(
+    null
+  );
+  const [screenConfig, setScreenConfig] = useState(
+    null
+  );
+  const setDetailHeader = useCallback((config) => {
+    setDetailConfig(config);
+  }, []);
+  const clearDetailHeader = useCallback(() => {
+    setDetailConfig(null);
+  }, []);
+  const setScreenHeader = useCallback((config) => {
+    setScreenConfig(config);
+  }, []);
+  const clearScreenHeader = useCallback(() => {
+    setScreenConfig(null);
+  }, []);
+  return /* @__PURE__ */ jsx(
+    MobileHeaderContext.Provider,
+    {
+      value: {
+        detailConfig,
+        setDetailHeader,
+        clearDetailHeader,
+        screenConfig,
+        setScreenHeader,
+        clearScreenHeader
+      },
+      children
+    }
+  );
+}
+function useMobileHeaderContext() {
+  return useContext(MobileHeaderContext);
+}
+export {
+  MobileHeaderProvider,
+  useMobileHeaderContext
+};
+//# sourceMappingURL=mobile-header-context.js.map

package/dist/mobile-header-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mobile-header-context.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, useContext, useState, useCallback } from 'react';\nimport type { LucideIcon } from 'lucide-react';\n\ninterface DetailHeaderConfig {\n  title: string;\n  onBack?: () => void;\n  action?: { label: string; icon?: LucideIcon; onClick: () => void };\n}\n\ninterface ScreenHeaderConfig {\n  title?: string;\n  subtitle?: string;\n  action?: { label: string; icon?: LucideIcon; onClick: () => void };\n}\n\ninterface MobileHeaderContextValue {\n  detailConfig: DetailHeaderConfig | null;\n  setDetailHeader: (config: DetailHeaderConfig) => void;\n  clearDetailHeader: () => void;\n  screenConfig: ScreenHeaderConfig | null;\n  setScreenHeader: (config: ScreenHeaderConfig) => void;\n  clearScreenHeader: () => void;\n}\n\nconst MobileHeaderContext = createContext<MobileHeaderContextValue>({\n  detailConfig: null,\n  setDetailHeader: () => {},\n  clearDetailHeader: () => {},\n  screenConfig: null,\n  setScreenHeader: () => {},\n  clearScreenHeader: () => {},\n});\n\nexport function MobileHeaderProvider({\n  children,\n}: {\n  children: React.ReactNode;\n}) {\n  const [detailConfig, setDetailConfig] = useState<DetailHeaderConfig | null>(\n    null,\n  );\n  const [screenConfig, setScreenConfig] = useState<ScreenHeaderConfig | null>(\n    null,\n  );\n\n  const setDetailHeader = useCallback((config: DetailHeaderConfig) => {\n    setDetailConfig(config);\n  }, []);\n\n  const clearDetailHeader = useCallback(() => {\n    setDetailConfig(null);\n  }, []);\n\n  const setScreenHeader = useCallback((config: ScreenHeaderConfig) => {\n    setScreenConfig(config);\n  }, []);\n\n  const clearScreenHeader = useCallback(() => {\n    setScreenConfig(null);\n  }, []);\n\n  return (\n    <MobileHeaderContext.Provider\n      value={{\n        detailConfig,\n        setDetailHeader,\n        clearDetailHeader,\n        screenConfig,\n        setScreenHeader,\n        clearScreenHeader,\n      }}\n    >\n      {children}\n    </MobileHeaderContext.Provider>\n  );\n}\n\nexport function useMobileHeaderContext() {\n  return useContext(MobileHeaderContext);\n}\n"],"mappings":";AAgEI;AA9DJ,SAAS,eAAe,YAAY,UAAU,mBAAmB;AAwBjE,MAAM,sBAAsB,cAAwC;AAAA,EAClE,cAAc;AAAA,EACd,iBAAiB,MAAM;AAAA,EAAC;AAAA,EACxB,mBAAmB,MAAM;AAAA,EAAC;AAAA,EAC1B,cAAc;AAAA,EACd,iBAAiB,MAAM;AAAA,EAAC;AAAA,EACxB,mBAAmB,MAAM;AAAA,EAAC;AAC5B,CAAC;AAEM,SAAS,qBAAqB;AAAA,EACnC;AACF,GAEG;AACD,QAAM,CAAC,cAAc,eAAe,IAAI;AAAA,IACtC;AAAA,EACF;AACA,QAAM,CAAC,cAAc,eAAe,IAAI;AAAA,IACtC;AAAA,EACF;AAEA,QAAM,kBAAkB,YAAY,CAAC,WAA+B;AAClE,oBAAgB,MAAM;AAAA,EACxB,GAAG,CAAC,CAAC;AAEL,QAAM,oBAAoB,YAAY,MAAM;AAC1C,oBAAgB,IAAI;AAAA,EACtB,GAAG,CAAC,CAAC;AAEL,QAAM,kBAAkB,YAAY,CAAC,WAA+B;AAClE,oBAAgB,MAAM;AAAA,EACxB,GAAG,CAAC,CAAC;AAEL,QAAM,oBAAoB,YAAY,MAAM;AAC1C,oBAAgB,IAAI;AAAA,EACtB,GAAG,CAAC,CAAC;AAEL,SACE;AAAA,IAAC,oBAAoB;AAAA,IAApB;AAAA,MACC,OAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,MAEC;AAAA;AAAA,EACH;AAEJ;AAEO,SAAS,yBAAyB;AACvC,SAAO,WAAW,mBAAmB;AACvC;","names":[]}

package/dist/mobile-routes.d.ts

@@ -0,0 +1,81 @@
+/**
+ * The mobile route contract.
+ *
+ * Every route under `/dashboard` declares how it behaves on a phone. There are
+ * only four answers, and "we haven't decided" is not one of them — that is the
+ * whole point of this file. `scripts/check-mobile-routes.mjs` fails CI when a
+ * route exists without an entry here, or an entry here points at a route that
+ * no longer exists.
+ *
+ * Why this exists: mobile had grown into a second app — 59 hand-built screens
+ * covering 43% of the dashboard — and nothing broke when a route shipped
+ * without a mobile twin. A fork with no failure mode loses ground every week.
+ * This is the failure mode.
+ *
+ * ## The tiers
+ *
+ * `native` — a hand-built mobile screen under `components/mobile/screens/`,
+ *   drawing its own chrome from `components/mobile/primitives/chrome.tsx`
+ *   (`BackBar`, `BottomTabBar`). Reserved for jobs a merchant does **standing
+ *   up, one hand, under a minute**. That is the entire test. It is a closed
+ *   list; adding to it is a product decision, not a refactor. The five tab
+ *   roots are always native, because landing a tab press in a fallback layout
+ *   reads as a bug.
+ *
+ * `shell` — the desktop body, on a phone, with mobile chrome around it. The
+ *   correct answer for anything configured sitting down.
+ *
+ *   `MobileShellChrome`, mounted in `app/dashboard/layout.tsx`, draws that
+ *   chrome from the live primitives. It reads `mobile-header-context`, so a
+ *   route names itself by publishing a title — `useScreenHeader`,
+ *   `useDetailHeader` or `<MobilePageHeader>`, and both page frames do it for
+ *   you. Publish nothing and you get a tab bar with no name on it.
+ * `desktop-only` — genuinely cannot be a phone surface. Every entry carries a
+ *   reason so the call does not get re-litigated every six months.
+ *
+ * `redirect` — a stub that never renders its own UI, so it has no mobile
+ *   behaviour to declare. Two spellings: a server `redirect()`, or a client
+ *   `router.replace()` in an effect for routes that must wait on the tenant
+ *   before they know where to go. Tracked so the gate can tell a real gap from
+ *   a route that was always a signpost.
+ */
+export type MobileTier = 'native' | 'shell' | 'desktop-only' | 'redirect';
+export declare const DESKTOP_ONLY_REASONS: Record<string, string>;
+export declare const MOBILE_ROUTES: Record<string, MobileTier>;
+/**
+ * Shell-tier routes that STILL render a hand-built mobile screen.
+ *
+ * These are the Phase 2 deletion backlog: they failed the standing-up test, so
+ * the tier says `shell`, but the screen has not been removed yet and the route
+ * still branches on `useIsMobile`. Until it does, the frame must not add
+ * fallback chrome on top — that is how a screen ends up with two headers.
+ *
+ * The list is transient and should shrink to nothing. The gate verifies it:
+ * every entry must actually still branch, and no shell route may branch without
+ * being listed here. Delete a mobile screen, drop its line, and the route picks
+ * up the fallback automatically.
+ */
+/**
+ * Shell routes that deliberately draw no chrome.
+ *
+ * Not a gap and not a backlog: a surface whose whole job is to *be* the
+ * customer's view of the site cannot have the app's furniture sitting on top of
+ * it. The template preview has its own toolbar naming the template and its own
+ * fullscreen mode, so it names itself and offers its own way out.
+ */
+export declare const CHROMELESS_BY_DESIGN: ReadonlySet<string>;
+export declare const LEGACY_MOBILE_SCREENS: ReadonlySet<string>;
+/**
+ * Whether the shared page frames should draw mobile chrome for this pathname.
+ *
+ * True only for a shell route that draws none of its own. A native screen
+ * brings its own BackBar/BottomTabBar, and a legacy screen still does too.
+ */
+export declare function shouldRenderFallbackChrome(pathname: string): boolean;
+/**
+ * Resolve a live pathname to its tier, matching dynamic segments.
+ *
+ * Static keys win over dynamic ones, so `/dashboard/catalog/new` resolves to
+ * its own entry rather than to `/dashboard/catalog/[productId]`.
+ */
+export declare function mobileTierFor(pathname: string): MobileTier | undefined;