@happyvertical/smrt-subscriptions 0.30.0

package/dist/models/SubscriptionPlan.d.ts

@@ -0,0 +1,30 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { BillingInterval, JsonObject, PlanFeatureGrant, PlanThreshold, SubscriptionPlanStatus } from '../types.js';
+export declare class SubscriptionPlan extends SmrtObject {
+    tenantId: string | null;
+    planKey: string;
+    name: string;
+    description: string;
+    status: SubscriptionPlanStatus;
+    sortOrder: number;
+    priceAmount: number;
+    currency: string;
+    billingInterval: BillingInterval;
+    externalProvider: string;
+    stripeProductId: string;
+    stripePriceId: string;
+    features: string;
+    thresholds: string;
+    metadata: string;
+    constructor(options?: any);
+    isActive(): boolean;
+    getFeatureGrants(): PlanFeatureGrant[];
+    setFeatureGrants(grants: Array<string | PlanFeatureGrant>): void;
+    getFeatureKeys(): string[];
+    getThresholds(): PlanThreshold[];
+    setThresholds(thresholds: PlanThreshold[]): void;
+    getMetadata(): JsonObject;
+    setMetadata(metadata: JsonObject): void;
+}
+export default SubscriptionPlan;
+//# sourceMappingURL=SubscriptionPlan.d.ts.map

package/dist/models/SubscriptionPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionPlan.d.ts","sourceRoot":"","sources":["../../src/models/SubscriptionPlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAQrB,qBAQa,gBAAiB,SAAQ,UAAU;IAE9C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B,OAAO,EAAE,MAAM,CAAM;IACrB,IAAI,EAAE,MAAM,CAAM;IAClB,WAAW,EAAE,MAAM,CAAM;IACzB,MAAM,EAAE,sBAAsB,CAAY;IAC1C,SAAS,EAAE,MAAM,CAAK;IACtB,WAAW,EAAE,MAAM,CAAO;IAC1B,QAAQ,EAAE,MAAM,CAAS;IACzB,eAAe,EAAE,eAAe,CAAW;IAC3C,gBAAgB,EAAE,MAAM,CAAY;IACpC,eAAe,EAAE,MAAM,CAAM;IAC7B,aAAa,EAAE,MAAM,CAAM;IAC3B,QAAQ,EAAE,MAAM,CAAQ;IACxB,UAAU,EAAE,MAAM,CAAQ;IAC1B,QAAQ,EAAE,MAAM,CAAQ;gBAEZ,OAAO,GAAE,GAAQ;IA6B7B,QAAQ,IAAI,OAAO;IAInB,gBAAgB,IAAI,gBAAgB,EAAE;IAMtC,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,GAAG,IAAI;IAIhE,cAAc,IAAI,MAAM,EAAE;IAM1B,aAAa,IAAI,aAAa,EAAE;IAMhC,aAAa,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,IAAI;IAIhD,WAAW,IAAI,UAAU;IAIzB,WAAW,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;CAGxC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/models/TenantSubscription.d.ts

