@buoy-gg/shared-ui 7.0.21 → 7.0.23

package/lib/commonjs/index.js

@@ -39,6 +39,7 @@ var _exportNames = {
   scheduleReloadApp: true,
   resolveReloadStrategy: true,
   REMOTE_RELOAD_DELAY_MS: true,
+  getDevServerOrigin: true,
   Subscribable: true,
   subscriberCountNotifier: true,
   subscribeToSubscriberCountChanges: true,
@@ -49,6 +50,7 @@ var _exportNames = {
   useSafeGlobalSearchParams: true,
   getSafeRouter: true,
   getSafeCurrentPathname: true,
+  getSafeCurrentRoute: true,
   isExpoRouterAvailable: true,
   isPlainObjectUtil: true,
   useSafeAreaInsets: true,
@@ -78,8 +80,15 @@ var _exportNames = {
   LicenseEntryModal: true,
   ProBadge: true,
   ProUpgradeModal: true,
+  FreeAccountPrompt: true,
+  LOGIN_COMMAND: true,
   getUseIsPro: true,
-  getUseLicense: true
+  getUseLicense: true,
+  getUseTier: true,
+  TIER_LIMITS: true,
+  useLimit: true,
+  resolveEffectiveTier: true,
+  freeKeyRaises: true
 };
 Object.defineProperty(exports, "EnvironmentIndicator", {
   enumerable: true,
@@ -105,6 +114,12 @@ Object.defineProperty(exports, "FeatureGate", {
     return _index12.FeatureGate;
   }
 });
+Object.defineProperty(exports, "FreeAccountPrompt", {
+  enumerable: true,
+  get: function () {
+    return _index12.FreeAccountPrompt;
+  }
+});
 Object.defineProperty(exports, "HintsProvider", {
   enumerable: true,
   get: function () {
@@ -117,6 +132,12 @@ Object.defineProperty(exports, "JsModal", {
     return _JsModal.JsModal;
   }
 });
+Object.defineProperty(exports, "LOGIN_COMMAND", {
+  enumerable: true,
+  get: function () {
+    return _index12.LOGIN_COMMAND;
+  }
+});
 Object.defineProperty(exports, "LicenseEntryModal", {
   enumerable: true,
   get: function () {
@@ -153,6 +174,12 @@ Object.defineProperty(exports, "Subscribable", {
     return _index3.Subscribable;
   }
 });
+Object.defineProperty(exports, "TIER_LIMITS", {
+  enumerable: true,
+  get: function () {
+    return _index12.TIER_LIMITS;
+  }
+});
 Object.defineProperty(exports, "UpgradeModal", {
   enumerable: true,
   get: function () {
@@ -207,6 +234,12 @@ Object.defineProperty(exports, "formatValue", {
     return _index3.formatValue;
   }
 });
+Object.defineProperty(exports, "freeKeyRaises", {
+  enumerable: true,
+  get: function () {
+    return _index12.freeKeyRaises;
+  }
+});
 Object.defineProperty(exports, "gameUIColors", {
   enumerable: true,
   get: function () {
@@ -225,6 +258,12 @@ Object.defineProperty(exports, "getConstructorName", {
     return _index3.getConstructorName;
   }
 });
+Object.defineProperty(exports, "getDevServerOrigin", {
+  enumerable: true,
+  get: function () {
+    return _index3.getDevServerOrigin;
+  }
+});
 Object.defineProperty(exports, "getDeviceInfo", {
   enumerable: true,
   get: function () {
@@ -249,6 +288,12 @@ Object.defineProperty(exports, "getSafeCurrentPathname", {
     return _index3.getSafeCurrentPathname;
   }
 });
+Object.defineProperty(exports, "getSafeCurrentRoute", {
+  enumerable: true,
+  get: function () {
+    return _index3.getSafeCurrentRoute;
+  }
+});
 Object.defineProperty(exports, "getSafeRouter", {
   enumerable: true,
   get: function () {
@@ -291,6 +336,12 @@ Object.defineProperty(exports, "getUseLicense", {
     return _index12.getUseLicense;
   }
 });
+Object.defineProperty(exports, "getUseTier", {
+  enumerable: true,
+  get: function () {
+    return _index12.getUseTier;
+  }
+});
 Object.defineProperty(exports, "getValueSize", {
   enumerable: true,
   get: function () {
@@ -411,6 +462,12 @@ Object.defineProperty(exports, "reloadApp", {
     return _index3.reloadApp;
   }
 });
+Object.defineProperty(exports, "resolveEffectiveTier", {
+  enumerable: true,
+  get: function () {
+    return _index12.resolveEffectiveTier;
+  }
+});
 Object.defineProperty(exports, "resolveReloadStrategy", {
   enumerable: true,
   get: function () {
@@ -501,6 +558,12 @@ Object.defineProperty(exports, "useHintsDisabled", {
     return _index10.useHintsDisabled;
   }
 });
+Object.defineProperty(exports, "useLimit", {
+  enumerable: true,
+  get: function () {
+    return _index12.useLimit;
+  }
+});
 Object.defineProperty(exports, "usePersistedState", {
   enumerable: true,
   get: function () {

package/lib/commonjs/license/FeatureGate.js

@@ -11,6 +11,9 @@ var _gameUIColors = require("../ui/gameUI/constants/gameUIColors.js");
 var _lucideIcons = require("../icons/lucide-icons.js");
 var _LicenseEntryModal = require("./LicenseEntryModal.js");
 var _openPricing = require("./openPricing.js");
+var _FreeAccountPrompt = require("./FreeAccountPrompt.js");
+var _licenseModule = require("./licenseModule.js");
+var _tierLimits = require("./tierLimits.js");
 var _license = require("@buoy-gg/license");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
@@ -55,14 +58,19 @@ exports.ProBadge = ProBadge;
 const ProUpgradeModal = ({
   visible,
   onClose,
-  featureName = "This feature"
+  featureName = "This feature",
+  limitKey
 }) => {
   // Simple wrapper around UpgradeModal with minimal description and no benefits
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(UpgradeModal, {
     visible: visible,
     onClose: onClose,
-    featureName: featureName,
-    description: `${featureName} requires a Pro subscription.`
+    featureName: featureName
+    // Only meaningful when this upsell is about a LIMIT; without it the
+    // description below (which promises Pro) is the accurate message.
+    ,
+    limitKey: limitKey,
+    description: limitKey ? undefined : `${featureName} requires a Pro subscription.`
   });
 };
 exports.ProUpgradeModal = ProUpgradeModal;
@@ -73,9 +81,13 @@ exports.ProUpgradeModal = ProUpgradeModal;
 const UpgradePrompt = ({
   featureName,
   onUpgradePress,
-  compact = false
+  compact = false,
+  limitKey
 }) => {
   const [showLicenseModal, setShowLicenseModal] = (0, _react.useState)(false);
+  // Only offer the free key when it would actually raise this limit — see
+  // UpgradeModalProps.limitKey.
+  const isAnonymous = (0, _licenseModule.getUseTier)()() === "anonymous" && limitKey != null && (0, _tierLimits.freeKeyRaises)(limitKey);
   const handlePress = (0, _react.useCallback)(() => {
     if (onUpgradePress) {
       onUpgradePress();
@@ -103,7 +115,11 @@ const UpgradePrompt = ({
           style: styles.compactText,
           children: "PRO"
         })]
-      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_LicenseEntryModal.LicenseEntryModal, {
+      }), isAnonymous ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_FreeAccountPrompt.FreeAccountPrompt, {
+        visible: showLicenseModal,
+        onClose: handleCloseModal,
+        featureName: featureName
+      }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_LicenseEntryModal.LicenseEntryModal, {
         visible: showLicenseModal,
         onClose: handleCloseModal
       })]
@@ -120,23 +136,27 @@ const UpgradePrompt = ({
         })
       }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
         style: styles.title,
-        children: "Pro Feature"
+        children: isAnonymous ? "Get a free key" : "Pro Feature"
       }), featureName && /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
         style: styles.featureName,
         children: featureName
       }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
         style: styles.description,
-        children: "Upgrade to React Buoy Pro to unlock this feature and more."
+        children: isAnonymous ? "Buoy works without an account, with a small slice of each tool. A free key opens it up." : "Upgrade to React Buoy Pro to unlock this feature and more."
       }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
         style: styles.upgradeButton,
         onPress: handlePress,
         activeOpacity: 0.8,
         children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
           style: styles.upgradeButtonText,
-          children: "Upgrade to Pro"
+          children: isAnonymous ? "Get a free key" : "Upgrade to Pro"
         })
       })]
-    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_LicenseEntryModal.LicenseEntryModal, {
+    }), isAnonymous ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_FreeAccountPrompt.FreeAccountPrompt, {
+      visible: showLicenseModal,
+      onClose: handleCloseModal,
+      featureName: featureName
+    }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_LicenseEntryModal.LicenseEntryModal, {
       visible: showLicenseModal,
       onClose: handleCloseModal
     })]
@@ -317,8 +337,14 @@ const UpgradeModal = ({
   onClose,
   featureName = "This Feature",
   description,
-  benefits
+  benefits,
+  limitKey
 }) => {
+  // Anonymous users get a different ask — but ONLY when a free key would
+  // actually fix what they just hit. Everything else here is Pro-exclusive,
+  // where a free key changes nothing and offering one would be dishonest.
+  const tier = (0, _licenseModule.getUseTier)()();
+  const offerFreeKey = tier === "anonymous" && limitKey != null && (0, _tierLimits.freeKeyRaises)(limitKey);
   const hasBenefits = benefits && benefits.length > 0;
   const [showLicenseModal, setShowLicenseModal] = (0, _react.useState)(false);
   const license = (0, _license.useLicense)();
@@ -341,6 +367,13 @@ const UpgradeModal = ({
     onClose();
   }, [onClose]);
   if (!visible) return null;
+  if (offerFreeKey) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_FreeAccountPrompt.FreeAccountPrompt, {
+      visible: visible,
+      onClose: onClose,
+      featureName: featureName === "This Feature" ? undefined : featureName
+    });
+  }
   return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
     children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Modal, {
       visible: visible && !showLicenseModal,

package/lib/commonjs/license/FreeAccountPrompt.js

@@ -0,0 +1,181 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.LOGIN_COMMAND = exports.FreeAccountPrompt = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var _gameUIColors = require("../ui/gameUI/constants/gameUIColors.js");
+var _lucideIcons = require("../icons/lucide-icons.js");
+var _index = require("../clipboard/index.js");
+var _openPricing = require("./openPricing.js");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * The upsell an ANONYMOUS user sees — someone with no key at all.
+ *
+ * Deliberately not the Pro modal. Their next step is free and takes about
+ * thirty seconds, so asking them for money would be asking the wrong question
+ * at the wrong moment, and would suppress exactly the signup this exists to
+ * produce. Pro is still offered, as a secondary action.
+ *
+ * The command is shown inline and copyable rather than linked, because there is
+ * no grace period: someone who just watched their limits shrink needs the fix
+ * in front of them, not a link to a page that has a link to a command.
+ */
+
+/** The one thing a reader has to be able to act on. */
+const LOGIN_COMMAND = exports.LOGIN_COMMAND = "npx buoy login";
+const FreeAccountPrompt = ({
+  visible,
+  onClose,
+  featureName
+}) => {
+  const [copied, setCopied] = (0, _react.useState)(false);
+  const resetTimer = (0, _react.useRef)(null);
+  (0, _react.useEffect)(() => () => {
+    if (resetTimer.current) clearTimeout(resetTimer.current);
+  }, []);
+  const handleCopy = (0, _react.useCallback)(() => {
+    void (0, _index.copyToClipboard)(LOGIN_COMMAND).then(ok => {
+      if (!ok) return;
+      setCopied(true);
+      if (resetTimer.current) clearTimeout(resetTimer.current);
+      resetTimer.current = setTimeout(() => setCopied(false), 1500);
+    });
+  }, []);
+  if (!visible) return null;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Modal, {
+    visible: visible,
+    transparent: true,
+    animationType: "fade",
+    onRequestClose: onClose,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
+      style: styles.overlay,
+      onPress: onClose,
+      activeOpacity: 1,
+      children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.TouchableOpacity, {
+        style: styles.card,
+        activeOpacity: 1,
+        onPress: () => {},
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
+          style: styles.close,
+          onPress: onClose,
+          activeOpacity: 0.7,
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_lucideIcons.X, {
+            size: 18,
+            color: _gameUIColors.buoyColors.textMuted
+          })
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+          style: styles.title,
+          children: featureName ? `More ${featureName}` : "See more"
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+          style: styles.subtitle,
+          children: "Buoy runs without an account \u2014 you just get a small slice of each tool. A free key opens it up."
+        }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.TouchableOpacity, {
+          style: styles.command,
+          onPress: handleCopy,
+          activeOpacity: 0.7,
+          accessibilityLabel: `Copy ${LOGIN_COMMAND}`,
+          children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+            style: styles.commandText,
+            children: LOGIN_COMMAND
+          }), copied ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_lucideIcons.Check, {
+            size: 14,
+            color: _gameUIColors.buoyColors.success
+          }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_lucideIcons.Copy, {
+            size: 14,
+            color: _gameUIColors.buoyColors.textMuted
+          })]
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+          style: styles.reassure,
+          children: "Free forever. No card. About thirty seconds."
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
+          style: styles.secondary,
+          onPress: () => (0, _openPricing.openPricing)(),
+          activeOpacity: 0.8,
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+            style: styles.secondaryText,
+            children: "Or see Pro"
+          })
+        })]
+      })
+    })
+  });
+};
+exports.FreeAccountPrompt = FreeAccountPrompt;
+const styles = _reactNative.StyleSheet.create({
+  overlay: {
+    flex: 1,
+    backgroundColor: "rgba(0, 0, 0, 0.75)",
+    alignItems: "center",
+    justifyContent: "center",
+    padding: 20
+  },
+  card: {
+    backgroundColor: _gameUIColors.buoyColors.card,
+    borderRadius: 16,
+    borderWidth: 1,
+    borderColor: _gameUIColors.buoyColors.primary + "60",
+    padding: 24,
+    maxWidth: 340,
+    width: "100%",
+    position: "relative"
+  },
+  close: {
+    position: "absolute",
+    top: 12,
+    right: 12,
+    padding: 6,
+    zIndex: 1
+  },
+  title: {
+    fontSize: 20,
+    fontWeight: "700",
+    color: _gameUIColors.buoyColors.text,
+    textAlign: "center",
+    marginBottom: 8
+  },
+  subtitle: {
+    fontSize: 13,
+    lineHeight: 19,
+    color: _gameUIColors.buoyColors.textMuted,
+    textAlign: "center",
+    marginBottom: 20
+  },
+  command: {
+    flexDirection: "row",
+    alignItems: "center",
+    justifyContent: "space-between",
+    backgroundColor: _gameUIColors.buoyColors.base,
+    borderRadius: 8,
+    borderWidth: 1,
+    borderColor: _gameUIColors.buoyColors.border,
+    paddingHorizontal: 14,
+    paddingVertical: 12,
+    gap: 10
+  },
+  commandText: {
+    fontSize: 14,
+    fontWeight: "600",
+    color: _gameUIColors.buoyColors.text,
+    fontFamily: "monospace"
+  },
+  reassure: {
+    fontSize: 12,
+    color: _gameUIColors.buoyColors.textMuted,
+    textAlign: "center",
+    marginTop: 10
+  },
+  secondary: {
+    marginTop: 18,
+    paddingVertical: 10,
+    alignItems: "center"
+  },
+  secondaryText: {
+    fontSize: 13,
+    fontWeight: "600",
+    color: _gameUIColors.buoyColors.textMuted
+  }
+});

