@schematichq/schematic-typescript-node 1.5.13 → 1.6.1

package/dist/serialization/resources/credits/client/requests/ReserveCreditsRequestBody.d.ts

@@ -0,0 +1,13 @@
+import type * as Schematic from "../../../../../api/index";
+import * as core from "../../../../../core";
+import type * as serializers from "../../../../index";
+export declare const ReserveCreditsRequestBody: core.serialization.Schema<serializers.ReserveCreditsRequestBody.Raw, Schematic.ReserveCreditsRequestBody>;
+export declare namespace ReserveCreditsRequestBody {
+    interface Raw {
+        amount: number;
+        company_id: string;
+        credit_type_id: string;
+        expires_at?: string | null;
+        idempotency_key?: string | null;
+    }
+}

package/dist/serialization/resources/credits/client/requests/index.d.ts

@@ -4,6 +4,7 @@ export { CreateCompanyCreditGrant } from "./CreateCompanyCreditGrant";
 export { CreateCreditBundleRequestBody } from "./CreateCreditBundleRequestBody";
 export { CreateCreditSpendPolicyRequestBody } from "./CreateCreditSpendPolicyRequestBody";
 export { ExtendCreditLeaseRequestBody } from "./ExtendCreditLeaseRequestBody";
+export { ReserveCreditsRequestBody } from "./ReserveCreditsRequestBody";
 export { UpdateBillingCreditRequestBody } from "./UpdateBillingCreditRequestBody";
 export { UpdateCreditBundleDetailsRequestBody } from "./UpdateCreditBundleDetailsRequestBody";
 export { UpdateCreditSpendPolicyRequestBody } from "./UpdateCreditSpendPolicyRequestBody";

package/dist/serialization/resources/credits/types/ReleaseCreditReservationResponse.d.ts

@@ -0,0 +1,11 @@
+import type * as Schematic from "../../../../api/index";
+import * as core from "../../../../core";
+import type * as serializers from "../../../index";
+import { CreditReservationResponseData } from "../../../types/CreditReservationResponseData";
+export declare const ReleaseCreditReservationResponse: core.serialization.ObjectSchema<serializers.ReleaseCreditReservationResponse.Raw, Schematic.ReleaseCreditReservationResponse>;
+export declare namespace ReleaseCreditReservationResponse {
+    interface Raw {
+        data: CreditReservationResponseData.Raw;
+        params: Record<string, unknown>;
+    }
+}

package/dist/serialization/resources/credits/types/ReserveCreditsResponse.d.ts

@@ -0,0 +1,11 @@
+import type * as Schematic from "../../../../api/index";
+import * as core from "../../../../core";
+import type * as serializers from "../../../index";
+import { CreditReservationResponseData } from "../../../types/CreditReservationResponseData";
+export declare const ReserveCreditsResponse: core.serialization.ObjectSchema<serializers.ReserveCreditsResponse.Raw, Schematic.ReserveCreditsResponse>;
+export declare namespace ReserveCreditsResponse {
+    interface Raw {
+        data: CreditReservationResponseData.Raw;
+        params: Record<string, unknown>;
+    }
+}

package/dist/serialization/resources/credits/types/index.d.ts

@@ -44,6 +44,8 @@ export * from "./ListCreditSpendPoliciesResponse";
 export * from "./ListGrantsForCreditParams";
 export * from "./ListGrantsForCreditResponse";
 export * from "./ReleaseCreditLeaseResponse";
+export * from "./ReleaseCreditReservationResponse";
+export * from "./ReserveCreditsResponse";
 export * from "./SoftDeleteBillingCreditResponse";
 export * from "./UpdateBillingCreditResponse";
 export * from "./UpdateBillingPlanCreditGrantResponse";

package/dist/serialization/resources/features/client/requests/CheckAndReserveFlagRequestBody.d.ts

