@noirstack/ledgerbill-sdk 0.1.0

package/README.md

@@ -0,0 +1,41 @@
+# @ledgerbill/sdk
+
+Official TypeScript client scaffold for LedgerBill.
+
+## Build flow
+
+From repository root:
+
+1. Export OpenAPI source of truth:
+   - `npm run openapi:export`
+2. Generate strongly-typed API contracts:
+   - `npm run sdk:types`
+3. Build SDK package:
+   - `npm run sdk:build`
+4. Create local tarball for publishing checks:
+   - `npm run sdk:pack`
+
+## Basic usage
+
+```ts
+import { LedgerBillClient } from '@ledgerbill/sdk';
+
+const client = new LedgerBillClient({
+  baseUrl: 'http://localhost:3107',
+  tenantId: 'tenant_123',
+  apiKey: 'lb_your_api_key',
+});
+
+const plans = await client.getPricingPlans();
+const preview = await client.previewUsage({
+  customerId: 'cus_123',
+  featureKey: 'events_processed',
+  amount: 1000,
+});
+```
+
+## Notes
+
+- This package is currently scaffolded from OpenAPI and intentionally thin.
+- Any route types come from `src/generated/api-types.ts`.
+- Re-run `npm run sdk:types` after API contract changes.

package/dist/client.d.ts

@@ -0,0 +1,33 @@
+import type { paths } from './generated/api-types';
+type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+type UsagePreviewRequest = paths['/api/v1/usage/preview']['post']['requestBody']['content']['application/json'];
+type UsagePreviewResponse = paths['/api/v1/usage/preview']['post']['responses']['200']['content']['application/json'];
+type UsageReportRequest = paths['/api/v1/usage']['post']['requestBody']['content']['application/json'];
+type UsageReportResponse = paths['/api/v1/usage']['post']['responses']['200']['content']['application/json'];
+type PricingPlansResponse = paths['/api/pricing/plans']['get']['responses']['200']['content']['application/json'];
+type SubscriptionPlansResponse = paths['/api/subscriptions/plans']['get']['responses']['200']['content']['application/json'];
+type CurrentSubscriptionResponse = paths['/api/subscriptions/current']['get']['responses']['200']['content']['application/json'];
+type CheckoutResponse = paths['/api/subscriptions/checkout']['post']['responses']['200']['content']['application/json'];
+export type LedgerBillClientOptions = {
+    baseUrl: string;
+    tenantId?: string;
+    apiKey?: string;
+    accessToken?: string;
+    fetchImpl?: FetchLike;
+};
+export declare class LedgerBillClient {
+    private readonly baseUrl;
+    private readonly tenantId?;
+    private readonly apiKey?;
+    private readonly accessToken?;
+    private readonly fetchImpl;
+    constructor(options: LedgerBillClientOptions);
+    getPricingPlans(): Promise<PricingPlansResponse>;
+    getSubscriptionPlans(): Promise<SubscriptionPlansResponse>;
+    getCurrentSubscription(): Promise<CurrentSubscriptionResponse>;
+    createCheckoutSession(planId: string): Promise<CheckoutResponse>;
+    previewUsage(payload: UsagePreviewRequest): Promise<UsagePreviewResponse>;
+    reportUsage(payload: UsageReportRequest): Promise<UsageReportResponse>;
+    private request;
+}
+export {};

package/dist/client.js

@@ -0,0 +1,70 @@
+export class LedgerBillClient {
+    baseUrl;
+    tenantId;
+    apiKey;
+    accessToken;
+    fetchImpl;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/$/, '');
+        this.tenantId = options.tenantId;
+        this.apiKey = options.apiKey;
+        this.accessToken = options.accessToken;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+    }
+    async getPricingPlans() {
+        return this.request('GET', '/api/pricing/plans');
+    }
+    async getSubscriptionPlans() {
+        return this.request('GET', '/api/subscriptions/plans');
+    }
+    async getCurrentSubscription() {
+        return this.request('GET', '/api/subscriptions/current');
+    }
+    async createCheckoutSession(planId) {
+        return this.request('POST', '/api/subscriptions/checkout', {
+            body: { planId },
+            idempotencyKey: `sdk-checkout-${Date.now()}`,
+        });
+    }
+    async previewUsage(payload) {
+        return this.request('POST', '/api/v1/usage/preview', { body: payload });
+    }
+    async reportUsage(payload) {
+        return this.request('POST', '/api/v1/usage', {
+            body: payload,
+            idempotencyKey: `sdk-usage-${Date.now()}`,
+        });
+    }
+    async request(method, route, options) {
+        const headers = {
+            Accept: 'application/json',
+        };
+        if (this.tenantId)
+            headers['x-tenant-id'] = this.tenantId;
+        if (this.apiKey)
+            headers['x-api-key'] = this.apiKey;
+        if (this.accessToken)
+            headers.Authorization = `Bearer ${this.accessToken}`;
+        if (options?.idempotencyKey)
+            headers['Idempotency-Key'] = options.idempotencyKey;
+        const hasBody = options?.body != null;
+        if (hasBody)
+            headers['Content-Type'] = 'application/json';
+        const response = await this.fetchImpl(`${this.baseUrl}${route}`, {
+            method,
+            headers,
+            body: hasBody ? JSON.stringify(options?.body) : undefined,
+        });
+        if (!response.ok) {
+            let detail;
+            try {
+                detail = await response.json();
+            }
+            catch {
+                detail = await response.text().catch(() => '');
+            }
+            throw new Error(`LedgerBill API ${method} ${route} failed: ${response.status} ${response.statusText} ${JSON.stringify(detail)}`);
+        }
+        return (await response.json());
+    }
+}