@withpotter/lib 0.13.0-next.101

package/dist/__fixtures__/demo-content-server.json

@@ -0,0 +1,484 @@
+{
+  "status_none": {
+    "status": 200,
+    "body": {
+      "state": "none"
+    }
+  },
+  "available_no_pack": {
+    "status": 200,
+    "body": {
+      "available": false,
+      "template": "atelier-fashion-01",
+      "state": "none",
+      "reason": "no_pack"
+    }
+  },
+  "error_not_owner_or_admin": {
+    "status": 403,
+    "body": {
+      "statusCode": 403,
+      "code": "not_owner_or_admin",
+      "message": "Only the owner or an admin of this store can change demo content."
+    }
+  },
+  "error_clear_nothing": {
+    "status": 404,
+    "body": {
+      "statusCode": 404,
+      "code": "no_demo_content",
+      "message": "There is no demo content to clear."
+    }
+  },
+  "error_invalid_body": {
+    "status": 400,
+    "body": {
+      "statusCode": 400,
+      "code": "invalid_body",
+      "message": "Unknown field \"nope\"."
+    }
+  },
+  "available_ok": {
+    "status": 200,
+    "body": {
+      "available": true,
+      "template": "atelier-fashion-01",
+      "state": "none",
+      "pack": {
+        "id": "atelier-fashion-01",
+        "name": "Atelier starter",
+        "description": "A small fashion store",
+        "version": "1.0.0",
+        "audience": "starter",
+        "locale": "en-NG",
+        "hash": "8a250f256273eae1183683684d411baba581c483f382727fef07872428fb8fe0"
+      },
+      "summary": {
+        "products": 2,
+        "collections": 1,
+        "contentItems": 0,
+        "pages": 1,
+        "images": 3,
+        "shipping": true
+      }
+    }
+  },
+  "dry_run": {
+    "status": 200,
+    "body": {
+      "dryRun": true,
+      "pack": {
+        "id": "atelier-fashion-01",
+        "version": "1.0.0",
+        "audience": "starter",
+        "hash": "8a250f256273eae1183683684d411baba581c483f382727fef07872428fb8fe0"
+      },
+      "plan": {
+        "products": {
+          "create": 2,
+          "update": 0,
+          "unchanged": 0,
+          "conflict": 0
+        },
+        "collections": {
+          "create": 1,
+          "update": 0,
+          "unchanged": 0,
+          "conflict": 0
+        },
+        "contentItems": {
+          "create": 0,
+          "update": 0,
+          "unchanged": 0,
+          "conflict": 0
+        },
+        "pages": {
+          "write": 3,
+          "skip": 0
+        },
+        "media": 3,
+        "shipping": "create"
+      },
+      "conflicts": [],
+      "skippedPages": []
+    }
+  },
+  "apply_202": {
+    "status": 202,
+    "body": {
+      "jobId": "30ac04a6-f11b-4888-a769-84e401dfc8df",
+      "state": "applying",
+      "resumed": false
+    }
+  },
+  "status_applying": {
+    "status": 200,
+    "body": {
+      "state": "applying",
+      "pack": {
+        "id": "atelier-fashion-01",
+        "template": "atelier-fashion-01",
+        "audience": "",
+        "hash": ""
+      },
+      "progress": {
+        "phase": "fetching",
+        "done": 0,
+        "total": 0
+      },
+      "startedAt": "2026-10-30T05:44:58.977Z",
+      "job": "apply",
+      "counts": {
+        "products": 0,
+        "collections": 0,
+        "pages": 0,
+        "media": 0
+      }
+    }
+  },
+  "error_job_in_progress": {
+    "status": 409,
+    "body": {
+      "statusCode": 409,
+      "code": "job_in_progress",
+      "message": "Demo content is already being changed. Wait for it to finish.",
+      "details": {
+        "job": "apply"
+      }
+    }
+  },
+  "error_adopt_busy": {
+    "status": 409,
+    "body": {
+      "statusCode": 409,
+      "code": "job_in_progress",
+      "message": "Demo content is already being changed. Wait for it to finish.",
+      "details": {
+        "job": "apply"
+      }
+    }
+  },
+  "status_applied": {
+    "status": 200,
+    "body": {
+      "state": "applied",
+      "pack": {
+        "id": "atelier-fashion-01",
+        "template": "atelier-fashion-01",
+        "version": "1.0.0",
+        "audience": "starter",
+        "hash": "8a250f256273eae1183683684d411baba581c483f382727fef07872428fb8fe0"
+      },
+      "progress": {
+        "phase": "activating",
+        "done": 3,
+        "total": 3
+      },
+      "startedAt": "2026-10-30T05:44:58.977Z",
+      "job": "apply",
+      "finishedAt": "2026-10-30T05:44:58.983Z",
+      "counts": {
+        "products": 2,
+        "collections": 1,
+        "pages": 1,
+        "media": 2
+      }
+    }
+  },
+  "available_after_apply": {
+    "status": 200,
+    "body": {
+      "available": true,
+      "template": "atelier-fashion-01",
+      "state": "applied",
+      "pack": {
+        "id": "atelier-fashion-01",
+        "name": "Atelier starter",
+        "description": "A small fashion store",
+        "version": "1.0.0",
+        "audience": "starter",
+        "locale": "en-NG",
+        "hash": "8a250f256273eae1183683684d411baba581c483f382727fef07872428fb8fe0"
+      },
+      "summary": {
+        "products": 2,
+        "collections": 1,
+        "contentItems": 0,
+        "pages": 1,
+        "images": 3,
+        "shipping": true
+      }
+    }
+  },
+  "sample_product": {
+    "id": "id-1",
+    "type": "physical",
+    "slug": "classic-tee",
+    "title": "Classic tee",
+    "tags": [
+      "demo-pack",
+      "demo-pack:atelier-fashion-01"
+    ],
+    "data": {
+      "demoPack": {
+        "id": "atelier-fashion-01",
+        "ref": "tee"
+      }
+    },
+    "isActive": true
+  },
+  "sample_collection": {
+    "id": "id-3",
+    "type": "collections",
+    "slug": "tops",
+    "title": "Tops",
+    "tags": [
+      "demo-pack",
+      "demo-pack:atelier-fashion-01"
+    ],
+    "data": {
+      "productIds": [
+        "id-1"
+      ],
+      "demoPack": {
+        "id": "atelier-fashion-01",
+        "ref": "tops"
+      }
+    },
+    "isActive": true
+  },
+  "adopt_200": {
+    "status": 200,
+    "body": {
+      "adopted": {
+        "products": [
+          "id-1"
+        ],
+        "collections": [],
+        "contentItems": []
+      },
+      "notFound": [
+        "ghost"
+      ]
+    }
+  },
+  "sample_product_after_adopt": {
+    "id": "id-1",
+    "type": "physical",
+    "slug": "classic-tee",
+    "title": "Classic tee",
+    "tags": [],
+    "data": {},
+    "isActive": true
+  },
+  "error_nothing_to_adopt": {
+    "status": 400,
+    "body": {
+      "statusCode": 400,
+      "code": "nothing_to_adopt",
+      "message": "Name at least one item to keep, or pass all: true."
+    }
+  },
+  "clear_202": {
+    "status": 202,
+    "body": {
+      "jobId": "6764bb70-2a79-4047-9bb8-760802c6a10d",
+      "state": "clearing",
+      "resumed": false
+    }
+  },
+  "status_clearing": {
+    "status": 200,
+    "body": {
+      "state": "clearing",
+      "pack": {
+        "id": "atelier-fashion-01",
+        "template": "atelier-fashion-01",
+        "version": "1.0.0",
+        "audience": "starter",
+        "hash": "8a250f256273eae1183683684d411baba581c483f382727fef07872428fb8fe0"
+      },
+      "progress": {
+        "phase": "catalogue",
+        "done": 0,
+        "total": 0
+      },
+      "startedAt": "2026-10-30T05:44:58.984Z",
+      "job": "clear",
+      "counts": {
+        "products": 1,
+        "collections": 1,
+        "pages": 1,
+        "media": 2
+      }
+    }
+  },
+  "status_after_clear": {
+    "status": 200,
+    "body": {
+      "state": "none",
+      "orphanedMedia": {
+        "count": 2,
+        "clearedAt": "2026-10-30T05:44:58.985Z"
+      }
+    }
+  },
+  "status_failed_apply": {
+    "status": 200,
+    "body": {
+      "state": "failed",
+      "pack": {
+        "id": "atelier-fashion-01",
+        "template": "atelier-fashion-01",
+        "version": "1.0.0",
+        "audience": "starter",
+        "hash": "8a250f256273eae1183683684d411baba581c483f382727fef07872428fb8fe0"
+      },
+      "progress": {
+        "phase": "products",
+        "done": 1,
+        "total": 2
+      },
+      "startedAt": "2026-10-30T05:44:58.992Z",
+      "job": "apply",
+      "finishedAt": "2026-10-30T05:44:59.006Z",
+      "counts": {
+        "products": 1,
+        "collections": 0,
+        "pages": 0,
+        "media": 2
+      },
+      "error": {
+        "code": "internal",
+        "message": "Something went wrong while adding the demo content. Try again."
+      }
+    }
+  },
+  "apply_resumed": {
+    "status": 202,
+    "body": {
+      "jobId": "ebc57efe-f23d-407b-9136-158bc45b761f",
+      "state": "applying",
+      "resumed": true
+    }
+  },
+  "status_applied_skipped": {
+    "status": 200,
+    "body": {
+      "state": "applied",
+      "pack": {
+        "id": "atelier-fashion-01",
+        "template": "atelier-fashion-01",
+        "version": "1.0.0",
+        "audience": "starter",
+        "hash": "8a250f256273eae1183683684d411baba581c483f382727fef07872428fb8fe0"
+      },
+      "progress": {
+        "phase": "activating",
+        "done": 3,
+        "total": 3
+      },
+      "startedAt": "2026-10-30T05:44:59.017Z",
+      "job": "apply",
+      "finishedAt": "2026-10-30T05:44:59.019Z",
+      "counts": {
+        "products": 2,
+        "collections": 1,
+        "pages": 0,
+        "media": 2
+      },
+      "skippedPages": [
+        "home"
+      ]
+    }
+  },
+  "error_pack_hash_mismatch": {
+    "status": 422,
+    "body": {
+      "statusCode": 422,
+      "code": "pack_hash_mismatch",
+      "message": "The downloaded pack does not match its published checksum."
+    }
+  },
+  "error_pack_branded_assets": {
+    "status": 422,
+    "body": {
+      "statusCode": 422,
+      "code": "pack_branded_assets",
+      "message": "A starter pack cannot contain branded pictures.",
+      "details": {
+        "assets": [
+          "hero",
+          "tee",
+          "tee2"
+        ]
+      }
+    }
+  },
+  "error_rate_limited": {
+    "status": 429,
+    "body": {
+      "statusCode": 429,
+      "code": "rate_limited",
+      "message": "Demo content was applied too often. Try again later.",
+      "details": {
+        "retryAfterSeconds": 3600
+      }
+    }
+  },
+  "enums": {
+    "states": [
+      "none",
+      "applying",
+      "applied",
+      "clearing",
+      "failed"
+    ],
+    "jobs": [
+      "apply",
+      "clear"
+    ],
+    "phases": [
+      "fetching",
+      "media",
+      "products",
+      "collections",
+      "content",
+      "tenant",
+      "pages",
+      "shipping",
+      "pruning",
+      "activating",
+      "catalogue",
+      "settings"
+    ],
+    "errorCodes": [
+      "invalid_body",
+      "not_owner_or_admin",
+      "showroom_not_allowed",
+      "pack_url_forbidden",
+      "pack_url_invalid",
+      "pack_host_not_allowed",
+      "template_mismatch",
+      "no_pack",
+      "no_demo_content",
+      "job_in_progress",
+      "other_pack_present",
+      "pack_invalid",
+      "pack_branded_assets",
+      "pack_hash_mismatch",
+      "pack_too_large",
+      "pack_fetch_failed",
+      "quota_exceeded",
+      "rate_limited",
+      "nothing_to_adopt",
+      "interrupted",
+      "internal"
+    ]
+  },
+  "marker": {
+    "tag": "demo-pack",
+    "packTag": "demo-pack:atelier-fashion-01"
+  },
+  "_about": "Generated by running @withpotter/demo-content (api-next PR #620) through its real controller, guards and use cases against the in-memory world of its own specs."
+}