package/lib/commonjs/license/index.js

@@ -9,6 +9,18 @@ Object.defineProperty(exports, "FeatureGate", {
     return _FeatureGate.FeatureGate;
   }
 });
+Object.defineProperty(exports, "FreeAccountPrompt", {
+  enumerable: true,
+  get: function () {
+    return _FreeAccountPrompt.FreeAccountPrompt;
+  }
+});
+Object.defineProperty(exports, "LOGIN_COMMAND", {
+  enumerable: true,
+  get: function () {
+    return _FreeAccountPrompt.LOGIN_COMMAND;
+  }
+});
 Object.defineProperty(exports, "LicenseEntryModal", {
   enumerable: true,
   get: function () {
@@ -33,6 +45,12 @@ Object.defineProperty(exports, "ProUpgradeModal", {
     return _FeatureGate.ProUpgradeModal;
   }
 });
+Object.defineProperty(exports, "TIER_LIMITS", {
+  enumerable: true,
+  get: function () {
+    return _tierLimits.TIER_LIMITS;
+  }
+});
 Object.defineProperty(exports, "UpgradeModal", {
   enumerable: true,
   get: function () {
@@ -45,53 +63,50 @@ Object.defineProperty(exports, "UpgradePrompt", {
     return _FeatureGate.UpgradePrompt;
   }
 });
-exports.getUseIsPro = getUseIsPro;
-exports.getUseLicense = getUseLicense;
+Object.defineProperty(exports, "freeKeyRaises", {
+  enumerable: true,
+  get: function () {
+    return _tierLimits.freeKeyRaises;
+  }
+});
+Object.defineProperty(exports, "getUseIsPro", {
+  enumerable: true,
+  get: function () {
+    return _licenseModule.getUseIsPro;
+  }
+});
+Object.defineProperty(exports, "getUseLicense", {
+  enumerable: true,
+  get: function () {
+    return _licenseModule.getUseLicense;
+  }
+});
+Object.defineProperty(exports, "getUseTier", {
+  enumerable: true,
+  get: function () {
+    return _licenseModule.getUseTier;
+  }
+});
+Object.defineProperty(exports, "resolveEffectiveTier", {
+  enumerable: true,
+  get: function () {
+    return _tierLimits.resolveEffectiveTier;
+  }
+});
 Object.defineProperty(exports, "useFeatureGate", {
   enumerable: true,
   get: function () {
     return _FeatureGate.useFeatureGate;
   }
 });
+Object.defineProperty(exports, "useLimit", {
+  enumerable: true,
+  get: function () {
+    return _tierLimits.useLimit;
+  }
+});
 var _FeatureGate = require("./FeatureGate.js");
 var _LicenseEntryModal = require("./LicenseEntryModal.js");
-// Centralized lazy loading for license hooks to avoid duplication across packages
-// This is the SINGLE source of truth - all packages should import from here
-let _useIsPro = null;
-let _useLicense = null;
-let _licenseLoadAttempted = false;
-function loadLicenseModuleCentral() {
-  if (_licenseLoadAttempted) return;
-  _licenseLoadAttempted = true;
-  try {
-    const mod = require("@buoy-gg/license");
-    if (mod) {
-      _useIsPro = mod.useIsPro ?? null;
-      _useLicense = mod.useLicense ?? null;
-    }
-  } catch {
-    // License package not available - will use fallback
-  }
-}
-
-/**
- * Get the useIsPro hook from @buoy-gg/license
- * Falls back to () => false if license package is not available
- *
- * IMPORTANT: Use this instead of doing your own lazy loading in other packages
- */
-function getUseIsPro() {
-  loadLicenseModuleCentral();
-  return _useIsPro ?? (() => false);
-}
-
-/**
- * Get the useLicense hook from @buoy-gg/license
- * Returns null if license package is not available
- *
- * IMPORTANT: Use this instead of doing your own lazy loading in other packages
- */
-function getUseLicense() {
-  loadLicenseModuleCentral();
-  return _useLicense;
-}
+var _FreeAccountPrompt = require("./FreeAccountPrompt.js");
+var _licenseModule = require("./licenseModule.js");
+var _tierLimits = require("./tierLimits.js");

package/lib/commonjs/license/licenseModule.js

@@ -0,0 +1,99 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getUseIsPro = getUseIsPro;
+exports.getUseLicense = getUseLicense;
+exports.getUseTier = getUseTier;
+exports.isAnonymousTierEnabled = isAnonymousTierEnabled;
+/**
+ * Centralized lazy loading of `@buoy-gg/license`.
+ *
+ * This is the SINGLE place any package resolves license hooks — tools must not
+ * `require("@buoy-gg/license")` themselves. Lives in its own module (rather
+ * than `./index`) so `tierLimits` can consume it without an import cycle.
+ */
+
+/** Access tier. Mirrors BuoyTier in @buoy-gg/license. */
+
+let _useIsPro = null;
+let _useLicense = null;
+let _useTier = null;
+let _anonymousTierEnabled = null;
+let _licenseLoadAttempted = false;
+function loadLicenseModuleCentral() {
+  if (_licenseLoadAttempted) return;
+  _licenseLoadAttempted = true;
+  try {
+    const mod = require("@buoy-gg/license");
+    if (mod) {
+      _useIsPro = mod.useIsPro ?? null;
+      _useLicense = mod.useLicense ?? null;
+      _useTier = mod.useTier ?? null;
+      _anonymousTierEnabled = typeof mod.ANONYMOUS_TIER_ENABLED === "boolean" ? mod.ANONYMOUS_TIER_ENABLED : null;
+    }
+  } catch {
+    // License package not available - will use fallback
+  }
+}
+
+/**
+ * Get the useIsPro hook from @buoy-gg/license.
+ * Falls back to () => false if the license package is not available.
+ *
+ * IMPORTANT: Use this instead of doing your own lazy loading in other packages
+ */
+function getUseIsPro() {
+  loadLicenseModuleCentral();
+  return _useIsPro ?? (() => false);
+}
+
+/**
+ * Get the useLicense hook from @buoy-gg/license.
+ * Returns null if the license package is not available.
+ *
+ * IMPORTANT: Use this instead of doing your own lazy loading in other packages
+ */
+function getUseLicense() {
+  loadLicenseModuleCentral();
+  return _useLicense;
+}
+
+/**
+ * Get the useTier hook from @buoy-gg/license.
+ *
+ * Falls back to `"free"` — NOT `"anonymous"` — when the license package can't
+ * be resolved. That deliberately matches the existing `getUseIsPro()` fallback,
+ * which yields free-tier behavior today, and it picks the safer failure:
+ *
+ *  - falling back to "anonymous" would let one bundler quirk silently cut every
+ *    legitimate user's limits by ~80%;
+ *  - falling back to "free" costs no revenue, because Pro still requires a key
+ *    that a live license server validated — this path can never grant Pro.
+ *
+ * Reaching it at all requires `@buoy-gg/license` to be missing, and it is a
+ * hard dependency of `@buoy-gg/core`.
+ */
+function getUseTier() {
+  loadLicenseModuleCentral();
+  return _useTier ?? (() => "free");
+}
+
+/**
+ * Whether the anonymous tier is switched on.
+ *
+ * The switch itself lives in @buoy-gg/license (see its config.ts) because the
+ * Weekend Pass change has to flip at the same moment as the reduced limits, and
+ * those live in different packages. Read through the same lazy loader as the
+ * hooks so a missing license package degrades gracefully rather than throwing
+ * at module load.
+ *
+ * Falls back to `false` — the anonymous tier off, everyone on free limits —
+ * which matches the `getUseTier()` fallback of "free". A build that cannot
+ * resolve the license package must never take limits AWAY from someone.
+ */
+function isAnonymousTierEnabled() {
+  loadLicenseModuleCentral();
+  return _anonymousTierEnabled ?? false;
+}