@riverbankcms/sdk 0.146.0 → 0.148.0

package/dist/_dts/billing/src/components/index.d.ts

@@ -1,11 +1,20 @@
-import { type PlannerNoChange } from '../../../core/src/index';
-import { type BillingPlanId } from '../plans/types';
-export type BillingComponentInterval = 'month' | 'year';
+import { type Brand, type PlannerNoChange } from '../../../core/src/index';
+import { type BillingPlanId, type PaidBillingPlanId } from '../plans/types';
 export type BillingComponentCurrencyCode = string;
-export type BillingComponentId = string;
+export type BillingComponentId = Brand<string, 'BillingComponentId'>;
+export type BillingComponentIdempotencyKey = Brand<string, 'BillingComponentIdempotencyKey'>;
+export type BillingComponentSnapshotHash = Brand<string, 'BillingComponentSnapshotHash'>;
 export type BillingComponentSiteId = string;
 export type BillingComponentSiteDomainId = string;
-export type BillingComponentKind = 'plan_base' | 'custom_site_price' | 'extra_site' | 'managed_domain_overage';
+/** Brand a component id read from a trusted store (a database row or a fixture). */
+export declare const unsafeAsBillingComponentId: (id: string) => BillingComponentId;
+export declare const unsafeAsBillingComponentIdempotencyKey: (key: string) => BillingComponentIdempotencyKey;
+export declare const unsafeAsBillingComponentSnapshotHash: (hash: string) => BillingComponentSnapshotHash;
+/** Components derived on every read; they are never stored. */
+export type ComputedBillingComponentKind = 'plan_base' | 'custom_site_price';
+/** Components stored in `billing_components`; mirrors the database enum. */
+export type PersistedBillingComponentKind = 'extra_site' | 'managed_domain_overage';
+export type BillingComponentKind = ComputedBillingComponentKind | PersistedBillingComponentKind;
 export type BillingComponentPersistenceStatus = 'pending_acceptance' | 'accepted' | 'sync_failed' | 'registrar_failed' | 'registrar_succeeded_persist_failed' | 'active' | 'ending' | 'ended' | 'failed';
 export type EndableBillingComponentStatus = Extract<BillingComponentPersistenceStatus, 'active' | 'ending'>;
 export type EndableBillingComponentKind = Extract<BillingComponentKind, 'extra_site' | 'managed_domain_overage'>;