package/dist/accessibility-context.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Accessibility preferences — persisted to localStorage and applied as data
+ * attributes on `<html>` so any screen can react via CSS.
+ *
+ * Hooks:
+ *   data-text-scale="md|lg|xl"        — bumps base font scale
+ *   data-reduce-motion="on"           — disables non-essential motion
+ *   data-high-contrast="on"           — opts into elevated contrast tokens
+ */
+import { type ReactNode } from 'react';
+export type TextScale = 'sm' | 'md' | 'lg' | 'xl';
+export interface AccessibilityPreferences {
+    textScale: TextScale;
+    reduceMotion: boolean;
+    highContrast: boolean;
+}
+interface ContextValue extends AccessibilityPreferences {
+    setTextScale: (v: TextScale) => void;
+    setReduceMotion: (v: boolean) => void;
+    setHighContrast: (v: boolean) => void;
+    reset: () => void;
+}
+export declare function AccessibilityProvider({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useAccessibility(): ContextValue;
+export {};

package/dist/accessibility-context.js

@@ -0,0 +1,107 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useEffect,
+  useMemo,
+  useState
+} from "react";
+import { MotionConfig } from "motion/react";
+const STORAGE_KEY = "pb:a11y-preferences";
+const DEFAULT_PREFS = {
+  textScale: "md",
+  reduceMotion: false,
+  highContrast: false
+};
+const AccessibilityContext = createContext(null);
+function readStoredPrefs() {
+  if (typeof window === "undefined") return DEFAULT_PREFS;
+  try {
+    const raw = window.localStorage.getItem(STORAGE_KEY);
+    if (!raw) return DEFAULT_PREFS;
+    const parsed = JSON.parse(raw);
+    return {
+      textScale: parsed.textScale && ["sm", "md", "lg", "xl"].includes(parsed.textScale) ? parsed.textScale : DEFAULT_PREFS.textScale,
+      reduceMotion: Boolean(parsed.reduceMotion),
+      highContrast: Boolean(parsed.highContrast)
+    };
+  } catch {
+    return DEFAULT_PREFS;
+  }
+}
+function applyToDocument(prefs) {
+  if (typeof document === "undefined") return;
+  const root = document.documentElement;
+  root.setAttribute("data-text-scale", prefs.textScale);
+  if (prefs.reduceMotion) {
+    root.setAttribute("data-reduce-motion", "on");
+  } else {
+    root.removeAttribute("data-reduce-motion");
+  }
+  if (prefs.highContrast) {
+    root.setAttribute("data-high-contrast", "on");
+  } else {
+    root.removeAttribute("data-high-contrast");
+  }
+}
+function MotionPreference({
+  reduceMotion,
+  children
+}) {
+  return /* @__PURE__ */ jsx(MotionConfig, { reducedMotion: reduceMotion ? "always" : "user", children });
+}
+function AccessibilityProvider({ children }) {
+  const [prefs, setPrefs] = useState(DEFAULT_PREFS);
+  useEffect(() => {
+    const stored = readStoredPrefs();
+    setPrefs(stored);
+    applyToDocument(stored);
+  }, []);
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    try {
+      window.localStorage.setItem(STORAGE_KEY, JSON.stringify(prefs));
+    } catch {
+    }
+    applyToDocument(prefs);
+  }, [prefs]);
+  const setTextScale = useCallback((v) => {
+    setPrefs((p) => ({ ...p, textScale: v }));
+  }, []);
+  const setReduceMotion = useCallback((v) => {
+    setPrefs((p) => ({ ...p, reduceMotion: v }));
+  }, []);
+  const setHighContrast = useCallback((v) => {
+    setPrefs((p) => ({ ...p, highContrast: v }));
+  }, []);
+  const reset = useCallback(() => setPrefs(DEFAULT_PREFS), []);
+  const value = useMemo(
+    () => ({ ...prefs, setTextScale, setReduceMotion, setHighContrast, reset }),
+    [prefs, setTextScale, setReduceMotion, setHighContrast, reset]
+  );
+  return /* @__PURE__ */ jsx(AccessibilityContext.Provider, { value, children: /* @__PURE__ */ jsx(MotionPreference, { reduceMotion: prefs.reduceMotion, children }) });
+}
+function useAccessibility() {
+  const ctx = useContext(AccessibilityContext);
+  if (!ctx) {
+    return {
+      ...DEFAULT_PREFS,
+      setTextScale: () => {
+      },
+      setReduceMotion: () => {
+      },
+      setHighContrast: () => {
+      },
+      reset: () => {
+      }
+    };
+  }
+  return ctx;
+}
+export {
+  AccessibilityProvider,
+  useAccessibility
+};
+//# sourceMappingURL=accessibility-context.js.map

