mbase-sdk 0.0.2 → 0.0.4

package/README.md

@@ -19,13 +19,17 @@ import { Meterbase } from "@meterbase/sdk"
 
 const meterbase = new Meterbase({ apiKey: process.env.METERBASE_API_KEY! })
 
-const { allowed } = await meterbase.check({
+const { allowed, reason, rate_limits } = await meterbase.check({
   customer_id: "acct_1", // the tenant's own id, not ours
   meter_id: "ai_tokens", // the meter's key, not ours
   quantity: 50_000, // what you are about to spend; defaults to 1
 })
 
-if (!allowed) throw new Error("Out of quota")
+if (!allowed) throw new Error(`Refused: ${reason}`)
+
+// Allowed, and still worth reading: every window comes back on every call.
+const tight = rate_limits.find((w) => w.remaining < w.max / 10)
+if (tight) console.warn(`Slowing down until ${tight.resets_at}`)
 
 const completion = await generate(prompt)
 
@@ -48,6 +52,16 @@ capacity is not a number. It is one figure and not a breakdown: `check` answers
 from a single cached integer, and itemising where the capacity came from would
 cost it that. For the per-grant detail, read a customer's allowances.
 
+A check answers **two gates**, and `allowed` needs both: the capacity has to
+cover the quantity, and every rate limit in force — _at most so much of this
+meter per minute, hour or day_ — has to admit it. `reason` names the one that
+said no, and is absent when the answer is yes. `rate_limits` reports every
+window whether or not it refused, so a caller can ease off as its headroom
+closes instead of finding the ceiling by hitting it; it is `[]` when no rule
+applies. A limit is protective and not commercial, so it is never folded into
+`available`: a customer well inside their plan can still be limited, and one on
+`no_cap` is precisely the customer a runaway loop costs most.
+
 ### Recording usage
 
 `track` counts work that already happened — the tokens were spent, the image
@@ -60,7 +74,7 @@ const { event } = await meterbase.track({
   customer_id: "acct_1",
   meter_id: "ai_tokens",
   quantity: 250_000,
-  idempotency_key: "req_9f3a", // generated when you omit it
+  idempotency_key: "0199e0c0-8f3a-7c21-9d44-6b2e91a0f5c3", // a UUIDv7; generated when you omit it
 })
 
 event.replayed // false the first time, true for a retry of the same call
@@ -75,16 +89,37 @@ bill drawn from a period is never moved by a report that arrives after it.
 
 #### Idempotency
 
-`customer_id` + `idempotency_key` identifies one logical event.
-
-| The retry sends                  | The engine answers                                        |
-| -------------------------------- | --------------------------------------------------------- |
-| the same key, meter and quantity | the original event with `replayed: true`, writing nothing |
-| the same key, a different event  | `409 idempotency_conflict`, naming the original           |
-
-The timestamp is deliberately not compared: every call is stamped with its own
-clock, so a retry carries a later one, and refusing that would punish the
-ordinary retry. The original's timestamp comes back unchanged.
+`idempotency_key` identifies one logical event, and **is** that event's id.
+It has to be a **UUIDv7**, whose first 48 bits are the millisecond it was
+minted. That timestamp is not decoration: the engine admits a key only while
+it is within **one hour** of the engine's clock, and keeps the claim behind it
+until exactly that hour is up. A retry is therefore recognised for as long as
+it is accepted at all.
+
+| The call sends                        | The engine answers                                     |
+| ------------------------------------- | ------------------------------------------------------ |
+| a fresh key                           | the recorded event, `replayed: false`                  |
+| a key it has already seen             | that event with `replayed: true`, writing nothing      |
+| a key more than an hour old, or ahead | `422 too_late`, writing nothing                        |
+| anything that is not a UUIDv7         | `422 invalid_idempotency_key`, writing nothing         |
+
+A key it has already seen replays **whatever the rest of the body says**:
+there is one claim behind the key and nothing to compare a retry against, so
+a changed quantity is a replay rather than an error. The upside is that a
+replay costs one lookup and stores nothing.
+
+**The hour is a retry budget.** Retry inside it and your call is recognised.
+Past it, `too_late` — and do not then resend under a fresh key, because the
+original may have been recorded. Nothing is written on either refusal: both
+are checked before the engine touches anything.
+
+**Clocks matter now.** The key is minted here, from this machine's clock, so
+a device running more than an hour off would have every call refused. When
+this SDK mints the key it handles that itself: `too_late` carries the engine's
+`server_time`, the client corrects its offset and retries once, and you never
+see the error. When **you** supply the key, you get `TooLateError` with
+`serverTime` on it, because only you can know whether that key names work that
+was already recorded.
 
 **The SDK generates a key when you omit one, and reuses it across that call's
 retries** — including its own, since `track` is the one `POST` it will replay.
@@ -368,9 +403,10 @@ try {
 | `PermissionDeniedError`            | 403 — the key may not use this route                                                     |
 | `NotFoundError`                    | 404                                                                                      |
 | `ConflictError`                    | 409 — a key or external id is taken                                                      |
-| `IdempotencyConflictError`         | 409 — a `ConflictError` naming the event that key already recorded, on `existingEventId` |
 | `InvalidRequestError`              | 422 — a field failed validation                                                          |
 | `CycleChangeRequiresResetError`    | 422 — an `InvalidRequestError`: the two plans' cycles differ, so use `restart`           |
+| `InvalidIdempotencyKeyError`       | 422 — an `InvalidRequestError`: the key was not a UUIDv7                                 |
+| `TooLateError`                     | 422 — an `InvalidRequestError`: the key is over an hour from the engine's clock, which it carries on `serverTime`. Nothing was recorded |
 | `RateLimitError`                   | 429                                                                                      |
 | `ServerError`                      | 5xx                                                                                      |
 | `ConnectionError` / `TimeoutError` | the request never got an answer                                                          |
@@ -405,7 +441,8 @@ because a retried create could produce a second row.
 SDK fixes that key **before** the retry loop starts: every attempt of one call
 names the same logical event, so the engine replays it instead of counting the
 work twice. If you retry `track` yourself, pass your own `idempotency_key` and
-keep it the same across attempts for exactly that reason.
+keep it the same across attempts for exactly that reason — and do it inside
+the hour the engine holds that key for.
 
 ## Types
 
@@ -481,11 +518,12 @@ It asserts the whole lifecycle of a customer, a meter and a plan; that a plan's
 allowances become real entitlement a `check` can see, with the recurring cap
 and the minted bonus summed into `available`; that tracked usage takes exactly
 that much away, that a replay takes nothing, and that a reused key naming a
-different event is refused; that a scheduled plan change is dated ahead and
-reads as `pending`, that cancelling it supersedes it, that a `restart`
-re-anchors the customer, and that two plans on different cycles refuse a
-scheduled change; that soft deletes and archiving behave as
-documented; that duplicates really answer
+different event is refused; that a rate limit set on a meter comes back on
+every `check` as a live window, and refuses with the allowance untouched; that
+a scheduled plan change is dated ahead and reads as `pending`, that cancelling
+it supersedes it, that a `restart` re-anchors the customer, and that two plans
+on different cycles refuse a scheduled change; that soft deletes and archiving
+behave as documented; that duplicates really answer
 `409 customer_external_id_taken` / `409 meter_key_taken`; and — via
 `Record<keyof T, true>` field maps — that the engine's fields still match the
 SDK's types exactly, in both directions.

package/dist/index.cjs

@@ -29,17 +29,18 @@ var NotFoundError = class extends APIError {
 };
 var ConflictError = class extends APIError {
 };
-var IdempotencyConflictError = class extends ConflictError {
-  /** The event that key already recorded. Undefined only if the engine sent a
-   * body this could not be read out of. */
-  existingEventId;
+var InvalidRequestError = class extends APIError {
+};
+var InvalidIdempotencyKeyError = class extends InvalidRequestError {
+};
+var TooLateError = class extends InvalidRequestError {
+  /** The engine's clock when it refused. */
+  serverTime;
   constructor(args) {
     super(args);
-    this.existingEventId = existingEventId(args.body);
+    this.serverTime = serverTime(args.body);
   }
 };
-var InvalidRequestError = class extends APIError {
-};
 var CycleChangeRequiresResetError = class extends InvalidRequestError {
 };
 var RateLimitError = class extends APIError {
@@ -65,21 +66,32 @@ function errorFromResponse(args) {
     case 404:
       return new NotFoundError(args);
     case 409:
-      return args.code === "idempotency_conflict" ? new IdempotencyConflictError(args) : new ConflictError(args);
+      return new ConflictError(args);
     case 422:
-      return args.code === "cycle_change_requires_reset" ? new CycleChangeRequiresResetError(args) : new InvalidRequestError(args);
+      switch (args.code) {
+        case "cycle_change_requires_reset":
+          return new CycleChangeRequiresResetError(args);
+        case "invalid_idempotency_key":
+          return new InvalidIdempotencyKeyError(args);
+        case "too_late":
+          return new TooLateError(args);
+        default:
+          return new InvalidRequestError(args);
+      }
     case 429:
       return new RateLimitError(args);
     default:
       return args.status >= 500 ? new ServerError(args) : new APIError(args);
   }
 }
-function existingEventId(body) {
+function serverTime(body) {
   if (typeof body !== "object" || body === null) return void 0;
   const error = body.error;
   if (typeof error !== "object" || error === null) return void 0;
-  const id = error.existing_event_id;
-  return typeof id === "string" ? id : void 0;
+  const at = error.server_time;
+  if (typeof at !== "string") return void 0;
+  const parsed = new Date(at);
+  return Number.isNaN(parsed.getTime()) ? void 0 : parsed;
 }
 
 // src/client.ts
@@ -93,6 +105,21 @@ var Client = class {
   #timeout;
   #maxRetries;
   #fetch;
+  /**
+   * How far the engine's clock is ahead of this machine's, in milliseconds.
+   * Idempotency keys are minted here and the engine refuses one dated more
+   * than an hour from its own clock, so without this a device with a wrong
+   * clock would fail every call forever.
+   */
+  #clockOffset = 0;
+  /** The engine's clock, as well as this client knows it. */
+  now() {
+    return Date.now() + this.#clockOffset;
+  }
+  /** Off by up to one round trip, which a window in hours does not notice. */
+  observeServerTime(at) {
+    this.#clockOffset = at.getTime() - Date.now();
+  }
   constructor(options) {
     if (!options.apiKey) {
       throw new MeterbaseError(
@@ -637,6 +664,12 @@ var Meterbase = class {
    *
    * This is the gate, and the only call that ever refuses. Run it before the
    * work; record the work with `track` afterwards.
+   *
+   * Two gates answer it, and `allowed` needs both: the customer's capacity has
+   * to cover the quantity, and every rate-limit window in force has to admit
+   * it. `reason` names the one that said no. `rate_limits` reports each window
+   * whether or not it refused, so a caller can ease off as its headroom closes
+   * instead of discovering the ceiling by hitting it.
    */
   check(params, options) {
     return this.#client.request({
@@ -652,25 +685,42 @@ var Meterbase = class {
    * customer's capacity is recorded, drives `available` to 0, and the next
    * `check` says no. The answer is a receipt, not a verdict.
    *
-   * `idempotency_key` is generated when omitted, so retrying this call — the
-   * SDK's own retries included — replays the original rather than counting
-   * the same work twice.
+   * `idempotency_key` is a UUIDv7, generated when omitted, so retrying this
+   * call — the SDK's own retries included — replays the original rather than
+   * counting the same work twice. The engine keeps that claim for an hour,
+   * which is how long a retry stays recognisable.
    */
   // `async` so that generating the key cannot throw synchronously out of a
   // method that otherwise only ever rejects: one call, one way to fail.
   async track(params, options) {
-    return this.#client.request({
+    const send = (key2) => this.#client.request({
       ...options,
       method: "POST",
       path: "/v1/usage/track",
-      // Fixed here, once, before the retry loop is entered: every attempt of
-      // this call carries the same key, which is what makes replaying it safe.
-      body: {
-        ...params,
-        idempotency_key: params.idempotency_key ?? idempotencyKey()
-      },
+      // Fixed before the retry loop is entered: every attempt of this call
+      // carries the same key, which is what makes replaying it safe.
+      body: { ...params, idempotency_key: key2 },
       idempotent: true
     });
+    if (params.idempotency_key !== void 0) {
+      return send(params.idempotency_key);
+    }
+    const key = idempotencyKey(this.#client.now());
+    const startedAt = Date.now();
+    try {
+      return await send(key);
+    } catch (error) {
+      if (!(error instanceof TooLateError) || error.serverTime === void 0) {
+        throw error;
+      }
+      const elapsed = Date.now() - startedAt;
+      const serverAtStart = error.serverTime.getTime() - elapsed;
+      if (Math.abs(serverAtStart - mintedAtMs(key)) <= IDEMPOTENCY_WINDOW_MS) {
+        throw error;
+      }
+      this.#client.observeServerTime(error.serverTime);
+      return await send(idempotencyKey(this.#client.now()));
+    }
   }
   /** Reports which workspace this key acts for. */
   whoami(options) {
@@ -681,18 +731,37 @@ var Meterbase = class {
     });
   }
 };
-function idempotencyKey() {
+var IDEMPOTENCY_WINDOW_MS = 60 * 60 * 1e3;
+function mintedAtMs(key) {
+  return Number.parseInt(key.replace(/-/g, "").slice(0, 12), 16);
+}
+function idempotencyKey(atMs) {
   const webcrypto = globalThis.crypto;
-  if (typeof webcrypto?.randomUUID === "function") {
-    return webcrypto.randomUUID();
-  }
-  if (typeof webcrypto?.getRandomValues === "function") {
-    const bytes = webcrypto.getRandomValues(new Uint8Array(16));
-    return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+  if (typeof webcrypto?.getRandomValues !== "function") {
+    throw new MeterbaseError(
+      "No crypto to generate an idempotency key with: pass `idempotency_key` yourself (a UUIDv7), or run somewhere `crypto.getRandomValues` exists."
+    );
   }
-  throw new MeterbaseError(
-    "No crypto to generate an idempotency key with: pass `idempotency_key` yourself, or run somewhere `crypto.getRandomValues` exists."
-  );
+  const bytes = webcrypto.getRandomValues(new Uint8Array(16));
+  const ms = Math.max(0, Math.trunc(atMs));
+  const high = Math.floor(ms / 4294967296);
+  const low = ms >>> 0;
+  bytes[0] = high >>> 8 & 255;
+  bytes[1] = high & 255;
+  bytes[2] = low >>> 24 & 255;
+  bytes[3] = low >>> 16 & 255;
+  bytes[4] = low >>> 8 & 255;
+  bytes[5] = low & 255;
+  bytes[6] = bytes[6] & 15 | 112;
+  bytes[8] = bytes[8] & 63 | 128;
+  const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+  return [
+    hex.slice(0, 8),
+    hex.slice(8, 12),
+    hex.slice(12, 16),
+    hex.slice(16, 20),
+    hex.slice(20)
+  ].join("-");
 }
 
 exports.APIError = APIError;
@@ -700,7 +769,7 @@ exports.AuthenticationError = AuthenticationError;
 exports.ConflictError = ConflictError;
 exports.ConnectionError = ConnectionError;
 exports.CycleChangeRequiresResetError = CycleChangeRequiresResetError;
-exports.IdempotencyConflictError = IdempotencyConflictError;
+exports.InvalidIdempotencyKeyError = InvalidIdempotencyKeyError;
 exports.InvalidRequestError = InvalidRequestError;
 exports.Meterbase = Meterbase;
 exports.MeterbaseError = MeterbaseError;
@@ -709,6 +778,7 @@ exports.PermissionDeniedError = PermissionDeniedError;
 exports.RateLimitError = RateLimitError;
 exports.ServerError = ServerError;
 exports.TimeoutError = TimeoutError;
+exports.TooLateError = TooLateError;
 exports.errorFromResponse = errorFromResponse;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/client.ts","../src/resources/customer-allowances.ts","../src/resources/customer-plan.ts","../src/resources/customers.ts","../src/resources/meters.ts","../src/resources/plans.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["// Every failure is a MeterbaseError, so a caller can catch one type and still\n// switch on the specific one. `code` is stable; `message` may change.\n\nexport class MeterbaseError extends Error {\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options)\n    this.name = new.target.name\n  }\n}\n\nexport class APIError extends MeterbaseError {\n  readonly status: number\n  readonly code: string\n  /** From `X-Request-Id`, when the engine sends one. */\n  readonly requestId: string | undefined\n  readonly body: unknown\n\n  constructor(args: {\n    status: number\n    code: string\n    message: string\n    requestId?: string | undefined\n    body?: unknown\n  }) {\n    super(args.message)\n    this.status = args.status\n    this.code = args.code\n    this.requestId = args.requestId\n    this.body = args.body\n  }\n}\n\nexport class AuthenticationError extends APIError {}\nexport class PermissionDeniedError extends APIError {}\nexport class NotFoundError extends APIError {}\nexport class ConflictError extends APIError {}\n\n/**\n * `409 idempotency_conflict`: the key is in use for a different meter or\n * quantity. A caller told their key is taken asks what it recorded next, so\n * the engine names the original and this carries it.\n *\n * A `ConflictError` still, so `catch (e) { if (e instanceof ConflictError) }`\n * keeps working.\n */\nexport class IdempotencyConflictError extends ConflictError {\n  /** The event that key already recorded. Undefined only if the engine sent a\n   * body this could not be read out of. */\n  readonly existingEventId: string | undefined\n\n  constructor(args: ConstructorParameters<typeof APIError>[0]) {\n    super(args)\n    this.existingEventId = existingEventId(args.body)\n  }\n}\n\nexport class InvalidRequestError extends APIError {}\n\n/**\n * `422 cycle_change_requires_reset`: the two plans measure different cycles,\n * so a `next_cycle` change has no shared boundary to wait for and a `prorate`\n * no shared period to weight. The move is `customers.plan.restart`, which\n * closes the current period and opens a fresh one on the new cycle — or\n * `changeNow` with the default `reconciliation: \"none\"` to keep the period\n * that is running. The engine's `message` says as much.\n *\n * An `InvalidRequestError` still, so an existing `catch` keeps working.\n */\nexport class CycleChangeRequiresResetError extends InvalidRequestError {}\nexport class RateLimitError extends APIError {\n  /** Seconds to wait, from `Retry-After`, when the engine sends one. */\n  readonly retryAfter: number | undefined\n\n  constructor(\n    args: ConstructorParameters<typeof APIError>[0] & {\n      retryAfter?: number | undefined\n    },\n  ) {\n    super(args)\n    this.retryAfter = args.retryAfter\n  }\n}\nexport class ServerError extends APIError {}\n\n// The request never produced an answer: DNS, TLS, a reset, an abort.\nexport class ConnectionError extends MeterbaseError {}\nexport class TimeoutError extends ConnectionError {}\n\nexport function errorFromResponse(args: {\n  status: number\n  code: string\n  message: string\n  requestId?: string | undefined\n  retryAfter?: number | undefined\n  body?: unknown\n}): APIError {\n  switch (args.status) {\n    case 401:\n      return new AuthenticationError(args)\n    case 403:\n      return new PermissionDeniedError(args)\n    case 404:\n      return new NotFoundError(args)\n    case 409:\n      return args.code === \"idempotency_conflict\"\n        ? new IdempotencyConflictError(args)\n        : new ConflictError(args)\n    case 422:\n      return args.code === \"cycle_change_requires_reset\"\n        ? new CycleChangeRequiresResetError(args)\n        : new InvalidRequestError(args)\n    case 429:\n      return new RateLimitError(args)\n    default:\n      return args.status >= 500 ? new ServerError(args) : new APIError(args)\n  }\n}\n\n/** The engine carries it beside `code` and `message`, inside `error`. */\nfunction existingEventId(body: unknown): string | undefined {\n  if (typeof body !== \"object\" || body === null) return undefined\n\n  const error = (body as { error?: unknown }).error\n  if (typeof error !== \"object\" || error === null) return undefined\n\n  const id = (error as { existing_event_id?: unknown }).existing_event_id\n  return typeof id === \"string\" ? id : undefined\n}\n","// Everything goes through `request`, so authentication, timeouts, retries and\n// error mapping are defined once.\n\nimport {\n  ConnectionError,\n  errorFromResponse,\n  MeterbaseError,\n  TimeoutError,\n} from \"./errors.js\"\n\nexport type MeterbaseOptions = {\n  /** A secret key. It names its own workspace. */\n  apiKey: string\n  /** Defaults to the hosted engine. */\n  baseUrl?: string\n  /** Per attempt, not per call. */\n  timeout?: number\n  maxRetries?: number\n  fetch?: typeof globalThis.fetch\n}\n\nexport type RequestOptions = {\n  signal?: AbortSignal\n  timeout?: number\n  maxRetries?: number\n}\n\ntype HttpMethod = \"GET\" | \"POST\" | \"PATCH\" | \"DELETE\"\n\ntype Request = RequestOptions & {\n  method: HttpMethod\n  path: string\n  query?: Record<string, string | number | boolean | undefined>\n  body?: unknown\n  /**\n   * Replay this call even though its method is not safe. Only a route that\n   * carries an idempotency key may set it, and the key has to be fixed before\n   * `request` is called — the loop re-sends one body, so a key generated\n   * per attempt would count the same usage twice.\n   */\n  idempotent?: boolean\n}\n\nconst DEFAULT_BASE_URL = \"https://api.meterbase.tech\"\nconst DEFAULT_TIMEOUT = 10_000\nconst DEFAULT_MAX_RETRIES = 2\nconst MAX_BACKOFF = 8_000\n\nexport class Client {\n  readonly #apiKey: string\n  readonly #baseUrl: string\n  readonly #timeout: number\n  readonly #maxRetries: number\n  readonly #fetch: typeof globalThis.fetch\n\n  constructor(options: MeterbaseOptions) {\n    if (!options.apiKey) {\n      throw new MeterbaseError(\n        \"An API key is required: new Meterbase({ apiKey: 'mb_sk_live_…' }).\",\n      )\n    }\n\n    this.#apiKey = options.apiKey\n    this.#baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\")\n    this.#timeout = options.timeout ?? DEFAULT_TIMEOUT\n    this.#maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES\n    this.#fetch = options.fetch ?? globalThis.fetch\n\n    if (typeof this.#fetch !== \"function\") {\n      throw new MeterbaseError(\n        \"No fetch implementation: pass one as `fetch`, or run on Node 18+.\",\n      )\n    }\n  }\n\n  async request<T>(req: Request): Promise<T> {\n    const maxRetries = req.maxRetries ?? this.#maxRetries\n    // Safe methods, plus the routes that carry an idempotency key and say so.\n    // Any other POST or PATCH could create a second row on a replay.\n    const retryable =\n      req.method === \"GET\" || req.method === \"DELETE\" || req.idempotent === true\n\n    let lastError: unknown\n    for (let attempt = 0; attempt <= maxRetries; attempt++) {\n      if (attempt > 0) await sleep(backoff(attempt, lastError))\n\n      try {\n        const response = await this.#send(req)\n\n        if (response.ok) return (await parseBody(response)) as T\n\n        const error = await errorFrom(response)\n        if (retryable && attempt < maxRetries && shouldRetry(response.status)) {\n          lastError = error\n          continue\n        }\n        throw error\n      } catch (cause) {\n        if (\n          cause instanceof MeterbaseError &&\n          !(cause instanceof ConnectionError)\n        ) {\n          throw cause\n        }\n        // A connection failure proves nothing about whether the server acted,\n        // so it is replayed under the same idempotency rule.\n        if (!retryable || attempt >= maxRetries) throw cause\n        lastError = cause\n      }\n    }\n\n    /* c8 ignore next 2 -- the loop always returns or throws */\n    throw lastError\n  }\n\n  async #send(req: Request): Promise<Response> {\n    const url = new URL(this.#baseUrl + req.path)\n    for (const [key, value] of Object.entries(req.query ?? {})) {\n      if (value !== undefined) url.searchParams.set(key, String(value))\n    }\n\n    const headers: Record<string, string> = {\n      authorization: `Bearer ${this.#apiKey}`,\n      accept: \"application/json\",\n    }\n    if (req.body !== undefined) headers[\"content-type\"] = \"application/json\"\n\n    const timeout = req.timeout ?? this.#timeout\n    const controller = new AbortController()\n    const onAbort = () => controller.abort(req.signal?.reason)\n    req.signal?.addEventListener(\"abort\", onAbort, { once: true })\n\n    let timedOut = false\n    const timer = setTimeout(() => {\n      timedOut = true\n      controller.abort()\n    }, timeout)\n\n    try {\n      return await this.#fetch(url, {\n        method: req.method,\n        headers,\n        body: req.body === undefined ? undefined : JSON.stringify(req.body),\n        signal: controller.signal,\n      })\n    } catch (cause) {\n      if (timedOut) {\n        throw new TimeoutError(`Request timed out after ${timeout}ms.`, {\n          cause,\n        })\n      }\n      // A caller's own abort is theirs to handle, not ours to reclassify.\n      if (req.signal?.aborted) throw cause\n      throw new ConnectionError(`Could not reach ${url.origin}.`, { cause })\n    } finally {\n      clearTimeout(timer)\n      req.signal?.removeEventListener(\"abort\", onAbort)\n    }\n  }\n}\n\nfunction shouldRetry(status: number): boolean {\n  return status === 408 || status === 429 || status >= 500\n}\n\n/** Exponential backoff with full jitter, unless the engine named a delay. */\nfunction backoff(attempt: number, lastError: unknown): number {\n  const retryAfter =\n    lastError && typeof lastError === \"object\" && \"retryAfter\" in lastError\n      ? (lastError as { retryAfter?: number }).retryAfter\n      : undefined\n  if (retryAfter !== undefined) return Math.min(retryAfter * 1000, MAX_BACKOFF)\n\n  const ceiling = Math.min(500 * 2 ** (attempt - 1), MAX_BACKOFF)\n  return Math.random() * ceiling\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n\nasync function parseBody(response: Response): Promise<unknown> {\n  if (response.status === 204) return undefined\n\n  const text = await response.text()\n  if (text === \"\") return undefined\n\n  try {\n    return JSON.parse(text)\n  } catch (cause) {\n    throw new MeterbaseError(\"The engine returned a body that is not JSON.\", {\n      cause,\n    })\n  }\n}\n\nasync function errorFrom(response: Response) {\n  const body = await response.text()\n  const parsed = parseErrorBody(body)\n  const retryAfterHeader = response.headers.get(\"retry-after\")\n  const retryAfter = retryAfterHeader ? Number(retryAfterHeader) : undefined\n\n  return errorFromResponse({\n    status: response.status,\n    code: parsed?.code ?? `http_${response.status}`,\n    message: parsed?.message ?? `The engine responded ${response.status}.`,\n    requestId: response.headers.get(\"x-request-id\") ?? undefined,\n    retryAfter:\n      retryAfter !== undefined && Number.isFinite(retryAfter)\n        ? retryAfter\n        : undefined,\n    body: body === \"\" ? undefined : (safeParse(body) ?? body),\n  })\n}\n\nfunction parseErrorBody(body: string) {\n  const parsed = safeParse(body) as\n    { error?: { code?: string; message?: string } } | undefined\n  const error = parsed?.error\n  if (!error?.code || !error.message) return undefined\n\n  return { code: error.code, message: error.message }\n}\n\nfunction safeParse(body: string): unknown {\n  try {\n    return JSON.parse(body)\n  } catch {\n    return undefined\n  }\n}\n","import type { Client, RequestOptions } from \"../client.js\"\nimport type {\n  Allowance,\n  AllowanceGrantParams,\n  AllowanceListParams,\n  List,\n} from \"../types.js\"\n\n/**\n * Capacity handed to one customer on top of their plan. A grant with\n * `source: \"plan\"` is the engine's own, minted when a plan is assigned, and\n * cannot be created here.\n */\nexport class CustomerAllowances {\n  readonly #client: Client\n\n  constructor(client: Client) {\n    this.#client = client\n  }\n\n  grant(\n    customerId: string,\n    params: AllowanceGrantParams,\n    options?: RequestOptions,\n  ): Promise<Allowance> {\n    return this.#client.request({\n      ...options,\n      method: \"POST\",\n      path: `/v1/customers/${encodeURIComponent(customerId)}/allowances`,\n      body: params,\n    })\n  }\n\n  /** Open grants only, unless `include_closed`. */\n  list(\n    customerId: string,\n    params: AllowanceListParams = {},\n    options?: RequestOptions,\n  ): Promise<List<Allowance>> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: `/v1/customers/${encodeURIComponent(customerId)}/allowances`,\n      query: {\n        meter_id: params.meter_id,\n        include_closed: params.include_closed,\n      },\n    })\n  }\n\n  retrieve(\n    customerId: string,\n    allowanceId: string,\n    options?: RequestOptions,\n  ): Promise<Allowance> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: `/v1/customers/${encodeURIComponent(customerId)}/allowances/${encodeURIComponent(allowanceId)}`,\n    })\n  }\n\n  /** Withdraws what is left without erasing what was consumed. Idempotent. */\n  revoke(\n    customerId: string,\n    allowanceId: string,\n    options?: RequestOptions,\n  ): Promise<Allowance> {\n    return this.#client.request({\n      ...options,\n      method: \"DELETE\",\n      path: `/v1/customers/${encodeURIComponent(customerId)}/allowances/${encodeURIComponent(allowanceId)}`,\n    })\n  }\n}\n","import type { Client, RequestOptions } from \"../client.js\"\nimport type {\n  AssignPlanParams,\n  Assignment,\n  List,\n  PlanChangeNowParams,\n  PlanChangeParams,\n  PlanMoveParams,\n} from \"../types.js\"\nimport { NotFoundError } from \"../errors.js\"\n\n/**\n * Which plan a customer holds. The history is append-only: there is no patch\n * and no delete, and moving a customer to a different plan is the same call as\n * their first.\n *\n * `assign` is that call, mirroring the wire. The rest name the four moves a\n * caller actually makes — later, now, now-and-start-over, and never mind — so\n * that picking one does not mean knowing what `effective` and `reconciliation`\n * do to a half-used period.\n */\nexport class CustomerPlan {\n  readonly #client: Client\n\n  constructor(client: Client) {\n    this.#client = client\n  }\n\n  /**\n   * Put a customer on a plan. This is the wire call, and the only one that\n   * takes `cycle_anchor` — a first assignment's one chance to put their\n   * periods on a date they already have.\n   *\n   * Returns the instruction as recorded, which is not always as asked: a first\n   * plan is recorded `immediate` whatever `effective` said.\n   */\n  assign(\n    customerId: string,\n    params: AssignPlanParams,\n    options?: RequestOptions,\n  ): Promise<Assignment> {\n    return this.#client.request({\n      ...options,\n      method: \"POST\",\n      path: `/v1/customers/${encodeURIComponent(customerId)}/plan`,\n      body: params,\n    })\n  }\n\n  /**\n   * Move a customer to a different plan, with both knobs in the open.\n   * `effective` defaults to `next_cycle`; `reconciliation` applies only to an\n   * `immediate` change and defaults to `none`.\n   *\n   * Reach for `changeAtNextCycle`, `changeNow` or `restart` when one of them\n   * says what you mean — this is the form to fall back to when the two are\n   * chosen at runtime.\n   */\n  change(\n    customerId: string,\n    params: PlanChangeParams,\n    options?: RequestOptions,\n  ): Promise<Assignment> {\n    const { plan, ...rest } = params\n\n    return this.assign(customerId, { plan_id: plan, ...rest }, options)\n  }\n\n  /**\n   * Schedule the move for the end of the period they are in: they keep the\n   * plan they are paying for until it runs out, and the new one starts at\n   * their next boundary. Nothing is pro-rated, because nothing is split.\n   *\n   * Two plans on different cycles share no boundary, and this answers\n   * `CycleChangeRequiresResetError` — use `restart` for that move.\n   */\n  changeAtNextCycle(\n    customerId: string,\n    params: PlanMoveParams,\n    options?: RequestOptions,\n  ): Promise<Assignment> {\n    return this.change(\n      customerId,\n      { plan: params.plan, effective: \"next_cycle\" },\n      options,\n    )\n  }\n\n  /**\n   * Move them now, inside the period already running. Their renewal day does\n   * not move; what changes is this period's cap, and `reconciliation` says\n   * how:\n   *\n   * - `none` (the default) — the new plan's amount governs the whole period.\n   *   Usage already spent still counts, so a downgrade can deny until the\n   *   period ends.\n   * - `prorate` — each plan's amount weighted by the fraction of the period it\n   *   was held for. Refused between plans on different cycles, which share no\n   *   period to weight.\n   *\n   * To have the period itself start over instead, use `restart`.\n   */\n  changeNow(\n    customerId: string,\n    params: PlanChangeNowParams,\n    options?: RequestOptions,\n  ): Promise<Assignment> {\n    return this.change(\n      customerId,\n      { ...params, effective: \"immediate\" },\n      options,\n    )\n  }\n\n  /**\n   * Move them now and start a fresh period today: the period they were in\n   * closes where the change lands, keeping the usage it had, and the new\n   * plan's full amount opens immediately.\n   *\n   * This moves the customer's anchor, so their renewal day becomes today. It\n   * is the move for a customer starting over — a new contract, a re-signup —\n   * and the only one that can take a customer between plans whose cycles\n   * differ.\n   */\n  restart(\n    customerId: string,\n    params: PlanMoveParams,\n    options?: RequestOptions,\n  ): Promise<Assignment> {\n    return this.change(\n      customerId,\n      { plan: params.plan, effective: \"immediate\", reconciliation: \"reset\" },\n      options,\n    )\n  }\n\n  /**\n   * Call off a change that has not landed yet, leaving the customer on the\n   * plan they hold. Naming the plan already held is what supersedes a pending\n   * instruction, so this reads the plan in force and names it back.\n   *\n   * Returns the assignment still in force, or `null` for a customer holding no\n   * plan — who can have nothing pending, since a first assignment always lands\n   * at once.\n   */\n  async cancelScheduledChange(\n    customerId: string,\n    options?: RequestOptions,\n  ): Promise<Assignment | null> {\n    const current = await this.retrieve(customerId, options)\n    if (current === null) return null\n\n    return this.assign(customerId, { plan_id: current.plan_id }, options)\n  }\n\n  /**\n   * The plan in force now, which is not always the newest instruction: a\n   * change dated ahead does not govern yet.\n   *\n   * `null` when the customer holds no plan. That is a default deny rather than\n   * a failure — they are entitled to nothing — so it is an answer here and not\n   * a thrown `NotFoundError`. A customer who does not exist at all still\n   * throws one.\n   */\n  async retrieve(\n    customerId: string,\n    options?: RequestOptions,\n  ): Promise<Assignment | null> {\n    try {\n      return await this.#client.request<Assignment>({\n        ...options,\n        method: \"GET\",\n        path: `/v1/customers/${encodeURIComponent(customerId)}/plan`,\n      })\n    } catch (error) {\n      if (error instanceof NotFoundError && error.code === \"no_plan_assigned\") {\n        return null\n      }\n      throw error\n    }\n  }\n\n  /**\n   * The change waiting to land, or `null` when none is. At most one is ever\n   * live: a newer instruction supersedes the one before it.\n   *\n   * Read against the assignment in force rather than against the local clock,\n   * so a change landing seconds from now is not reported as already governing.\n   */\n  async pending(\n    customerId: string,\n    options?: RequestOptions,\n  ): Promise<Assignment | null> {\n    const [current, { data }] = await Promise.all([\n      this.retrieve(customerId, options),\n      this.history(customerId, options),\n    ])\n\n    const inForce =\n      current === null ? -Infinity : Date.parse(current.effective_at)\n\n    return (\n      data.find(\n        (a) => a.superseded_at === null && Date.parse(a.effective_at) > inForce,\n      ) ?? null\n    )\n  }\n\n  /** Every instruction, superseded ones included: it is the whole trail. */\n  history(\n    customerId: string,\n    options?: RequestOptions,\n  ): Promise<List<Assignment>> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: `/v1/customers/${encodeURIComponent(customerId)}/plan/history`,\n    })\n  }\n}\n","import type { Client, RequestOptions } from \"../client.js\"\nimport type {\n  Customer,\n  CustomerCreateParams,\n  CustomerListParams,\n  CustomerUpdateParams,\n  CustomerWithPlan,\n  List,\n} from \"../types.js\"\nimport { CustomerAllowances } from \"./customer-allowances.js\"\nimport { CustomerPlan } from \"./customer-plan.js\"\n\nexport class Customers {\n  /** The plan they hold, and the trail of instructions that got them there. */\n  readonly plan: CustomerPlan\n  /** Grants, which sit on top of whatever the plan gives. */\n  readonly allowances: CustomerAllowances\n\n  readonly #client: Client\n\n  constructor(client: Client) {\n    this.#client = client\n    this.plan = new CustomerPlan(client)\n    this.allowances = new CustomerAllowances(client)\n  }\n\n  create(\n    params: CustomerCreateParams,\n    options?: RequestOptions,\n  ): Promise<Customer> {\n    return this.#client.request({\n      ...options,\n      method: \"POST\",\n      path: \"/v1/customers\",\n      body: params,\n    })\n  }\n\n  /** Lean: a listing does not embed the plan. Read one customer for that. */\n  list(\n    params: CustomerListParams = {},\n    options?: RequestOptions,\n  ): Promise<List<Customer>> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: \"/v1/customers\",\n      query: { include_deleted: params.include_deleted },\n    })\n  }\n\n  /**\n   * One customer, with the plan they hold. `plan` is the one in force now and\n   * `pending_plan` the change waiting to land, each `null` when there is\n   * none — so knowing what a customer is on costs no second request.\n   */\n  retrieve(id: string, options?: RequestOptions): Promise<CustomerWithPlan> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: `/v1/customers/${encodeURIComponent(id)}`,\n    })\n  }\n\n  /**\n   * Resolves the tenant's own identifier, or null, embedding the plan the way\n   * `retrieve` does. The engine answers this as a filtered list, so a miss is\n   * an empty collection rather than a 404.\n   */\n  async retrieveByExternalId(\n    externalId: string,\n    options?: RequestOptions,\n  ): Promise<CustomerWithPlan | null> {\n    const { data } = await this.#client.request<List<CustomerWithPlan>>({\n      ...options,\n      method: \"GET\",\n      path: \"/v1/customers\",\n      query: { external_id: externalId },\n    })\n\n    return data[0] ?? null\n  }\n\n  update(\n    id: string,\n    params: CustomerUpdateParams,\n    options?: RequestOptions,\n  ): Promise<Customer> {\n    return this.#client.request({\n      ...options,\n      method: \"PATCH\",\n      path: `/v1/customers/${encodeURIComponent(id)}`,\n      body: params,\n    })\n  }\n\n  /** Soft delete: usage and assignments keep referencing the customer. */\n  delete(id: string, options?: RequestOptions): Promise<Customer> {\n    return this.#client.request({\n      ...options,\n      method: \"DELETE\",\n      path: `/v1/customers/${encodeURIComponent(id)}`,\n    })\n  }\n}\n","import type { Client, RequestOptions } from \"../client.js\"\nimport type {\n  List,\n  Meter,\n  MeterCreateParams,\n  MeterListParams,\n  MeterUpdateParams,\n} from \"../types.js\"\n\nexport class Meters {\n  readonly #client: Client\n\n  constructor(client: Client) {\n    this.#client = client\n  }\n\n  create(params: MeterCreateParams, options?: RequestOptions): Promise<Meter> {\n    return this.#client.request({\n      ...options,\n      method: \"POST\",\n      path: \"/v1/meters\",\n      body: params,\n    })\n  }\n\n  list(\n    params: MeterListParams = {},\n    options?: RequestOptions,\n  ): Promise<List<Meter>> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: \"/v1/meters\",\n      query: { include_archived: params.include_archived },\n    })\n  }\n\n  retrieve(id: string, options?: RequestOptions): Promise<Meter> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: `/v1/meters/${encodeURIComponent(id)}`,\n    })\n  }\n\n  update(\n    id: string,\n    params: MeterUpdateParams,\n    options?: RequestOptions,\n  ): Promise<Meter> {\n    return this.#client.request({\n      ...options,\n      method: \"PATCH\",\n      path: `/v1/meters/${encodeURIComponent(id)}`,\n      body: params,\n    })\n  }\n\n  /** Soft delete: plans and usage keep referencing the meter. Idempotent. */\n  archive(id: string, options?: RequestOptions): Promise<Meter> {\n    return this.#client.request({\n      ...options,\n      method: \"DELETE\",\n      path: `/v1/meters/${encodeURIComponent(id)}`,\n    })\n  }\n}\n","import type { Client, RequestOptions } from \"../client.js\"\nimport type {\n  List,\n  Plan,\n  PlanAllowance,\n  PlanAllowanceListParams,\n  PlanAllowanceSetParams,\n  PlanCreateParams,\n  PlanListParams,\n  PlanUpdateParams,\n} from \"../types.js\"\n\n/**\n * A plan's entitlement, versioned. There is no update and no delete: an edit\n * appends the next version, so which amount applied when stays derivable.\n */\nexport class PlanAllowances {\n  readonly #client: Client\n\n  constructor(client: Client) {\n    this.#client = client\n  }\n\n  set(\n    planId: string,\n    params: PlanAllowanceSetParams,\n    options?: RequestOptions,\n  ): Promise<PlanAllowance> {\n    return this.#client.request({\n      ...options,\n      method: \"POST\",\n      path: `/v1/plans/${encodeURIComponent(planId)}/allowances`,\n      body: params,\n    })\n  }\n\n  /** Every version of every meter, newest first — history, not just current. */\n  list(\n    planId: string,\n    params: PlanAllowanceListParams = {},\n    options?: RequestOptions,\n  ): Promise<List<PlanAllowance>> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: `/v1/plans/${encodeURIComponent(planId)}/allowances`,\n      query: { meter_id: params.meter_id },\n    })\n  }\n}\n\nexport class Plans {\n  readonly allowances: PlanAllowances\n\n  readonly #client: Client\n\n  constructor(client: Client) {\n    this.#client = client\n    this.allowances = new PlanAllowances(client)\n  }\n\n  /** A new plan grants nothing; attach entitlement with `allowances.set`. */\n  create(params: PlanCreateParams, options?: RequestOptions): Promise<Plan> {\n    return this.#client.request({\n      ...options,\n      method: \"POST\",\n      path: \"/v1/plans\",\n      body: params,\n    })\n  }\n\n  list(\n    params: PlanListParams = {},\n    options?: RequestOptions,\n  ): Promise<List<Plan>> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: \"/v1/plans\",\n      query: { include_archived: params.include_archived },\n    })\n  }\n\n  retrieve(id: string, options?: RequestOptions): Promise<Plan> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: `/v1/plans/${encodeURIComponent(id)}`,\n    })\n  }\n\n  update(\n    id: string,\n    params: PlanUpdateParams,\n    options?: RequestOptions,\n  ): Promise<Plan> {\n    return this.#client.request({\n      ...options,\n      method: \"PATCH\",\n      path: `/v1/plans/${encodeURIComponent(id)}`,\n      body: params,\n    })\n  }\n\n  /**\n   * Stops new assignments without withdrawing capacity from anyone already on\n   * the plan, which is why an archived plan still resolves by id. Idempotent.\n   */\n  archive(id: string, options?: RequestOptions): Promise<Plan> {\n    return this.#client.request({\n      ...options,\n      method: \"DELETE\",\n      path: `/v1/plans/${encodeURIComponent(id)}`,\n    })\n  }\n}\n","import { Client, type MeterbaseOptions, type RequestOptions } from \"./client.js\"\nimport { MeterbaseError } from \"./errors.js\"\nimport type { CustomerAllowances } from \"./resources/customer-allowances.js\"\nimport type { CustomerPlan } from \"./resources/customer-plan.js\"\nimport { Customers } from \"./resources/customers.js\"\nimport { Meters } from \"./resources/meters.js\"\nimport { Plans, type PlanAllowances } from \"./resources/plans.js\"\nimport type {\n  CheckParams,\n  CheckResult,\n  TrackParams,\n  TrackResult,\n  WhoAmI,\n} from \"./types.js\"\n\nexport class Meterbase {\n  readonly customers: Customers\n  readonly meters: Meters\n  readonly plans: Plans\n\n  readonly #client: Client\n\n  constructor(options: MeterbaseOptions) {\n    this.#client = new Client(options)\n    this.customers = new Customers(this.#client)\n    this.meters = new Meters(this.#client)\n    this.plans = new Plans(this.#client)\n  }\n\n  /**\n   * Asks whether a customer may consume `quantity` of a meter, named by the\n   * tenant's own external id and the meter's key. Absence of entitlement is\n   * not permission: a customer with no plan and no grant is denied.\n   *\n   * This is the gate, and the only call that ever refuses. Run it before the\n   * work; record the work with `track` afterwards.\n   */\n  check(params: CheckParams, options?: RequestOptions): Promise<CheckResult> {\n    return this.#client.request({\n      ...options,\n      method: \"POST\",\n      path: \"/v1/check\",\n      body: params,\n    })\n  }\n\n  /**\n   * Records usage that already happened — the tokens were spent, the image\n   * was generated — so it never refuses on capacity. A quantity beyond the\n   * customer's capacity is recorded, drives `available` to 0, and the next\n   * `check` says no. The answer is a receipt, not a verdict.\n   *\n   * `idempotency_key` is generated when omitted, so retrying this call — the\n   * SDK's own retries included — replays the original rather than counting\n   * the same work twice.\n   */\n  // `async` so that generating the key cannot throw synchronously out of a\n  // method that otherwise only ever rejects: one call, one way to fail.\n  async track(\n    params: TrackParams,\n    options?: RequestOptions,\n  ): Promise<TrackResult> {\n    return this.#client.request({\n      ...options,\n      method: \"POST\",\n      path: \"/v1/usage/track\",\n      // Fixed here, once, before the retry loop is entered: every attempt of\n      // this call carries the same key, which is what makes replaying it safe.\n      body: {\n        ...params,\n        idempotency_key: params.idempotency_key ?? idempotencyKey(),\n      },\n      idempotent: true,\n    })\n  }\n\n  /** Reports which workspace this key acts for. */\n  whoami(options?: RequestOptions): Promise<WhoAmI> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: \"/v1/whoami\",\n    })\n  }\n}\n\n// Type-only: none of them is constructible without the unexported Client.\nexport type {\n  CustomerAllowances,\n  CustomerPlan,\n  Customers,\n  MeterbaseOptions,\n  Meters,\n  PlanAllowances,\n  Plans,\n  RequestOptions,\n}\nexport * from \"./errors.js\"\nexport type * from \"./types.js\"\n\n/**\n * The engine requires a key, and a caller made to invent one on every call\n * eventually will not — which is the moment a retry counts twice.\n */\nfunction idempotencyKey(): string {\n  // Structurally, not as `Crypto`: that lib type is the DOM's, and this\n  // compiles without it so the SDK stays as portable as `fetch` is.\n  const webcrypto = globalThis.crypto as\n    | {\n        randomUUID?: () => string\n        getRandomValues?: (array: Uint8Array) => Uint8Array\n      }\n    | undefined\n\n  if (typeof webcrypto?.randomUUID === \"function\") {\n    return webcrypto.randomUUID()\n  }\n  // `randomUUID` needs a secure context; `getRandomValues` does not, so a\n  // page served over plain http still gets 128 random bits.\n  if (typeof webcrypto?.getRandomValues === \"function\") {\n    const bytes = webcrypto.getRandomValues(new Uint8Array(16))\n    return Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\")).join(\"\")\n  }\n\n  throw new MeterbaseError(\n    \"No crypto to generate an idempotency key with: pass `idempotency_key` \" +\n      \"yourself, or run somewhere `crypto.getRandomValues` exists.\",\n  )\n}\n"]}
+{"version":3,"sources":["../src/errors.ts","../src/client.ts","../src/resources/customer-allowances.ts","../src/resources/customer-plan.ts","../src/resources/customers.ts","../src/resources/meters.ts","../src/resources/plans.ts","../src/index.ts"],"names":["key"],"mappings":";;;AAGO,IAAM,cAAA,GAAN,cAA6B,KAAA,CAAM;AAAA,EACxC,WAAA,CAAY,SAAiB,OAAA,EAA+B;AAC1D,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA;AACtB,IAAA,IAAA,CAAK,OAAO,GAAA,CAAA,MAAA,CAAW,IAAA;AAAA,EACzB;AACF;AAEO,IAAM,QAAA,GAAN,cAAuB,cAAA,CAAe;AAAA,EAClC,MAAA;AAAA,EACA,IAAA;AAAA;AAAA,EAEA,SAAA;AAAA,EACA,IAAA;AAAA,EAET,YAAY,IAAA,EAMT;AACD,IAAA,KAAA,CAAM,KAAK,OAAO,CAAA;AAClB,IAAA,IAAA,CAAK,SAAS,IAAA,CAAK,MAAA;AACnB,IAAA,IAAA,CAAK,OAAO,IAAA,CAAK,IAAA;AACjB,IAAA,IAAA,CAAK,YAAY,IAAA,CAAK,SAAA;AACtB,IAAA,IAAA,CAAK,OAAO,IAAA,CAAK,IAAA;AAAA,EACnB;AACF;AAEO,IAAM,mBAAA,GAAN,cAAkC,QAAA,CAAS;AAAC;AAC5C,IAAM,qBAAA,GAAN,cAAoC,QAAA,CAAS;AAAC;AAC9C,IAAM,aAAA,GAAN,cAA4B,QAAA,CAAS;AAAC;AACtC,IAAM,aAAA,GAAN,cAA4B,QAAA,CAAS;AAAC;AAEtC,IAAM,mBAAA,GAAN,cAAkC,QAAA,CAAS;AAAC;AAO5C,IAAM,0BAAA,GAAN,cAAyC,mBAAA,CAAoB;AAAC;AAY9D,IAAM,YAAA,GAAN,cAA2B,mBAAA,CAAoB;AAAA;AAAA,EAE3C,UAAA;AAAA,EAET,YAAY,IAAA,EAAiD;AAC3D,IAAA,KAAA,CAAM,IAAI,CAAA;AACV,IAAA,IAAA,CAAK,UAAA,GAAa,UAAA,CAAW,IAAA,CAAK,IAAI,CAAA;AAAA,EACxC;AACF;AAYO,IAAM,6BAAA,GAAN,cAA4C,mBAAA,CAAoB;AAAC;AACjE,IAAM,cAAA,GAAN,cAA6B,QAAA,CAAS;AAAA;AAAA,EAElC,UAAA;AAAA,EAET,YACE,IAAA,EAGA;AACA,IAAA,KAAA,CAAM,IAAI,CAAA;AACV,IAAA,IAAA,CAAK,aAAa,IAAA,CAAK,UAAA;AAAA,EACzB;AACF;AACO,IAAM,WAAA,GAAN,cAA0B,QAAA,CAAS;AAAC;AAGpC,IAAM,eAAA,GAAN,cAA8B,cAAA,CAAe;AAAC;AAC9C,IAAM,YAAA,GAAN,cAA2B,eAAA,CAAgB;AAAC;AAE5C,SAAS,kBAAkB,IAAA,EAOrB;AACX,EAAA,QAAQ,KAAK,MAAA;AAAQ,IACnB,KAAK,GAAA;AACH,MAAA,OAAO,IAAI,oBAAoB,IAAI,CAAA;AAAA,IACrC,KAAK,GAAA;AACH,MAAA,OAAO,IAAI,sBAAsB,IAAI,CAAA;AAAA,IACvC,KAAK,GAAA;AACH,MAAA,OAAO,IAAI,cAAc,IAAI,CAAA;AAAA,IAC/B,KAAK,GAAA;AACH,MAAA,OAAO,IAAI,cAAc,IAAI,CAAA;AAAA,IAC/B,KAAK,GAAA;AACH,MAAA,QAAQ,KAAK,IAAA;AAAM,QACjB,KAAK,6BAAA;AACH,UAAA,OAAO,IAAI,8BAA8B,IAAI,CAAA;AAAA,QAC/C,KAAK,yBAAA;AACH,UAAA,OAAO,IAAI,2BAA2B,IAAI,CAAA;AAAA,QAC5C,KAAK,UAAA;AACH,UAAA,OAAO,IAAI,aAAa,IAAI,CAAA;AAAA,QAC9B;AACE,UAAA,OAAO,IAAI,oBAAoB,IAAI,CAAA;AAAA;AACvC,IACF,KAAK,GAAA;AACH,MAAA,OAAO,IAAI,eAAe,IAAI,CAAA;AAAA,IAChC;AACE,MAAA,OAAO,IAAA,CAAK,UAAU,GAAA,GAAM,IAAI,YAAY,IAAI,CAAA,GAAI,IAAI,QAAA,CAAS,IAAI,CAAA;AAAA;AAE3E;AAGA,SAAS,WAAW,IAAA,EAAiC;AACnD,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,IAAA,KAAS,MAAM,OAAO,MAAA;AAEtD,EAAA,MAAM,QAAS,IAAA,CAA6B,KAAA;AAC5C,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,MAAM,OAAO,MAAA;AAExD,EAAA,MAAM,KAAM,KAAA,CAAoC,WAAA;AAChD,EAAA,IAAI,OAAO,EAAA,KAAO,QAAA,EAAU,OAAO,MAAA;AAEnC,EAAA,MAAM,MAAA,GAAS,IAAI,IAAA,CAAK,EAAE,CAAA;AAC1B,EAAA,OAAO,OAAO,KAAA,CAAM,MAAA,CAAO,OAAA,EAAS,IAAI,MAAA,GAAY,MAAA;AACtD;;;ACpGA,IAAM,gBAAA,GAAmB,4BAAA;AACzB,IAAM,eAAA,GAAkB,GAAA;AACxB,IAAM,mBAAA,GAAsB,CAAA;AAC5B,IAAM,WAAA,GAAc,GAAA;AAEb,IAAM,SAAN,MAAa;AAAA,EACT,OAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA;AAAA,EACA,WAAA;AAAA,EACA,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQT,YAAA,GAAe,CAAA;AAAA;AAAA,EAGf,GAAA,GAAc;AACZ,IAAA,OAAO,IAAA,CAAK,GAAA,EAAI,GAAI,IAAA,CAAK,YAAA;AAAA,EAC3B;AAAA;AAAA,EAGA,kBAAkB,EAAA,EAAgB;AAChC,IAAA,IAAA,CAAK,YAAA,GAAe,EAAA,CAAG,OAAA,EAAQ,GAAI,KAAK,GAAA,EAAI;AAAA,EAC9C;AAAA,EAEA,YAAY,OAAA,EAA2B;AACrC,IAAA,IAAI,CAAC,QAAQ,MAAA,EAAQ;AACnB,MAAA,MAAM,IAAI,cAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,UAAU,OAAA,CAAQ,MAAA;AACvB,IAAA,IAAA,CAAK,YAAY,OAAA,CAAQ,OAAA,IAAW,gBAAA,EAAkB,OAAA,CAAQ,QAAQ,EAAE,CAAA;AACxE,IAAA,IAAA,CAAK,QAAA,GAAW,QAAQ,OAAA,IAAW,eAAA;AACnC,IAAA,IAAA,CAAK,WAAA,GAAc,QAAQ,UAAA,IAAc,mBAAA;AACzC,IAAA,IAAA,CAAK,MAAA,GAAS,OAAA,CAAQ,KAAA,IAAS,UAAA,CAAW,KAAA;AAE1C,IAAA,IAAI,OAAO,IAAA,CAAK,MAAA,KAAW,UAAA,EAAY;AACrC,MAAA,MAAM,IAAI,cAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,QAAW,GAAA,EAA0B;AACzC,IAAA,MAAM,UAAA,GAAa,GAAA,CAAI,UAAA,IAAc,IAAA,CAAK,WAAA;AAG1C,IAAA,MAAM,SAAA,GACJ,IAAI,MAAA,KAAW,KAAA,IAAS,IAAI,MAAA,KAAW,QAAA,IAAY,IAAI,UAAA,KAAe,IAAA;AAExE,IAAA,IAAI,SAAA;AACJ,IAAA,KAAA,IAAS,OAAA,GAAU,CAAA,EAAG,OAAA,IAAW,UAAA,EAAY,OAAA,EAAA,EAAW;AACtD,MAAA,IAAI,UAAU,CAAA,EAAG,MAAM,MAAM,OAAA,CAAQ,OAAA,EAAS,SAAS,CAAC,CAAA;AAExD,MAAA,IAAI;AACF,QAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,KAAA,CAAM,GAAG,CAAA;AAErC,QAAA,IAAI,QAAA,CAAS,EAAA,EAAI,OAAQ,MAAM,UAAU,QAAQ,CAAA;AAEjD,QAAA,MAAM,KAAA,GAAQ,MAAM,SAAA,CAAU,QAAQ,CAAA;AACtC,QAAA,IAAI,aAAa,OAAA,GAAU,UAAA,IAAc,WAAA,CAAY,QAAA,CAAS,MAAM,CAAA,EAAG;AACrE,UAAA,SAAA,GAAY,KAAA;AACZ,UAAA;AAAA,QACF;AACA,QAAA,MAAM,KAAA;AAAA,MACR,SAAS,KAAA,EAAO;AACd,QAAA,IACE,KAAA,YAAiB,cAAA,IACjB,EAAE,KAAA,YAAiB,eAAA,CAAA,EACnB;AACA,UAAA,MAAM,KAAA;AAAA,QACR;AAGA,QAAA,IAAI,CAAC,SAAA,IAAa,OAAA,IAAW,UAAA,EAAY,MAAM,KAAA;AAC/C,QAAA,SAAA,GAAY,KAAA;AAAA,MACd;AAAA,IACF;AAGA,IAAA,MAAM,SAAA;AAAA,EACR;AAAA,EAEA,MAAM,MAAM,GAAA,EAAiC;AAC3C,IAAA,MAAM,MAAM,IAAI,GAAA,CAAI,IAAA,CAAK,QAAA,GAAW,IAAI,IAAI,CAAA;AAC5C,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,CAAA,IAAK,MAAA,CAAO,QAAQ,GAAA,CAAI,KAAA,IAAS,EAAE,CAAA,EAAG;AAC1D,MAAA,IAAI,KAAA,KAAU,QAAW,GAAA,CAAI,YAAA,CAAa,IAAI,GAAA,EAAK,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,IAClE;AAEA,IAAA,MAAM,OAAA,GAAkC;AAAA,MACtC,aAAA,EAAe,CAAA,OAAA,EAAU,IAAA,CAAK,OAAO,CAAA,CAAA;AAAA,MACrC,MAAA,EAAQ;AAAA,KACV;AACA,IAAA,IAAI,GAAA,CAAI,IAAA,KAAS,MAAA,EAAW,OAAA,CAAQ,cAAc,CAAA,GAAI,kBAAA;AAEtD,IAAA,MAAM,OAAA,GAAU,GAAA,CAAI,OAAA,IAAW,IAAA,CAAK,QAAA;AACpC,IAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,IAAA,MAAM,UAAU,MAAM,UAAA,CAAW,KAAA,CAAM,GAAA,CAAI,QAAQ,MAAM,CAAA;AACzD,IAAA,GAAA,CAAI,QAAQ,gBAAA,CAAiB,OAAA,EAAS,SAAS,EAAE,IAAA,EAAM,MAAM,CAAA;AAE7D,IAAA,IAAI,QAAA,GAAW,KAAA;AACf,IAAA,MAAM,KAAA,GAAQ,WAAW,MAAM;AAC7B,MAAA,QAAA,GAAW,IAAA;AACX,MAAA,UAAA,CAAW,KAAA,EAAM;AAAA,IACnB,GAAG,OAAO,CAAA;AAEV,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,IAAA,CAAK,MAAA,CAAO,GAAA,EAAK;AAAA,QAC5B,QAAQ,GAAA,CAAI,MAAA;AAAA,QACZ,OAAA;AAAA,QACA,IAAA,EAAM,IAAI,IAAA,KAAS,KAAA,CAAA,GAAY,SAAY,IAAA,CAAK,SAAA,CAAU,IAAI,IAAI,CAAA;AAAA,QAClE,QAAQ,UAAA,CAAW;AAAA,OACpB,CAAA;AAAA,IACH,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,QAAA,EAAU;AACZ,QAAA,MAAM,IAAI,YAAA,CAAa,CAAA,wBAAA,EAA2B,OAAO,CAAA,GAAA,CAAA,EAAO;AAAA,UAC9D;AAAA,SACD,CAAA;AAAA,MACH;AAEA,MAAA,IAAI,GAAA,CAAI,MAAA,EAAQ,OAAA,EAAS,MAAM,KAAA;AAC/B,MAAA,MAAM,IAAI,gBAAgB,CAAA,gBAAA,EAAmB,GAAA,CAAI,MAAM,CAAA,CAAA,CAAA,EAAK,EAAE,OAAO,CAAA;AAAA,IACvE,CAAA,SAAE;AACA,MAAA,YAAA,CAAa,KAAK,CAAA;AAClB,MAAA,GAAA,CAAI,MAAA,EAAQ,mBAAA,CAAoB,OAAA,EAAS,OAAO,CAAA;AAAA,IAClD;AAAA,EACF;AACF,CAAA;AAEA,SAAS,YAAY,MAAA,EAAyB;AAC5C,EAAA,OAAO,MAAA,KAAW,GAAA,IAAO,MAAA,KAAW,GAAA,IAAO,MAAA,IAAU,GAAA;AACvD;AAGA,SAAS,OAAA,CAAQ,SAAiB,SAAA,EAA4B;AAC5D,EAAA,MAAM,UAAA,GACJ,aAAa,OAAO,SAAA,KAAc,YAAY,YAAA,IAAgB,SAAA,GACzD,UAAsC,UAAA,GACvC,MAAA;AACN,EAAA,IAAI,eAAe,MAAA,EAAW,OAAO,KAAK,GAAA,CAAI,UAAA,GAAa,KAAM,WAAW,CAAA;AAE5E,EAAA,MAAM,UAAU,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA,KAAM,OAAA,GAAU,IAAI,WAAW,CAAA;AAC9D,EAAA,OAAO,IAAA,CAAK,QAAO,GAAI,OAAA;AACzB;AAEA,SAAS,MAAM,EAAA,EAA2B;AACxC,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,YAAY,UAAA,CAAW,OAAA,EAAS,EAAE,CAAC,CAAA;AACzD;AAEA,eAAe,UAAU,QAAA,EAAsC;AAC7D,EAAA,IAAI,QAAA,CAAS,MAAA,KAAW,GAAA,EAAK,OAAO,MAAA;AAEpC,EAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AACjC,EAAA,IAAI,IAAA,KAAS,IAAI,OAAO,MAAA;AAExB,EAAA,IAAI;AACF,IAAA,OAAO,IAAA,CAAK,MAAM,IAAI,CAAA;AAAA,EACxB,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,IAAI,eAAe,8CAAA,EAAgD;AAAA,MACvE;AAAA,KACD,CAAA;AAAA,EACH;AACF;AAEA,eAAe,UAAU,QAAA,EAAoB;AAC3C,EAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AACjC,EAAA,MAAM,MAAA,GAAS,eAAe,IAAI,CAAA;AAClC,EAAA,MAAM,gBAAA,GAAmB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAA;AAC3D,EAAA,MAAM,UAAA,GAAa,gBAAA,GAAmB,MAAA,CAAO,gBAAgB,CAAA,GAAI,MAAA;AAEjE,EAAA,OAAO,iBAAA,CAAkB;AAAA,IACvB,QAAQ,QAAA,CAAS,MAAA;AAAA,IACjB,IAAA,EAAM,MAAA,EAAQ,IAAA,IAAQ,CAAA,KAAA,EAAQ,SAAS,MAAM,CAAA,CAAA;AAAA,IAC7C,OAAA,EAAS,MAAA,EAAQ,OAAA,IAAW,CAAA,qBAAA,EAAwB,SAAS,MAAM,CAAA,CAAA,CAAA;AAAA,IACnE,SAAA,EAAW,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,cAAc,CAAA,IAAK,MAAA;AAAA,IACnD,YACE,UAAA,KAAe,MAAA,IAAa,OAAO,QAAA,CAAS,UAAU,IAClD,UAAA,GACA,MAAA;AAAA,IACN,MAAM,IAAA,KAAS,EAAA,GAAK,MAAA,GAAa,SAAA,CAAU,IAAI,CAAA,IAAK;AAAA,GACrD,CAAA;AACH;AAEA,SAAS,eAAe,IAAA,EAAc;AACpC,EAAA,MAAM,MAAA,GAAS,UAAU,IAAI,CAAA;AAE7B,EAAA,MAAM,QAAQ,MAAA,EAAQ,KAAA;AACtB,EAAA,IAAI,CAAC,KAAA,EAAO,IAAA,IAAQ,CAAC,KAAA,CAAM,SAAS,OAAO,MAAA;AAE3C,EAAA,OAAO,EAAE,IAAA,EAAM,KAAA,CAAM,IAAA,EAAM,OAAA,EAAS,MAAM,OAAA,EAAQ;AACpD;AAEA,SAAS,UAAU,IAAA,EAAuB;AACxC,EAAA,IAAI;AACF,IAAA,OAAO,IAAA,CAAK,MAAM,IAAI,CAAA;AAAA,EACxB,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,MAAA;AAAA,EACT;AACF;;;AC3OO,IAAM,qBAAN,MAAyB;AAAA,EACrB,OAAA;AAAA,EAET,YAAY,MAAA,EAAgB;AAC1B,IAAA,IAAA,CAAK,OAAA,GAAU,MAAA;AAAA,EACjB;AAAA,EAEA,KAAA,CACE,UAAA,EACA,MAAA,EACA,OAAA,EACoB;AACpB,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,CAAA,cAAA,EAAiB,kBAAA,CAAmB,UAAU,CAAC,CAAA,WAAA,CAAA;AAAA,MACrD,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,IAAA,CACE,UAAA,EACA,MAAA,GAA8B,IAC9B,OAAA,EAC0B;AAC1B,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,CAAA,cAAA,EAAiB,kBAAA,CAAmB,UAAU,CAAC,CAAA,WAAA,CAAA;AAAA,MACrD,KAAA,EAAO;AAAA,QACL,UAAU,MAAA,CAAO,QAAA;AAAA,QACjB,gBAAgB,MAAA,CAAO;AAAA;AACzB,KACD,CAAA;AAAA,EACH;AAAA,EAEA,QAAA,CACE,UAAA,EACA,WAAA,EACA,OAAA,EACoB;AACpB,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,iBAAiB,kBAAA,CAAmB,UAAU,CAAC,CAAA,YAAA,EAAe,kBAAA,CAAmB,WAAW,CAAC,CAAA;AAAA,KACpG,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAA,CACE,UAAA,EACA,WAAA,EACA,OAAA,EACoB;AACpB,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,QAAA;AAAA,MACR,IAAA,EAAM,iBAAiB,kBAAA,CAAmB,UAAU,CAAC,CAAA,YAAA,EAAe,kBAAA,CAAmB,WAAW,CAAC,CAAA;AAAA,KACpG,CAAA;AAAA,EACH;AACF,CAAA;;;ACrDO,IAAM,eAAN,MAAmB;AAAA,EACf,OAAA;AAAA,EAET,YAAY,MAAA,EAAgB;AAC1B,IAAA,IAAA,CAAK,OAAA,GAAU,MAAA;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAA,CACE,UAAA,EACA,MAAA,EACA,OAAA,EACqB;AACrB,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,CAAA,cAAA,EAAiB,kBAAA,CAAmB,UAAU,CAAC,CAAA,KAAA,CAAA;AAAA,MACrD,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAA,CACE,UAAA,EACA,MAAA,EACA,OAAA,EACqB;AACrB,IAAA,MAAM,EAAE,IAAA,EAAM,GAAG,IAAA,EAAK,GAAI,MAAA;AAE1B,IAAA,OAAO,IAAA,CAAK,OAAO,UAAA,EAAY,EAAE,SAAS,IAAA,EAAM,GAAG,IAAA,EAAK,EAAG,OAAO,CAAA;AAAA,EACpE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,iBAAA,CACE,UAAA,EACA,MAAA,EACA,OAAA,EACqB;AACrB,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,MACV,UAAA;AAAA,MACA,EAAE,IAAA,EAAM,MAAA,CAAO,IAAA,EAAM,WAAW,YAAA,EAAa;AAAA,MAC7C;AAAA,KACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,SAAA,CACE,UAAA,EACA,MAAA,EACA,OAAA,EACqB;AACrB,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,MACV,UAAA;AAAA,MACA,EAAE,GAAG,MAAA,EAAQ,SAAA,EAAW,WAAA,EAAY;AAAA,MACpC;AAAA,KACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,OAAA,CACE,UAAA,EACA,MAAA,EACA,OAAA,EACqB;AACrB,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,MACV,UAAA;AAAA,MACA,EAAE,IAAA,EAAM,MAAA,CAAO,MAAM,SAAA,EAAW,WAAA,EAAa,gBAAgB,OAAA,EAAQ;AAAA,MACrE;AAAA,KACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,qBAAA,CACJ,UAAA,EACA,OAAA,EAC4B;AAC5B,IAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,QAAA,CAAS,YAAY,OAAO,CAAA;AACvD,IAAA,IAAI,OAAA,KAAY,MAAM,OAAO,IAAA;AAE7B,IAAA,OAAO,IAAA,CAAK,OAAO,UAAA,EAAY,EAAE,SAAS,OAAA,CAAQ,OAAA,IAAW,OAAO,CAAA;AAAA,EACtE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,QAAA,CACJ,UAAA,EACA,OAAA,EAC4B;AAC5B,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAA,CAAoB;AAAA,QAC5C,GAAG,OAAA;AAAA,QACH,MAAA,EAAQ,KAAA;AAAA,QACR,IAAA,EAAM,CAAA,cAAA,EAAiB,kBAAA,CAAmB,UAAU,CAAC,CAAA,KAAA;AAAA,OACtD,CAAA;AAAA,IACH,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,KAAA,YAAiB,aAAA,IAAiB,KAAA,CAAM,IAAA,KAAS,kBAAA,EAAoB;AACvE,QAAA,OAAO,IAAA;AAAA,MACT;AACA,MAAA,MAAM,KAAA;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,OAAA,CACJ,UAAA,EACA,OAAA,EAC4B;AAC5B,IAAA,MAAM,CAAC,SAAS,EAAE,IAAA,EAAM,CAAA,GAAI,MAAM,QAAQ,GAAA,CAAI;AAAA,MAC5C,IAAA,CAAK,QAAA,CAAS,UAAA,EAAY,OAAO,CAAA;AAAA,MACjC,IAAA,CAAK,OAAA,CAAQ,UAAA,EAAY,OAAO;AAAA,KACjC,CAAA;AAED,IAAA,MAAM,UACJ,OAAA,KAAY,IAAA,GAAO,YAAY,IAAA,CAAK,KAAA,CAAM,QAAQ,YAAY,CAAA;AAEhE,IAAA,OACE,IAAA,CAAK,IAAA;AAAA,MACH,CAAC,MAAM,CAAA,CAAE,aAAA,KAAkB,QAAQ,IAAA,CAAK,KAAA,CAAM,CAAA,CAAE,YAAY,CAAA,GAAI;AAAA,KAClE,IAAK,IAAA;AAAA,EAET;AAAA;AAAA,EAGA,OAAA,CACE,YACA,OAAA,EAC2B;AAC3B,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,CAAA,cAAA,EAAiB,kBAAA,CAAmB,UAAU,CAAC,CAAA,aAAA;AAAA,KACtD,CAAA;AAAA,EACH;AACF,CAAA;;;AC/MO,IAAM,YAAN,MAAgB;AAAA;AAAA,EAEZ,IAAA;AAAA;AAAA,EAEA,UAAA;AAAA,EAEA,OAAA;AAAA,EAET,YAAY,MAAA,EAAgB;AAC1B,IAAA,IAAA,CAAK,OAAA,GAAU,MAAA;AACf,IAAA,IAAA,CAAK,IAAA,GAAO,IAAI,YAAA,CAAa,MAAM,CAAA;AACnC,IAAA,IAAA,CAAK,UAAA,GAAa,IAAI,kBAAA,CAAmB,MAAM,CAAA;AAAA,EACjD;AAAA,EAEA,MAAA,CACE,QACA,OAAA,EACmB;AACnB,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,eAAA;AAAA,MACN,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,IAAA,CACE,MAAA,GAA6B,EAAC,EAC9B,OAAA,EACyB;AACzB,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,eAAA;AAAA,MACN,KAAA,EAAO,EAAE,eAAA,EAAiB,MAAA,CAAO,eAAA;AAAgB,KAClD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,QAAA,CAAS,IAAY,OAAA,EAAqD;AACxE,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,CAAA,cAAA,EAAiB,kBAAA,CAAmB,EAAE,CAAC,CAAA;AAAA,KAC9C,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,oBAAA,CACJ,UAAA,EACA,OAAA,EACkC;AAClC,IAAA,MAAM,EAAE,IAAA,EAAK,GAAI,MAAM,IAAA,CAAK,QAAQ,OAAA,CAAgC;AAAA,MAClE,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,eAAA;AAAA,MACN,KAAA,EAAO,EAAE,WAAA,EAAa,UAAA;AAAW,KAClC,CAAA;AAED,IAAA,OAAO,IAAA,CAAK,CAAC,CAAA,IAAK,IAAA;AAAA,EACpB;AAAA,EAEA,MAAA,CACE,EAAA,EACA,MAAA,EACA,OAAA,EACmB;AACnB,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,OAAA;AAAA,MACR,IAAA,EAAM,CAAA,cAAA,EAAiB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA;AAAA,MAC7C,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAA,CAAO,IAAY,OAAA,EAA6C;AAC9D,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,QAAA;AAAA,MACR,IAAA,EAAM,CAAA,cAAA,EAAiB,kBAAA,CAAmB,EAAE,CAAC,CAAA;AAAA,KAC9C,CAAA;AAAA,EACH;AACF,CAAA;;;AC/FO,IAAM,SAAN,MAAa;AAAA,EACT,OAAA;AAAA,EAET,YAAY,MAAA,EAAgB;AAC1B,IAAA,IAAA,CAAK,OAAA,GAAU,MAAA;AAAA,EACjB;AAAA,EAEA,MAAA,CAAO,QAA2B,OAAA,EAA0C;AAC1E,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,YAAA;AAAA,MACN,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA,EAEA,IAAA,CACE,MAAA,GAA0B,EAAC,EAC3B,OAAA,EACsB;AACtB,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,YAAA;AAAA,MACN,KAAA,EAAO,EAAE,gBAAA,EAAkB,MAAA,CAAO,gBAAA;AAAiB,KACpD,CAAA;AAAA,EACH;AAAA,EAEA,QAAA,CAAS,IAAY,OAAA,EAA0C;AAC7D,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,EAAE,CAAC,CAAA;AAAA,KAC3C,CAAA;AAAA,EACH;AAAA,EAEA,MAAA,CACE,EAAA,EACA,MAAA,EACA,OAAA,EACgB;AAChB,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,OAAA;AAAA,MACR,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA;AAAA,MAC1C,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,OAAA,CAAQ,IAAY,OAAA,EAA0C;AAC5D,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,QAAA;AAAA,MACR,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,EAAE,CAAC,CAAA;AAAA,KAC3C,CAAA;AAAA,EACH;AACF,CAAA;;;AClDO,IAAM,iBAAN,MAAqB;AAAA,EACjB,OAAA;AAAA,EAET,YAAY,MAAA,EAAgB;AAC1B,IAAA,IAAA,CAAK,OAAA,GAAU,MAAA;AAAA,EACjB;AAAA,EAEA,GAAA,CACE,MAAA,EACA,MAAA,EACA,OAAA,EACwB;AACxB,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,CAAA,UAAA,EAAa,kBAAA,CAAmB,MAAM,CAAC,CAAA,WAAA,CAAA;AAAA,MAC7C,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,IAAA,CACE,MAAA,EACA,MAAA,GAAkC,IAClC,OAAA,EAC8B;AAC9B,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,CAAA,UAAA,EAAa,kBAAA,CAAmB,MAAM,CAAC,CAAA,WAAA,CAAA;AAAA,MAC7C,KAAA,EAAO,EAAE,QAAA,EAAU,MAAA,CAAO,QAAA;AAAS,KACpC,CAAA;AAAA,EACH;AACF,CAAA;AAEO,IAAM,QAAN,MAAY;AAAA,EACR,UAAA;AAAA,EAEA,OAAA;AAAA,EAET,YAAY,MAAA,EAAgB;AAC1B,IAAA,IAAA,CAAK,OAAA,GAAU,MAAA;AACf,IAAA,IAAA,CAAK,UAAA,GAAa,IAAI,cAAA,CAAe,MAAM,CAAA;AAAA,EAC7C;AAAA;AAAA,EAGA,MAAA,CAAO,QAA0B,OAAA,EAAyC;AACxE,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,WAAA;AAAA,MACN,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA,EAEA,IAAA,CACE,MAAA,GAAyB,EAAC,EAC1B,OAAA,EACqB;AACrB,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,WAAA;AAAA,MACN,KAAA,EAAO,EAAE,gBAAA,EAAkB,MAAA,CAAO,gBAAA;AAAiB,KACpD,CAAA;AAAA,EACH;AAAA,EAEA,QAAA,CAAS,IAAY,OAAA,EAAyC;AAC5D,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,CAAA,UAAA,EAAa,kBAAA,CAAmB,EAAE,CAAC,CAAA;AAAA,KAC1C,CAAA;AAAA,EACH;AAAA,EAEA,MAAA,CACE,EAAA,EACA,MAAA,EACA,OAAA,EACe;AACf,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,OAAA;AAAA,MACR,IAAA,EAAM,CAAA,UAAA,EAAa,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA;AAAA,MACzC,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAA,CAAQ,IAAY,OAAA,EAAyC;AAC3D,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,QAAA;AAAA,MACR,IAAA,EAAM,CAAA,UAAA,EAAa,kBAAA,CAAmB,EAAE,CAAC,CAAA;AAAA,KAC1C,CAAA;AAAA,EACH;AACF,CAAA;;;ACjGO,IAAM,YAAN,MAAgB;AAAA,EACZ,SAAA;AAAA,EACA,MAAA;AAAA,EACA,KAAA;AAAA,EAEA,OAAA;AAAA,EAET,YAAY,OAAA,EAA2B;AACrC,IAAA,IAAA,CAAK,OAAA,GAAU,IAAI,MAAA,CAAO,OAAO,CAAA;AACjC,IAAA,IAAA,CAAK,SAAA,GAAY,IAAI,SAAA,CAAkB,IAAA,CAAK,OAAO,CAAA;AACnD,IAAA,IAAA,CAAK,MAAA,GAAS,IAAI,MAAA,CAAe,IAAA,CAAK,OAAO,CAAA;AAC7C,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAI,KAAA,CAAc,IAAA,CAAK,OAAO,CAAA;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,KAAA,CAAM,QAAqB,OAAA,EAAgD;AACzE,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,WAAA;AAAA,MACN,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,KAAA,CACJ,MAAA,EACA,OAAA,EACsB;AACtB,IAAA,MAAM,IAAA,GAAO,CAACA,IAAAA,KACZ,IAAA,CAAK,QAAQ,OAAA,CAAqB;AAAA,MAChC,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,iBAAA;AAAA;AAAA;AAAA,MAGN,IAAA,EAAM,EAAE,GAAG,MAAA,EAAQ,iBAAiBA,IAAAA,EAAI;AAAA,MACxC,UAAA,EAAY;AAAA,KACb,CAAA;AAEH,IAAA,IAAI,MAAA,CAAO,oBAAoB,MAAA,EAAW;AAIxC,MAAA,OAAO,IAAA,CAAK,OAAO,eAAe,CAAA;AAAA,IACpC;AAEA,IAAA,MAAM,GAAA,GAAM,cAAA,CAAe,IAAA,CAAK,OAAA,CAAQ,KAAK,CAAA;AAC7C,IAAA,MAAM,SAAA,GAAY,KAAK,GAAA,EAAI;AAE3B,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,KAAK,GAAG,CAAA;AAAA,IACvB,SAAS,KAAA,EAAO;AAGd,MAAA,IAAI,EAAE,KAAA,YAAiB,YAAA,CAAA,IAAiB,KAAA,CAAM,eAAe,MAAA,EAAW;AACtE,QAAA,MAAM,KAAA;AAAA,MACR;AAMA,MAAA,MAAM,OAAA,GAAU,IAAA,CAAK,GAAA,EAAI,GAAI,SAAA;AAC7B,MAAA,MAAM,aAAA,GAAgB,KAAA,CAAM,UAAA,CAAW,OAAA,EAAQ,GAAI,OAAA;AACnD,MAAA,IAAI,KAAK,GAAA,CAAI,aAAA,GAAgB,WAAW,GAAG,CAAC,KAAK,qBAAA,EAAuB;AACtE,QAAA,MAAM,KAAA;AAAA,MACR;AAEA,MAAA,IAAA,CAAK,OAAA,CAAQ,iBAAA,CAAkB,KAAA,CAAM,UAAU,CAAA;AAE/C,MAAA,OAAO,MAAM,IAAA,CAAK,cAAA,CAAe,KAAK,OAAA,CAAQ,GAAA,EAAK,CAAC,CAAA;AAAA,IACtD;AAAA,EACF;AAAA;AAAA,EAGA,OAAO,OAAA,EAA2C;AAChD,IAAA,OAAO,IAAA,CAAK,QAAQ,OAAA,CAAQ;AAAA,MAC1B,GAAG,OAAA;AAAA,MACH,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AACF;AA2BA,IAAM,qBAAA,GAAwB,KAAK,EAAA,GAAK,GAAA;AAGxC,SAAS,WAAW,GAAA,EAAqB;AACvC,EAAA,OAAO,MAAA,CAAO,QAAA,CAAS,GAAA,CAAI,OAAA,CAAQ,IAAA,EAAM,EAAE,CAAA,CAAE,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,EAAG,EAAE,CAAA;AAC/D;AAEA,SAAS,eAAe,IAAA,EAAsB;AAG5C,EAAA,MAAM,YAAY,UAAA,CAAW,MAAA;AAI7B,EAAA,IAAI,OAAO,SAAA,EAAW,eAAA,KAAoB,UAAA,EAAY;AACpD,IAAA,MAAM,IAAI,cAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AAEA,EAAA,MAAM,QAAQ,SAAA,CAAU,eAAA,CAAgB,IAAI,UAAA,CAAW,EAAE,CAAC,CAAA;AAI1D,EAAA,MAAM,KAAK,IAAA,CAAK,GAAA,CAAI,GAAG,IAAA,CAAK,KAAA,CAAM,IAAI,CAAC,CAAA;AACvC,EAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,EAAA,GAAK,UAAa,CAAA;AAC1C,EAAA,MAAM,MAAM,EAAA,KAAO,CAAA;AACnB,EAAA,KAAA,CAAM,CAAC,CAAA,GAAK,IAAA,KAAS,CAAA,GAAK,GAAA;AAC1B,EAAA,KAAA,CAAM,CAAC,IAAI,IAAA,GAAO,GAAA;AAClB,EAAA,KAAA,CAAM,CAAC,CAAA,GAAK,GAAA,KAAQ,EAAA,GAAM,GAAA;AAC1B,EAAA,KAAA,CAAM,CAAC,CAAA,GAAK,GAAA,KAAQ,EAAA,GAAM,GAAA;AAC1B,EAAA,KAAA,CAAM,CAAC,CAAA,GAAK,GAAA,KAAQ,CAAA,GAAK,GAAA;AACzB,EAAA,KAAA,CAAM,CAAC,IAAI,GAAA,GAAM,GAAA;AAEjB,EAAA,KAAA,CAAM,CAAC,CAAA,GAAK,KAAA,CAAM,CAAC,IAAK,EAAA,GAAQ,GAAA;AAChC,EAAA,KAAA,CAAM,CAAC,CAAA,GAAK,KAAA,CAAM,CAAC,IAAK,EAAA,GAAQ,GAAA;AAEhC,EAAA,MAAM,MAAM,KAAA,CAAM,IAAA,CAAK,KAAA,EAAO,CAAC,MAAM,CAAA,CAAE,QAAA,CAAS,EAAE,CAAA,CAAE,SAAS,CAAA,EAAG,GAAG,CAAC,CAAA,CAAE,KAAK,EAAE,CAAA;AAE7E,EAAA,OAAO;AAAA,IACL,GAAA,CAAI,KAAA,CAAM,CAAA,EAAG,CAAC,CAAA;AAAA,IACd,GAAA,CAAI,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA;AAAA,IACf,GAAA,CAAI,KAAA,CAAM,EAAA,EAAI,EAAE,CAAA;AAAA,IAChB,GAAA,CAAI,KAAA,CAAM,EAAA,EAAI,EAAE,CAAA;AAAA,IAChB,GAAA,CAAI,MAAM,EAAE;AAAA,GACd,CAAE,KAAK,GAAG,CAAA;AACZ","file":"index.cjs","sourcesContent":["// Every failure is a MeterbaseError, so a caller can catch one type and still\n// switch on the specific one. `code` is stable; `message` may change.\n\nexport class MeterbaseError extends Error {\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options)\n    this.name = new.target.name\n  }\n}\n\nexport class APIError extends MeterbaseError {\n  readonly status: number\n  readonly code: string\n  /** From `X-Request-Id`, when the engine sends one. */\n  readonly requestId: string | undefined\n  readonly body: unknown\n\n  constructor(args: {\n    status: number\n    code: string\n    message: string\n    requestId?: string | undefined\n    body?: unknown\n  }) {\n    super(args.message)\n    this.status = args.status\n    this.code = args.code\n    this.requestId = args.requestId\n    this.body = args.body\n  }\n}\n\nexport class AuthenticationError extends APIError {}\nexport class PermissionDeniedError extends APIError {}\nexport class NotFoundError extends APIError {}\nexport class ConflictError extends APIError {}\n\nexport class InvalidRequestError extends APIError {}\n\n/**\n * `422 invalid_idempotency_key`: the key was not a UUID version 7.\n * `crypto.randomUUID()` mints a v4, so omit `idempotency_key` and let this\n * SDK mint the right thing.\n */\nexport class InvalidIdempotencyKeyError extends InvalidRequestError {}\n\n/**\n * `422 too_late`: the key's timestamp is more than an hour from the engine's\n * clock, so a retry can no longer be told from a new event. **Nothing was\n * recorded** — the check runs before any write.\n *\n * The usual cause is this machine's clock. When this SDK minted the key it\n * corrects the offset from `serverTime` and retries once, so you only see\n * this for a key you supplied. If that key is a retry of a call made over an\n * hour ago, do not resend it under a new one: it may already be recorded.\n */\nexport class TooLateError extends InvalidRequestError {\n  /** The engine's clock when it refused. */\n  readonly serverTime: Date | undefined\n\n  constructor(args: ConstructorParameters<typeof APIError>[0]) {\n    super(args)\n    this.serverTime = serverTime(args.body)\n  }\n}\n\n/**\n * `422 cycle_change_requires_reset`: the two plans measure different cycles,\n * so a `next_cycle` change has no shared boundary to wait for and a `prorate`\n * no shared period to weight. The move is `customers.plan.restart`, which\n * closes the current period and opens a fresh one on the new cycle — or\n * `changeNow` with the default `reconciliation: \"none\"` to keep the period\n * that is running. The engine's `message` says as much.\n *\n * An `InvalidRequestError` still, so an existing `catch` keeps working.\n */\nexport class CycleChangeRequiresResetError extends InvalidRequestError {}\nexport class RateLimitError extends APIError {\n  /** Seconds to wait, from `Retry-After`, when the engine sends one. */\n  readonly retryAfter: number | undefined\n\n  constructor(\n    args: ConstructorParameters<typeof APIError>[0] & {\n      retryAfter?: number | undefined\n    },\n  ) {\n    super(args)\n    this.retryAfter = args.retryAfter\n  }\n}\nexport class ServerError extends APIError {}\n\n// The request never produced an answer: DNS, TLS, a reset, an abort.\nexport class ConnectionError extends MeterbaseError {}\nexport class TimeoutError extends ConnectionError {}\n\nexport function errorFromResponse(args: {\n  status: number\n  code: string\n  message: string\n  requestId?: string | undefined\n  retryAfter?: number | undefined\n  body?: unknown\n}): APIError {\n  switch (args.status) {\n    case 401:\n      return new AuthenticationError(args)\n    case 403:\n      return new PermissionDeniedError(args)\n    case 404:\n      return new NotFoundError(args)\n    case 409:\n      return new ConflictError(args)\n    case 422:\n      switch (args.code) {\n        case \"cycle_change_requires_reset\":\n          return new CycleChangeRequiresResetError(args)\n        case \"invalid_idempotency_key\":\n          return new InvalidIdempotencyKeyError(args)\n        case \"too_late\":\n          return new TooLateError(args)\n        default:\n          return new InvalidRequestError(args)\n      }\n    case 429:\n      return new RateLimitError(args)\n    default:\n      return args.status >= 500 ? new ServerError(args) : new APIError(args)\n  }\n}\n\n/** The engine carries it beside `code` and `message`, inside `error`. */\nfunction serverTime(body: unknown): Date | undefined {\n  if (typeof body !== \"object\" || body === null) return undefined\n\n  const error = (body as { error?: unknown }).error\n  if (typeof error !== \"object\" || error === null) return undefined\n\n  const at = (error as { server_time?: unknown }).server_time\n  if (typeof at !== \"string\") return undefined\n\n  const parsed = new Date(at)\n  return Number.isNaN(parsed.getTime()) ? undefined : parsed\n}\n","// Everything goes through `request`, so authentication, timeouts, retries and\n// error mapping are defined once.\n\nimport {\n  ConnectionError,\n  errorFromResponse,\n  MeterbaseError,\n  TimeoutError,\n} from \"./errors.js\"\n\nexport type MeterbaseOptions = {\n  /** A secret key. It names its own workspace. */\n  apiKey: string\n  /** Defaults to the hosted engine. */\n  baseUrl?: string\n  /** Per attempt, not per call. */\n  timeout?: number\n  maxRetries?: number\n  fetch?: typeof globalThis.fetch\n}\n\nexport type RequestOptions = {\n  signal?: AbortSignal\n  timeout?: number\n  maxRetries?: number\n}\n\ntype HttpMethod = \"GET\" | \"POST\" | \"PATCH\" | \"DELETE\"\n\ntype Request = RequestOptions & {\n  method: HttpMethod\n  path: string\n  query?: Record<string, string | number | boolean | undefined>\n  body?: unknown\n  /**\n   * Replay this call even though its method is not safe. Only a route that\n   * carries an idempotency key may set it, and the key has to be fixed before\n   * `request` is called — the loop re-sends one body, so a key generated\n   * per attempt would count the same usage twice.\n   */\n  idempotent?: boolean\n}\n\nconst DEFAULT_BASE_URL = \"https://api.meterbase.tech\"\nconst DEFAULT_TIMEOUT = 10_000\nconst DEFAULT_MAX_RETRIES = 2\nconst MAX_BACKOFF = 8_000\n\nexport class Client {\n  readonly #apiKey: string\n  readonly #baseUrl: string\n  readonly #timeout: number\n  readonly #maxRetries: number\n  readonly #fetch: typeof globalThis.fetch\n\n  /**\n   * How far the engine's clock is ahead of this machine's, in milliseconds.\n   * Idempotency keys are minted here and the engine refuses one dated more\n   * than an hour from its own clock, so without this a device with a wrong\n   * clock would fail every call forever.\n   */\n  #clockOffset = 0\n\n  /** The engine's clock, as well as this client knows it. */\n  now(): number {\n    return Date.now() + this.#clockOffset\n  }\n\n  /** Off by up to one round trip, which a window in hours does not notice. */\n  observeServerTime(at: Date): void {\n    this.#clockOffset = at.getTime() - Date.now()\n  }\n\n  constructor(options: MeterbaseOptions) {\n    if (!options.apiKey) {\n      throw new MeterbaseError(\n        \"An API key is required: new Meterbase({ apiKey: 'mb_sk_live_…' }).\",\n      )\n    }\n\n    this.#apiKey = options.apiKey\n    this.#baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\")\n    this.#timeout = options.timeout ?? DEFAULT_TIMEOUT\n    this.#maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES\n    this.#fetch = options.fetch ?? globalThis.fetch\n\n    if (typeof this.#fetch !== \"function\") {\n      throw new MeterbaseError(\n        \"No fetch implementation: pass one as `fetch`, or run on Node 18+.\",\n      )\n    }\n  }\n\n  async request<T>(req: Request): Promise<T> {\n    const maxRetries = req.maxRetries ?? this.#maxRetries\n    // Safe methods, plus the routes that carry an idempotency key and say so.\n    // Any other POST or PATCH could create a second row on a replay.\n    const retryable =\n      req.method === \"GET\" || req.method === \"DELETE\" || req.idempotent === true\n\n    let lastError: unknown\n    for (let attempt = 0; attempt <= maxRetries; attempt++) {\n      if (attempt > 0) await sleep(backoff(attempt, lastError))\n\n      try {\n        const response = await this.#send(req)\n\n        if (response.ok) return (await parseBody(response)) as T\n\n        const error = await errorFrom(response)\n        if (retryable && attempt < maxRetries && shouldRetry(response.status)) {\n          lastError = error\n          continue\n        }\n        throw error\n      } catch (cause) {\n        if (\n          cause instanceof MeterbaseError &&\n          !(cause instanceof ConnectionError)\n        ) {\n          throw cause\n        }\n        // A connection failure proves nothing about whether the server acted,\n        // so it is replayed under the same idempotency rule.\n        if (!retryable || attempt >= maxRetries) throw cause\n        lastError = cause\n      }\n    }\n\n    /* c8 ignore next 2 -- the loop always returns or throws */\n    throw lastError\n  }\n\n  async #send(req: Request): Promise<Response> {\n    const url = new URL(this.#baseUrl + req.path)\n    for (const [key, value] of Object.entries(req.query ?? {})) {\n      if (value !== undefined) url.searchParams.set(key, String(value))\n    }\n\n    const headers: Record<string, string> = {\n      authorization: `Bearer ${this.#apiKey}`,\n      accept: \"application/json\",\n    }\n    if (req.body !== undefined) headers[\"content-type\"] = \"application/json\"\n\n    const timeout = req.timeout ?? this.#timeout\n    const controller = new AbortController()\n    const onAbort = () => controller.abort(req.signal?.reason)\n    req.signal?.addEventListener(\"abort\", onAbort, { once: true })\n\n    let timedOut = false\n    const timer = setTimeout(() => {\n      timedOut = true\n      controller.abort()\n    }, timeout)\n\n    try {\n      return await this.#fetch(url, {\n        method: req.method,\n        headers,\n        body: req.body === undefined ? undefined : JSON.stringify(req.body),\n        signal: controller.signal,\n      })\n    } catch (cause) {\n      if (timedOut) {\n        throw new TimeoutError(`Request timed out after ${timeout}ms.`, {\n          cause,\n        })\n      }\n      // A caller's own abort is theirs to handle, not ours to reclassify.\n      if (req.signal?.aborted) throw cause\n      throw new ConnectionError(`Could not reach ${url.origin}.`, { cause })\n    } finally {\n      clearTimeout(timer)\n      req.signal?.removeEventListener(\"abort\", onAbort)\n    }\n  }\n}\n\nfunction shouldRetry(status: number): boolean {\n  return status === 408 || status === 429 || status >= 500\n}\n\n/** Exponential backoff with full jitter, unless the engine named a delay. */\nfunction backoff(attempt: number, lastError: unknown): number {\n  const retryAfter =\n    lastError && typeof lastError === \"object\" && \"retryAfter\" in lastError\n      ? (lastError as { retryAfter?: number }).retryAfter\n      : undefined\n  if (retryAfter !== undefined) return Math.min(retryAfter * 1000, MAX_BACKOFF)\n\n  const ceiling = Math.min(500 * 2 ** (attempt - 1), MAX_BACKOFF)\n  return Math.random() * ceiling\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n\nasync function parseBody(response: Response): Promise<unknown> {\n  if (response.status === 204) return undefined\n\n  const text = await response.text()\n  if (text === \"\") return undefined\n\n  try {\n    return JSON.parse(text)\n  } catch (cause) {\n    throw new MeterbaseError(\"The engine returned a body that is not JSON.\", {\n      cause,\n    })\n  }\n}\n\nasync function errorFrom(response: Response) {\n  const body = await response.text()\n  const parsed = parseErrorBody(body)\n  const retryAfterHeader = response.headers.get(\"retry-after\")\n  const retryAfter = retryAfterHeader ? Number(retryAfterHeader) : undefined\n\n  return errorFromResponse({\n    status: response.status,\n    code: parsed?.code ?? `http_${response.status}`,\n    message: parsed?.message ?? `The engine responded ${response.status}.`,\n    requestId: response.headers.get(\"x-request-id\") ?? undefined,\n    retryAfter:\n      retryAfter !== undefined && Number.isFinite(retryAfter)\n        ? retryAfter\n        : undefined,\n    body: body === \"\" ? undefined : (safeParse(body) ?? body),\n  })\n}\n\nfunction parseErrorBody(body: string) {\n  const parsed = safeParse(body) as\n    { error?: { code?: string; message?: string } } | undefined\n  const error = parsed?.error\n  if (!error?.code || !error.message) return undefined\n\n  return { code: error.code, message: error.message }\n}\n\nfunction safeParse(body: string): unknown {\n  try {\n    return JSON.parse(body)\n  } catch {\n    return undefined\n  }\n}\n","import type { Client, RequestOptions } from \"../client.js\"\nimport type {\n  Allowance,\n  AllowanceGrantParams,\n  AllowanceListParams,\n  List,\n} from \"../types.js\"\n\n/**\n * Capacity handed to one customer on top of their plan. A grant with\n * `source: \"plan\"` is the engine's own, minted when a plan is assigned, and\n * cannot be created here.\n */\nexport class CustomerAllowances {\n  readonly #client: Client\n\n  constructor(client: Client) {\n    this.#client = client\n  }\n\n  grant(\n    customerId: string,\n    params: AllowanceGrantParams,\n    options?: RequestOptions,\n  ): Promise<Allowance> {\n    return this.#client.request({\n      ...options,\n      method: \"POST\",\n      path: `/v1/customers/${encodeURIComponent(customerId)}/allowances`,\n      body: params,\n    })\n  }\n\n  /** Open grants only, unless `include_closed`. */\n  list(\n    customerId: string,\n    params: AllowanceListParams = {},\n    options?: RequestOptions,\n  ): Promise<List<Allowance>> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: `/v1/customers/${encodeURIComponent(customerId)}/allowances`,\n      query: {\n        meter_id: params.meter_id,\n        include_closed: params.include_closed,\n      },\n    })\n  }\n\n  retrieve(\n    customerId: string,\n    allowanceId: string,\n    options?: RequestOptions,\n  ): Promise<Allowance> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: `/v1/customers/${encodeURIComponent(customerId)}/allowances/${encodeURIComponent(allowanceId)}`,\n    })\n  }\n\n  /** Withdraws what is left without erasing what was consumed. Idempotent. */\n  revoke(\n    customerId: string,\n    allowanceId: string,\n    options?: RequestOptions,\n  ): Promise<Allowance> {\n    return this.#client.request({\n      ...options,\n      method: \"DELETE\",\n      path: `/v1/customers/${encodeURIComponent(customerId)}/allowances/${encodeURIComponent(allowanceId)}`,\n    })\n  }\n}\n","import type { Client, RequestOptions } from \"../client.js\"\nimport type {\n  AssignPlanParams,\n  Assignment,\n  List,\n  PlanChangeNowParams,\n  PlanChangeParams,\n  PlanMoveParams,\n} from \"../types.js\"\nimport { NotFoundError } from \"../errors.js\"\n\n/**\n * Which plan a customer holds. The history is append-only: there is no patch\n * and no delete, and moving a customer to a different plan is the same call as\n * their first.\n *\n * `assign` is that call, mirroring the wire. The rest name the four moves a\n * caller actually makes — later, now, now-and-start-over, and never mind — so\n * that picking one does not mean knowing what `effective` and `reconciliation`\n * do to a half-used period.\n */\nexport class CustomerPlan {\n  readonly #client: Client\n\n  constructor(client: Client) {\n    this.#client = client\n  }\n\n  /**\n   * Put a customer on a plan. This is the wire call, and the only one that\n   * takes `cycle_anchor` — a first assignment's one chance to put their\n   * periods on a date they already have.\n   *\n   * Returns the instruction as recorded, which is not always as asked: a first\n   * plan is recorded `immediate` whatever `effective` said.\n   */\n  assign(\n    customerId: string,\n    params: AssignPlanParams,\n    options?: RequestOptions,\n  ): Promise<Assignment> {\n    return this.#client.request({\n      ...options,\n      method: \"POST\",\n      path: `/v1/customers/${encodeURIComponent(customerId)}/plan`,\n      body: params,\n    })\n  }\n\n  /**\n   * Move a customer to a different plan, with both knobs in the open.\n   * `effective` defaults to `next_cycle`; `reconciliation` applies only to an\n   * `immediate` change and defaults to `none`.\n   *\n   * Reach for `changeAtNextCycle`, `changeNow` or `restart` when one of them\n   * says what you mean — this is the form to fall back to when the two are\n   * chosen at runtime.\n   */\n  change(\n    customerId: string,\n    params: PlanChangeParams,\n    options?: RequestOptions,\n  ): Promise<Assignment> {\n    const { plan, ...rest } = params\n\n    return this.assign(customerId, { plan_id: plan, ...rest }, options)\n  }\n\n  /**\n   * Schedule the move for the end of the period they are in: they keep the\n   * plan they are paying for until it runs out, and the new one starts at\n   * their next boundary. Nothing is pro-rated, because nothing is split.\n   *\n   * Two plans on different cycles share no boundary, and this answers\n   * `CycleChangeRequiresResetError` — use `restart` for that move.\n   */\n  changeAtNextCycle(\n    customerId: string,\n    params: PlanMoveParams,\n    options?: RequestOptions,\n  ): Promise<Assignment> {\n    return this.change(\n      customerId,\n      { plan: params.plan, effective: \"next_cycle\" },\n      options,\n    )\n  }\n\n  /**\n   * Move them now, inside the period already running. Their renewal day does\n   * not move; what changes is this period's cap, and `reconciliation` says\n   * how:\n   *\n   * - `none` (the default) — the new plan's amount governs the whole period.\n   *   Usage already spent still counts, so a downgrade can deny until the\n   *   period ends.\n   * - `prorate` — each plan's amount weighted by the fraction of the period it\n   *   was held for. Refused between plans on different cycles, which share no\n   *   period to weight.\n   *\n   * To have the period itself start over instead, use `restart`.\n   */\n  changeNow(\n    customerId: string,\n    params: PlanChangeNowParams,\n    options?: RequestOptions,\n  ): Promise<Assignment> {\n    return this.change(\n      customerId,\n      { ...params, effective: \"immediate\" },\n      options,\n    )\n  }\n\n  /**\n   * Move them now and start a fresh period today: the period they were in\n   * closes where the change lands, keeping the usage it had, and the new\n   * plan's full amount opens immediately.\n   *\n   * This moves the customer's anchor, so their renewal day becomes today. It\n   * is the move for a customer starting over — a new contract, a re-signup —\n   * and the only one that can take a customer between plans whose cycles\n   * differ.\n   */\n  restart(\n    customerId: string,\n    params: PlanMoveParams,\n    options?: RequestOptions,\n  ): Promise<Assignment> {\n    return this.change(\n      customerId,\n      { plan: params.plan, effective: \"immediate\", reconciliation: \"reset\" },\n      options,\n    )\n  }\n\n  /**\n   * Call off a change that has not landed yet, leaving the customer on the\n   * plan they hold. Naming the plan already held is what supersedes a pending\n   * instruction, so this reads the plan in force and names it back.\n   *\n   * Returns the assignment still in force, or `null` for a customer holding no\n   * plan — who can have nothing pending, since a first assignment always lands\n   * at once.\n   */\n  async cancelScheduledChange(\n    customerId: string,\n    options?: RequestOptions,\n  ): Promise<Assignment | null> {\n    const current = await this.retrieve(customerId, options)\n    if (current === null) return null\n\n    return this.assign(customerId, { plan_id: current.plan_id }, options)\n  }\n\n  /**\n   * The plan in force now, which is not always the newest instruction: a\n   * change dated ahead does not govern yet.\n   *\n   * `null` when the customer holds no plan. That is a default deny rather than\n   * a failure — they are entitled to nothing — so it is an answer here and not\n   * a thrown `NotFoundError`. A customer who does not exist at all still\n   * throws one.\n   */\n  async retrieve(\n    customerId: string,\n    options?: RequestOptions,\n  ): Promise<Assignment | null> {\n    try {\n      return await this.#client.request<Assignment>({\n        ...options,\n        method: \"GET\",\n        path: `/v1/customers/${encodeURIComponent(customerId)}/plan`,\n      })\n    } catch (error) {\n      if (error instanceof NotFoundError && error.code === \"no_plan_assigned\") {\n        return null\n      }\n      throw error\n    }\n  }\n\n  /**\n   * The change waiting to land, or `null` when none is. At most one is ever\n   * live: a newer instruction supersedes the one before it.\n   *\n   * Read against the assignment in force rather than against the local clock,\n   * so a change landing seconds from now is not reported as already governing.\n   */\n  async pending(\n    customerId: string,\n    options?: RequestOptions,\n  ): Promise<Assignment | null> {\n    const [current, { data }] = await Promise.all([\n      this.retrieve(customerId, options),\n      this.history(customerId, options),\n    ])\n\n    const inForce =\n      current === null ? -Infinity : Date.parse(current.effective_at)\n\n    return (\n      data.find(\n        (a) => a.superseded_at === null && Date.parse(a.effective_at) > inForce,\n      ) ?? null\n    )\n  }\n\n  /** Every instruction, superseded ones included: it is the whole trail. */\n  history(\n    customerId: string,\n    options?: RequestOptions,\n  ): Promise<List<Assignment>> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: `/v1/customers/${encodeURIComponent(customerId)}/plan/history`,\n    })\n  }\n}\n","import type { Client, RequestOptions } from \"../client.js\"\nimport type {\n  Customer,\n  CustomerCreateParams,\n  CustomerListParams,\n  CustomerUpdateParams,\n  CustomerWithPlan,\n  List,\n} from \"../types.js\"\nimport { CustomerAllowances } from \"./customer-allowances.js\"\nimport { CustomerPlan } from \"./customer-plan.js\"\n\nexport class Customers {\n  /** The plan they hold, and the trail of instructions that got them there. */\n  readonly plan: CustomerPlan\n  /** Grants, which sit on top of whatever the plan gives. */\n  readonly allowances: CustomerAllowances\n\n  readonly #client: Client\n\n  constructor(client: Client) {\n    this.#client = client\n    this.plan = new CustomerPlan(client)\n    this.allowances = new CustomerAllowances(client)\n  }\n\n  create(\n    params: CustomerCreateParams,\n    options?: RequestOptions,\n  ): Promise<Customer> {\n    return this.#client.request({\n      ...options,\n      method: \"POST\",\n      path: \"/v1/customers\",\n      body: params,\n    })\n  }\n\n  /** Lean: a listing does not embed the plan. Read one customer for that. */\n  list(\n    params: CustomerListParams = {},\n    options?: RequestOptions,\n  ): Promise<List<Customer>> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: \"/v1/customers\",\n      query: { include_deleted: params.include_deleted },\n    })\n  }\n\n  /**\n   * One customer, with the plan they hold. `plan` is the one in force now and\n   * `pending_plan` the change waiting to land, each `null` when there is\n   * none — so knowing what a customer is on costs no second request.\n   */\n  retrieve(id: string, options?: RequestOptions): Promise<CustomerWithPlan> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: `/v1/customers/${encodeURIComponent(id)}`,\n    })\n  }\n\n  /**\n   * Resolves the tenant's own identifier, or null, embedding the plan the way\n   * `retrieve` does. The engine answers this as a filtered list, so a miss is\n   * an empty collection rather than a 404.\n   */\n  async retrieveByExternalId(\n    externalId: string,\n    options?: RequestOptions,\n  ): Promise<CustomerWithPlan | null> {\n    const { data } = await this.#client.request<List<CustomerWithPlan>>({\n      ...options,\n      method: \"GET\",\n      path: \"/v1/customers\",\n      query: { external_id: externalId },\n    })\n\n    return data[0] ?? null\n  }\n\n  update(\n    id: string,\n    params: CustomerUpdateParams,\n    options?: RequestOptions,\n  ): Promise<Customer> {\n    return this.#client.request({\n      ...options,\n      method: \"PATCH\",\n      path: `/v1/customers/${encodeURIComponent(id)}`,\n      body: params,\n    })\n  }\n\n  /** Soft delete: usage and assignments keep referencing the customer. */\n  delete(id: string, options?: RequestOptions): Promise<Customer> {\n    return this.#client.request({\n      ...options,\n      method: \"DELETE\",\n      path: `/v1/customers/${encodeURIComponent(id)}`,\n    })\n  }\n}\n","import type { Client, RequestOptions } from \"../client.js\"\nimport type {\n  List,\n  Meter,\n  MeterCreateParams,\n  MeterListParams,\n  MeterUpdateParams,\n} from \"../types.js\"\n\nexport class Meters {\n  readonly #client: Client\n\n  constructor(client: Client) {\n    this.#client = client\n  }\n\n  create(params: MeterCreateParams, options?: RequestOptions): Promise<Meter> {\n    return this.#client.request({\n      ...options,\n      method: \"POST\",\n      path: \"/v1/meters\",\n      body: params,\n    })\n  }\n\n  list(\n    params: MeterListParams = {},\n    options?: RequestOptions,\n  ): Promise<List<Meter>> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: \"/v1/meters\",\n      query: { include_archived: params.include_archived },\n    })\n  }\n\n  retrieve(id: string, options?: RequestOptions): Promise<Meter> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: `/v1/meters/${encodeURIComponent(id)}`,\n    })\n  }\n\n  update(\n    id: string,\n    params: MeterUpdateParams,\n    options?: RequestOptions,\n  ): Promise<Meter> {\n    return this.#client.request({\n      ...options,\n      method: \"PATCH\",\n      path: `/v1/meters/${encodeURIComponent(id)}`,\n      body: params,\n    })\n  }\n\n  /** Soft delete: plans and usage keep referencing the meter. Idempotent. */\n  archive(id: string, options?: RequestOptions): Promise<Meter> {\n    return this.#client.request({\n      ...options,\n      method: \"DELETE\",\n      path: `/v1/meters/${encodeURIComponent(id)}`,\n    })\n  }\n}\n","import type { Client, RequestOptions } from \"../client.js\"\nimport type {\n  List,\n  Plan,\n  PlanAllowance,\n  PlanAllowanceListParams,\n  PlanAllowanceSetParams,\n  PlanCreateParams,\n  PlanListParams,\n  PlanUpdateParams,\n} from \"../types.js\"\n\n/**\n * A plan's entitlement, versioned. There is no update and no delete: an edit\n * appends the next version, so which amount applied when stays derivable.\n */\nexport class PlanAllowances {\n  readonly #client: Client\n\n  constructor(client: Client) {\n    this.#client = client\n  }\n\n  set(\n    planId: string,\n    params: PlanAllowanceSetParams,\n    options?: RequestOptions,\n  ): Promise<PlanAllowance> {\n    return this.#client.request({\n      ...options,\n      method: \"POST\",\n      path: `/v1/plans/${encodeURIComponent(planId)}/allowances`,\n      body: params,\n    })\n  }\n\n  /** Every version of every meter, newest first — history, not just current. */\n  list(\n    planId: string,\n    params: PlanAllowanceListParams = {},\n    options?: RequestOptions,\n  ): Promise<List<PlanAllowance>> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: `/v1/plans/${encodeURIComponent(planId)}/allowances`,\n      query: { meter_id: params.meter_id },\n    })\n  }\n}\n\nexport class Plans {\n  readonly allowances: PlanAllowances\n\n  readonly #client: Client\n\n  constructor(client: Client) {\n    this.#client = client\n    this.allowances = new PlanAllowances(client)\n  }\n\n  /** A new plan grants nothing; attach entitlement with `allowances.set`. */\n  create(params: PlanCreateParams, options?: RequestOptions): Promise<Plan> {\n    return this.#client.request({\n      ...options,\n      method: \"POST\",\n      path: \"/v1/plans\",\n      body: params,\n    })\n  }\n\n  list(\n    params: PlanListParams = {},\n    options?: RequestOptions,\n  ): Promise<List<Plan>> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: \"/v1/plans\",\n      query: { include_archived: params.include_archived },\n    })\n  }\n\n  retrieve(id: string, options?: RequestOptions): Promise<Plan> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: `/v1/plans/${encodeURIComponent(id)}`,\n    })\n  }\n\n  update(\n    id: string,\n    params: PlanUpdateParams,\n    options?: RequestOptions,\n  ): Promise<Plan> {\n    return this.#client.request({\n      ...options,\n      method: \"PATCH\",\n      path: `/v1/plans/${encodeURIComponent(id)}`,\n      body: params,\n    })\n  }\n\n  /**\n   * Stops new assignments without withdrawing capacity from anyone already on\n   * the plan, which is why an archived plan still resolves by id. Idempotent.\n   */\n  archive(id: string, options?: RequestOptions): Promise<Plan> {\n    return this.#client.request({\n      ...options,\n      method: \"DELETE\",\n      path: `/v1/plans/${encodeURIComponent(id)}`,\n    })\n  }\n}\n","import { Client, type MeterbaseOptions, type RequestOptions } from \"./client.js\"\nimport { MeterbaseError, TooLateError } from \"./errors.js\"\nimport type { CustomerAllowances as CustomerAllowancesResource } from \"./resources/customer-allowances.js\"\nimport type { CustomerPlan as CustomerPlanResource } from \"./resources/customer-plan.js\"\nimport { Customers as CustomersResource } from \"./resources/customers.js\"\nimport { Meters as MetersResource } from \"./resources/meters.js\"\nimport {\n  Plans as PlansResource,\n  type PlanAllowances as PlanAllowancesResource,\n} from \"./resources/plans.js\"\nimport type {\n  CheckParams,\n  CheckResult,\n  TrackParams,\n  TrackResult,\n  WhoAmI,\n} from \"./types.js\"\n\nexport class Meterbase {\n  readonly customers: Customers\n  readonly meters: Meters\n  readonly plans: Plans\n\n  readonly #client: Client\n\n  constructor(options: MeterbaseOptions) {\n    this.#client = new Client(options)\n    this.customers = new CustomersResource(this.#client)\n    this.meters = new MetersResource(this.#client)\n    this.plans = new PlansResource(this.#client)\n  }\n\n  /**\n   * Asks whether a customer may consume `quantity` of a meter, named by the\n   * tenant's own external id and the meter's key. Absence of entitlement is\n   * not permission: a customer with no plan and no grant is denied.\n   *\n   * This is the gate, and the only call that ever refuses. Run it before the\n   * work; record the work with `track` afterwards.\n   *\n   * Two gates answer it, and `allowed` needs both: the customer's capacity has\n   * to cover the quantity, and every rate-limit window in force has to admit\n   * it. `reason` names the one that said no. `rate_limits` reports each window\n   * whether or not it refused, so a caller can ease off as its headroom closes\n   * instead of discovering the ceiling by hitting it.\n   */\n  check(params: CheckParams, options?: RequestOptions): Promise<CheckResult> {\n    return this.#client.request({\n      ...options,\n      method: \"POST\",\n      path: \"/v1/check\",\n      body: params,\n    })\n  }\n\n  /**\n   * Records usage that already happened — the tokens were spent, the image\n   * was generated — so it never refuses on capacity. A quantity beyond the\n   * customer's capacity is recorded, drives `available` to 0, and the next\n   * `check` says no. The answer is a receipt, not a verdict.\n   *\n   * `idempotency_key` is a UUIDv7, generated when omitted, so retrying this\n   * call — the SDK's own retries included — replays the original rather than\n   * counting the same work twice. The engine keeps that claim for an hour,\n   * which is how long a retry stays recognisable.\n   */\n  // `async` so that generating the key cannot throw synchronously out of a\n  // method that otherwise only ever rejects: one call, one way to fail.\n  async track(\n    params: TrackParams,\n    options?: RequestOptions,\n  ): Promise<TrackResult> {\n    const send = (key: string) =>\n      this.#client.request<TrackResult>({\n        ...options,\n        method: \"POST\",\n        path: \"/v1/usage/track\",\n        // Fixed before the retry loop is entered: every attempt of this call\n        // carries the same key, which is what makes replaying it safe.\n        body: { ...params, idempotency_key: key },\n        idempotent: true,\n      })\n\n    if (params.idempotency_key !== undefined) {\n      // The caller's key, so the caller's problem if it is out of the window:\n      // this cannot know whether it names work already recorded, and minting\n      // a replacement could count that work twice.\n      return send(params.idempotency_key)\n    }\n\n    const key = idempotencyKey(this.#client.now())\n    const startedAt = Date.now()\n\n    try {\n      return await send(key)\n    } catch (error) {\n      // The only failure this can fix by itself: a clock that disagrees with\n      // the engine's.\n      if (!(error instanceof TooLateError) || error.serverTime === undefined) {\n        throw error\n      }\n\n      // Re-minting is safe only if no attempt under the old key can have\n      // landed. `send` retries internally, so this 422 may have come from a\n      // later attempt while an earlier one succeeded. If the key was already\n      // outside the window when the call began, every attempt was refused.\n      const elapsed = Date.now() - startedAt\n      const serverAtStart = error.serverTime.getTime() - elapsed\n      if (Math.abs(serverAtStart - mintedAtMs(key)) <= IDEMPOTENCY_WINDOW_MS) {\n        throw error\n      }\n\n      this.#client.observeServerTime(error.serverTime)\n\n      return await send(idempotencyKey(this.#client.now()))\n    }\n  }\n\n  /** Reports which workspace this key acts for. */\n  whoami(options?: RequestOptions): Promise<WhoAmI> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: \"/v1/whoami\",\n    })\n  }\n}\n\n/**\n * The resource namespaces, type-only: none is constructible without the\n * unexported Client. Instance types rather than `export type { Customers }`,\n * which the declaration bundler re-emits as a value export — promising a\n * runtime binding the bundle never has.\n */\nexport type CustomerAllowances = InstanceType<typeof CustomerAllowancesResource>\nexport type CustomerPlan = InstanceType<typeof CustomerPlanResource>\nexport type Customers = InstanceType<typeof CustomersResource>\nexport type Meters = InstanceType<typeof MetersResource>\nexport type PlanAllowances = InstanceType<typeof PlanAllowancesResource>\nexport type Plans = InstanceType<typeof PlansResource>\nexport type { MeterbaseOptions, RequestOptions }\nexport * from \"./errors.js\"\nexport type * from \"./types.js\"\n\n/**\n * A UUIDv7: 48 bits of Unix milliseconds, then the version and variant, then\n * 74 random bits. `crypto.randomUUID()` mints a v4, which carries no time, so\n * this builds one from random bytes.\n *\n * `atMs` is the engine's clock as the client knows it, not this machine's: a\n * device an hour out would otherwise mint keys the engine refuses.\n */\n/** How far the engine lets a key's timestamp sit from its own clock. */\nconst IDEMPOTENCY_WINDOW_MS = 60 * 60 * 1000\n\n/** The millisecond a v7 carries in its first 48 bits. */\nfunction mintedAtMs(key: string): number {\n  return Number.parseInt(key.replace(/-/g, \"\").slice(0, 12), 16)\n}\n\nfunction idempotencyKey(atMs: number): string {\n  // Structurally, not as `Crypto`: that lib type is the DOM's, and this\n  // compiles without it so the SDK stays as portable as `fetch` is.\n  const webcrypto = globalThis.crypto as\n    | { getRandomValues?: (array: Uint8Array) => Uint8Array }\n    | undefined\n\n  if (typeof webcrypto?.getRandomValues !== \"function\") {\n    throw new MeterbaseError(\n      \"No crypto to generate an idempotency key with: pass `idempotency_key` \" +\n        \"yourself (a UUIDv7), or run somewhere `crypto.getRandomValues` exists.\",\n    )\n  }\n\n  const bytes = webcrypto.getRandomValues(new Uint8Array(16))\n\n  // Big-endian ms in the first six bytes, split in two so the arithmetic\n  // stays 32-bit safe without BigInt.\n  const ms = Math.max(0, Math.trunc(atMs))\n  const high = Math.floor(ms / 0x1_0000_0000) // the top 16 bits of 48\n  const low = ms >>> 0 // the bottom 32\n  bytes[0] = (high >>> 8) & 0xff\n  bytes[1] = high & 0xff\n  bytes[2] = (low >>> 24) & 0xff\n  bytes[3] = (low >>> 16) & 0xff\n  bytes[4] = (low >>> 8) & 0xff\n  bytes[5] = low & 0xff\n\n  bytes[6] = (bytes[6]! & 0x0f) | 0x70 // version 7\n  bytes[8] = (bytes[8]! & 0x3f) | 0x80 // variant 10\n\n  const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\")).join(\"\")\n\n  return [\n    hex.slice(0, 8),\n    hex.slice(8, 12),\n    hex.slice(12, 16),\n    hex.slice(16, 20),\n    hex.slice(20),\n  ].join(\"-\")\n}\n"]}