@owlmeans/payment 0.1.18-rc.21 → 0.1.18-rc.22

package/README.md

@@ -15,7 +15,7 @@ quantity-priced checkout.
 ## Installation
 
 ```bash
-bun add @owlmeans/payment@^0.1.18-rc.13
+bun add @owlmeans/payment@^0.1.18-rc.22
 ```
 
 ## Usage
@@ -83,7 +83,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.20
+npx @owlmeans/agent-skills@^0.1.18-rc.21
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/payment",
-  "version": "0.1.18-rc.21",
-  "generatedAt": "2026-09-12T14:18:54.796Z",
+  "version": "0.1.18-rc.22",
+  "generatedAt": "2026-09-15T12:21:31.943Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/payment/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/payment
 
 **Layer:** Core
-**Install:** `"@owlmeans/payment": "^0.1.18-rc.21"` in `dependencies`
+**Install:** `"@owlmeans/payment": "^0.1.18-rc.22"` in `dependencies`
 
 The contracts half of payments: the catalogue (products, plans, localizations), the subscription
 record, the entitlement grammar, and the entrypoint declarations both sides of a checkout share. It
@@ -108,7 +108,7 @@ for framework materialization, never a public compatibility export.
 import { paymentApi } from '@owlmeans/payment'
 import { bindAll } from '@owlmeans/client-entrypoint'
 
-export const appEntrypoints = [...bindAll(paymentApi.service)]
+export const clientBindings = [...bindAll(paymentApi.service)]
 
 const result = await ctx.entrypoint(paymentApi.service.checkout.session.external.create).call({
   body: { productSku, entitySlug, service, amountMinor, successUrl }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/payment",
-  "version": "0.1.18-rc.21",
+  "version": "0.1.18-rc.22",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -32,16 +32,16 @@
     "ajv": "*"
   },
   "dependencies": {
-    "@owlmeans/api-config": "^0.1.18-rc.20",
-    "@owlmeans/auth": "^0.1.18-rc.17",
-    "@owlmeans/basic-envelope": "^0.1.18-rc.20",
-    "@owlmeans/config": "^0.1.18-rc.20",
-    "@owlmeans/context": "^0.1.18-rc.16",
-    "@owlmeans/error": "^0.1.18-rc.16",
-    "@owlmeans/i18n": "^0.1.18-rc.16",
-    "@owlmeans/entrypoint": "^0.1.18-rc.19",
-    "@owlmeans/resource": "^0.1.18-rc.17",
-    "@owlmeans/route": "^0.1.18-rc.17"
+    "@owlmeans/api-config": "^0.1.18-rc.21",
+    "@owlmeans/auth": "^0.1.18-rc.18",
+    "@owlmeans/basic-envelope": "^0.1.18-rc.21",
+    "@owlmeans/config": "^0.1.18-rc.21",
+    "@owlmeans/context": "^0.1.18-rc.17",
+    "@owlmeans/error": "^0.1.18-rc.17",
+    "@owlmeans/i18n": "^0.1.18-rc.17",
+    "@owlmeans/entrypoint": "^0.1.18-rc.20",
+    "@owlmeans/resource": "^0.1.18-rc.18",
+    "@owlmeans/route": "^0.1.18-rc.18"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",

package/tests/entitlement.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entitlement.spec.d.ts.map

package/tests/entitlement.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlement.spec.d.ts","sourceRoot":"","sources":["entitlement.spec.ts"],"names":[],"mappings":""}

package/tests/entitlement.spec.js

@@ -0,0 +1,72 @@
+import { describe, test, expect } from 'bun:test';
+import { CAPABILITY_FEATURE_SCOPE, entitlementList, formatEntitlementParam, hasEntitlement, parseEntitlementParam, } from '../src/entitlement.js';
+const pro = [
+    { scope: 'renewable', permissions: { production: 1, credits: 5000 } },
+    { scope: CAPABILITY_FEATURE_SCOPE, permissions: { 'branding--whitelabel': true, 'domain--custom': true } },
+];
+describe('the parameter grammar', () => {
+    test('a bare permission has no scope and no floor', () => {
+        expect(parseEntitlementParam('domain--custom')).toEqual({ permission: 'domain--custom' });
+    });
+    test('a scope is everything before the first colon', () => {
+        expect(parseEntitlementParam('feature:branding--whitelabel'))
+            .toEqual({ scope: 'feature', permission: 'branding--whitelabel' });
+    });
+    test('a floor is parsed as a number', () => {
+        expect(parseEntitlementParam('renewable:credits>=100'))
+            .toEqual({ scope: 'renewable', permission: 'credits', atLeast: 100 });
+    });
+    test('formatting round-trips', () => {
+        for (const param of ['domain--custom', 'feature:branding--whitelabel', 'renewable:credits>=100']) {
+            expect(formatEntitlementParam(parseEntitlementParam(param))).toBe(param);
+        }
+    });
+});
+describe('the predicate', () => {
+    test('a held feature passes', () => {
+        expect(hasEntitlement(pro, 'feature:branding--whitelabel')).toBe(true);
+    });
+    test('a feature nobody granted does not', () => {
+        expect(hasEntitlement(pro, 'feature:branding--nonexistent')).toBe(false);
+    });
+    test('a scope that does not match is not consulted', () => {
+        expect(hasEntitlement(pro, 'renewable:branding--whitelabel')).toBe(false);
+        // …and without a scope, any set may answer.
+        expect(hasEntitlement(pro, 'branding--whitelabel')).toBe(true);
+    });
+    test('a numeric floor compares', () => {
+        expect(hasEntitlement(pro, 'renewable:credits>=5000')).toBe(true);
+        expect(hasEntitlement(pro, 'renewable:credits>=5001')).toBe(false);
+    });
+    test('a boolean cannot satisfy a numeric floor', () => {
+        expect(hasEntitlement(pro, 'feature:branding--whitelabel>=1')).toBe(false);
+    });
+    test('an explicit false is not a grant', () => {
+        expect(hasEntitlement([{ scope: 'feature', permissions: { x: false } }], 'feature:x')).toBe(false);
+        expect(hasEntitlement([{ scope: 'feature', permissions: { x: null } }], 'feature:x')).toBe(false);
+    });
+    test('no capabilities at all is a refusal, never a pass', () => {
+        expect(hasEntitlement(undefined, 'feature:branding--whitelabel')).toBe(false);
+        expect(hasEntitlement([], 'feature:branding--whitelabel')).toBe(false);
+    });
+    test('a malformed parameter refuses rather than throwing', () => {
+        // A gate that crashed on a typo would take down the endpoint it guards.
+        expect(() => hasEntitlement(pro, '')).not.toThrow();
+        expect(hasEntitlement(pro, '')).toBe(false);
+        expect(hasEntitlement(pro, 'feature:')).toBe(false);
+        expect(hasEntitlement(pro, 'renewable:credits>=abc')).toBe(true);
+    });
+});
+describe('listing', () => {
+    test('unions every granted capability, scoped', () => {
+        expect(entitlementList(pro).sort()).toEqual([
+            'feature:branding--whitelabel', 'feature:domain--custom',
+            'renewable:credits', 'renewable:production',
+        ]);
+    });
+    test('skips what is not granted', () => {
+        expect(entitlementList([{ scope: 'feature', permissions: { a: true, b: false, c: null } }]))
+            .toEqual(['feature:a']);
+    });
+});
+//# sourceMappingURL=entitlement.spec.js.map

package/tests/entitlement.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlement.spec.js","sourceRoot":"","sources":["entitlement.spec.ts"],"names":[],"mappings":"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"}