@owlmeans/payment 0.1.18-rc.15 → 0.1.18-rc.16

package/README.md

@@ -1,87 +1,10 @@
 # @owlmeans/payment
 
-Payment service abstraction — product catalog, subscription management, and Stripe checkout integration.
+Payment-domain services, schemas and shared checkout/subscription protocol declarations.
 
-## Overview
-
-- `makePaymentService(alias?)` — creates a payment service for context registration
-- `appendPaymentService(context, alias?)` — registers the payment service in the context
-- `PaymentService` — interface for products, plans, subscriptions, and checkout session creation
-- `CreateCheckoutBody` / `CreateCheckoutResponse` — request/response types for checkout
-
-## Installation
-
-```bash
-bun add @owlmeans/payment@^0.1.18-rc.12
-```
-
-## Usage
-
-Create a checkout session:
-
-```typescript
-import type { CreateCheckoutBody, CreateCheckoutResponse } from '@owlmeans/payment'
-
-const result = await ctx.entrypoint<ClientEntrypoint<CreateCheckoutResponse>>(
-  paymentApi.service.checkout.session.external.create
-).call({
-  body: {
-    productSku: 'vib-tokens',
-    entityId,
-    service: VIB_ALIAS,
-    successUrl: helper.makeUrl(service)
-  } satisfies CreateCheckoutBody
-})
-window.open(result.url, '_blank')
-```
-
-Handle subscription propagation:
-
-```typescript
-import { SubscriptionPropagateBody, PlanDuration, SubscriptionStatus } from '@owlmeans/payment'
-
-const handler = handleBody<SubscriptionPropagateBody>(async (body, context) => {
-  if (body.status === SubscriptionStatus.Consumable) {
-    const tokens = body.capabilities?.find(
-      c => c.scope === PlanDuration.Consumable
-    )?.permissions.units ?? 0
-    await ctx.agentToken().topUpTokens(entityId, tokens * 1000)
-  }
-})
-```
-
-## API
-
-### `makePaymentService(alias?): PaymentService`
-
-Creates the payment service.
-
-### `PaymentService`
-
-- `product(sku): Promise<Product>` — get a product by SKU
-- `products(): Promise<Product[]>` — list all products
-- `plans(productSku, duration): Promise<ProductPlan[]>` — list plans for a product
-- `plan(planSku): Promise<ProductPlan>` — get a plan by SKU
-- `shallowAuthentication(token): Promise<string>` — shallow auth for payment flows
-- `localize(lng, entity): Promise<Localization | null>` — get localized payment content
-
-### Types
-
-- `CreateCheckoutBody` — `{ productSku, entityId, service, successUrl?, cancelUrl? }`
-- `CreateCheckoutResponse` — `{ url: string }`
-- `SubscriptionPropagateBody` — extends `PlanSubscription`
-- `PlanSubscription` — `{ sku, entityId, createdAt, status, capabilities? }`
-
-### Enums
-
-- `PlanDuration` — `Monthly`, `Yearly`, `Consumable`, etc.
-- `SubscriptionStatus` — `Active`, `Consumable`, `Canceled`, etc.
-- `ProductType` — product category enum
-- `PaymentEntityType` — entity classification enum
-
-## Related Packages
-
-- [`@owlmeans/client-payment`](../client-payment) — client-side wrapper for browser contexts
+Bind the exported protocol declarations in each runtime, then call the protocol reference from the
+context. `entityId` in a billing payload is the stable organization entity record id; never send an
+`entitySlug` as a billing relation.
 
 <!-- owlmeans:agent-guidance:start -->
 ## Agent guidance
@@ -91,7 +14,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.14
+npx @owlmeans/agent-skills@^0.1.18-rc.15
 ```
 
 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.15",
-  "generatedAt": "2026-09-10T23:12:07.517Z",
+  "version": "0.1.18-rc.16",
+  "generatedAt": "2026-09-12T08:39:52.735Z",
   "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.15"` in `dependencies`
+**Install:** `"@owlmeans/payment": "^0.1.18-rc.16"` 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
@@ -72,8 +72,8 @@ is written as a string:
   flag, however true, does not answer it.
 - **A malformed parameter answers `false`, it never throws.** A gate that crashed on a typo would
   take down the endpoint it guards, which is strictly worse than refusing the request.
