schematichq 1.5.2 → 1.5.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d5f68b11540e455fec79249c0a3e8a6bca7279e00ae3192f855e424eba9314c9
-  data.tar.gz: 732ed6c93fc15dd15b453fb4b873c4f1c252db187a750e6a633a76c6088feefa
+  metadata.gz: 42a7ac411958f446624efef8e76092dec19e652603089848b36d93fbe53a5f3f
+  data.tar.gz: 942a73f63c86d6c66f3bf57a369578479e18529943a3b234900e6b87116046e9
 SHA512:
-  metadata.gz: 8a3063e0d0d534c99d77b4cbc98272953ccbc04292f67768e7323d99faeaddc69f520ac91922c7c9d695fdb2b4240643213ecbdbe75d03a249871385e7ec5386
-  data.tar.gz: 67d03301abfdbb17162052217094762e656afee2b0f2e4ed32244858f17f5a807c62a866281de236776d53838e40bc08fa1537cbb3794f0e4c7d081d2de0e12b
+  metadata.gz: 90da04958f952788cb9fa76c46f5c791e2eba2754aec598007b7c66c0a5f80777e325345fe337155055a5301e3b61c482204dde4ef7d74830bb87d0f539a9126
+  data.tar.gz: 276cd27a9f3c58009313ff802cf87f09aafc7f689ab5d916e10764dda976dd06a553d7a65e8e69a02b9f358e3409faba975d26eac3d52c222aed8895673cf05f

data/.fern/metadata.json

@@ -13,10 +13,10 @@
       "webrick": ">= 1.0"
     }
   },
-  "originGitCommit": "4ca95f7ba356ea2c3b42db5e3e78c064477b3a8d",
+  "originGitCommit": "6a2f1e8406783d0f2591db2053e1a8a8df4a9046",
   "originGitCommitIsDirty": false,
   "invokedBy": "ci",
-  "requestedVersion": "1.5.2",
+  "requestedVersion": "1.5.3",
   "ciProvider": "github",
-  "sdkVersion": "1.5.2"
+  "sdkVersion": "1.5.3"
 }

data/.fern/replay.lock

@@ -114,341 +114,11 @@ generations:
     cli_version: unknown
     generator_versions:
       fernapi/fern-ruby-sdk: 1.25.0
