@rdlabo/workers-hono-kit 0.6.8 → 0.6.9

package/dist/index.d.ts

@@ -48,7 +48,7 @@ export type { KVNamespace, KVCacheOptions } from './cache/kv-cache.js';
 export { createStripeClient, verifyStripeWebhook } from './stripe/client.js';
 export type { CreateStripeClientOptions } from './stripe/client.js';
 export { extractStripeFailureReason, stripeFailureMessageJa, serializePaymentFailure, parsePaymentFailure, PaymentDeclinedError, toPaymentDeclinedError, } from './stripe/failure.js';
-export type { StripeFailureReason, PaymentFailureSource, PaymentFailureRecord, PaymentDeclinedBody, } from './stripe/failure.js';
+export type { StripeFailureReason, PaymentFailureSource, PaymentFailureRecord, PaymentFailureReason, IapFailureReason, PaymentDeclinedBody, } from './stripe/failure.js';
 export { classifyStripeReconcile } from './stripe/reconcile.js';
 export type { StripeReconcileAction } from './stripe/reconcile.js';
 export { paymentFailureMessageJa, iapFailureKey, UNRESOLVED_PAYMENT_STATUSES } from './payment/failure.js';

package/dist/payment/failure.d.ts

@@ -1,4 +1,4 @@
-import type { StripeFailureReason } from '../stripe/failure.js';
+import type { PaymentFailureReason } from '../stripe/failure.js';
 /**
  * Provider-agnostic status of a row in the `payment_failed` table.
  *
@@ -35,22 +35,23 @@ export declare function paymentFailureMessageJa(input: {
     status: PaymentFailureStatus;
     /** The row `type` (stripe/ios/android). Typed as `string` since it comes from the DB column. */
     type?: string | null;