@@ -0,0 +1,59 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { JsonObject, Subscriber, SubscriberKind, SubscriptionStatus } from '../types.js';
+export declare class TenantSubscription extends SmrtObject {
+    tenantId?: string;
+    /**
+     * Discriminator for the subscriber identity.
+     *
+     * - `'tenant'` (default): the subscriber IS the owning `tenantId` — the
+     *   pre-polymorphic shape. All existing rows continue to behave this way.
+     * - `'external'`: the subscriber is `subscriberExternalId`, scoped under the
+     *   issuing `tenantId`. Used for B2C buyers, anonymous-email subscribers,
+     *   agent identities, and any other caller-defined identity.
+     */
+    subscriberKind: SubscriberKind;
+    /**
+     * Caller-namespaced opaque identifier for the subscriber when
+     * `subscriberKind === 'external'`. Empty string when kind is `'tenant'`.
+     *
+     * The package treats this as opaque — no FK, no inferred semantics. Callers
+     * are expected to namespace (e.g. `buyer-contact:abc123`,
+     * `agent:hermes-7`, `email:foo@example.com`).
+     */
+    subscriberExternalId: string;
+    planId: string;
+    status: SubscriptionStatus;
+    startedAt: Date;
+    currentPeriodStart: Date | null;
+    currentPeriodEnd: Date | null;
+    trialEndsAt: Date | null;
+    cancelAtPeriodEnd: boolean;
+    canceledAt: Date | null;
+    externalProvider: string;
+    stripeCustomerId: string;
+    stripeSubscriptionId: string;
+    stripeCheckoutSessionId: string;
+    metadata: string;
+    constructor(options?: any);
+    /**
+     * Validates the subscriber XOR invariant before every save. Critical for the
+     * generated update path: `SmrtCollection.update()` mutates the existing
+     * instance via `Object.assign()` and calls `save()` directly — the
+     * constructor never re-runs, so without this hook a partial update like
+     * `{ subscriberExternalId: 'buyer:alice' }` on a tenant-kind row would
+     * persist a malformed conflict key and let two tenant-kind rows coexist
+     * under the same tenant.
+     */
+    protected validateBeforeSave(): Promise<void>;
+    isEntitled(now?: Date): boolean;
+    /**
+     * Project this row's polymorphic subscriber columns onto the
+     * {@link Subscriber} discriminated union. Returns `null` when the owning
+     * tenant is absent — that's an invalid row that should not be acted on.
+     */
+    getSubscriber(): Subscriber | null;
+    getMetadata(): JsonObject;
+    setMetadata(metadata: JsonObject): void;
+}
+export default TenantSubscription;
+//# sourceMappingURL=TenantSubscription.d.ts.map

package/dist/models/TenantSubscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TenantSubscription.d.ts","sourceRoot":"","sources":["../../src/models/TenantSubscription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAExE,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAOrB,qBAwBa,kBAAmB,SAAQ,UAAU;IAEhD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;OAQG;IACH,cAAc,EAAE,cAAc,CAAY;IAE1C;;;;;;;OAOG;IACH,oBAAoB,EAAE,MAAM,CAAM;IAGlC,MAAM,EAAE,MAAM,CAAM;IAEpB,MAAM,EAAE,kBAAkB,CAAgB;IAC1C,SAAS,EAAE,IAAI,CAAc;IAC7B,kBAAkB,EAAE,IAAI,GAAG,IAAI,CAAQ;IACvC,gBAAgB,EAAE,IAAI,GAAG,IAAI,CAAQ;IACrC,WAAW,EAAE,IAAI,GAAG,IAAI,CAAQ;IAChC,iBAAiB,EAAE,OAAO,CAAS;IACnC,UAAU,EAAE,IAAI,GAAG,IAAI,CAAQ;IAC/B,gBAAgB,EAAE,MAAM,CAAY;IACpC,gBAAgB,EAAE,MAAM,CAAM;IAC9B,oBAAoB,EAAE,MAAM,CAAM;IAClC,uBAAuB,EAAE,MAAM,CAAM;IACrC,QAAQ,EAAE,MAAM,CAAQ;gBAEZ,OAAO,GAAE,GAAQ;IA8C7B;;;;;;;;OAQG;cACa,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnD,UAAU,CAAC,GAAG,OAAa,GAAG,OAAO;IAarC;;;;OAIG;IACH,aAAa,IAAI,UAAU,GAAG,IAAI;IAiBlC,WAAW,IAAI,UAAU;IAIzB,WAAW,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;CAGxC;AAED,eAAe,kBAAkB,CAAC"}

package/dist/models/TenantUsageMetric.d.ts

@@ -0,0 +1,35 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { JsonObject, Subscriber, SubscriberKind } from '../types.js';
+export declare class TenantUsageMetric extends SmrtObject {
+    tenantId?: string;
+    /**
+     * Discriminator for which subscriber identity recorded this usage.
+     * `'tenant'` (default) preserves the legacy shape; `'external'` indicates
+     * the subscriber is `subscriberExternalId` under the issuing `tenantId`.
+     */
+    subscriberKind: SubscriberKind;
+    /**
+     * Opaque caller-namespaced subscriber id when `subscriberKind === 'external'`.
+     * Empty string when kind is `'tenant'`.
+     */
+    subscriberExternalId: string;
+    metricKey: string;
+    quantity: number;
+    windowStart: Date;
+    windowEnd: Date;
+    source: string;
+    sourceId: string;
+    dimensions: string;
+    constructor(options?: any);
+    /** See `TenantSubscription.validateBeforeSave` for the rationale. */
+    protected validateBeforeSave(): Promise<void>;
+    /**
+     * Project this row's polymorphic subscriber columns onto the
+     * {@link Subscriber} discriminated union.
+     */
+    getSubscriber(): Subscriber | null;
+    getDimensions(): JsonObject;
+    setDimensions(dimensions: JsonObject): void;
+}
+export default TenantUsageMetric;
+//# sourceMappingURL=TenantUsageMetric.d.ts.map