@@ -14,10 +23,9 @@ export type BillingComponentProposalPlan = Readonly<{
     pendingSourceKey: string;
     userId: string;
     siteId: string | null;
-    kind: 'extra_site' | 'managed_domain_overage';
+    kind: PersistedBillingComponentKind;
     amountCents: number;
     currency: string;
-    interval: BillingComponentInterval;
     sourceEntity: BillingComponentSourceEntityPlan;
     snapshotHash: string;
     pricingSnapshot: unknown;
@@ -51,7 +59,6 @@ export type BillingComponentBase<TKind extends BillingComponentKind, TOrigin ext
     source: BillingComponentSourceForKind<TKind>;
     amountCents: number;
     currency: BillingComponentCurrencyCode;
-    interval: BillingComponentInterval;
 }>;
 export type MacadamiaExtraSiteBillingComponentProposalPlan = BillingComponentProposalPlan & Readonly<{
     kind: 'extra_site';
@@ -122,9 +129,7 @@ export type BillingTotalPricePlan = BillingBasePricePlan & Readonly<{
     componentBreakdown: readonly BillingComponent[];
 }>;
 export type BillingComponentCompatibilityMismatch = Readonly<{
-    tag: 'component_interval_currency_mismatch';
-    componentInterval: BillingComponentInterval;
-    requestedInterval: BillingComponentInterval;
+    tag: 'component_currency_mismatch';
     componentCurrency: BillingComponentCurrencyCode;
     requestedCurrency: BillingComponentCurrencyCode;
 }>;
@@ -147,7 +152,6 @@ export type BillingComponentSummaryBase<TKind extends BillingComponentKind> = Re
     label: string;
     amountCents: number;
     formatted: string;
-    interval: BillingComponentInterval;
 }>;
 export type BillingComponentSummaryBasePlanComponent = BillingComponentSummaryBase<'plan_base'> & Readonly<{
     source: BillingComponentPlanSource;
@@ -208,13 +212,15 @@ export type MacadamiaExtraSitePricingSnapshot = Readonly<{
     planId: BillingPlanId;
     amountCents: number;
     currency: BillingComponentCurrencyCode;
-    interval: BillingComponentInterval;
 }>;
 export type ExtraSitePricingPolicy = Readonly<{
     includedSiteCount: number;
     currency: BillingComponentCurrencyCode;
-    extraSite: Readonly<{
+    extraSite: 
+    /** The plan an upgrade prompt names: the cheapest one that keeps what this plan has and adds extra sites. */
+    Readonly<{
         tag: 'not_supported';
+        minimumPlanId: PaidBillingPlanId;
     }> | Readonly<{
         tag: 'priced';
         monthlyAmountCents: number;
@@ -226,34 +232,22 @@ export type ConfiguredExtraSitePricingPolicy = ExtraSitePricingPolicy & Readonly
         monthlyAmountCents: number;
     }>;
 }>;
-export type MacadamiaSiteAllowancePricingInput = Readonly<{
-    includedLiveSiteCount: number;
-    extraSite: Readonly<{
-        tag: 'not_supported';
-    }> | Readonly<{
-        tag: 'priced';
-        monthlyPricePence: number;
-    }>;
-}>;
 export type ActiveExtraSiteComponentForReconciliation = Readonly<{
     componentId: BillingComponentId;
     siteId: BillingComponentSiteId;
     amountCents: number;
     currency: BillingComponentCurrencyCode;
-    interval: BillingComponentInterval;
 }>;
 export type MacadamiaExtraSiteReconciliationAction = Readonly<{
     tag: 'requires_acceptance';
     site: BillableMacadamiaSite;
     amountCents: number;
     currency: BillingComponentCurrencyCode;
-    interval: BillingComponentInterval;
 }> | Readonly<{
     tag: 'create_missing';
     site: BillableMacadamiaSite;
     amountCents: number;
     currency: BillingComponentCurrencyCode;
-    interval: BillingComponentInterval;
 }> | Readonly<{
     tag: 'end_at_period_end';
     component: ActiveExtraSiteComponentForReconciliation;
@@ -265,7 +259,7 @@ export type MacadamiaExtraSiteReconciliationAction = Readonly<{
 }> | Readonly<{
     tag: 'requires_plan_upgrade';
     site: BillableMacadamiaSite;
-    minimumPlanId: 'solo';
+    minimumPlanId: PaidBillingPlanId;
 }>;
 export type MacadamiaExtraSiteReconciliationPlan = PlannerNoChange | Readonly<{
     tag: 'changes_required';
@@ -281,13 +275,12 @@ export type MacadamiaExtraSiteLaunchDecision = Readonly<{
 }> | Readonly<{
     tag: 'requires_plan_upgrade';
     currentPlanId: BillingPlanId;
-    minimumPlanId: 'solo';
+    minimumPlanId: PaidBillingPlanId;
 }> | Readonly<{
     tag: 'requires_acceptance';
     currentPlanId: BillingPlanId;
     amountCents: number;
     currency: BillingComponentCurrencyCode;
-    interval: BillingComponentInterval;
 }>;
 export type MacadamiaSiteCreationBillingNotice = Readonly<{
     tag: 'none';
@@ -298,13 +291,12 @@ export type MacadamiaSiteCreationBillingNotice = Readonly<{
 }> | Readonly<{
     tag: 'upgrade_required_on_launch';
     currentPlanId: BillingPlanId;
-    minimumPlanId: 'solo';
+    minimumPlanId: PaidBillingPlanId;
 }> | Readonly<{
     tag: 'extra_site_charge_on_launch';
     currentPlanId: BillingPlanId;
     amountCents: number;
     currency: BillingComponentCurrencyCode;
-    interval: BillingComponentInterval;
 }>;
 export type MacadamiaExtraSiteProposalDecisionPlan = Extract<MacadamiaExtraSiteLaunchDecision, {
     tag: 'requires_acceptance';
@@ -378,7 +370,7 @@ export declare function planBillingComponentEndAtTimestamp(input: Readonly<{
     now: Date;
 }>): BillingComponentTimestampEndPlan;
 export declare function gbpPenceToAmountCents(amountPence: number, currency: BillingComponentCurrencyCode): number;
-export declare function buildMacadamiaExtraSitePricingPolicy(allowance: MacadamiaSiteAllowancePricingInput): ExtraSitePricingPolicy;
+export declare function buildMacadamiaExtraSitePricingPolicy(planId: BillingPlanId): ExtraSitePricingPolicy;
 export declare function buildManagedDomainRegistrarAttemptIdempotencyKey(input: Readonly<{
     componentId: string;
     domain: string;
@@ -408,14 +400,12 @@ export declare function classifyBillingModel(input: Readonly<{
 export declare function planExtraSiteComponents(input: Readonly<{
     sites: readonly BillableMacadamiaSite[];
     policy: ConfiguredExtraSitePricingPolicy;
-    interval?: BillingComponentInterval;
 }>): readonly BillingComponent[];
 export declare function planMacadamiaExtraSiteReconciliation(input: Readonly<{
     sites: readonly BillableMacadamiaSite[];
     activeExtraSiteComponents: readonly ActiveExtraSiteComponentForReconciliation[];
     acceptedSiteIds?: readonly BillingComponentSiteId[];
     policy: ExtraSitePricingPolicy;
-    interval?: BillingComponentInterval;
 }>): MacadamiaExtraSiteReconciliationPlan;
 export declare function evaluateMacadamiaExtraSiteLaunchDecision(input: Readonly<{
     siteId: BillingComponentSiteId;
@@ -426,14 +416,12 @@ export declare function evaluateMacadamiaExtraSiteLaunchDecision(input: Readonly
         componentId?: BillingComponentId;
     }>[];
     policy: ExtraSitePricingPolicy;
-    interval?: BillingComponentInterval;
 }>): MacadamiaExtraSiteLaunchDecision;
 export declare function macadamiaExtraSiteLaunchDecisionToCreationBillingNotice(decision: MacadamiaExtraSiteLaunchDecision): MacadamiaSiteCreationBillingNotice;
 export declare function evaluateMacadamiaSiteCreationBillingNotice(input: Readonly<{
     currentPlanId: BillingPlanId;
     currentLiveSiteCount: number;
     policy: ExtraSitePricingPolicy;
-    interval?: BillingComponentInterval;
 }>): MacadamiaSiteCreationBillingNotice;
 export declare function resolveBillingComponents(input: Readonly<{
     basePlan: BillingComponent;
@@ -454,16 +442,13 @@ export declare function toBillingSiteCostBreakdown(input: Readonly<{
 export declare function planCustomSitePriceComponents(input: Readonly<{
     siteBreakdown: readonly BillingSiteCostBreakdown[];
     currency: BillingComponentCurrencyCode;
-    interval: BillingComponentInterval;
 }>): readonly BillingComponent[];
 export declare function validateBillingComponentCompatibility(input: Readonly<{
     component: BillingComponent;
-    requestedInterval: BillingComponentInterval;
     requestedCurrency: BillingComponentCurrencyCode;
 }>): BillingComponentCompatibilityMismatch | null;
 export declare function planBillingTotalPrice(input: Readonly<{
     planId: string;
-    interval: BillingComponentInterval;
     currency: BillingComponentCurrencyCode;
     siteBreakdown: readonly BillingSiteCostBreakdown[];
     persistedComponents: readonly PersistedBillingComponent[];
@@ -521,5 +506,5 @@ export declare function asBillingComponentProposalPlan<TIdempotencyKey, TPending
  * programming/configuration error into every runtime caller.
  */
 export declare function asBillingComponentProposalPricingSnapshot<TPricingSnapshot>(value: unknown, parse: BillingComponentProposalPricingSnapshotParser<TPricingSnapshot>, description?: string): TPricingSnapshot;
-export declare function hashBillingComponentSnapshot(snapshot: unknown): string;
+export declare function hashBillingComponentSnapshot(snapshot: unknown): BillingComponentSnapshotHash;
 export declare function stableJson(value: unknown): string;

package/dist/_dts/billing/src/membership/index.d.ts

@@ -1,11 +1,10 @@
-import type { BillingInterval, BillingPlanId, PlanEntitlements } from '../plans/types';
+import type { BillingPlanId, PlanEntitlements } from '../plans/types';
 import { type SubscriptionRepository, type SubscriptionRecord } from '../subscriptions/store';
 import { type PlanStanding } from '../plans/standing';
 export interface MembershipState {
     userId: string;
     planStanding: 'paid' | 'payment_recovery' | 'free';
     planId: BillingPlanId;
-    interval: BillingInterval;
     status: SubscriptionRecord['status'];
     currentPeriodEnd: string;
     cancelAtPeriodEnd: boolean;
@@ -19,7 +18,6 @@ export interface MembershipSummary {
     planStanding: 'paid' | 'payment_recovery' | 'free';
     /** Effective entitlement plan. Provider subscription identity remains in the repository. */
     planId: BillingPlanId;
-    interval: BillingInterval;
     status: SubscriptionRecord['status'];
     currentPeriodEnd: string;
     cancelAtPeriodEnd: boolean;

package/dist/_dts/billing/src/plans/entitlements.d.ts

@@ -0,0 +1,80 @@
+import { type BillingPlanId, type BrandingTier, type FormsTier, type NewsletterTier, type PlanBooleanFeatureKey, type PlanEntitlements, type SeoTier, type StorageBytes, type StorageQuota, type TeamTier, type WebsiteCollaborationTier, type WebsiteTier } from './types';
+type MinimumTier<TTier extends string> = Readonly<{
+    minimum: TTier;
+}>;
+export type PlanEntitlementRequirementSpec = Readonly<{
+    features?: readonly PlanBooleanFeatureKey[];
+    website?: MinimumTier<WebsiteTier>;
+    /** Commission isn't a tier: the only requirement is that there is none. */
+    stripeBookingCommission?: Readonly<{
+        kind: 'none';
+    }>;
+    /** Extra sites aren't a tier either: the plan either prices them or doesn't offer them. */
+    extraSite?: Readonly<{
+        kind: 'supported';
+    }>;
+    forms?: MinimumTier<FormsTier>;
+    seo?: MinimumTier<SeoTier>;
+    newsletter?: MinimumTier<NewsletterTier>;
+    branding?: MinimumTier<BrandingTier>;
+    team?: MinimumTier<TeamTier>;
+    websiteCollaboration?: MinimumTier<WebsiteCollaborationTier>;
+}>;
+export type StorageQuotaCheckResult = Readonly<{
+    tag: 'unlimited';
+    usedBytes: StorageBytes;
+    incomingBytes: StorageBytes;
+}> | Readonly<{
+    tag: 'within_limit';
+    usedBytes: StorageBytes;
+    incomingBytes: StorageBytes;
+    remainingBytes: StorageBytes;
+    maxBytes: StorageBytes;
+}> | Readonly<{
+    tag: 'at_limit';
+    usedBytes: StorageBytes;
+    incomingBytes: StorageBytes;
+    remainingBytes: StorageBytes;
+    maxBytes: StorageBytes;
+}> | Readonly<{
+    tag: 'would_exceed_limit';
+    usedBytes: StorageBytes;
+    incomingBytes: StorageBytes;
+    remainingBytes: StorageBytes;
+    maxBytes: StorageBytes;
+    overByBytes: StorageBytes;
+}>;
+export declare function definePlanEntitlementRequirements<const TRequirements extends PlanEntitlementRequirementSpec>(requirements: TRequirements): TRequirements;
+export declare function isPlanBooleanFeatureEnabled(entitlements: PlanEntitlements, feature: PlanBooleanFeatureKey): boolean;
+export declare function meetsPlanEntitlementRequirements(entitlements: PlanEntitlements, requirements: PlanEntitlementRequirementSpec): boolean;
+/**
+ * The cheapest plan that grants `requirements`, by list price: the plan an
+ * upgrade prompt names. Price order, not registry order, so a plan added
+ * anywhere in the ladder is still found correctly.
+ */
+export declare function cheapestPlanMeetingRequirements(requirements: PlanEntitlementRequirementSpec): BillingPlanId | null;
+/**
+ * What choosing `planId` at launch commits the site to: the entitlements a
+ * launched site depends on (the website, a team, its own domain, no
+ * commission). A current plan satisfies the selection when it grants all of
+ * them, so plans that differ in other ways (storage, analytics) never block a
+ * launch, and a plan outside a single ladder (Team, alongside Solo) needs no
+ * rank.
+ */
+export declare function launchRequirementFor(planId: BillingPlanId): PlanEntitlementRequirementSpec;
+/**
+ * The plan an upgrade prompt names when an account on `currentPlanId` needs
+ * `addition`: the cheapest plan that keeps everything a launched site on the
+ * current plan depends on and adds it. A Team account that needs extra sites
+ * is pointed to Studio, not Solo, because Solo would lose the team. Null when
+ * no plan does.
+ */
+export declare function upgradeTargetAdding(currentPlanId: BillingPlanId, addition: PlanEntitlementRequirementSpec): BillingPlanId | null;
+/** Whether an account on `currentPlanId` can launch a site that selected `selectedPlanId`. */
+export declare function planSatisfiesLaunchSelection(currentPlanId: BillingPlanId | null, selectedPlanId: BillingPlanId): boolean;
+export declare function checkStorageQuota(quota: StorageQuota, input: Readonly<{
+    usedBytes: StorageBytes;
+    incomingBytes: StorageBytes;
+}>): StorageQuotaCheckResult;
+export declare function listBooleanPlanFeatureKeys(): readonly PlanBooleanFeatureKey[];
+export {};

package/dist/_dts/billing/src/plans/registry.d.ts

@@ -1,4 +1,4 @@
-import { type BillingInterval, type BillingPlanId, type PlanDefinition, type DisplayPricing } from './types';
+import { type BillingPlanId, type PlanDefinition } from './types';
 export declare function listPlans(): PlanDefinition[];
 export declare function isBillingPlanId(planId: string): planId is BillingPlanId;
 export declare function ensureBillingPlanId(planId: string): BillingPlanId;
@@ -8,23 +8,23 @@ export declare function getKnownPlan(planId: BillingPlanId): PlanDefinition;
 export declare function ensurePlan(planId: string): PlanDefinition;
 export declare function getPlanEntitlements(planId: string): PlanDefinition['entitlements'];
 export declare function getMacadamiaSiteAllowance(planId: string): PlanDefinition['entitlements']['macadamiaSiteAllowance'];
-/**
- * @deprecated Use database pricing with resolveUserPrice() instead.
- * This function fetches pre-created Stripe Price IDs which is being replaced
- * by inline price_data creation from database prices.
- */
-export declare function getStripePriceId(planId: string, interval: BillingInterval): Promise<string>;
-/**
- * @deprecated Use database pricing with getPlanPrice() and resolveUserPrice() instead.
- * This function fetches prices from Stripe which is being replaced by database pricing.
- */
-export declare function calculatePlanPricing(planId: string): Promise<DisplayPricing>;
-/**
- * @deprecated Use database pricing instead. This function fetches prices from Stripe.
- */
-export declare function listPricing(): Promise<DisplayPricing[]>;
 /**
  * Check if a plan is a paid plan.
  * A plan is paid if it's not the 'free' plan.
  */
 export declare function isPaidPlan(planId: string): boolean;
+/** What a plan costs and charges, derived from the registry. Not a second store. */
+export type PlanCommercials = Readonly<{
+    planId: BillingPlanId;
+    /** The monthly list price, before any per-user override or site costs. */
+    monthlyPricePence: number;
+    /** Macadamia's commission on Stripe-paid bookings; 0 when the plan has none. */
+    commissionPercent: number;
+    /**
+     * The monthly online revenue at which Free's commission equals this plan's
+     * price. Null for Free itself, and for any plan that does not charge less
+     * commission than Free.
+     */
+    breakEvenMonthlyOnlineRevenuePence: number | null;
+}>;
+export declare function planCommercials(planId: BillingPlanId): PlanCommercials;

package/dist/_dts/billing/src/plans/standing.d.ts

@@ -1,6 +1,6 @@
 import type { SubscriptionStandingEvidence, SubscriptionStandingEvidenceError, SubscriptionStandingInput } from '../subscriptions/standingEvidence';
-import { type SubscriptionRead } from '../subscriptions/store';
-type PaidStandingDetails = Pick<SubscriptionStandingEvidence, 'planId' | 'interval' | 'currentPeriodEnd' | 'cancelAtPeriodEnd'>;
+import { type SubscriptionRead, type SubscriptionStatus } from '../subscriptions/store';
+type PaidStandingDetails = Pick<SubscriptionStandingEvidence, 'planId' | 'currentPeriodEnd' | 'cancelAtPeriodEnd'>;
 export type PlanStanding = Readonly<{
     kind: 'paid';
 } & PaidStandingDetails> | Readonly<{
@@ -16,4 +16,11 @@ export type PlanStanding = Readonly<{
 export declare function resolvePlanStanding(input: SubscriptionStandingInput): PlanStanding;
 /** Repository reads have already parsed provider evidence; never validate it again here. */
 export declare function resolveStoredPlanStanding(record: SubscriptionRead): PlanStanding;
+/**
+ * Whether the provider still holds this subscription: it can be recovered,
+ * updated, cancelled or acted on by an arrangement change. This is presence,
+ * not entitlement: an unpaid subscription is present but grants free standing,
+ * so read `resolvePlanStanding` for what a plan allows.
+ */
+export declare function hasProviderSubscriptionPresence(status: SubscriptionStatus): boolean;
 export {};

package/dist/_dts/billing/src/plans/types.d.ts

@@ -1,4 +1,3 @@
-export type BillingInterval = 'monthly' | 'annual';
 declare const storageBytesBrand: unique symbol;
 export type StorageBytes = number & {
     readonly [storageBytesBrand]: 'StorageBytes';
@@ -24,10 +23,11 @@ export declare function storageGigabytes(value: number): StorageBytes;
 export declare function limitedStorageQuota(maxBytes: StorageBytes): StorageQuota;
 export declare function formatStorageBytes(bytes: StorageBytes): string;
 export declare function formatStorageQuota(quota: StorageQuota): string;
-export declare const BILLING_PLAN_IDS: readonly ["free", "core", "solo", "studio"];
+/** The ladder in reading order: the booking-page plans, then the website plans. */
+export declare const BILLING_PLAN_IDS: readonly ["free", "core", "team", "solo", "studio"];
 export type BillingPlanId = (typeof BILLING_PLAN_IDS)[number];
-export declare const PAID_BILLING_PLAN_IDS: readonly ["core", "solo", "studio"];
-export type PaidBillingPlanId = (typeof PAID_BILLING_PLAN_IDS)[number];
+export type PaidBillingPlanId = Exclude<BillingPlanId, 'free'>;
+export declare function isPaidBillingPlanId(planId: BillingPlanId): planId is PaidBillingPlanId;
 export declare const FORMS_TIERS: readonly ["limited", "full"];
 export type FormsTier = (typeof FORMS_TIERS)[number];
 export declare const SEO_TIERS: readonly ["none", "basic", "advanced"];
@@ -73,8 +73,7 @@ export type StripeBookingCommission = Readonly<{
 }>;
 export interface PlanEntitlements {
     planId: BillingPlanId;
-    monthlyPricePence: number | null;
-    availableIntervals: readonly BillingInterval[];
+    monthlyPricePence: number;
     macadamiaSiteAllowance: Readonly<{
         includedLiveSiteCount: number;
         extraSite: Readonly<{
@@ -106,13 +105,9 @@ export interface PlanDefinition {
     name: string;
     description: string;
     defaultCurrency: string;
-    annualDiscountPercent?: number;
-    /** @deprecated Use database pricing instead. Will be removed in Phase 6. */
-    stripePriceLookupKeys?: Partial<Record<BillingInterval, string>>;
     /** @deprecated Stripe products are now auto-created via ensurePlatformProduct(). */
     stripeProductId?: string;
     entitlements: PlanEntitlements;
-    trialDays?: number;
     metadata?: Record<string, string | number | boolean>;
 }
 export interface DisplayPricing {
@@ -122,10 +117,5 @@ export interface DisplayPricing {
         amountPence: number;
         formatted: string;
     };
-    annual: {
-        amountPence: number;
-        formatted: string;
-        discountPercent?: number;
-    };
 }
 export {};

package/dist/_dts/billing/src/site-arrangements.d.ts

@@ -1,4 +1,5 @@
 import { type PositiveCents, type Result } from '../../core/src/index';
+import type { SubscriptionStatus } from './subscriptions/store';
 export declare const SITE_BILLING_ARRANGEMENT_KINDS: readonly ["self_serve", "managed_platform_subscription", "managed_manual"];
 export type SiteBillingArrangementKind = (typeof SITE_BILLING_ARRANGEMENT_KINDS)[number];
 export declare const MANAGED_MANUAL_BILLING_REASONS: readonly ["bank_transfer", "testing_exchange", "complimentary", "other"];
@@ -56,7 +57,7 @@ export type ActiveSiteLinkedPlatformAddOn = Readonly<{
 export type SiteBillingSubscriptionSnapshot = Readonly<{
     id: string;
     origin: BillingSubscriptionOrigin | null;
-    status: string;
+    status: SubscriptionStatus;
 }> | null;
 export type SiteBillingManualReviewReason = 'ambiguous_subscription_origin' | 'active_site_linked_add_on' | 'admin_requested_manual_review' | 'missing_admin_subscription_choice' | 'practitioner_limit_exceeded' | 'live_site_allowance_exceeded' | 'subscription_action_failed' | 'multiple_platform_subscriptions' | 'platform_subscription_recovery_failed' | 'commission_reconciliation_exhausted';
 export declare const SITE_BILLING_MANUAL_REVIEW_REASONS: readonly ["ambiguous_subscription_origin", "active_site_linked_add_on", "admin_requested_manual_review", "missing_admin_subscription_choice", "practitioner_limit_exceeded", "live_site_allowance_exceeded", "subscription_action_failed", "multiple_platform_subscriptions", "platform_subscription_recovery_failed", "commission_reconciliation_exhausted"];
@@ -175,4 +176,3 @@ export declare function planSiteBillingArrangementChange(input: Readonly<{
     activeSiteLinkedAddOns: readonly ActiveSiteLinkedPlatformAddOn[];
     adminSubscriptionAction?: AdminManagedSubscriptionActionChoice | null;
 }>): SiteBillingArrangementChangePlan;
-export declare function isSubscriptionActiveForArrangementPlanning(status: string): boolean;

package/dist/_dts/billing/src/subscriptions/standingEvidence.d.ts

@@ -1,18 +1,16 @@
 import { type Result, type UtcIsoDateTimeString } from '../../../core/src/index';
-import type { BillingInterval, PaidBillingPlanId } from '../plans/types';
+import type { PaidBillingPlanId } from '../plans/types';
 import type { SubscriptionStatus } from './store';
 /** Untrusted stored columns, before defaults, casts or membership projection. */
 export type RawSubscriptionStandingEvidence = Readonly<{
     planId: unknown;
-    interval: unknown;
     status: unknown;
     currentPeriodEnd: unknown;
     cancelAtPeriodEnd: unknown;
 }>;
-export type SubscriptionStandingEvidenceError = 'invalid_plan' | 'invalid_interval' | 'invalid_status' | 'invalid_period_end' | 'invalid_cancellation';
+export type SubscriptionStandingEvidenceError = 'invalid_plan' | 'invalid_status' | 'invalid_period_end' | 'invalid_cancellation';
 export type SubscriptionStandingEvidence = Readonly<{
     planId: PaidBillingPlanId;
-    interval: BillingInterval;
     status: SubscriptionStatus;
     currentPeriodEnd: UtcIsoDateTimeString;
     cancelAtPeriodEnd: boolean;

package/dist/_dts/billing/src/subscriptions/store.d.ts

@@ -1,15 +1,14 @@
+import { type StripeCustomerId, type StripeSubscriptionId } from '../../../core/src/index';
 import type { ProviderSubscriptionRecord } from './evidence';
 import { type RawSubscriptionStandingEvidence, type SubscriptionStandingEvidenceError } from './standingEvidence';
-import type { BillingInterval } from '../plans/types';
 import type { BillingSubscriptionOrigin } from '../site-arrangements';
 export type SubscriptionStatus = 'incomplete_expired' | 'paused' | 'incomplete' | 'trialing' | 'active' | 'past_due' | 'canceled' | 'unpaid';
 export interface SubscriptionRecord {
-    id: string;
+    id: StripeSubscriptionId;
     userId: string;
-    customerId: string;
+    customerId: StripeCustomerId;
     planId: string;
     origin: BillingSubscriptionOrigin | null;
-    interval: BillingInterval;
     status: SubscriptionStatus;
     currentPeriodEnd: string;
     cancelAtPeriodEnd: boolean;
@@ -18,9 +17,9 @@ export interface SubscriptionRecord {
 }
 export type InvalidSubscriptionRecord = Readonly<{
     kind: 'invalid';
-    id: string;
+    id: StripeSubscriptionId;
     userId: string;
-    customerId: string;
+    customerId: StripeCustomerId;
     reason: SubscriptionStandingEvidenceError;
 }>;
 export type SubscriptionRead = ProviderSubscriptionRecord | InvalidSubscriptionRecord | null;
@@ -31,18 +30,25 @@ export declare class InvalidSubscriptionEvidenceError extends Error {
 }
 /** For mutation boundaries that cannot operate without valid subscription evidence. */
 export declare function requireSubscriptionRecord(value: SubscriptionRead): ProviderSubscriptionRecord | null;
-export declare function readSubscriptionRecord(raw: Omit<SubscriptionRecord, keyof RawSubscriptionStandingEvidence> & RawSubscriptionStandingEvidence): ProviderSubscriptionRecord | InvalidSubscriptionRecord;
+/**
+ * The parse boundary for a stored row: the Stripe ids arrive as the column
+ * strings and leave as branded ids, whether or not the rest is valid.
+ */
+export declare function readSubscriptionRecord(raw: Omit<SubscriptionRecord, keyof RawSubscriptionStandingEvidence | 'id' | 'customerId'> & RawSubscriptionStandingEvidence & Readonly<{
+    id: string;
+    customerId: string;
+}>): ProviderSubscriptionRecord | InvalidSubscriptionRecord;
 export interface SubscriptionRepository {
     upsert(record: SubscriptionRecord): Promise<void>;
     getByUserId(userId: string): Promise<SubscriptionRead>;
-    getBySubscriptionId(subscriptionId: string): Promise<SubscriptionRead>;
-    removeBySubscriptionId(subscriptionId: string): Promise<void>;
+    getBySubscriptionId(subscriptionId: StripeSubscriptionId): Promise<SubscriptionRead>;
+    removeBySubscriptionId(subscriptionId: StripeSubscriptionId): Promise<void>;
 }
 export declare class InMemorySubscriptionRepository implements SubscriptionRepository {
     private byUser;
     private byId;
     upsert(record: SubscriptionRecord): Promise<void>;
     getByUserId(userId: string): Promise<SubscriptionRead>;
-    getBySubscriptionId(subscriptionId: string): Promise<SubscriptionRead>;
-    removeBySubscriptionId(subscriptionId: string): Promise<void>;
+    getBySubscriptionId(subscriptionId: StripeSubscriptionId): Promise<SubscriptionRead>;
+    removeBySubscriptionId(subscriptionId: StripeSubscriptionId): Promise<void>;
 }

package/dist/_dts/block-form/src/backend/store-backend.d.ts

@@ -4,13 +4,11 @@
  * Integrates with EditorUiStore for autosave-enabled form management.
  * Supports blocks (per-block data), metadata, content, and linkedContent (embedded entry data).
  */
-import type { EditorBlockId, EditorSyncState } from '../../../core/src/index';
+import { type EditorBlockId, type EditorValueRecord, type ValueSync } from '../../../core/src/index';
 import { type BlockDraftSaveability } from '../blockDraftSaveability';
 import type { FormBackend, StoreBackendOptions } from './types';
 type StoreSnapshot = {
-    current: Record<string, unknown> | null;
-    baseline: Record<string, unknown> | null;
-    syncState: EditorSyncState;
+    sync: ValueSync<EditorValueRecord | null>;
     version?: number;
 };
 interface BlocksSlice {
@@ -18,7 +16,6 @@ interface BlocksSlice {
     setAtPath: (blockId: EditorBlockId, path: string, value: unknown) => void;
     getCurrentValues: (blockId: EditorBlockId) => Record<string, unknown> | null;
     getBlockSnapshot?: (blockId: EditorBlockId) => StoreSnapshot | null;
-    clearError?: (blockId: EditorBlockId) => void;
     updateBlockBaseline?: (blockId: EditorBlockId, data: Record<string, unknown> | null) => void;
 }
 interface RootSlice {
@@ -27,8 +24,10 @@ interface RootSlice {
     setAtPath: (path: string, value: unknown) => void;
     getCurrentValues: () => Record<string, unknown> | null;
     getSnapshot?: () => StoreSnapshot | null;
-    clearError?: () => void;
-    hydrate?: (baseline: Record<string, unknown> | null, current: Record<string, unknown> | null) => void;
+    /** Applies server values as a refresh; `replace` throws local edits away. */
+    refresh?: (input: Readonly<{
+        values: Record<string, unknown> | null;
+    }>, policy: 'replace') => unknown;
 }
 interface ArrayKeysManager {
     get: (scope: string, path: string) => string[] | undefined;

package/dist/_dts/block-form/src/backend/types.d.ts

@@ -133,6 +133,13 @@ export type StoreBackendOptions<TState = unknown> = {
     store: ZustandLikeStore<TState>;
     blockId?: EditorBlockId;
     validateFn?: (values: Record<string, unknown>) => ZodIssue[];
+    /**
+     * Read-only values beside the scope's own, keyed by top-level field id. A read of a key
+     * the values don't hold falls back to these, so a widget can watch a sibling that isn't
+     * a value (slug auto-generation's `statusFieldId` reads the entry's lifecycle status
+     * this way). They're never written, sent or edited.
+     */
+    context?: Readonly<Record<string, unknown>>;
 };
 /**
  * Type guards for discriminating backend types

package/dist/_dts/block-form/src/widgets/FieldFrame.d.ts

@@ -9,6 +9,8 @@ export type FieldFrameProps = {
     fieldPath?: string;
     label?: ReactNode;
     required?: boolean;
+    /** Marks the label "optional", for forms that mark what can be left blank rather than what can't. */
+    optional?: boolean;
     labelClassName?: string;
     description?: ReactNode;
     descriptionClassName?: string;
@@ -29,4 +31,4 @@ export declare function FieldFrameMessage({ id, error, hint }: FieldFrameMessage
 export declare function FieldLabelText({ label, required, }: {
     label: ReactNode;
     required?: boolean;
-}): import("react").JSX.Element | null;
+}): import("react").JSX.Element;

package/dist/_dts/blocks/src/PageRenderer.d.ts

@@ -1,13 +1,12 @@
 import * as React from 'react';
 import type { ResolverContext } from './system';
-import type { PageOutline } from './structure/schema';
 import type { SdkCustomBlock } from './system/manifest/schema';
 import type { RouteMap } from './system/transforms';
 import { type OverrideOnlyRenderMode, type ThemedRenderMode, type TokensOnlyRenderMode } from './pageRenderingMode';
 import { type PageJoinRenderer, type PageRuntimeJoin } from './pageRendererBoundaries';
 import { type BlockOverrides, type PageRendererDataContext, type SdkConfigForRenderer } from './pageRendererContracts';
-import { type RenderablePageOutline } from './pageRenderAdmission';
-export type { PageBlockRenderAdmissionError, RenderablePageBlock, RenderablePageOutline, } from './pageRenderAdmission';
+import { type RenderablePageOutline, type EditorPageOutlineWithPlacement } from './pageRenderAdmission';
+export type { PageBlockRenderAdmissionError, RenderablePageBlock, RenderablePageOutline, EditorRenderablePageOutline, EditorPageOutlineWithPlacement, } from './pageRenderAdmission';
 export type { BlockOverrideComponent, BlockOverrideProps, BlockOverrides, EntrySubrouteContextData, OccurrenceContextData, SdkConfigForRenderer, } from './pageRendererContracts';
 export { MissingBlockOverrideError } from './pageRenderingMode';
 export type { PageBlockPosition, PageJoinRenderer, PageJoinSlot, PageRuntimeJoin, RenderedJoin, } from './pageRendererBoundaries';
@@ -30,6 +29,6 @@ type OverrideOnlyPageRendererProps<TPage> = PageRendererCommonProps<TPage> & Ove
     blockOverrides: BlockOverrides;
 };
 export type PageRendererProps = ThemedPageRendererProps<RenderablePageOutline> | TokensOnlyPageRendererProps<RenderablePageOutline> | OverrideOnlyPageRendererProps<RenderablePageOutline>;
-export type EditorPageRendererProps = ThemedPageRendererProps<PageOutline> | OverrideOnlyPageRendererProps<PageOutline>;
+export type EditorPageRendererProps = ThemedPageRendererProps<EditorPageOutlineWithPlacement> | OverrideOnlyPageRendererProps<EditorPageOutlineWithPlacement>;
 export default function PageRenderer(props: PageRendererProps): React.JSX.Element;
 export declare function EditorPageRenderer(props: EditorPageRendererProps): React.JSX.Element;

package/dist/_dts/blocks/src/client/events.d.ts

@@ -4,3 +4,6 @@ export { EventDetailsIslandClient, type EventDetailsIslandClientProps, } from '.
 export { EventCalendarClient, type EventCalendarClientProps, } from '../system/runtime/nodes/events/EventCalendar.client';
 export { EventCombinedIslandClient, type EventCombinedClientProps, type EventCombinedIslandClientProps, } from '../system/runtime/nodes/events/EventCombined.client';
 export { EventListingClient, type EventListingClientProps, } from '../system/runtime/nodes/events/EventListing.client';
+export { EventCardClient, type EventCardClientProps, } from '../system/runtime/nodes/events/shared/EventCard.client';
+export { catalogueEventCardProps, type EventCardDisplayProps, } from '../system/runtime/nodes/events/shared/eventCardPresentations';
+export { defaultEventListingCardProps } from '../system/runtime/nodes/events/EventListing.interactive';