-current_generation: ec0eabecc3325dfe0a69590f9a2f4e52c3c18ade
-patches:
-  - id: patch-5da692c2
-    content_hash: sha256:e652287219a0a709e16112ced444e6472c6fa8bdfe888edf868caaf9769a9472
-    original_commit: 5da692c20aef08577d900f9a860b5f78a549418e
-    original_message: inject host time into datastream wasm rules engine (SCHY-471)
-    original_author: Christopher Brady <chris@schematichq.com>
-    base_generation: ec0eabecc3325dfe0a69590f9a2f4e52c3c18ade
-    files:
-      - test/rules_engine_clock_test.rb
-    patch_content: |
-      diff --git a/test/rules_engine_clock_test.rb b/test/rules_engine_clock_test.rb
-      new file mode 100644
-      index 0000000..8711b5e
-      --- /dev/null
-      +++ b/test/rules_engine_clock_test.rb
-      @@ -0,0 +1,75 @@
-      +# frozen_string_literal: true
-      +
-      +require_relative "test_helper"
-      +require "minitest/autorun"
-      +
-      +# Regression for SCHY-471.
-      +#
-      +# A company-override entitlement rule whose metric condition uses a
-      +# calendar/billing metric period drives the engine into the metric-period-reset
-      +# code path, which needs a wall clock. On the raw wasm32-unknown-unknown build
-      +# that path used to trap (+wasm unreachable+); the flag then wrongly fell back to
-      +# its default value for a company that is legitimately entitled. The host now
-      +# injects the current time via +setCurrentTimeMillis+ so this evaluates cleanly.
-      +class RulesEngineClockTest < Minitest::Test
-      +  def setup
-      +    @engine = Schematic::RulesEngine.new
-      +    @engine.initialize!
-      +    # The wasm binary is fetched via scripts/download-wasm.sh and may be absent
-      +    # (or the wasmtime gem missing) in some environments — skip rather than fail.
-      +    skip "WASM rules engine unavailable (wasm binary or wasmtime gem missing)" unless @engine.initialized?
-      +  end
-      +
-      +  def flag
-      +    {
-      +      "id" => "flag1", "key" => "mcp-access", "account_id" => "acc_1",
-      +      "environment_id" => "env_1", "default_value" => false, "rules" => []
-      +    }
-      +  end
-      +
-      +  # Usage 40 < allocation 100, so the override grants the feature.
-      +  def entitled_company
-      +    {
-      +      "id" => "co_entitled", "account_id" => "acc_1", "environment_id" => "env_1",
-      +      "keys" => { "id" => "co_entitled" },
-      +      "metrics" => [{
-      +        "account_id" => "acc_1", "environment_id" => "env_1", "company_id" => "co_entitled",
-      +        "event_subtype" => "api-calls", "period" => "current_month",
-      +        "month_reset" => "billing_cycle", "value" => 40, "created_at" => "2023-01-01T00:00:00Z"
-      +      }],
-      +      "rules" => [{
-      +        "id" => "rule_override", "flag_id" => "flag1", "account_id" => "acc_1",
-      +        "environment_id" => "env_1", "name" => "Company Override",
-      +        "rule_type" => "company_override", "priority" => 0, "value" => true,
-      +        "condition_groups" => [],
-      +        "conditions" => [
-      +          {
-      +            "id" => "cond_company", "account_id" => "acc_1", "environment_id" => "env_1",
-      +            "condition_type" => "company", "operator" => "eq",
-      +            "resource_ids" => ["co_entitled"], "trait_value" => ""
-      +          },
-      +          {
-      +            "id" => "cond_metric", "account_id" => "acc_1", "environment_id" => "env_1",
-      +            "condition_type" => "metric", "operator" => "lt", "event_subtype" => "api-calls",
-      +            "metric_value" => 100, "metric_period" => "current_month",
-      +            "metric_period_month_reset" => "billing_cycle", "trait_value" => "100"
-      +          }
-      +        ]
-      +      }]
-      +    }
-      +  end
-      +
-      +  def test_billing_metric_override_evaluates_without_trapping
-      +    result = @engine.check_flag(flag, entitled_company)
-      +
-      +    assert result[:value], "company override should grant the flag, not fall back to default false"
-      +    assert_match(/override/i, result[:reason].to_s)
-      +  end
-      +
-      +  def test_billing_metric_override_populates_reset_at
-      +    result = @engine.check_flag(flag, entitled_company)
-      +
-      +    refute_nil result[:feature_usage_reset_at],
-      +               "reset-at should be computed from the injected host time"
-      +  end
-      +end
-    theirs_snapshot:
-      test/rules_engine_clock_test.rb: |
-        # frozen_string_literal: true
-
-        require_relative "test_helper"
-        require "minitest/autorun"
-
-        # Regression for SCHY-471.
-        #
-        # A company-override entitlement rule whose metric condition uses a
-        # calendar/billing metric period drives the engine into the metric-period-reset
-        # code path, which needs a wall clock. On the raw wasm32-unknown-unknown build
-        # that path used to trap (+wasm unreachable+); the flag then wrongly fell back to
-        # its default value for a company that is legitimately entitled. The host now
-        # injects the current time via +setCurrentTimeMillis+ so this evaluates cleanly.
-        class RulesEngineClockTest < Minitest::Test
-          def setup
-            @engine = Schematic::RulesEngine.new
-            @engine.initialize!
-            # The wasm binary is fetched via scripts/download-wasm.sh and may be absent
-            # (or the wasmtime gem missing) in some environments — skip rather than fail.
-            skip "WASM rules engine unavailable (wasm binary or wasmtime gem missing)" unless @engine.initialized?
-          end
-
-          def flag
-            {
-              "id" => "flag1", "key" => "mcp-access", "account_id" => "acc_1",
-              "environment_id" => "env_1", "default_value" => false, "rules" => []
-            }
-          end
-
-          # Usage 40 < allocation 100, so the override grants the feature.
-          def entitled_company
-            {
-              "id" => "co_entitled", "account_id" => "acc_1", "environment_id" => "env_1",
-              "keys" => { "id" => "co_entitled" },
-              "metrics" => [{
-                "account_id" => "acc_1", "environment_id" => "env_1", "company_id" => "co_entitled",
-                "event_subtype" => "api-calls", "period" => "current_month",
-                "month_reset" => "billing_cycle", "value" => 40, "created_at" => "2023-01-01T00:00:00Z"
-              }],
-              "rules" => [{
-                "id" => "rule_override", "flag_id" => "flag1", "account_id" => "acc_1",
-                "environment_id" => "env_1", "name" => "Company Override",
-                "rule_type" => "company_override", "priority" => 0, "value" => true,
-                "condition_groups" => [],
-                "conditions" => [
-                  {
-                    "id" => "cond_company", "account_id" => "acc_1", "environment_id" => "env_1",
-                    "condition_type" => "company", "operator" => "eq",
-                    "resource_ids" => ["co_entitled"], "trait_value" => ""
-                  },
-                  {
-                    "id" => "cond_metric", "account_id" => "acc_1", "environment_id" => "env_1",
-                    "condition_type" => "metric", "operator" => "lt", "event_subtype" => "api-calls",
-                    "metric_value" => 100, "metric_period" => "current_month",
-                    "metric_period_month_reset" => "billing_cycle", "trait_value" => "100"
-                  }
-                ]
-              }]
-            }
-          end
-
-          def test_billing_metric_override_evaluates_without_trapping
-            result = @engine.check_flag(flag, entitled_company)
-
-            assert result[:value], "company override should grant the flag, not fall back to default false"
-            assert_match(/override/i, result[:reason].to_s)
-          end
-
-          def test_billing_metric_override_populates_reset_at
-            result = @engine.check_flag(flag, entitled_company)
-
-            refute_nil result[:feature_usage_reset_at],
-                       "reset-at should be computed from the injected host time"
-          end
-        end
-    user_owned: true
-  - id: patch-ee61788c
-    content_hash: sha256:e652287219a0a709e16112ced444e6472c6fa8bdfe888edf868caaf9769a9472
-    original_commit: ee61788c5a83fce5dd5768b2536391459550d176
-    original_message: fix rubocop offenses in clock regression test (SCHY-471)
-    original_author: Christopher Brady <chris@schematichq.com>
-    base_generation: ec0eabecc3325dfe0a69590f9a2f4e52c3c18ade
-    files:
-      - test/rules_engine_clock_test.rb
-    patch_content: |
-      diff --git a/test/rules_engine_clock_test.rb b/test/rules_engine_clock_test.rb
-      new file mode 100644
-      index 0000000..8711b5e
-      --- /dev/null
-      +++ b/test/rules_engine_clock_test.rb
-      @@ -0,0 +1,75 @@
-      +# frozen_string_literal: true
-      +
-      +require_relative "test_helper"
-      +require "minitest/autorun"
-      +
-      +# Regression for SCHY-471.
-      +#
-      +# A company-override entitlement rule whose metric condition uses a
-      +# calendar/billing metric period drives the engine into the metric-period-reset
-      +# code path, which needs a wall clock. On the raw wasm32-unknown-unknown build
-      +# that path used to trap (+wasm unreachable+); the flag then wrongly fell back to
-      +# its default value for a company that is legitimately entitled. The host now
-      +# injects the current time via +setCurrentTimeMillis+ so this evaluates cleanly.
-      +class RulesEngineClockTest < Minitest::Test
-      +  def setup
-      +    @engine = Schematic::RulesEngine.new
-      +    @engine.initialize!
-      +    # The wasm binary is fetched via scripts/download-wasm.sh and may be absent
-      +    # (or the wasmtime gem missing) in some environments — skip rather than fail.
-      +    skip "WASM rules engine unavailable (wasm binary or wasmtime gem missing)" unless @engine.initialized?
-      +  end
-      +
-      +  def flag
-      +    {
-      +      "id" => "flag1", "key" => "mcp-access", "account_id" => "acc_1",
-      +      "environment_id" => "env_1", "default_value" => false, "rules" => []
-      +    }
-      +  end
-      +
-      +  # Usage 40 < allocation 100, so the override grants the feature.
-      +  def entitled_company
-      +    {
-      +      "id" => "co_entitled", "account_id" => "acc_1", "environment_id" => "env_1",
-      +      "keys" => { "id" => "co_entitled" },
-      +      "metrics" => [{
-      +        "account_id" => "acc_1", "environment_id" => "env_1", "company_id" => "co_entitled",
-      +        "event_subtype" => "api-calls", "period" => "current_month",
-      +        "month_reset" => "billing_cycle", "value" => 40, "created_at" => "2023-01-01T00:00:00Z"
-      +      }],
-      +      "rules" => [{
-      +        "id" => "rule_override", "flag_id" => "flag1", "account_id" => "acc_1",
-      +        "environment_id" => "env_1", "name" => "Company Override",
-      +        "rule_type" => "company_override", "priority" => 0, "value" => true,
-      +        "condition_groups" => [],
-      +        "conditions" => [
-      +          {
-      +            "id" => "cond_company", "account_id" => "acc_1", "environment_id" => "env_1",
-      +            "condition_type" => "company", "operator" => "eq",
-      +            "resource_ids" => ["co_entitled"], "trait_value" => ""
-      +          },
-      +          {
-      +            "id" => "cond_metric", "account_id" => "acc_1", "environment_id" => "env_1",
-      +            "condition_type" => "metric", "operator" => "lt", "event_subtype" => "api-calls",
-      +            "metric_value" => 100, "metric_period" => "current_month",
-      +            "metric_period_month_reset" => "billing_cycle", "trait_value" => "100"
-      +          }
-      +        ]
-      +      }]
-      +    }
-      +  end
-      +
-      +  def test_billing_metric_override_evaluates_without_trapping
-      +    result = @engine.check_flag(flag, entitled_company)
-      +
-      +    assert result[:value], "company override should grant the flag, not fall back to default false"
-      +    assert_match(/override/i, result[:reason].to_s)
-      +  end
-      +
-      +  def test_billing_metric_override_populates_reset_at
-      +    result = @engine.check_flag(flag, entitled_company)
-      +
-      +    refute_nil result[:feature_usage_reset_at],
-      +               "reset-at should be computed from the injected host time"
-      +  end
-      +end
-    theirs_snapshot:
-      test/rules_engine_clock_test.rb: |
-        # frozen_string_literal: true
-
-        require_relative "test_helper"
-        require "minitest/autorun"
-
-        # Regression for SCHY-471.
-        #
-        # A company-override entitlement rule whose metric condition uses a
-        # calendar/billing metric period drives the engine into the metric-period-reset
-        # code path, which needs a wall clock. On the raw wasm32-unknown-unknown build
-        # that path used to trap (+wasm unreachable+); the flag then wrongly fell back to
-        # its default value for a company that is legitimately entitled. The host now
-        # injects the current time via +setCurrentTimeMillis+ so this evaluates cleanly.
-        class RulesEngineClockTest < Minitest::Test
-          def setup
-            @engine = Schematic::RulesEngine.new
-            @engine.initialize!
-            # The wasm binary is fetched via scripts/download-wasm.sh and may be absent
-            # (or the wasmtime gem missing) in some environments — skip rather than fail.
-            skip "WASM rules engine unavailable (wasm binary or wasmtime gem missing)" unless @engine.initialized?
-          end
-
-          def flag
-            {
-              "id" => "flag1", "key" => "mcp-access", "account_id" => "acc_1",
-              "environment_id" => "env_1", "default_value" => false, "rules" => []
-            }
-          end
-
-          # Usage 40 < allocation 100, so the override grants the feature.
-          def entitled_company
-            {
-              "id" => "co_entitled", "account_id" => "acc_1", "environment_id" => "env_1",
-              "keys" => { "id" => "co_entitled" },
-              "metrics" => [{
-                "account_id" => "acc_1", "environment_id" => "env_1", "company_id" => "co_entitled",
-                "event_subtype" => "api-calls", "period" => "current_month",
-                "month_reset" => "billing_cycle", "value" => 40, "created_at" => "2023-01-01T00:00:00Z"
-              }],
-              "rules" => [{
-                "id" => "rule_override", "flag_id" => "flag1", "account_id" => "acc_1",
-                "environment_id" => "env_1", "name" => "Company Override",
-                "rule_type" => "company_override", "priority" => 0, "value" => true,
-                "condition_groups" => [],
-                "conditions" => [
-                  {
-                    "id" => "cond_company", "account_id" => "acc_1", "environment_id" => "env_1",
-                    "condition_type" => "company", "operator" => "eq",
-                    "resource_ids" => ["co_entitled"], "trait_value" => ""
-                  },
-                  {
-                    "id" => "cond_metric", "account_id" => "acc_1", "environment_id" => "env_1",
-                    "condition_type" => "metric", "operator" => "lt", "event_subtype" => "api-calls",
-                    "metric_value" => 100, "metric_period" => "current_month",
-                    "metric_period_month_reset" => "billing_cycle", "trait_value" => "100"
-                  }
-                ]
-              }]
-            }
-          end
-
-          def test_billing_metric_override_evaluates_without_trapping
-            result = @engine.check_flag(flag, entitled_company)
-
-            assert result[:value], "company override should grant the flag, not fall back to default false"
-            assert_match(/override/i, result[:reason].to_s)
-          end
-
-          def test_billing_metric_override_populates_reset_at
-            result = @engine.check_flag(flag, entitled_company)
-
-            refute_nil result[:feature_usage_reset_at],
-                       "reset-at should be computed from the injected host time"
-          end
-        end
-    user_owned: true
+  - commit_sha: eae816455d05776057b4d684b5cd4effe47ef299
+    tree_hash: 3af6229006f1467db74835ba62abc1dcff846262
+    timestamp: 2026-10-05T10:05:38.729Z
+    cli_version: unknown
+    generator_versions:
+      fernapi/fern-ruby-sdk: 1.25.0
+current_generation: eae816455d05776057b4d684b5cd4effe47ef299
+patches: []