-    reason?: StripeFailureReason | null;
+    reason?: PaymentFailureReason | null;
 }): string;
 /**
- * Build the `payment_failed.recursions_id` (PRIMARY KEY) with a per-type namespace.
+ * Build the provider-native `payment_failed.recursions_id`.
  *
  * @remarks
- * - iOS: `ios:${original_transaction_id}:${expires_date_ms}`. `original_transaction_id` is stable
+ * - iOS: `${original_transaction_id}:${expires_date_ms}`. `original_transaction_id` is stable
  *   across re-subscribes, so keying on it alone would let the resolved-reopen guard permanently mask
  *   every event after the first. Including `expires_date_ms` makes each billing cycle a distinct row,
  *   while the same cycle's daily reconcile (billing-retry) still converges to one row.
- * - Android: `android:${orderId}` — Google issues a new orderId per subscription, so it is already
- *   cycle-specific; the `android:` prefix only guards against cross-type PK collisions.
+ * - Android: `${orderId}` — Google issues a new orderId per subscription, so it is already cycle-specific.
  *
  * Stripe rows use the invoice / subscription id directly (globally unique) and need no helper.
  *
- * @remarks Fits the fleet's `payment_failed.recursions_id` `varchar(50)` (iOS ≤ ~38, Android ≤ ~36 chars).
+ * The provider is stored separately in the `type` column. Provider-native ID formats are disjoint in practice
+ * (Apple numeric pair / Google `GPA.*` / Stripe `in_*` or `sub_*`), so duplicating `type` in the primary-key value
+ * is unnecessary.
  */
 export declare function iapFailureKey(input: {
     platform: 'ios';

package/dist/payment/failure.js

@@ -32,25 +32,25 @@ export function paymentFailureMessageJa(input) {
     if (input.status === 'failed' && (input.type === 'ios' || input.type === 'android')) {
         return IAP_FAILED_MESSAGE_JA[input.type];
     }
-    return stripeFailureMessageJa(input.reason ?? null);
+    const stripeReason = input.reason && !('provider' in input.reason) ? input.reason : null;
+    return stripeFailureMessageJa(stripeReason);
 }
 /**
- * Build the `payment_failed.recursions_id` (PRIMARY KEY) with a per-type namespace.
+ * Build the provider-native `payment_failed.recursions_id`.
  *
  * @remarks
- * - iOS: `ios:${original_transaction_id}:${expires_date_ms}`. `original_transaction_id` is stable
+ * - iOS: `${original_transaction_id}:${expires_date_ms}`. `original_transaction_id` is stable
  *   across re-subscribes, so keying on it alone would let the resolved-reopen guard permanently mask
  *   every event after the first. Including `expires_date_ms` makes each billing cycle a distinct row,
  *   while the same cycle's daily reconcile (billing-retry) still converges to one row.
- * - Android: `android:${orderId}` — Google issues a new orderId per subscription, so it is already
- *   cycle-specific; the `android:` prefix only guards against cross-type PK collisions.
+ * - Android: `${orderId}` — Google issues a new orderId per subscription, so it is already cycle-specific.
  *
  * Stripe rows use the invoice / subscription id directly (globally unique) and need no helper.
  *
- * @remarks Fits the fleet's `payment_failed.recursions_id` `varchar(50)` (iOS ≤ ~38, Android ≤ ~36 chars).
+ * The provider is stored separately in the `type` column. Provider-native ID formats are disjoint in practice
+ * (Apple numeric pair / Google `GPA.*` / Stripe `in_*` or `sub_*`), so duplicating `type` in the primary-key value
+ * is unnecessary.
  */
 export function iapFailureKey(input) {
-    return input.platform === 'ios'
-        ? `ios:${input.originalTransactionId}:${input.expiresDateMs}`
-        : `android:${input.orderId}`;
+    return input.platform === 'ios' ? `${input.originalTransactionId}:${input.expiresDateMs}` : input.orderId;
 }

package/dist/stripe/failure.d.ts

@@ -22,6 +22,23 @@ export interface StripeFailureReason {
     /** Id of the Subscription the failing invoice belongs to, when resolvable. */
     subscriptionId?: string;
 }
+/** Normalized reason persisted for an App Store / Google Play subscription failure. */
+export interface IapFailureReason {
+    /** Provider discriminator. */
+    provider: 'ios' | 'android';
+    /** Stable machine-readable classification. */
+    code: 'billing_retry' | 'auto_renew_off' | 'subscription_canceled' | 'subscription_gone';
+    /** Provider response status code when present (Apple verifyReceipt status / Google error code). */
+    statusCode?: number;
+    /** Apple auto-renew status (`'0'` means disabled). */
+    autoRenewStatus?: string;
+    /** Apple billing-retry status (`'1'` means retrying a failed renewal). */
+    billingRetryStatus?: string;
+    /** Google cancellation reason code (0=user, 1=system, 2=replaced, 3=developer). */
+    cancelReason?: number;
+}
+/** Provider-specific diagnostic reason stored in `payment_failed.receipt`. */
+export type PaymentFailureReason = StripeFailureReason | IapFailureReason;
 /** Where a {@link PaymentFailureRecord} was captured. */
 export type PaymentFailureSource = 'webhook.invoice.payment_failed' | 'webhook.invoice.payment_action_required' | 'reconcile' | 'checkout' | 'iap';
 /**
@@ -32,7 +49,7 @@ export type PaymentFailureSource = 'webhook.invoice.payment_failed' | 'webhook.i
  * on read via {@link stripeFailureMessageJa} so that wording changes never require a data migration.
  */
 export interface PaymentFailureRecord {
-    reason: StripeFailureReason;
+    reason: PaymentFailureReason;
     source: PaymentFailureSource;
     /** ISO 8601 timestamp of when the failure was captured. */
     occurredAt: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rdlabo/workers-hono-kit",
-  "version": "0.6.8",
+  "version": "0.6.9",
   "private": false,
   "publishConfig": {
     "access": "public"