-- **Declare the requirement on the route, not in the handler.** `entitled(...)` is sugar over
-  `gate(ENTITLEMENT_GATE, params)`; the framework asserts a gate before the handler is entered, so
+- **Declare the requirement on the protocol, not in the handler.** `entitled(...)` is sugar over
+  the protocol's `gate: { alias: ENTITLEMENT_GATE, params }` option; the framework asserts a gate before the handler is entered, so
   the route table states what a feature costs and no new endpoint can forget to check. Several
   parameters are OR'd, as with every other gate.
 - The gate service itself is not here — bind something under `ENTITLEMENT_GATE` in the server
@@ -82,9 +82,12 @@ is written as a string:
 ```typescript
 import { entitled, hasEntitlement, entitlementList } from '@owlmeans/payment'
 
-// On the route:
-entrypoint(route(MY_ROUTE, '/whitelabel', backend(BASE, RouteMethod.POST)),
-  entitled('feature:branding--whitelabel'))
+// On the protocol:
+protocol(
+  route(MY_ROUTE, '/whitelabel', backend(BASE, RouteMethod.POST)),
+  contract(typed()),
+  { gate: { alias: ENTITLEMENT_GATE, params: ['feature:branding--whitelabel'] } },
+)
 
 // In the UI, to render a control disabled rather than let it fail:
 const allowed = hasEntitlement(capabilities, 'renewable:credits>=100')
@@ -95,19 +98,20 @@ const granted = entitlementList(capabilities)
 ## Checkout
 
 Register `serviceEntrypoints` (and `entrypoints` where subscriptions are propagated back), then
-call the alias. `ClientEntrypoint.call` resolves to the response value itself and throws the reply's
-error; `invoke` is the form that hands back the value and the outcome together.
+bind the shared declaration in the caller runtime. `call` resolves to the response value itself and
+throws the reply's error; `invoke` returns the value and outcome together.
 
 ```typescript
 import { paymentApi, serviceEntrypoints } from '@owlmeans/payment'
 import type { CreateCheckoutBody, CreateCheckoutResponse } from '@owlmeans/payment'
-import type { ClientEntrypoint } from '@owlmeans/client-entrypoint'
+import { entrypointRef } from '@owlmeans/entrypoint'
 
 export const appEntrypoints = [...myEntrypoints, ...serviceEntrypoints]
 