@@ -0,0 +1,14 @@
+import type * as Schematic from "../../../../../api/index";
+import * as core from "../../../../../core";
+import type * as serializers from "../../../../index";
+import { PreflightRequestBody } from "../../../../types/PreflightRequestBody";
+export declare const CheckAndReserveFlagRequestBody: core.serialization.Schema<serializers.CheckAndReserveFlagRequestBody.Raw, Schematic.CheckAndReserveFlagRequestBody>;
+export declare namespace CheckAndReserveFlagRequestBody {
+    interface Raw {
+        company?: Record<string, string> | null;
+        expires_at?: string | null;
+        preflight?: PreflightRequestBody.Raw | null;
+        quantity?: number | null;
+        user?: Record<string, string> | null;
+    }
+}

package/dist/serialization/resources/features/client/requests/index.d.ts

@@ -1,3 +1,4 @@
+export { CheckAndReserveFlagRequestBody } from "./CheckAndReserveFlagRequestBody";
 export { CheckFlagsBulkRequestBody } from "./CheckFlagsBulkRequestBody";
 export { CreateBillingLinkedFeatureRequestBody } from "./CreateBillingLinkedFeatureRequestBody";
 export { CreateFeatureRequestBody } from "./CreateFeatureRequestBody";

package/dist/serialization/resources/features/types/CheckAndReserveFlagResponse.d.ts

@@ -0,0 +1,11 @@
+import type * as Schematic from "../../../../api/index";
+import * as core from "../../../../core";
+import type * as serializers from "../../../index";
+import { CheckAndReserveFlagResponseData } from "../../../types/CheckAndReserveFlagResponseData";
+export declare const CheckAndReserveFlagResponse: core.serialization.ObjectSchema<serializers.CheckAndReserveFlagResponse.Raw, Schematic.CheckAndReserveFlagResponse>;
+export declare namespace CheckAndReserveFlagResponse {
+    interface Raw {
+        data: CheckAndReserveFlagResponseData.Raw;
+        params: Record<string, unknown>;
+    }
+}

package/dist/serialization/resources/features/types/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./CheckAndReserveFlagResponse";
 export * from "./CheckFlagResponse";
 export * from "./CheckFlagsBulkResponse";
 export * from "./CheckFlagsResponse";

package/dist/serialization/resources/planmigrations/types/CountMigrationsParams.d.ts

