@buoy-gg/license 3.0.1 → 4.0.1

package/lib/commonjs/hooks.js

@@ -6,8 +6,10 @@ Object.defineProperty(exports, "__esModule", {
 exports.useFeatureAccess = useFeatureAccess;
 exports.useIsPro = useIsPro;
 exports.useLicense = useLicense;
+exports.useProAccess = useProAccess;
 var _react = require("react");
 var _LicenseManager = require("./LicenseManager.js");
+var _weekendPro = require("./weekendPro.js");
 /**
  * React hooks for license management
  *
@@ -15,6 +17,13 @@ var _LicenseManager = require("./LicenseManager.js");
  * We trust our customers.
  */
 
+/**
+ * Why the user currently has Pro access:
+ *   - "licensed" → a real, validated license key
+ *   - "weekend"  → the free Weekend Pass (no license)
+ *   - null       → no access
+ */
+
 /**
  * Hook to access the current license state
  *
@@ -78,12 +87,35 @@ function useFeatureAccess(featureCode) {
 }
 
 /**
- * Hook that returns true only when Pro and not loading
+ * Hook that returns true when the user has Pro access — either a validated
+ * license OR the free Weekend Pass (Pro is free for everyone on weekends).
  */
 function useIsPro() {
   const {
     isPro,
     isInitialized
   } = useLicense();
-  return isInitialized && isPro;
+  const weekendFree = (0, _weekendPro.useWeekendFreePro)();
+  return isInitialized && isPro || weekendFree;
+}
+
+/**
+ * Like {@link useIsPro} but also reports WHY access is granted, so badges can
+ * show "PRO" for a real license vs the "Weekend Pass" badge for the free
+ * weekend unlock.
+ */
+function useProAccess() {
+  const {
+    isPro,
+    isInitialized
+  } = useLicense();
+  const isLicensed = isInitialized && isPro;
+  const isWeekendFree = (0, _weekendPro.useWeekendFreePro)();
+  const reason = isLicensed ? "licensed" : isWeekendFree ? "weekend" : null;
+  return {
+    isPro: isLicensed || isWeekendFree,
+    isLicensed,
+    isWeekendFree,
+    reason
+  };
 }

package/lib/commonjs/index.js

@@ -17,6 +17,12 @@ Object.defineProperty(exports, "LicenseManager", {
 });
 exports.hasEntitlement = hasEntitlement;
 exports.isPro = isPro;
+Object.defineProperty(exports, "isWeekendFreePro", {
+  enumerable: true,
+  get: function () {
+    return _weekendPro.isWeekendFreePro;
+  }
+});
 exports.setLicenseKey = setLicenseKey;
 Object.defineProperty(exports, "useFeatureAccess", {
   enumerable: true,
@@ -36,9 +42,22 @@ Object.defineProperty(exports, "useLicense", {
     return _hooks.useLicense;
   }
 });
+Object.defineProperty(exports, "useProAccess", {
+  enumerable: true,
+  get: function () {
+    return _hooks.useProAccess;
+  }
+});
+Object.defineProperty(exports, "useWeekendFreePro", {
+  enumerable: true,
+  get: function () {
+    return _weekendPro.useWeekendFreePro;
+  }
+});
 var _LicenseManager = require("./LicenseManager.js");
 var _DeviceRegistrationModal = require("./DeviceRegistrationModal.js");
 var _hooks = require("./hooks.js");
+var _weekendPro = require("./weekendPro.js");
 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); } /**
  * @buoy-gg/license
  *
@@ -50,6 +69,7 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
  */ // Main manager
 // Device registration UI
 // React hooks
+// Weekend Pass — Pro is free for everyone on weekends
 // Types
 
 // Convenience function for setting license key
@@ -61,16 +81,24 @@ async function setLicenseKey(key) {
   return LM.setLicenseKey(key);
 }
 
-// Convenience function for checking Pro status
+// Convenience function for checking Pro status (honors the free Weekend Pass)
 function isPro() {
+  const {
+    isWeekendFreePro: isWeekend
+  } = require("./weekendPro");
+  if (isWeekend()) return true;
   const {
     LicenseManager: LM
   } = require("./LicenseManager");
   return LM.isPro();
 }
 
-// Convenience function for checking entitlement
+// Convenience function for checking entitlement (honors the free Weekend Pass)
 function hasEntitlement(code) {
+  const {
+    isWeekendFreePro: isWeekend
+  } = require("./weekendPro");
+  if (isWeekend()) return true;
   const {
     LicenseManager: LM
   } = require("./LicenseManager");

package/lib/commonjs/index.web.js

@@ -11,6 +11,12 @@ Object.defineProperty(exports, "LicenseManager", {
 });
 exports.hasEntitlement = hasEntitlement;
 exports.isPro = isPro;
+Object.defineProperty(exports, "isWeekendFreePro", {
+  enumerable: true,
+  get: function () {
+    return _weekendPro.isWeekendFreePro;
+  }
+});
 exports.setLicenseKey = setLicenseKey;
 Object.defineProperty(exports, "useFeatureAccess", {
   enumerable: true,
@@ -30,8 +36,21 @@ Object.defineProperty(exports, "useLicense", {
     return _hooks.useLicense;
   }
 });
+Object.defineProperty(exports, "useProAccess", {
+  enumerable: true,
+  get: function () {
+    return _hooks.useProAccess;
+  }
+});
+Object.defineProperty(exports, "useWeekendFreePro", {
+  enumerable: true,
+  get: function () {
+    return _weekendPro.useWeekendFreePro;
+  }
+});
 var _LicenseManager = require("./LicenseManager.js");
 var _hooks = require("./hooks.js");
+var _weekendPro = require("./weekendPro.js");
 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); } /**
  * @buoy-gg/license (Web/Electron)
  *
@@ -42,6 +61,7 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
  * Keygen tracks validation calls for usage analytics.
  */ // Main manager
 // React hooks
+// Weekend Pass — Pro is free for everyone on weekends
 // Types
 
 // Convenience function for setting license key
@@ -53,16 +73,24 @@ async function setLicenseKey(key) {
   return LM.setLicenseKey(key);
 }
 
-// Convenience function for checking Pro status
+// Convenience function for checking Pro status (honors the free Weekend Pass)
 function isPro() {
+  const {
+    isWeekendFreePro: isWeekend
+  } = require("./weekendPro");
+  if (isWeekend()) return true;
   const {
     LicenseManager: LM
   } = require("./LicenseManager");
   return LM.isPro();
 }
 
-// Convenience function for checking entitlement
+// Convenience function for checking entitlement (honors the free Weekend Pass)
 function hasEntitlement(code) {
+  const {
+    isWeekendFreePro: isWeekend
+  } = require("./weekendPro");
+  if (isWeekend()) return true;
   const {
     LicenseManager: LM
   } = require("./LicenseManager");

package/lib/commonjs/weekendPro.js

@@ -0,0 +1,43 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isWeekendFreePro = isWeekendFreePro;
+exports.useWeekendFreePro = useWeekendFreePro;
+var _react = require("react");
+/**
+ * Weekend Pass — Pro is free for everyone on weekends.
+ *
+ * A no-strings way to let people try Pro on their personal projects (most
+ * folks don't work weekends, so it's great for side projects but not the
+ * Mon–Fri day job). Evaluated in LOCAL time: active all of Saturday & Sunday.
+ *
+ * This is intentionally tiny and dependency-free so it can be shared by every
+ * `useIsPro()` gate without pulling in extra packages.
+ */
+
+/** Whether the Weekend Pass is active right now (local Saturday or Sunday). */
+function isWeekendFreePro(now = new Date()) {
+  const day = now.getDay(); // 0 = Sunday … 6 = Saturday
+  return day === 0 || day === 6;
+}
+
+/**
+ * Reactive Weekend Pass flag — re-renders the moment the weekend window opens
+ * or closes (re-checks every minute) so a long-running session flips at
+ * midnight without a reload.
+ */
+function useWeekendFreePro() {
+  const [active, setActive] = (0, _react.useState)(() => isWeekendFreePro());
+  (0, _react.useEffect)(() => {
+    const id = setInterval(() => {
+      const next = isWeekendFreePro();
+      // Functional update returns the same reference when unchanged, so React
+      // bails out of the re-render — the interval is effectively free.
+      setActive(prev => prev === next ? prev : next);
+    }, 60 * 1000);
+    return () => clearInterval(id);
+  }, []);
+  return active;
+}

package/lib/module/hooks.js

@@ -9,6 +9,15 @@
 
 import { useState, useEffect, useCallback } from "react";
 import { LicenseManager } from "./LicenseManager.js";
+import { useWeekendFreePro } from "./weekendPro.js";
+
+/**
+ * Why the user currently has Pro access:
+ *   - "licensed" → a real, validated license key
+ *   - "weekend"  → the free Weekend Pass (no license)
+ *   - null       → no access
+ */
+
 /**
  * Hook to access the current license state
  *
@@ -72,12 +81,35 @@ export function useFeatureAccess(featureCode) {
 }
 
 /**
- * Hook that returns true only when Pro and not loading
+ * Hook that returns true when the user has Pro access — either a validated
+ * license OR the free Weekend Pass (Pro is free for everyone on weekends).
  */
 export function useIsPro() {
   const {
     isPro,
     isInitialized
   } = useLicense();
-  return isInitialized && isPro;
+  const weekendFree = useWeekendFreePro();
+  return isInitialized && isPro || weekendFree;
+}
+
+/**
+ * Like {@link useIsPro} but also reports WHY access is granted, so badges can
+ * show "PRO" for a real license vs the "Weekend Pass" badge for the free
+ * weekend unlock.
+ */
+export function useProAccess() {
+  const {
+    isPro,
+    isInitialized
+  } = useLicense();
+  const isLicensed = isInitialized && isPro;
+  const isWeekendFree = useWeekendFreePro();
+  const reason = isLicensed ? "licensed" : isWeekendFree ? "weekend" : null;
+  return {
+    isPro: isLicensed || isWeekendFree,
+    isLicensed,
+    isWeekendFree,
+    reason
+  };
 }

package/lib/module/index.js

@@ -16,7 +16,9 @@ export { LicenseManager } from "./LicenseManager.js";
 export { DeviceRegistrationModal } from "./DeviceRegistrationModal.js";
 
 // React hooks
-export { useLicense, useFeatureAccess, useIsPro } from "./hooks.js";
+export { useLicense, useFeatureAccess, useIsPro, useProAccess } from "./hooks.js";
+// Weekend Pass — Pro is free for everyone on weekends
+export { isWeekendFreePro, useWeekendFreePro } from "./weekendPro.js";
 
 // Types
 
@@ -29,16 +31,24 @@ export async function setLicenseKey(key) {
   return LM.setLicenseKey(key);
 }
 
-// Convenience function for checking Pro status
+// Convenience function for checking Pro status (honors the free Weekend Pass)
 export function isPro() {
+  const {
+    isWeekendFreePro: isWeekend
+  } = require("./weekendPro");
+  if (isWeekend()) return true;
   const {
     LicenseManager: LM
   } = require("./LicenseManager");
   return LM.isPro();
 }
 
-// Convenience function for checking entitlement
+// Convenience function for checking entitlement (honors the free Weekend Pass)
 export function hasEntitlement(code) {
+  const {
+    isWeekendFreePro: isWeekend
+  } = require("./weekendPro");
+  if (isWeekend()) return true;
   const {
     LicenseManager: LM
   } = require("./LicenseManager");

package/lib/module/index.web.js

@@ -14,7 +14,9 @@
 export { LicenseManager } from "./LicenseManager.js";
 
 // React hooks
-export { useLicense, useFeatureAccess, useIsPro } from "./hooks.js";
+export { useLicense, useFeatureAccess, useIsPro, useProAccess } from "./hooks.js";
+// Weekend Pass — Pro is free for everyone on weekends
+export { isWeekendFreePro, useWeekendFreePro } from "./weekendPro.js";
 
 // Types
 
@@ -27,16 +29,24 @@ export async function setLicenseKey(key) {
   return LM.setLicenseKey(key);
 }
 
-// Convenience function for checking Pro status
+// Convenience function for checking Pro status (honors the free Weekend Pass)
 export function isPro() {
+  const {
+    isWeekendFreePro: isWeekend
+  } = require("./weekendPro");
+  if (isWeekend()) return true;
   const {
     LicenseManager: LM
   } = require("./LicenseManager");
   return LM.isPro();
 }
 
-// Convenience function for checking entitlement
+// Convenience function for checking entitlement (honors the free Weekend Pass)
 export function hasEntitlement(code) {
+  const {
+    isWeekendFreePro: isWeekend
+  } = require("./weekendPro");
+  if (isWeekend()) return true;
   const {
     LicenseManager: LM
   } = require("./LicenseManager");

package/lib/module/weekendPro.js

@@ -0,0 +1,39 @@
+"use strict";
+
+/**
+ * Weekend Pass — Pro is free for everyone on weekends.
+ *
+ * A no-strings way to let people try Pro on their personal projects (most
+ * folks don't work weekends, so it's great for side projects but not the
+ * Mon–Fri day job). Evaluated in LOCAL time: active all of Saturday & Sunday.
+ *
+ * This is intentionally tiny and dependency-free so it can be shared by every
+ * `useIsPro()` gate without pulling in extra packages.
+ */
+
+import { useEffect, useState } from "react";
+
+/** Whether the Weekend Pass is active right now (local Saturday or Sunday). */
+export function isWeekendFreePro(now = new Date()) {
+  const day = now.getDay(); // 0 = Sunday … 6 = Saturday
+  return day === 0 || day === 6;
+}
+
+/**
+ * Reactive Weekend Pass flag — re-renders the moment the weekend window opens
+ * or closes (re-checks every minute) so a long-running session flips at
+ * midnight without a reload.
+ */
+export function useWeekendFreePro() {
+  const [active, setActive] = useState(() => isWeekendFreePro());
+  useEffect(() => {
+    const id = setInterval(() => {
+      const next = isWeekendFreePro();
+      // Functional update returns the same reference when unchanged, so React
+      // bails out of the re-render — the interval is effectively free.
+      setActive(prev => prev === next ? prev : next);
+    }, 60 * 1000);
+    return () => clearInterval(id);
+  }, []);
+  return active;
+}

package/lib/typescript/commonjs/hooks.d.ts

@@ -5,6 +5,13 @@
  * We trust our customers.
  */
 import type { LicenseState } from "./types";
+/**
+ * Why the user currently has Pro access:
+ *   - "licensed" → a real, validated license key
+ *   - "weekend"  → the free Weekend Pass (no license)
+ *   - null       → no access
+ */
+export type ProAccessReason = "licensed" | "weekend" | null;
 /**
  * Hook to access the current license state
  *
@@ -34,7 +41,22 @@ export declare function useFeatureAccess(featureCode?: string): {
     isLoading: boolean;
 };
 /**
- * Hook that returns true only when Pro and not loading
+ * Hook that returns true when the user has Pro access — either a validated
+ * license OR the free Weekend Pass (Pro is free for everyone on weekends).
  */
 export declare function useIsPro(): boolean;
+/**
+ * Like {@link useIsPro} but also reports WHY access is granted, so badges can
+ * show "PRO" for a real license vs the "Weekend Pass" badge for the free
+ * weekend unlock.
+ */
+export declare function useProAccess(): {
+    /** True if the user has Pro access for any reason. */
+    isPro: boolean;
+    /** True only for a real, validated license. */
+    isLicensed: boolean;
+    /** True only for the free Weekend Pass. */
+    isWeekendFree: boolean;
+    reason: ProAccessReason;
+};
 //# sourceMappingURL=hooks.d.ts.map

package/lib/typescript/commonjs/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,SAAS,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,IAAI,YAAY,GAAG;IAC3C,qCAAqC;IACrC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,gCAAgC;IAChC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC,CAiCA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB,CAWA;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAGlC"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,SAAS,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,IAAI,YAAY,GAAG;IAC3C,qCAAqC;IACrC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,gCAAgC;IAChC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC,CAiCA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB,CAWA;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAIlC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI;IAC9B,sDAAsD;IACtD,KAAK,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,UAAU,EAAE,OAAO,CAAC;IACpB,2CAA2C;IAC3C,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;CACzB,CAUA"}

package/lib/typescript/commonjs/index.d.ts

@@ -10,7 +10,9 @@
 export { LicenseManager } from "./LicenseManager";
 export type { DeviceRegistrationInfo, DeviceRegistrationCallback, } from "./LicenseManager";
 export { DeviceRegistrationModal } from "./DeviceRegistrationModal";
-export { useLicense, useFeatureAccess, useIsPro } from "./hooks";
+export { useLicense, useFeatureAccess, useIsPro, useProAccess } from "./hooks";
+export type { ProAccessReason } from "./hooks";
+export { isWeekendFreePro, useWeekendFreePro } from "./weekendPro";
 export type { LicenseState, LicenseEvent, LicenseListener, LicenseValidationResult, CachedLicense, } from "./types";
 export declare function setLicenseKey(key: string): Promise<boolean>;
 export declare function isPro(): boolean;

package/lib/typescript/commonjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGjE,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIjE;AAGD,wBAAgB,KAAK,IAAI,OAAO,CAG/B;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/E,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGnE,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIjE;AAGD,wBAAgB,KAAK,IAAI,OAAO,CAK/B;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKpD"}

package/lib/typescript/commonjs/index.web.d.ts

@@ -8,7 +8,9 @@
  * Keygen tracks validation calls for usage analytics.
  */
 export { LicenseManager } from "./LicenseManager";
-export { useLicense, useFeatureAccess, useIsPro } from "./hooks";
+export { useLicense, useFeatureAccess, useIsPro, useProAccess } from "./hooks";
+export type { ProAccessReason } from "./hooks";
+export { isWeekendFreePro, useWeekendFreePro } from "./weekendPro";
 export type { LicenseState, LicenseEvent, LicenseListener, LicenseValidationResult, CachedLicense, } from "./types";
 export declare function setLicenseKey(key: string): Promise<boolean>;
 export declare function isPro(): boolean;

package/lib/typescript/commonjs/index.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../src/index.web.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGjE,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIjE;AAGD,wBAAgB,KAAK,IAAI,OAAO,CAG/B;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD"}
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../src/index.web.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/E,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGnE,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIjE;AAGD,wBAAgB,KAAK,IAAI,OAAO,CAK/B;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKpD"}

package/lib/typescript/commonjs/weekendPro.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Weekend Pass — Pro is free for everyone on weekends.
+ *
+ * A no-strings way to let people try Pro on their personal projects (most
+ * folks don't work weekends, so it's great for side projects but not the
+ * Mon–Fri day job). Evaluated in LOCAL time: active all of Saturday & Sunday.
+ *
+ * This is intentionally tiny and dependency-free so it can be shared by every
+ * `useIsPro()` gate without pulling in extra packages.
+ */
+/** Whether the Weekend Pass is active right now (local Saturday or Sunday). */
+export declare function isWeekendFreePro(now?: Date): boolean;
+/**
+ * Reactive Weekend Pass flag — re-renders the moment the weekend window opens
+ * or closes (re-checks every minute) so a long-running session flips at
+ * midnight without a reload.
+ */
+export declare function useWeekendFreePro(): boolean;
+//# sourceMappingURL=weekendPro.d.ts.map

package/lib/typescript/commonjs/weekendPro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekendPro.d.ts","sourceRoot":"","sources":["../../../src/weekendPro.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,IAAiB,GAAG,OAAO,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAY3C"}

package/lib/typescript/module/hooks.d.ts

@@ -5,6 +5,13 @@
  * We trust our customers.
  */
 import type { LicenseState } from "./types";
+/**
+ * Why the user currently has Pro access:
+ *   - "licensed" → a real, validated license key
+ *   - "weekend"  → the free Weekend Pass (no license)
+ *   - null       → no access
+ */
+export type ProAccessReason = "licensed" | "weekend" | null;
 /**
  * Hook to access the current license state
  *
@@ -34,7 +41,22 @@ export declare function useFeatureAccess(featureCode?: string): {
     isLoading: boolean;
 };
 /**
- * Hook that returns true only when Pro and not loading
+ * Hook that returns true when the user has Pro access — either a validated
+ * license OR the free Weekend Pass (Pro is free for everyone on weekends).
  */
 export declare function useIsPro(): boolean;
+/**
+ * Like {@link useIsPro} but also reports WHY access is granted, so badges can
+ * show "PRO" for a real license vs the "Weekend Pass" badge for the free
+ * weekend unlock.
+ */
+export declare function useProAccess(): {
+    /** True if the user has Pro access for any reason. */
+    isPro: boolean;
+    /** True only for a real, validated license. */
+    isLicensed: boolean;
+    /** True only for the free Weekend Pass. */
+    isWeekendFree: boolean;
+    reason: ProAccessReason;
+};
 //# sourceMappingURL=hooks.d.ts.map

package/lib/typescript/module/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,SAAS,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,IAAI,YAAY,GAAG;IAC3C,qCAAqC;IACrC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,gCAAgC;IAChC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC,CAiCA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB,CAWA;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAGlC"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,SAAS,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,IAAI,YAAY,GAAG;IAC3C,qCAAqC;IACrC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,gCAAgC;IAChC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC,CAiCA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB,CAWA;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAIlC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI;IAC9B,sDAAsD;IACtD,KAAK,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,UAAU,EAAE,OAAO,CAAC;IACpB,2CAA2C;IAC3C,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;CACzB,CAUA"}

package/lib/typescript/module/index.d.ts

@@ -10,7 +10,9 @@
 export { LicenseManager } from "./LicenseManager";
 export type { DeviceRegistrationInfo, DeviceRegistrationCallback, } from "./LicenseManager";
 export { DeviceRegistrationModal } from "./DeviceRegistrationModal";
-export { useLicense, useFeatureAccess, useIsPro } from "./hooks";
+export { useLicense, useFeatureAccess, useIsPro, useProAccess } from "./hooks";
+export type { ProAccessReason } from "./hooks";
+export { isWeekendFreePro, useWeekendFreePro } from "./weekendPro";
 export type { LicenseState, LicenseEvent, LicenseListener, LicenseValidationResult, CachedLicense, } from "./types";
 export declare function setLicenseKey(key: string): Promise<boolean>;
 export declare function isPro(): boolean;

package/lib/typescript/module/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGjE,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIjE;AAGD,wBAAgB,KAAK,IAAI,OAAO,CAG/B;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/E,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGnE,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIjE;AAGD,wBAAgB,KAAK,IAAI,OAAO,CAK/B;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKpD"}

package/lib/typescript/module/index.web.d.ts

@@ -8,7 +8,9 @@
  * Keygen tracks validation calls for usage analytics.
  */
 export { LicenseManager } from "./LicenseManager";
-export { useLicense, useFeatureAccess, useIsPro } from "./hooks";
+export { useLicense, useFeatureAccess, useIsPro, useProAccess } from "./hooks";
+export type { ProAccessReason } from "./hooks";
+export { isWeekendFreePro, useWeekendFreePro } from "./weekendPro";
 export type { LicenseState, LicenseEvent, LicenseListener, LicenseValidationResult, CachedLicense, } from "./types";
 export declare function setLicenseKey(key: string): Promise<boolean>;
 export declare function isPro(): boolean;

package/lib/typescript/module/index.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../src/index.web.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGjE,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIjE;AAGD,wBAAgB,KAAK,IAAI,OAAO,CAG/B;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD"}
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../src/index.web.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/E,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGnE,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIjE;AAGD,wBAAgB,KAAK,IAAI,OAAO,CAK/B;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKpD"}

package/lib/typescript/module/weekendPro.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Weekend Pass — Pro is free for everyone on weekends.
+ *
+ * A no-strings way to let people try Pro on their personal projects (most
+ * folks don't work weekends, so it's great for side projects but not the
+ * Mon–Fri day job). Evaluated in LOCAL time: active all of Saturday & Sunday.
+ *
+ * This is intentionally tiny and dependency-free so it can be shared by every
+ * `useIsPro()` gate without pulling in extra packages.
+ */
+/** Whether the Weekend Pass is active right now (local Saturday or Sunday). */
+export declare function isWeekendFreePro(now?: Date): boolean;
+/**
+ * Reactive Weekend Pass flag — re-renders the moment the weekend window opens
+ * or closes (re-checks every minute) so a long-running session flips at
+ * midnight without a reload.
+ */
+export declare function useWeekendFreePro(): boolean;
+//# sourceMappingURL=weekendPro.d.ts.map

package/lib/typescript/module/weekendPro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekendPro.d.ts","sourceRoot":"","sources":["../../../src/weekendPro.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,IAAiB,GAAG,OAAO,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAY3C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/license",
-  "version": "3.0.1",
+  "version": "4.0.1",
   "description": "License validation for React Buoy Pro features",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",