@schematichq/schematic-js 1.5.0 → 1.7.0

package/dist/schematic.cjs.js

@@ -34,9 +34,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// node_modules/cross-fetch/dist/browser-polyfill.js
+// node_modules/.pnpm/cross-fetch@4.1.0/node_modules/cross-fetch/dist/browser-polyfill.js
 var require_browser_polyfill = __commonJS({
-  "node_modules/cross-fetch/dist/browser-polyfill.js"(exports) {
+  "node_modules/.pnpm/cross-fetch@4.1.0/node_modules/cross-fetch/dist/browser-polyfill.js"(exports) {
     (function(self2) {
       var irrelevant = (function(exports2) {
         var g = typeof globalThis !== "undefined" && globalThis || typeof self2 !== "undefined" && self2 || // eslint-disable-next-line no-undef
@@ -578,16 +578,28 @@ __export(index_exports, {
   CheckFlagsResponseFromJSON: () => CheckFlagsResponseFromJSON,
   CheckPlanReturnFromJSON: () => CheckPlanReturnFromJSON,
   CreditBalancesFromJSON: () => CreditBalancesFromJSON,
+  DEFAULT_INVOICE_QUERY: () => DEFAULT_INVOICE_QUERY,
   DatastreamCompanyPlanFromJSON: () => DatastreamCompanyPlanFromJSON,
   EventBodyFlagCheckToJSON: () => EventBodyFlagCheckToJSON,
+  INVOICE_MAX_PAGE_SIZE: () => INVOICE_MAX_PAGE_SIZE,
+  INVOICE_PAGE_SIZE: () => INVOICE_PAGE_SIZE,
+  InvoiceStatus: () => InvoiceStatus,
   RuleType: () => RuleType,
   Schematic: () => Schematic,
+  SchematicApiError: () => SchematicApiError,
+  SchematicBillingClient: () => SchematicBillingClient,
+  SchematicSession: () => SchematicSession,
+  TOKEN_CACHE_SIZE: () => TOKEN_CACHE_SIZE,
   TrialStatus: () => TrialStatus,
-  UsagePeriod: () => UsagePeriod
+  UsagePeriod: () => UsagePeriod,
+  billingApi: () => models_exports,
+  fetchBillingData: () => fetchBillingData,
+  normalizeInvoiceQuery: () => normalizeInvoiceQuery,
+  sessionKey: () => sessionKey
 });
 module.exports = __toCommonJS(index_exports);
 
-// node_modules/uuid/dist/stringify.js
+// node_modules/.pnpm/uuid@14.0.2/node_modules/uuid/dist/stringify.js
 var byteToHex = [];
 for (let i = 0; i < 256; ++i) {
   byteToHex.push((i + 256).toString(16).slice(1));
@@ -596,13 +608,13 @@ function unsafeStringify(arr, offset = 0) {
   return (byteToHex[arr[offset + 0]] + byteToHex[arr[offset + 1]] + byteToHex[arr[offset + 2]] + byteToHex[arr[offset + 3]] + "-" + byteToHex[arr[offset + 4]] + byteToHex[arr[offset + 5]] + "-" + byteToHex[arr[offset + 6]] + byteToHex[arr[offset + 7]] + "-" + byteToHex[arr[offset + 8]] + byteToHex[arr[offset + 9]] + "-" + byteToHex[arr[offset + 10]] + byteToHex[arr[offset + 11]] + byteToHex[arr[offset + 12]] + byteToHex[arr[offset + 13]] + byteToHex[arr[offset + 14]] + byteToHex[arr[offset + 15]]).toLowerCase();
 }
 
-// node_modules/uuid/dist/rng.js
+// node_modules/.pnpm/uuid@14.0.2/node_modules/uuid/dist/rng.js
 var rnds8 = new Uint8Array(16);
 function rng() {
   return crypto.getRandomValues(rnds8);
 }
 
-// node_modules/uuid/dist/v4.js
+// node_modules/.pnpm/uuid@14.0.2/node_modules/uuid/dist/v4.js
 function v4(options, buf, offset) {
   if (!buf && !options && crypto.randomUUID) {
     return crypto.randomUUID();
@@ -650,6 +662,20 @@ function MetricPeriodMonthResetFromJSONTyped(json, ignoreDiscriminator) {
   return json;
 }
 
+// src/types/api/models/WarningTier.ts
+function WarningTierFromJSON(json) {
+  return WarningTierFromJSONTyped(json, false);
+}
+function WarningTierFromJSONTyped(json, ignoreDiscriminator) {
+  if (json == null) {
+    return json;
+  }
+  return {
+    key: json["key"],
+    value: json["value"]
+  };
+}
+
 // src/types/api/models/MetricPeriod.ts
 function MetricPeriodFromJSON(json) {
   return MetricPeriodFromJSONTyped(json, false);
@@ -684,7 +710,8 @@ function FeatureEntitlementFromJSONTyped(json, ignoreDiscriminator) {
     monthReset: json["month_reset"] == null ? void 0 : MetricPeriodMonthResetFromJSON(json["month_reset"]),
     softLimit: json["soft_limit"] == null ? void 0 : json["soft_limit"],
     usage: json["usage"] == null ? void 0 : json["usage"],
-    valueType: EntitlementValueTypeFromJSON(json["value_type"])
+    valueType: EntitlementValueTypeFromJSON(json["value_type"]),
+    warningTiers: json["warning_tiers"] == null ? void 0 : json["warning_tiers"].map(WarningTierFromJSON)
   };
 }
 
@@ -1074,6 +1101,7 @@ function EventBodyFlagCheckToJSONTyped(value, ignoreDiscriminator = false) {
     error: value["error"],
     flag_id: value["flagId"],
     flag_key: value["flagKey"],
+    preflight: value["preflight"],
     reason: value["reason"],
     req_company: value["reqCompany"],
     req_user: value["reqUser"],
@@ -1195,7 +1223,590 @@ function contextString(context) {
 }
 
 // src/version.ts
-var version = "1.5.0";
+var version = "1.7.0";
+
+// src/billing/api/generated/models/index.ts
+var models_exports = {};
+__export(models_exports, {
+  ApiErrorFromJSON: () => ApiErrorFromJSON,
+  ApiErrorFromJSONTyped: () => ApiErrorFromJSONTyped,
+  ApiErrorToJSON: () => ApiErrorToJSON,
+  ApiErrorToJSONTyped: () => ApiErrorToJSONTyped,
+  CompanyInvoiceResponseDataFromJSON: () => CompanyInvoiceResponseDataFromJSON,
+  CompanyInvoiceResponseDataFromJSONTyped: () => CompanyInvoiceResponseDataFromJSONTyped,
+  CompanyInvoiceResponseDataToJSON: () => CompanyInvoiceResponseDataToJSON,
+  CompanyInvoiceResponseDataToJSONTyped: () => CompanyInvoiceResponseDataToJSONTyped,
+  CompanyInvoicesResponseDataFromJSON: () => CompanyInvoicesResponseDataFromJSON,
+  CompanyInvoicesResponseDataFromJSONTyped: () => CompanyInvoicesResponseDataFromJSONTyped,
+  CompanyInvoicesResponseDataToJSON: () => CompanyInvoicesResponseDataToJSON,
+  CompanyInvoicesResponseDataToJSONTyped: () => CompanyInvoicesResponseDataToJSONTyped,
+  GetCompanyInvoicesParamsFromJSON: () => GetCompanyInvoicesParamsFromJSON,
+  GetCompanyInvoicesParamsFromJSONTyped: () => GetCompanyInvoicesParamsFromJSONTyped,
+  GetCompanyInvoicesParamsToJSON: () => GetCompanyInvoicesParamsToJSON,
+  GetCompanyInvoicesParamsToJSONTyped: () => GetCompanyInvoicesParamsToJSONTyped,
+  GetCompanyInvoicesResponseFromJSON: () => GetCompanyInvoicesResponseFromJSON,
+  GetCompanyInvoicesResponseFromJSONTyped: () => GetCompanyInvoicesResponseFromJSONTyped,
+  GetCompanyInvoicesResponseToJSON: () => GetCompanyInvoicesResponseToJSON,
+  GetCompanyInvoicesResponseToJSONTyped: () => GetCompanyInvoicesResponseToJSONTyped,
+  InvoiceStatus: () => InvoiceStatus,
+  InvoiceStatusFromJSON: () => InvoiceStatusFromJSON,
+  InvoiceStatusFromJSONTyped: () => InvoiceStatusFromJSONTyped,
+  InvoiceStatusToJSON: () => InvoiceStatusToJSON,
+  InvoiceStatusToJSONTyped: () => InvoiceStatusToJSONTyped,
+  instanceOfApiError: () => instanceOfApiError,
+  instanceOfCompanyInvoiceResponseData: () => instanceOfCompanyInvoiceResponseData,
+  instanceOfCompanyInvoicesResponseData: () => instanceOfCompanyInvoicesResponseData,
+  instanceOfGetCompanyInvoicesParams: () => instanceOfGetCompanyInvoicesParams,
+  instanceOfGetCompanyInvoicesResponse: () => instanceOfGetCompanyInvoicesResponse,
+  instanceOfInvoiceStatus: () => instanceOfInvoiceStatus
+});
+
+// src/billing/api/generated/models/ApiError.ts
+function instanceOfApiError(value) {
+  if (!("error" in value) || value["error"] === void 0) return false;
+  return true;
+}
+function ApiErrorFromJSON(json) {
+  return ApiErrorFromJSONTyped(json, false);
+}
+function ApiErrorFromJSONTyped(json, ignoreDiscriminator) {
+  if (json == null) {
+    return json;
+  }
+  return {
+    error: json["error"]
+  };
+}
+function ApiErrorToJSON(json) {
+  return ApiErrorToJSONTyped(json, false);
+}
+function ApiErrorToJSONTyped(value, ignoreDiscriminator = false) {
+  if (value == null) {
+    return value;
+  }
+  return {
+    error: value["error"]
+  };
+}
+
+// src/billing/api/generated/models/InvoiceStatus.ts
+var InvoiceStatus = {
+  Draft: "draft",
+  Open: "open",
+  Paid: "paid",
+  Uncollectible: "uncollectible",
+  Void: "void"
+};
+function instanceOfInvoiceStatus(value) {
+  for (const key in InvoiceStatus) {
+    if (Object.prototype.hasOwnProperty.call(InvoiceStatus, key)) {
+      if (InvoiceStatus[key] === value) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function InvoiceStatusFromJSON(json) {
+  return InvoiceStatusFromJSONTyped(json, false);
+}
+function InvoiceStatusFromJSONTyped(json, ignoreDiscriminator) {
+  return json;
+}
+function InvoiceStatusToJSON(value) {
+  return value;
+}
+function InvoiceStatusToJSONTyped(value, ignoreDiscriminator) {
+  return value;
+}
+
+// src/billing/api/generated/models/CompanyInvoiceResponseData.ts
+function instanceOfCompanyInvoiceResponseData(value) {
+  if (!("amountDue" in value) || value["amountDue"] === void 0) return false;
+  if (!("createdAt" in value) || value["createdAt"] === void 0) return false;
+  if (!("currency" in value) || value["currency"] === void 0) return false;
+  if (!("id" in value) || value["id"] === void 0) return false;
+  return true;
+}
+function CompanyInvoiceResponseDataFromJSON(json) {
+  return CompanyInvoiceResponseDataFromJSONTyped(json, false);
+}
+function CompanyInvoiceResponseDataFromJSONTyped(json, ignoreDiscriminator) {
+  if (json == null) {
+    return json;
+  }
+  return {
+    amountDue: json["amount_due"],
+    createdAt: new Date(json["created_at"]),
+    currency: json["currency"],
+    dueDate: json["due_date"] == null ? void 0 : new Date(json["due_date"]),
+    id: json["id"],
+    status: json["status"] == null ? void 0 : InvoiceStatusFromJSON(json["status"]),
+    url: json["url"] == null ? void 0 : json["url"]
+  };
+}
+function CompanyInvoiceResponseDataToJSON(json) {
+  return CompanyInvoiceResponseDataToJSONTyped(json, false);
+}
+function CompanyInvoiceResponseDataToJSONTyped(value, ignoreDiscriminator = false) {
+  if (value == null) {
+    return value;
+  }
+  return {
+    amount_due: value["amountDue"],
+    created_at: value["createdAt"].toISOString(),
+    currency: value["currency"],
+    due_date: value["dueDate"] == null ? void 0 : value["dueDate"].toISOString(),
+    id: value["id"],
+    status: InvoiceStatusToJSON(value["status"]),
+    url: value["url"]
+  };
+}
+
+// src/billing/api/generated/models/CompanyInvoicesResponseData.ts
+function instanceOfCompanyInvoicesResponseData(value) {
+  if (!("count" in value) || value["count"] === void 0) return false;
+  if (!("invoices" in value) || value["invoices"] === void 0) return false;
+  return true;
+}
+function CompanyInvoicesResponseDataFromJSON(json) {
+  return CompanyInvoicesResponseDataFromJSONTyped(json, false);
+}
+function CompanyInvoicesResponseDataFromJSONTyped(json, ignoreDiscriminator) {
+  if (json == null) {
+    return json;
+  }
+  return {
+    count: json["count"],
+    invoices: json["invoices"].map(
+      CompanyInvoiceResponseDataFromJSON
+    )
+  };
+}
+function CompanyInvoicesResponseDataToJSON(json) {
+  return CompanyInvoicesResponseDataToJSONTyped(json, false);
+}
+function CompanyInvoicesResponseDataToJSONTyped(value, ignoreDiscriminator = false) {
+  if (value == null) {
+    return value;
+  }
+  return {
+    count: value["count"],
+    invoices: value["invoices"].map(
+      CompanyInvoiceResponseDataToJSON
+    )
+  };
+}
+
+// src/billing/api/generated/models/GetCompanyInvoicesParams.ts
+function instanceOfGetCompanyInvoicesParams(value) {
+  return true;
+}
+function GetCompanyInvoicesParamsFromJSON(json) {
+  return GetCompanyInvoicesParamsFromJSONTyped(json, false);
+}
+function GetCompanyInvoicesParamsFromJSONTyped(json, ignoreDiscriminator) {
+  if (json == null) {
+    return json;
+  }
+  return {
+    includePending: json["include_pending"] == null ? void 0 : json["include_pending"],
+    limit: json["limit"] == null ? void 0 : json["limit"],
+    offset: json["offset"] == null ? void 0 : json["offset"]
+  };
+}
+function GetCompanyInvoicesParamsToJSON(json) {
+  return GetCompanyInvoicesParamsToJSONTyped(json, false);
+}
+function GetCompanyInvoicesParamsToJSONTyped(value, ignoreDiscriminator = false) {
+  if (value == null) {
+    return value;
+  }
+  return {
+    include_pending: value["includePending"],
+    limit: value["limit"],
+    offset: value["offset"]
+  };
+}
+
+// src/billing/api/generated/models/GetCompanyInvoicesResponse.ts
+function instanceOfGetCompanyInvoicesResponse(value) {
+  if (!("data" in value) || value["data"] === void 0) return false;
+  if (!("params" in value) || value["params"] === void 0) return false;
+  return true;
+}
+function GetCompanyInvoicesResponseFromJSON(json) {
+  return GetCompanyInvoicesResponseFromJSONTyped(json, false);
+}
+function GetCompanyInvoicesResponseFromJSONTyped(json, ignoreDiscriminator) {
+  if (json == null) {
+    return json;
+  }
+  return {
+    data: CompanyInvoicesResponseDataFromJSON(json["data"]),
+    params: GetCompanyInvoicesParamsFromJSON(json["params"])
+  };
+}
+function GetCompanyInvoicesResponseToJSON(json) {
+  return GetCompanyInvoicesResponseToJSONTyped(json, false);
+}
+function GetCompanyInvoicesResponseToJSONTyped(value, ignoreDiscriminator = false) {
+  if (value == null) {
+    return value;
+  }
+  return {
+    data: CompanyInvoicesResponseDataToJSON(value["data"]),
+    params: GetCompanyInvoicesParamsToJSON(value["params"])
+  };
+}
+
+// src/billing/contract/invoices.ts
+var DEFAULT_INVOICE_QUERY = {};
+function normalizeInvoiceQuery(query) {
+  const { includePending, ...rest } = query;
+  return includePending === true ? { ...rest, includePending: true } : rest;
+}
+
+// src/billing/session.ts
+var SchematicApiError = class extends Error {
+  constructor(status, path, body) {
+    super(
+      typeof body === "object" && body !== null && "error" in body ? String(body.error) : `Request to ${path} failed with status ${status}`
+    );
+    this.status = status;
+    this.path = path;
+    this.body = body;
+    this.name = "SchematicApiError";
+  }
+  status;
+  path;
+  body;
+};
+var DEFAULT_API_URL = "https://api.schematichq.com";
+var TOKEN_CACHE_SIZE = 10;
+function sessionKey(session) {
+  return JSON.stringify([session.company, session.user ?? null]);
+}
+var SchematicSession = class {
+  _apiUrl;
+  _headers;
+  _fetch;
+  _session;
+  _tokens = /* @__PURE__ */ new Map();
+  _resolving = /* @__PURE__ */ new Map();
+  /**
+   * Bumped when the session's identity changes, and only then — the object
+   * itself is replaced on every render. Anything asking "is this still the
+   * session I started under?" counts generations rather than comparing.
+   */
+  _generation = 0;
+  _listeners = /* @__PURE__ */ new Set();
+  constructor(options = {}) {
+    this._session = options.session;
+    this._apiUrl = (options.apiUrl ?? DEFAULT_API_URL).replace(/\/$/, "");
+    this._headers = options.additionalHeaders ?? {};
+    this._fetch = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
+  }
+  get key() {
+    return this._session === null || this._session === void 0 ? void 0 : sessionKey(this._session);
+  }
+  get status() {
+    if (this._session === void 0) {
+      return "pending";
+    }
+    return this._session === null ? "ended" : "active";
+  }
+  /** Only a statement that changes which pair is read counts as a change. */
+  set(session) {
+    if (session === void 0) {
+      return;
+    }
+    const previous = this._session;
+    this._session = session;
+    if (session === null) {
+      if (previous === null) {
+        return;
+      }
+      this._tokens.clear();
+      this._resolving.clear();
+      this._generation += 1;
+      this._emit({ type: "ended" });
+      return;
+    }
+    if (previous !== null && previous !== void 0) {
+      if (previous.company === session.company && (previous.user ?? null) === (session.user ?? null)) {
+        return;
+      }
+      this._generation += 1;
+      this._emit({ type: "changed" });
+      return;
+    }
+    this._generation += 1;
+    this._emit({ type: "started" });
+  }
+  onChange(listener) {
+    this._listeners.add(listener);
+    return () => {
+      this._listeners.delete(listener);
+    };
+  }
+  _emit(event) {
+    for (const listener of this._listeners) {
+      listener(event);
+    }
+  }
+  _cached(key) {
+    const cached = this._tokens.get(key);
+    if (cached === void 0) {
+      return void 0;
+    }
+    if (cached.expiresAt !== void 0 && cached.expiresAt.getTime() <= Date.now()) {
+      this._tokens.delete(key);
+      return void 0;
+    }
+    this._tokens.delete(key);
+    this._tokens.set(key, cached);
+    return cached;
+  }
+  _cache(key, resolved) {
+    this._tokens.delete(key);
+    this._tokens.set(key, resolved);
+    while (this._tokens.size > TOKEN_CACHE_SIZE) {
+      const oldest = this._tokens.keys().next();
+      if (oldest.done === true) {
+        break;
+      }
+      this._tokens.delete(oldest.value);
+    }
+  }
+  /**
+   * The credential for a session, minted if this one is not held. `force`
+   * retires what is held first: the caller is a request the API has just
+   * rejected.
+   */
+  resolveToken(session, force) {
+    const { token } = session;
+    if (typeof token === "string") {
+      return Promise.resolve(token);
+    }
+    const key = sessionKey(session);
+    if (!force) {
+      const cached = this._cached(key);
+      if (cached !== void 0) {
+        return Promise.resolve(cached.token);
+      }
+    } else {
+      this._tokens.delete(key);
+    }
+    const inflight = this._resolving.get(key);
+    if (inflight !== void 0 && inflight.sessionGeneration === this._generation && (!force || inflight.forced)) {
+      return inflight.promise;
+    }
+    const provider = token;
+    const sessionGeneration = this._generation;
+    const owns = () => this._resolving.get(key)?.promise === promise;
+    const promise = Promise.resolve().then(() => provider()).then((result) => {
+      const { resolved, stamped } = asResolvedToken(result, session);
+      if (owns() && (this._generation === sessionGeneration || stamped)) {
+        this._cache(key, resolved);
+      }
+      return resolved.token;
+    }).finally(() => {
+      if (owns()) {
+        this._resolving.delete(key);
+      }
+    });
+    this._resolving.set(key, { promise, forced: force, sessionGeneration });
+    return promise;
+  }
+  /**
+   * Sends a request under the active session's credential, refreshing once
+   * and retrying if the API rejects it. Rejects rather than answering when
+   * the session changes while the request is in flight: the rows would
+   * otherwise come back as the answer to a question asked for another pair.
+   */
+  async request(path, options = {}) {
+    const { method = "GET", body } = options;
+    const send = async (credential2) => this._fetch(`${this._apiUrl}${path}`, {
+      method,
+      headers: {
+        "Accept": "application/json",
+        ...body === void 0 ? {} : { "Content-Type": "application/json" },
+        ...this._headers,
+        "X-Schematic-Api-Key": credential2
+      },
+      ...body === void 0 ? {} : { body: JSON.stringify(body) }
+    });
+    const session = this._session;
+    if (session === null) {
+      throw new Error("There is no session to read data for.");
+    }
+    if (session === void 0) {
+      throw new Error("A session is required to read data.");
+    }
+    const provider = session.token;
+    const generation = this._generation;
+    const stillOurs = async (response2) => {
+      if (this._generation === generation) {
+        return;
+      }
+      if (response2 !== void 0) {
+        await discardBody(response2);
+      }
+      throw new Error("The session changed while this request was in flight.");
+    };
+    const credential = await this.resolveToken(session, false);
+    if (this._generation !== generation) {
+      throw new Error("The session changed before this request was sent.");
+    }
+    let response = await send(credential);
+    await stillOurs(response);
+    if (response.status === 401 && typeof provider === "function" && this._generation === generation) {
+      const status = response.status;
+      const rejected = await readBody(response);
+      let retried = false;
+      const current = this._session;
+      if (this._generation === generation && current !== null && current !== void 0) {
+        const refreshed = await this.resolveToken(current, true);
+        if (this._generation === generation) {
+          response = await send(refreshed);
+          await stillOurs(response);
+          retried = true;
+        }
+      }
+      if (!retried) {
+        throw new SchematicApiError(status, path, rejected);
+      }
+    }
+    const parsed = await readBody(response);
+    await stillOurs();
+    if (!response.ok) {
+      throw new SchematicApiError(response.status, path, parsed);
+    }
+    return parsed;
+  }
+};
+function asResolvedToken(result, session) {
+  if (typeof result === "string") {
+    return { resolved: { token: result }, stamped: false };
+  }
+  const token = result?.token;
+  if (typeof token !== "string" || token === "") {
+    throw new Error("The access token provider did not return a token.");
+  }
+  if (result.company !== void 0 && result.company !== session.company || result.user !== void 0 && session.user !== void 0 && result.user !== session.user) {
+    throw new Error(
+      "The access token provider returned a token for a different session."
+    );
+  }
+  const stamped = result.company !== void 0 && (session.user === void 0 || result.user !== void 0);
+  return { resolved: { token, expiresAt: asDate(result.expiresAt) }, stamped };
+}
+function asDate(value) {
+  if (value === void 0 || value === null) {
+    return void 0;
+  }
+  const date = value instanceof Date ? value : new Date(value);
+  return Number.isNaN(date.getTime()) ? void 0 : date;
+}
+async function discardBody(response) {
+  try {
+    await response.body?.cancel();
+  } catch {
+  }
+}
+async function readBody(response) {
+  const text = await response.text();
+  if (text === "") {
+    return null;
+  }
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+
+// src/billing/client.ts
+var INVOICE_PAGE_SIZE = 12;
+var INVOICE_MAX_PAGE_SIZE = 250;
+var SchematicBillingClient = class {
+  /**
+   * Public so a second client over the same surface can be constructed on
+   * this one rather than minting tokens of its own.
+   */
+  session;
+  constructor(options = {}) {
+    this.session = options instanceof SchematicSession ? options : new SchematicSession(options);
+  }
+  get sessionKey() {
+    return this.session.key;
+  }
+  get sessionStatus() {
+    return this.session.status;
+  }
+  setSession(session) {
+    this.session.set(session);
+  }
+  onSessionChange(listener) {
+    return this.session.onChange(listener);
+  }
+  fetchInvoices(params) {
+    const query = new URLSearchParams({
+      limit: String(Math.min(params.limit, INVOICE_MAX_PAGE_SIZE)),
+      offset: String(params.offset)
+    });
+    if (params.includePending !== void 0) {
+      query.set("include_pending", String(params.includePending));
+    }
+    const path = `/company/invoices?${query}`;
+    return this.session.request(path).then((body) => {
+      if (body === null || typeof body !== "object" || !("data" in body)) {
+        throw new Error(`Malformed response from ${path}`);
+      }
+      const data = body.data;
+      if (data == null || data.invoices == null) {
+        return { invoices: [], count: 0 };
+      }
+      const decoded = GetCompanyInvoicesResponseFromJSON(body).data;
+      return { invoices: decoded.invoices, count: decoded.count };
+    });
+  }
+};
+async function fetchBillingData(client, options = {}) {
+  const wanted = options.names ?? ["invoices"];
+  const data = {};
+  const invoices = options.invoices === void 0 ? void 0 : normalizeInvoiceQuery(options.invoices);
+  if (invoices !== void 0) {
+    data.params = { invoices };
+  }
+  data.sessionKey = client.sessionKey;
+  await Promise.all(
+    wanted.map(async (name) => {
+      try {
+        switch (name) {
+          case "invoices": {
+            const page = await client.fetchInvoices({
+              ...invoices ?? {},
+              limit: INVOICE_PAGE_SIZE,
+              offset: 0
+            });
+            data.invoices = {
+              invoices: page.invoices,
+              count: page.count,
+              // Two queries on the server: a count that outran the rows
+              // would seed a page that pages nothing.
+              hasMore: page.invoices.length > 0 && page.invoices.length < page.count
+            };
+            break;
+          }
+        }
+      } catch {
+      }
+    })
+  );
+  return data;
+}
 
 // src/index.ts
 var anonymousIdKey = "schematicId";
@@ -1204,9 +1815,9 @@ var flagStateCacheMaxContexts = 10;
 var flagStateCacheDefaultMaxAgeMs = 7 * 24 * 60 * 60 * 1e3;
 var emptyCreditBalances = Object.freeze({});
 var Schematic = class {
-  additionalHeaders = {};
+  _additionalHeaders = {};
   apiKey;
-  apiUrl = "https://api.schematichq.com";
+  _apiUrl = "https://api.schematichq.com";
   conn = null;
   context = {};
   debugEnabled = false;
@@ -1286,7 +1897,7 @@ var Schematic = class {
     if (this.offlineEnabled) {
       this.setIsPending(false);
     }
-    this.additionalHeaders = {
+    this._additionalHeaders = {
       "X-Schematic-Client-Version": `schematic-js@${version}`,
       ...options?.additionalHeaders ?? {}
     };
@@ -1302,7 +1913,7 @@ var Schematic = class {
     }
     this.hydrateFlagStateFromCache();
     if (options?.apiUrl !== void 0) {
-      this.apiUrl = options.apiUrl;
+      this._apiUrl = options.apiUrl;
     }
     if (options?.eventUrl !== void 0) {
       this.eventUrl = options.eventUrl;
@@ -1367,6 +1978,12 @@ var Schematic = class {
       this.debug("Initialized with debug mode enabled");
     }
   }
+  get apiUrl() {
+    return this._apiUrl;
+  }
+  get additionalHeaders() {
+    return { ...this._additionalHeaders };
+  }
   /**
    * Resolve fallback value according to priority order:
    * 1. Callsite fallback value (if provided)
@@ -1452,11 +2069,11 @@ var Schematic = class {
       return resolvedFallbackResult.value;
     }
     if (!this.useWebSocket) {
-      const requestUrl = `${this.apiUrl}/flags/${key}/check`;
+      const requestUrl = `${this._apiUrl}/flags/${key}/check`;
       return fetch(requestUrl, {
         method: "POST",
         headers: {
-          ...this.additionalHeaders ?? {},
+          ...this._additionalHeaders ?? {},
           "Content-Type": "application/json;charset=UTF-8",
           "X-Schematic-Api-Key": this.apiKey
         },
@@ -1659,12 +2276,12 @@ var Schematic = class {
       this.debug(`checkFlags offline result: returning empty object`);
       return {};
     }
-    const requestUrl = `${this.apiUrl}/flags/check`;
+    const requestUrl = `${this._apiUrl}/flags/check`;
     const requestBody = JSON.stringify(context);
     return fetch(requestUrl, {
       method: "POST",
       headers: {
-        ...this.additionalHeaders ?? {},
+        ...this._additionalHeaders ?? {},
         "Content-Type": "application/json;charset=UTF-8",
         "X-Schematic-Api-Key": this.apiKey
       },
@@ -2211,7 +2828,7 @@ var Schematic = class {
       const response = await fetch(captureUrl, {
         method: "POST",
         headers: {
-          ...this.additionalHeaders ?? {},
+          ...this._additionalHeaders ?? {},
           "Content-Type": "application/json;charset=UTF-8"
         },
         body: payload
@@ -2707,7 +3324,7 @@ var Schematic = class {
           }
         });
         this.currentWebSocket = socket;
-        const clientVersion = this.additionalHeaders["X-Schematic-Client-Version"] ?? `schematic-js@${version}`;
+        const clientVersion = this._additionalHeaders["X-Schematic-Client-Version"] ?? `schematic-js@${version}`;
         const messagePayload = {
           apiKey: this.apiKey,
           clientVersion,