@detent/sdk 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cyril Guillerminet
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+# @detent/sdk
+
+[![CI](https://github.com/cguillerminet/detent-sdk-ts/actions/workflows/ci.yml/badge.svg)](https://github.com/cguillerminet/detent-sdk-ts/actions/workflows/ci.yml)
+
+Typed TypeScript client for the [Detent](https://detent.dev) rate-limiting API.
+
+> Status: pre-release (v0.5.0).
+
+## Install
+
+```bash
+npm i @detent/sdk
+```
+
+## Usage
+
+```ts
+import { Detent } from '@detent/sdk'
+
+const rg = new Detent({ apiKey: process.env.DETENT_API_KEY! })
+
+// Rate-limit check (always resolves; fails open by default on transport error)
+const { allowed } = await rg.limit({ namespace: 'api', key: userId })
+if (!allowed) return res.status(429).end()
+
+// Concurrent-limit lease
+await rg.withLease({ namespace: 'jobs', key: userId }, async () => {
+  await runExpensiveJob()
+})
+
+// Read-only usage stats
+const stats = await rg.getStats({ namespace: 'api' })
+```
+
+### Configuration
+
+| Option      | Default                    | Notes                                            |
+|-------------|----------------------------|--------------------------------------------------|
+| `apiKey`    | — (required)               | `rg_live_…` / `rg_test_…`                         |
+| `baseUrl`   | `https://api.detent.dev`   | Override for self-host / tests                    |
+| `timeoutMs` | `1000`                     | Client-side transport timeout                     |
+| `failMode`  | `'open'`                   | `'open'` allows, `'closed'` denies on transport error |
+| `onError`   | —                          | Called on transport errors and 5xx responses before fail-open/closed |
+
+`limit()` never throws on a transport error or a 5xx server error — it returns `{ degraded: true }` and respects `failMode`.
+Only 4xx client errors (bad key, plan gate, unknown rule, malformed request) throw `DetentApiError`.

package/dist/index.cjs

@@ -0,0 +1,220 @@
+"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, {
+  Detent: () => Detent,
+  DetentApiError: () => DetentApiError,
+  DetentError: () => DetentError,
+  DetentLeaseDeniedError: () => DetentLeaseDeniedError,
+  DetentTransportError: () => DetentTransportError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var DetentError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "DetentError";
+  }
+};
+var DetentApiError = class extends DetentError {
+  status;
+  body;
+  constructor(status, body) {
+    super(`Detent API error ${status}: ${body.error}`);
+    this.name = "DetentApiError";
+    this.status = status;
+    this.body = body;
+  }
+};
+var DetentTransportError = class extends DetentError {
+  cause;
+  constructor(message, cause) {
+    super(message);
+    this.name = "DetentTransportError";
+    this.cause = cause;
+  }
+};
+var DetentLeaseDeniedError = class extends DetentError {
+  result;
+  constructor(result) {
+    super("Lease denied: no concurrent slot available");
+    this.name = "DetentLeaseDeniedError";
+    this.result = result;
+  }
+};
+
+// src/leases.ts
+async function acquireLease(request, opts) {
+  const body = {
+    namespace: opts.namespace,
+    key: opts.key,
+    ...opts.limit !== void 0 ? { limit: opts.limit } : {},
+    ...opts.windowMs !== void 0 ? { window_ms: opts.windowMs } : {}
+  };
+  const w = await request("POST", "/v1/leases", body);
+  const result = {
+    allowed: w.allowed,
+    leaseId: w.lease_id ?? void 0,
+    active: w.active,
+    limit: w.limit,
+    resetMs: w.reset_ms,
+    release: async () => {
+      if (!w.allowed || !w.lease_id) return;
+      return releaseLease(request, w.lease_id);
+    }
+  };
+  return result;
+}
+async function releaseLease(request, leaseId) {
+  return request("DELETE", `/v1/leases/${encodeURIComponent(leaseId)}`);
+}
+async function withLease(request, opts, fn) {
+  const lease = await acquireLease(request, opts);
+  if (!lease.allowed) throw new DetentLeaseDeniedError(lease);
+  let threw = false;
+  try {
+    return await fn();
+  } catch (e) {
+    threw = true;
+    throw e;
+  } finally {
+    try {
+      await lease.release();
+    } catch (releaseErr) {
+      if (!threw) throw releaseErr;
+    }
+  }
+}
+
+// src/stats.ts
+async function getStats(request, opts) {
+  const w = await request(
+    "GET",
+    `/v1/namespaces/${encodeURIComponent(opts.namespace)}/stats`
+  );
+  return {
+    namespace: w.namespace,
+    total: w.total,
+    blocked: w.blocked,
+    days: w.days.map((d) => ({ day: d.day, total: d.total, blocked: d.blocked })),
+    month: {
+      month: w.month.month,
+      total: w.month.total,
+      quota: w.month.quota ?? null,
+      overQuota: w.month.over_quota
+    }
+  };
+}
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.detent.dev";
+var DEFAULT_TIMEOUT_MS = 1e3;
+var Detent = class {
+  apiKey;
+  baseUrl;
+  timeoutMs;
+  failMode;
+  onError;
+  constructor(config) {
+    if (!config?.apiKey) throw new Error("Detent: apiKey is required");
+    this.apiKey = config.apiKey;
+    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.failMode = config.failMode ?? "open";
+    this.onError = config.onError;
+  }
+  /** Single HTTP choke point. 2xx → T; 4xx/5xx → DetentApiError; network/abort/body-stall → DetentTransportError. */
+  async request(method, path, body) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      const res = await fetch(`${this.baseUrl}${path}`, {
+        method,
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json"
+        },
+        body: body === void 0 ? void 0 : JSON.stringify(body),
+        signal: controller.signal
+      });
+      if (!res.ok) {
+        let parsed;
+        try {
+          parsed = await res.json();
+        } catch {
+          parsed = { error: res.statusText || `HTTP ${res.status}` };
+        }
+        throw new DetentApiError(res.status, parsed);
+      }
+      return await res.json();
+    } catch (cause) {
+      if (cause instanceof DetentApiError) throw cause;
+      throw new DetentTransportError("Detent request failed", cause);
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  acquire(opts) {
+    return acquireLease(this.request.bind(this), opts);
+  }
+  release(leaseId) {
+    return releaseLease(this.request.bind(this), leaseId);
+  }
+  withLease(opts, fn) {
+    return withLease(this.request.bind(this), opts, fn);
+  }
+  async limit(opts) {
+    const body = {
+      namespace: opts.namespace,
+      key: opts.key,
+      ...opts.algorithm !== void 0 ? { algorithm: opts.algorithm } : {},
+      ...opts.limit !== void 0 ? { limit: opts.limit } : {},
+      ...opts.windowMs !== void 0 ? { window_ms: opts.windowMs } : {}
+    };
+    try {
+      const w = await this.request(
+        "POST",
+        "/v1/limit",
+        body
+      );
+      return { allowed: w.allowed, remaining: w.remaining, resetMs: w.reset_ms, limit: w.limit, degraded: false };
+    } catch (err) {
+      if (err instanceof DetentTransportError || err instanceof DetentApiError && err.status >= 500) {
+        this.onError?.(err);
+        return { allowed: this.failMode === "open", remaining: 0, resetMs: 0, limit: opts.limit ?? 0, degraded: true };
+      }
+      throw err;
+    }
+  }
+  getStats(opts) {
+    return getStats(this.request.bind(this), opts);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Detent,
+  DetentApiError,
+  DetentError,
+  DetentLeaseDeniedError,
+  DetentTransportError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/leases.ts","../src/stats.ts","../src/client.ts"],"sourcesContent":["export { Detent } from './client'\nexport * from './types'\nexport * from './errors'\n","import type { AcquireResult } from './types'\n\nexport class DetentError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'DetentError'\n  }\n}\n\nexport class DetentApiError extends DetentError {\n  readonly status: number\n  readonly body: { error: string }\n  constructor(status: number, body: { error: string }) {\n    super(`Detent API error ${status}: ${body.error}`)\n    this.name = 'DetentApiError'\n    this.status = status\n    this.body = body\n  }\n}\n\nexport class DetentTransportError extends DetentError {\n  readonly cause: unknown\n  constructor(message: string, cause: unknown) {\n    super(message)\n    this.name = 'DetentTransportError'\n    this.cause = cause\n  }\n}\n\nexport class DetentLeaseDeniedError extends DetentError {\n  readonly result: AcquireResult\n  constructor(result: AcquireResult) {\n    super('Lease denied: no concurrent slot available')\n    this.name = 'DetentLeaseDeniedError'\n    this.result = result\n  }\n}\n","import { DetentLeaseDeniedError } from './errors'\nimport type { AcquireOptions, AcquireResult, ReleaseResult } from './types'\nimport type { components } from './generated/openapi'\n\ntype Requester = <T>(method: string, path: string, body?: unknown) => Promise<T>\n\ntype AcquireWire = components['schemas']['AcquireResponse']\n\nexport async function acquireLease(request: Requester, opts: AcquireOptions): Promise<AcquireResult> {\n  const body = {\n    namespace: opts.namespace,\n    key: opts.key,\n    ...(opts.limit !== undefined ? { limit: opts.limit } : {}),\n    ...(opts.windowMs !== undefined ? { window_ms: opts.windowMs } : {}),\n  }\n  const w = await request<AcquireWire>('POST', '/v1/leases', body)\n  const result: AcquireResult = {\n    allowed: w.allowed,\n    leaseId: w.lease_id ?? undefined,\n    active: w.active,\n    limit: w.limit,\n    resetMs: w.reset_ms,\n    release: async () => {\n      if (!w.allowed || !w.lease_id) return\n      return releaseLease(request, w.lease_id)\n    },\n  }\n  return result\n}\n\nexport async function releaseLease(request: Requester, leaseId: string): Promise<ReleaseResult> {\n  return request<ReleaseResult>('DELETE', `/v1/leases/${encodeURIComponent(leaseId)}`)\n}\n\nexport async function withLease<T>(\n  request: Requester,\n  opts: AcquireOptions,\n  fn: () => Promise<T>,\n): Promise<T> {\n  const lease = await acquireLease(request, opts)\n  if (!lease.allowed) throw new DetentLeaseDeniedError(lease)\n  let threw = false\n  try {\n    return await fn()\n  } catch (e) {\n    threw = true\n    throw e\n  } finally {\n    // Best-effort release. If fn already threw, don't let a release error mask it.\n    try {\n      await lease.release()\n    } catch (releaseErr) {\n      if (!threw) throw releaseErr\n    }\n  }\n}\n","import type { StatsOptions, StatsResult } from './types'\nimport type { components } from './generated/openapi'\n\ntype Requester = <T>(method: string, path: string, body?: unknown) => Promise<T>\n\ntype StatsWire = components['schemas']['StatsResponse']\n\nexport async function getStats(request: Requester, opts: StatsOptions): Promise<StatsResult> {\n  const w = await request<StatsWire>(\n    'GET', `/v1/namespaces/${encodeURIComponent(opts.namespace)}/stats`,\n  )\n  return {\n    namespace: w.namespace,\n    total: w.total,\n    blocked: w.blocked,\n    days: w.days.map((d) => ({ day: d.day, total: d.total, blocked: d.blocked })),\n    month: {\n      month: w.month.month,\n      total: w.month.total,\n      quota: w.month.quota ?? null,\n      overQuota: w.month.over_quota,\n    },\n  }\n}\n","import { DetentApiError, DetentTransportError } from './errors'\nimport { acquireLease, releaseLease, withLease } from './leases'\nimport { getStats } from './stats'\nimport type {\n  DetentConfig, FailMode, LimitOptions, LimitResult,\n  AcquireOptions, AcquireResult, ReleaseResult,\n  StatsOptions, StatsResult,\n} from './types'\nimport type { components } from './generated/openapi'\n\nconst DEFAULT_BASE_URL = 'https://api.detent.dev'\nconst DEFAULT_TIMEOUT_MS = 1000\n\nexport class Detent {\n  protected readonly apiKey: string\n  protected readonly baseUrl: string\n  protected readonly timeoutMs: number\n  protected readonly failMode: FailMode\n  protected readonly onError?: DetentConfig['onError']\n\n  constructor(config: DetentConfig) {\n    if (!config?.apiKey) throw new Error('Detent: apiKey is required')\n    this.apiKey = config.apiKey\n    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, '')\n    this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS\n    this.failMode = config.failMode ?? 'open'\n    this.onError = config.onError\n  }\n\n  /** Single HTTP choke point. 2xx → T; 4xx/5xx → DetentApiError; network/abort/body-stall → DetentTransportError. */\n  protected async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const controller = new AbortController()\n    const timer = setTimeout(() => controller.abort(), this.timeoutMs)\n    try {\n      const res = await fetch(`${this.baseUrl}${path}`, {\n        method,\n        headers: {\n          Authorization: `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n        },\n        body: body === undefined ? undefined : JSON.stringify(body),\n        signal: controller.signal,\n      })\n      if (!res.ok) {\n        let parsed: { error: string }\n        try {\n          parsed = (await res.json()) as { error: string }\n        } catch {\n          parsed = { error: res.statusText || `HTTP ${res.status}` }\n        }\n        throw new DetentApiError(res.status, parsed)\n      }\n      return (await res.json()) as T\n    } catch (cause) {\n      if (cause instanceof DetentApiError) throw cause\n      throw new DetentTransportError('Detent request failed', cause)\n    } finally {\n      clearTimeout(timer)\n    }\n  }\n\n  acquire(opts: AcquireOptions): Promise<AcquireResult> {\n    return acquireLease(this.request.bind(this), opts)\n  }\n\n  release(leaseId: string): Promise<ReleaseResult> {\n    return releaseLease(this.request.bind(this), leaseId)\n  }\n\n  withLease<T>(opts: AcquireOptions, fn: () => Promise<T>): Promise<T> {\n    return withLease(this.request.bind(this), opts, fn)\n  }\n\n  async limit(opts: LimitOptions): Promise<LimitResult> {\n    const body = {\n      namespace: opts.namespace,\n      key: opts.key,\n      ...(opts.algorithm !== undefined ? { algorithm: opts.algorithm } : {}),\n      ...(opts.limit !== undefined ? { limit: opts.limit } : {}),\n      ...(opts.windowMs !== undefined ? { window_ms: opts.windowMs } : {}),\n    }\n    try {\n      const w = await this.request<components['schemas']['LimitResponse']>(\n        'POST', '/v1/limit', body,\n      )\n      return { allowed: w.allowed, remaining: w.remaining, resetMs: w.reset_ms, limit: w.limit, degraded: false }\n    } catch (err) {\n      if (err instanceof DetentTransportError || (err instanceof DetentApiError && err.status >= 500)) {\n        this.onError?.(err)\n        return { allowed: this.failMode === 'open', remaining: 0, resetMs: 0, limit: opts.limit ?? 0, degraded: true }\n      }\n      throw err // 4xx client errors and anything else\n    }\n  }\n\n  getStats(opts: StatsOptions): Promise<StatsResult> {\n    return getStats(this.request.bind(this), opts)\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,103 @@
+declare class DetentError extends Error {
+    constructor(message: string);
+}
+declare class DetentApiError extends DetentError {
+    readonly status: number;
+    readonly body: {
+        error: string;
+    };
+    constructor(status: number, body: {
+        error: string;
+    });
+}
+declare class DetentTransportError extends DetentError {
+    readonly cause: unknown;
+    constructor(message: string, cause: unknown);
+}
+declare class DetentLeaseDeniedError extends DetentError {
+    readonly result: AcquireResult;
+    constructor(result: AcquireResult);
+}
+
+type Algorithm = 'sliding_window' | 'token_bucket' | 'fixed_window';
+type FailMode = 'open' | 'closed';
+interface DetentConfig {
+    apiKey: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+    failMode?: FailMode;
+    onError?: (err: DetentError) => void;
+}
+interface LimitOptions {
+    namespace: string;
+    key: string;
+    algorithm?: Algorithm;
+    limit?: number;
+    windowMs?: number;
+}
+interface LimitResult {
+    allowed: boolean;
+    remaining: number;
+    resetMs: number;
+    limit: number;
+    /** true when this is a fail-open/fail-closed result, not a real decision. */
+    degraded: boolean;
+}
+interface AcquireOptions {
+    namespace: string;
+    key: string;
+    limit?: number;
+    windowMs?: number;
+}
+interface AcquireResult {
+    allowed: boolean;
+    leaseId?: string;
+    active: number;
+    limit: number;
+    resetMs: number;
+    /** Release this lease; a no-op when `allowed` is false. */
+    release(): Promise<ReleaseResult | void>;
+}
+interface ReleaseResult {
+    released: boolean;
+    active: number;
+}
+interface StatsOptions {
+    namespace: string;
+}
+interface DayStat {
+    day: string;
+    total: number;
+    blocked: number;
+}
+interface MonthSummary {
+    month: string;
+    total: number;
+    quota: number | null;
+    overQuota: boolean;
+}
+interface StatsResult {
+    namespace: string;
+    total: number;
+    blocked: number;
+    days: DayStat[];
+    month: MonthSummary;
+}
+
+declare class Detent {
+    protected readonly apiKey: string;
+    protected readonly baseUrl: string;
+    protected readonly timeoutMs: number;
+    protected readonly failMode: FailMode;
+    protected readonly onError?: DetentConfig['onError'];
+    constructor(config: DetentConfig);
+    /** Single HTTP choke point. 2xx → T; 4xx/5xx → DetentApiError; network/abort/body-stall → DetentTransportError. */
+    protected request<T>(method: string, path: string, body?: unknown): Promise<T>;
+    acquire(opts: AcquireOptions): Promise<AcquireResult>;
+    release(leaseId: string): Promise<ReleaseResult>;
+    withLease<T>(opts: AcquireOptions, fn: () => Promise<T>): Promise<T>;
+    limit(opts: LimitOptions): Promise<LimitResult>;
+    getStats(opts: StatsOptions): Promise<StatsResult>;
+}
+
+export { type AcquireOptions, type AcquireResult, type Algorithm, type DayStat, Detent, DetentApiError, type DetentConfig, DetentError, DetentLeaseDeniedError, DetentTransportError, type FailMode, type LimitOptions, type LimitResult, type MonthSummary, type ReleaseResult, type StatsOptions, type StatsResult };

package/dist/index.d.ts

@@ -0,0 +1,103 @@
+declare class DetentError extends Error {
+    constructor(message: string);
+}
+declare class DetentApiError extends DetentError {
+    readonly status: number;
+    readonly body: {
+        error: string;
+    };
+    constructor(status: number, body: {
+        error: string;
+    });
+}
+declare class DetentTransportError extends DetentError {
+    readonly cause: unknown;
+    constructor(message: string, cause: unknown);
+}
+declare class DetentLeaseDeniedError extends DetentError {
+    readonly result: AcquireResult;
+    constructor(result: AcquireResult);
+}
+
+type Algorithm = 'sliding_window' | 'token_bucket' | 'fixed_window';
+type FailMode = 'open' | 'closed';
+interface DetentConfig {
+    apiKey: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+    failMode?: FailMode;
+    onError?: (err: DetentError) => void;
+}
+interface LimitOptions {
+    namespace: string;
+    key: string;
+    algorithm?: Algorithm;
+    limit?: number;
+    windowMs?: number;
+}
+interface LimitResult {
+    allowed: boolean;
+    remaining: number;
+    resetMs: number;
+    limit: number;
+    /** true when this is a fail-open/fail-closed result, not a real decision. */
+    degraded: boolean;
+}
+interface AcquireOptions {
+    namespace: string;
+    key: string;
+    limit?: number;
+    windowMs?: number;
+}
+interface AcquireResult {
+    allowed: boolean;
+    leaseId?: string;
+    active: number;
+    limit: number;
+    resetMs: number;
+    /** Release this lease; a no-op when `allowed` is false. */
+    release(): Promise<ReleaseResult | void>;
+}
+interface ReleaseResult {
+    released: boolean;
+    active: number;
+}
+interface StatsOptions {
+    namespace: string;
+}
+interface DayStat {
+    day: string;
+    total: number;
+    blocked: number;
+}
+interface MonthSummary {
+    month: string;
+    total: number;
+    quota: number | null;
+    overQuota: boolean;
+}
+interface StatsResult {
+    namespace: string;
+    total: number;
+    blocked: number;
+    days: DayStat[];
+    month: MonthSummary;
+}
+
+declare class Detent {
+    protected readonly apiKey: string;
+    protected readonly baseUrl: string;
+    protected readonly timeoutMs: number;
+    protected readonly failMode: FailMode;
+    protected readonly onError?: DetentConfig['onError'];
+    constructor(config: DetentConfig);
+    /** Single HTTP choke point. 2xx → T; 4xx/5xx → DetentApiError; network/abort/body-stall → DetentTransportError. */
+    protected request<T>(method: string, path: string, body?: unknown): Promise<T>;
+    acquire(opts: AcquireOptions): Promise<AcquireResult>;
+    release(leaseId: string): Promise<ReleaseResult>;
+    withLease<T>(opts: AcquireOptions, fn: () => Promise<T>): Promise<T>;
+    limit(opts: LimitOptions): Promise<LimitResult>;
+    getStats(opts: StatsOptions): Promise<StatsResult>;
+}
+
+export { type AcquireOptions, type AcquireResult, type Algorithm, type DayStat, Detent, DetentApiError, type DetentConfig, DetentError, DetentLeaseDeniedError, DetentTransportError, type FailMode, type LimitOptions, type LimitResult, type MonthSummary, type ReleaseResult, type StatsOptions, type StatsResult };

package/dist/index.js

@@ -0,0 +1,189 @@
+// src/errors.ts
+var DetentError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "DetentError";
+  }
+};
+var DetentApiError = class extends DetentError {
+  status;
+  body;
+  constructor(status, body) {
+    super(`Detent API error ${status}: ${body.error}`);
+    this.name = "DetentApiError";
+    this.status = status;
+    this.body = body;
+  }
+};
+var DetentTransportError = class extends DetentError {
+  cause;
+  constructor(message, cause) {
+    super(message);
+    this.name = "DetentTransportError";
+    this.cause = cause;
+  }
+};
+var DetentLeaseDeniedError = class extends DetentError {
+  result;
+  constructor(result) {
+    super("Lease denied: no concurrent slot available");
+    this.name = "DetentLeaseDeniedError";
+    this.result = result;
+  }
+};
+
+// src/leases.ts
+async function acquireLease(request, opts) {
+  const body = {
+    namespace: opts.namespace,
+    key: opts.key,
+    ...opts.limit !== void 0 ? { limit: opts.limit } : {},
+    ...opts.windowMs !== void 0 ? { window_ms: opts.windowMs } : {}
+  };
+  const w = await request("POST", "/v1/leases", body);
+  const result = {
+    allowed: w.allowed,
+    leaseId: w.lease_id ?? void 0,
+    active: w.active,
+    limit: w.limit,
+    resetMs: w.reset_ms,
+    release: async () => {
+      if (!w.allowed || !w.lease_id) return;
+      return releaseLease(request, w.lease_id);
+    }
+  };
+  return result;
+}
+async function releaseLease(request, leaseId) {
+  return request("DELETE", `/v1/leases/${encodeURIComponent(leaseId)}`);
+}
+async function withLease(request, opts, fn) {
+  const lease = await acquireLease(request, opts);
+  if (!lease.allowed) throw new DetentLeaseDeniedError(lease);
+  let threw = false;
+  try {
+    return await fn();
+  } catch (e) {
+    threw = true;
+    throw e;
+  } finally {
+    try {
+      await lease.release();
+    } catch (releaseErr) {
+      if (!threw) throw releaseErr;
+    }
+  }
+}
+
+// src/stats.ts
+async function getStats(request, opts) {
+  const w = await request(
+    "GET",
+    `/v1/namespaces/${encodeURIComponent(opts.namespace)}/stats`
+  );
+  return {
+    namespace: w.namespace,
+    total: w.total,
+    blocked: w.blocked,
+    days: w.days.map((d) => ({ day: d.day, total: d.total, blocked: d.blocked })),
+    month: {
+      month: w.month.month,
+      total: w.month.total,
+      quota: w.month.quota ?? null,
+      overQuota: w.month.over_quota
+    }
+  };
+}
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.detent.dev";
+var DEFAULT_TIMEOUT_MS = 1e3;
+var Detent = class {
+  apiKey;
+  baseUrl;
+  timeoutMs;
+  failMode;
+  onError;
+  constructor(config) {
+    if (!config?.apiKey) throw new Error("Detent: apiKey is required");
+    this.apiKey = config.apiKey;
+    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.failMode = config.failMode ?? "open";
+    this.onError = config.onError;
+  }
+  /** Single HTTP choke point. 2xx → T; 4xx/5xx → DetentApiError; network/abort/body-stall → DetentTransportError. */
+  async request(method, path, body) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      const res = await fetch(`${this.baseUrl}${path}`, {
+        method,
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json"
+        },
+        body: body === void 0 ? void 0 : JSON.stringify(body),
+        signal: controller.signal
+      });
+      if (!res.ok) {
+        let parsed;
+        try {
+          parsed = await res.json();
+        } catch {
+          parsed = { error: res.statusText || `HTTP ${res.status}` };
+        }
+        throw new DetentApiError(res.status, parsed);
+      }
+      return await res.json();
+    } catch (cause) {
+      if (cause instanceof DetentApiError) throw cause;
+      throw new DetentTransportError("Detent request failed", cause);
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  acquire(opts) {
+    return acquireLease(this.request.bind(this), opts);
+  }
+  release(leaseId) {
+    return releaseLease(this.request.bind(this), leaseId);
+  }
+  withLease(opts, fn) {
+    return withLease(this.request.bind(this), opts, fn);
+  }
+  async limit(opts) {
+    const body = {
+      namespace: opts.namespace,
+      key: opts.key,
+      ...opts.algorithm !== void 0 ? { algorithm: opts.algorithm } : {},
+      ...opts.limit !== void 0 ? { limit: opts.limit } : {},
+      ...opts.windowMs !== void 0 ? { window_ms: opts.windowMs } : {}
+    };
+    try {
+      const w = await this.request(
+        "POST",
+        "/v1/limit",
+        body
+      );
+      return { allowed: w.allowed, remaining: w.remaining, resetMs: w.reset_ms, limit: w.limit, degraded: false };
+    } catch (err) {
+      if (err instanceof DetentTransportError || err instanceof DetentApiError && err.status >= 500) {
+        this.onError?.(err);
+        return { allowed: this.failMode === "open", remaining: 0, resetMs: 0, limit: opts.limit ?? 0, degraded: true };
+      }
+      throw err;
+    }
+  }
+  getStats(opts) {
+    return getStats(this.request.bind(this), opts);
+  }
+};
+export {
+  Detent,
+  DetentApiError,
+  DetentError,
+  DetentLeaseDeniedError,
+  DetentTransportError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/leases.ts","../src/stats.ts","../src/client.ts"],"sourcesContent":["import type { AcquireResult } from './types'\n\nexport class DetentError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'DetentError'\n  }\n}\n\nexport class DetentApiError extends DetentError {\n  readonly status: number\n  readonly body: { error: string }\n  constructor(status: number, body: { error: string }) {\n    super(`Detent API error ${status}: ${body.error}`)\n    this.name = 'DetentApiError'\n    this.status = status\n    this.body = body\n  }\n}\n\nexport class DetentTransportError extends DetentError {\n  readonly cause: unknown\n  constructor(message: string, cause: unknown) {\n    super(message)\n    this.name = 'DetentTransportError'\n    this.cause = cause\n  }\n}\n\nexport class DetentLeaseDeniedError extends DetentError {\n  readonly result: AcquireResult\n  constructor(result: AcquireResult) {\n    super('Lease denied: no concurrent slot available')\n    this.name = 'DetentLeaseDeniedError'\n    this.result = result\n  }\n}\n","import { DetentLeaseDeniedError } from './errors'\nimport type { AcquireOptions, AcquireResult, ReleaseResult } from './types'\nimport type { components } from './generated/openapi'\n\ntype Requester = <T>(method: string, path: string, body?: unknown) => Promise<T>\n\ntype AcquireWire = components['schemas']['AcquireResponse']\n\nexport async function acquireLease(request: Requester, opts: AcquireOptions): Promise<AcquireResult> {\n  const body = {\n    namespace: opts.namespace,\n    key: opts.key,\n    ...(opts.limit !== undefined ? { limit: opts.limit } : {}),\n    ...(opts.windowMs !== undefined ? { window_ms: opts.windowMs } : {}),\n  }\n  const w = await request<AcquireWire>('POST', '/v1/leases', body)\n  const result: AcquireResult = {\n    allowed: w.allowed,\n    leaseId: w.lease_id ?? undefined,\n    active: w.active,\n    limit: w.limit,\n    resetMs: w.reset_ms,\n    release: async () => {\n      if (!w.allowed || !w.lease_id) return\n      return releaseLease(request, w.lease_id)\n    },\n  }\n  return result\n}\n\nexport async function releaseLease(request: Requester, leaseId: string): Promise<ReleaseResult> {\n  return request<ReleaseResult>('DELETE', `/v1/leases/${encodeURIComponent(leaseId)}`)\n}\n\nexport async function withLease<T>(\n  request: Requester,\n  opts: AcquireOptions,\n  fn: () => Promise<T>,\n): Promise<T> {\n  const lease = await acquireLease(request, opts)\n  if (!lease.allowed) throw new DetentLeaseDeniedError(lease)\n  let threw = false\n  try {\n    return await fn()\n  } catch (e) {\n    threw = true\n    throw e\n  } finally {\n    // Best-effort release. If fn already threw, don't let a release error mask it.\n    try {\n      await lease.release()\n    } catch (releaseErr) {\n      if (!threw) throw releaseErr\n    }\n  }\n}\n","import type { StatsOptions, StatsResult } from './types'\nimport type { components } from './generated/openapi'\n\ntype Requester = <T>(method: string, path: string, body?: unknown) => Promise<T>\n\ntype StatsWire = components['schemas']['StatsResponse']\n\nexport async function getStats(request: Requester, opts: StatsOptions): Promise<StatsResult> {\n  const w = await request<StatsWire>(\n    'GET', `/v1/namespaces/${encodeURIComponent(opts.namespace)}/stats`,\n  )\n  return {\n    namespace: w.namespace,\n    total: w.total,\n    blocked: w.blocked,\n    days: w.days.map((d) => ({ day: d.day, total: d.total, blocked: d.blocked })),\n    month: {\n      month: w.month.month,\n      total: w.month.total,\n      quota: w.month.quota ?? null,\n      overQuota: w.month.over_quota,\n    },\n  }\n}\n","import { DetentApiError, DetentTransportError } from './errors'\nimport { acquireLease, releaseLease, withLease } from './leases'\nimport { getStats } from './stats'\nimport type {\n  DetentConfig, FailMode, LimitOptions, LimitResult,\n  AcquireOptions, AcquireResult, ReleaseResult,\n  StatsOptions, StatsResult,\n} from './types'\nimport type { components } from './generated/openapi'\n\nconst DEFAULT_BASE_URL = 'https://api.detent.dev'\nconst DEFAULT_TIMEOUT_MS = 1000\n\nexport class Detent {\n  protected readonly apiKey: string\n  protected readonly baseUrl: string\n  protected readonly timeoutMs: number\n  protected readonly failMode: FailMode\n  protected readonly onError?: DetentConfig['onError']\n\n  constructor(config: DetentConfig) {\n    if (!config?.apiKey) throw new Error('Detent: apiKey is required')\n    this.apiKey = config.apiKey\n    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, '')\n    this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS\n    this.failMode = config.failMode ?? 'open'\n    this.onError = config.onError\n  }\n\n  /** Single HTTP choke point. 2xx → T; 4xx/5xx → DetentApiError; network/abort/body-stall → DetentTransportError. */\n  protected async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const controller = new AbortController()\n    const timer = setTimeout(() => controller.abort(), this.timeoutMs)\n    try {\n      const res = await fetch(`${this.baseUrl}${path}`, {\n        method,\n        headers: {\n          Authorization: `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n        },\n        body: body === undefined ? undefined : JSON.stringify(body),\n        signal: controller.signal,\n      })\n      if (!res.ok) {\n        let parsed: { error: string }\n        try {\n          parsed = (await res.json()) as { error: string }\n        } catch {\n          parsed = { error: res.statusText || `HTTP ${res.status}` }\n        }\n        throw new DetentApiError(res.status, parsed)\n      }\n      return (await res.json()) as T\n    } catch (cause) {\n      if (cause instanceof DetentApiError) throw cause\n      throw new DetentTransportError('Detent request failed', cause)\n    } finally {\n      clearTimeout(timer)\n    }\n  }\n\n  acquire(opts: AcquireOptions): Promise<AcquireResult> {\n    return acquireLease(this.request.bind(this), opts)\n  }\n\n  release(leaseId: string): Promise<ReleaseResult> {\n    return releaseLease(this.request.bind(this), leaseId)\n  }\n\n  withLease<T>(opts: AcquireOptions, fn: () => Promise<T>): Promise<T> {\n    return withLease(this.request.bind(this), opts, fn)\n  }\n\n  async limit(opts: LimitOptions): Promise<LimitResult> {\n    const body = {\n      namespace: opts.namespace,\n      key: opts.key,\n      ...(opts.algorithm !== undefined ? { algorithm: opts.algorithm } : {}),\n      ...(opts.limit !== undefined ? { limit: opts.limit } : {}),\n      ...(opts.windowMs !== undefined ? { window_ms: opts.windowMs } : {}),\n    }\n    try {\n      const w = await this.request<components['schemas']['LimitResponse']>(\n        'POST', '/v1/limit', body,\n      )\n      return { allowed: w.allowed, remaining: w.remaining, resetMs: w.reset_ms, limit: w.limit, degraded: false }\n    } catch (err) {\n      if (err instanceof DetentTransportError || (err instanceof DetentApiError && err.status >= 500)) {\n        this.onError?.(err)\n        return { allowed: this.failMode === 'open', remaining: 0, resetMs: 0, limit: opts.limit ?? 0, degraded: true }\n      }\n      throw err // 4xx client errors and anything else\n    }\n  }\n\n  getStats(opts: StatsOptions): Promise<StatsResult> {\n    return getStats(this.request.bind(this), opts)\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@detent/sdk",
+  "version": "0.5.0",
+  "description": "Typed TypeScript client for the Detent rate-limiting API.",
+  "license": "MIT",
+  "keywords": [
+    "rate-limit",
+    "rate-limiter",
+    "detent",
+    "sdk",
+    "api-client",
+    "ratelimit"
+  ],
+  "homepage": "https://github.com/cguillerminet/detent-sdk-ts#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cguillerminet/detent-sdk-ts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cguillerminet/detent-sdk-ts/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "gen:types": "tsx scripts/gen-types.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "openapi-typescript": "^7.4.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.4.0"
+  }
+}