data/.fernignore

@@ -6,8 +6,10 @@ CONTRIBUTING.md
 LICENSE
 README.md
 WASM_VERSION
+conformance/
 custom.gemspec.rb
 lib/schematic/cache.rb
+lib/schematic/credits/leases/
 lib/schematic/datastream/
 lib/schematic/event_buffer.rb
 lib/schematic/logger.rb
@@ -18,7 +20,11 @@ lib/schematic/wasm/
 lib/schematic/webhook_verification.rb
 lib/schematichq.rb
 scripts/
+test/conformance_test.rb
+test/credits_test.rb
 test/custom.test.rb
+test/lease_support.rb
+test/rules_engine_clock_test.rb
 testapp/
 .fern/replay.lock
 .fern/replay.yml

data/README.md

@@ -363,6 +363,147 @@ end
 client.close
 ```
 
+### Credit Leases and Reservations
+
+For features metered by credit burndown (e.g. inference tokens), `check` reserves credits for the work about to run and `track_with_reservation` settles the reservation with actual usage. The SDK gates in one of two modes:
+
+- **Client mode** acquires a **lease**, a tranche of credits held against the company's balance, and carves a per-request **reservation** out of it locally, so a check needs no API call. It requires [DataStream](#datastream) (or [Replicator Mode](#replicator-mode)) and, across multiple processes, a shared Redis so every instance gates against the same lease.
+- **Server mode** makes one `check-and-reserve` API call per check. No lease, no Redis, no local state.
+
+`credit_leases[:mode]` defaults to `:auto`: client when DataStream is enabled, server otherwise. Client mode suits high-throughput gating; server mode suits low-volume checks and operations that run for seconds.
+
+Durations are in milliseconds, as in the other Schematic SDKs.
+
+#### Setup
+
+The `redis` gem is not a dependency; pass a client you already have.
+
+```ruby
+require "redis"
+require "schematichq"
+
+redis_client = Redis.new(url: "redis://localhost:6379")
+
+client = Schematic::SchematicClient.new(
+  api_key: ENV["SCHEMATIC_API_KEY"],
+  use_data_stream: true,
+  datastream_options: {
+    redis_client: redis_client # also backs lease and reservation state
+  },
+  credit_leases: {
+    default_lease_size: 10_000,           # credits requested per lease
+    default_lease_duration: 5 * 60 * 1000, # lease lifetime (ms)
+    default_reservation_ttl: 60 * 1000     # how long a reservation is held if no track settles it (ms)
+  }
+)
+```
+
+Set `credit_leases[:redis_client]` to keep lease state in a different Redis than the DataStream cache.
+
+Server mode needs only a TTL:
+
+```ruby
+client = Schematic::SchematicClient.new(
+  api_key: ENV["SCHEMATIC_API_KEY"],
+  credit_leases: {
+    default_reservation_ttl: 60 * 1000 # how long the server holds the credits if no track settles them (ms, max 1 hour)
+  }
+)
+```
+
+Only `mode` and `default_reservation_ttl` apply in server mode; the SDK warns at startup if a client-only option is set.
+
+#### Checking and tracking
+
+```ruby
+# Reserve up to max_tokens for this operation.
+result = client.check(
+  "inference",
+  company: { "id" => "your-company-id" },
+  usage: max_tokens,                  # upper bound for this operation
+  event_subtype: "inference_tokens"   # the metered event
+)
+raise "credit balance exceeded" unless result.allowed?
+
+inference = run_inference(...)
+
+# Report actual usage; the unused slice of the reservation is refunded.
+if result.reservation
+  client.track_with_reservation(result.reservation, inference.tokens_used)
+else
+  client.track({
+    event: "inference_tokens",
+    company: { "id" => "your-company-id" },
+    quantity: inference.tokens_used
+  })
+end
+```
+
+A check can allow without reserving credits (the feature is not credit-metered, `usage` is 0, or the check failed open), and that usage still has to be tracked.
+
+Without `credit_leases` configured, or without a `usage`, `check` falls through to a plain flag check with no reservation. `usage` is still sent as a preflight, locally or to the API, so the verdict accounts for what the call is about to spend. Preflighted verdicts are not cached.
+
+`usage` may be fractional. A client-mode reservation is sized in whole event units, `ceil(usage) x consumption_rate`, and a settle debits the lease by `ceil(actual) x consumption_rate`, so the local ledger moves by exactly what the track event bills. The reservation still records the fractional quantity the caller declared. Everything on the wire rounds up with the debit: the track event's quantity, a server-mode reservation, and the preflight quantity, whether it goes to the API or the local engine.
+
+`result.entitlement` is a symbol-keyed hash with the field names of `Schematic::Types::FeatureEntitlement`, the same in both modes.
+
+An unsettled reservation expires after `default_reservation_ttl` and its credits return to the lease. A late settle still bills the usage (the track event carries a deterministic idempotency key, so it never double-bills) but does not re-debit the local lease, so set `default_reservation_ttl` above the longest expected gap between `check` and `track_with_reservation`.
+
+#### Pre-warming
+
+Pre-warm leases when the user is identified, so a session's first check does not wait on a lease acquire:
+
+```ruby
+client.identify(
+  {
+    keys: { "user_id" => "your-user-id" },
+    company: { keys: { "id" => "your-company-id" } }
+  },
+  prewarm: ["credit-type-id"] # credit type IDs to acquire leases for
+)
+```
+
+Or call `client.prewarm(credit_type_ids, company:)` directly. Both are no-ops in server mode.
+
+Pre-warming resolves the company the way the server does: it looks the keys up first, whatever they are named, and only when nothing matches does it read a value carrying Schematic's `comp_` prefix as the company id.
+
+#### Failure behavior
+
+A check that cannot be gated (API unreachable, Redis down, lease exhausted) fails closed by default. Override per check:
+
+```ruby
+result = client.check(
+  "inference",
+  company: { "id" => "your-company-id" },
+  usage: max_tokens,
+  event_subtype: "inference_tokens",
+  on_acquire_failure: :fail_open
+)
+```
+
+In server mode, a check that times out after the server has already reserved leaves those credits reserved until the TTL expires, so keep `default_reservation_ttl` short there.
+
+In client mode, `:fail_open` still evaluates the flag's rules with the credit balance assumed sufficient, so plan targeting and all non-credit conditions apply and only the credit gate is bypassed. In server mode it returns the flag's default value, which is `false` unless you pass `default_value` or configure a `flag_defaults` entry.
+
+`default_value` also applies when a check falls back to a plain flag check and that check fails. Pass a boolean or a callable.
+
+`check` accepts `timeout_ms`, but no timeout is configurable yet: the generated HTTP transport ignores per-request timeouts and the client exposes no setting. The option is carried on the request so it takes effect once the transport reads it.
+
+#### Configuration options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `mode` | `:client`, `:server`, `:auto` | `:auto` | Where credits are reserved; `:auto` picks client when DataStream is enabled, server otherwise |
+| `default_reservation_ttl` | `Integer` | 60000 (60 seconds) | How long an unsettled reservation is held (ms) |
+| `default_lease_duration` | `Integer` | 300000 (5 minutes) | (client mode) Lease lifetime (ms) |
+| `default_lease_size` | `Numeric` | 10000 | (client mode) Credits requested per lease acquire or extend |
+| `low_water_mark` | `Float` | 0.25 | (client mode) Extend in the background when the lease balance dips below this fraction |
+| `sweep_interval_ms` | `Integer` | 1000 | (client mode) Sweep interval for expired reservations (ms) |
+| `prewarm_resolve_timeout_ms` | `Integer` | 5000 | (client mode) How long `prewarm` waits for a freshly identified company to surface (ms); 0 resolves from the DataStream cache only |
+| `redis_client` | Redis client | `datastream_options[:redis_client]` | (client mode) Redis client for lease and reservation state |
+| `redis_key_prefix` | `String` | `datastream_options[:redis_key_prefix]` | (client mode) Key prefix for lease and reservation keys |
+| `overrides` | `Hash` | none | (client mode) Per-credit-type overrides of the above, keyed by credit type ID |
+
 ### Other API operations
 
 The Schematic API supports many operations beyond these, accessible via the API modules on the client: `accounts`, `billing`, `companies`, `credits`, `entitlements`, `events`, `features`, and `plans`.

data/custom.gemspec.rb

@@ -3,6 +3,12 @@
 def add_custom_gemspec_data(spec)
   spec.homepage = "https://github.com/SchematicHQ/schematic-ruby"
 
+  # Cross-SDK test fixtures, read only by test/conformance_test.rb, which the
+  # generated gemspec already drops with the rest of test/. Rejected here rather
+  # than there because that file is generated; npm's allowlist keeps them out of
+  # schematic-node the same way.
+  spec.files.reject! { |f| f.start_with?("conformance/") }
+
   # The WASM binary is gitignored (downloaded at build time via scripts/download-wasm.sh)
   # but must be included in the published gem. Append it to the file list.
   wasm_file = "lib/schematic/wasm/rulesengine.wasm"

data/lib/schematic/accounts/types/update_environment_request_body.rb

@@ -9,6 +9,8 @@ module Schematic
         field :environment_type, -> { Schematic::Types::EnvironmentType }, optional: true, nullable: false
 
         field :name, -> { String }, optional: true, nullable: false
+
+        field :require_context_signature, -> { Internal::Types::Boolean }, optional: true, nullable: false
       end
     end
   end

data/lib/schematic/client.rb

@@ -42,7 +42,7 @@ module Schematic
       @raw_client = Schematic::Internal::Http::RawClient.new(
         base_url: base_url || Schematic::Environment::DEFAULT,
         headers: {
-          "User-Agent" => "schematichq/1.5.2",
+          "User-Agent" => "schematichq/1.5.3",
           "X-Fern-Language" => "Ruby",
           "X-Schematic-Api-Key" => api_key.to_s
         },

data/lib/schematic/credits/client.rb

@@ -1399,10 +1399,7 @@ module Schematic
       # @option request_options [Integer] :timeout_in_seconds
       #
       # @example
-      #   client.credits.create_credit_spend_policy(
-      #     billing_credit_id: "billing_credit_id",
-      #     max_per_draw: 1.1
-      #   )
+      #   client.credits.create_credit_spend_policy(billing_credit_id: "billing_credit_id")
       #
       # @return [Schematic::Credits::Types::CreateCreditSpendPolicyResponse]
       def create_credit_spend_policy(request_options: {}, **params)
@@ -1597,6 +1594,53 @@ module Schematic
         end
       end
 
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String, nil] :billing_credit_id
+      # @option params [String] :company_id
+      # @option params [String, nil] :user_ids
+      #
+      # @example
+      #   client.credits.get_credit_spend_policy_usage(
+      #     billing_credit_id: "billing_credit_id",
+      #     company_id: "company_id",
+      #     user_ids: ["user_ids"]
+      #   )
+      #
+      # @return [Schematic::Credits::Types::GetCreditSpendPolicyUsageResponse]
+      def get_credit_spend_policy_usage(request_options: {}, **params)
+        params = Schematic::Internal::Types::Utils.normalize_keys(params)
+        query_params = {}
+        query_params["billing_credit_id"] = params[:billing_credit_id] if params.key?(:billing_credit_id)
+        query_params["company_id"] = params[:company_id] if params.key?(:company_id)
+        query_params["user_ids"] = params[:user_ids] if params.key?(:user_ids)
+
+        request = Schematic::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "billing/credits/spend-policies/usage",
+          query: query_params,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Schematic::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          (response.body.to_s.empty? ? nil : Schematic::Credits::Types::GetCreditSpendPolicyUsageResponse.load(response.body))
+        else
+          error_class = Schematic::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
       # @param request_options [Hash]
       # @param params [Hash]
       # @option request_options [String] :base_url
@@ -1618,7 +1662,7 @@ module Schematic
       #     billing_credit_id: "billing_credit_id",
       #     company_id: "company_id",
       #     end_time: "end_time",
-      #     event_type: "grant",
+      #     event_type: "adjustment",
       #     feature_id: "feature_id",
       #     start_time: "start_time",
       #     limit: 1000000,
@@ -1680,7 +1724,7 @@ module Schematic
       #     billing_credit_id: "billing_credit_id",
       #     company_id: "company_id",
       #     end_time: "end_time",
-      #     event_type: "grant",
+      #     event_type: "adjustment",
       #     feature_id: "feature_id",
       #     start_time: "start_time",
       #     limit: 1000000,