@happyvertical/smrt-subscriptions 0.30.0

package/dist/svelte/PlanPicker.svelte

@@ -0,0 +1,82 @@
+<script lang="ts">
+import type { SubscriptionPlan } from '../models/SubscriptionPlan.js';
+
+let {
+  plans = [],
+  selectedPlanKey = null,
+  onSelect,
+}: {
+  plans?: SubscriptionPlan[];
+  selectedPlanKey?: string | null;
+  onSelect?: (plan: SubscriptionPlan) => void;
+} = $props();
+</script>
+
+<div class="smrt-plan-picker">
+  {#each plans as plan (plan.id)}
+    <button
+      aria-pressed={plan.planKey === selectedPlanKey}
+      class:selected={plan.planKey === selectedPlanKey}
+      class="smrt-plan-picker__plan"
+      type="button"
+      onclick={() => onSelect?.(plan)}
+    >
+      <span class="smrt-plan-picker__name">{plan.name}</span>
+      <span class="smrt-plan-picker__price">
+        {new Intl.NumberFormat(undefined, {
+          style: 'currency',
+          currency: plan.currency,
+        }).format(plan.priceAmount)}
+        <small>/ {plan.billingInterval}</small>
+      </span>
+      {#if plan.description}
+        <span class="smrt-plan-picker__description">{plan.description}</span>
+      {/if}
+      <span class="smrt-plan-picker__features">
+        {plan.getFeatureKeys().length} features
+      </span>
+    </button>
+  {/each}
+</div>
+
+<style>
+  .smrt-plan-picker {
+    display: grid;
+    gap: 0.75rem;
+    grid-template-columns: repeat(auto-fit, minmax(14rem, 1fr));
+  }
+
+  .smrt-plan-picker__plan {
+    align-items: flex-start;
+    background: var(--smrt-color-surface, #fff);
+    border: 1px solid var(--smrt-color-outline-variant, #d8dde6);
+    border-radius: var(--smrt-radius-md, 8px);
+    color: inherit;
+    cursor: pointer;
+    display: grid;
+    gap: 0.45rem;
+    padding: 1rem;
+    text-align: left;
+  }
+
+  .smrt-plan-picker__plan.selected {
+    border-color: var(--smrt-color-primary, #2563eb);
+    box-shadow: 0 0 0 1px var(--smrt-color-primary, #2563eb);
+  }
+
+  .smrt-plan-picker__name {
+    font-weight: var(--smrt-typography-weight-bold, 650);
+  }
+
+  .smrt-plan-picker__price {
+    font-size: var(--smrt-typography-title-large-size, 1.25rem);
+    font-weight: var(--smrt-typography-weight-bold, 700);
+  }
+
+  .smrt-plan-picker__price small,
+  .smrt-plan-picker__description,
+  .smrt-plan-picker__features {
+    color: var(--smrt-color-on-surface-variant, #64748b);
+    font-size: var(--smrt-typography-body-medium-size, 0.875rem);
+  }
+</style>

package/dist/svelte/PlanPicker.svelte.d.ts

@@ -0,0 +1,10 @@
+import type { SubscriptionPlan } from '../models/SubscriptionPlan.js';
+type $$ComponentProps = {
+    plans?: SubscriptionPlan[];
+    selectedPlanKey?: string | null;
+    onSelect?: (plan: SubscriptionPlan) => void;
+};
+declare const PlanPicker: import("svelte").Component<$$ComponentProps, {}, "">;
+type PlanPicker = ReturnType<typeof PlanPicker>;
+export default PlanPicker;
+//# sourceMappingURL=PlanPicker.svelte.d.ts.map

package/dist/svelte/PlanPicker.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlanPicker.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/PlanPicker.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAErE,KAAK,gBAAgB,GAAI;IACxB,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC7C,CAAC;AAoCF,QAAA,MAAM,UAAU,sDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/svelte/SubscriptionSummary.svelte

@@ -0,0 +1,65 @@
+<script lang="ts">
+import { useI18n } from '@happyvertical/smrt-ui/i18n';
+import type { EntitlementResolution } from '../types.js';
+import { M } from './i18n.js';
+
+let {
+  resolution = null,
+}: {
+  resolution?: EntitlementResolution | null;
+} = $props();
+
+const { t } = useI18n();
+</script>
+
+<section class="smrt-subscription-summary">
+  <div>
+    <p class="smrt-subscription-summary__label">{t(M['subscriptions.summary.current_plan'])}</p>
+    <h2>{resolution?.planKey ?? t(M['subscriptions.summary.no_active_plan'])}</h2>
+  </div>
+  <dl>
+    <div>
+      <dt>Status</dt>
+      <dd>{resolution?.status ?? 'none'}</dd>
+    </div>
+    <div>
+      <dt>Features</dt>
+      <dd>{resolution?.featureKeys.length ?? 0}</dd>
+    </div>
+    <div>
+      <dt>Thresholds</dt>
+      <dd>{resolution?.thresholds.length ?? 0}</dd>
+    </div>
+  </dl>
+</section>
+
+<style>
+  .smrt-subscription-summary {
+    align-items: center;
+    display: flex;
+    gap: 1rem;
+    justify-content: space-between;
+  }
+
+  .smrt-subscription-summary h2,
+  .smrt-subscription-summary__label {
+    margin: 0;
+  }
+
+  .smrt-subscription-summary__label,
+  .smrt-subscription-summary dt {
+    color: var(--smrt-color-on-surface-variant, #64748b);
+    font-size: var(--smrt-typography-label-medium-size, 0.8rem);
+  }
+
+  .smrt-subscription-summary dl {
+    display: flex;
+    gap: 1rem;
+    margin: 0;
+  }
+
+  .smrt-subscription-summary dd {
+    font-weight: var(--smrt-typography-weight-bold, 650);
+    margin: 0;
+  }
+</style>

package/dist/svelte/SubscriptionSummary.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { EntitlementResolution } from '../types.js';
+type $$ComponentProps = {
+    resolution?: EntitlementResolution | null;
+};
+declare const SubscriptionSummary: import("svelte").Component<$$ComponentProps, {}, "">;
+type SubscriptionSummary = ReturnType<typeof SubscriptionSummary>;
+export default SubscriptionSummary;
+//# sourceMappingURL=SubscriptionSummary.svelte.d.ts.map

package/dist/svelte/SubscriptionSummary.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionSummary.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/SubscriptionSummary.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGxD,KAAK,gBAAgB,GAAI;IACxB,UAAU,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC3C,CAAC;AAsCF,QAAA,MAAM,mBAAmB,sDAAwC,CAAC;AAClE,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAClE,eAAe,mBAAmB,CAAC"}

package/dist/svelte/UsageThresholds.svelte

@@ -0,0 +1,71 @@
+<script lang="ts">
+import type { ThresholdEvaluation } from '../types.js';
+
+let {
+  evaluations = [],
+}: {
+  evaluations?: ThresholdEvaluation[];
+} = $props();
+</script>
+
+<div class="smrt-usage-thresholds">
+  {#each evaluations as evaluation (`${evaluation.threshold.metricKey}:${evaluation.usage.windowStart.toISOString()}`)}
+    <article
+      class:warn={evaluation.state === 'warn'}
+      class:blocked={evaluation.state === 'blocked'}
+      class="smrt-usage-thresholds__row"
+    >
+      <div class="smrt-usage-thresholds__header">
+        <strong>{evaluation.threshold.label ?? evaluation.threshold.metricKey}</strong>
+        <span>{evaluation.usage.quantity} / {evaluation.threshold.limit}</span>
+      </div>
+      <progress
+        aria-label={`${evaluation.threshold.label ?? evaluation.threshold.metricKey} usage`}
+        max="1"
+        value={Number.isFinite(evaluation.ratio)
+          ? Math.min(1, evaluation.ratio)
+          : 1}
+      ></progress>
+      <p>{evaluation.state}</p>
+    </article>
+  {/each}
+</div>
+
+<style>
+  .smrt-usage-thresholds {
+    display: grid;
+    gap: 0.75rem;
+  }
+
+  .smrt-usage-thresholds__row {
+    border: 1px solid var(--smrt-color-outline-variant, #d8dde6);
+    border-radius: var(--smrt-radius-md, 8px);
+    display: grid;
+    gap: 0.45rem;
+    padding: 0.875rem;
+  }
+
+  .smrt-usage-thresholds__row.warn {
+    border-color: var(--smrt-color-warning, #d97706);
+  }
+
+  .smrt-usage-thresholds__row.blocked {
+    border-color: var(--smrt-color-error, #dc2626);
+  }
+
+  .smrt-usage-thresholds__header {
+    align-items: center;
+    display: flex;
+    justify-content: space-between;
+  }
+
+  .smrt-usage-thresholds p {
+    color: var(--smrt-color-on-surface-variant, #64748b);
+    font-size: var(--smrt-typography-body-medium-size, 0.875rem);
+    margin: 0;
+  }
+
+  .smrt-usage-thresholds progress {
+    inline-size: 100%;
+  }
+</style>

package/dist/svelte/UsageThresholds.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { ThresholdEvaluation } from '../types.js';
+type $$ComponentProps = {
+    evaluations?: ThresholdEvaluation[];
+};
+declare const UsageThresholds: import("svelte").Component<$$ComponentProps, {}, "">;
+type UsageThresholds = ReturnType<typeof UsageThresholds>;
+export default UsageThresholds;
+//# sourceMappingURL=UsageThresholds.svelte.d.ts.map

package/dist/svelte/UsageThresholds.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsageThresholds.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/UsageThresholds.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEtD,KAAK,gBAAgB,GAAI;IACxB,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACrC,CAAC;AA4BF,QAAA,MAAM,eAAe,sDAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}

package/dist/svelte/i18n.d.ts

@@ -0,0 +1,5 @@
+export declare const M: {
+    readonly 'subscriptions.summary.current_plan': "subscriptions.summary.current_plan";
+    readonly 'subscriptions.summary.no_active_plan': "subscriptions.summary.no_active_plan";
+};
+//# sourceMappingURL=i18n.d.ts.map

package/dist/svelte/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/svelte/i18n.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,CAAC;;;CAGZ,CAAC"}

package/dist/svelte/i18n.js

@@ -0,0 +1,9 @@
+/**
+ * smrt-subscriptions UI message catalog (S13 #1418).
+ * Keys: `subscriptions.<component>.<descriptor>`.
+ */
+import { defineMessages } from '@happyvertical/smrt-ui/i18n';
+export const M = defineMessages({
+    'subscriptions.summary.current_plan': 'Current plan',
+    'subscriptions.summary.no_active_plan': 'No active plan',
+});

package/dist/svelte/index.d.ts

@@ -0,0 +1,4 @@
+export { default as PlanPicker } from './PlanPicker.svelte';
+export { default as SubscriptionSummary } from './SubscriptionSummary.svelte';
+export { default as UsageThresholds } from './UsageThresholds.svelte';
+//# sourceMappingURL=index.d.ts.map

package/dist/svelte/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/svelte/index.js

@@ -0,0 +1,3 @@
+export { default as PlanPicker } from './PlanPicker.svelte';
+export { default as SubscriptionSummary } from './SubscriptionSummary.svelte';
+export { default as UsageThresholds } from './UsageThresholds.svelte';

package/dist/types.d.ts

@@ -0,0 +1,175 @@
+import { SmrtClassOptions } from '@happyvertical/smrt-core';
+import { SubscriptionPlan } from './models/SubscriptionPlan.js';
+import { TenantSubscription } from './models/TenantSubscription.js';
+export type SubscriptionStatus = 'active' | 'canceled' | 'incomplete' | 'past_due' | 'trialing' | 'unpaid';
+export type SubscriptionPlanStatus = 'active' | 'archived' | 'draft';
+export type BillingInterval = 'day' | 'week' | 'month' | 'year';
+export type ThresholdEnforcement = 'observe' | 'warn' | 'block';
+export type ThresholdWindow = 'day' | 'week' | 'month' | 'year' | 'rolling';
+export type SubscriberKind = 'tenant' | 'external';
+/**
+ * Discriminated union identifying who a subscription/usage record is for.
+ *
+ * - `tenant`: the subscriber IS the owning tenant — preserves the existing
+ *   single-tenant SaaS shape end-to-end.
+ * - `external`: the subscriber is a caller-defined identity (opaque to this
+ *   package) scoped under an issuing `tenantId`. The `externalId` is a free-form
+ *   string that the caller namespaces (e.g. `buyer-contact:abc123`). Use this
+ *   for B2C buyers, anonymous-email subscribers, agent identities, etc.
+ *
+ * For both kinds, `tenantId` carries the owning/issuing tenant scope.
+ */
+export type Subscriber = {
+    kind: 'tenant';
+    tenantId: string;
+} | {
+    kind: 'external';
+    tenantId: string;
+    externalId: string;
+};
+export interface PlanFeatureGrant {
+    featureKey: string;
+    enabled?: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface PlanThreshold {
+    metricKey: string;
+    limit: number;
+    window: ThresholdWindow;
+    enforcement: ThresholdEnforcement;
+    label?: string;
+    warningRatio?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface UsageWindow {
+    start: Date;
+    end: Date;
+}
+export interface UsageMetricRecord {
+    /**
+     * Owning/issuing tenant scope. For `subscriberKind: 'tenant'` records this is
+     * also the subscriber. For `'external'` records this is the issuer.
+     */
+    tenantId: string;
+    /**
+     * Defaults to `'tenant'` when omitted — preserves the historical single-tenant
+     * shape for existing callers.
+     */
+    subscriberKind?: SubscriberKind;
+    /**
+     * Required when `subscriberKind` is `'external'`. Caller-namespaced opaque
+     * identifier (e.g. `buyer-contact:abc123`).
+     */
+    subscriberExternalId?: string;
+    metricKey: string;
+    quantity: number;
+    windowStart: Date;
+    windowEnd: Date;
+    source?: string;
+    sourceId?: string;
+    dimensions?: Record<string, unknown>;
+}
+export interface UsageSummary {
+    /** Owning/issuing tenant scope. */
+    tenantId: string;
+    /** Subscriber kind this summary represents. Defaults to `'tenant'`. */
+    subscriberKind?: SubscriberKind;
+    /** Set when `subscriberKind === 'external'`. */
+    subscriberExternalId?: string;
+    metricKey: string;
+    quantity: number;
+    windowStart: Date;
+    windowEnd: Date;
+}
+export interface AiUsageSummary {
+    tenantId: string;
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    estimatedCost: number;
+    requestCount: number;
+    windowStart: Date;
+    windowEnd: Date;
+}
+export interface ThresholdEvaluation {
+    threshold: PlanThreshold;
+    usage: UsageSummary;
+    ratio: number;
+    state: 'ok' | 'warn' | 'blocked';
+    allowed: boolean;
+    remaining: number;
+}
+export interface EntitlementResolution {
+    /** Issuing/owning tenant scope. */
+    tenantId: string;
+    /**
+     * The subscriber identity this resolution was computed for.
+     *
+     * Always populated at runtime by `SubscriptionResolver.resolveEntitlements`,
+     * but kept optional on the interface so downstream code that constructs
+     * or mocks `EntitlementResolution` (pre-#1454) continues to typecheck
+     * without code changes.
+     */
+    subscriber?: Subscriber;
+    planId: string | null;
+    planKey: string | null;
+    subscriptionId: string | null;
+    status: SubscriptionStatus | 'none';
+    featureKeys: string[];
+    thresholds: PlanThreshold[];
+    thresholdEvaluations: ThresholdEvaluation[];
+    allowed: boolean;
+}
+export interface EntitlementResolutionContext {
+    /**
+     * Current subscription for the requested subscriber. Set to `null` when a
+     * caller has already resolved that no current subscription exists.
+     */
+    subscription?: TenantSubscription | null;
+    /**
+     * Plan for `subscription.planId`. Set to `null` when the caller has already
+     * resolved the plan as absent or inactive.
+     */
+    plan?: SubscriptionPlan | null;
+}
+export interface SubscriptionResolverOptions {
+    now?: Date;
+    usageWindows?: Partial<Record<ThresholdWindow, UsageWindow>>;
+    /**
+     * Request-scoped context that lets repeated entitlement checks reuse an
+     * already-loaded subscription and plan instead of re-querying readers.
+     */
+    context?: EntitlementResolutionContext;
+}
+export interface UsageMeterOptions {
+    classOptions?: SmrtClassOptions;
+}
+export interface RecordUsageOptions extends UsageMetricRecord {
+}
+export interface SummarizeUsageOptions {
+    /** Owning/issuing tenant scope. */
+    tenantId: string;
+    /** Defaults to `'tenant'`. */
+    subscriberKind?: SubscriberKind;
+    /** Required when `subscriberKind === 'external'`. */
+    subscriberExternalId?: string;
+    metricKey: string;
+    window: UsageWindow;
+}
+export interface SummarizeUsageBatchOptions {
+    /** Owning/issuing tenant scope. */
+    tenantId: string;
+    /** Defaults to `'tenant'`. */
+    subscriberKind?: SubscriberKind;
+    /** Required when `subscriberKind === 'external'`. */
+    subscriberExternalId?: string;
+    metricKeys: string[];
+    window: UsageWindow;
+}
+export interface SummarizeAiUsageOptions {
+    tenantId: string;
+    window: UsageWindow;
+}
+export type JsonObject = Record<string, unknown>;
+export type { SmrtClassOptions };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,UAAU,GACV,UAAU,GACV,QAAQ,CAAC;AAEb,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAErE,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEhE,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5E,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,oBAAoB,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,IAAI,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;CACX;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAAC;IACpC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,YAAY,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACzC;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC,CAAC;IAC7D;;;OAGG;IACH,OAAO,CAAC,EAAE,4BAA4B,CAAC;CACxC;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAED,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;CAAG;AAEhE,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,qDAAqD;IACrD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,qDAAqD;IACrD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,59 @@
+import { JsonObject, PlanFeatureGrant, PlanThreshold, Subscriber, SubscriberKind, ThresholdWindow, UsageWindow } from './types.js';
+export declare function parseJsonArray<T>(value: string, fallback?: T[]): T[];
+export declare function parseJsonObject<T extends JsonObject>(value: string, fallback: T): T;
+export declare function stringifyJson(value: unknown): string;
+export declare function normalizeFeatureGrants(grants: Array<string | PlanFeatureGrant>): PlanFeatureGrant[];
+/**
+ * Coerce inputs from the legacy tenant-only API into a {@link Subscriber}.
+ *
+ * Existing callers that pass only `tenantId` (with optional `subscriberKind` /
+ * `subscriberExternalId` fields, e.g. on `RecordUsageOptions`) get normalized
+ * into the discriminated union exactly once at the boundary. This is the only
+ * place that contains "if kind is omitted, default to tenant" logic — every
+ * other site works with a typed `Subscriber`.
+ *
+ * Throws when:
+ * - `subscriberKind === 'external'` is requested without a non-empty
+ *   `subscriberExternalId` (the XOR invariant is the whole point), or
+ * - the input carries a non-empty `subscriberExternalId` but the kind resolves
+ *   to `'tenant'` (silent re-scoping would write buyer-scoped usage as tenant
+ *   usage, which then disappears from external summaries).
+ */
+export declare function normalizeSubscriber(input: {
+    tenantId: string;
+    subscriberKind?: SubscriberKind | null;
+    subscriberExternalId?: string | null;
+}): Subscriber;
+/**
+ * Project a {@link Subscriber} back onto column values for persistence or query
+ * filters. Counterpart to {@link normalizeSubscriber}.
+ */
+export declare function subscriberToColumns(subscriber: Subscriber): {
+    tenantId: string;
+    subscriberKind: SubscriberKind;
+    subscriberExternalId: string;
+};
+/**
+ * Enforce the subscriber XOR invariant on a row's columns. Used by both the
+ * model constructors (catches construction-time mistakes) and the
+ * `validateBeforeSave` override (catches mutations applied via the
+ * generated PUT/PATCH update path that bypass the constructor).
+ *
+ * Defensive about types because both call sites can receive JSON or untyped
+ * fixture data via the generated REST/CLI surface — `null` arriving in place
+ * of `''` would otherwise slip past an `=== ''` check, land in the
+ * `(tenant_id, subscriber_kind, subscriber_external_id)` conflict key, and
+ * (on Postgres) not collide with other NULLs while `findCurrentForSubscriber`
+ * keeps querying by a string external id.
+ *
+ * @param modelName - Prepended to error messages so callers can tell whether
+ *   the failure originated in `TenantSubscription` or `TenantUsageMetric`.
+ */
+export declare function assertSubscriberInvariant(modelName: string, fields: {
+    subscriberKind: unknown;
+    subscriberExternalId: unknown;
+}): void;
+export declare function getWindowForThreshold(thresholdWindow: ThresholdWindow, now?: Date): UsageWindow;
+export declare function getWindowKey(window: UsageWindow): string;
+export declare function isValidThreshold(threshold: PlanThreshold): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,cAAc,EAEd,eAAe,EACf,WAAW,EACZ,MAAM,YAAY,CAAC;AAepB,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,CAAC,EAAO,GAAG,CAAC,EAAE,CAWxE;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,UAAU,EAClD,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,GACV,CAAC,CAaH;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,GACvC,gBAAgB,EAAE,CAIpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC,GAAG,UAAU,CAuCb;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;IAC/B,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAaA;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE;IACN,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,EAAE,OAAO,CAAC;CAC/B,GACA,IAAI,CAmCN;AASD,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,eAAe,EAChC,GAAG,OAAa,GACf,WAAW,CAgBb;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAExD;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAalE"}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@happyvertical/smrt-subscriptions",
+  "version": "0.30.0",
+  "description": "Tenant subscriptions, entitlement resolution, usage thresholds, and subscription UI for SMRT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "scripts",
+    "CLAUDE.md",
+    "AGENTS.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./manifest": "./dist/manifest.json",
+    "./manifest.json": "./dist/manifest.json",
+    "./svelte": {
+      "types": "./dist/svelte/index.d.ts",
+      "svelte": "./dist/svelte/index.js",
+      "import": "./dist/svelte/index.js"
+    }
+  },
+  "dependencies": {
+    "@happyvertical/sql": "^0.74.7",
+    "@happyvertical/smrt-ui": "0.30.0",
+    "@happyvertical/smrt-tenancy": "0.30.0",
+    "@happyvertical/smrt-core": "0.30.0"
+  },
+  "peerDependencies": {
+    "svelte": "^5.18.0"
+  },
+  "peerDependenciesMeta": {
+    "svelte": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@sveltejs/package": "^2.5.7",
+    "@types/node": "24.10.9",
+    "svelte": "^5.18.0",
+    "svelte-check": "^4.3.5",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.17",
+    "@happyvertical/smrt-vitest": "0.30.0"
+  },
+  "keywords": [
+    "smrt",
+    "subscriptions",
+    "billing",
+    "entitlements",
+    "multi-tenant"
+  ],
+  "author": "HappyVertical",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/smrt.git",
+    "directory": "packages/subscriptions"
+  },
+  "scripts": {
+    "build": "vite build --mode library && svelte-package -i src/svelte -o dist/svelte --tsconfig tsconfig.svelte.json",
+    "build:watch": "vite build --mode library --watch",
+    "check": "pnpm exec svelte-check --tsconfig ./tsconfig.svelte.json",
+    "typecheck": "tsc --noEmit && node ../../scripts/svelte-check-a11y.mjs --tsconfig ./tsconfig.svelte.json",
+    "clean": "rm -rf dist",
+    "dev": "vite dev",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "verify:pack": "node ../../scripts/verify-package-types-exports.js ."
+  }
+}