@aipricinglab/sdk 0.1.0

package/README.md

@@ -0,0 +1,231 @@
+# @aipricinglab/sdk
+
+[![npm version](https://img.shields.io/npm/v/@aipricinglab/sdk.svg)](https://www.npmjs.com/package/@aipricinglab/sdk)
+
+The official TypeScript SDK for **[AiPricingLab](https://aipricinglab.space)** — drop-in usage metering, limits, and plan enforcement for AI-powered apps.
+
+Stop building your own meter for LLM tokens, image generations, video seconds, or any other AI consumption. Define plans in the dashboard, install this SDK, and ship.
+
+- 🌐 Website: <https://aipricinglab.space>
+- 📚 Docs: <https://aipricinglab.space/docs>
+- 🐛 Issues: <https://aipricinglab.space/support>
+
+---
+
+## Features
+
+- **Provider-agnostic** — works with OpenAI, Anthropic, Replicate, Fal, your own models, anything you bill against.
+- **Atomic reservations** — `reserve` / `commit` / `release` prevents parallel requests from blowing past limits.
+- **Zero runtime dependencies** — uses the platform `fetch`. Tiny bundle, works in Node, Bun, Deno, Edge, and the browser.
+- **Typed errors** — every failure mode is a typed `AiPricingLabError` with a stable `code`.
+- **Public + secret keys** — read a user's own usage from the browser with `pk_live_...`, do everything else from the backend with `sk_live_...`.
+
+## Install
+
+```bash
+npm install @aipricinglab/sdk
+# or
+pnpm add @aipricinglab/sdk
+# or
+yarn add @aipricinglab/sdk
+```
+
+Requires Node 18+ (or any runtime with global `fetch`).
+
+## Quick start
+
+Grab a secret key from your app's **API keys** tab at <https://aipricinglab.space>, then:
+
+```ts
+import { createClient } from '@aipricinglab/sdk';
+
+const apl = createClient({ apiKey: process.env.AIPRICINGLAB_KEY! });
+
+// Just record consumption — fire-and-forget.
+await apl.track('user_abc123', 'image.flux-pro', 1);
+```
+
+That's it. The event is now visible in your AiPricingLab dashboard, counted against any matching plan limits.
+
+### Event naming convention
+
+The plan builder generates match rules in the form **`<category>.<modelId>`**, where `category` is one of `image`, `llm`, `video`, `audio`. Use the same shape in your `track` / `canUse` / `reserve` calls so events count toward plan rows automatically:
+
+| Category | Example event name |
+|---|---|
+| Image generation | `image.flux-pro`, `image.gemini-3.1-image` |
+| Language model | `llm.gpt-4o`, `llm.claude-sonnet-4-6` |
+| Video generation | `video.runway-gen3`, `video.veo-2` |
+| Audio generation | `audio.elevenlabs-v2`, `audio.whisper` |
+
+A plan can also have a **category total** (e.g. *"30 images of any kind per month"*). Those use the wildcard pattern `<category>.*`, which matches any event that starts with that prefix — you don't need to emit anything special.
+
+You're free to use any other event names too — they just won't match the structural plan rows; they'll only fire if you've added a matching custom group.
+
+## Reserve / commit / release (recommended)
+
+For strict enforcement, use the three-step pattern. It atomically increments the counter *before* the AI call so two parallel requests can't both squeeze through under the limit:
+
+```ts
+import { createClient, AiPricingLabError } from '@aipricinglab/sdk';
+
+const apl = createClient({ apiKey: process.env.AIPRICINGLAB_KEY! });
+
+async function generateImage(userId: string, prompt: string) {
+  // 1. Reserve quota before the AI call.
+  const reservation = await apl.reserve(userId, 'image.flux-pro', 1);
+
+  if (!reservation.allowed) {
+    throw new Error(`Limit reached: ${reservation.reasons?.join(', ')}`);
+  }
+
+  try {
+    const image = await callFluxPro(prompt);
+
+    // 2. Commit on success — the charge is final.
+    await apl.commit(reservation.reservationId!);
+    return image;
+  } catch (err) {
+    // 3. Release on failure — the user is not charged.
+    await apl.release(reservation.reservationId!);
+    throw err;
+  }
+}
+```
+
+Reservations auto-expire after 60 seconds if you forget to commit or release, so a crashed server won't permanently lock quota.
+
+## Track (fire-and-forget)
+
+Simpler, no atomicity guarantee. Use it when slight over-counting is acceptable.
+
+### `quantity` semantics
+
+`quantity` is **the number of units the event consumed** in whatever unit the matching plan limit uses:
+
+- For an `image` plan with unit `count` → `quantity = 1` per generation.
+- For an `llm` plan with unit `tokens` → `quantity = totalInputTokens + totalOutputTokens`.
+- For an `llm` plan with unit `cents` → `quantity = costInCents` (integer cents).
+- For a `video` plan with unit `seconds` → `quantity = clipLengthInSeconds`.
+
+```ts
+// LLM call — pass total tokens consumed
+await apl.track('user_abc123', 'llm.gpt-4o', 1842, {
+  inputTokens: '920',
+  outputTokens: '922',
+});
+
+// Video clip — pass duration in seconds
+await apl.track('user_abc123', 'video.runway-gen3', 8);
+```
+
+## Check without charging
+
+```ts
+const { allowed, reasons } = await apl.canUse('user_abc123', 'image.flux-pro');
+
+if (!allowed) {
+  return showUpgradePrompt(reasons);
+}
+```
+
+Or the boolean shorthand:
+
+```ts
+if (await apl.can('user_abc123', 'image.flux-pro')) {
+  // proceed
+}
+```
+
+## Variant-gated plan rows
+
+Some plans gate a model by output tier — e.g. *"100 standard images, 10 4K images"*. Pass the `variant` key in `metadata` so the right bucket is incremented:
+
+```ts
+await apl.track('user_abc123', 'image.gemini-3.1-image', 1, { variant: '4k' });
+```
+
+`variant` is the only reserved metadata key — everything else is yours.
+
+### Metadata is string-only
+
+Metadata values must be strings (`Record<string, string>`). The API rejects numbers and booleans, so coerce them on your side:
+
+```ts
+await apl.track('user_abc123', 'llm.gpt-4o', 1842, {
+  inputTokens: String(920),    // ✅
+  cached: String(true),         // ✅
+  // outputTokens: 922,         // ❌ rejected
+});
+```
+
+## Read a user's own usage (browser-safe)
+
+Use a `pk_live_...` key in client-side code. Public keys can only read usage; they cannot track, reserve, or modify subscriptions. The SDK auto-routes public keys to the public-safe endpoint:
+
+```ts
+const apl = createClient({ apiKey: 'pk_live_...' });
+
+const usage = await apl.usage(currentUserId);
+// → { userId, period: { start, end } | null, counters: [{ groupId, count, costCents }, ...] }
+```
+
+`period` is `null` when the user has no active subscription on the app.
+
+## Manage subscriptions
+
+Move a user onto a plan (or off it) from your backend:
+
+```ts
+await apl.upsertSubscription({
+  userId: 'user_abc123',
+  planId: 'plan_pro_monthly',
+});
+```
+
+## Error handling
+
+Every method throws a typed `AiPricingLabError` on failure:
+
+```ts
+import { AiPricingLabError } from '@aipricinglab/sdk';
+
+try {
+  await apl.track('user_abc123', 'image.flux-pro');
+} catch (err) {
+  if (err instanceof AiPricingLabError) {
+    console.error(err.code, err.status, err.message);
+    // err.code: 'limit_reached' | 'invalid_key' | 'not_found' | 'workspace_limit_reached' | ...
+  }
+}
+```
+
+## API reference
+
+| Method | Purpose |
+|---|---|
+| `track(userId, event, quantity?, metadata?)` | Record consumption. |
+| `canUse(userId, event, quantity?, metadata?)` | Check if allowed; returns `{ allowed, reasons, details }`. |
+| `can(userId, event, quantity?, metadata?)` | Boolean shorthand for `canUse`. |
+| `reserve(userId, event, quantity?, metadata?)` | Atomically hold quota; returns a `reservationId`. |
+| `commit(reservationId)` | Confirm a reservation. |
+| `release(reservationId)` | Cancel a reservation; quota returned. |
+| `usage(userId, event?)` | Read a user's current counters. |
+| `upsertSubscription({ userId, planId })` | Assign or change a user's plan. |
+
+Full request/response types are exported from the package — your editor will pick them up.
+
+## Configuration
+
+```ts
+createClient({
+  apiKey: 'sk_live_...',         // required
+  baseUrl: 'https://www.aipricinglab.space', // optional, defaults to production
+});
+```
+
+Set `baseUrl` only if you're running a self-hosted instance.
+
+## License
+
+MIT © [AiPricingLab](https://aipricinglab.space)

package/dist/index.d.mts

@@ -0,0 +1,144 @@
+type LimitUnit = 'count' | 'tokens' | 'seconds' | 'cents';
+interface MatchRule {
+    event: string;
+    metadata?: Record<string, string> | undefined;
+}
+interface LimitGroup {
+    id: string;
+    label: string;
+    unit: LimitUnit;
+    quota: number;
+    matches: MatchRule[];
+}
+interface PlanLimits {
+    groups: LimitGroup[];
+}
+type PeriodType = 'daily' | 'weekly' | 'monthly' | 'lifetime';
+type PeriodAnchor = 'subscription_start' | 'calendar';
+type EventMetadata = Record<string, string>;
+interface TrackResponseData {
+    eventId: string;
+    counters: CounterSummary[];
+}
+interface CounterSummary {
+    groupId: string;
+    count: number;
+    costCents: number;
+}
+type ErrorCode = 'not_found' | 'invalid_key' | 'requires_secret_key' | 'limit_reached' | 'workspace_limit_reached' | 'invalid_request' | 'reservation_expired' | 'reservation_not_pending' | 'internal_error' | 'not_implemented';
+interface ApiError {
+    code: ErrorCode;
+    message: string;
+}
+interface ApiOk<T> {
+    ok: true;
+    data: T;
+}
+interface ApiFail {
+    ok: false;
+    error: ApiError;
+}
+type ApiResponse<T> = ApiOk<T> | ApiFail;
+interface CanUseResponseData {
+    allowed: boolean;
+    reasons: string[];
+    details: {
+        groupId: string;
+        current: number;
+        quota: number;
+        resetsAt: string | null;
+    }[];
+}
+interface ReserveResponseData {
+    allowed: boolean;
+    reservationId?: string;
+    expiresAt?: string;
+    reasons?: string[];
+}
+interface UsageResponseData {
+    userId: string;
+    period: {
+        start: string;
+        end: string | null;
+    } | null;
+    counters: CounterSummary[];
+}
+interface UpsertSubscriptionRequest {
+    userId: string;
+    planId: string;
+    customLimits?: PlanLimits;
+    endsAt?: string;
+}
+interface UpsertSubscriptionResponseData {
+    subscriptionId: string;
+    userId: string;
+    planId: string;
+    startedAt: string;
+}
+
+interface ClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+declare class AiPricingLabClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(opts: ClientOptions);
+    /**
+     * Record that a user consumed something.
+     *
+     * `metadata` is matched against the `metadata` filters on plan match rules.
+     * The dashboard uses one reserved key — **`variant`** — when a plan row gates
+     * a model to a specific output tier (e.g. image quality `1k`/`2k`/`4k`,
+     * video tier `standard`/`fast`/`lite`). Pass it through so variant-gated
+     * buckets count the event:
+     *
+     *     await apl.track('user_123', 'image.gemini-3.1-image', 1, { variant: '4k' });
+     */
+    track(userId: string, event: string, quantity?: number, metadata?: EventMetadata): Promise<TrackResponseData>;
+    /**
+     * Check if a user is allowed to perform an action.
+     * Returns `{ allowed, reasons, details }`.
+     * Use `.can()` if you only need the boolean.
+     *
+     * Pass `metadata.variant` (e.g. `'4k'`, `'standard'`) when a plan row gates
+     * the model to a specific output tier — see {@link AiPricingLabClient.track}.
+     */
+    canUse(userId: string, event: string, quantity?: number, metadata?: EventMetadata): Promise<CanUseResponseData>;
+    /** Shorthand: returns `true` if allowed, `false` if the user hit a limit. */
+    can(userId: string, event: string, quantity?: number, metadata?: EventMetadata): Promise<boolean>;
+    /**
+     * Atomically reserve quota before doing the AI call.
+     * On success call `commit(reservationId)`, on failure call `release(reservationId)`.
+     *
+     * Pass `metadata.variant` (e.g. `'4k'`, `'standard'`) when a plan row gates
+     * the model to a specific output tier — see {@link AiPricingLabClient.track}.
+     */
+    reserve(userId: string, event: string, quantity?: number, metadata?: EventMetadata): Promise<ReserveResponseData>;
+    /** Confirm a reservation after a successful AI call. */
+    commit(reservationId: string): Promise<void>;
+    /** Cancel a reservation after a failed AI call so quota is returned. */
+    release(reservationId: string): Promise<void>;
+    /**
+     * Get current usage counters for a user.
+     *
+     * Routes to `/api/v1/usage/me` for public (`pk_live_`) keys — that endpoint
+     * is the only one that accepts public keys. Secret keys hit `/api/v1/usage`.
+     */
+    usage(userId: string, event?: string): Promise<UsageResponseData>;
+    /** Assign or update a user's plan subscription. */
+    upsertSubscription(params: UpsertSubscriptionRequest): Promise<UpsertSubscriptionResponseData>;
+}
+declare function createClient(opts: ClientOptions): AiPricingLabClient;
+
+declare class AiPricingLabError extends Error {
+    readonly code: ErrorCode;
+    readonly status: number;
+    constructor(opts: {
+        code: ErrorCode;
+        message: string;
+        status: number;
+    });
+}
+
+export { AiPricingLabClient, AiPricingLabError, type ApiError, type ApiResponse, type CanUseResponseData, type ClientOptions, type CounterSummary, type ErrorCode, type EventMetadata, type LimitGroup, type LimitUnit, type MatchRule, type PeriodAnchor, type PeriodType, type PlanLimits, type ReserveResponseData, type TrackResponseData, type UpsertSubscriptionRequest, type UpsertSubscriptionResponseData, type UsageResponseData, createClient };

package/dist/index.d.ts

@@ -0,0 +1,144 @@
+type LimitUnit = 'count' | 'tokens' | 'seconds' | 'cents';
+interface MatchRule {
+    event: string;
+    metadata?: Record<string, string> | undefined;
+}
+interface LimitGroup {
+    id: string;
+    label: string;
+    unit: LimitUnit;
+    quota: number;
+    matches: MatchRule[];
+}
+interface PlanLimits {
+    groups: LimitGroup[];
+}
+type PeriodType = 'daily' | 'weekly' | 'monthly' | 'lifetime';
+type PeriodAnchor = 'subscription_start' | 'calendar';
+type EventMetadata = Record<string, string>;
+interface TrackResponseData {
+    eventId: string;
+    counters: CounterSummary[];
+}
+interface CounterSummary {
+    groupId: string;
+    count: number;
+    costCents: number;
+}
+type ErrorCode = 'not_found' | 'invalid_key' | 'requires_secret_key' | 'limit_reached' | 'workspace_limit_reached' | 'invalid_request' | 'reservation_expired' | 'reservation_not_pending' | 'internal_error' | 'not_implemented';
+interface ApiError {
+    code: ErrorCode;
+    message: string;
+}
+interface ApiOk<T> {
+    ok: true;
+    data: T;
+}
+interface ApiFail {
+    ok: false;
+    error: ApiError;
+}
+type ApiResponse<T> = ApiOk<T> | ApiFail;
+interface CanUseResponseData {
+    allowed: boolean;
+    reasons: string[];
+    details: {
+        groupId: string;
+        current: number;
+        quota: number;
+        resetsAt: string | null;
+    }[];
+}
+interface ReserveResponseData {
+    allowed: boolean;
+    reservationId?: string;
+    expiresAt?: string;
+    reasons?: string[];
+}
+interface UsageResponseData {
+    userId: string;
+    period: {
+        start: string;
+        end: string | null;
+    } | null;
+    counters: CounterSummary[];
+}
+interface UpsertSubscriptionRequest {
+    userId: string;
+    planId: string;
+    customLimits?: PlanLimits;
+    endsAt?: string;
+}
+interface UpsertSubscriptionResponseData {
+    subscriptionId: string;
+    userId: string;
+    planId: string;
+    startedAt: string;
+}
+
+interface ClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+declare class AiPricingLabClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(opts: ClientOptions);
+    /**
+     * Record that a user consumed something.
+     *
+     * `metadata` is matched against the `metadata` filters on plan match rules.
+     * The dashboard uses one reserved key — **`variant`** — when a plan row gates
+     * a model to a specific output tier (e.g. image quality `1k`/`2k`/`4k`,
+     * video tier `standard`/`fast`/`lite`). Pass it through so variant-gated
+     * buckets count the event:
+     *
+     *     await apl.track('user_123', 'image.gemini-3.1-image', 1, { variant: '4k' });
+     */
+    track(userId: string, event: string, quantity?: number, metadata?: EventMetadata): Promise<TrackResponseData>;
+    /**
+     * Check if a user is allowed to perform an action.
+     * Returns `{ allowed, reasons, details }`.
+     * Use `.can()` if you only need the boolean.
+     *
+     * Pass `metadata.variant` (e.g. `'4k'`, `'standard'`) when a plan row gates
+     * the model to a specific output tier — see {@link AiPricingLabClient.track}.
+     */
+    canUse(userId: string, event: string, quantity?: number, metadata?: EventMetadata): Promise<CanUseResponseData>;
+    /** Shorthand: returns `true` if allowed, `false` if the user hit a limit. */
+    can(userId: string, event: string, quantity?: number, metadata?: EventMetadata): Promise<boolean>;
+    /**
+     * Atomically reserve quota before doing the AI call.
+     * On success call `commit(reservationId)`, on failure call `release(reservationId)`.
+     *
+     * Pass `metadata.variant` (e.g. `'4k'`, `'standard'`) when a plan row gates
+     * the model to a specific output tier — see {@link AiPricingLabClient.track}.
+     */
+    reserve(userId: string, event: string, quantity?: number, metadata?: EventMetadata): Promise<ReserveResponseData>;
+    /** Confirm a reservation after a successful AI call. */
+    commit(reservationId: string): Promise<void>;
+    /** Cancel a reservation after a failed AI call so quota is returned. */
+    release(reservationId: string): Promise<void>;
+    /**
+     * Get current usage counters for a user.
+     *
+     * Routes to `/api/v1/usage/me` for public (`pk_live_`) keys — that endpoint
+     * is the only one that accepts public keys. Secret keys hit `/api/v1/usage`.
+     */
+    usage(userId: string, event?: string): Promise<UsageResponseData>;
+    /** Assign or update a user's plan subscription. */
+    upsertSubscription(params: UpsertSubscriptionRequest): Promise<UpsertSubscriptionResponseData>;
+}
+declare function createClient(opts: ClientOptions): AiPricingLabClient;
+
+declare class AiPricingLabError extends Error {
+    readonly code: ErrorCode;
+    readonly status: number;
+    constructor(opts: {
+        code: ErrorCode;
+        message: string;
+        status: number;
+    });
+}
+
+export { AiPricingLabClient, AiPricingLabError, type ApiError, type ApiResponse, type CanUseResponseData, type ClientOptions, type CounterSummary, type ErrorCode, type EventMetadata, type LimitGroup, type LimitUnit, type MatchRule, type PeriodAnchor, type PeriodType, type PlanLimits, type ReserveResponseData, type TrackResponseData, type UpsertSubscriptionRequest, type UpsertSubscriptionResponseData, type UsageResponseData, createClient };

package/dist/index.js

@@ -0,0 +1,170 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AiPricingLabClient: () => AiPricingLabClient,
+  AiPricingLabError: () => AiPricingLabError,
+  createClient: () => createClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var AiPricingLabError = class extends Error {
+  code;
+  status;
+  constructor(opts) {
+    super(opts.message);
+    this.name = "AiPricingLabError";
+    this.code = opts.code;
+    this.status = opts.status;
+  }
+};
+
+// src/http.ts
+async function request(baseUrl, apiKey, method, path, body) {
+  const url = `${baseUrl.replace(/\/$/, "")}${path}`;
+  const res = await fetch(url, {
+    method,
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`
+    },
+    ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+  });
+  const json = await res.json();
+  if (!json.ok) {
+    throw new AiPricingLabError({
+      code: json.error.code,
+      message: json.error.message,
+      status: res.status
+    });
+  }
+  return json.data;
+}
+
+// src/client.ts
+var AiPricingLabClient = class {
+  apiKey;
+  baseUrl;
+  constructor(opts) {
+    this.apiKey = opts.apiKey;
+    this.baseUrl = opts.baseUrl ?? "https://www.aipricinglab.space";
+  }
+  /**
+   * Record that a user consumed something.
+   *
+   * `metadata` is matched against the `metadata` filters on plan match rules.
+   * The dashboard uses one reserved key — **`variant`** — when a plan row gates
+   * a model to a specific output tier (e.g. image quality `1k`/`2k`/`4k`,
+   * video tier `standard`/`fast`/`lite`). Pass it through so variant-gated
+   * buckets count the event:
+   *
+   *     await apl.track('user_123', 'image.gemini-3.1-image', 1, { variant: '4k' });
+   */
+  async track(userId, event, quantity = 1, metadata) {
+    return request(this.baseUrl, this.apiKey, "POST", "/api/v1/track", {
+      userId,
+      event,
+      quantity,
+      metadata
+    });
+  }
+  /**
+   * Check if a user is allowed to perform an action.
+   * Returns `{ allowed, reasons, details }`.
+   * Use `.can()` if you only need the boolean.
+   *
+   * Pass `metadata.variant` (e.g. `'4k'`, `'standard'`) when a plan row gates
+   * the model to a specific output tier — see {@link AiPricingLabClient.track}.
+   */
+  async canUse(userId, event, quantity = 1, metadata) {
+    return request(this.baseUrl, this.apiKey, "POST", "/api/v1/can-use", {
+      userId,
+      event,
+      quantity,
+      metadata
+    });
+  }
+  /** Shorthand: returns `true` if allowed, `false` if the user hit a limit. */
+  async can(userId, event, quantity = 1, metadata) {
+    const { allowed } = await this.canUse(userId, event, quantity, metadata);
+    return allowed;
+  }
+  /**
+   * Atomically reserve quota before doing the AI call.
+   * On success call `commit(reservationId)`, on failure call `release(reservationId)`.
+   *
+   * Pass `metadata.variant` (e.g. `'4k'`, `'standard'`) when a plan row gates
+   * the model to a specific output tier — see {@link AiPricingLabClient.track}.
+   */
+  async reserve(userId, event, quantity = 1, metadata) {
+    return request(this.baseUrl, this.apiKey, "POST", "/api/v1/reserve", {
+      userId,
+      event,
+      quantity,
+      metadata
+    });
+  }
+  /** Confirm a reservation after a successful AI call. */
+  async commit(reservationId) {
+    await request(this.baseUrl, this.apiKey, "POST", "/api/v1/commit", {
+      reservationId
+    });
+  }
+  /** Cancel a reservation after a failed AI call so quota is returned. */
+  async release(reservationId) {
+    await request(this.baseUrl, this.apiKey, "POST", "/api/v1/release", {
+      reservationId
+    });
+  }
+  /**
+   * Get current usage counters for a user.
+   *
+   * Routes to `/api/v1/usage/me` for public (`pk_live_`) keys — that endpoint
+   * is the only one that accepts public keys. Secret keys hit `/api/v1/usage`.
+   */
+  async usage(userId, event) {
+    const qs = new URLSearchParams({ userId });
+    if (event) qs.set("event", event);
+    const path = this.apiKey.startsWith("pk_live_") ? `/api/v1/usage/me?${qs}` : `/api/v1/usage?${qs}`;
+    return request(this.baseUrl, this.apiKey, "GET", path);
+  }
+  /** Assign or update a user's plan subscription. */
+  async upsertSubscription(params) {
+    return request(
+      this.baseUrl,
+      this.apiKey,
+      "POST",
+      "/api/v1/subscriptions",
+      params
+    );
+  }
+};
+function createClient(opts) {
+  return new AiPricingLabClient(opts);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AiPricingLabClient,
+  AiPricingLabError,
+  createClient
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/http.ts","../src/client.ts"],"sourcesContent":["export { AiPricingLabClient, createClient } from './client';\nexport type { ClientOptions } from './client';\nexport { AiPricingLabError } from './errors';\nexport type {\n  EventMetadata,\n  TrackResponseData,\n  CounterSummary,\n  CanUseResponseData,\n  ReserveResponseData,\n  UsageResponseData,\n  UpsertSubscriptionRequest,\n  UpsertSubscriptionResponseData,\n  LimitGroup,\n  LimitUnit,\n  MatchRule,\n  PlanLimits,\n  PeriodType,\n  PeriodAnchor,\n  ErrorCode,\n  ApiError,\n  ApiResponse,\n} from './types';\n","import type { ErrorCode } from './types';\n\nexport class AiPricingLabError extends Error {\n  readonly code: ErrorCode;\n  readonly status: number;\n\n  constructor(opts: { code: ErrorCode; message: string; status: number }) {\n    super(opts.message);\n    this.name = 'AiPricingLabError';\n    this.code = opts.code;\n    this.status = opts.status;\n  }\n}\n","// Phase 9: internal fetch wrapper\nimport type { ApiResponse, ErrorCode } from './types';\nimport { AiPricingLabError } from './errors';\n\nexport async function request<T>(\n  baseUrl: string,\n  apiKey: string,\n  method: string,\n  path: string,\n  body?: unknown,\n): Promise<T> {\n  const url = `${baseUrl.replace(/\\/$/, '')}${path}`;\n  const res = await fetch(url, {\n    method,\n    headers: {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${apiKey}`,\n    },\n    ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n  });\n\n  const json = (await res.json()) as ApiResponse<T>;\n\n  if (!json.ok) {\n    throw new AiPricingLabError({\n      code: json.error.code as ErrorCode,\n      message: json.error.message,\n      status: res.status,\n    });\n  }\n\n  return json.data;\n}\n","import type {\n  TrackResponseData,\n  CanUseResponseData,\n  ReserveResponseData,\n  UsageResponseData,\n  UpsertSubscriptionRequest,\n  UpsertSubscriptionResponseData,\n  EventMetadata,\n} from './types';\nimport { request } from './http';\n\nexport interface ClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n}\n\nexport class AiPricingLabClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n\n  constructor(opts: ClientOptions) {\n    this.apiKey = opts.apiKey;\n    this.baseUrl = opts.baseUrl ?? 'https://www.aipricinglab.space';\n  }\n\n  /**\n   * Record that a user consumed something.\n   *\n   * `metadata` is matched against the `metadata` filters on plan match rules.\n   * The dashboard uses one reserved key — **`variant`** — when a plan row gates\n   * a model to a specific output tier (e.g. image quality `1k`/`2k`/`4k`,\n   * video tier `standard`/`fast`/`lite`). Pass it through so variant-gated\n   * buckets count the event:\n   *\n   *     await apl.track('user_123', 'image.gemini-3.1-image', 1, { variant: '4k' });\n   */\n  async track(\n    userId: string,\n    event: string,\n    quantity = 1,\n    metadata?: EventMetadata,\n  ): Promise<TrackResponseData> {\n    return request<TrackResponseData>(this.baseUrl, this.apiKey, 'POST', '/api/v1/track', {\n      userId,\n      event,\n      quantity,\n      metadata,\n    });\n  }\n\n  /**\n   * Check if a user is allowed to perform an action.\n   * Returns `{ allowed, reasons, details }`.\n   * Use `.can()` if you only need the boolean.\n   *\n   * Pass `metadata.variant` (e.g. `'4k'`, `'standard'`) when a plan row gates\n   * the model to a specific output tier — see {@link AiPricingLabClient.track}.\n   */\n  async canUse(\n    userId: string,\n    event: string,\n    quantity = 1,\n    metadata?: EventMetadata,\n  ): Promise<CanUseResponseData> {\n    return request<CanUseResponseData>(this.baseUrl, this.apiKey, 'POST', '/api/v1/can-use', {\n      userId,\n      event,\n      quantity,\n      metadata,\n    });\n  }\n\n  /** Shorthand: returns `true` if allowed, `false` if the user hit a limit. */\n  async can(userId: string, event: string, quantity = 1, metadata?: EventMetadata): Promise<boolean> {\n    const { allowed } = await this.canUse(userId, event, quantity, metadata);\n    return allowed;\n  }\n\n  /**\n   * Atomically reserve quota before doing the AI call.\n   * On success call `commit(reservationId)`, on failure call `release(reservationId)`.\n   *\n   * Pass `metadata.variant` (e.g. `'4k'`, `'standard'`) when a plan row gates\n   * the model to a specific output tier — see {@link AiPricingLabClient.track}.\n   */\n  async reserve(\n    userId: string,\n    event: string,\n    quantity = 1,\n    metadata?: EventMetadata,\n  ): Promise<ReserveResponseData> {\n    return request<ReserveResponseData>(this.baseUrl, this.apiKey, 'POST', '/api/v1/reserve', {\n      userId,\n      event,\n      quantity,\n      metadata,\n    });\n  }\n\n  /** Confirm a reservation after a successful AI call. */\n  async commit(reservationId: string): Promise<void> {\n    await request<Record<string, never>>(this.baseUrl, this.apiKey, 'POST', '/api/v1/commit', {\n      reservationId,\n    });\n  }\n\n  /** Cancel a reservation after a failed AI call so quota is returned. */\n  async release(reservationId: string): Promise<void> {\n    await request<Record<string, never>>(this.baseUrl, this.apiKey, 'POST', '/api/v1/release', {\n      reservationId,\n    });\n  }\n\n  /**\n   * Get current usage counters for a user.\n   *\n   * Routes to `/api/v1/usage/me` for public (`pk_live_`) keys — that endpoint\n   * is the only one that accepts public keys. Secret keys hit `/api/v1/usage`.\n   */\n  async usage(userId: string, event?: string): Promise<UsageResponseData> {\n    const qs = new URLSearchParams({ userId });\n    if (event) qs.set('event', event);\n    const path = this.apiKey.startsWith('pk_live_')\n      ? `/api/v1/usage/me?${qs}`\n      : `/api/v1/usage?${qs}`;\n    return request<UsageResponseData>(this.baseUrl, this.apiKey, 'GET', path);\n  }\n\n  /** Assign or update a user's plan subscription. */\n  async upsertSubscription(\n    params: UpsertSubscriptionRequest,\n  ): Promise<UpsertSubscriptionResponseData> {\n    return request<UpsertSubscriptionResponseData>(\n      this.baseUrl,\n      this.apiKey,\n      'POST',\n      '/api/v1/subscriptions',\n      params,\n    );\n  }\n}\n\nexport function createClient(opts: ClientOptions): AiPricingLabClient {\n  return new AiPricingLabClient(opts);\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,141 @@
+// src/errors.ts
+var AiPricingLabError = class extends Error {
+  code;
+  status;
+  constructor(opts) {
+    super(opts.message);
+    this.name = "AiPricingLabError";
+    this.code = opts.code;
+    this.status = opts.status;
+  }
+};
+
+// src/http.ts
+async function request(baseUrl, apiKey, method, path, body) {
+  const url = `${baseUrl.replace(/\/$/, "")}${path}`;
+  const res = await fetch(url, {
+    method,
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`
+    },
+    ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+  });
+  const json = await res.json();
+  if (!json.ok) {
+    throw new AiPricingLabError({
+      code: json.error.code,
+      message: json.error.message,
+      status: res.status
+    });
+  }
+  return json.data;
+}
+
+// src/client.ts
+var AiPricingLabClient = class {
+  apiKey;
+  baseUrl;
+  constructor(opts) {
+    this.apiKey = opts.apiKey;
+    this.baseUrl = opts.baseUrl ?? "https://www.aipricinglab.space";
+  }
+  /**
+   * Record that a user consumed something.
+   *
+   * `metadata` is matched against the `metadata` filters on plan match rules.
+   * The dashboard uses one reserved key — **`variant`** — when a plan row gates
+   * a model to a specific output tier (e.g. image quality `1k`/`2k`/`4k`,
+   * video tier `standard`/`fast`/`lite`). Pass it through so variant-gated
+   * buckets count the event:
+   *
+   *     await apl.track('user_123', 'image.gemini-3.1-image', 1, { variant: '4k' });
+   */
+  async track(userId, event, quantity = 1, metadata) {
+    return request(this.baseUrl, this.apiKey, "POST", "/api/v1/track", {
+      userId,
+      event,
+      quantity,
+      metadata
+    });
+  }
+  /**
+   * Check if a user is allowed to perform an action.
+   * Returns `{ allowed, reasons, details }`.
+   * Use `.can()` if you only need the boolean.
+   *
+   * Pass `metadata.variant` (e.g. `'4k'`, `'standard'`) when a plan row gates
+   * the model to a specific output tier — see {@link AiPricingLabClient.track}.
+   */
+  async canUse(userId, event, quantity = 1, metadata) {
+    return request(this.baseUrl, this.apiKey, "POST", "/api/v1/can-use", {
+      userId,
+      event,
+      quantity,
+      metadata
+    });
+  }
+  /** Shorthand: returns `true` if allowed, `false` if the user hit a limit. */
+  async can(userId, event, quantity = 1, metadata) {
+    const { allowed } = await this.canUse(userId, event, quantity, metadata);
+    return allowed;
+  }
+  /**
+   * Atomically reserve quota before doing the AI call.
+   * On success call `commit(reservationId)`, on failure call `release(reservationId)`.
+   *
+   * Pass `metadata.variant` (e.g. `'4k'`, `'standard'`) when a plan row gates
+   * the model to a specific output tier — see {@link AiPricingLabClient.track}.
+   */
+  async reserve(userId, event, quantity = 1, metadata) {
+    return request(this.baseUrl, this.apiKey, "POST", "/api/v1/reserve", {
+      userId,
+      event,
+      quantity,
+      metadata
+    });
+  }
+  /** Confirm a reservation after a successful AI call. */
+  async commit(reservationId) {
+    await request(this.baseUrl, this.apiKey, "POST", "/api/v1/commit", {
+      reservationId
+    });
+  }
+  /** Cancel a reservation after a failed AI call so quota is returned. */
+  async release(reservationId) {
+    await request(this.baseUrl, this.apiKey, "POST", "/api/v1/release", {
+      reservationId
+    });
+  }
+  /**
+   * Get current usage counters for a user.
+   *
+   * Routes to `/api/v1/usage/me` for public (`pk_live_`) keys — that endpoint
+   * is the only one that accepts public keys. Secret keys hit `/api/v1/usage`.
+   */
+  async usage(userId, event) {
+    const qs = new URLSearchParams({ userId });
+    if (event) qs.set("event", event);
+    const path = this.apiKey.startsWith("pk_live_") ? `/api/v1/usage/me?${qs}` : `/api/v1/usage?${qs}`;
+    return request(this.baseUrl, this.apiKey, "GET", path);
+  }
+  /** Assign or update a user's plan subscription. */
+  async upsertSubscription(params) {
+    return request(
+      this.baseUrl,
+      this.apiKey,
+      "POST",
+      "/api/v1/subscriptions",
+      params
+    );
+  }
+};
+function createClient(opts) {
+  return new AiPricingLabClient(opts);
+}
+export {
+  AiPricingLabClient,
+  AiPricingLabError,
+  createClient
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/http.ts","../src/client.ts"],"sourcesContent":["import type { ErrorCode } from './types';\n\nexport class AiPricingLabError extends Error {\n  readonly code: ErrorCode;\n  readonly status: number;\n\n  constructor(opts: { code: ErrorCode; message: string; status: number }) {\n    super(opts.message);\n    this.name = 'AiPricingLabError';\n    this.code = opts.code;\n    this.status = opts.status;\n  }\n}\n","// Phase 9: internal fetch wrapper\nimport type { ApiResponse, ErrorCode } from './types';\nimport { AiPricingLabError } from './errors';\n\nexport async function request<T>(\n  baseUrl: string,\n  apiKey: string,\n  method: string,\n  path: string,\n  body?: unknown,\n): Promise<T> {\n  const url = `${baseUrl.replace(/\\/$/, '')}${path}`;\n  const res = await fetch(url, {\n    method,\n    headers: {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${apiKey}`,\n    },\n    ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n  });\n\n  const json = (await res.json()) as ApiResponse<T>;\n\n  if (!json.ok) {\n    throw new AiPricingLabError({\n      code: json.error.code as ErrorCode,\n      message: json.error.message,\n      status: res.status,\n    });\n  }\n\n  return json.data;\n}\n","import type {\n  TrackResponseData,\n  CanUseResponseData,\n  ReserveResponseData,\n  UsageResponseData,\n  UpsertSubscriptionRequest,\n  UpsertSubscriptionResponseData,\n  EventMetadata,\n} from './types';\nimport { request } from './http';\n\nexport interface ClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n}\n\nexport class AiPricingLabClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n\n  constructor(opts: ClientOptions) {\n    this.apiKey = opts.apiKey;\n    this.baseUrl = opts.baseUrl ?? 'https://www.aipricinglab.space';\n  }\n\n  /**\n   * Record that a user consumed something.\n   *\n   * `metadata` is matched against the `metadata` filters on plan match rules.\n   * The dashboard uses one reserved key — **`variant`** — when a plan row gates\n   * a model to a specific output tier (e.g. image quality `1k`/`2k`/`4k`,\n   * video tier `standard`/`fast`/`lite`). Pass it through so variant-gated\n   * buckets count the event:\n   *\n   *     await apl.track('user_123', 'image.gemini-3.1-image', 1, { variant: '4k' });\n   */\n  async track(\n    userId: string,\n    event: string,\n    quantity = 1,\n    metadata?: EventMetadata,\n  ): Promise<TrackResponseData> {\n    return request<TrackResponseData>(this.baseUrl, this.apiKey, 'POST', '/api/v1/track', {\n      userId,\n      event,\n      quantity,\n      metadata,\n    });\n  }\n\n  /**\n   * Check if a user is allowed to perform an action.\n   * Returns `{ allowed, reasons, details }`.\n   * Use `.can()` if you only need the boolean.\n   *\n   * Pass `metadata.variant` (e.g. `'4k'`, `'standard'`) when a plan row gates\n   * the model to a specific output tier — see {@link AiPricingLabClient.track}.\n   */\n  async canUse(\n    userId: string,\n    event: string,\n    quantity = 1,\n    metadata?: EventMetadata,\n  ): Promise<CanUseResponseData> {\n    return request<CanUseResponseData>(this.baseUrl, this.apiKey, 'POST', '/api/v1/can-use', {\n      userId,\n      event,\n      quantity,\n      metadata,\n    });\n  }\n\n  /** Shorthand: returns `true` if allowed, `false` if the user hit a limit. */\n  async can(userId: string, event: string, quantity = 1, metadata?: EventMetadata): Promise<boolean> {\n    const { allowed } = await this.canUse(userId, event, quantity, metadata);\n    return allowed;\n  }\n\n  /**\n   * Atomically reserve quota before doing the AI call.\n   * On success call `commit(reservationId)`, on failure call `release(reservationId)`.\n   *\n   * Pass `metadata.variant` (e.g. `'4k'`, `'standard'`) when a plan row gates\n   * the model to a specific output tier — see {@link AiPricingLabClient.track}.\n   */\n  async reserve(\n    userId: string,\n    event: string,\n    quantity = 1,\n    metadata?: EventMetadata,\n  ): Promise<ReserveResponseData> {\n    return request<ReserveResponseData>(this.baseUrl, this.apiKey, 'POST', '/api/v1/reserve', {\n      userId,\n      event,\n      quantity,\n      metadata,\n    });\n  }\n\n  /** Confirm a reservation after a successful AI call. */\n  async commit(reservationId: string): Promise<void> {\n    await request<Record<string, never>>(this.baseUrl, this.apiKey, 'POST', '/api/v1/commit', {\n      reservationId,\n    });\n  }\n\n  /** Cancel a reservation after a failed AI call so quota is returned. */\n  async release(reservationId: string): Promise<void> {\n    await request<Record<string, never>>(this.baseUrl, this.apiKey, 'POST', '/api/v1/release', {\n      reservationId,\n    });\n  }\n\n  /**\n   * Get current usage counters for a user.\n   *\n   * Routes to `/api/v1/usage/me` for public (`pk_live_`) keys — that endpoint\n   * is the only one that accepts public keys. Secret keys hit `/api/v1/usage`.\n   */\n  async usage(userId: string, event?: string): Promise<UsageResponseData> {\n    const qs = new URLSearchParams({ userId });\n    if (event) qs.set('event', event);\n    const path = this.apiKey.startsWith('pk_live_')\n      ? `/api/v1/usage/me?${qs}`\n      : `/api/v1/usage?${qs}`;\n    return request<UsageResponseData>(this.baseUrl, this.apiKey, 'GET', path);\n  }\n\n  /** Assign or update a user's plan subscription. */\n  async upsertSubscription(\n    params: UpsertSubscriptionRequest,\n  ): Promise<UpsertSubscriptionResponseData> {\n    return request<UpsertSubscriptionResponseData>(\n      this.baseUrl,\n      this.apiKey,\n      'POST',\n      '/api/v1/subscriptions',\n      params,\n    );\n  }\n}\n\nexport function createClient(opts: ClientOptions): AiPricingLabClient {\n  return new AiPricingLabClient(opts);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@aipricinglab/sdk",
+  "version": "0.1.0",
+  "description": "Usage metering and limits SDK for AI-powered apps. Track LLM tokens, image generations, video seconds, and any other AI consumption — provider-agnostic.",
+  "keywords": [
+    "ai",
+    "metering",
+    "usage",
+    "limits",
+    "billing",
+    "rate-limiting",
+    "llm",
+    "tokens",
+    "openai",
+    "anthropic",
+    "stripe",
+    "saas"
+  ],
+  "homepage": "https://aipricinglab.space",
+  "bugs": {
+    "url": "https://aipricinglab.space/support"
+  },
+  "license": "MIT",
+  "author": "AiPricingLab",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3"
+  }
+}