@schematichq/schematic-angular 1.4.0 → 1.6.0

package/README.md

@@ -202,6 +202,86 @@ export class EntitlementComponent {
 
 *Note: `isPending$` checks if entitlement data has been loaded, typically via `identify`. It should be used to wrap flag and entitlement checks, but never the initial call to `identify`.*
 
+For features metered by credit burndown, the emitted entitlement also carries the company's credit position:
+
+| Property | Type | Description |
+| --- | --- | --- |
+| `creditId` | `string \| undefined` | The ID of the credit funding this feature |
+| `creditSettled` | `number \| undefined` | The spendable balance, including any amount held by an open lease. This is the number to show end users |
+| `creditRemaining` | `number \| undefined` | The balance available to fund new consumption, excluding any open lease hold |
+| `creditReserved` | `number \| undefined` | The unspent amount held by an open credit lease, `0` when none is open |
+
+All four are `undefined` when the feature is not credit-based.
+
+```typescript
+@Component({
+  selector: "app-credit-feature",
+  standalone: true,
+  imports: [AsyncPipe],
+  template: `
+    @if (entitlement$ | async; as entitlement) {
+      @if (entitlement.value) {
+        <app-feature [creditsRemaining]="entitlement.creditSettled" />
+      } @else {
+        <app-out-of-credits />
+      }
+    }
+  `,
+})
+export class CreditFeatureComponent {
+  private schematic = inject(SchematicService);
+  entitlement$ = this.schematic.entitlement$("my-flag-key");
+}
+```
+
+These values refresh with each flag check. For a balance that also updates on the credit partials arriving between checks, pipe `creditId` into [`creditBalance$`](#credit-balances) instead.
+
+### Usage warnings
+
+If a usage warning is configured on the entitlement, the emitted entitlement carries it as `warningTiers`, so you can warn a customer before they hit the limit rather than after:
+
+| Property | Type | Description |
+| --- | --- | --- |
+| `warningTiers` | `WarningTier[] \| undefined` | The usage warning thresholds configured on the entitlement, each a `{ key, value }` pair in the entitlement's usage units. `undefined` when none are configured |
+| `softLimit` | `number \| undefined` | For usage-based pricing, the soft limit for overage charges or the next tier boundary |
+
+The dashboard writes a single tier under the key `default`.
+
+```typescript
+import { Component, inject } from "@angular/core";
+import { AsyncPipe } from "@angular/common";
+import { map } from "rxjs";
+import { SchematicService } from "@schematichq/schematic-angular";
+
+@Component({
+  selector: "app-usage-warning",
+  standalone: true,
+  imports: [AsyncPipe],
+  template: `
+    @if (approachingLimit$ | async) {
+      <app-approaching-limit />
+    }
+    <app-feature />
+  `,
+})
+export class UsageWarningComponent {
+  private schematic = inject(SchematicService);
+  entitlement$ = this.schematic.entitlement$("my-flag-key");
+  approachingLimit$ = this.entitlement$.pipe(
+    map((entitlement) => {
+      const warning = entitlement.warningTiers?.find(
+        (tier) => tier.key === "default",
+      );
+      return (
+        typeof entitlement.featureUsage === "number" &&
+        typeof warning?.value === "number" &&
+        entitlement.featureUsage >= warning.value
+      );
+    }),
+  );
+}
+```
+
 ### Checking plans
 
 Use `plan$` to get an Observable of the current plan information:
@@ -229,6 +309,73 @@ export class PlanComponent {
 }
 ```
 
+### Credit balances
+
+Use `creditBalance$` to observe a company's credit balance. It is keyed by credit ID and emits as the balance changes over the DataStream:
+
+```typescript
+import { Component, inject } from "@angular/core";
+import { AsyncPipe } from "@angular/common";
+import { SchematicService } from "@schematichq/schematic-angular";
+
+@Component({
+  selector: "app-credit-meter",
+  standalone: true,
+  imports: [AsyncPipe],
+  template: `
+    @if (creditBalance$ | async; as credit) {
+      @if (credit.isLoading) {
+        <div>Loading…</div>
+      } @else {
+        <div>{{ credit.balance }} credits remaining</div>
+      }
+    }
+  `,
+})
+export class CreditMeterComponent {
+  private schematic = inject(SchematicService);
+  creditBalance$ = this.schematic.creditBalance$("credit-id");
+}
+```
+
+`creditBalance$` emits an object with the following properties:
+
+| Property | Type | Description |
+| --- | --- | --- |
+| `balance` | `number` | The spendable balance, or `0` while loading or when the company holds no balance in this credit |
+| `isLoading` | `boolean` | `true` while the balance is still loading and no value has arrived yet |
+
+It surfaces the `settled` (spendable) balance. The credit ID is available on a feature's entitlement, and `creditBalance$` accepts an Observable of credit IDs as well as a plain one, so you can pipe the entitlement straight in:
+
+```typescript
+import { map } from "rxjs";
+
+@Component({
+  selector: "app-credit-meter",
+  standalone: true,
+  imports: [AsyncPipe],
+  template: `
+    @if (creditBalance$ | async; as credit) {
+      @if (credit.isLoading) {
+        <div>Loading…</div>
+      } @else {
+        <div>{{ credit.balance }} credits remaining</div>
+      }
+    }
+  `,
+})
+export class CreditMeterComponent {
+  private schematic = inject(SchematicService);
+  creditBalance$ = this.schematic.creditBalance$(
+    this.schematic
+      .entitlement$("my-flag-key")
+      .pipe(map((entitlement) => entitlement.creditId)),
+  );
+}
+```
+
+It switches to the new credit as the source emits. While the ID is `undefined`, it emits the client's loading state and a balance of `0`.
+
 ## API Reference
 
 ### `provideSchematic(config)`
@@ -248,6 +395,7 @@ Injectable service providing all Schematic functionality:
 | `flagValue$(key, fallback?)` | `Observable<boolean>` | Observe a feature flag's boolean value |
 | `entitlement$(key, fallback?)` | `Observable<CheckFlagReturn>` | Observe detailed entitlement data |
 | `plan$()` | `Observable<CheckPlanReturn \| undefined>` | Observe plan information |
+| `creditBalance$(creditId)` | `Observable<SchematicCreditBalance>` | Observe a company's lease-aware credit balance. Takes a credit ID or an Observable of credit IDs |
 | `isPending$()` | `Observable<boolean>` | Observe loading state |
 
 ### `SCHEMATIC_CLIENT`

package/fesm2022/schematichq-schematic-angular.mjs

@@ -2,7 +2,7 @@ import * as i0 from '@angular/core';
 import { InjectionToken, inject, Injectable, makeEnvironmentProviders, DestroyRef } from '@angular/core';
 import * as SchematicJS from '@schematichq/schematic-js';
 export { RuleType, Schematic, TrialStatus, UsagePeriod } from '@schematichq/schematic-js';
-import { Observable, distinctUntilChanged, shareReplay, finalize } from 'rxjs';
+import { Observable, distinctUntilChanged, shareReplay, finalize, isObservable, switchMap, map } from 'rxjs';
 
 const SCHEMATIC_CLIENT = new InjectionToken("SchematicClient");
 
@@ -28,6 +28,7 @@ class SchematicService {
     client = inject(SCHEMATIC_CLIENT);
     flagValueCache = new Map();
     entitlementCache = new Map();
+    creditBalanceCache = new Map();
     planCache;
     isPendingCache;
     getClient() {
@@ -95,6 +96,59 @@ class SchematicService {
         }));
         return this.planCache;
     }
+    /**
+     * Observe a company's live, lease-aware credit balance for a single credit type.
+     *
+     * Surfaces the spendable `settled` balance, sourced from the streamed credit
+     * balances map (keyed by credit ID). It emits as partials arrive over the
+     * DataStream, so it stays accurate during an open lease — when the raw
+     * `remaining` would otherwise read stale / falsely "exhausted".
+     *
+     * The credit ID is available on a feature's entitlement: `entitlement$(key)`
+     * emits `creditId` for credit-based features. Pass that stream straight in:
+     * this accepts an Observable of credit IDs as well as a plain one, switching
+     * to the new credit as the source emits. While the ID is undefined it emits
+     * the client's loading state and a balance of 0.
+     */
+    creditBalance$(creditId) {
+        if (isObservable(creditId)) {
+            return creditId.pipe(distinctUntilChanged(), switchMap((id) => this.creditBalanceFor(id)), distinctUntilChanged(shallowEqual), shareReplay({ bufferSize: 1, refCount: true }));
+        }
+        return this.creditBalanceFor(creditId);
+    }
+    /**
+     * Emits a zeroed balance that still tracks the client's loading state, for
+     * when there is no credit ID to read (a check that has not arrived yet, or a
+     * feature that is not credit-based).
+     */
+    noCreditBalance$() {
+        return this.isPending$().pipe(map((isLoading) => ({ balance: 0, isLoading })));
+    }
+    creditBalanceFor(creditId) {
+        if (creditId === undefined)
+            return this.noCreditBalance$();
+        let cached = this.creditBalanceCache.get(creditId);
+        if (cached)
+            return cached;
+        cached = new Observable((subscriber) => {
+            const emit = () => {
+                const balance = this.client.getCreditBalance(creditId);
+                subscriber.next({
+                    balance: balance?.settled ?? 0,
+                    isLoading: balance === undefined && this.client.getIsPending(),
+                });
+            };
+            emit();
+            const unsubscribeBalance = this.client.addCreditBalanceListener(() => emit());
+            const unsubscribePending = this.client.addIsPendingListener(() => emit());
+            return () => {
+                unsubscribeBalance();
+                unsubscribePending();
+            };
+        }).pipe(distinctUntilChanged(shallowEqual), shareReplay({ bufferSize: 1, refCount: true }), finalize(() => this.creditBalanceCache.delete(creditId)));
+        this.creditBalanceCache.set(creditId, cached);
+        return cached;
+    }
     isPending$() {
         if (this.isPendingCache)
             return this.isPendingCache;
@@ -109,14 +163,14 @@ class SchematicService {
         }));
         return this.isPendingCache;
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: SchematicService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: SchematicService });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.7", ngImport: i0, type: SchematicService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.1.7", ngImport: i0, type: SchematicService });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: SchematicService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.7", ngImport: i0, type: SchematicService, decorators: [{
             type: Injectable
         }] });
 
-const version = "1.4.0";
+const version = "1.6.0";
 
 function provideSchematic(config) {
     const { client: providedClient, publishableKey, additionalHeaders, ...restOpts } = config;

package/fesm2022/schematichq-schematic-angular.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"schematichq-schematic-angular.mjs","sources":["../../src/token.ts","../../src/schematic.service.ts","../../src/version.ts","../../src/provide.ts","../../src/schematichq-schematic-angular.ts"],"sourcesContent":["import { InjectionToken } from \"@angular/core\";\nimport * as SchematicJS from \"@schematichq/schematic-js\";\n\nexport const SCHEMATIC_CLIENT = new InjectionToken<SchematicJS.Schematic>(\n  \"SchematicClient\",\n);\n","import { Injectable, inject } from \"@angular/core\";\nimport * as SchematicJS from \"@schematichq/schematic-js\";\nimport { Observable, distinctUntilChanged, finalize, shareReplay } from \"rxjs\";\nimport { SCHEMATIC_CLIENT } from \"./token\";\n\nfunction shallowEqual<T extends Record<string, unknown>>(\n  a: T | undefined,\n  b: T | undefined,\n): boolean {\n  if (a === b) return true;\n  if (!a || !b) return false;\n  const keysA = Object.keys(a);\n  const keysB = Object.keys(b);\n  if (keysA.length !== keysB.length) return false;\n  return keysA.every((key) => {\n    const valA = a[key];\n    const valB = b[key];\n    if (valA instanceof Date && valB instanceof Date) {\n      return valA.getTime() === valB.getTime();\n    }\n    return valA === valB;\n  });\n}\n\n@Injectable()\nexport class SchematicService {\n  private client = inject(SCHEMATIC_CLIENT);\n\n  private flagValueCache = new Map<string, Observable<boolean>>();\n  private entitlementCache = new Map<\n    string,\n    Observable<SchematicJS.CheckFlagReturn>\n  >();\n  private planCache?: Observable<SchematicJS.CheckPlanReturn | undefined>;\n  private isPendingCache?: Observable<boolean>;\n\n  getClient(): SchematicJS.Schematic {\n    return this.client;\n  }\n\n  setContext(context: SchematicJS.SchematicContext): void {\n    this.client.setContext(context);\n  }\n\n  identify(body: SchematicJS.EventBodyIdentify): void {\n    this.client.identify(body);\n  }\n\n  track(body: SchematicJS.EventBodyTrack): void {\n    this.client.track(body);\n  }\n\n  flagValue$(key: string, fallback: boolean = false): Observable<boolean> {\n    const cacheKey = `${key}:${fallback}`;\n    let cached = this.flagValueCache.get(cacheKey);\n    if (cached) return cached;\n\n    cached = new Observable<boolean>((subscriber) => {\n      const current = this.client.getFlagValue(key);\n      subscriber.next(current ?? fallback);\n\n      const unsubscribe = this.client.addFlagValueListener(key, () => {\n        const value = this.client.getFlagValue(key);\n        subscriber.next(value ?? fallback);\n      });\n\n      return () => unsubscribe();\n    }).pipe(\n      distinctUntilChanged(),\n      shareReplay({ bufferSize: 1, refCount: true }),\n      finalize(() => this.flagValueCache.delete(cacheKey)),\n    );\n\n    this.flagValueCache.set(cacheKey, cached);\n    return cached;\n  }\n\n  entitlement$(\n    key: string,\n    fallback: boolean = false,\n  ): Observable<SchematicJS.CheckFlagReturn> {\n    const cacheKey = `${key}:${fallback}`;\n    let cached = this.entitlementCache.get(cacheKey);\n    if (cached) return cached;\n\n    const fallbackCheck: SchematicJS.CheckFlagReturn = {\n      flag: key,\n      reason: \"Fallback\",\n      value: fallback,\n    };\n\n    cached = new Observable<SchematicJS.CheckFlagReturn>((subscriber) => {\n      const current = this.client.getFlagCheck(key);\n      subscriber.next(current ?? fallbackCheck);\n\n      const unsubscribe = this.client.addFlagCheckListener(key, () => {\n        const check = this.client.getFlagCheck(key);\n        subscriber.next(check ?? fallbackCheck);\n      });\n\n      return () => unsubscribe();\n    }).pipe(\n      distinctUntilChanged(shallowEqual),\n      shareReplay({ bufferSize: 1, refCount: true }),\n      finalize(() => this.entitlementCache.delete(cacheKey)),\n    );\n\n    this.entitlementCache.set(cacheKey, cached);\n    return cached;\n  }\n\n  plan$(): Observable<SchematicJS.CheckPlanReturn | undefined> {\n    if (this.planCache) return this.planCache;\n\n    this.planCache = new Observable<SchematicJS.CheckPlanReturn | undefined>(\n      (subscriber) => {\n        subscriber.next(this.client.getPlan());\n\n        const unsubscribe = this.client.addPlanListener(() => {\n          subscriber.next(this.client.getPlan());\n        });\n\n        return () => unsubscribe();\n      },\n    ).pipe(\n      distinctUntilChanged(shallowEqual),\n      shareReplay({ bufferSize: 1, refCount: true }),\n      finalize(() => {\n        this.planCache = undefined;\n      }),\n    );\n\n    return this.planCache;\n  }\n\n  isPending$(): Observable<boolean> {\n    if (this.isPendingCache) return this.isPendingCache;\n\n    this.isPendingCache = new Observable<boolean>((subscriber) => {\n      subscriber.next(this.client.getIsPending());\n\n      const unsubscribe = this.client.addIsPendingListener(() => {\n        subscriber.next(this.client.getIsPending());\n      });\n\n      return () => unsubscribe();\n    }).pipe(\n      distinctUntilChanged(),\n      shareReplay({ bufferSize: 1, refCount: true }),\n      finalize(() => {\n        this.isPendingCache = undefined;\n      }),\n    );\n\n    return this.isPendingCache;\n  }\n}\n","export const version = \"1.4.0\";\n","import { DestroyRef, inject, makeEnvironmentProviders } from \"@angular/core\";\nimport * as SchematicJS from \"@schematichq/schematic-js\";\n\nimport { SchematicService } from \"./schematic.service\";\nimport { SCHEMATIC_CLIENT } from \"./token\";\nimport { version } from \"./version\";\n\ntype BaseSchematicConfig = Omit<SchematicJS.SchematicOptions, \"useWebSocket\">;\n\ntype SchematicConfigWithClient = BaseSchematicConfig & {\n  client: SchematicJS.Schematic;\n  publishableKey?: never;\n};\n\ntype SchematicConfigWithKey = BaseSchematicConfig & {\n  client?: never;\n  publishableKey: string;\n};\n\nexport type SchematicConfig =\n  | SchematicConfigWithClient\n  | SchematicConfigWithKey;\n\nexport function provideSchematic(config: SchematicConfig) {\n  const {\n    client: providedClient,\n    publishableKey,\n    additionalHeaders,\n    ...restOpts\n  } = config;\n\n  return makeEnvironmentProviders([\n    {\n      provide: SCHEMATIC_CLIENT,\n      useFactory: () => {\n        const isProvidedClient = !!providedClient;\n\n        const client = isProvidedClient\n          ? providedClient\n          : new SchematicJS.Schematic(publishableKey!, {\n              ...restOpts,\n              useWebSocket: true,\n              additionalHeaders: {\n                \"X-Schematic-Client-Version\": `schematic-angular@${version}`,\n                ...additionalHeaders,\n              },\n            });\n\n        const destroyRef = inject(DestroyRef);\n        destroyRef.onDestroy(() => {\n          if (!isProvidedClient) {\n            client.cleanup().catch((error: unknown) => {\n              console.error(\"Error during Schematic cleanup:\", error);\n            });\n          }\n        });\n\n        return client;\n      },\n    },\n    SchematicService,\n  ]);\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;MAGa,gBAAgB,GAAG,IAAI,cAAc,CAChD,iBAAiB;;ACCnB,SAAS,YAAY,CACnB,CAAgB,EAChB,CAAgB,EAAA;IAEhB,IAAI,CAAC,KAAK,CAAC;AAAE,QAAA,OAAO,IAAI;AACxB,IAAA,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;AAAE,QAAA,OAAO,KAAK;IAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5B,IAAA,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;AAAE,QAAA,OAAO,KAAK;AAC/C,IAAA,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,KAAI;AACzB,QAAA,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC;AACnB,QAAA,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC;QACnB,IAAI,IAAI,YAAY,IAAI,IAAI,IAAI,YAAY,IAAI,EAAE;YAChD,OAAO,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,CAAC,OAAO,EAAE;QAC1C;QACA,OAAO,IAAI,KAAK,IAAI;AACtB,IAAA,CAAC,CAAC;AACJ;MAGa,gBAAgB,CAAA;AACnB,IAAA,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC;AAEjC,IAAA,cAAc,GAAG,IAAI,GAAG,EAA+B;AACvD,IAAA,gBAAgB,GAAG,IAAI,GAAG,EAG/B;AACK,IAAA,SAAS;AACT,IAAA,cAAc;IAEtB,SAAS,GAAA;QACP,OAAO,IAAI,CAAC,MAAM;IACpB;AAEA,IAAA,UAAU,CAAC,OAAqC,EAAA;AAC9C,QAAA,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;IACjC;AAEA,IAAA,QAAQ,CAAC,IAAmC,EAAA;AAC1C,QAAA,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B;AAEA,IAAA,KAAK,CAAC,IAAgC,EAAA;AACpC,QAAA,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB;AAEA,IAAA,UAAU,CAAC,GAAW,EAAE,QAAA,GAAoB,KAAK,EAAA;AAC/C,QAAA,MAAM,QAAQ,GAAG,CAAA,EAAG,GAAG,CAAA,CAAA,EAAI,QAAQ,EAAE;QACrC,IAAI,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC;AAC9C,QAAA,IAAI,MAAM;AAAE,YAAA,OAAO,MAAM;AAEzB,QAAA,MAAM,GAAG,IAAI,UAAU,CAAU,CAAC,UAAU,KAAI;YAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC;AAC7C,YAAA,UAAU,CAAC,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC;YAEpC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE,MAAK;gBAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC;AAC3C,gBAAA,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;AACpC,YAAA,CAAC,CAAC;AAEF,YAAA,OAAO,MAAM,WAAW,EAAE;AAC5B,QAAA,CAAC,CAAC,CAAC,IAAI,CACL,oBAAoB,EAAE,EACtB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAC9C,QAAQ,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CACrD;QAED,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC;AACzC,QAAA,OAAO,MAAM;IACf;AAEA,IAAA,YAAY,CACV,GAAW,EACX,QAAA,GAAoB,KAAK,EAAA;AAEzB,QAAA,MAAM,QAAQ,GAAG,CAAA,EAAG,GAAG,CAAA,CAAA,EAAI,QAAQ,EAAE;QACrC,IAAI,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC;AAChD,QAAA,IAAI,MAAM;AAAE,YAAA,OAAO,MAAM;AAEzB,QAAA,MAAM,aAAa,GAAgC;AACjD,YAAA,IAAI,EAAE,GAAG;AACT,YAAA,MAAM,EAAE,UAAU;AAClB,YAAA,KAAK,EAAE,QAAQ;SAChB;AAED,QAAA,MAAM,GAAG,IAAI,UAAU,CAA8B,CAAC,UAAU,KAAI;YAClE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC;AAC7C,YAAA,UAAU,CAAC,IAAI,CAAC,OAAO,IAAI,aAAa,CAAC;YAEzC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE,MAAK;gBAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC;AAC3C,gBAAA,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC;AACzC,YAAA,CAAC,CAAC;AAEF,YAAA,OAAO,MAAM,WAAW,EAAE;AAC5B,QAAA,CAAC,CAAC,CAAC,IAAI,CACL,oBAAoB,CAAC,YAAY,CAAC,EAClC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAC9C,QAAQ,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CACvD;QAED,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC;AAC3C,QAAA,OAAO,MAAM;IACf;IAEA,KAAK,GAAA;QACH,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS;QAEzC,IAAI,CAAC,SAAS,GAAG,IAAI,UAAU,CAC7B,CAAC,UAAU,KAAI;YACb,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAEtC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,MAAK;gBACnD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;AACxC,YAAA,CAAC,CAAC;AAEF,YAAA,OAAO,MAAM,WAAW,EAAE;QAC5B,CAAC,CACF,CAAC,IAAI,CACJ,oBAAoB,CAAC,YAAY,CAAC,EAClC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAC9C,QAAQ,CAAC,MAAK;AACZ,YAAA,IAAI,CAAC,SAAS,GAAG,SAAS;QAC5B,CAAC,CAAC,CACH;QAED,OAAO,IAAI,CAAC,SAAS;IACvB;IAEA,UAAU,GAAA;QACR,IAAI,IAAI,CAAC,cAAc;YAAE,OAAO,IAAI,CAAC,cAAc;QAEnD,IAAI,CAAC,cAAc,GAAG,IAAI,UAAU,CAAU,CAAC,UAAU,KAAI;YAC3D,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAE3C,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,MAAK;gBACxD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;AAC7C,YAAA,CAAC,CAAC;AAEF,YAAA,OAAO,MAAM,WAAW,EAAE;QAC5B,CAAC,CAAC,CAAC,IAAI,CACL,oBAAoB,EAAE,EACtB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAC9C,QAAQ,CAAC,MAAK;AACZ,YAAA,IAAI,CAAC,cAAc,GAAG,SAAS;QACjC,CAAC,CAAC,CACH;QAED,OAAO,IAAI,CAAC,cAAc;IAC5B;uGAlIW,gBAAgB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA;2GAAhB,gBAAgB,EAAA,CAAA;;2FAAhB,gBAAgB,EAAA,UAAA,EAAA,CAAA;kBAD5B;;;ACxBM,MAAM,OAAO,GAAG,OAAO;;ACuBxB,SAAU,gBAAgB,CAAC,MAAuB,EAAA;AACtD,IAAA,MAAM,EACJ,MAAM,EAAE,cAAc,EACtB,cAAc,EACd,iBAAiB,EACjB,GAAG,QAAQ,EACZ,GAAG,MAAM;AAEV,IAAA,OAAO,wBAAwB,CAAC;AAC9B,QAAA;AACE,YAAA,OAAO,EAAE,gBAAgB;YACzB,UAAU,EAAE,MAAK;AACf,gBAAA,MAAM,gBAAgB,GAAG,CAAC,CAAC,cAAc;gBAEzC,MAAM,MAAM,GAAG;AACb,sBAAE;AACF,sBAAE,IAAI,WAAW,CAAC,SAAS,CAAC,cAAe,EAAE;AACzC,wBAAA,GAAG,QAAQ;AACX,wBAAA,YAAY,EAAE,IAAI;AAClB,wBAAA,iBAAiB,EAAE;4BACjB,4BAA4B,EAAE,CAAA,kBAAA,EAAqB,OAAO,CAAA,CAAE;AAC5D,4BAAA,GAAG,iBAAiB;AACrB,yBAAA;AACF,qBAAA,CAAC;AAEN,gBAAA,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;AACrC,gBAAA,UAAU,CAAC,SAAS,CAAC,MAAK;oBACxB,IAAI,CAAC,gBAAgB,EAAE;wBACrB,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,KAAI;AACxC,4BAAA,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC;AACzD,wBAAA,CAAC,CAAC;oBACJ;AACF,gBAAA,CAAC,CAAC;AAEF,gBAAA,OAAO,MAAM;YACf,CAAC;AACF,SAAA;QACD,gBAAgB;AACjB,KAAA,CAAC;AACJ;;AC9DA;;AAEG;;;;"}
+{"version":3,"file":"schematichq-schematic-angular.mjs","sources":["../../src/token.ts","../../src/schematic.service.ts","../../src/version.ts","../../src/provide.ts","../../src/schematichq-schematic-angular.ts"],"sourcesContent":["import { InjectionToken } from \"@angular/core\";\nimport * as SchematicJS from \"@schematichq/schematic-js\";\n\nexport const SCHEMATIC_CLIENT = new InjectionToken<SchematicJS.Schematic>(\n  \"SchematicClient\",\n);\n","import { Injectable, inject } from \"@angular/core\";\nimport * as SchematicJS from \"@schematichq/schematic-js\";\nimport {\n  Observable,\n  distinctUntilChanged,\n  finalize,\n  isObservable,\n  map,\n  shareReplay,\n  switchMap,\n} from \"rxjs\";\nimport { SCHEMATIC_CLIENT } from \"./token\";\n\n/** A company's credit balance for a single credit type, plus a loading flag */\nexport type SchematicCreditBalance = {\n  /** The spendable balance; 0 while loading or when the company holds no balance in this credit */\n  balance: number;\n  /** True while the balance is still loading and no value has arrived yet */\n  isLoading: boolean;\n};\n\nfunction shallowEqual<T extends Record<string, unknown>>(\n  a: T | undefined,\n  b: T | undefined,\n): boolean {\n  if (a === b) return true;\n  if (!a || !b) return false;\n  const keysA = Object.keys(a);\n  const keysB = Object.keys(b);\n  if (keysA.length !== keysB.length) return false;\n  return keysA.every((key) => {\n    const valA = a[key];\n    const valB = b[key];\n    if (valA instanceof Date && valB instanceof Date) {\n      return valA.getTime() === valB.getTime();\n    }\n    return valA === valB;\n  });\n}\n\n@Injectable()\nexport class SchematicService {\n  private client = inject(SCHEMATIC_CLIENT);\n\n  private flagValueCache = new Map<string, Observable<boolean>>();\n  private entitlementCache = new Map<\n    string,\n    Observable<SchematicJS.CheckFlagReturn>\n  >();\n  private creditBalanceCache = new Map<\n    string,\n    Observable<SchematicCreditBalance>\n  >();\n  private planCache?: Observable<SchematicJS.CheckPlanReturn | undefined>;\n  private isPendingCache?: Observable<boolean>;\n\n  getClient(): SchematicJS.Schematic {\n    return this.client;\n  }\n\n  setContext(context: SchematicJS.SchematicContext): void {\n    this.client.setContext(context);\n  }\n\n  identify(body: SchematicJS.EventBodyIdentify): void {\n    this.client.identify(body);\n  }\n\n  track(body: SchematicJS.EventBodyTrack): void {\n    this.client.track(body);\n  }\n\n  flagValue$(key: string, fallback: boolean = false): Observable<boolean> {\n    const cacheKey = `${key}:${fallback}`;\n    let cached = this.flagValueCache.get(cacheKey);\n    if (cached) return cached;\n\n    cached = new Observable<boolean>((subscriber) => {\n      const current = this.client.getFlagValue(key);\n      subscriber.next(current ?? fallback);\n\n      const unsubscribe = this.client.addFlagValueListener(key, () => {\n        const value = this.client.getFlagValue(key);\n        subscriber.next(value ?? fallback);\n      });\n\n      return () => unsubscribe();\n    }).pipe(\n      distinctUntilChanged(),\n      shareReplay({ bufferSize: 1, refCount: true }),\n      finalize(() => this.flagValueCache.delete(cacheKey)),\n    );\n\n    this.flagValueCache.set(cacheKey, cached);\n    return cached;\n  }\n\n  entitlement$(\n    key: string,\n    fallback: boolean = false,\n  ): Observable<SchematicJS.CheckFlagReturn> {\n    const cacheKey = `${key}:${fallback}`;\n    let cached = this.entitlementCache.get(cacheKey);\n    if (cached) return cached;\n\n    const fallbackCheck: SchematicJS.CheckFlagReturn = {\n      flag: key,\n      reason: \"Fallback\",\n      value: fallback,\n    };\n\n    cached = new Observable<SchematicJS.CheckFlagReturn>((subscriber) => {\n      const current = this.client.getFlagCheck(key);\n      subscriber.next(current ?? fallbackCheck);\n\n      const unsubscribe = this.client.addFlagCheckListener(key, () => {\n        const check = this.client.getFlagCheck(key);\n        subscriber.next(check ?? fallbackCheck);\n      });\n\n      return () => unsubscribe();\n    }).pipe(\n      distinctUntilChanged(shallowEqual),\n      shareReplay({ bufferSize: 1, refCount: true }),\n      finalize(() => this.entitlementCache.delete(cacheKey)),\n    );\n\n    this.entitlementCache.set(cacheKey, cached);\n    return cached;\n  }\n\n  plan$(): Observable<SchematicJS.CheckPlanReturn | undefined> {\n    if (this.planCache) return this.planCache;\n\n    this.planCache = new Observable<SchematicJS.CheckPlanReturn | undefined>(\n      (subscriber) => {\n        subscriber.next(this.client.getPlan());\n\n        const unsubscribe = this.client.addPlanListener(() => {\n          subscriber.next(this.client.getPlan());\n        });\n\n        return () => unsubscribe();\n      },\n    ).pipe(\n      distinctUntilChanged(shallowEqual),\n      shareReplay({ bufferSize: 1, refCount: true }),\n      finalize(() => {\n        this.planCache = undefined;\n      }),\n    );\n\n    return this.planCache;\n  }\n\n  /**\n   * Observe a company's live, lease-aware credit balance for a single credit type.\n   *\n   * Surfaces the spendable `settled` balance, sourced from the streamed credit\n   * balances map (keyed by credit ID). It emits as partials arrive over the\n   * DataStream, so it stays accurate during an open lease — when the raw\n   * `remaining` would otherwise read stale / falsely \"exhausted\".\n   *\n   * The credit ID is available on a feature's entitlement: `entitlement$(key)`\n   * emits `creditId` for credit-based features. Pass that stream straight in:\n   * this accepts an Observable of credit IDs as well as a plain one, switching\n   * to the new credit as the source emits. While the ID is undefined it emits\n   * the client's loading state and a balance of 0.\n   */\n  creditBalance$(\n    creditId: string | undefined | Observable<string | undefined>,\n  ): Observable<SchematicCreditBalance> {\n    if (isObservable(creditId)) {\n      return creditId.pipe(\n        distinctUntilChanged(),\n        switchMap((id) => this.creditBalanceFor(id)),\n        distinctUntilChanged(shallowEqual),\n        shareReplay({ bufferSize: 1, refCount: true }),\n      );\n    }\n\n    return this.creditBalanceFor(creditId);\n  }\n\n  /**\n   * Emits a zeroed balance that still tracks the client's loading state, for\n   * when there is no credit ID to read (a check that has not arrived yet, or a\n   * feature that is not credit-based).\n   */\n  private noCreditBalance$(): Observable<SchematicCreditBalance> {\n    return this.isPending$().pipe(\n      map((isLoading) => ({ balance: 0, isLoading })),\n    );\n  }\n\n  private creditBalanceFor(\n    creditId: string | undefined,\n  ): Observable<SchematicCreditBalance> {\n    if (creditId === undefined) return this.noCreditBalance$();\n\n    let cached = this.creditBalanceCache.get(creditId);\n    if (cached) return cached;\n\n    cached = new Observable<SchematicCreditBalance>((subscriber) => {\n      const emit = () => {\n        const balance = this.client.getCreditBalance(creditId);\n        subscriber.next({\n          balance: balance?.settled ?? 0,\n          isLoading: balance === undefined && this.client.getIsPending(),\n        });\n      };\n\n      emit();\n\n      const unsubscribeBalance = this.client.addCreditBalanceListener(() =>\n        emit(),\n      );\n      const unsubscribePending = this.client.addIsPendingListener(() => emit());\n\n      return () => {\n        unsubscribeBalance();\n        unsubscribePending();\n      };\n    }).pipe(\n      distinctUntilChanged(shallowEqual),\n      shareReplay({ bufferSize: 1, refCount: true }),\n      finalize(() => this.creditBalanceCache.delete(creditId)),\n    );\n\n    this.creditBalanceCache.set(creditId, cached);\n    return cached;\n  }\n\n  isPending$(): Observable<boolean> {\n    if (this.isPendingCache) return this.isPendingCache;\n\n    this.isPendingCache = new Observable<boolean>((subscriber) => {\n      subscriber.next(this.client.getIsPending());\n\n      const unsubscribe = this.client.addIsPendingListener(() => {\n        subscriber.next(this.client.getIsPending());\n      });\n\n      return () => unsubscribe();\n    }).pipe(\n      distinctUntilChanged(),\n      shareReplay({ bufferSize: 1, refCount: true }),\n      finalize(() => {\n        this.isPendingCache = undefined;\n      }),\n    );\n\n    return this.isPendingCache;\n  }\n}\n","export const version = \"1.6.0\";\n","import { DestroyRef, inject, makeEnvironmentProviders } from \"@angular/core\";\nimport * as SchematicJS from \"@schematichq/schematic-js\";\n\nimport { SchematicService } from \"./schematic.service\";\nimport { SCHEMATIC_CLIENT } from \"./token\";\nimport { version } from \"./version\";\n\ntype BaseSchematicConfig = Omit<SchematicJS.SchematicOptions, \"useWebSocket\">;\n\ntype SchematicConfigWithClient = BaseSchematicConfig & {\n  client: SchematicJS.Schematic;\n  publishableKey?: never;\n};\n\ntype SchematicConfigWithKey = BaseSchematicConfig & {\n  client?: never;\n  publishableKey: string;\n};\n\nexport type SchematicConfig =\n  SchematicConfigWithClient | SchematicConfigWithKey;\n\nexport function provideSchematic(config: SchematicConfig) {\n  const {\n    client: providedClient,\n    publishableKey,\n    additionalHeaders,\n    ...restOpts\n  } = config;\n\n  return makeEnvironmentProviders([\n    {\n      provide: SCHEMATIC_CLIENT,\n      useFactory: () => {\n        const isProvidedClient = !!providedClient;\n\n        const client = isProvidedClient\n          ? providedClient\n          : new SchematicJS.Schematic(publishableKey!, {\n              ...restOpts,\n              useWebSocket: true,\n              additionalHeaders: {\n                \"X-Schematic-Client-Version\": `schematic-angular@${version}`,\n                ...additionalHeaders,\n              },\n            });\n\n        const destroyRef = inject(DestroyRef);\n        destroyRef.onDestroy(() => {\n          if (!isProvidedClient) {\n            client.cleanup().catch((error: unknown) => {\n              console.error(\"Error during Schematic cleanup:\", error);\n            });\n          }\n        });\n\n        return client;\n      },\n    },\n    SchematicService,\n  ]);\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;MAGa,gBAAgB,GAAG,IAAI,cAAc,CAChD,iBAAiB;;ACiBnB,SAAS,YAAY,CACnB,CAAgB,EAChB,CAAgB,EAAA;IAEhB,IAAI,CAAC,KAAK,CAAC;AAAE,QAAA,OAAO,IAAI;AACxB,IAAA,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;AAAE,QAAA,OAAO,KAAK;IAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5B,IAAA,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;AAAE,QAAA,OAAO,KAAK;AAC/C,IAAA,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,KAAI;AACzB,QAAA,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC;AACnB,QAAA,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC;QACnB,IAAI,IAAI,YAAY,IAAI,IAAI,IAAI,YAAY,IAAI,EAAE;YAChD,OAAO,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,CAAC,OAAO,EAAE;QAC1C;QACA,OAAO,IAAI,KAAK,IAAI;AACtB,IAAA,CAAC,CAAC;AACJ;MAGa,gBAAgB,CAAA;AACnB,IAAA,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC;AAEjC,IAAA,cAAc,GAAG,IAAI,GAAG,EAA+B;AACvD,IAAA,gBAAgB,GAAG,IAAI,GAAG,EAG/B;AACK,IAAA,kBAAkB,GAAG,IAAI,GAAG,EAGjC;AACK,IAAA,SAAS;AACT,IAAA,cAAc;IAEtB,SAAS,GAAA;QACP,OAAO,IAAI,CAAC,MAAM;IACpB;AAEA,IAAA,UAAU,CAAC,OAAqC,EAAA;AAC9C,QAAA,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;IACjC;AAEA,IAAA,QAAQ,CAAC,IAAmC,EAAA;AAC1C,QAAA,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B;AAEA,IAAA,KAAK,CAAC,IAAgC,EAAA;AACpC,QAAA,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB;AAEA,IAAA,UAAU,CAAC,GAAW,EAAE,QAAA,GAAoB,KAAK,EAAA;AAC/C,QAAA,MAAM,QAAQ,GAAG,CAAA,EAAG,GAAG,CAAA,CAAA,EAAI,QAAQ,EAAE;QACrC,IAAI,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC;AAC9C,QAAA,IAAI,MAAM;AAAE,YAAA,OAAO,MAAM;AAEzB,QAAA,MAAM,GAAG,IAAI,UAAU,CAAU,CAAC,UAAU,KAAI;YAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC;AAC7C,YAAA,UAAU,CAAC,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC;YAEpC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE,MAAK;gBAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC;AAC3C,gBAAA,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;AACpC,YAAA,CAAC,CAAC;AAEF,YAAA,OAAO,MAAM,WAAW,EAAE;AAC5B,QAAA,CAAC,CAAC,CAAC,IAAI,CACL,oBAAoB,EAAE,EACtB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAC9C,QAAQ,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CACrD;QAED,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC;AACzC,QAAA,OAAO,MAAM;IACf;AAEA,IAAA,YAAY,CACV,GAAW,EACX,QAAA,GAAoB,KAAK,EAAA;AAEzB,QAAA,MAAM,QAAQ,GAAG,CAAA,EAAG,GAAG,CAAA,CAAA,EAAI,QAAQ,EAAE;QACrC,IAAI,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC;AAChD,QAAA,IAAI,MAAM;AAAE,YAAA,OAAO,MAAM;AAEzB,QAAA,MAAM,aAAa,GAAgC;AACjD,YAAA,IAAI,EAAE,GAAG;AACT,YAAA,MAAM,EAAE,UAAU;AAClB,YAAA,KAAK,EAAE,QAAQ;SAChB;AAED,QAAA,MAAM,GAAG,IAAI,UAAU,CAA8B,CAAC,UAAU,KAAI;YAClE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC;AAC7C,YAAA,UAAU,CAAC,IAAI,CAAC,OAAO,IAAI,aAAa,CAAC;YAEzC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE,MAAK;gBAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC;AAC3C,gBAAA,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC;AACzC,YAAA,CAAC,CAAC;AAEF,YAAA,OAAO,MAAM,WAAW,EAAE;AAC5B,QAAA,CAAC,CAAC,CAAC,IAAI,CACL,oBAAoB,CAAC,YAAY,CAAC,EAClC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAC9C,QAAQ,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CACvD;QAED,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC;AAC3C,QAAA,OAAO,MAAM;IACf;IAEA,KAAK,GAAA;QACH,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS;QAEzC,IAAI,CAAC,SAAS,GAAG,IAAI,UAAU,CAC7B,CAAC,UAAU,KAAI;YACb,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAEtC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,MAAK;gBACnD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;AACxC,YAAA,CAAC,CAAC;AAEF,YAAA,OAAO,MAAM,WAAW,EAAE;QAC5B,CAAC,CACF,CAAC,IAAI,CACJ,oBAAoB,CAAC,YAAY,CAAC,EAClC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAC9C,QAAQ,CAAC,MAAK;AACZ,YAAA,IAAI,CAAC,SAAS,GAAG,SAAS;QAC5B,CAAC,CAAC,CACH;QAED,OAAO,IAAI,CAAC,SAAS;IACvB;AAEA;;;;;;;;;;;;;AAaG;AACH,IAAA,cAAc,CACZ,QAA6D,EAAA;AAE7D,QAAA,IAAI,YAAY,CAAC,QAAQ,CAAC,EAAE;AAC1B,YAAA,OAAO,QAAQ,CAAC,IAAI,CAClB,oBAAoB,EAAE,EACtB,SAAS,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,EAC5C,oBAAoB,CAAC,YAAY,CAAC,EAClC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAC/C;QACH;AAEA,QAAA,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC;IACxC;AAEA;;;;AAIG;IACK,gBAAgB,GAAA;QACtB,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,CAC3B,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAChD;IACH;AAEQ,IAAA,gBAAgB,CACtB,QAA4B,EAAA;QAE5B,IAAI,QAAQ,KAAK,SAAS;AAAE,YAAA,OAAO,IAAI,CAAC,gBAAgB,EAAE;QAE1D,IAAI,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC;AAClD,QAAA,IAAI,MAAM;AAAE,YAAA,OAAO,MAAM;AAEzB,QAAA,MAAM,GAAG,IAAI,UAAU,CAAyB,CAAC,UAAU,KAAI;YAC7D,MAAM,IAAI,GAAG,MAAK;gBAChB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC;gBACtD,UAAU,CAAC,IAAI,CAAC;AACd,oBAAA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,CAAC;oBAC9B,SAAS,EAAE,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE;AAC/D,iBAAA,CAAC;AACJ,YAAA,CAAC;AAED,YAAA,IAAI,EAAE;AAEN,YAAA,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC,wBAAwB,CAAC,MAC9D,IAAI,EAAE,CACP;AACD,YAAA,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,MAAM,IAAI,EAAE,CAAC;AAEzE,YAAA,OAAO,MAAK;AACV,gBAAA,kBAAkB,EAAE;AACpB,gBAAA,kBAAkB,EAAE;AACtB,YAAA,CAAC;AACH,QAAA,CAAC,CAAC,CAAC,IAAI,CACL,oBAAoB,CAAC,YAAY,CAAC,EAClC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAC9C,QAAQ,CAAC,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CACzD;QAED,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC;AAC7C,QAAA,OAAO,MAAM;IACf;IAEA,UAAU,GAAA;QACR,IAAI,IAAI,CAAC,cAAc;YAAE,OAAO,IAAI,CAAC,cAAc;QAEnD,IAAI,CAAC,cAAc,GAAG,IAAI,UAAU,CAAU,CAAC,UAAU,KAAI;YAC3D,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAE3C,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,MAAK;gBACxD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;AAC7C,YAAA,CAAC,CAAC;AAEF,YAAA,OAAO,MAAM,WAAW,EAAE;QAC5B,CAAC,CAAC,CAAC,IAAI,CACL,oBAAoB,EAAE,EACtB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAC9C,QAAQ,CAAC,MAAK;AACZ,YAAA,IAAI,CAAC,cAAc,GAAG,SAAS;QACjC,CAAC,CAAC,CACH;QAED,OAAO,IAAI,CAAC,cAAc;IAC5B;uGApNW,gBAAgB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA;2GAAhB,gBAAgB,EAAA,CAAA;;2FAAhB,gBAAgB,EAAA,UAAA,EAAA,CAAA;kBAD5B;;;ACxCM,MAAM,OAAO,GAAG,OAAO;;ACsBxB,SAAU,gBAAgB,CAAC,MAAuB,EAAA;AACtD,IAAA,MAAM,EACJ,MAAM,EAAE,cAAc,EACtB,cAAc,EACd,iBAAiB,EACjB,GAAG,QAAQ,EACZ,GAAG,MAAM;AAEV,IAAA,OAAO,wBAAwB,CAAC;AAC9B,QAAA;AACE,YAAA,OAAO,EAAE,gBAAgB;YACzB,UAAU,EAAE,MAAK;AACf,gBAAA,MAAM,gBAAgB,GAAG,CAAC,CAAC,cAAc;gBAEzC,MAAM,MAAM,GAAG;AACb,sBAAE;AACF,sBAAE,IAAI,WAAW,CAAC,SAAS,CAAC,cAAe,EAAE;AACzC,wBAAA,GAAG,QAAQ;AACX,wBAAA,YAAY,EAAE,IAAI;AAClB,wBAAA,iBAAiB,EAAE;4BACjB,4BAA4B,EAAE,CAAA,kBAAA,EAAqB,OAAO,CAAA,CAAE;AAC5D,4BAAA,GAAG,iBAAiB;AACrB,yBAAA;AACF,qBAAA,CAAC;AAEN,gBAAA,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;AACrC,gBAAA,UAAU,CAAC,SAAS,CAAC,MAAK;oBACxB,IAAI,CAAC,gBAAgB,EAAE;wBACrB,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,KAAI;AACxC,4BAAA,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC;AACzD,wBAAA,CAAC,CAAC;oBACJ;AACF,gBAAA,CAAC,CAAC;AAEF,gBAAA,OAAO,MAAM;YACf,CAAC;AACF,SAAA;QACD,gBAAgB;AACjB,KAAA,CAAC;AACJ;;AC7DA;;AAEG;;"}

package/package.json

@@ -1,20 +1,21 @@
 {
   "name": "@schematichq/schematic-angular",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "author": "Schematic <engineering@schematichq.com>",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+ssh://git@github.com/SchematicHQ/schematic-js.git"
   },
+  "dependencies": {
+    "@schematichq/schematic-js": "^1.8.0",
+    "tslib": "^2.3.0"
+  },
   "peerDependencies": {
     "@angular/core": ">=19.0.0",
     "rxjs": ">=7.0.0"
   },
-  "resolutions": {
-    "minimatch": ">=3.1.3"
-  },
-  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e",
+  "packageManager": "pnpm@11.9.0+sha512.bd682d5d03fe525ef7c9fd6780c6884d1e756ac4c9c9fe00c538782824310dcf90e3ddc4f53835f06dfaebd5085e41855e0bcbb3b60de2ac5bbab89e5036f03b",
   "module": "fesm2022/schematichq-schematic-angular.mjs",
   "typings": "types/schematichq-schematic-angular.d.ts",
   "exports": {
@@ -27,8 +28,5 @@
     }
   },
   "sideEffects": false,
-  "type": "module",
-  "dependencies": {
-    "tslib": "^2.3.0"
-  }
+  "type": "module"
 }

package/types/schematichq-schematic-angular.d.ts

@@ -1,7 +1,7 @@
 import * as i0 from '@angular/core';
 import { InjectionToken } from '@angular/core';
 import * as SchematicJS from '@schematichq/schematic-js';
-export { CheckFlagReturn, CheckPlanReturn, Event, EventBody, EventBodyIdentify, EventBodyTrack, EventType, Keys, RuleType, Schematic, SchematicContext, SchematicOptions, StoragePersister, Traits, TrialStatus, UsagePeriod } from '@schematichq/schematic-js';
+export { CheckFlagReturn, CheckPlanReturn, CompanyCreditBalance, CreditBalance, CreditBalances, Event, EventBody, EventBodyIdentify, EventBodyTrack, EventType, Keys, RuleType, Schematic, SchematicContext, SchematicOptions, StoragePersister, Traits, TrialStatus, UsagePeriod, WarningTier } from '@schematichq/schematic-js';
 import { Observable } from 'rxjs';
 
 type BaseSchematicConfig = Omit<SchematicJS.SchematicOptions, "useWebSocket">;
@@ -18,10 +18,18 @@ declare function provideSchematic(config: SchematicConfig): i0.EnvironmentProvid
 
 declare const SCHEMATIC_CLIENT: InjectionToken<SchematicJS.Schematic>;
 
+/** A company's credit balance for a single credit type, plus a loading flag */
+type SchematicCreditBalance = {
+    /** The spendable balance; 0 while loading or when the company holds no balance in this credit */
+    balance: number;
+    /** True while the balance is still loading and no value has arrived yet */
+    isLoading: boolean;
+};
 declare class SchematicService {
     private client;
     private flagValueCache;
     private entitlementCache;
+    private creditBalanceCache;
     private planCache?;
     private isPendingCache?;
     getClient(): SchematicJS.Schematic;
@@ -31,10 +39,32 @@ declare class SchematicService {
     flagValue$(key: string, fallback?: boolean): Observable<boolean>;
     entitlement$(key: string, fallback?: boolean): Observable<SchematicJS.CheckFlagReturn>;
     plan$(): Observable<SchematicJS.CheckPlanReturn | undefined>;
+    /**
+     * Observe a company's live, lease-aware credit balance for a single credit type.
+     *
+     * Surfaces the spendable `settled` balance, sourced from the streamed credit
+     * balances map (keyed by credit ID). It emits as partials arrive over the
+     * DataStream, so it stays accurate during an open lease — when the raw
+     * `remaining` would otherwise read stale / falsely "exhausted".
+     *
+     * The credit ID is available on a feature's entitlement: `entitlement$(key)`
+     * emits `creditId` for credit-based features. Pass that stream straight in:
+     * this accepts an Observable of credit IDs as well as a plain one, switching
+     * to the new credit as the source emits. While the ID is undefined it emits
+     * the client's loading state and a balance of 0.
+     */
+    creditBalance$(creditId: string | undefined | Observable<string | undefined>): Observable<SchematicCreditBalance>;
+    /**
+     * Emits a zeroed balance that still tracks the client's loading state, for
+     * when there is no credit ID to read (a check that has not arrived yet, or a
+     * feature that is not credit-based).
+     */
+    private noCreditBalance$;
+    private creditBalanceFor;
     isPending$(): Observable<boolean>;
     static ɵfac: i0.ɵɵFactoryDeclaration<SchematicService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SchematicService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 export { SCHEMATIC_CLIENT, SchematicService, provideSchematic };
-export type { SchematicConfig };
+export type { SchematicConfig, SchematicCreditBalance };