mbase-sdk 0.1.0

package/dist/index.cjs

@@ -0,0 +1,589 @@
+'use strict';
+
+// src/errors.ts
+var MeterbaseError = class extends Error {
+  constructor(message, options) {
+    super(message, options);
+    this.name = new.target.name;
+  }
+};
+var APIError = class extends MeterbaseError {
+  status;
+  code;
+  /** From `X-Request-Id`, when the engine sends one. */
+  requestId;
+  body;
+  constructor(args) {
+    super(args.message);
+    this.status = args.status;
+    this.code = args.code;
+    this.requestId = args.requestId;
+    this.body = args.body;
+  }
+};
+var AuthenticationError = class extends APIError {
+};
+var PermissionDeniedError = class extends APIError {
+};
+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;
+  constructor(args) {
+    super(args);
+    this.existingEventId = existingEventId(args.body);
+  }
+};
+var InvalidRequestError = class extends APIError {
+};
+var RateLimitError = class extends APIError {
+  /** Seconds to wait, from `Retry-After`, when the engine sends one. */
+  retryAfter;
+  constructor(args) {
+    super(args);
+    this.retryAfter = args.retryAfter;
+  }
+};
+var ServerError = class extends APIError {
+};
+var ConnectionError = class extends MeterbaseError {
+};
+var TimeoutError = class extends ConnectionError {
+};
+function errorFromResponse(args) {
+  switch (args.status) {
+    case 401:
+      return new AuthenticationError(args);
+    case 403:
+      return new PermissionDeniedError(args);
+    case 404:
+      return new NotFoundError(args);
+    case 409:
+      return args.code === "idempotency_conflict" ? new IdempotencyConflictError(args) : new ConflictError(args);
+    case 422:
+      return new InvalidRequestError(args);
+    case 429:
+      return new RateLimitError(args);
+    default:
+      return args.status >= 500 ? new ServerError(args) : new APIError(args);
+  }
+}
+function existingEventId(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;
+}
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.meterbase.tech";
+var DEFAULT_TIMEOUT = 1e4;
+var DEFAULT_MAX_RETRIES = 2;
+var MAX_BACKOFF = 8e3;
+var Client = class {
+  #apiKey;
+  #baseUrl;
+  #timeout;
+  #maxRetries;
+  #fetch;
+  constructor(options) {
+    if (!options.apiKey) {
+      throw new MeterbaseError(
+        "An API key is required: new Meterbase({ apiKey: 'mb_sk_live_\u2026' })."
+      );
+    }
+    this.#apiKey = options.apiKey;
+    this.#baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.#timeout = options.timeout ?? DEFAULT_TIMEOUT;
+    this.#maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    this.#fetch = options.fetch ?? globalThis.fetch;
+    if (typeof this.#fetch !== "function") {
+      throw new MeterbaseError(
+        "No fetch implementation: pass one as `fetch`, or run on Node 18+."
+      );
+    }
+  }
+  async request(req) {
+    const maxRetries = req.maxRetries ?? this.#maxRetries;
+    const retryable = req.method === "GET" || req.method === "DELETE" || req.idempotent === true;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      if (attempt > 0) await sleep(backoff(attempt, lastError));
+      try {
+        const response = await this.#send(req);
+        if (response.ok) return await parseBody(response);
+        const error = await errorFrom(response);
+        if (retryable && attempt < maxRetries && shouldRetry(response.status)) {
+          lastError = error;
+          continue;
+        }
+        throw error;
+      } catch (cause) {
+        if (cause instanceof MeterbaseError && !(cause instanceof ConnectionError)) {
+          throw cause;
+        }
+        if (!retryable || attempt >= maxRetries) throw cause;
+        lastError = cause;
+      }
+    }
+    throw lastError;
+  }
+  async #send(req) {
+    const url = new URL(this.#baseUrl + req.path);
+    for (const [key, value] of Object.entries(req.query ?? {})) {
+      if (value !== void 0) url.searchParams.set(key, String(value));
+    }
+    const headers = {
+      authorization: `Bearer ${this.#apiKey}`,
+      accept: "application/json"
+    };
+    if (req.body !== void 0) headers["content-type"] = "application/json";
+    const timeout = req.timeout ?? this.#timeout;
+    const controller = new AbortController();
+    const onAbort = () => controller.abort(req.signal?.reason);
+    req.signal?.addEventListener("abort", onAbort, { once: true });
+    let timedOut = false;
+    const timer = setTimeout(() => {
+      timedOut = true;
+      controller.abort();
+    }, timeout);
+    try {
+      return await this.#fetch(url, {
+        method: req.method,
+        headers,
+        body: req.body === void 0 ? void 0 : JSON.stringify(req.body),
+        signal: controller.signal
+      });
+    } catch (cause) {
+      if (timedOut) {
+        throw new TimeoutError(`Request timed out after ${timeout}ms.`, {
+          cause
+        });
+      }
+      if (req.signal?.aborted) throw cause;
+      throw new ConnectionError(`Could not reach ${url.origin}.`, { cause });
+    } finally {
+      clearTimeout(timer);
+      req.signal?.removeEventListener("abort", onAbort);
+    }
+  }
+};
+function shouldRetry(status) {
+  return status === 408 || status === 429 || status >= 500;
+}
+function backoff(attempt, lastError) {
+  const retryAfter = lastError && typeof lastError === "object" && "retryAfter" in lastError ? lastError.retryAfter : void 0;
+  if (retryAfter !== void 0) return Math.min(retryAfter * 1e3, MAX_BACKOFF);
+  const ceiling = Math.min(500 * 2 ** (attempt - 1), MAX_BACKOFF);
+  return Math.random() * ceiling;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function parseBody(response) {
+  if (response.status === 204) return void 0;
+  const text = await response.text();
+  if (text === "") return void 0;
+  try {
+    return JSON.parse(text);
+  } catch (cause) {
+    throw new MeterbaseError("The engine returned a body that is not JSON.", {
+      cause
+    });
+  }
+}
+async function errorFrom(response) {
+  const body = await response.text();
+  const parsed = parseErrorBody(body);
+  const retryAfterHeader = response.headers.get("retry-after");
+  const retryAfter = retryAfterHeader ? Number(retryAfterHeader) : void 0;
+  return errorFromResponse({
+    status: response.status,
+    code: parsed?.code ?? `http_${response.status}`,
+    message: parsed?.message ?? `The engine responded ${response.status}.`,
+    requestId: response.headers.get("x-request-id") ?? void 0,
+    retryAfter: retryAfter !== void 0 && Number.isFinite(retryAfter) ? retryAfter : void 0,
+    body: body === "" ? void 0 : safeParse(body) ?? body
+  });
+}
+function parseErrorBody(body) {
+  const parsed = safeParse(body);
+  const error = parsed?.error;
+  if (!error?.code || !error.message) return void 0;
+  return { code: error.code, message: error.message };
+}
+function safeParse(body) {
+  try {
+    return JSON.parse(body);
+  } catch {
+    return void 0;
+  }
+}
+
+// src/resources/customer-allowances.ts
+var CustomerAllowances = class {
+  #client;
+  constructor(client) {
+    this.#client = client;
+  }
+  grant(customerId, params, options) {
+    return this.#client.request({
+      ...options,
+      method: "POST",
+      path: `/v1/customers/${encodeURIComponent(customerId)}/allowances`,
+      body: params
+    });
+  }
+  /** Open grants only, unless `include_closed`. */
+  list(customerId, params = {}, options) {
+    return this.#client.request({
+      ...options,
+      method: "GET",
+      path: `/v1/customers/${encodeURIComponent(customerId)}/allowances`,
+      query: {
+        meter_id: params.meter_id,
+        include_closed: params.include_closed
+      }
+    });
+  }
+  retrieve(customerId, allowanceId, options) {
+    return this.#client.request({
+      ...options,
+      method: "GET",
+      path: `/v1/customers/${encodeURIComponent(customerId)}/allowances/${encodeURIComponent(allowanceId)}`
+    });
+  }
+  /** Withdraws what is left without erasing what was consumed. Idempotent. */
+  revoke(customerId, allowanceId, options) {
+    return this.#client.request({
+      ...options,
+      method: "DELETE",
+      path: `/v1/customers/${encodeURIComponent(customerId)}/allowances/${encodeURIComponent(allowanceId)}`
+    });
+  }
+};
+
+// src/resources/customer-plan.ts
+var CustomerPlan = class {
+  #client;
+  constructor(client) {
+    this.#client = client;
+  }
+  /** Returns the instruction as recorded, which is where to read when it lands. */
+  assign(customerId, params, options) {
+    return this.#client.request({
+      ...options,
+      method: "POST",
+      path: `/v1/customers/${encodeURIComponent(customerId)}/plan`,
+      body: params
+    });
+  }
+  /**
+   * The plan in force now, which is not always the newest instruction: a
+   * change dated ahead does not govern yet. Throws NotFoundError when the
+   * customer holds no plan.
+   */
+  retrieve(customerId, options) {
+    return this.#client.request({
+      ...options,
+      method: "GET",
+      path: `/v1/customers/${encodeURIComponent(customerId)}/plan`
+    });
+  }
+  /** Every instruction, superseded ones included: it is the whole trail. */
+  history(customerId, options) {
+    return this.#client.request({
+      ...options,
+      method: "GET",
+      path: `/v1/customers/${encodeURIComponent(customerId)}/plan/history`
+    });
+  }
+};
+
+// src/resources/customers.ts
+var Customers = class {
+  /** The plan they hold, and the trail of instructions that got them there. */
+  plan;
+  /** Grants, which sit on top of whatever the plan gives. */
+  allowances;
+  #client;
+  constructor(client) {
+    this.#client = client;
+    this.plan = new CustomerPlan(client);
+    this.allowances = new CustomerAllowances(client);
+  }
+  create(params, options) {
+    return this.#client.request({
+      ...options,
+      method: "POST",
+      path: "/v1/customers",
+      body: params
+    });
+  }
+  list(params = {}, options) {
+    return this.#client.request({
+      ...options,
+      method: "GET",
+      path: "/v1/customers",
+      query: { include_deleted: params.include_deleted }
+    });
+  }
+  retrieve(id, options) {
+    return this.#client.request({
+      ...options,
+      method: "GET",
+      path: `/v1/customers/${encodeURIComponent(id)}`
+    });
+  }
+  /**
+   * Resolves the tenant's own identifier, or null. The engine answers this as
+   * a filtered list, so a miss is an empty collection rather than a 404.
+   */
+  async retrieveByExternalId(externalId, options) {
+    const { data } = await this.#client.request({
+      ...options,
+      method: "GET",
+      path: "/v1/customers",
+      query: { external_id: externalId }
+    });
+    return data[0] ?? null;
+  }
+  update(id, params, options) {
+    return this.#client.request({
+      ...options,
+      method: "PATCH",
+      path: `/v1/customers/${encodeURIComponent(id)}`,
+      body: params
+    });
+  }
+  /** Soft delete: usage and assignments keep referencing the customer. */
+  delete(id, options) {
+    return this.#client.request({
+      ...options,
+      method: "DELETE",
+      path: `/v1/customers/${encodeURIComponent(id)}`
+    });
+  }
+};
+
+// src/resources/meters.ts
+var Meters = class {
+  #client;
+  constructor(client) {
+    this.#client = client;
+  }
+  create(params, options) {
+    return this.#client.request({
+      ...options,
+      method: "POST",
+      path: "/v1/meters",
+      body: params
+    });
+  }
+  list(params = {}, options) {
+    return this.#client.request({
+      ...options,
+      method: "GET",
+      path: "/v1/meters",
+      query: { include_archived: params.include_archived }
+    });
+  }
+  retrieve(id, options) {
+    return this.#client.request({
+      ...options,
+      method: "GET",
+      path: `/v1/meters/${encodeURIComponent(id)}`
+    });
+  }
+  update(id, params, options) {
+    return this.#client.request({
+      ...options,
+      method: "PATCH",
+      path: `/v1/meters/${encodeURIComponent(id)}`,
+      body: params
+    });
+  }
+  /** Soft delete: plans and usage keep referencing the meter. Idempotent. */
+  archive(id, options) {
+    return this.#client.request({
+      ...options,
+      method: "DELETE",
+      path: `/v1/meters/${encodeURIComponent(id)}`
+    });
+  }
+};
+
+// src/resources/plans.ts
+var PlanAllowances = class {
+  #client;
+  constructor(client) {
+    this.#client = client;
+  }
+  set(planId, params, options) {
+    return this.#client.request({
+      ...options,
+      method: "POST",
+      path: `/v1/plans/${encodeURIComponent(planId)}/allowances`,
+      body: params
+    });
+  }
+  /** Every version of every meter, newest first — history, not just current. */
+  list(planId, params = {}, options) {
+    return this.#client.request({
+      ...options,
+      method: "GET",
+      path: `/v1/plans/${encodeURIComponent(planId)}/allowances`,
+      query: { meter_id: params.meter_id }
+    });
+  }
+};
+var Plans = class {
+  allowances;
+  #client;
+  constructor(client) {
+    this.#client = client;
+    this.allowances = new PlanAllowances(client);
+  }
+  /** A new plan grants nothing; attach entitlement with `allowances.set`. */
+  create(params, options) {
+    return this.#client.request({
+      ...options,
+      method: "POST",
+      path: "/v1/plans",
+      body: params
+    });
+  }
+  list(params = {}, options) {
+    return this.#client.request({
+      ...options,
+      method: "GET",
+      path: "/v1/plans",
+      query: { include_archived: params.include_archived }
+    });
+  }
+  retrieve(id, options) {
+    return this.#client.request({
+      ...options,
+      method: "GET",
+      path: `/v1/plans/${encodeURIComponent(id)}`
+    });
+  }
+  update(id, params, options) {
+    return this.#client.request({
+      ...options,
+      method: "PATCH",
+      path: `/v1/plans/${encodeURIComponent(id)}`,
+      body: params
+    });
+  }
+  /**
+   * Stops new assignments without withdrawing capacity from anyone already on
+   * the plan, which is why an archived plan still resolves by id. Idempotent.
+   */
+  archive(id, options) {
+    return this.#client.request({
+      ...options,
+      method: "DELETE",
+      path: `/v1/plans/${encodeURIComponent(id)}`
+    });
+  }
+};
+
+// src/index.ts
+var Meterbase = class {
+  customers;
+  meters;
+  plans;
+  #client;
+  constructor(options) {
+    this.#client = new Client(options);
+    this.customers = new Customers(this.#client);
+    this.meters = new Meters(this.#client);
+    this.plans = new Plans(this.#client);
+  }
+  /**
+   * Asks whether a customer may consume `quantity` of a meter, named by the
+   * tenant's own external id and the meter's key. Absence of entitlement is
+   * not permission: a customer with no plan and no grant is denied.
+   *
+   * This is the gate, and the only call that ever refuses. Run it before the
+   * work; record the work with `track` afterwards.
+   */
+  check(params, options) {
+    return this.#client.request({
+      ...options,
+      method: "POST",
+      path: "/v1/check",
+      body: params
+    });
+  }
+  /**
+   * Records usage that already happened — the tokens were spent, the image
+   * was generated — so it never refuses on capacity. A quantity beyond the
+   * 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.
+   */
+  // `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({
+      ...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()
+      },
+      idempotent: true
+    });
+  }
+  /** Reports which workspace this key acts for. */
+  whoami(options) {
+    return this.#client.request({
+      ...options,
+      method: "GET",
+      path: "/v1/whoami"
+    });
+  }
+};
+function idempotencyKey() {
+  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("");
+  }
+  throw new MeterbaseError(
+    "No crypto to generate an idempotency key with: pass `idempotency_key` yourself, or run somewhere `crypto.getRandomValues` exists."
+  );
+}
+
+exports.APIError = APIError;
+exports.AuthenticationError = AuthenticationError;
+exports.ConflictError = ConflictError;
+exports.ConnectionError = ConnectionError;
+exports.IdempotencyConflictError = IdempotencyConflictError;
+exports.InvalidRequestError = InvalidRequestError;
+exports.Meterbase = Meterbase;
+exports.MeterbaseError = MeterbaseError;
+exports.NotFoundError = NotFoundError;
+exports.PermissionDeniedError = PermissionDeniedError;
+exports.RateLimitError = RateLimitError;
+exports.ServerError = ServerError;
+exports.TimeoutError = TimeoutError;
+exports.errorFromResponse = errorFromResponse;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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 {}\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 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 { AssignPlanParams, Assignment, List } from \"../types.js\"\n\n/**\n * Which plan a customer holds. The history is append-only: there is no patch\n * and no delete, and assigning a plan to a customer who already has one is\n * the same call as their first.\n */\nexport class CustomerPlan {\n  readonly #client: Client\n\n  constructor(client: Client) {\n    this.#client = client\n  }\n\n  /** Returns the instruction as recorded, which is where to read when it lands. */\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   * The plan in force now, which is not always the newest instruction: a\n   * change dated ahead does not govern yet. Throws NotFoundError when the\n   * customer holds no plan.\n   */\n  retrieve(customerId: string, options?: RequestOptions): Promise<Assignment> {\n    return this.#client.request({\n      ...options,\n      method: \"GET\",\n      path: `/v1/customers/${encodeURIComponent(customerId)}/plan`,\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  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  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  retrieve(id: string, options?: RequestOptions): Promise<Customer> {\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. The engine answers this as\n   * a filtered list, so a miss is an empty collection rather than a 404.\n   */\n  async retrieveByExternalId(\n    externalId: string,\n    options?: RequestOptions,\n  ): Promise<Customer | null> {\n    const { data } = await this.#client.request<List<Customer>>({\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"]}