package/dist/models/TenantUsageMetric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TenantUsageMetric.d.ts","sourceRoot":"","sources":["../../src/models/TenantUsageMetric.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAO1E,qBAOa,iBAAkB,SAAQ,UAAU;IAE/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,cAAc,EAAE,cAAc,CAAY;IAE1C;;;OAGG;IACH,oBAAoB,EAAE,MAAM,CAAM;IAElC,SAAS,EAAE,MAAM,CAAM;IACvB,QAAQ,EAAE,MAAM,CAAO;IACvB,WAAW,EAAE,IAAI,CAAc;IAC/B,SAAS,EAAE,IAAI,CAAc;IAC7B,MAAM,EAAE,MAAM,CAAM;IACpB,QAAQ,EAAE,MAAM,CAAM;IACtB,UAAU,EAAE,MAAM,CAAQ;gBAEd,OAAO,GAAE,GAAQ;IAuB7B,qEAAqE;cACrD,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnD;;;OAGG;IACH,aAAa,IAAI,UAAU,GAAG,IAAI;IAiBlC,aAAa,IAAI,UAAU;IAI3B,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;CAG5C;AAED,eAAe,iBAAiB,CAAC"}

package/dist/models/index.d.ts

@@ -0,0 +1,4 @@
+export { SubscriptionPlan } from './SubscriptionPlan.js';
+export { TenantSubscription } from './TenantSubscription.js';
+export { TenantUsageMetric } from './TenantUsageMetric.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/services/index.d.ts

@@ -0,0 +1,5 @@
+export type { EntitlementResolutionContext } from '../types.js';
+export { type SubscriptionPlanReader, SubscriptionResolver, type SubscriptionResolverReaders, type TenantSubscriptionReader, type UsageSummaryReader, } from './subscription-resolver.js';
+export { evaluateThreshold, evaluateThresholds, } from './threshold-evaluator.js';
+export { TenantUsageMeter } from './usage-meter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EACL,KAAK,sBAAsB,EAC3B,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,GACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/services/subscription-resolver.d.ts