package/dist/accessibility-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/accessibility-context.tsx"],"sourcesContent":["'use client';\n\n/**\n * Accessibility preferences — persisted to localStorage and applied as data\n * attributes on `<html>` so any screen can react via CSS.\n *\n * Hooks:\n *   data-text-scale=\"md|lg|xl\"        — bumps base font scale\n *   data-reduce-motion=\"on\"           — disables non-essential motion\n *   data-high-contrast=\"on\"           — opts into elevated contrast tokens\n */\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n  type ReactNode,\n} from 'react';\nimport { MotionConfig } from 'motion/react';\n\nexport type TextScale = 'sm' | 'md' | 'lg' | 'xl';\n\nexport interface AccessibilityPreferences {\n  textScale: TextScale;\n  reduceMotion: boolean;\n  highContrast: boolean;\n}\n\nconst STORAGE_KEY = 'pb:a11y-preferences';\n\nconst DEFAULT_PREFS: AccessibilityPreferences = {\n  textScale: 'md',\n  reduceMotion: false,\n  highContrast: false,\n};\n\ninterface ContextValue extends AccessibilityPreferences {\n  setTextScale: (v: TextScale) => void;\n  setReduceMotion: (v: boolean) => void;\n  setHighContrast: (v: boolean) => void;\n  reset: () => void;\n}\n\nconst AccessibilityContext = createContext<ContextValue | null>(null);\n\nfunction readStoredPrefs(): AccessibilityPreferences {\n  if (typeof window === 'undefined') return DEFAULT_PREFS;\n  try {\n    const raw = window.localStorage.getItem(STORAGE_KEY);\n    if (!raw) return DEFAULT_PREFS;\n    const parsed = JSON.parse(raw) as Partial<AccessibilityPreferences>;\n    return {\n      textScale:\n        parsed.textScale && ['sm', 'md', 'lg', 'xl'].includes(parsed.textScale)\n          ? parsed.textScale\n          : DEFAULT_PREFS.textScale,\n      reduceMotion: Boolean(parsed.reduceMotion),\n      highContrast: Boolean(parsed.highContrast),\n    };\n  } catch {\n    return DEFAULT_PREFS;\n  }\n}\n\nfunction applyToDocument(prefs: AccessibilityPreferences) {\n  if (typeof document === 'undefined') return;\n  const root = document.documentElement;\n  root.setAttribute('data-text-scale', prefs.textScale);\n  if (prefs.reduceMotion) {\n    root.setAttribute('data-reduce-motion', 'on');\n  } else {\n    root.removeAttribute('data-reduce-motion');\n  }\n  if (prefs.highContrast) {\n    root.setAttribute('data-high-contrast', 'on');\n  } else {\n    root.removeAttribute('data-high-contrast');\n  }\n}\n\n/**\n * Framer's motion, told about the same preference the CSS already honours.\n *\n * There were two reduced-motion signals and neither reached the springs. The\n * in-app toggle stamps `data-reduce-motion=\"on\"`, which the global rule at the\n * bottom of globals.css turns into `animation-duration: 0.001ms` — but that is\n * CSS, and a spring is JavaScript writing transforms every frame, so it ran at\n * full tilt for anyone who had asked the product to stop moving. The OS\n * preference fared better because 86 files call `useReducedMotion()`\n * themselves, but 47 animating files never did, and a rule kept by hand in\n * every file is a rule that is kept in most of them.\n *\n * `MotionConfig` is the one place that settles it for every `<motion.*>` in\n * the tree at once, including the ones written after this. `always` when the\n * product's own switch is on, `user` otherwise — which defers to the OS.\n */\nfunction MotionPreference({\n  reduceMotion,\n  children,\n}: {\n  reduceMotion: boolean;\n  children: ReactNode;\n}) {\n  return (\n    <MotionConfig reducedMotion={reduceMotion ? 'always' : 'user'}>\n      {children}\n    </MotionConfig>\n  );\n}\n\nexport function AccessibilityProvider({ children }: { children: ReactNode }) {\n  const [prefs, setPrefs] = useState<AccessibilityPreferences>(DEFAULT_PREFS);\n\n  // Hydrate on mount\n  useEffect(() => {\n    const stored = readStoredPrefs();\n    setPrefs(stored);\n    applyToDocument(stored);\n  }, []);\n\n  // Persist + apply on every change\n  useEffect(() => {\n    if (typeof window === 'undefined') return;\n    try {\n      window.localStorage.setItem(STORAGE_KEY, JSON.stringify(prefs));\n    } catch {\n      /* ignore quota errors */\n    }\n    applyToDocument(prefs);\n  }, [prefs]);\n\n  const setTextScale = useCallback((v: TextScale) => {\n    setPrefs((p) => ({ ...p, textScale: v }));\n  }, []);\n  const setReduceMotion = useCallback((v: boolean) => {\n    setPrefs((p) => ({ ...p, reduceMotion: v }));\n  }, []);\n  const setHighContrast = useCallback((v: boolean) => {\n    setPrefs((p) => ({ ...p, highContrast: v }));\n  }, []);\n  const reset = useCallback(() => setPrefs(DEFAULT_PREFS), []);\n\n  const value = useMemo<ContextValue>(\n    () => ({ ...prefs, setTextScale, setReduceMotion, setHighContrast, reset }),\n    [prefs, setTextScale, setReduceMotion, setHighContrast, reset],\n  );\n\n  return (\n    <AccessibilityContext.Provider value={value}>\n      <MotionPreference reduceMotion={prefs.reduceMotion}>\n        {children}\n      </MotionPreference>\n    </AccessibilityContext.Provider>\n  );\n}\n\nexport function useAccessibility(): ContextValue {\n  const ctx = useContext(AccessibilityContext);\n  if (!ctx) {\n    // Outside provider — return a no-op shell so callers don't crash on SSR.\n    return {\n      ...DEFAULT_PREFS,\n      setTextScale: () => {},\n      setReduceMotion: () => {},\n      setHighContrast: () => {},\n      reset: () => {},\n    };\n  }\n  return ctx;\n}\n"],"mappings":";AA2GI;AA/FJ;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,oBAAoB;AAU7B,MAAM,cAAc;AAEpB,MAAM,gBAA0C;AAAA,EAC9C,WAAW;AAAA,EACX,cAAc;AAAA,EACd,cAAc;AAChB;AASA,MAAM,uBAAuB,cAAmC,IAAI;AAEpE,SAAS,kBAA4C;AACnD,MAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,MAAI;AACF,UAAM,MAAM,OAAO,aAAa,QAAQ,WAAW;AACnD,QAAI,CAAC,IAAK,QAAO;AACjB,UAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,WAAO;AAAA,MACL,WACE,OAAO,aAAa,CAAC,MAAM,MAAM,MAAM,IAAI,EAAE,SAAS,OAAO,SAAS,IAClE,OAAO,YACP,cAAc;AAAA,MACpB,cAAc,QAAQ,OAAO,YAAY;AAAA,MACzC,cAAc,QAAQ,OAAO,YAAY;AAAA,IAC3C;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,gBAAgB,OAAiC;AACxD,MAAI,OAAO,aAAa,YAAa;AACrC,QAAM,OAAO,SAAS;AACtB,OAAK,aAAa,mBAAmB,MAAM,SAAS;AACpD,MAAI,MAAM,cAAc;AACtB,SAAK,aAAa,sBAAsB,IAAI;AAAA,EAC9C,OAAO;AACL,SAAK,gBAAgB,oBAAoB;AAAA,EAC3C;AACA,MAAI,MAAM,cAAc;AACtB,SAAK,aAAa,sBAAsB,IAAI;AAAA,EAC9C,OAAO;AACL,SAAK,gBAAgB,oBAAoB;AAAA,EAC3C;AACF;AAkBA,SAAS,iBAAiB;AAAA,EACxB;AAAA,EACA;AACF,GAGG;AACD,SACE,oBAAC,gBAAa,eAAe,eAAe,WAAW,QACpD,UACH;AAEJ;AAEO,SAAS,sBAAsB,EAAE,SAAS,GAA4B;AAC3E,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAmC,aAAa;AAG1E,YAAU,MAAM;AACd,UAAM,SAAS,gBAAgB;AAC/B,aAAS,MAAM;AACf,oBAAgB,MAAM;AAAA,EACxB,GAAG,CAAC,CAAC;AAGL,YAAU,MAAM;AACd,QAAI,OAAO,WAAW,YAAa;AACnC,QAAI;AACF,aAAO,aAAa,QAAQ,aAAa,KAAK,UAAU,KAAK,CAAC;AAAA,IAChE,QAAQ;AAAA,IAER;AACA,oBAAgB,KAAK;AAAA,EACvB,GAAG,CAAC,KAAK,CAAC;AAEV,QAAM,eAAe,YAAY,CAAC,MAAiB;AACjD,aAAS,CAAC,OAAO,EAAE,GAAG,GAAG,WAAW,EAAE,EAAE;AAAA,EAC1C,GAAG,CAAC,CAAC;AACL,QAAM,kBAAkB,YAAY,CAAC,MAAe;AAClD,aAAS,CAAC,OAAO,EAAE,GAAG,GAAG,cAAc,EAAE,EAAE;AAAA,EAC7C,GAAG,CAAC,CAAC;AACL,QAAM,kBAAkB,YAAY,CAAC,MAAe;AAClD,aAAS,CAAC,OAAO,EAAE,GAAG,GAAG,cAAc,EAAE,EAAE;AAAA,EAC7C,GAAG,CAAC,CAAC;AACL,QAAM,QAAQ,YAAY,MAAM,SAAS,aAAa,GAAG,CAAC,CAAC;AAE3D,QAAM,QAAQ;AAAA,IACZ,OAAO,EAAE,GAAG,OAAO,cAAc,iBAAiB,iBAAiB,MAAM;AAAA,IACzE,CAAC,OAAO,cAAc,iBAAiB,iBAAiB,KAAK;AAAA,EAC/D;AAEA,SACE,oBAAC,qBAAqB,UAArB,EAA8B,OAC7B,8BAAC,oBAAiB,cAAc,MAAM,cACnC,UACH,GACF;AAEJ;AAEO,SAAS,mBAAiC;AAC/C,QAAM,MAAM,WAAW,oBAAoB;AAC3C,MAAI,CAAC,KAAK;AAER,WAAO;AAAA,MACL,GAAG;AAAA,MACH,cAAc,MAAM;AAAA,MAAC;AAAA,MACrB,iBAAiB,MAAM;AAAA,MAAC;AAAA,MACxB,iBAAiB,MAAM;AAAA,MAAC;AAAA,MACxB,OAAO,MAAM;AAAA,MAAC;AAAA,IAChB;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/active-workspace.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Which business a page load lands in.
+ *
+ * The rule was duplicated at all three entry paths — reload, login, refresh —
+ * as `find(slug === preferred) || workspaces[0]`, and a fourth party wrote to
+ * the storage it reads. That fourth party was the accept-invite screen, which
+ * cleared `currentWorkspace` and `pb_current_tenant` and trusted the app to
+ * come back up in the business it had just joined.
+ *
+ * It does not. `readPreferredSlug` falls through to `pb_last_workspace`, a key
+ * those two removals do not touch and which deliberately outlives a session so
+ * a returning owner resumes where they left off. So anybody who already used
+ * Box for their own business accepted an invite, was handed straight back to
+ * their own business, and saw an invite that looked like it had done nothing.
+ *
+ * Clearing cannot express "land me here". Naming it can.
+ */
+export interface WorkspaceLike {
+    tenant: {
+        id: string;
+        slug: string;
+    };
+}
+/**
+ * The precedence rule, as one pure function.
+ *
+ * A just-joined business outranks the remembered one, which outranks first-in-
+ * the-list. Both preferences are matched against the account's real workspaces
+ * and lose to the fallback when they name a business it does not have — an id
+ * or a slug is a request, never an answer.
+ */
+export declare function pickWorkspace<T extends WorkspaceLike>(workspaces: T[], opts: {
+    joinedTenantId?: string | null;
+    preferredSlug?: string | null;
+}): T | null;
+/**
+ * Remember the business just joined, for exactly one page load.
+ *
+ * sessionStorage, and a tenant id rather than a slug: the accept response
+ * carries the id, and the id is what the workspace list can be matched on
+ * without a second request to turn it into a slug.
+ */
+export declare function flagJoinedWorkspace(tenantId: string | null | undefined): void;
+export declare function readJoinedWorkspace(): string | null;
+export declare function clearJoinedWorkspace(): void;