@voltro/plugin-licensing 0.81.0 → 0.83.0

package/THIRD-PARTY-NOTICES.md

@@ -4551,7 +4551,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## undici@8.10.0
+## undici@8.11.2
 
 License: MIT
 

package/dist/index.d.ts

@@ -38,10 +38,10 @@ export declare interface LicenseClaims {
 
 export declare const LicenseService: Tag<LicenseServiceShape, LicenseServiceShape>;
 
-/** The service handlers can `yield*` to read the current license directly (for
- *  feature checks beyond billing's metered entitlements). */
 export declare interface LicenseServiceShape {
     readonly snapshot: () => LicenseSnapshot | undefined;
+    /** Where the installation stands with its license — see {@link LicenseStatus}. */
+    readonly status: () => LicenseStatus;
     readonly limitFor: (tenantId: string | null | undefined, key: string) => number | undefined;
     readonly hasFeature: (feature: string) => boolean;
     readonly allowsPlugin: (plugin: string) => boolean;
@@ -62,8 +62,43 @@ export declare interface LicenseSnapshot {
     /** Whether a plugin is licensed for production use (name without the
      *  `@voltro/plugin-` prefix, e.g. `'storage'`). The "installed ≠ billable" gate. */
     readonly allowsPlugin: (plugin: string) => boolean;
+    /** `active` until `exp`, `grace` while an expired license is still honored,
+     *  `expired` after — when `limitFor` and the rest go dark. */
+    readonly state: () => 'active' | 'grace' | 'expired';
 }
 
+/** The service handlers can `yield*` to read the current license directly (for
+ *  feature checks beyond billing's metered entitlements). */
+/**
+ * Where the installation stands with its license, for an operator's screen:
+ * `none` — no license configured; `active` / `grace` / `expired` — the
+ * installed one, by its expiry and the grace period; `rejected` — the license
+ * offered did not verify (a last good one, if any, still reports its own
+ * state in `installed`).
+ */
+export declare type LicenseStatus = {
+    readonly state: 'none';
+} | {
+    readonly state: 'active' | 'grace' | 'expired';
+    readonly edition: string;
+    /** Unix seconds; 0 for a license that does not expire. */
+    readonly expiresAt: number;
+    /** The tenant a tenant-scoped license applies to. */
+    readonly tenant?: string;
+} | {
+    readonly state: 'rejected';
+    readonly reason: LicenseVerifyError['reason'];
+    readonly message: string;
+    readonly installed?: {
+        readonly state: 'active' | 'grace' | 'expired';
+        readonly edition: string;
+        readonly expiresAt: number;
+    };
+};
+
+/** The current {@link LicenseStatus}, read from the in-memory snapshot and the last refusal. */
+export declare const licenseStatus: () => LicenseStatus;
+
 export declare class LicenseVerifyError extends LicenseVerifyError_base<{
     /** `expired` — past `exp`; `invalid` — bad signature; `key` — unusable public
      *  key; `malformed` — verified but the payload isn't a license. */

package/dist/index.js

@@ -56,6 +56,7 @@ var c = class extends e.TaggedError("LicenseVerifyError") {}, l = (e) => typeof
 	let n = new Set(e.features), r = new Set(e.plugins), i = t.graceSeconds ?? 0, a = t.now ?? (() => Date.now() / 1e3), o = () => e.exp <= 0 || a() <= e.exp + i;
 	return {
 		claims: e,
+		state: () => e.exp <= 0 || a() <= e.exp ? "active" : o() ? "grace" : "expired",
 		limitFor: (t, n) => {
 			if (!o() || e.tenant !== void 0 && e.tenant !== t) return;
 			let r = e.entitlements[n];
@@ -66,10 +67,29 @@ var c = class extends e.TaggedError("LicenseVerifyError") {}, l = (e) => typeof
 	};
 }, h, g = (e) => {
 	h = e;
-}, _ = () => h, v = (e, n) => t.sync(() => {
+}, _ = () => h, v, y = (e) => {
+	v = e;
+}, b = () => v, x = (e, n) => t.sync(() => {
 	let t = _()?.limitFor(e, n);
 	return t === void 0 ? null : t;
-}), y = a([{
+}), S = () => {
+	let e = _(), t = e === void 0 ? void 0 : {
+		state: e.state(),
+		edition: e.claims.edition,
+		expiresAt: e.claims.exp,
+		...e.claims.tenant === void 0 ? {} : { tenant: e.claims.tenant }
+	}, n = b();
+	return n === void 0 ? t ?? { state: "none" } : {
+		state: "rejected",
+		reason: n.reason,
+		message: n.message,
+		...t === void 0 ? {} : { installed: {
+			state: t.state,
+			edition: t.edition,
+			expiresAt: t.expiresAt
+		} }
+	};
+}, C = a([{
 	name: "VOLTRO_LICENSE_PUBLIC_KEY",
 	required: !1,
 	secret: !1,
@@ -79,23 +99,27 @@ var c = class extends e.TaggedError("LicenseVerifyError") {}, l = (e) => typeof
 	required: !1,
 	secret: !1,
 	description: "The signed EdDSA license token, verified offline at boot."
-}]), { Tag: b, Live: x } = r("@voltro/plugin-licensing/LicenseService", {
+}]), { Tag: w, Live: T } = r("@voltro/plugin-licensing/LicenseService", {
 	snapshot: () => _(),
+	status: () => S(),
 	limitFor: (e, t) => _()?.limitFor(e, t),
 	hasFeature: (e) => _()?.hasFeature(e) ?? !1,
 	allowsPlugin: (e) => _()?.allowsPlugin(e) ?? !1,
 	edition: () => _()?.claims.edition
-}), S = class extends e.TaggedError("PluginNotLicensed") {}, C = (e) => _()?.allowsPlugin(e) ?? !1, w = (e) => C(e) ? t.void : t.fail(new S({ plugin: e })), T = (e = {}) => {
-	let r = y.read("VOLTRO_LICENSE_PUBLIC_KEY", e.publicKey), a = y.read("VOLTRO_LICENSE_KEY", e.licenseKey), o = e.graceSeconds ?? 0, s = e.refreshMs ?? 9e5, c, l = (e, n) => p(e, n).pipe(t.match({
+}), E = class extends e.TaggedError("PluginNotLicensed") {}, D = (e) => _()?.allowsPlugin(e) ?? !1, O = (e) => D(e) ? t.void : t.fail(new E({ plugin: e })), k = (e = {}) => {
+	let r = C.read("VOLTRO_LICENSE_PUBLIC_KEY", e.publicKey), a = C.read("VOLTRO_LICENSE_KEY", e.licenseKey), o = e.graceSeconds ?? 0, s = e.refreshMs ?? 9e5, c, l = (e, n) => p(e, n).pipe(t.match({
 		onSuccess: (e) => {
-			g(m(e, { graceSeconds: o })), c?.info("license active", {
+			g(m(e, { graceSeconds: o })), y(void 0), c?.info("license active", {
 				edition: e.edition,
 				entitlements: Object.keys(e.entitlements).length,
 				exp: e.exp
 			});
 		},
 		onFailure: (e) => {
-			c?.warn("license verification failed — entitlements fall back to static plan", {
+			y({
+				reason: e.reason,
+				message: e.message
+			}), c?.warn("license verification failed — entitlements fall back to static plan", {
 				reason: e.reason,
 				message: e.message
 			});
@@ -107,8 +131,8 @@ var c = class extends e.TaggedError("LicenseVerifyError") {}, l = (e) => typeof
 			instance: e.name
 		}),
 		description: "Offline-verified EdDSA license keys + entitlement snapshots; feeds @voltro/plugin-billing via entitlementResolver.",
-		declaredEnv: y.declared,
-		services: x,
+		declaredEnv: C.declared,
+		services: T,
 		onActivate: (e) => t.gen(function* () {
 			if (c = e.logger, r === void 0 || a === void 0) {
 				e.logger.debug("licensing: no license configured — static plan entitlements apply");
@@ -131,8 +155,10 @@ var c = class extends e.TaggedError("LicenseVerifyError") {}, l = (e) => typeof
 				}
 			});
 		},
-		onDeactivate: () => t.sync(() => g(void 0))
+		onDeactivate: () => t.sync(() => {
+			g(void 0), y(void 0);
+		})
 	});
 };
 //#endregion
-export { b as LicenseService, c as LicenseVerifyError, S as PluginNotLicensed, v as entitlementResolver, C as licenseAllowsPlugin, T as licensingPlugin, w as requireLicensedPlugin, p as verifyLicense };
+export { w as LicenseService, c as LicenseVerifyError, E as PluginNotLicensed, x as entitlementResolver, D as licenseAllowsPlugin, S as licenseStatus, k as licensingPlugin, O as requireLicensedPlugin, p as verifyLicense };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-licensing",
-  "version": "0.81.0",
+  "version": "0.83.0",
   "description": "Offline-verified license keys + cloud-issued entitlement snapshots for @voltro apps",
   "keywords": [
     "voltro",
@@ -38,10 +38,10 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/database": "0.81.0",
-    "@voltro/env": "0.81.0",
-    "@voltro/logger": "0.81.0",
-    "@voltro/protocol": "0.81.0",
+    "@voltro/database": "0.83.0",
+    "@voltro/env": "0.83.0",
+    "@voltro/logger": "0.83.0",
+    "@voltro/protocol": "0.83.0",
     "jose": "^6.2.12"
   },
   "peerDependencies": {