@mesub/node 0.1.4 → 0.1.6

package/dist/index.js

@@ -10,14 +10,14 @@ import {
   MesubSubmitError,
   VERSION,
   verifyWebhook
-} from "./chunk-IG4QRQSJ.js";
+} from "./chunk-QDBKSJ56.js";
 import {
   ACCESS_LINE,
   CONFIRMATIONS,
   SITUATIONS,
   explain,
   situationOf
-} from "./chunk-JJWHMB2X.js";
+} from "./chunk-R4H46TSQ.js";
 export {
   ACCESS_LINE,
   API_VERSION,

package/dist/nest.cjs

@@ -9,10 +9,10 @@
 
 
 
-var _chunkYCPYBU3Rcjs = require('./chunk-YCPYBU3R.cjs');
+var _chunkTDRUSUBVcjs = require('./chunk-TDRUSUBV.cjs');
 
 
-var _chunkIAYUXSDDcjs = require('./chunk-IAYUXSDD.cjs');
+var _chunk5THDILDDcjs = require('./chunk-5THDILDD.cjs');
 
 // src/nest.ts
 
@@ -25,28 +25,28 @@ function setHeader(response, name, value) {
   else if (typeof response.header === "function") response.header(name, value);
 }
 function RequirePlan(plan, options) {
-  _chunkYCPYBU3Rcjs.checkPlan.call(void 0, plan);
-  _chunkYCPYBU3Rcjs.checkCustomer.call(void 0, options);
+  _chunkTDRUSUBVcjs.checkPlan.call(void 0, plan);
+  _chunkTDRUSUBVcjs.checkCustomer.call(void 0, options);
   class MesubPlanGuard {
     async canActivate(context) {
       const http = context.switchToHttp();
       const request = http.getRequest();
-      const client = _nullishCoalesce(options.client, () => ( _chunkYCPYBU3Rcjs.defaultClient.call(void 0, )));
-      const outcome = await _chunkYCPYBU3Rcjs.guard.call(void 0, 
+      const client = _nullishCoalesce(options.client, () => ( _chunkTDRUSUBVcjs.defaultClient.call(void 0, )));
+      const outcome = await _chunkTDRUSUBVcjs.guard.call(void 0, 
         client,
-        await _chunkYCPYBU3Rcjs.askerOf.call(void 0, request, options.customer),
-        () => _chunkYCPYBU3Rcjs.plansOf.call(void 0, plan, request)
+        await _chunkTDRUSUBVcjs.askerOf.call(void 0, request, options.customer),
+        () => _chunkTDRUSUBVcjs.plansOf.call(void 0, plan, request)
       );
       if (outcome.allowed) {
-        request.mesub = _chunkYCPYBU3Rcjs.accessOf.call(void 0, outcome);
+        request.mesub = _chunkTDRUSUBVcjs.accessOf.call(void 0, outcome);
         return true;
       }
-      const denial = _chunkYCPYBU3Rcjs.denialOf.call(void 0, outcome);
+      const denial = _chunkTDRUSUBVcjs.denialOf.call(void 0, outcome);
       await _optionalChain([options, 'access', _ => _.onDenied, 'optionalCall', _2 => _2(denial, request)]);
       if (outcome.reason === "unavailable") {
-        setHeader(http.getResponse(), "Retry-After", _chunkYCPYBU3Rcjs.retryAfterOf.call(void 0, outcome));
+        setHeader(http.getResponse(), "Retry-After", _chunkTDRUSUBVcjs.retryAfterOf.call(void 0, outcome));
       }
-      throw new (0, _common.HttpException)(_chunkYCPYBU3Rcjs.denialBody.call(void 0, outcome), denial.status);
+      throw new (0, _common.HttpException)(_chunkTDRUSUBVcjs.denialBody.call(void 0, outcome), denial.status);
     }
   }
   return _common.mixin.call(void 0, MesubPlanGuard);
@@ -58,5 +58,5 @@ var MesubAccess = _common.createParamDecorator.call(void 0,
 
 
 
-exports.MesubAccess = MesubAccess; exports.MesubError = _chunkIAYUXSDDcjs.MesubError; exports.RequirePlan = RequirePlan;
+exports.MesubAccess = MesubAccess; exports.MesubError = _chunk5THDILDDcjs.MesubError; exports.RequirePlan = RequirePlan;
 //# sourceMappingURL=nest.cjs.map

package/dist/nest.d.cts

@@ -1,9 +1,9 @@
 import { Type, CanActivate } from '@nestjs/common';
-import { H as HeaderSource, M as Mesub } from './client-BZB6KIGd.cjs';
-import { M as MesubAccess$1, P as PlanOption, C as CustomerOption, D as Denial } from './guard-D4AB5HtN.cjs';
-export { A as Asked, a as DenialReason } from './guard-D4AB5HtN.cjs';
-export { M as MesubError } from './errors-DcLfunS-.cjs';
-export { C as Customer } from './subscriptions-B6Lin6i_.cjs';
+import { H as HeaderSource, M as Mesub } from './client-B2DttW-V.cjs';
+import { M as MesubAccess$1, P as PlanOption, C as CustomerOption, D as Denial } from './guard-CDC9mDWY.cjs';
+export { A as Asked, a as DenialReason } from './guard-CDC9mDWY.cjs';
+export { M as MesubError } from './errors-xk1hGCOf.cjs';
+export { C as Customer } from './subscriptions-Dy_BNyPE.cjs';
 
 /** `@mesub/node/nest`: `RequirePlan()` and `@MesubAccess()`. */
 

package/dist/nest.d.ts

@@ -1,9 +1,9 @@
 import { Type, CanActivate } from '@nestjs/common';
-import { H as HeaderSource, M as Mesub } from './client-Q5QhXphp.js';
-import { M as MesubAccess$1, P as PlanOption, C as CustomerOption, D as Denial } from './guard-CaXiHMVF.js';
-export { A as Asked, a as DenialReason } from './guard-CaXiHMVF.js';
-export { M as MesubError } from './errors-BN4ZWUfM.js';
-export { C as Customer } from './subscriptions-B6Lin6i_.js';
+import { H as HeaderSource, M as Mesub } from './client-BHrc_yO3.js';
+import { M as MesubAccess$1, P as PlanOption, C as CustomerOption, D as Denial } from './guard-CrGTKKXV.js';
+export { A as Asked, a as DenialReason } from './guard-CrGTKKXV.js';
+export { M as MesubError } from './errors-CTFJfJoF.js';
+export { C as Customer } from './subscriptions-Dy_BNyPE.js';
 
 /** `@mesub/node/nest`: `RequirePlan()` and `@MesubAccess()`. */
 

package/dist/nest.js

@@ -9,10 +9,10 @@ import {
   guard,
   plansOf,
   retryAfterOf
-} from "./chunk-EPOLIEGY.js";
+} from "./chunk-EGGKTDHO.js";
 import {
   MesubError
-} from "./chunk-IG4QRQSJ.js";
+} from "./chunk-QDBKSJ56.js";
 
 // src/nest.ts
 import {

package/dist/next.cjs

@@ -3,7 +3,7 @@
 
 
 
-var _chunkK6U6FPTAcjs = require('./chunk-K6U6FPTA.cjs');
+var _chunk5LDAYKUAcjs = require('./chunk-5LDAYKUA.cjs');
 
 
 
@@ -15,27 +15,27 @@ var _chunkK6U6FPTAcjs = require('./chunk-K6U6FPTA.cjs');
 
 
 
-var _chunkYCPYBU3Rcjs = require('./chunk-YCPYBU3R.cjs');
+var _chunkTDRUSUBVcjs = require('./chunk-TDRUSUBV.cjs');
 
 
-var _chunkIAYUXSDDcjs = require('./chunk-IAYUXSDD.cjs');
+var _chunk5THDILDDcjs = require('./chunk-5THDILDD.cjs');
 
 // src/next.ts
 function withMesub(handler, options) {
-  _chunkYCPYBU3Rcjs.checkPlan.call(void 0, options.plan);
-  _chunkYCPYBU3Rcjs.checkCustomer.call(void 0, options);
+  _chunkTDRUSUBVcjs.checkPlan.call(void 0, options.plan);
+  _chunkTDRUSUBVcjs.checkCustomer.call(void 0, options);
   return async (request, context) => {
-    const client = _nullishCoalesce(options.client, () => ( _chunkYCPYBU3Rcjs.defaultClient.call(void 0, )));
-    const outcome = await _chunkYCPYBU3Rcjs.guard.call(void 0, 
+    const client = _nullishCoalesce(options.client, () => ( _chunkTDRUSUBVcjs.defaultClient.call(void 0, )));
+    const outcome = await _chunkTDRUSUBVcjs.guard.call(void 0, 
       client,
-      await _chunkYCPYBU3Rcjs.askerOf.call(void 0, request, options.customer),
-      () => _chunkYCPYBU3Rcjs.plansOf.call(void 0, options.plan, request)
+      await _chunkTDRUSUBVcjs.askerOf.call(void 0, request, options.customer),
+      () => _chunkTDRUSUBVcjs.plansOf.call(void 0, options.plan, request)
     );
-    if (outcome.allowed) return handler(request, _chunkYCPYBU3Rcjs.accessOf.call(void 0, outcome), context);
-    const denial = _chunkYCPYBU3Rcjs.denialOf.call(void 0, outcome);
+    if (outcome.allowed) return handler(request, _chunkTDRUSUBVcjs.accessOf.call(void 0, outcome), context);
+    const denial = _chunkTDRUSUBVcjs.denialOf.call(void 0, outcome);
     if (options.onDenied) return await options.onDenied(denial, request);
-    const headers = outcome.reason === "unavailable" ? { "Retry-After": _chunkYCPYBU3Rcjs.retryAfterOf.call(void 0, outcome) } : {};
-    return Response.json(_chunkYCPYBU3Rcjs.denialBody.call(void 0, outcome), { status: denial.status, headers });
+    const headers = outcome.reason === "unavailable" ? { "Retry-After": _chunkTDRUSUBVcjs.retryAfterOf.call(void 0, outcome) } : {};
+    return Response.json(_chunkTDRUSUBVcjs.denialBody.call(void 0, outcome), { status: denial.status, headers });
   };
 }
 async function pathOf(context) {
@@ -44,7 +44,7 @@ async function pathOf(context) {
   return `/${(_nullishCoalesce(segments, () => ( []))).map((segment) => encodeURIComponent(String(segment))).join("/")}`;
 }
 async function textOf(request) {
-  if (Number(request.headers.get("content-length")) > _chunkK6U6FPTAcjs.MAX_BODY_BYTES) return null;
+  if (Number(request.headers.get("content-length")) > _chunk5LDAYKUAcjs.MAX_BODY_BYTES) return null;
   if (request.body === null) return "";
   const reader = request.body.getReader();
   const decoder = new TextDecoder();
@@ -54,7 +54,7 @@ async function textOf(request) {
     const { done, value } = await reader.read();
     if (done) return text + decoder.decode();
     size += value.byteLength;
-    if (size > _chunkK6U6FPTAcjs.MAX_BODY_BYTES) {
+    if (size > _chunk5LDAYKUAcjs.MAX_BODY_BYTES) {
       await reader.cancel();
       return null;
     }
@@ -62,7 +62,7 @@ async function textOf(request) {
   }
 }
 function mesubRouteHandlers(options) {
-  _chunkK6U6FPTAcjs.checkWidgetOptions.call(void 0, options);
+  _chunk5LDAYKUAcjs.checkWidgetOptions.call(void 0, options);
   const handle = async (request, context) => {
     const path = await pathOf(context);
     let body;
@@ -84,10 +84,10 @@ function mesubRouteHandlers(options) {
       }
     }
     const publicRead = request.method === "GET" && path.startsWith("/plans/");
-    const asked = publicRead ? null : await _chunkK6U6FPTAcjs.widgetCustomer.call(void 0, request, options.customer);
+    const asked = publicRead ? null : await _chunk5LDAYKUAcjs.widgetCustomer.call(void 0, request, options.customer);
     const email = asked && options.email ? await options.email(request) : void 0;
-    const answer = await _chunkK6U6FPTAcjs.handleWidget.call(void 0, 
-      _nullishCoalesce(options.client, () => ( _chunkYCPYBU3Rcjs.defaultClient.call(void 0, ))),
+    const answer = await _chunk5LDAYKUAcjs.handleWidget.call(void 0, 
+      _nullishCoalesce(options.client, () => ( _chunkTDRUSUBVcjs.defaultClient.call(void 0, ))),
       {
         method: request.method,
         path,
@@ -109,5 +109,5 @@ function mesubRouteHandlers(options) {
 
 
 
-exports.MesubError = _chunkIAYUXSDDcjs.MesubError; exports.mesubRouteHandlers = mesubRouteHandlers; exports.withMesub = withMesub;
+exports.MesubError = _chunk5THDILDDcjs.MesubError; exports.mesubRouteHandlers = mesubRouteHandlers; exports.withMesub = withMesub;
 //# sourceMappingURL=next.cjs.map

package/dist/next.d.cts

@@ -1,10 +1,10 @@
-import { M as Mesub } from './client-BZB6KIGd.cjs';
-import { M as MesubAccess, P as PlanOption, C as CustomerOption, D as Denial } from './guard-D4AB5HtN.cjs';
-export { A as Asked, a as DenialReason } from './guard-D4AB5HtN.cjs';
-import { W as WidgetRoutesOptions } from './routes-DT8EFWSl.cjs';
-export { a as WidgetPayment, b as WidgetSubscriptionDetail, c as WidgetSubscriptionList } from './routes-DT8EFWSl.cjs';
-export { M as MesubError } from './errors-DcLfunS-.cjs';
-export { C as Customer } from './subscriptions-B6Lin6i_.cjs';
+import { M as Mesub } from './client-B2DttW-V.cjs';
+import { M as MesubAccess, P as PlanOption, C as CustomerOption, D as Denial } from './guard-CDC9mDWY.cjs';
+export { A as Asked, a as DenialReason } from './guard-CDC9mDWY.cjs';
+import { W as WidgetRoutesOptions } from './routes-BpOV9UAR.cjs';
+export { a as WidgetPayment, b as WidgetSubscriptionDetail, c as WidgetSubscriptionList } from './routes-BpOV9UAR.cjs';
+export { M as MesubError } from './errors-xk1hGCOf.cjs';
+export { C as Customer } from './subscriptions-Dy_BNyPE.cjs';
 
 /** `@mesub/node/next`: `withMesub()`. Web `Request`/`Response` only, nothing imported from `next`. */
 

package/dist/next.d.ts

@@ -1,10 +1,10 @@
-import { M as Mesub } from './client-Q5QhXphp.js';
-import { M as MesubAccess, P as PlanOption, C as CustomerOption, D as Denial } from './guard-CaXiHMVF.js';
-export { A as Asked, a as DenialReason } from './guard-CaXiHMVF.js';
-import { W as WidgetRoutesOptions } from './routes-KoaD1Xsk.js';
-export { a as WidgetPayment, b as WidgetSubscriptionDetail, c as WidgetSubscriptionList } from './routes-KoaD1Xsk.js';
-export { M as MesubError } from './errors-BN4ZWUfM.js';
-export { C as Customer } from './subscriptions-B6Lin6i_.js';
+import { M as Mesub } from './client-BHrc_yO3.js';
+import { M as MesubAccess, P as PlanOption, C as CustomerOption, D as Denial } from './guard-CrGTKKXV.js';
+export { A as Asked, a as DenialReason } from './guard-CrGTKKXV.js';
+import { W as WidgetRoutesOptions } from './routes-DWhspa6s.js';
+export { a as WidgetPayment, b as WidgetSubscriptionDetail, c as WidgetSubscriptionList } from './routes-DWhspa6s.js';
+export { M as MesubError } from './errors-CTFJfJoF.js';
+export { C as Customer } from './subscriptions-Dy_BNyPE.js';
 
 /** `@mesub/node/next`: `withMesub()`. Web `Request`/`Response` only, nothing imported from `next`. */
 

package/dist/next.js

@@ -3,7 +3,7 @@ import {
   checkWidgetOptions,
   handleWidget,
   widgetCustomer
-} from "./chunk-PFI3Y32I.js";
+} from "./chunk-ANBU7BJU.js";
 import {
   accessOf,
   askerOf,
@@ -15,10 +15,10 @@ import {
   guard,
   plansOf,
   retryAfterOf
-} from "./chunk-EPOLIEGY.js";
+} from "./chunk-EGGKTDHO.js";
 import {
   MesubError
-} from "./chunk-IG4QRQSJ.js";
+} from "./chunk-QDBKSJ56.js";
 
 // src/next.ts
 function withMesub(handler, options) {

package/dist/{routes-DT8EFWSl.d.cts → routes-BpOV9UAR.d.cts}

@@ -1,5 +1,5 @@
-import { C as Customer, j as ServerSubscription } from './subscriptions-B6Lin6i_.cjs';
-import { M as Mesub } from './client-BZB6KIGd.cjs';
+import { C as Customer, j as ServerSubscription } from './subscriptions-Dy_BNyPE.cjs';
+import { M as Mesub } from './client-B2DttW-V.cjs';
 
 /**
  * The routes `@mesub/react` calls on your own server, so the browser never

package/dist/{routes-KoaD1Xsk.d.ts → routes-DWhspa6s.d.ts}

@@ -1,5 +1,5 @@
-import { C as Customer, j as ServerSubscription } from './subscriptions-B6Lin6i_.js';
-import { M as Mesub } from './client-Q5QhXphp.js';
+import { C as Customer, j as ServerSubscription } from './subscriptions-Dy_BNyPE.js';
+import { M as Mesub } from './client-BHrc_yO3.js';
 
 /**
  * The routes `@mesub/react` calls on your own server, so the browser never

package/dist/situations.cjs

@@ -4,12 +4,12 @@
 
 
 
-var _chunk43Q4PNF7cjs = require('./chunk-43Q4PNF7.cjs');
+var _chunk4M3ACBWXcjs = require('./chunk-4M3ACBWX.cjs');
 
 
 
 
 
 
-exports.ACCESS_LINE = _chunk43Q4PNF7cjs.ACCESS_LINE; exports.CONFIRMATIONS = _chunk43Q4PNF7cjs.CONFIRMATIONS; exports.SITUATIONS = _chunk43Q4PNF7cjs.SITUATIONS; exports.explain = _chunk43Q4PNF7cjs.explain; exports.situationOf = _chunk43Q4PNF7cjs.situationOf;
+exports.ACCESS_LINE = _chunk4M3ACBWXcjs.ACCESS_LINE; exports.CONFIRMATIONS = _chunk4M3ACBWXcjs.CONFIRMATIONS; exports.SITUATIONS = _chunk4M3ACBWXcjs.SITUATIONS; exports.explain = _chunk4M3ACBWXcjs.explain; exports.situationOf = _chunk4M3ACBWXcjs.situationOf;
 //# sourceMappingURL=situations.cjs.map

package/dist/situations.d.cts

@@ -1,4 +1,4 @@
-import { A as AccessAnswer, j as ServerSubscription } from './subscriptions-B6Lin6i_.cjs';
+import { A as AccessAnswer, j as ServerSubscription } from './subscriptions-Dy_BNyPE.cjs';
 
 /**
  * One sentence per subscription situation, for the subscriber and for the
@@ -274,6 +274,46 @@ declare const SITUATIONS: {
             readonly route: "POST /v1/subscriptions/:id/cancel";
         }];
     };
+    readonly blocked_receiver_account_needs_memo: {
+        readonly subscriber: "Mesub cannot take your payments for {plan_name} for now, because of how the plan is set up, not because of anything you did: there is nothing for you to do or sign, and Mesub keeps trying.[ You keep access until {access_until} if no payment goes through by then.] Access comes back on its own with the first payment that goes through.";
+        readonly merchant: "Payments blocked[ since {blocked_since}] by your plan's setup: the token account of the wallet that receives its payments requires a memo on every payment in, which Mesub's charges do not carry. Turn that requirement off for the account, or choose another receiving wallet; Mesub keeps trying.[ Access ends on {access_until} if nothing is collected by then.] Access comes back with the first payment that goes through, with nothing for the subscriber to sign.";
+        readonly actions: readonly [{
+            readonly by: "subscriber";
+            readonly action: "cancel";
+            readonly sdk: "subscriptions.cancel";
+            readonly route: "POST /v1/subscriptions/:id/cancel";
+        }];
+    };
+    readonly blocked_receiver_account_confidential_only: {
+        readonly subscriber: "Mesub cannot take your payments for {plan_name} for now, because of how the plan is set up, not because of anything you did: there is nothing for you to do or sign, and Mesub keeps trying.[ You keep access until {access_until} if no payment goes through by then.] Access comes back on its own with the first payment that goes through.";
+        readonly merchant: "Payments blocked[ since {blocked_since}] by your plan's setup: the token account of the wallet that receives its payments takes confidential transfers only, and Mesub's charges are plain ones. Allow plain transfers into the account, or choose another receiving wallet; Mesub keeps trying.[ Access ends on {access_until} if nothing is collected by then.] Access comes back with the first payment that goes through, with nothing for the subscriber to sign.";
+        readonly actions: readonly [{
+            readonly by: "subscriber";
+            readonly action: "cancel";
+            readonly sdk: "subscriptions.cancel";
+            readonly route: "POST /v1/subscriptions/:id/cancel";
+        }];
+    };
+    readonly blocked_mint_paused: {
+        readonly subscriber: "Mesub cannot take your payments for {plan_name} for now, because of the token it is paid in, not because of anything you did: there is nothing for you to do or sign, and Mesub keeps trying.[ You keep access until {access_until} if no payment goes through by then.] Access comes back on its own with the first payment that goes through.";
+        readonly merchant: "Payments blocked[ since {blocked_since}] by the plan's token: its issuer paused it, so no payment in it can move. Only the issuer can lift the pause, and Mesub charges again once they do.[ Access ends on {access_until} if nothing is collected by then.] Access comes back with the first payment that goes through, with nothing for the subscriber to sign.";
+        readonly actions: readonly [{
+            readonly by: "subscriber";
+            readonly action: "cancel";
+            readonly sdk: "subscriptions.cancel";
+            readonly route: "POST /v1/subscriptions/:id/cancel";
+        }];
+    };
+    readonly blocked_mint_transfer_hook: {
+        readonly subscriber: "Mesub cannot take your payments for {plan_name} for now, because of the token it is paid in, not because of anything you did: there is nothing for you to do or sign, and Mesub keeps trying.[ You keep access until {access_until} if no payment goes through by then.] Access comes back on its own with the first payment that goes through.";
+        readonly merchant: "Payments blocked[ since {blocked_since}] by the plan's token: its issuer made every transfer of it run their own program, which Mesub does not support yet. Mesub charges again if the issuer removes it; otherwise, create a new plan with another token.[ Access ends on {access_until} if nothing is collected by then.] Access comes back with the first payment that goes through, with nothing for the subscriber to sign.";
+        readonly actions: readonly [{
+            readonly by: "subscriber";
+            readonly action: "cancel";
+            readonly sdk: "subscriptions.cancel";
+            readonly route: "POST /v1/subscriptions/:id/cancel";
+        }];
+    };
     readonly blocked_mint_gone: {
         readonly subscriber: "Mesub can no longer take your payments for {plan_name}: the token it is paid in no longer exists. This is not because of anything you did, and there is nothing for you to do or sign.[ You keep access until {access_until}.] No payment can go through on this plan again, so once access ends it does not come back.";
         readonly merchant: "Payments blocked[ since {blocked_since}] by your plan's setup: the plan's token no longer exists on chain, so nothing can be collected on it. Create a new plan with another token.[ Access ends on {access_until}.] No payment can go through on this plan again, so once access ends it does not come back.";

package/dist/situations.d.ts

@@ -1,4 +1,4 @@
-import { A as AccessAnswer, j as ServerSubscription } from './subscriptions-B6Lin6i_.js';
+import { A as AccessAnswer, j as ServerSubscription } from './subscriptions-Dy_BNyPE.js';
 
 /**
  * One sentence per subscription situation, for the subscriber and for the
@@ -274,6 +274,46 @@ declare const SITUATIONS: {
             readonly route: "POST /v1/subscriptions/:id/cancel";
         }];
     };
+    readonly blocked_receiver_account_needs_memo: {
+        readonly subscriber: "Mesub cannot take your payments for {plan_name} for now, because of how the plan is set up, not because of anything you did: there is nothing for you to do or sign, and Mesub keeps trying.[ You keep access until {access_until} if no payment goes through by then.] Access comes back on its own with the first payment that goes through.";
+        readonly merchant: "Payments blocked[ since {blocked_since}] by your plan's setup: the token account of the wallet that receives its payments requires a memo on every payment in, which Mesub's charges do not carry. Turn that requirement off for the account, or choose another receiving wallet; Mesub keeps trying.[ Access ends on {access_until} if nothing is collected by then.] Access comes back with the first payment that goes through, with nothing for the subscriber to sign.";
+        readonly actions: readonly [{
+            readonly by: "subscriber";
+            readonly action: "cancel";
+            readonly sdk: "subscriptions.cancel";
+            readonly route: "POST /v1/subscriptions/:id/cancel";
+        }];
+    };
+    readonly blocked_receiver_account_confidential_only: {
+        readonly subscriber: "Mesub cannot take your payments for {plan_name} for now, because of how the plan is set up, not because of anything you did: there is nothing for you to do or sign, and Mesub keeps trying.[ You keep access until {access_until} if no payment goes through by then.] Access comes back on its own with the first payment that goes through.";
+        readonly merchant: "Payments blocked[ since {blocked_since}] by your plan's setup: the token account of the wallet that receives its payments takes confidential transfers only, and Mesub's charges are plain ones. Allow plain transfers into the account, or choose another receiving wallet; Mesub keeps trying.[ Access ends on {access_until} if nothing is collected by then.] Access comes back with the first payment that goes through, with nothing for the subscriber to sign.";
+        readonly actions: readonly [{
+            readonly by: "subscriber";
+            readonly action: "cancel";
+            readonly sdk: "subscriptions.cancel";
+            readonly route: "POST /v1/subscriptions/:id/cancel";
+        }];
+    };
+    readonly blocked_mint_paused: {
+        readonly subscriber: "Mesub cannot take your payments for {plan_name} for now, because of the token it is paid in, not because of anything you did: there is nothing for you to do or sign, and Mesub keeps trying.[ You keep access until {access_until} if no payment goes through by then.] Access comes back on its own with the first payment that goes through.";
+        readonly merchant: "Payments blocked[ since {blocked_since}] by the plan's token: its issuer paused it, so no payment in it can move. Only the issuer can lift the pause, and Mesub charges again once they do.[ Access ends on {access_until} if nothing is collected by then.] Access comes back with the first payment that goes through, with nothing for the subscriber to sign.";
+        readonly actions: readonly [{
+            readonly by: "subscriber";
+            readonly action: "cancel";
+            readonly sdk: "subscriptions.cancel";
+            readonly route: "POST /v1/subscriptions/:id/cancel";
+        }];
+    };
+    readonly blocked_mint_transfer_hook: {
+        readonly subscriber: "Mesub cannot take your payments for {plan_name} for now, because of the token it is paid in, not because of anything you did: there is nothing for you to do or sign, and Mesub keeps trying.[ You keep access until {access_until} if no payment goes through by then.] Access comes back on its own with the first payment that goes through.";
+        readonly merchant: "Payments blocked[ since {blocked_since}] by the plan's token: its issuer made every transfer of it run their own program, which Mesub does not support yet. Mesub charges again if the issuer removes it; otherwise, create a new plan with another token.[ Access ends on {access_until} if nothing is collected by then.] Access comes back with the first payment that goes through, with nothing for the subscriber to sign.";
+        readonly actions: readonly [{
+            readonly by: "subscriber";
+            readonly action: "cancel";
+            readonly sdk: "subscriptions.cancel";
+            readonly route: "POST /v1/subscriptions/:id/cancel";
+        }];
+    };
     readonly blocked_mint_gone: {
         readonly subscriber: "Mesub can no longer take your payments for {plan_name}: the token it is paid in no longer exists. This is not because of anything you did, and there is nothing for you to do or sign.[ You keep access until {access_until}.] No payment can go through on this plan again, so once access ends it does not come back.";
         readonly merchant: "Payments blocked[ since {blocked_since}] by your plan's setup: the plan's token no longer exists on chain, so nothing can be collected on it. Create a new plan with another token.[ Access ends on {access_until}.] No payment can go through on this plan again, so once access ends it does not come back.";

package/dist/situations.js

@@ -4,7 +4,7 @@ import {
   SITUATIONS,
   explain,
   situationOf
-} from "./chunk-JJWHMB2X.js";
+} from "./chunk-R4H46TSQ.js";
 export {
   ACCESS_LINE,
   CONFIRMATIONS,

package/dist/{subscriptions-B6Lin6i_.d.cts → subscriptions-Dy_BNyPE.d.cts}

@@ -48,10 +48,13 @@ type StopReason = 'out_of_retries' | 'retry_deadline_passed' | 'authority_closed
  * doing (Mesub-io/backend#398). The merchant's own setup, theirs to fix, by
  * name: Mesub's puller taken off the plan on chain, a receiving wallet that
  * is not in the plan's destinations, has no token account for the plan's
- * token or whose token account is frozen (Mesub-io/backend#395), a token
- * that no longer exists. `mesub` for every cause of Mesub's.
+ * token, whose token account is frozen (Mesub-io/backend#395) or refuses a
+ * plain transfer in (a memo required, or confidential transfers only), a
+ * token that no longer exists. Two are the token issuer's to lift, not the
+ * merchant's: a token its issuer paused, or gave a transfer hook program
+ * (Mesub-io/backend#396). `mesub` for every cause of Mesub's.
  */
-type BlockedReason = 'puller_not_allowed' | 'receiver_not_allowed' | 'receiver_account_missing' | 'receiver_account_frozen' | 'mint_gone' | 'mesub';
+type BlockedReason = 'puller_not_allowed' | 'receiver_not_allowed' | 'receiver_account_missing' | 'receiver_account_frozen' | 'receiver_account_needs_memo' | 'receiver_account_confidential_only' | 'mint_gone' | 'mint_paused' | 'mint_transfer_hook' | 'mesub';
 /**
  * `blocked` is a pull nothing was tried for, none of it the subscriber's
  * doing (Mesub's fee payer, the network): it never counts against them.

package/dist/{subscriptions-B6Lin6i_.d.ts → subscriptions-Dy_BNyPE.d.ts}

@@ -48,10 +48,13 @@ type StopReason = 'out_of_retries' | 'retry_deadline_passed' | 'authority_closed
  * doing (Mesub-io/backend#398). The merchant's own setup, theirs to fix, by
  * name: Mesub's puller taken off the plan on chain, a receiving wallet that
  * is not in the plan's destinations, has no token account for the plan's
- * token or whose token account is frozen (Mesub-io/backend#395), a token
- * that no longer exists. `mesub` for every cause of Mesub's.
+ * token, whose token account is frozen (Mesub-io/backend#395) or refuses a
+ * plain transfer in (a memo required, or confidential transfers only), a
+ * token that no longer exists. Two are the token issuer's to lift, not the
+ * merchant's: a token its issuer paused, or gave a transfer hook program
+ * (Mesub-io/backend#396). `mesub` for every cause of Mesub's.
  */
-type BlockedReason = 'puller_not_allowed' | 'receiver_not_allowed' | 'receiver_account_missing' | 'receiver_account_frozen' | 'mint_gone' | 'mesub';
+type BlockedReason = 'puller_not_allowed' | 'receiver_not_allowed' | 'receiver_account_missing' | 'receiver_account_frozen' | 'receiver_account_needs_memo' | 'receiver_account_confidential_only' | 'mint_gone' | 'mint_paused' | 'mint_transfer_hook' | 'mesub';
 /**
  * `blocked` is a pull nothing was tried for, none of it the subscriber's
  * doing (Mesub's fee payer, the network): it never counts against them.

package/dist/testing.cjs

@@ -4,7 +4,7 @@
 
 
 
-var _chunkIAYUXSDDcjs = require('./chunk-IAYUXSDD.cjs');
+var _chunk5THDILDDcjs = require('./chunk-5THDILDD.cjs');
 
 // src/testing.ts
 var ACCESS_ATTEMPTS = 5;
@@ -108,8 +108,10 @@ var FakeMesub = (_class = class {
   
   
   
+  /** What `project()` answers: the id of the project the key belongs to. */
+  __init() {this.projectId = "proj_fake"}
   /** Every call received, oldest first. */
-  __init() {this.requests = []}
+  __init2() {this.requests = []}
   /** Hand it to `new Mesub({ fetch })`, or use `client()`. */
   
   #plans;
@@ -143,7 +145,7 @@ var FakeMesub = (_class = class {
   #tier;
   /** The hand retries fired on each late subscription, and when the last one was, by id. */
   #handRetries = /* @__PURE__ */ new Map();
-  constructor(options = {}) {;_class.prototype.__init.call(this);
+  constructor(options = {}) {;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);
     this.baseUrl = (_nullishCoalesce(options.baseUrl, () => ( "https://api.mesub.test"))).replace(/\/+$/, "");
     this.apiKey = _nullishCoalesce(options.apiKey, () => ( "SUB_test_fake"));
     const plans = _optionalChain([options, 'access', _ => _.plans, 'optionalAccess', _2 => _2.map, 'call', _3 => _3(
@@ -166,7 +168,7 @@ var FakeMesub = (_class = class {
    * unless asked, so a failure shows at once. Any other option is passed on.
    */
   client(options = {}) {
-    return new (0, _chunkIAYUXSDDcjs.Mesub)({
+    return new (0, _chunk5THDILDDcjs.Mesub)({
       maxRetries: 0,
       ...options,
       apiKey: this.apiKey,
@@ -262,7 +264,7 @@ var FakeMesub = (_class = class {
    * asked about, and to null for an external id or an email.
    */
   setAccess(customer, plan, fields) {
-    const asked = _chunkIAYUXSDDcjs.customerOf.call(void 0, customer);
+    const asked = _chunk5THDILDDcjs.customerOf.call(void 0, customer);
     const answer = { ...nothing(asked, plan), ...fields, plan };
     this.#answers.set(keyOf(asked, plan), answer);
     return this.#fresh(answer);
@@ -350,7 +352,7 @@ var FakeMesub = (_class = class {
       type,
       created_at: _nullishCoalesce(fields.created_at, () => ( now.toISOString())),
       network: "mainnet-beta",
-      api_version: _chunkIAYUXSDDcjs.API_VERSION,
+      api_version: _chunk5THDILDDcjs.API_VERSION,
       ...sequence !== null && { sequence },
       data,
       detail: _nullishCoalesce(fields.detail, () => ( detailOf(type, now, data))),
@@ -393,7 +395,7 @@ var FakeMesub = (_class = class {
       type,
       created_at: _nullishCoalesce(fields.created_at, () => ( now.toISOString())),
       network: "mainnet-beta",
-      api_version: _chunkIAYUXSDDcjs.API_VERSION,
+      api_version: _chunk5THDILDDcjs.API_VERSION,
       ...sequence !== null && { sequence },
       data,
       detail: _nullishCoalesce(fields.detail, () => ( detailOf(type, now, data)))
@@ -499,7 +501,7 @@ var FakeMesub = (_class = class {
       type: each,
       created_at,
       network: "mainnet-beta",
-      api_version: _chunkIAYUXSDDcjs.API_VERSION,
+      api_version: _chunk5THDILDDcjs.API_VERSION,
       sequence: this.#nextSequence(subscription.id),
       data: structuredClone(data),
       detail: eachDetail
@@ -563,12 +565,12 @@ var FakeMesub = (_class = class {
     if (key !== this.apiKey) {
       return error(401, "invalid_api_key", "That API key is not valid.");
     }
-    const version = headers.get(_chunkIAYUXSDDcjs.API_VERSION_HEADER);
-    if (version !== null && version !== _chunkIAYUXSDDcjs.API_VERSION) {
+    const version = headers.get(_chunk5THDILDDcjs.API_VERSION_HEADER);
+    if (version !== null && version !== _chunk5THDILDDcjs.API_VERSION) {
       return error(
         400,
         "unsupported_version",
-        `${_chunkIAYUXSDDcjs.API_VERSION_HEADER} must be one of the versions this API serves: ${_chunkIAYUXSDDcjs.API_VERSION}.`
+        `${_chunk5THDILDDcjs.API_VERSION_HEADER} must be one of the versions this API serves: ${_chunk5THDILDDcjs.API_VERSION}.`
       );
     }
     if (this.#failure) {
@@ -579,6 +581,8 @@ var FakeMesub = (_class = class {
         ...retryAfter !== void 0 && { retryAfter }
       });
     }
+    if (method === "GET" && path === "/v1/project")
+      return Response.json({ id: this.projectId });
     if (method === "GET" && path === "/v1/plans") {
       return Response.json({ plans: this.#planList.map((plan) => this.#served(plan)) });
     }
@@ -1018,7 +1022,7 @@ var FakeMesub = (_class = class {
     if (subscription.external_id) customers.push({ external_id: subscription.external_id });
     if (subscription.email) customers.push({ email: subscription.email });
     for (const customer of customers) {
-      const before = this.#answers.get(keyOf(_chunkIAYUXSDDcjs.customerOf.call(void 0, customer), plan));
+      const before = this.#answers.get(keyOf(_chunk5THDILDDcjs.customerOf.call(void 0, customer), plan));
       this.setAccess(customer, plan, {
         wallet: subscription.wallet,
         access: subscription.access,
@@ -1288,7 +1292,7 @@ async function signWebhook(payload, options) {
   const body = typeof payload === "string" ? payload : JSON.stringify(payload);
   const id = _nullishCoalesce(options.id, () => ( `msg_signed_${signedIds += 1}`));
   const timestamp = _nullishCoalesce(options.timestamp, () => ( Math.floor(Date.now() / 1e3)));
-  return { body, headers: await _chunkIAYUXSDDcjs.signedHeaders.call(void 0, options.secret, id, timestamp, body) };
+  return { body, headers: await _chunk5THDILDDcjs.signedHeaders.call(void 0, options.secret, id, timestamp, body) };
 }
 function detailOf(type, now, data) {
   const start = now.toISOString();
@@ -1391,7 +1395,7 @@ function invalidSubmit(body) {
 }
 function askedIn(query) {
   try {
-    return _chunkIAYUXSDDcjs.customerOf.call(void 0, {
+    return _chunk5THDILDDcjs.customerOf.call(void 0, {
       wallet: query["wallet"],
       external_id: query["external_id"],
       email: query["email"]
@@ -1476,7 +1480,7 @@ function error(status, code, message, { retryable, retryAfter } = {}) {
 async function stamped(response, id) {
   const headers = new Headers(response.headers);
   headers.set(REQUEST_ID_HEADER, id);
-  headers.set(_chunkIAYUXSDDcjs.API_VERSION_HEADER, _chunkIAYUXSDDcjs.API_VERSION);
+  headers.set(_chunk5THDILDDcjs.API_VERSION_HEADER, _chunk5THDILDDcjs.API_VERSION);
   if (response.ok) return new Response(response.body, { status: response.status, headers });
   const body = await response.json();
   return Response.json({ ...body, request_id: id }, { status: response.status, headers });