@@ -0,0 +1,96 @@
+import { SubscriptionPlan } from '../models/SubscriptionPlan.js';
+import { TenantSubscription } from '../models/TenantSubscription.js';
+import { EntitlementResolution, EntitlementResolutionContext, PlanThreshold, SmrtClassOptions, Subscriber, SubscriptionResolverOptions, UsageSummary, UsageWindow } from '../types.js';
+export interface SubscriptionPlanReader {
+    get(criteria: {
+        id: string;
+    }): Promise<SubscriptionPlan | null>;
+}
+/**
+ * Reader contract for finding the current subscription for a subscriber.
+ *
+ * The legacy `findCurrentForTenant(tenantId)` signature stays for backward
+ * compatibility with the original tenant-only resolver. New implementations
+ * should provide `findCurrentForSubscriber(subscriber)` — it's preferred when
+ * present and lets the resolver work with both `'tenant'` and `'external'`
+ * subscribers without callers having to pre-narrow the discriminator.
+ */
+export interface TenantSubscriptionReader {
+    findCurrentForTenant(tenantId: string, now?: Date): Promise<TenantSubscription | null>;
+    findCurrentForSubscriber?(subscriber: Subscriber, now?: Date): Promise<TenantSubscription | null>;
+}
+/**
+ * Reader contract for summarizing usage.
+ *
+ * `summarize(options)` already accepts the polymorphic
+ * `subscriberKind`/`subscriberExternalId` fields. When omitted the reader
+ * defaults to `'tenant'`, which is what existing callers got before this
+ * change — no behavior shift for them. The discriminator type is derived
+ * from `Subscriber['kind']` rather than inlined so any future additions to
+ * the union stay consistent across the package.
+ */
+export interface UsageSummaryReader {
+    summarize(options: {
+        tenantId: string;
+        subscriberKind?: Subscriber['kind'];
+        subscriberExternalId?: string;
+        metricKey: string;
+        window: UsageWindow;
+    }): Promise<UsageSummary>;
+    summarizeBatch?(options: {
+        tenantId: string;
+        subscriberKind?: Subscriber['kind'];
+        subscriberExternalId?: string;
+        metricKeys: string[];
+        window: UsageWindow;
+    }): Promise<UsageSummary[]>;
+}
+export interface SubscriptionResolverReaders {
+    plans: SubscriptionPlanReader;
+    subscriptions: TenantSubscriptionReader;
+    usage: UsageSummaryReader;
+}
+export declare class SubscriptionResolver {
+    private readonly readers;
+    constructor(readers: SubscriptionResolverReaders);
+    /**
+     * Build the default resolver readers once for a request or app lifecycle and
+     * reuse the returned resolver across entitlement checks.
+     */
+    static create(classOptions?: SmrtClassOptions): Promise<SubscriptionResolver>;
+    /**
+     * Load the subscription/plan pair used by entitlement resolution. Callers
+     * that need both the entitlement snapshot and the backing records can load
+     * this once, then pass it back via `options.context`.
+     */
+    loadEntitlementContext(subscriberOrTenantId: Subscriber | string, options?: SubscriptionResolverOptions): Promise<EntitlementResolutionContext>;
+    /**
+     * Polymorphic entitlement resolution. Works for both `'tenant'`-kind and
+     * `'external'`-kind subscribers and is the preferred surface — the
+     * `resolveTenantEntitlements(tenantId)` method below is a thin wrapper.
+     */
+    resolveEntitlements(subscriber: Subscriber, options?: SubscriptionResolverOptions): Promise<EntitlementResolution>;
+    /**
+     * Legacy single-tenant wrapper around {@link resolveEntitlements}. Kept so
+     * existing tenant-only callers don't need to update their call sites.
+     */
+    resolveTenantEntitlements(tenantId: string, options?: SubscriptionResolverOptions): Promise<EntitlementResolution>;
+    isFeatureEnabled(subscriberOrTenantId: Subscriber | string, featureKey: string, options?: SubscriptionResolverOptions): Promise<boolean>;
+    assertWithinThresholds(subscriberOrTenantId: Subscriber | string, options?: SubscriptionResolverOptions): Promise<void>;
+    private resolveSubscription;
+    private resolvePlan;
+    /**
+     * Bridge the legacy and polymorphic reader contracts.
+     *
+     * Prefers `findCurrentForSubscriber` when the reader provides it (the
+     * preferred shape). For `'tenant'` subscribers we fall back to the legacy
+     * `findCurrentForTenant`. For `'external'` subscribers the reader MUST
+     * implement `findCurrentForSubscriber` — otherwise we have no way to scope
+     * the lookup and we throw rather than silently returning the tenant's
+     * primary subscription.
+     */
+    private findCurrentSubscription;
+    private resolveThresholdEvaluations;
+}
+export type { PlanThreshold };
+//# sourceMappingURL=subscription-resolver.d.ts.map

package/dist/services/subscription-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-resolver.d.ts","sourceRoot":"","sources":["../../src/services/subscription-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EACV,qBAAqB,EACrB,4BAA4B,EAC5B,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,2BAA2B,EAE3B,YAAY,EACZ,WAAW,EACZ,MAAM,aAAa,CAAC;AASrB,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CACjE;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC,oBAAoB,CAClB,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,IAAI,GACT,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACtC,wBAAwB,CAAC,CACvB,UAAU,EAAE,UAAU,EACtB,GAAG,CAAC,EAAE,IAAI,GACT,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,OAAO,EAAE;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QACpC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,WAAW,CAAC;KACrB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1B,cAAc,CAAC,CAAC,OAAO,EAAE;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QACpC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,MAAM,EAAE,WAAW,CAAC;KACrB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,sBAAsB,CAAC;IAC9B,aAAa,EAAE,wBAAwB,CAAC;IACxC,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAED,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,2BAA2B;IAEjE;;;OAGG;WACU,MAAM,CACjB,YAAY,GAAE,gBAAqB,GAClC,OAAO,CAAC,oBAAoB,CAAC;IAShC;;;;OAIG;IACG,sBAAsB,CAC1B,oBAAoB,EAAE,UAAU,GAAG,MAAM,EACzC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,4BAA4B,CAAC;IAYxC;;;;OAIG;IACG,mBAAmB,CACvB,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,qBAAqB,CAAC;IA2CjC;;;OAGG;IACG,yBAAyB,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,qBAAqB,CAAC;IAI3B,gBAAgB,CACpB,oBAAoB,EAAE,UAAU,GAAG,MAAM,EACzC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,OAAO,CAAC;IAQb,sBAAsB,CAC1B,oBAAoB,EAAE,UAAU,GAAG,MAAM,EACzC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,IAAI,CAAC;YAkBF,mBAAmB;YAanB,WAAW;IAezB;;;;;;;;;OASG;YACW,uBAAuB;YAsBvB,2BAA2B;CA4E1C;AAmGD,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/services/threshold-evaluator.d.ts

