@schematichq/schematic-typescript-node 1.4.7 → 1.5.0

package/dist/api/resources/plans/client/Client.d.ts

@@ -242,7 +242,7 @@ export declare class PlansClient {
      *
      * @example
      *     await client.plans.upsertPlanForBillingProduct({
-     *         billingProvider: "orb",
+     *         billingProvider: "metronome",
      *         description: "description",
      *         externalResourceId: "external_resource_id",
      *         name: "name",

package/dist/api/resources/plans/client/requests/CreateBillingLinkedPlanRequestBody.d.ts

@@ -2,7 +2,7 @@ import type * as Schematic from "../../../../index";
 /**
  * @example
  *     {
- *         billingProvider: "orb",
+ *         billingProvider: "metronome",
  *         description: "description",
  *         externalResourceId: "external_resource_id",
  *         name: "name",

package/dist/api/types/AccountMemberResponseData.d.ts

@@ -2,8 +2,10 @@ import type * as Schematic from "../index";
 export interface AccountMemberResponseData {
     createdAt: Date;
     email?: string;
+    firstName?: string;
     id: string;
     imageUrl?: string;
+    lastName?: string;
     name?: string;
     permissions: Record<string, Schematic.AccountMemberPermission[]>;
     role?: Schematic.AccountMemberRole;

package/dist/api/types/BillingCreditGrantReason.d.ts

@@ -4,5 +4,6 @@ export declare const BillingCreditGrantReason: {
     readonly Free: "free";
     readonly Plan: "plan";
     readonly Purchased: "purchased";
+    readonly Rollover: "rollover";
 };
 export type BillingCreditGrantReason = (typeof BillingCreditGrantReason)[keyof typeof BillingCreditGrantReason];

package/dist/api/types/BillingCreditGrantResponseData.d.ts

@@ -18,6 +18,10 @@ export interface BillingCreditGrantResponseData {
     quantityUsed: number;
     renewalEnabled: boolean;
     renewalPeriod?: Schematic.BillingPlanCreditGrantResetCadence;
+    reserved?: number;
+    settled?: number;
+    /** For rollover grants, the ID of the source grant that this grant rolled from. */
+    sourceGrantId?: string;
     sourceLabel: string;
     transfers?: Schematic.CreditTransferResponseData[];
     updatedAt: Date;

package/dist/api/types/BillingCreditLedgerAuthority.d.ts

@@ -0,0 +1,6 @@
+export declare const BillingCreditLedgerAuthority: {
+    readonly SchematicAuthoritative: "schematic_authoritative";
+    readonly ExternalMirror: "external_mirror";
+    readonly ExternalRated: "external_rated";
+};
+export type BillingCreditLedgerAuthority = (typeof BillingCreditLedgerAuthority)[keyof typeof BillingCreditLedgerAuthority];

package/dist/api/types/BillingCreditView.d.ts

@@ -12,6 +12,7 @@ export interface BillingCreditView {
     environmentId: string;
     icon?: string;
     id: string;
+    ledgerAuthority: Schematic.BillingCreditLedgerAuthority;
     name: string;
     pluralName?: string;
     price?: Schematic.BillingPriceView;

package/dist/api/types/BillingPlanCreditGrantResponseData.d.ts

@@ -31,5 +31,7 @@ export interface BillingPlanCreditGrantResponseData {
     resetCadence?: Schematic.BillingPlanCreditGrantResetCadence;
     resetStart?: Schematic.BillingPlanCreditGrantResetStart;
     resetType?: Schematic.BillingPlanCreditGrantResetType;
+    /** Percentage of unused credits that carry over when this grant resets. Only meaningful when reset_type is plan_period. */
+    rolloverPercentage: number;
     updatedAt: Date;
 }

package/dist/api/types/BillingProviderType.d.ts

@@ -1,4 +1,5 @@
 export declare const BillingProviderType: {
+    readonly Metronome: "metronome";
     readonly Orb: "orb";
     readonly Schematic: "schematic";
     readonly Stripe: "stripe";

package/dist/api/types/ChangeSubscriptionInternalRequestBody.d.ts

@@ -5,6 +5,7 @@ export interface ChangeSubscriptionInternalRequestBody {
     companyId: string;
     couponExternalId?: string;
     creditBundles: Schematic.UpdateCreditBundleRequestBody[];
+    customFieldValues: Schematic.CheckoutFieldValue[];
     newPlanId: string;
     newPriceId: string;
     payInAdvance: Schematic.UpdatePayInAdvanceRequestBody[];

package/dist/api/types/ChangeSubscriptionRequestBody.d.ts

@@ -4,6 +4,7 @@ export interface ChangeSubscriptionRequestBody {
     autoTopupOverrides: Schematic.UpdateAutoTopupOverrideRequestBody[];
     couponExternalId?: string;
     creditBundles: Schematic.UpdateCreditBundleRequestBody[];
+    customFieldValues: Schematic.CheckoutFieldValue[];
     newPlanId: string;
     newPriceId: string;
     payInAdvance: Schematic.UpdatePayInAdvanceRequestBody[];

package/dist/api/types/CheckoutDataResponseData.d.ts

@@ -5,6 +5,7 @@ export interface CheckoutDataResponseData {
     activeUsageBasedEntitlements: Schematic.UsageBasedEntitlementResponseData[];
     availableCreditBundles: Schematic.BillingCreditBundleResponseData[];
     company?: Schematic.CompanyDetailResponseData;
+    customCheckoutFields: Schematic.CheckoutFieldWithValue[];
     featureUsage?: Schematic.FeatureUsageDetailResponseData;
     selectedCreditBundles: Schematic.CreditBundlePurchaseResponseData[];
     selectedPlan?: Schematic.PlanDetailResponseData;

package/dist/api/types/CheckoutFieldInput.d.ts

@@ -0,0 +1,8 @@
+export interface CheckoutFieldInput {
+    definitionId?: string;
+    helperText?: string;
+    id?: string;
+    name: string;
+    required: boolean;
+    stripeMetadataKey: string;
+}

package/dist/api/types/CheckoutFieldResponseData.d.ts

@@ -0,0 +1,12 @@
+export interface CheckoutFieldResponseData {
+    createdAt: Date;
+    definitionId: string;
+    helperText?: string;
+    id: string;
+    name: string;
+    position: number;
+    required: boolean;
+    stripeMetadataKey: string;
+    traitHierarchy: string[];
+    updatedAt: Date;
+}

package/dist/api/types/CheckoutFieldValue.d.ts

@@ -0,0 +1,4 @@
+export interface CheckoutFieldValue {
+    id: string;
+    value: string;
+}

package/dist/api/types/CheckoutFieldWithValue.d.ts

@@ -0,0 +1,9 @@
+export interface CheckoutFieldWithValue {
+    definitionId: string;
+    helperText?: string;
+    id: string;
+    name: string;
+    required: boolean;
+    stripeMetadataKey: string;
+    value?: string;
+}

package/dist/api/types/CompanyCreditBalanceResponseData.d.ts

@@ -2,6 +2,8 @@ import type * as Schematic from "../index";
 export interface CompanyCreditBalanceResponseData {
     creditId: string;
     remaining: number;
+    reserved: number;
+    settled: number;
     source: Schematic.BillingProviderType;
     total?: number;
 }

package/dist/api/types/CompanyPlanCreditGrantView.d.ts

@@ -34,6 +34,7 @@ export interface CompanyPlanCreditGrantView {
     resetCadence?: Schematic.BillingPlanCreditGrantResetCadence;
     resetStart?: Schematic.BillingPlanCreditGrantResetStart;
     resetType: Schematic.BillingPlanCreditGrantResetType;
+    rolloverPercentage: number;
     /** Deprecated field, will be removed in the future. Use Credit.SingularName instead. */
     singularName?: string;
     updatedAt: Date;

package/dist/api/types/ComponentHydrateResponseData.d.ts

@@ -10,6 +10,7 @@ export interface ComponentHydrateResponseData {
     component?: Schematic.ComponentResponseData;
     creditBundles: Schematic.BillingCreditBundleView[];
     creditGrants: Schematic.CreditCompanyGrantView[];
+    customCheckoutFields: Schematic.CheckoutFieldWithValue[];
     defaultPlan?: Schematic.PlanDetailResponseData;
     displaySettings: Schematic.ComponentDisplaySettings;
     featureUsage?: Schematic.FeatureUsageDetailResponseData;

package/dist/api/types/ComponentPreviewResponseData.d.ts

@@ -10,6 +10,7 @@ export interface ComponentPreviewResponseData {
     component?: Schematic.ComponentResponseData;
     creditBundles: Schematic.BillingCreditBundleView[];
     creditGrants: Schematic.CreditCompanyGrantView[];
+    customCheckoutFields: Schematic.CheckoutFieldWithValue[];
     defaultPlan?: Schematic.PlanDetailResponseData;
     displaySettings: Schematic.ComponentDisplaySettings;
     featureUsage?: Schematic.FeatureUsageDetailResponseData;

package/dist/api/types/CreateBillingPlanCreditGrantRequestBody.d.ts

@@ -20,4 +20,6 @@ export interface CreateBillingPlanCreditGrantRequestBody {
     resetCadence: Schematic.BillingPlanCreditGrantResetCadence;
     resetStart: Schematic.BillingPlanCreditGrantResetStart;
     resetType?: Schematic.BillingPlanCreditGrantResetType;
+    /** Percentage of unused credits that carry over when this grant resets. Only applies when reset_type is plan_period. Rolled-over credits expire at the next reset and are not rolled again. Defaults to 0. */
+    rolloverPercentage?: number;
 }

package/dist/api/types/CreditCompanyGrantView.d.ts

@@ -25,7 +25,10 @@ export interface CreditCompanyGrantView {
     quantityUsed: number;
     renewalEnabled: boolean;
     renewalPeriod?: Schematic.BillingPlanCreditGrantResetCadence;
+    reserved?: number;
+    settled?: number;
     singularName?: string;
+    sourceGrantId?: string;
     sourceLabel: string;
     transfers?: Schematic.CreditTransferView[];
     updatedAt: Date;

package/dist/api/types/CreditEventLedgerResponseData.d.ts

@@ -30,5 +30,6 @@ export interface CreditEventLedgerResponseData {
     sourceId: number;
     toGrantId?: string;
     usageEventId?: string;
+    usageReason?: Schematic.CreditUsageReason;
     zeroedOutReason?: Schematic.BillingCreditGrantZeroedOutReason;
 }

package/dist/api/types/CreditUsageReason.d.ts

@@ -0,0 +1,8 @@
+export declare const CreditUsageReason: {
+    readonly LeaseHold: "lease_hold";
+    readonly LeaseRelease: "lease_release";
+    readonly ManualAdjustment: "manual_adjustment";
+    readonly Reconciliation: "reconciliation";
+    readonly Track: "track";
+};
+export type CreditUsageReason = (typeof CreditUsageReason)[keyof typeof CreditUsageReason];

package/dist/api/types/EventDetailResponseData.d.ts

@@ -14,6 +14,7 @@ export interface EventDetailResponseData {
     features: Schematic.PreviewObject[];
     id: string;
     idempotencyKey?: string;
+    leaseId?: string;
     loadedAt?: Date;
     processedAt?: Date;
     quantity: number;

package/dist/api/types/EventResponseData.d.ts

@@ -11,6 +11,7 @@ export interface EventResponseData {
     featureIds: string[];
     id: string;
     idempotencyKey?: string;
+    leaseId?: string;
     loadedAt?: Date;
     processedAt?: Date;
     quantity: number;

package/dist/api/types/InstallIntegrationRequestBody.d.ts

@@ -0,0 +1,9 @@
+import type * as Schematic from "../index";
+export interface InstallIntegrationRequestBody {
+    companyMatchingCriteria?: Schematic.CompanyMatchingCriteria;
+    companyMatchingField?: string;
+    config?: Record<string, unknown>;
+    isSandbox?: boolean;
+    liveMode?: boolean;
+    type: Schematic.IntegrationType;
+}

package/dist/api/types/IntegrationConfig.d.ts

@@ -1,9 +1,12 @@
 import type * as Schematic from "../index";
-export type IntegrationConfig = Schematic.IntegrationConfig.Clerk | Schematic.IntegrationConfig.Orb | Schematic.IntegrationConfig.Stripe | Schematic.IntegrationConfig.Workos;
+export type IntegrationConfig = Schematic.IntegrationConfig.Clerk | Schematic.IntegrationConfig.Metronome | Schematic.IntegrationConfig.Orb | Schematic.IntegrationConfig.Stripe | Schematic.IntegrationConfig.Workos;
 export declare namespace IntegrationConfig {
     interface Clerk extends Schematic.ClerkIntegrationConfig {
         type: "clerk";
     }
+    interface Metronome extends Schematic.MetronomeIntegrationConfig {
+        type: "metronome";
+    }
     interface Orb extends Schematic.OrbIntegrationConfig {
         type: "orb";
     }

package/dist/api/types/IntegrationInstallConfig.d.ts

@@ -0,0 +1,13 @@
+import type * as Schematic from "../index";
+export interface IntegrationInstallConfig {
+    companyMatchingCriteria?: Schematic.CompanyMatchingCriteria;
+    companyMatchingField?: string;
+    config?: Schematic.IntegrationConfig;
+    createdAt: Date;
+    id: string;
+    integrationId: string;
+    isAppInstall: boolean;
+    isConnectInstall: boolean;
+    liveMode: boolean;
+    updatedAt: Date;
+}

package/dist/api/types/IntegrationInstallResponseData.d.ts

@@ -0,0 +1,6 @@
+import type * as Schematic from "../index";
+export interface IntegrationInstallResponseData {
+    capabilities: Schematic.IntegrationCapabilities;
+    config: Schematic.IntegrationInstallConfig;
+    integration: Schematic.IntegrationResponseData;
+}

package/dist/api/types/IntegrationType.d.ts

@@ -1,5 +1,6 @@
 export declare const IntegrationType: {
     readonly Clerk: "clerk";
+    readonly Metronome: "metronome";
     readonly Orb: "orb";
     readonly Stripe: "stripe";
     readonly Unknown: "unknown";

package/dist/api/types/ManagePlanRequest.d.ts

@@ -9,6 +9,7 @@ export interface ManagePlanRequest {
     companyId: string;
     couponExternalId?: string;
     creditBundles: Schematic.UpdateCreditBundleRequestBody[];
+    customFieldValues: Schematic.CheckoutFieldValue[];
     payInAdvanceEntitlements: Schematic.UpdatePayInAdvanceRequestBody[];
     paymentMethodExternalId?: string;
     promoCode?: string;

package/dist/api/types/MetronomeIntegrationConfig.d.ts

@@ -0,0 +1 @@
+export type MetronomeIntegrationConfig = {};

package/dist/api/types/MigrationErrorCode.d.ts

@@ -3,6 +3,7 @@ export declare const MigrationErrorCode: {
     readonly MultipleSubscriptions: "multiple_subscriptions";
     readonly NoPriceForInterval: "no_price_for_interval";
     readonly NotOnOriginVersion: "not_on_origin_version";
+    readonly OperationItemNotFound: "operation_item_not_found";
     readonly PermanentConfig: "permanent_config";
     readonly PermanentDecline: "permanent_decline";
     readonly TransientDecline: "transient_decline";

package/dist/api/types/PlanCreditGrantView.d.ts

@@ -31,6 +31,7 @@ export interface PlanCreditGrantView {
     resetCadence?: Schematic.BillingPlanCreditGrantResetCadence;
     resetStart?: Schematic.BillingPlanCreditGrantResetStart;
     resetType: Schematic.BillingPlanCreditGrantResetType;
+    rolloverPercentage: number;
     /** Deprecated field, will be removed in the future. Use Credit.SingularName instead. */
     singularName?: string;
     updatedAt: Date;

package/dist/api/types/PlanGroupDetailResponseData.d.ts

@@ -3,6 +3,7 @@ export interface PlanGroupDetailResponseData {
     addOns: Schematic.PlanGroupPlanDetailResponseData[];
     checkoutSettings: Schematic.CheckoutSettingsResponseData;
     componentSettings: Schematic.ComponentSettingsResponseData;
+    customCheckoutFields: Schematic.CheckoutFieldResponseData[];
     customPlanConfig?: Schematic.CustomPlanViewConfigResponseData;
     customPlanId?: string;
     defaultPlan?: Schematic.PlanGroupPlanDetailResponseData;

package/dist/api/types/UpdateBillingPlanCreditGrantRequestBody.d.ts

@@ -17,4 +17,6 @@ export interface UpdateBillingPlanCreditGrantRequestBody {
     resetCadence: Schematic.BillingPlanCreditGrantResetCadence;
     resetStart: Schematic.BillingPlanCreditGrantResetStart;
     resetType?: Schematic.BillingPlanCreditGrantResetType;
+    /** Percentage of unused credits that carry over when this grant resets. Only applies when reset_type is plan_period. Rolled-over credits expire at the next reset and are not rolled again. */
+    rolloverPercentage?: number;
 }

package/dist/api/types/index.d.ts

@@ -22,6 +22,7 @@ export * from "./BillingCreditExpiryUnit";
 export * from "./BillingCreditGrantReason";
 export * from "./BillingCreditGrantResponseData";
 export * from "./BillingCreditGrantZeroedOutReason";
+export * from "./BillingCreditLedgerAuthority";
 export * from "./BillingCreditLedgerResponseData";
 export * from "./BillingCreditResponseData";
 export * from "./BillingCreditRolloverPolicy";
@@ -65,6 +66,10 @@ export * from "./CheckFlagResponseData";
 export * from "./CheckFlagsBulkResponseData";
 export * from "./CheckFlagsResponseData";
 export * from "./CheckoutDataResponseData";
+export * from "./CheckoutFieldInput";
+export * from "./CheckoutFieldResponseData";
+export * from "./CheckoutFieldValue";
+export * from "./CheckoutFieldWithValue";
 export * from "./CheckoutSettingsResponseData";
 export * from "./CheckoutSubscription";
 export * from "./ClerkIntegrationConfig";
@@ -143,6 +148,7 @@ export * from "./CreditTransferView";
 export * from "./CreditTriggerConfig";
 export * from "./CreditUsage";
 export * from "./CreditUsageAggregation";
+export * from "./CreditUsageReason";
 export * from "./CurrencyPriceRequestBody";
 export * from "./CustomPlanActivationStrategy";
 export * from "./CustomPlanBillingResponseData";
@@ -209,8 +215,11 @@ export * from "./FlagType";
 export * from "./FlagView";
 export * from "./GenericPreviewObject";
 export * from "./InsightsSummaryResponseData";
+export * from "./InstallIntegrationRequestBody";
 export * from "./IntegrationCapabilities";
 export * from "./IntegrationConfig";
+export * from "./IntegrationInstallConfig";
+export * from "./IntegrationInstallResponseData";
 export * from "./IntegrationResponseData";
 export * from "./IntegrationState";
 export * from "./IntegrationsDataSetResponseData";
@@ -231,6 +240,7 @@ export * from "./MarkCustomPlanBillingPaidRequestBody";
 export * from "./MeterRequestBody";
 export * from "./MetricPeriod";
 export * from "./MetricPeriodMonthReset";
+export * from "./MetronomeIntegrationConfig";
 export * from "./MigrationErrorCode";
 export * from "./MrrResponseData";
 export * from "./OrbIntegrationConfig";

package/dist/cache/redis.d.ts

@@ -1,7 +1,10 @@
 import { CacheProvider, CacheOptions } from "./types";
 /**
- * Minimal interface describing the redis client methods used by RedisCacheProvider.
- * Compatible with the 'redis' package's RedisClientType.
+ * Minimal interface describing the redis client methods used by the SDK.
+ * Compatible with the 'redis' package's RedisClientType (node-redis v4).
+ *
+ * Includes hash + sorted-set + eval surface used by the credit-lease and
+ * reservation stores to coordinate state across multiple SDK pods.
  */
 export interface RedisClient {
     get(key: string): Promise<string | null>;
@@ -12,6 +15,30 @@ export interface RedisClient {
         MATCH: string;
         COUNT: number;
     }): AsyncIterable<string>;
+    hSet(key: string, field: string | Record<string, string | number>, value?: string | number): Promise<unknown>;
+    hGet(key: string, field: string): Promise<string | null | undefined>;
+    hGetAll(key: string): Promise<Record<string, string>>;
+    hDel(key: string, field: string | string[]): Promise<unknown>;
+    zAdd(key: string, members: {
+        score: number;
+        value: string;
+    } | {
+        score: number;
+        value: string;
+    }[]): Promise<unknown>;
+    zRangeByScore(key: string, min: number | string, max: number | string, options?: {
+        LIMIT: {
+            offset: number;
+            count: number;
+        };
+    }): Promise<string[]>;
+    zRem(key: string, member: string | string[]): Promise<unknown>;
+    zCard(key: string): Promise<number>;
+    eval(script: string, options: {
+        keys: string[];
+        arguments: string[];
+    }): Promise<unknown>;
+    pExpireAt(key: string, timestamp: number): Promise<unknown>;
 }
 export interface RedisOptions extends CacheOptions {
     /** Pre-created, connected redis client */

package/dist/credits/check.d.ts

@@ -0,0 +1,49 @@
+import type * as api from "../api";
+import type { DataStreamClient } from "../datastream";
+import type { Logger } from "../logger";
+import type { CheckFlagOptions } from "../wrapper";
+import { CreditLeaseManager } from "./lease-manager";
+import type { ILeaseStore } from "./lease-store";
+import type { IReservationStore } from "./reservation-store";
+import type { CheckOptions, CheckResult } from "./types";
+/** Internal helper bundling everything needed to satisfy a lease-bearing check. */
+export interface CreditCheckDeps {
+    leaseStore: ILeaseStore;
+    reservations: IReservationStore;
+    manager: CreditLeaseManager;
+    datastream: DataStreamClient | undefined;
+    logger: Logger;
+    /**
+     * Report a `flag_check` event for a check the lease path resolved itself.
+     * Mirrors the plain `checkFlag` paths (which enqueue one per check) so
+     * lease-gated checks stay visible to flag-check analytics and company
+     * last-seen. Fallback exits don't call this — the plain check they
+     * delegate to enqueues its own.
+     */
+    enqueueFlagCheckEvent: (body: api.EventBodyFlagCheck) => void;
+}
+/**
+ * Drives a single `client.check` with `usage` set.
+ *
+ * Steps:
+ *   1. Resolve the matching credit-balance condition on the flag to get
+ *      `creditId` + `consumptionRate`.
+ *   2. Acquire (or reuse) a lease for `(company, creditId)`.
+ *   3. Try to reserve `quantity × consumptionRate` from the lease.
+ *   4. Run the WASM rules engine against a substituted company snapshot
+ *      (`credit_balances[creditId] = lease.localRemaining` *before* the
+ *      reservation we just made was debited), plus `event_usage` options so
+ *      the engine evaluates the post-call balance. The reservation we made
+ *      in step 3 only sticks if the engine says allowed.
+ */
+export declare function checkWithLease(deps: CreditCheckDeps, key: string, evalCtx: api.CheckFlagRequestBody, options: CheckOptions, fallback: () => Promise<CheckResult>): Promise<CheckResult>;
+/**
+ * Build the preflight options envelope for a client-side rules evaluation.
+ * With an `eventSubtype` the quantity goes out as the `event_usage` pair so
+ * the engine matches it to the subtype's condition; without one it goes out
+ * as the generic `usage` knob. Exported so `client.check`'s fallback path can
+ * thread the same preflight through a plain flag check — any client-side
+ * evaluation (datastream, replicator) honors it even when the lease path
+ * can't run.
+ */
+export declare function buildPreflightOptions(options: CheckOptions): CheckFlagOptions | undefined;

package/dist/credits/index.d.ts

@@ -0,0 +1,7 @@
+export { LeaseStore, leaseKey, type LeaseEntry, type ILeaseStore } from "./lease-store";
+export { ReservationStore, type IReservationStore } from "./reservation-store";
+export { CreditLeaseManager } from "./lease-manager";
+export { RedisLeaseStore } from "./redis-lease-store";
+export { RedisReservationStore } from "./redis-reservation-store";
+export { DEFAULT_LEASE_DURATION_MS, DEFAULT_LEASE_SIZE, DEFAULT_LOW_WATER_MARK, DEFAULT_PREWARM_POLL_INTERVAL_MS, DEFAULT_PREWARM_RESOLVE_TIMEOUT_MS, DEFAULT_RESERVATION_TTL_MS, DEFAULT_SWEEP_INTERVAL_MS, } from "./types";
+export type { CreditLeaseConfig, ResolvedLeaseConfig, Reservation, CheckOptions, CheckResult, OnAcquireFailure, TrackWithReservationOptions, } from "./types";

package/dist/credits/lease-manager.d.ts

@@ -0,0 +1,68 @@
+import type { CreditsClient } from "../api/resources/credits/client/Client";
+import type { Logger } from "../logger";
+import { type ILeaseStore, type LeaseEntry } from "./lease-store";
+import { type CreditLeaseConfig, type ResolvedLeaseConfig } from "./types";
+/**
+ * Owns the lifecycle of `credit_lease` rows for a single client: acquire on
+ * first use or after expiry, extend when the local view dips below the low
+ * water mark, release on `client.close()`.
+ *
+ * Concurrency: each operation (acquire, extend) has its own best-effort
+ * single-flight map keyed by `(company, creditType)`. It's best-effort —
+ * callers racing ahead of the registration can still issue duplicate wire
+ * calls — which is safe because the server is idempotent for an active slot
+ * and `replace` keeps the first live lease.
+ */
+export declare class CreditLeaseManager {
+    private readonly creditsClient;
+    private readonly leaseStore;
+    private readonly logger;
+    private readonly config;
+    private readonly inflightAcquire;
+    private readonly inflightExtend;
+    constructor(opts: {
+        creditsClient: CreditsClient;
+        leaseStore: ILeaseStore;
+        logger: Logger;
+        config: CreditLeaseConfig;
+    });
+    resolveConfig(creditTypeId: string): ResolvedLeaseConfig;
+    /**
+     * Return the current lease entry, acquiring one (or replacing an expired
+     * one) if none is live. Best-effort single-flight: callers arriving after
+     * a request is registered share it (the first caller's `requestOptions`
+     * win); callers racing ahead of registration may duplicate the wire call,
+     * which the server's idempotent acquire absorbs.
+     * Never rejects: a store (Redis) failure is logged and reported as
+     * `undefined`, the same as a wire failure, so callers route it through
+     * their fail-open/fail-closed handling instead of an unhandled rejection.
+     */
+    acquireIfNeeded(companyId: string, creditTypeId: string, requestOptions?: CreditsClient.RequestOptions): Promise<LeaseEntry | undefined>;
+    private acquire;
+    /**
+     * Single-flight: kick off a background extend when one is warranted.
+     * An extend is triggered if EITHER:
+     *   - the local remaining is below the low-water-mark ratio (steady-state
+     *     refresh), or
+     *   - the caller passes `requiredCredits` and the local remaining is below
+     *     that figure (a single check just failed a reserve for that many
+     *     credits — extend opportunistically instead of waiting for the next
+     *     sub-watermark check).
+     * Returns the in-flight promise so callers can await it or fire-and-forget.
+     * Never rejects (it is often fire-and-forget — a rejection would surface
+     * as an unhandled promise rejection).
+     */
+    maybeExtendInBackground(companyId: string, creditTypeId: string, requiredCredits?: number, requestOptions?: CreditsClient.RequestOptions): Promise<LeaseEntry | undefined>;
+    private extend;
+    /**
+     * Release every live lease held in the store. ONLY safe when the store is
+     * per-process (in-memory): those leases are exclusively this process's, so
+     * releasing them on `close()` returns their unspent remainder to the
+     * company balance immediately instead of waiting out the lease expiry. A
+     * shared (Redis) store must never do this — sibling pods are still
+     * drawing on the same leases — and is excluded by the `list` capability
+     * check (only the in-memory store implements it). Best-effort: failures
+     * are logged and the lease falls back to server-side expiry.
+     */
+    releaseAllLocalLeases(): Promise<void>;
+}