@@ -5,6 +5,7 @@ import { PlanVersionMigrationStatus } from "../../../types/PlanVersionMigrationS
 export declare const CountMigrationsParams: core.serialization.ObjectSchema<serializers.CountMigrationsParams.Raw, Schematic.CountMigrationsParams>;
 export declare namespace CountMigrationsParams {
     interface Raw {
+        feature_id?: string | null;
         limit?: number | null;
         offset?: number | null;
         plan_version_id?: string | null;

package/dist/serialization/resources/planmigrations/types/ListMigrationsParams.d.ts

@@ -5,6 +5,7 @@ import { PlanVersionMigrationStatus } from "../../../types/PlanVersionMigrationS
 export declare const ListMigrationsParams: core.serialization.ObjectSchema<serializers.ListMigrationsParams.Raw, Schematic.ListMigrationsParams>;
 export declare namespace ListMigrationsParams {
     interface Raw {
+        feature_id?: string | null;
         limit?: number | null;
         offset?: number | null;
         plan_version_id?: string | null;

package/dist/serialization/resources/plans/types/CountPlansParams.d.ts

@@ -21,7 +21,9 @@ export declare namespace CountPlansParams {
         q?: string | null;
         scoped_to_company_id?: string | null;
         with_entitlements?: boolean | null;
+        with_published_version?: boolean | null;
         without_entitlement_for?: string | null;
+        without_entitlement_for_include_drafts?: boolean | null;
         without_paid_product_id?: boolean | null;
     }
 }

package/dist/serialization/resources/plans/types/ListPlansParams.d.ts

@@ -21,7 +21,9 @@ export declare namespace ListPlansParams {
         q?: string | null;
         scoped_to_company_id?: string | null;
         with_entitlements?: boolean | null;
+        with_published_version?: boolean | null;
         without_entitlement_for?: string | null;
+        without_entitlement_for_include_drafts?: boolean | null;
         without_paid_product_id?: boolean | null;
     }
 }

package/dist/serialization/types/CheckAndReserveFlagResponseData.d.ts

@@ -0,0 +1,28 @@
+import type * as Schematic from "../../api/index";
+import * as core from "../../core";
+import type * as serializers from "../index";
+import { FeatureEntitlement } from "./FeatureEntitlement";
+import { FlagCheckReservationResponseData } from "./FlagCheckReservationResponseData";
+import { MetricPeriod } from "./MetricPeriod";
+import { RuleType } from "./RuleType";
+export declare const CheckAndReserveFlagResponseData: core.serialization.ObjectSchema<serializers.CheckAndReserveFlagResponseData.Raw, Schematic.CheckAndReserveFlagResponseData>;
+export declare namespace CheckAndReserveFlagResponseData {
+    interface Raw {
+        company_id?: string | null;
+        entitlement?: FeatureEntitlement.Raw | null;
+        error?: string | null;
+        feature_allocation?: number | null;
+        feature_usage?: number | null;
+        feature_usage_event?: string | null;
+        feature_usage_period?: MetricPeriod.Raw | null;
+        feature_usage_reset_at?: string | null;
+        flag: string;
+        flag_id?: string | null;
+        reason: string;
+        reservation?: FlagCheckReservationResponseData.Raw | null;
+        rule_id?: string | null;
+        rule_type?: RuleType.Raw | null;
+        user_id?: string | null;
+        value: boolean;
+    }
+}

package/dist/serialization/types/CreditReservationResponseData.d.ts

@@ -0,0 +1,17 @@
+import type * as Schematic from "../../api/index";
+import * as core from "../../core";
+import type * as serializers from "../index";
+export declare const CreditReservationResponseData: core.serialization.ObjectSchema<serializers.CreditReservationResponseData.Raw, Schematic.CreditReservationResponseData>;
+export declare namespace CreditReservationResponseData {
+    interface Raw {
+        company_id: string;
+        created_at: string;
+        credit_type_id: string;
+        expires_at: string;
+        id: string;
+        released_at?: string | null;
+        reserved_amount: number;
+        settled_amount: number;
+        updated_at: string;
+    }
+}

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

@@ -3,5 +3,5 @@ import * as core from "../../core";
 import type * as serializers from "../index";
 export declare const CreditUsageReason: core.serialization.Schema<serializers.CreditUsageReason.Raw, Schematic.CreditUsageReason>;
 export declare namespace CreditUsageReason {
-    type Raw = "lease_hold" | "lease_release" | "manual_adjustment" | "reconciliation" | "track";
+    type Raw = "lease_hold" | "lease_release" | "manual_adjustment" | "reconciliation" | "reservation_hold" | "reservation_release" | "track";
 }

package/dist/serialization/types/EventBodyTrack.d.ts

@@ -8,6 +8,7 @@ export declare namespace EventBodyTrack {
         event: string;
         lease_id?: string | null;
         quantity?: number | null;
+        reservation_id?: string | null;
         traits?: Record<string, unknown> | null;
         user?: Record<string, string> | null;
     }

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

@@ -26,6 +26,7 @@ export declare namespace EventDetailResponseData {
         loaded_at?: string | null;
         processed_at?: string | null;
         quantity: number;
+        reservation_id?: string | null;
         sent_at?: string | null;
         status: EventStatus.Raw;
         subtype?: string | null;

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

@@ -21,6 +21,7 @@ export declare namespace EventResponseData {
         loaded_at?: string | null;
         processed_at?: string | null;
         quantity: number;
+        reservation_id?: string | null;
         sent_at?: string | null;
         status: EventStatus.Raw;
         subtype?: string | null;

package/dist/serialization/types/FlagCheckReservationResponseData.d.ts

@@ -0,0 +1,16 @@
+import type * as Schematic from "../../api/index";
+import * as core from "../../core";
+import type * as serializers from "../index";
+export declare const FlagCheckReservationResponseData: core.serialization.ObjectSchema<serializers.FlagCheckReservationResponseData.Raw, Schematic.FlagCheckReservationResponseData>;
+export declare namespace FlagCheckReservationResponseData {
+    interface Raw {
+        company_id: string;
+        consumption_rate: number;
+        credit_type_id: string;
+        credits_reserved: number;
+        event_subtype?: string | null;
+        expires_at: string;
+        id: string;
+        quantity_reserved: number;
+    }
+}

package/dist/serialization/types/PlanVersionMigrationResponseData.d.ts

@@ -12,6 +12,8 @@ export declare namespace PlanVersionMigrationResponseData {
         created_at: string;
         error?: string | null;
         failed_companies: number;
+        feature_id?: string | null;
+        feature_plan_rollout_id?: string | null;
         id: string;
         next_due_at?: string | null;
         plan_id: string;

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

@@ -79,6 +79,7 @@ export * from "./CatalogResponseData";
 export * from "./ChangeSubscriptionInternalRequestBody";
 export * from "./ChangeSubscriptionRequestBody";
 export * from "./ChargeType";
+export * from "./CheckAndReserveFlagResponseData";
 export * from "./CheckFlagRequestBody";
 export * from "./CheckFlagResponseData";
 export * from "./CheckFlagsBulkResponseData";
@@ -169,6 +170,7 @@ export * from "./CreditGrantDetail";
 export * from "./CreditGrantExpiryRequestBody";
 export * from "./CreditGrantSortOrder";
 export * from "./CreditLeaseResponseData";
+export * from "./CreditReservationResponseData";
 export * from "./CreditSpendPolicyResponseData";
 export * from "./CreditSpendPolicyScope";
 export * from "./CreditsAutoTopupCompanySummary";
@@ -251,6 +253,7 @@ export * from "./FeatureUsageLegacyResponseData";
 export * from "./FeatureUsageResponseData";
 export * from "./FeatureUsageTimeSeriesResponseData";
 export * from "./FeatureView";
+export * from "./FlagCheckReservationResponseData";
 export * from "./FlagDetailResponseData";
 export * from "./FlagInPlanResponseData";
 export * from "./FlagResponseData";
@@ -360,7 +363,6 @@ export * from "./PublicPlansResponseData";
 export * from "./QuickstartResp";
 export * from "./RawEventBatchResponseData";
 export * from "./RawEventResponseData";
-export * from "./ReleaseCreditLeaseRequestBody";
 export * from "./Rule";
 export * from "./RuleConditionDetailResponseData";
 export * from "./RuleConditionGroupDetailResponseData";

package/dist/wrapper.d.ts

@@ -55,12 +55,14 @@ export interface SchematicOptions {
     /** The default maximum time to wait for a response in milliseconds */
     timeoutMs?: number;
     /**
-     * Enable client-side credit lease + reservation behavior on `check` /
-     * `trackWithReservation`. Omit to keep the SDK lease-unaware.
+     * Enable credit reservation behavior on `check` / `trackWithReservation`.
+     * Omit to keep the SDK credit-unaware.
      *
-     * Lease-bearing checks require DataStream (or replicator mode) so the
-     * SDK has access to the cached flag + company state needed for local
-     * gating against the lease balance.
+     * Client mode (local leases) requires DataStream (or replicator mode) so
+     * the SDK has the cached flag + company state it needs to gate locally
+     * against the lease balance. Without DataStream the SDK gates in server
+     * mode instead — one `check-and-reserve` API call per check. See
+     * `CreditLeaseConfig.mode`.
      */
     creditLeases?: CreditLeaseConfig;
 }
@@ -145,6 +147,8 @@ export declare class SchematicClient extends BaseClient {
     private reservations?;
     private leaseBackendShared;
     private prewarmResolveTimeoutMs;
+    private creditLeaseMode?;
+    private serverReservationTTL;
     /**
      * Creates a new instance of the SchematicClient
      * @param opts - Configuration options for the client
@@ -154,6 +158,23 @@ export declare class SchematicClient extends BaseClient {
      * Returns whether DataStream is enabled and available
      */
     private useDataStream;
+    /**
+     * Whether the configured mode wants the local lease plumbing (stores,
+     * manager, sweeper). Read during construction, after the DataStream client
+     * has been wired, so `auto` can resolve against it.
+     */
+    private creditLeaseModeUsesLeases;
+    /**
+     * Which reservation mode a `check()` with `usage` resolves to right now.
+     * `undefined` means no credit gating at all — `creditLeases` isn't
+     * configured, or the client is offline.
+     *
+     * `auto` is resolved per check rather than once at startup so a DataStream
+     * that failed to start after construction (its `start()` rejection clears
+     * `datastreamClient`) falls to server mode instead of silently dropping
+     * every check to a plain, ungated flag check.
+     */
+    private effectiveLeaseMode;
     /**
      * Checks the value of a feature flag for the given evaluation context
      * @param evalCtx - The context (company and/or user) for evaluating the feature flag
@@ -232,11 +253,17 @@ export declare class SchematicClient extends BaseClient {
      */
     private resolveCompanyIdWithWait;
     /**
-     * Lease-aware feature check. When `creditLeases` is configured and the
+     * Credit-aware feature check. When `creditLeases` is configured and the
      * caller passes `usage` (optionally qualified by `eventSubtype`), this
-     * acquires a lease (if needed), gates the check against the lease's local
-     * balance via WASM, and returns a reservation handle on success — pass
-     * that handle to `trackWithReservation` when the work completes.
+     * gates the check against the company's credit balance and returns a
+     * reservation handle on success — pass that handle to
+     * `trackWithReservation` when the work completes.
+     *
+     * In client mode (DataStream enabled) the hold is carved out of a local
+     * lease and the flag is evaluated by the WASM engine. In server mode it is
+     * a single `check-and-reserve` API call that evaluates the flag and takes
+     * the hold server-side. `creditLeases.mode` picks; the default (`auto`)
+     * uses client mode when DataStream is enabled and server mode otherwise.
      *
      * When `creditLeases` is not configured (or `usage` is omitted) this falls
      * through to a plain flag check and returns `{allowed: value}` with no
@@ -255,6 +282,10 @@ export declare class SchematicClient extends BaseClient {
      * `actualQuantity × consumption_rate` from the company's real credit
      * balance.
      *
+     * A server-mode handle has no local hold to refund: the Track event carries
+     * the reservation id, and the server settles the hold (refunding the
+     * unspent slice) when it processes the event.
+     *
      * If the work outlived the reservation's TTL and the sweeper already
      * returned the hold to the lease, the local refund has happened but the
      * usage must still be billed — so we emit the Track anyway (a "recovery"
@@ -269,7 +300,7 @@ export declare class SchematicClient extends BaseClient {
      * accidental second `trackWithReservation`, collapses to a single billed
      * event — across pods and process restarts, not just within one process.
      */
-    trackWithReservation(reservation: Reservation, actualQuantity: number, options?: TrackWithReservationOptions): Promise<void>;
+    trackWithReservation(reservation: Reservation | undefined, actualQuantity: number, options?: TrackWithReservationOptions): Promise<void>;
     private resolveCompanyId;
     /**
      * Send a non-blocking event to create or update companies and users.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@schematichq/schematic-typescript-node",
-    "version": "1.5.13",
+    "version": "1.6.1",
     "private": false,
     "repository": {
         "type": "git",
@@ -57,12 +57,20 @@
         "crypto": false,
         "timers": false
     },
+    "resolutions": {
+        "sharp": "^0.35.4",
+        "undici": "7.29.0"
+    },
     "packageManager": "yarn@1.22.22",
     "engines": {
         "node": ">=18.0.0"
     },
     "sideEffects": false,
     "license": "MIT",
+    "resolutions": {
+        "sharp": "^0.35.4",
+        "undici": "7.29.0"
+    },
     "files": [
         "dist/**/*.js",
         "dist/**/*.d.ts",

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

@@ -1 +0,0 @@
-export type ReleaseCreditLeaseRequestBody = Record<string, unknown>;

package/dist/serialization/types/ReleaseCreditLeaseRequestBody.d.ts

@@ -1,7 +0,0 @@
-import type * as Schematic from "../../api/index";
-import * as core from "../../core";
-import type * as serializers from "../index";
-export declare const ReleaseCreditLeaseRequestBody: core.serialization.Schema<serializers.ReleaseCreditLeaseRequestBody.Raw, Schematic.ReleaseCreditLeaseRequestBody>;
-export declare namespace ReleaseCreditLeaseRequestBody {
-    type Raw = Record<string, unknown>;
-}