@@ -0,0 +1,4 @@
+import { PlanThreshold, ThresholdEvaluation, UsageSummary } from '../types.js';
+export declare function evaluateThreshold(threshold: PlanThreshold, usage: UsageSummary): ThresholdEvaluation;
+export declare function evaluateThresholds(thresholds: PlanThreshold[], usage: UsageSummary[]): ThresholdEvaluation[];
+//# sourceMappingURL=threshold-evaluator.d.ts.map

package/dist/services/threshold-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threshold-evaluator.d.ts","sourceRoot":"","sources":["../../src/services/threshold-evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,YAAY,GAClB,mBAAmB,CAuBrB;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,aAAa,EAAE,EAC3B,KAAK,EAAE,YAAY,EAAE,GACpB,mBAAmB,EAAE,CAWvB"}

package/dist/services/usage-meter.d.ts

@@ -0,0 +1,32 @@
+import { SmrtClassOptions } from '@happyvertical/smrt-core';
+import { TenantUsageMetricCollection } from '../collections/TenantUsageMetricCollection.js';
+import { AiUsageSummary, RecordUsageOptions, SummarizeAiUsageOptions, SummarizeUsageBatchOptions, SummarizeUsageOptions, UsageSummary } from '../types.js';
+export declare class TenantUsageMeter {
+    private readonly metrics;
+    private readonly classOptions;
+    constructor(metrics: TenantUsageMetricCollection, classOptions?: SmrtClassOptions);
+    static create(classOptions?: SmrtClassOptions): Promise<TenantUsageMeter>;
+    /**
+     * Record one usage row.
+     *
+     * Accepts the polymorphic subscriber fields directly on the options object
+     * (`subscriberKind`/`subscriberExternalId`); when omitted defaults to a
+     * `'tenant'`-kind row keyed off `tenantId`. The collection layer enforces
+     * the XOR invariant — passing `subscriberKind: 'external'` without a
+     * non-empty `subscriberExternalId` throws.
+     */
+    record(options: RecordUsageOptions): Promise<void>;
+    /**
+     * Summarize usage over a window for a given subscriber.
+     *
+     * The `ai.*` short-circuit only fires for `'tenant'`-kind subscribers since
+     * the `_smrt_ai_usage` system table is tenant-scoped; external subscribers
+     * fall through to the normal `_smrt_tenant_usage_metrics` aggregation.
+     */
+    summarize(options: SummarizeUsageOptions): Promise<UsageSummary>;
+    summarizeBatch(options: SummarizeUsageBatchOptions): Promise<UsageSummary[]>;
+    summarizeAiUsage(options: SummarizeAiUsageOptions): Promise<AiUsageSummary>;
+    getOptions(): SmrtClassOptions;
+    private trySummarizeAiMetric;
+}
+//# sourceMappingURL=usage-meter.d.ts.map

package/dist/services/usage-meter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-meter.d.ts","sourceRoot":"","sources":["../../src/services/usage-meter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAC;AAC5F,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,YAAY,EACb,MAAM,aAAa,CAAC;AAGrB,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,OAAO,EAAE,2BAA2B,EACpC,YAAY,GAAE,gBAAqB;WAGzC,MAAM,CACjB,YAAY,GAAE,gBAAqB,GAClC,OAAO,CAAC,gBAAgB,CAAC;IAK5B;;;;;;;;OAQG;IACG,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD;;;;;;OAMG;IACG,SAAS,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IAoBhE,cAAc,CAClB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,YAAY,EAAE,CAAC;IAoDpB,gBAAgB,CACpB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,cAAc,CAAC;IAI1B,UAAU,IAAI,gBAAgB;YAIhB,oBAAoB;CA+BnC"}