-const result = await ctx.entrypoint<ClientEntrypoint<CreateCheckoutResponse>>(
+const checkout = entrypointRef<{ body: CreateCheckoutBody }, CreateCheckoutResponse>(
   paymentApi.service.checkout.session.external.create
-).call({
+)
+const result = await ctx.entrypoint(checkout).call({
   body: { productSku, entityId, service, successUrl } satisfies CreateCheckoutBody
 })
 window.open(result.url, '_blank')

package/build/entitlement.d.ts

@@ -1,4 +1,4 @@
-import type { CommonEntrypointOptions } from '@owlmeans/entrypoint';
+import type { EntrypointOptions } from '@owlmeans/entrypoint';
 import type { PermissionSet } from '@owlmeans/auth';
 /**
  * The gate alias a paid capability is asserted under.
@@ -49,12 +49,13 @@ export declare const entitlementList: (capabilities: PermissionSet[] | undefined
 /**
  * Declare that an entrypoint needs a paid capability.
  *
- * Sugar over `gate(ENTITLEMENT_GATE, params)` so a route reads as what it means. Several
+ * Compatibility sugar over the protocol option
+ * `{ gate: { alias: ENTITLEMENT_GATE, params } }` so a route reads as what it means. Several
  * parameters are OR'd, matching every other gate in the framework.
  *
  * Putting the requirement HERE rather than in a handler is the point: the framework asserts a gate
  * before the handler is entered, so the route table states what a feature costs and no new
  * endpoint can forget to check.
  */
-export declare const entitled: (params: string | string[], opts?: CommonEntrypointOptions) => CommonEntrypointOptions;
+export declare const entitled: (params: string | string[], opts?: EntrypointOptions) => EntrypointOptions;
 //# sourceMappingURL=entitlement.d.ts.map

package/build/entitlement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entitlement.d.ts","sourceRoot":"","sources":["../src/entitlement.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,qBAAqB,CAAA;AAElD;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,YAAY,CAAA;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAA;IAClB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,UAAW,MAAM,KAAG,gBAerD,CAAA;AAED,eAAO,MAAM,sBAAsB,WAAY,gBAAgB,KAAG,MAER,CAAA;AAE1D;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,iBACX,aAAa,EAAE,GAAG,SAAS,SAAS,MAAM,KACvD,OAqBF,CAAA;AAED,kGAAkG;AAClG,eAAO,MAAM,eAAe,iBAAkB,aAAa,EAAE,GAAG,SAAS,KAAG,MAAM,EAYjF,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,WACX,MAAM,GAAG,MAAM,EAAE,SAAS,uBAAuB,KACxD,uBAA+D,CAAA"}
+{"version":3,"file":"entitlement.d.ts","sourceRoot":"","sources":["../src/entitlement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,qBAAqB,CAAA;AAElD;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,YAAY,CAAA;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAA;IAClB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,UAAW,MAAM,KAAG,gBAerD,CAAA;AAED,eAAO,MAAM,sBAAsB,WAAY,gBAAgB,KAAG,MAER,CAAA;AAE1D;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,iBACX,aAAa,EAAE,GAAG,SAAS,SAAS,MAAM,KACvD,OAqBF,CAAA;AAED,kGAAkG;AAClG,eAAO,MAAM,eAAe,iBAAkB,aAAa,EAAE,GAAG,SAAS,KAAG,MAAM,EAYjF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,WACX,MAAM,GAAG,MAAM,EAAE,SAAS,iBAAiB,KAClD,iBAGD,CAAA"}

package/build/entitlement.js

@@ -1,4 +1,3 @@
-import { gate } from '@owlmeans/entrypoint';
 /**
  * The gate alias a paid capability is asserted under.
  *
@@ -84,12 +83,16 @@ export const entitlementList = (capabilities) => {
 /**
  * Declare that an entrypoint needs a paid capability.
  *
- * Sugar over `gate(ENTITLEMENT_GATE, params)` so a route reads as what it means. Several
+ * Compatibility sugar over the protocol option
+ * `{ gate: { alias: ENTITLEMENT_GATE, params } }` so a route reads as what it means. Several
  * parameters are OR'd, matching every other gate in the framework.
  *
  * Putting the requirement HERE rather than in a handler is the point: the framework asserts a gate
  * before the handler is entered, so the route table states what a feature costs and no new
  * endpoint can forget to check.
  */
-export const entitled = (params, opts) => gate(ENTITLEMENT_GATE, params, opts);
+export const entitled = (params, opts) => ({
+    ...opts,
+    gate: { alias: ENTITLEMENT_GATE, params },
+});
 //# sourceMappingURL=entitlement.js.map

package/build/entitlement.js.map

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

package/build/entrypoints.d.ts

@@ -1,3 +1,7 @@
-export declare const entrypoints: import("@owlmeans/entrypoint").CommonEntrypoint[];
-export declare const serviceEntrypoints: import("@owlmeans/entrypoint").CommonEntrypoint[];
+export declare const entrypoints: (import("@owlmeans/entrypoint").EntrypointProtocol<import("@owlmeans/entrypoint").OpenRequest, import("@owlmeans/entrypoint").OpenValue> | import("@owlmeans/entrypoint").EntrypointProtocol<{
+    body: import("./types.js").SubscriptionPropagateBody | import("@owlmeans/entrypoint").OpenValue;
+}, undefined>)[];
+export declare const serviceEntrypoints: (import("@owlmeans/entrypoint").EntrypointProtocol<import("@owlmeans/entrypoint").OpenRequest, import("@owlmeans/entrypoint").OpenValue> | import("@owlmeans/entrypoint").EntrypointProtocol<{
+    body: import("./types.js").CreateCheckoutBody | import("@owlmeans/entrypoint").OpenValue;
+}, undefined>)[];
 //# sourceMappingURL=entrypoints.d.ts.map

package/build/entrypoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entrypoints.d.ts","sourceRoot":"","sources":["../src/entrypoints.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,WAAW,mDAgBvB,CAAA;AAED,eAAO,MAAM,kBAAkB,mDAkB9B,CAAA"}
+{"version":3,"file":"entrypoints.d.ts","sourceRoot":"","sources":["../src/entrypoints.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,WAAW;;gBAgBvB,CAAA;AAED,eAAO,MAAM,kBAAkB;;gBAkB9B,CAAA"}

package/build/entrypoints.js

@@ -1,18 +1,18 @@
-import { body, filter, entrypoint } from '@owlmeans/entrypoint';
+import { contract, openProtocol, protocol, typed } from '@owlmeans/entrypoint';
 import { route, backend, RouteMethod } from '@owlmeans/route';
 import { paymentApi } from './consts.js';
 import { SubscriptionPropagateBodySchema } from './model/subscription.js';
 import { CreateCheckoutBodySchema } from './model/checkout.js';
 export const entrypoints = [
-    entrypoint(route(paymentApi.subscription.base, '/subscription', backend())),
-    entrypoint(route(paymentApi.subscription.propogate, '/propogate', backend(paymentApi.subscription.base, RouteMethod.POST)), filter(body(SubscriptionPropagateBodySchema))),
-    entrypoint(route(paymentApi.subscription.propagate, '/propagate', backend(paymentApi.subscription.base, RouteMethod.POST)), filter(body(SubscriptionPropagateBodySchema)))
+    openProtocol(route(paymentApi.subscription.base, '/subscription', backend())),
+    protocol(route(paymentApi.subscription.propogate, '/propogate', backend(paymentApi.subscription.base, RouteMethod.POST)), contract.request({ body: SubscriptionPropagateBodySchema }, typed())),
+    protocol(route(paymentApi.subscription.propagate, '/propagate', backend(paymentApi.subscription.base, RouteMethod.POST)), contract.request({ body: SubscriptionPropagateBodySchema }, typed()))
 ];
 export const serviceEntrypoints = [
-    entrypoint(route(paymentApi.service.base, '/payment-service', backend())),
-    entrypoint(route(paymentApi.service.checkout.base, '/checkout', backend(paymentApi.service.base))),
-    entrypoint(route(paymentApi.service.checkout.session.base, '/session', backend(paymentApi.service.checkout.base))),
-    entrypoint(route(paymentApi.service.checkout.session.external.base, '/external', backend(paymentApi.service.checkout.session.base))),
-    entrypoint(route(paymentApi.service.checkout.session.external.create, '/create', backend(paymentApi.service.checkout.session.external.base, RouteMethod.POST)), filter(body(CreateCheckoutBodySchema)))
+    openProtocol(route(paymentApi.service.base, '/payment-service', backend())),
+    openProtocol(route(paymentApi.service.checkout.base, '/checkout', backend(paymentApi.service.base))),
+    openProtocol(route(paymentApi.service.checkout.session.base, '/session', backend(paymentApi.service.checkout.base))),
+    openProtocol(route(paymentApi.service.checkout.session.external.base, '/external', backend(paymentApi.service.checkout.session.base))),
+    protocol(route(paymentApi.service.checkout.session.external.create, '/create', backend(paymentApi.service.checkout.session.external.base, RouteMethod.POST)), contract.request({ body: CreateCheckoutBodySchema }, typed()))
 ];
 //# sourceMappingURL=entrypoints.js.map

package/build/entrypoints.js.map

@@ -1 +1 @@
-{"version":3,"file":"entrypoints.js","sourceRoot":"","sources":["../src/entrypoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AAE9D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3E,UAAU,CACR,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAC5D,UAAU,CAAC,YAAY,CAAC,IAAI,EAC5B,WAAW,CAAC,IAAI,CACjB,CAAC,EACF,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,CAC9C;IACD,UAAU,CACR,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAC5D,UAAU,CAAC,YAAY,CAAC,IAAI,EAC5B,WAAW,CAAC,IAAI,CACjB,CAAC,EACF,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,CAC9C;CACF,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,CAAC;IACzE,UAAU,CACR,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CACvF;IACD,UAAU,CACR,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CACvG;IACD,UAAU,CACR,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CACzH;IACD,UAAU,CACR,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAC3E,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EACjD,WAAW,CAAC,IAAI,CACjB,CAAC,EACF,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CACvC;CACF,CAAA"}
+{"version":3,"file":"entrypoints.js","sourceRoot":"","sources":["../src/entrypoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC9E,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AAE9D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7E,QAAQ,CACN,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAC5D,UAAU,CAAC,YAAY,CAAC,IAAI,EAC5B,WAAW,CAAC,IAAI,CACjB,CAAC,EACF,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,+BAA+B,EAAE,EAAE,KAAK,EAAE,CAAC,CACrE;IACD,QAAQ,CACN,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAC5D,UAAU,CAAC,YAAY,CAAC,IAAI,EAC5B,WAAW,CAAC,IAAI,CACjB,CAAC,EACF,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,+BAA+B,EAAE,EAAE,KAAK,EAAE,CAAC,CACrE;CACF,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3E,YAAY,CACV,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CACvF;IACD,YAAY,CACV,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CACvG;IACD,YAAY,CACV,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CACzH;IACD,QAAQ,CACN,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAC3E,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EACjD,WAAW,CAAC,IAAI,CACjB,CAAC,EACF,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,wBAAwB,EAAE,EAAE,KAAK,EAAE,CAAC,CAC9D;CACF,CAAA"}

package/build/index.d.ts

@@ -7,5 +7,4 @@ export * from './service.js';
 export * from './i18n.js';
 export * from './helper.js';
 export * from './entrypoints.js';
-export * from './advertise.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA"}

package/build/index.js

@@ -6,5 +6,4 @@ export * from './service.js';
 export * from './i18n.js';
 export * from './helper.js';
 export * from './entrypoints.js';
-export * from './advertise.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/payment",
-  "version": "0.1.18-rc.15",
+  "version": "0.1.18-rc.16",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -31,16 +31,16 @@
     "ajv": "*"
   },
   "dependencies": {
-    "@owlmeans/api-config": "^0.1.18-rc.14",
-    "@owlmeans/auth": "^0.1.18-rc.11",
-    "@owlmeans/basic-envelope": "^0.1.18-rc.14",
-    "@owlmeans/config": "^0.1.18-rc.14",
-    "@owlmeans/context": "^0.1.18-rc.10",
-    "@owlmeans/error": "^0.1.18-rc.10",
-    "@owlmeans/i18n": "^0.1.18-rc.10",
-    "@owlmeans/entrypoint": "^0.1.18-rc.13",
-    "@owlmeans/resource": "^0.1.18-rc.11",
-    "@owlmeans/route": "^0.1.18-rc.11"
+    "@owlmeans/api-config": "^0.1.18-rc.15",
+    "@owlmeans/auth": "^0.1.18-rc.12",
+    "@owlmeans/basic-envelope": "^0.1.18-rc.15",
+    "@owlmeans/config": "^0.1.18-rc.15",
+    "@owlmeans/context": "^0.1.18-rc.11",
+    "@owlmeans/error": "^0.1.18-rc.11",
+    "@owlmeans/i18n": "^0.1.18-rc.11",
+    "@owlmeans/entrypoint": "^0.1.18-rc.14",
+    "@owlmeans/resource": "^0.1.18-rc.12",
+    "@owlmeans/route": "^0.1.18-rc.12"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",

package/src/entitlement.ts

@@ -1,5 +1,4 @@
-import { gate } from '@owlmeans/entrypoint'
-import type { CommonEntrypointOptions } from '@owlmeans/entrypoint'
+import type { EntrypointOptions } from '@owlmeans/entrypoint'
 import type { PermissionSet } from '@owlmeans/auth'
 
 /**
@@ -110,7 +109,8 @@ export const entitlementList = (capabilities: PermissionSet[] | undefined): stri
 /**
  * Declare that an entrypoint needs a paid capability.
  *
- * Sugar over `gate(ENTITLEMENT_GATE, params)` so a route reads as what it means. Several
+ * Compatibility sugar over the protocol option
+ * `{ gate: { alias: ENTITLEMENT_GATE, params } }` so a route reads as what it means. Several
  * parameters are OR'd, matching every other gate in the framework.
  *
  * Putting the requirement HERE rather than in a handler is the point: the framework asserts a gate
@@ -118,5 +118,8 @@ export const entitlementList = (capabilities: PermissionSet[] | undefined): stri
  * endpoint can forget to check.
  */
 export const entitled = (
-  params: string | string[], opts?: CommonEntrypointOptions
-): CommonEntrypointOptions => gate(ENTITLEMENT_GATE, params, opts)
+  params: string | string[], opts?: EntrypointOptions,
+): EntrypointOptions => ({
+  ...opts,
+  gate: { alias: ENTITLEMENT_GATE, params },
+})

package/src/entrypoints.ts

@@ -1,43 +1,43 @@
-import { body, filter, entrypoint } from '@owlmeans/entrypoint'
+import { contract, openProtocol, protocol, typed } from '@owlmeans/entrypoint'
 import { route, backend, RouteMethod } from '@owlmeans/route'
 import { paymentApi } from './consts.js'
 import { SubscriptionPropagateBodySchema } from './model/subscription.js'
 import { CreateCheckoutBodySchema } from './model/checkout.js'
 
 export const entrypoints = [
-  entrypoint(route(paymentApi.subscription.base, '/subscription', backend())),
-  entrypoint(
+  openProtocol(route(paymentApi.subscription.base, '/subscription', backend())),
+  protocol(
     route(paymentApi.subscription.propogate, '/propogate', backend(
       paymentApi.subscription.base,
       RouteMethod.POST
     )),
-    filter(body(SubscriptionPropagateBodySchema))
+    contract.request({ body: SubscriptionPropagateBodySchema }, typed())
   ),
-  entrypoint(
+  protocol(
     route(paymentApi.subscription.propagate, '/propagate', backend(
       paymentApi.subscription.base,
       RouteMethod.POST
     )),
-    filter(body(SubscriptionPropagateBodySchema))
+    contract.request({ body: SubscriptionPropagateBodySchema }, typed())
   )
 ]
 
 export const serviceEntrypoints = [
-  entrypoint(route(paymentApi.service.base, '/payment-service', backend())),
-  entrypoint(
+  openProtocol(route(paymentApi.service.base, '/payment-service', backend())),
+  openProtocol(
     route(paymentApi.service.checkout.base, '/checkout', backend(paymentApi.service.base)),
   ),
-  entrypoint(
+  openProtocol(
     route(paymentApi.service.checkout.session.base, '/session', backend(paymentApi.service.checkout.base)),
   ),
-  entrypoint(
+  openProtocol(
     route(paymentApi.service.checkout.session.external.base, '/external', backend(paymentApi.service.checkout.session.base)),
   ),
-  entrypoint(
+  protocol(
     route(paymentApi.service.checkout.session.external.create, '/create', backend(
       paymentApi.service.checkout.session.external.base,
       RouteMethod.POST
     )),
-    filter(body(CreateCheckoutBodySchema))
+    contract.request({ body: CreateCheckoutBodySchema }, typed())
   )
-]
+]

package/src/index.ts

@@ -8,4 +8,3 @@ export * from './service.js'
 export * from './i18n.js'
 export * from './helper.js'
 export * from './entrypoints.js'
-export * from './advertise.js'

package/src/advertise.ts

@@ -1,15 +0,0 @@
-import { CONFIG_RECORD } from '@owlmeans/context'
-import { apiConfigPlugin, every } from '@owlmeans/api-config'
-import { L10N_RECORD_TYPE, PLAN_RECORD_TYPE, PRODUCT_RECORD_TYPE } from './consts.js'
-
-const advertisedRecordTypes = new Set([L10N_RECORD_TYPE, PLAN_RECORD_TYPE, PRODUCT_RECORD_TYPE])
-
-apiConfigPlugin({
-  allow: {
-    [CONFIG_RECORD]: every(
-      true,
-      value => value != null && typeof value === 'object'
-        && advertisedRecordTypes.has((value as { recordType?: string }).recordType ?? '')
-    ),
-  },
-})