@cosmicdrift/kumiko-bundled-features 0.369.0 → 0.371.0

package/dist/billing-foundation/consumer-protection/confirmation-mail.d.ts

@@ -1,5 +1,5 @@
-import type { CheckoutConsentRecordedPayload } from "../events.js";
-import { type ConsentLocale } from "./consent-text.js";
+import type { CheckoutConsentRecordedPayload } from "../events.ts";
+import { type ConsentLocale } from "./consent-text.ts";
 type ConfirmationLabels = {
     readonly subject: string;
     readonly intro: string;

package/dist/billing-foundation/consumer-protection/consent-gate.d.ts

@@ -1,6 +1,6 @@
 import { type HandlerContext } from "@cosmicdrift/kumiko-framework/engine";
 import * as z from "zod";
-import type { ConsumerProtectionOptions, ProviderPrice } from "../types.js";
+import type { ConsumerProtectionOptions, ProviderPrice } from "../types.ts";
 export type CheckoutMode = "subscription" | "payment";
 export declare const consentPayloadSchema: z.ZodObject<{
     earlyPerformanceRequested: z.ZodBoolean;

package/dist/billing-foundation/consumer-protection/consent-text.d.ts

@@ -1,5 +1,5 @@
-import type { ConsentLocale } from "./consent-locale.js";
-export { CONSENT_LOCALES, type ConsentLocale, FALLBACK_CONSENT_LOCALE, resolveConsentLocale, } from "./consent-locale.js";
+import type { ConsentLocale } from "./consent-locale.ts";
+export { CONSENT_LOCALES, type ConsentLocale, FALLBACK_CONSENT_LOCALE, resolveConsentLocale, } from "./consent-locale.ts";
 export type ConsentTexts = {
     readonly earlyPerformance: string;
     readonly withdrawalLoss: string;

package/dist/billing-foundation/consumer-protection/issue-confirmation.d.ts

@@ -1,6 +1,6 @@
 import { type WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
 import * as z from "zod";
-import type { ConsumerProtectionOptions, ResolvedBillingFoundationOptions } from "../types.js";
+import type { ConsumerProtectionOptions, ResolvedBillingFoundationOptions } from "../types.ts";
 export declare const issueContractConfirmationSchema: z.ZodObject<{
     consentId: z.ZodString;
     sourceAggregateId: z.ZodUUID;

package/dist/billing-foundation/consumer-protection/register-consent.d.ts

@@ -1,3 +1,3 @@
 import type { FeatureRegistrar } from "@cosmicdrift/kumiko-framework/engine";
-import type { ConsumerProtectionOptions, ResolvedBillingFoundationOptions } from "../types.js";
+import type { ConsumerProtectionOptions, ResolvedBillingFoundationOptions } from "../types.ts";
 export declare function registerConsumerProtection(r: FeatureRegistrar, options: ResolvedBillingFoundationOptions, consumerProtection: ConsumerProtectionOptions): void;

package/dist/billing-foundation/consumer-protection/register-termination.d.ts

@@ -1,3 +1,3 @@
 import type { FeatureRegistrar } from "@cosmicdrift/kumiko-framework/engine";
-import type { ConsumerProtectionOptions, ResolvedBillingFoundationOptions } from "../types.js";
+import type { ConsumerProtectionOptions, ResolvedBillingFoundationOptions } from "../types.ts";
 export declare function registerContractTermination(r: FeatureRegistrar, options: ResolvedBillingFoundationOptions, consumerProtection: ConsumerProtectionOptions): void;

package/dist/billing-foundation/consumer-protection/termination-mail.d.ts

@@ -1,6 +1,6 @@
-import type { ContractTerminationDeclarationType, ContractTerminationKind, ProviderCancelOutcome } from "../events.js";
-import type { ConsentLocale } from "./consent-text.js";
-import { type OperatorNoticeReason } from "./termination-texts.js";
+import type { ContractTerminationDeclarationType, ContractTerminationKind, ProviderCancelOutcome } from "../events.ts";
+import type { ConsentLocale } from "./consent-text.ts";
+import { type OperatorNoticeReason } from "./termination-texts.ts";
 type TextRow = {
     readonly text: string;
 };

package/dist/billing-foundation/consumer-protection/termination-notify.d.ts

@@ -1,9 +1,9 @@
 import type { HandlerContext } from "@cosmicdrift/kumiko-framework/engine";
-import type { ProviderCancelOutcome } from "../events.js";
-import type { ConsumerProtectionOptions } from "../types.js";
-import type { ConsentLocale } from "./consent-text.js";
-import { type OperatorNoticeDeclaration } from "./termination-mail.js";
-import type { OperatorNoticeReason } from "./termination-texts.js";
+import type { ProviderCancelOutcome } from "../events.ts";
+import type { ConsumerProtectionOptions } from "../types.ts";
+import type { ConsentLocale } from "./consent-text.ts";
+import { type OperatorNoticeDeclaration } from "./termination-mail.ts";
+import type { OperatorNoticeReason } from "./termination-texts.ts";
 export type OperatorNoticePlan = {
     readonly locale: ConsentLocale;
     readonly requestId: string;

package/dist/billing-foundation/consumer-protection/termination-pages.d.ts

@@ -1,6 +1,6 @@
 import { type AnonymousExtraRoute } from "@cosmicdrift/kumiko-framework/api";
-import { type PublicPageWrapLayout } from "../../page-render/index.js";
-import type { ConsentLocale } from "./consent-text.js";
+import { type PublicPageWrapLayout } from "../../page-render/index.ts";
+import type { ConsentLocale } from "./consent-text.ts";
 export type ContractTerminationRoutesOptions = {
     readonly paths?: Readonly<Partial<Record<ConsentLocale, string>>>;
     /** Layout around every page (form, review, result, 429, error). Default:

package/dist/billing-foundation/consumer-protection/termination-record.d.ts

@@ -1,8 +1,8 @@
 import { type QueryHandlerDef, type WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
 import * as z from "zod";
-import { type ProviderCancelOutcome } from "../events.js";
-import type { ConsumerProtectionOptions, ResolvedBillingFoundationOptions } from "../types.js";
-import type { OperatorNoticeReason } from "./termination-texts.js";
+import { type ProviderCancelOutcome } from "../events.ts";
+import type { ConsumerProtectionOptions, ResolvedBillingFoundationOptions } from "../types.ts";
+import type { OperatorNoticeReason } from "./termination-texts.ts";
 export declare const recordContractTerminationSchema: z.ZodObject<{
     requestId: z.ZodString;
     declarationType: z.ZodEnum<{

package/dist/billing-foundation/consumer-protection/termination-request.d.ts

@@ -1,7 +1,7 @@
 import { type WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
 import * as z from "zod";
-import { type ProviderCancelOutcome } from "../events.js";
-import type { ConsumerProtectionOptions, ResolvedBillingFoundationOptions } from "../types.js";
+import { type ProviderCancelOutcome } from "../events.ts";
+import type { ConsumerProtectionOptions, ResolvedBillingFoundationOptions } from "../types.ts";
 export declare const requestContractTerminationSchema: z.ZodObject<{
     declarationType: z.ZodEnum<{
         termination: "termination";

package/dist/billing-foundation/consumer-protection/termination-texts.d.ts

@@ -1,5 +1,5 @@
-import type { ContractTerminationDeclarationType, ContractTerminationKind } from "../events.js";
-import type { ConsentLocale } from "./consent-text.js";
+import type { ContractTerminationDeclarationType, ContractTerminationKind } from "../events.ts";
+import type { ConsentLocale } from "./consent-text.ts";
 export type TerminationTexts = {
     readonly declarationTypeLabel: Readonly<Record<ContractTerminationDeclarationType, string>>;
     readonly terminationKindLabel: Readonly<Record<ContractTerminationKind, string>>;

package/dist/billing-foundation/feature.d.ts

@@ -1,5 +1,3 @@
 import { type FeatureDefinition } from "@cosmicdrift/kumiko-framework/engine";
-import type { BillingFoundationOptions } from "./types.js";
+import type { BillingFoundationOptions } from "./types.ts";
 export declare function createBillingFoundationFeature<TTier extends string = string>(options?: BillingFoundationOptions<TTier>): FeatureDefinition;
-/** @deprecated Use createBillingFoundationFeature(). Run `bun kumiko-upgrade --apply`. Removed in the first release after 2026-10-29. */
-export declare const billingFoundationFeature: FeatureDefinition;

package/dist/billing-foundation/feature.js

@@ -219,5 +219,3 @@ export function createBillingFoundationFeature(options = {}) {
         });
     }, Object.keys(options).length === 0 ? { dedupeOptions: {} } : undefined);
 }
-/** @deprecated Use createBillingFoundationFeature(). Run `bun kumiko-upgrade --apply`. Removed in the first release after 2026-10-29. */
-export const billingFoundationFeature = createBillingFoundationFeature();

package/dist/billing-foundation/handlers/billing-plans.query.d.ts

@@ -1,3 +1,3 @@
 import type { QueryHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
-import { type BillingPlanCatalog, type ResolvedBillingFoundationOptions } from "../types.js";
+import { type BillingPlanCatalog, type ResolvedBillingFoundationOptions } from "../types.ts";
 export declare function createBillingPlansQuery(options: ResolvedBillingFoundationOptions, catalog: BillingPlanCatalog): QueryHandlerDef;

package/dist/billing-foundation/handlers/create-checkout-session.write.d.ts

@@ -1,3 +1,3 @@
 import type { WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
-import type { ResolvedBillingFoundationOptions } from "../types.js";
+import type { ResolvedBillingFoundationOptions } from "../types.ts";
 export declare function createCheckoutSessionHandler(options: ResolvedBillingFoundationOptions): WriteHandlerDef;

package/dist/billing-foundation/handlers/create-portal-session.write.d.ts

@@ -1,3 +1,3 @@
 import type { WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
-import type { BillingFoundationOptions } from "../types.js";
+import type { BillingFoundationOptions } from "../types.ts";
 export declare function createPortalSessionHandler(options: BillingFoundationOptions): WriteHandlerDef;

package/dist/billing-foundation/handlers/start-plan-checkout.write.d.ts

@@ -1,3 +1,3 @@
 import type { WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
-import type { BillingPlanCatalog, ResolvedBillingFoundationOptions } from "../types.js";
+import type { BillingPlanCatalog, ResolvedBillingFoundationOptions } from "../types.ts";
 export declare function createStartPlanCheckoutHandler(options: ResolvedBillingFoundationOptions, catalog: BillingPlanCatalog): WriteHandlerDef;

package/dist/billing-foundation/handlers/switch-plan.write.d.ts

@@ -1,3 +1,3 @@
 import type { WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
-import type { BillingFoundationOptions, BillingPlanCatalog } from "../types.js";
+import type { BillingFoundationOptions, BillingPlanCatalog } from "../types.ts";
 export declare function createSwitchPlanHandler(options: BillingFoundationOptions, catalog: BillingPlanCatalog): WriteHandlerDef;

package/dist/billing-foundation/index.d.ts

@@ -1,16 +1,16 @@
-export { paymentAggregateId, subscriptionAggregateId } from "./aggregate-id.js";
-export { type BillingInfo, type BillingInfoQueryDeps, createBillingInfoQueryConfig, } from "./billing-info-query.js";
-export { isBillingEnabled, type ResolvedProvider, resolveProviderPlugin, } from "./checkout-core.js";
-export { BILLING_FOUNDATION_FEATURE, BILLING_PLANS_PANEL_COMPONENT, BILLING_PLANS_SCREEN_ID, type BillingEventKind, BillingEventKinds, type BillingPlanAction, BillingPlanActions, DEFAULT_PURCHASE_ROLES, isSwitchableSubscriptionStatus, isTerminalSubscriptionStatus, parseProviderConsentId, SUBSCRIPTION_PROVIDER_EXTENSION, type SubscriptionCancelTiming, SubscriptionCancelTimings, type SubscriptionEventType, SubscriptionEventTypes, SubscriptionFoundationHandlers, SubscriptionFoundationQueries, type SubscriptionStatus, SubscriptionStatuses, } from "./constants.js";
-export { type ConsentPayload, consentPayloadSchema, type OrderItem, } from "./consumer-protection/consent-gate.js";
-export { CONSENT_LOCALES, type ConsentLocale, resolveConsentLocale, } from "./consumer-protection/consent-locale.js";
-export { type ContractTerminationRoutesOptions, createContractTerminationRoutes, } from "./consumer-protection/termination-pages.js";
-export { paymentEntity, subscriptionEntity } from "./entities.js";
-export { INVOICE_PAID_EVENT_QN, INVOICE_PAID_EVENT_SHORT, INVOICE_PAYMENT_FAILED_EVENT_QN, INVOICE_PAYMENT_FAILED_EVENT_SHORT, PAYMENT_AGGREGATE_TYPE, PAYMENT_RECEIVED_EVENT_QN, PAYMENT_RECEIVED_EVENT_SHORT, type PaymentEventHeaders, type PaymentEventPayload, paymentEventPayloadSchema, SUBSCRIPTION_AGGREGATE_TYPE, SUBSCRIPTION_CANCELED_EVENT_QN, SUBSCRIPTION_CANCELED_EVENT_SHORT, SUBSCRIPTION_CREATED_EVENT_QN, SUBSCRIPTION_CREATED_EVENT_SHORT, SUBSCRIPTION_UPDATED_EVENT_QN, SUBSCRIPTION_UPDATED_EVENT_SHORT, type SubscriptionEventHeaders, type SubscriptionEventPayload, subscriptionEventPayloadSchema, } from "./events.js";
-export { billingFoundationFeature, createBillingFoundationFeature } from "./feature.js";
-export { getSubscriptionForTenant, type SubscriptionView } from "./get-subscription-for-tenant.js";
-export { paymentsProjectionTable, subscriptionsProjectionTable } from "./projection.js";
-export { billingPlansPanel, createBillingPlansScreen } from "./screens.js";
-export { createSubscriptionTierSync, effectiveTierFromSubscription, SUBSCRIPTION_WEBHOOK_PATH, type SubscriptionTierSyncDeps, } from "./subscription-tier-sync.js";
-export { type BillingFoundationOptions, type BillingPlanBenefit, type BillingPlanCatalog, type BillingPlanPrice, type BillingPlansResult, type BillingPlanView, type ConsumerProtectionOptions, KNOWN_RECURRING_INTERVALS, type LegalLinkSet, type PaymentEvent, type ProviderPrice, type ProviderSubscriptionSnapshot, type RecurringInterval, type SubscriptionEvent, type SubscriptionProviderPlugin, } from "./types.js";
-export { createSubscriptionWebhookRoute, type SubscriptionWebhookRouteOptions, } from "./webhook-handler.js";
+export { paymentAggregateId, subscriptionAggregateId } from "./aggregate-id.ts";
+export { type BillingInfo, type BillingInfoQueryDeps, createBillingInfoQueryConfig, } from "./billing-info-query.ts";
+export { isBillingEnabled, type ResolvedProvider, resolveProviderPlugin, } from "./checkout-core.ts";
+export { BILLING_FOUNDATION_FEATURE, BILLING_PLANS_PANEL_COMPONENT, BILLING_PLANS_SCREEN_ID, type BillingEventKind, BillingEventKinds, type BillingPlanAction, BillingPlanActions, DEFAULT_PURCHASE_ROLES, isSwitchableSubscriptionStatus, isTerminalSubscriptionStatus, parseProviderConsentId, SUBSCRIPTION_PROVIDER_EXTENSION, type SubscriptionCancelTiming, SubscriptionCancelTimings, type SubscriptionEventType, SubscriptionEventTypes, SubscriptionFoundationHandlers, SubscriptionFoundationQueries, type SubscriptionStatus, SubscriptionStatuses, } from "./constants.ts";
+export { type ConsentPayload, consentPayloadSchema, type OrderItem, } from "./consumer-protection/consent-gate.ts";
+export { CONSENT_LOCALES, type ConsentLocale, resolveConsentLocale, } from "./consumer-protection/consent-locale.ts";
+export { type ContractTerminationRoutesOptions, createContractTerminationRoutes, } from "./consumer-protection/termination-pages.ts";
+export { paymentEntity, subscriptionEntity } from "./entities.ts";
+export { INVOICE_PAID_EVENT_QN, INVOICE_PAID_EVENT_SHORT, INVOICE_PAYMENT_FAILED_EVENT_QN, INVOICE_PAYMENT_FAILED_EVENT_SHORT, PAYMENT_AGGREGATE_TYPE, PAYMENT_RECEIVED_EVENT_QN, PAYMENT_RECEIVED_EVENT_SHORT, type PaymentEventHeaders, type PaymentEventPayload, paymentEventPayloadSchema, SUBSCRIPTION_AGGREGATE_TYPE, SUBSCRIPTION_CANCELED_EVENT_QN, SUBSCRIPTION_CANCELED_EVENT_SHORT, SUBSCRIPTION_CREATED_EVENT_QN, SUBSCRIPTION_CREATED_EVENT_SHORT, SUBSCRIPTION_UPDATED_EVENT_QN, SUBSCRIPTION_UPDATED_EVENT_SHORT, type SubscriptionEventHeaders, type SubscriptionEventPayload, subscriptionEventPayloadSchema, } from "./events.ts";
+export { createBillingFoundationFeature } from "./feature.ts";
+export { getSubscriptionForTenant, type SubscriptionView } from "./get-subscription-for-tenant.ts";
+export { paymentsProjectionTable, subscriptionsProjectionTable } from "./projection.ts";
+export { billingPlansPanel, createBillingPlansScreen } from "./screens.ts";
+export { createSubscriptionTierSync, effectiveTierFromSubscription, SUBSCRIPTION_WEBHOOK_PATH, type SubscriptionTierSyncDeps, type TierSyncResult, } from "./subscription-tier-sync.ts";
+export { type BillingFoundationOptions, type BillingPlanBenefit, type BillingPlanCatalog, type BillingPlanPrice, type BillingPlansResult, type BillingPlanView, type ConsumerProtectionOptions, KNOWN_RECURRING_INTERVALS, type LegalLinkSet, type PaymentEvent, type ProviderPrice, type ProviderSubscriptionSnapshot, type RecurringInterval, type SubscriptionEvent, type SubscriptionProviderPlugin, } from "./types.ts";
+export { createSubscriptionWebhookRoute, type SubscriptionWebhookRouteOptions, } from "./webhook-handler.ts";

package/dist/billing-foundation/index.js

@@ -8,7 +8,7 @@ export { CONSENT_LOCALES, resolveConsentLocale, } from "./consumer-protection/co
 export { createContractTerminationRoutes, } from "./consumer-protection/termination-pages.js";
 export { paymentEntity, subscriptionEntity } from "./entities.js";
 export { INVOICE_PAID_EVENT_QN, INVOICE_PAID_EVENT_SHORT, INVOICE_PAYMENT_FAILED_EVENT_QN, INVOICE_PAYMENT_FAILED_EVENT_SHORT, PAYMENT_AGGREGATE_TYPE, PAYMENT_RECEIVED_EVENT_QN, PAYMENT_RECEIVED_EVENT_SHORT, paymentEventPayloadSchema, SUBSCRIPTION_AGGREGATE_TYPE, SUBSCRIPTION_CANCELED_EVENT_QN, SUBSCRIPTION_CANCELED_EVENT_SHORT, SUBSCRIPTION_CREATED_EVENT_QN, SUBSCRIPTION_CREATED_EVENT_SHORT, SUBSCRIPTION_UPDATED_EVENT_QN, SUBSCRIPTION_UPDATED_EVENT_SHORT, subscriptionEventPayloadSchema, } from "./events.js";
-export { billingFoundationFeature, createBillingFoundationFeature } from "./feature.js";
+export { createBillingFoundationFeature } from "./feature.js";
 export { getSubscriptionForTenant } from "./get-subscription-for-tenant.js";
 export { paymentsProjectionTable, subscriptionsProjectionTable } from "./projection.js";
 export { billingPlansPanel, createBillingPlansScreen } from "./screens.js";

package/dist/billing-foundation/plan-catalog.d.ts

@@ -1,5 +1,5 @@
 import type { HandlerContext } from "@cosmicdrift/kumiko-framework/engine";
-import type { BillingPlanCatalog, BillingPlansResult, ProviderPrice, SubscriptionProviderPlugin } from "./types.js";
+import type { BillingPlanCatalog, BillingPlansResult, ProviderPrice, SubscriptionProviderPlugin } from "./types.ts";
 /** `catalog?.purchaseRoles ?? DEFAULT_PURCHASE_ROLES` — the one place this
  *  fallback is spelled out; plan-catalog.ts and the start-plan-checkout/
  *  switch-plan/create-portal-session handlers all call this instead of

package/dist/billing-foundation/subscription-tier-sync.d.ts

@@ -1,17 +1,36 @@
 import type { ExtraRouteDefinition, SignatureExtraRouteDeps } from "@cosmicdrift/kumiko-framework/api";
 import type { TenantId } from "@cosmicdrift/kumiko-framework/engine";
+import type { PaymentEvent, SubscriptionEvent } from "./types.ts";
 export declare const SUBSCRIPTION_WEBHOOK_PATH = "/webhooks/subscription/:providerName";
 export type SubscriptionTierSyncDeps<TTier extends string> = {
     readonly isTierName: (value: string) => value is TTier;
     readonly defaultTier: TTier;
     readonly onSyncError?: "log" | "fail-webhook";
+    /** Runs after every webhook whose sync succeeded, also when the tier stayed the same
+     *  (`changed: false`). Not called when the tenant has no subscription yet, when a
+     *  manual grant was kept, or when the sync failed. A throw counts as a sync failure
+     *  and follows `onSyncError`. */
+    readonly afterSync?: (result: TierSyncResult<TTier>) => Promise<void>;
+};
+export type TierSyncResult<TTier extends string> = {
+    readonly tenantId: TenantId;
+    /** The tier the subscription yields. */
+    readonly tier: TTier;
+    /** True when this sync created or updated the tenant's tier assignment. */
+    readonly changed: boolean;
+    readonly event: SubscriptionEvent | PaymentEvent;
+};
+type SyncError = {
+    code: string;
+    message: string;
 };
 export declare const TIER_SYNC_MANUAL_GRANT_SKIPPED = "tier_sync_manual_grant_skipped";
 export declare function effectiveTierFromSubscription<TTier extends string>(status: string | undefined, tier: string | undefined, isTierName: (value: string) => value is TTier, defaultTier: TTier): TTier;
 export declare function createSubscriptionTierSync<TTier extends string>(deps: SubscriptionTierSyncDeps<TTier>): {
-    createWebhookRoute: () => ExtraRouteDefinition;
-    syncTierFromSubscription: (tenantId: TenantId, routeDeps: Pick<SignatureExtraRouteDeps, "dispatchSystemQuery" | "dispatchSystemWrite">) => Promise<{
-        code: string;
-        message: string;
-    } | null>;
+    createWebhookRoute: (options?: {
+        readonly path?: string;
+    }) => ExtraRouteDefinition;
+    syncTierFromSubscription: (tenantId: TenantId, routeDeps: Pick<SignatureExtraRouteDeps, "dispatchSystemQuery" | "dispatchSystemWrite">) => Promise<SyncError | null>;
+    syncAndNotify: (tenantId: TenantId, event: SubscriptionEvent | PaymentEvent, routeDeps: Pick<SignatureExtraRouteDeps, "dispatchSystemQuery" | "dispatchSystemWrite">) => Promise<SyncError | null>;
 };
+export {};

package/dist/billing-foundation/subscription-tier-sync.js

@@ -41,7 +41,7 @@ function findTierAssignment(rows, tenantId) {
     };
 }
 export function createSubscriptionTierSync(deps) {
-    async function syncTierFromSubscription(tenantId, routeDeps) {
+    async function runTierSync(tenantId, routeDeps) {
         try {
             const subscriptionId = subscriptionAggregateId(tenantId);
             const subscriptionRows = asRows(await routeDeps.dispatchSystemQuery({
@@ -51,7 +51,7 @@ export function createSubscriptionTierSync(deps) {
             }));
             const sub = subscriptionRows.find((row) => row["id"] === subscriptionId);
             if (!sub)
-                return null;
+                return { error: null };
             const effective = effectiveTierFromSubscription(typeof sub["status"] === "string" ? sub["status"] : undefined, typeof sub["tier"] === "string" ? sub["tier"] : undefined, deps.isTierName, deps.defaultTier);
             const tierAssignmentRows = asRows(await routeDeps.dispatchSystemQuery({
                 handlerQn: TierEngineQueries.list,
@@ -71,18 +71,23 @@ export function createSubscriptionTierSync(deps) {
                 });
                 if (!created.isSuccess) {
                     return {
-                        code: "tier_sync_failed",
-                        message: `tier-engine create with "${effective}" failed: ${created.error?.code ?? "unknown"}`,
+                        error: {
+                            code: "tier_sync_failed",
+                            message: `tier-engine create with "${effective}" failed: ${created.error?.code ?? "unknown"}`,
+                        },
                     };
                 }
-                return null;
+                return { error: null, applied: { tier: effective, changed: true } };
+            }
+            if (assignment.tier === effective) {
+                return { error: null, applied: { tier: effective, changed: false } };
             }
-            if (assignment.tier === effective)
-                return null;
             if (assignment.source === TierAssignmentSources.manual) {
                 return {
-                    code: TIER_SYNC_MANUAL_GRANT_SKIPPED,
-                    message: `manual tier grant "${String(assignment.tier)}" kept although the subscription yields "${effective}"`,
+                    error: {
+                        code: TIER_SYNC_MANUAL_GRANT_SKIPPED,
+                        message: `manual tier grant "${String(assignment.tier)}" kept although the subscription yields "${effective}"`,
+                    },
                 };
             }
             const result = await routeDeps.dispatchSystemWrite({
@@ -96,11 +101,13 @@ export function createSubscriptionTierSync(deps) {
             });
             if (!result.isSuccess) {
                 return {
-                    code: "tier_sync_failed",
-                    message: `tier-engine update to "${effective}" failed: ${result.error?.code ?? "unknown"}`,
+                    error: {
+                        code: "tier_sync_failed",
+                        message: `tier-engine update to "${effective}" failed: ${result.error?.code ?? "unknown"}`,
+                    },
                 };
             }
-            return null;
+            return { error: null, applied: { tier: effective, changed: true } };
         }
         catch (error) {
             // dispatchSystemQuery throws (AccessDenied/NotFound/Validation) rather
@@ -109,16 +116,38 @@ export function createSubscriptionTierSync(deps) {
             // a failed dispatchSystemWrite instead of letting it bubble into the
             // webhook response as an unhandled 500.
             return {
-                code: "tier_sync_failed",
-                message: error instanceof Error ? error.message : "tier sync threw a non-Error value",
+                error: {
+                    code: "tier_sync_failed",
+                    message: error instanceof Error ? error.message : "tier sync threw a non-Error value",
+                },
+            };
+        }
+    }
+    async function syncTierFromSubscription(tenantId, routeDeps) {
+        return (await runTierSync(tenantId, routeDeps)).error;
+    }
+    async function syncAndNotify(tenantId, event, routeDeps) {
+        const outcome = await runTierSync(tenantId, routeDeps);
+        if (outcome.error !== null || outcome.applied === undefined || !deps.afterSync) {
+            return outcome.error;
+        }
+        try {
+            await deps.afterSync({ tenantId, event, ...outcome.applied });
+            return null;
+        }
+        catch (error) {
+            return {
+                code: "tier_sync_after_hook_failed",
+                message: error instanceof Error ? error.message : "afterSync threw a non-Error value",
             };
         }
     }
-    function createWebhookRoute() {
+    // `path` must keep the `:providerName` param the webhook route resolves the provider from.
+    function createWebhookRoute(options = {}) {
         return createSubscriptionWebhookRoute({
-            path: SUBSCRIPTION_WEBHOOK_PATH,
-            afterDispatch: async (dispatched, tenantId, routeDeps) => {
-                const syncError = await syncTierFromSubscription(tenantId, routeDeps);
+            path: options.path ?? SUBSCRIPTION_WEBHOOK_PATH,
+            afterDispatch: async (dispatched, tenantId, routeDeps, event) => {
+                const syncError = await syncAndNotify(tenantId, event, routeDeps);
                 if (syncError) {
                     // biome-ignore lint/suspicious/noConsole: operator visibility for a post-commit sync failure
                     console.warn(`[subscription-tier-sync] tier sync for tenant ${tenantId} after successful webhook write: ${syncError.code} ${syncError.message}`);
@@ -139,5 +168,5 @@ export function createSubscriptionTierSync(deps) {
             },
         });
     }
-    return { createWebhookRoute, syncTierFromSubscription };
+    return { createWebhookRoute, syncTierFromSubscription, syncAndNotify };
 }

package/dist/billing-foundation/types.d.ts

@@ -2,9 +2,9 @@
 import type { TenantDb } from "@cosmicdrift/kumiko-framework/db";
 import type { HandlerContext, TenantId } from "@cosmicdrift/kumiko-framework/engine";
 import type { SecretsContext } from "@cosmicdrift/kumiko-framework/secrets";
-import { type BillingEventKinds, type BillingPlanAction, SUBSCRIPTION_PROVIDER_EXTENSION, type SubscriptionCancelTiming, type SubscriptionEventType, type SubscriptionStatus, type TerminationScope } from "./constants.js";
-import type { OrderItem } from "./consumer-protection/consent-gate.js";
-import type { ConsentLocale } from "./consumer-protection/consent-locale.js";
+import { type BillingEventKinds, type BillingPlanAction, SUBSCRIPTION_PROVIDER_EXTENSION, type SubscriptionCancelTiming, type SubscriptionEventType, type SubscriptionStatus, type TerminationScope } from "./constants.ts";
+import type { OrderItem } from "./consumer-protection/consent-gate.ts";
+import type { ConsentLocale } from "./consumer-protection/consent-locale.ts";
 export type SubscriptionEvent = {
     /** Discriminator against PaymentEvent. Optional (instead of required) so
      *  existing plugins like subscription-mollie, which don't set this field,

package/dist/billing-foundation/validate-options.d.ts

@@ -1,4 +1,4 @@
-import { type BillingFoundationOptions } from "./types.js";
+import { type BillingFoundationOptions } from "./types.ts";
 /** Validates `options` and throws a plain `Error` with a clear message at
  *  feature-definition time — same pattern as `createCapOverviewFeature`.
  *  `createBillingFoundationFeature()` (no options) always succeeds; the

package/dist/billing-foundation/web/checkout-consent-dialog.d.ts

@@ -1,6 +1,6 @@
 import type { WriteResult } from "@cosmicdrift/kumiko-headless";
 import { type ReactNode } from "react";
-import type { BillingPlansResult } from "../types.js";
+import type { BillingPlansResult } from "../types.ts";
 export declare const CONSENT_TEXT_OUTDATED_CODE = "consent_text_outdated";
 type ConsumerProtectionView = NonNullable<BillingPlansResult["consumerProtection"]>;
 export type CheckoutConsentPayload = {

package/dist/billing-foundation/web/index.d.ts

@@ -1,6 +1,6 @@
-export { BILLING_PLANS_SCREEN_ID, type BillingPlanAction, BillingPlanActions, SubscriptionFoundationHandlers, SubscriptionFoundationQueries, type SubscriptionStatus, SubscriptionStatuses, } from "../constants.js";
-export { CONSENT_LOCALES, type ConsentLocale, resolveConsentLocale, } from "../consumer-protection/consent-locale.js";
-export type { BillingPlanBenefit, BillingPlanCatalog, BillingPlansResult, BillingPlanView, LegalLinkSet, } from "../types.js";
-export { BillingPlansPanel } from "./billing-plans-panel.js";
-export { CheckoutConsentDialog, type CheckoutConsentDialogProps, type CheckoutConsentPayload, CONSENT_TEXT_OUTDATED_CODE, } from "./checkout-consent-dialog.js";
-export { type BillingFoundationClientOptions, billingFoundationClient } from "./client-plugin.js";
+export { BILLING_PLANS_SCREEN_ID, type BillingPlanAction, BillingPlanActions, SubscriptionFoundationHandlers, SubscriptionFoundationQueries, type SubscriptionStatus, SubscriptionStatuses, } from "../constants.ts";
+export { CONSENT_LOCALES, type ConsentLocale, resolveConsentLocale, } from "../consumer-protection/consent-locale.ts";
+export type { BillingPlanBenefit, BillingPlanCatalog, BillingPlansResult, BillingPlanView, LegalLinkSet, } from "../types.ts";
+export { BillingPlansPanel } from "./billing-plans-panel.tsx";
+export { CheckoutConsentDialog, type CheckoutConsentDialogProps, type CheckoutConsentPayload, CONSENT_TEXT_OUTDATED_CODE, } from "./checkout-consent-dialog.tsx";
+export { type BillingFoundationClientOptions, billingFoundationClient } from "./client-plugin.tsx";

package/dist/billing-foundation/webhook-handler.d.ts

@@ -1,3 +1,4 @@
+import type { PaymentEvent, SubscriptionEvent } from "./types.ts";
 export type SubscriptionWebhookRouteOptions = {
     /** Route path — MUST carry the `:providerName` path-param. Default
      *  "/api/subscription/webhook/:providerName". */
@@ -7,7 +8,7 @@ export type SubscriptionWebhookRouteOptions = {
      *  duplicating the provider-resolve/payload-mapping logic above. Returning
      *  a failed WriteResult turns the response into the same 500 a dispatch
      *  failure would produce. */
-    readonly afterDispatch?: (dispatched: import("@cosmicdrift/kumiko-framework/engine").WriteResult, tenantId: import("@cosmicdrift/kumiko-framework/engine").TenantId, deps: import("@cosmicdrift/kumiko-framework/api").SignatureExtraRouteDeps) => Promise<import("@cosmicdrift/kumiko-framework/engine").WriteResult>;
+    readonly afterDispatch?: (dispatched: import("@cosmicdrift/kumiko-framework/engine").WriteResult, tenantId: import("@cosmicdrift/kumiko-framework/engine").TenantId, deps: import("@cosmicdrift/kumiko-framework/api").SignatureExtraRouteDeps, event: SubscriptionEvent | PaymentEvent) => Promise<import("@cosmicdrift/kumiko-framework/engine").WriteResult>;
 };
 /**
  * Builds the `entry:"signature"` extraRoute definition. Mount via

package/dist/billing-foundation/webhook-handler.js

@@ -68,7 +68,7 @@ export function createSubscriptionWebhookRoute(options = {}) {
                     },
                 });
                 return respondFromDispatch(c, dispatched.isSuccess && options.afterDispatch
-                    ? await options.afterDispatch(dispatched, tenantId, deps)
+                    ? await options.afterDispatch(dispatched, tenantId, deps, parsed)
                     : dispatched, "subscription_payment_webhook_processing_failed", "Internal error processing payment event");
             }
             const dispatched = await deps.dispatchSystemWrite({
@@ -88,7 +88,7 @@ export function createSubscriptionWebhookRoute(options = {}) {
                 },
             });
             return respondFromDispatch(c, dispatched.isSuccess && options.afterDispatch
-                ? await options.afterDispatch(dispatched, tenantId, deps)
+                ? await options.afterDispatch(dispatched, tenantId, deps, parsed)
                 : dispatched, "subscription_webhook_processing_failed", "Internal error processing subscription event");
         },
     });

package/dist/cap-counter/calendar-cap-usage-reservation.d.ts

@@ -1,7 +1,7 @@
-import type { CapCounterContext } from "./book-cap-usage.js";
-import { type CalendarCapReservation } from "./cap-reservation.js";
-import { type SoftHitNotifier } from "./enforce-cap.js";
-import type { CalendarCapDef } from "./with-cap-enforcement.js";
+import type { CapCounterContext } from "./book-cap-usage.ts";
+import { type CalendarCapReservation } from "./cap-reservation.ts";
+import { type SoftHitNotifier } from "./enforce-cap.ts";
+import type { CalendarCapDef } from "./with-cap-enforcement.ts";
 export type CalendarCapUsageReservationSpec = Omit<CalendarCapDef, "amount" | "notify"> & {
     readonly amount: number;
     readonly notify?: SoftHitNotifier;

package/dist/cap-counter/cap-reservation.d.ts

@@ -1,6 +1,6 @@
 import { UnprocessableError } from "@cosmicdrift/kumiko-framework/errors";
 import type { ReservationHandle } from "@cosmicdrift/kumiko-types/handlers";
-import { type BookCapUsageOptions, type CapCounterContext, type ReadRollingCapUsageOptions } from "./book-cap-usage.js";
+import { type BookCapUsageOptions, type CapCounterContext, type ReadRollingCapUsageOptions } from "./book-cap-usage.ts";
 export type CalendarCapReservation = ReservationHandle & {
     readonly reservationId: string;
     readonly counterValue: number;

package/dist/cap-counter/enforce-cap.d.ts

@@ -1,6 +1,6 @@
 import { KumikoError } from "@cosmicdrift/kumiko-framework/errors";
 import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
-import { type CapCounterContext } from "./book-cap-usage.js";
+import { type CapCounterContext } from "./book-cap-usage.ts";
 /**
  * Cap-Toleranz-Profile — pro Cap-Typ asymmetrisch. Quelle: Memory
  * `project_pricing_byok_caps` §3 + `docs/plans/marketing/produkt/

package/dist/cap-counter/feature.d.ts

@@ -1,7 +1,3 @@
 export declare function createCapCounterFeature(): import("@cosmicdrift/kumiko-types/feature").FeatureDefinition & {
     readonly exports: void;
 };
-/** @deprecated Use createCapCounterFeature(). Run `bun kumiko-upgrade --apply`. Removed in the first release after 2026-10-29. */
-export declare const capCounterFeature: import("@cosmicdrift/kumiko-types/feature").FeatureDefinition & {
-    readonly exports: void;
-};

package/dist/cap-counter/feature.js

@@ -125,5 +125,3 @@ export function createCapCounterFeature() {
         });
     }, { dedupeOptions: {} });
 }
-/** @deprecated Use createCapCounterFeature(). Run `bun kumiko-upgrade --apply`. Removed in the first release after 2026-10-29. */
-export const capCounterFeature = createCapCounterFeature();

package/dist/cap-counter/index.d.ts

@@ -1,13 +1,13 @@
-export { capCounterAggregateId, rollingCapAggregateId } from "./aggregate-id.js";
-export { type BookCapUsageOptions, bookCapUsage, type MarkCapSoftWarnedOptions, markCapSoftWarned, type ReadRollingCapUsageOptions, readRollingCapUsage, } from "./book-cap-usage.js";
-export { type CalendarCapReservationHandle, type CalendarCapReservationHandleSpec, type CalendarCapUsageReservation, type CalendarCapUsageReservationSpec, calendarCapReservationHandle, reserveCalendarCapUsage, } from "./calendar-cap-usage-reservation.js";
-export { CapReservationOverConsumedError, CapReservationSettledError, CapSettleBelowConsumedError, } from "./cap-reservation.js";
-export { CAP_COUNTER_FEATURE, CAP_COUNTER_ROLLING_AGGREGATE_TYPE, CapCounterHandlers, CapCounterQueries, ROLLING_INCREMENTED_EVENT_QN, ROLLING_INCREMENTED_EVENT_SHORT, ROLLING_RELEASED_EVENT_QN, ROLLING_RELEASED_EVENT_SHORT, } from "./constants.js";
-export { CAP_TOLERANCES, CapExceededError, type CapToleranceProfile, type CapToleranceProfileName, calendarMonthPeriodEndIso, currentCalendarMonthStartIso, type EnforceCapResult, enforceCap, enforceCapAndMaybeNotify, enforceRollingCap, enforceRollingCapAndMaybeNotify, enforceStockCap, type SoftHitNotifier, type StockCapResult, } from "./enforce-cap.js";
-export { capCounterEntity } from "./entity.js";
-export { capCounterFeature, createCapCounterFeature } from "./feature.js";
-export { readPayloadField } from "./payload-field.js";
-export { type CapGuardContext, type CapLimitContext, createStockCapGuard, type StockCapGuard, type StockCapSpec, } from "./stock-cap-guard.js";
-export { capReservationsTable, capReservationsTableMeta } from "./tables.js";
-export { createValueCapGuard, type ValueCapGuard, type ValueCapSpec, } from "./value-cap-guard.js";
-export { type CalendarCapDef, type CalendarCapResolver, type RollingCapDef, type RollingCapResolver, withCapEnforcement, withRollingCapEnforcement, } from "./with-cap-enforcement.js";
+export { capCounterAggregateId, rollingCapAggregateId } from "./aggregate-id.ts";
+export { type BookCapUsageOptions, bookCapUsage, type MarkCapSoftWarnedOptions, markCapSoftWarned, type ReadRollingCapUsageOptions, readRollingCapUsage, } from "./book-cap-usage.ts";
+export { type CalendarCapReservationHandle, type CalendarCapReservationHandleSpec, type CalendarCapUsageReservation, type CalendarCapUsageReservationSpec, calendarCapReservationHandle, reserveCalendarCapUsage, } from "./calendar-cap-usage-reservation.ts";
+export { CapReservationOverConsumedError, CapReservationSettledError, CapSettleBelowConsumedError, } from "./cap-reservation.ts";
+export { CAP_COUNTER_FEATURE, CAP_COUNTER_ROLLING_AGGREGATE_TYPE, CapCounterHandlers, CapCounterQueries, ROLLING_INCREMENTED_EVENT_QN, ROLLING_INCREMENTED_EVENT_SHORT, ROLLING_RELEASED_EVENT_QN, ROLLING_RELEASED_EVENT_SHORT, } from "./constants.ts";
+export { CAP_TOLERANCES, CapExceededError, type CapToleranceProfile, type CapToleranceProfileName, calendarMonthPeriodEndIso, currentCalendarMonthStartIso, type EnforceCapResult, enforceCap, enforceCapAndMaybeNotify, enforceRollingCap, enforceRollingCapAndMaybeNotify, enforceStockCap, type SoftHitNotifier, type StockCapResult, } from "./enforce-cap.ts";
+export { capCounterEntity } from "./entity.ts";
+export { createCapCounterFeature } from "./feature.ts";
+export { readPayloadField } from "./payload-field.ts";
+export { type CapGuardContext, type CapLimitContext, createStockCapGuard, type StockCapGuard, type StockCapSpec, } from "./stock-cap-guard.ts";
+export { capReservationsTable, capReservationsTableMeta } from "./tables.ts";
+export { createValueCapGuard, type ValueCapGuard, type ValueCapSpec, } from "./value-cap-guard.ts";
+export { type CalendarCapDef, type CalendarCapResolver, type RollingCapDef, type RollingCapResolver, withCapEnforcement, withRollingCapEnforcement, } from "./with-cap-enforcement.ts";

package/dist/cap-counter/index.js

@@ -6,7 +6,7 @@ export { CapReservationOverConsumedError, CapReservationSettledError, CapSettleB
 export { CAP_COUNTER_FEATURE, CAP_COUNTER_ROLLING_AGGREGATE_TYPE, CapCounterHandlers, CapCounterQueries, ROLLING_INCREMENTED_EVENT_QN, ROLLING_INCREMENTED_EVENT_SHORT, ROLLING_RELEASED_EVENT_QN, ROLLING_RELEASED_EVENT_SHORT, } from "./constants.js";
 export { CAP_TOLERANCES, CapExceededError, calendarMonthPeriodEndIso, currentCalendarMonthStartIso, enforceCap, enforceCapAndMaybeNotify, enforceRollingCap, enforceRollingCapAndMaybeNotify, enforceStockCap, } from "./enforce-cap.js";
 export { capCounterEntity } from "./entity.js";
-export { capCounterFeature, createCapCounterFeature } from "./feature.js";
+export { createCapCounterFeature } from "./feature.js";
 export { readPayloadField } from "./payload-field.js";
 export { createStockCapGuard, } from "./stock-cap-guard.js";
 export { capReservationsTable, capReservationsTableMeta } from "./tables.js";

package/dist/cap-counter/value-cap-guard.d.ts

@@ -1,7 +1,7 @@
 import type { TenantDb } from "@cosmicdrift/kumiko-framework/db";
 import type { WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
 import { type WriteFailure } from "@cosmicdrift/kumiko-framework/errors";
-import type { CapGuardContext, CapLimitContext } from "./stock-cap-guard.js";
+import type { CapGuardContext, CapLimitContext } from "./stock-cap-guard.ts";
 export type ValueCapSpec<TCaps> = {
     readonly field: string;
     /** `undefined` = no lower bound for this tier. */

package/dist/cap-counter/with-cap-enforcement.d.ts

@@ -1,5 +1,5 @@
 import type { HandlerContext, WriteEvent, WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
-import { type CapToleranceProfileName, type SoftHitNotifier } from "./enforce-cap.js";
+import { type CapToleranceProfileName, type SoftHitNotifier } from "./enforce-cap.ts";
 /**
  * Pro-call dynamische Cap-Definition. Wird vor jedem Handler-Aufruf
  * neu evaluiert — typischer Caller liest hier den Tenant-Tier aus

package/dist/cap-overview/feature.d.ts

@@ -1,5 +1,5 @@
 import { type FeatureDefinition } from "@cosmicdrift/kumiko-framework/engine";
-import type { CapSpec } from "./types.js";
+import type { CapSpec } from "./types.ts";
 export type CreateCapOverviewOptions = {
     readonly caps: readonly CapSpec[];
     /** Caps shown as columns on the platform-wide tenant-cap-list screen.

package/dist/cap-overview/handlers/caps-usage.query.d.ts

@@ -1,3 +1,3 @@
 import { type QueryHandlerDefinition } from "@cosmicdrift/kumiko-framework/engine";
-import type { CapSpec } from "../types.js";
+import type { CapSpec } from "../types.ts";
 export declare function createCapsUsageQuery(caps: readonly CapSpec[], usageRoles: readonly string[]): QueryHandlerDefinition;