@fonderie/client 0.26.0 → 0.27.0

package/brain/signatures.md

@@ -305,6 +305,29 @@ new AuthAdminClient(opts: IAuthAdminClientOptions): AuthAdminClient
   .suspendUser(id: string): Promise<IApiResponse<IAdminUserDTO>>
   .unsuspendUser(id: string): Promise<IApiResponse<IAdminUserDTO>>
 
+interface IBillingAdminClientOptions {
+    baseUrl: string;
+    adminToken: string;
+    prefix?: string;
+    actor?: string;
+}
+
+interface IAdminLedgerQuery {
+    currency?: string;
+    limit?: number;
+    cursor?: string;
+}
+
+new BillingAdminClient(opts: IBillingAdminClientOptions): BillingAdminClient
+  .catalog(): Promise<IApiResponse<IAdminCatalog>>
+  .createPlan(input: IAdminPlanInput & { name: string; }): Promise<IApiResponse<IPlanDTO>>
+  .updatePlan(planId: string, input: IAdminPlanInput): Promise<IApiResponse<IPlanDTO>>
+  .deletePlan(planId: string): Promise<IApiResponse<undefined>>
+  .subscription(type: SubscriberType, id: string): Promise<IApiResponse<IAdminSubscriptionDTO>>
+  .wallet(type: SubscriberType, id: string, currency?: string | undefined): Promise<IApiResponse<IAdminWalletDTO>>
+  .walletLedger(type: SubscriberType, id: string, query?: IAdminLedgerQuery): Promise<IApiResponse<IAdminWalletLedgerPage>>
+  .grant(input: IAdminGrantInput): Promise<IApiResponse<unknown>>
+
 interface ICourierAdminClientOptions {
     baseUrl: string;
     adminToken: string;
@@ -763,6 +786,61 @@ interface IAdminUserDTO extends IUserDTO {
     deletedAt: string | null;
 }
 
+interface IAdminCatalog {
+    configured: unknown[];
+    stored: IPlanDTO[];
+}
+
+interface IAdminSubscriptionDTO {
+    id: string;
+    subscriberType: SubscriberType;
+    subscriberId: string;
+    plan: string;
+    interval: string;
+    status: string;
+    providerCustomerId: string | null;
+    providerSubscriptionId: string | null;
+    currentPeriodStart: string | null;
+    currentPeriodEnd: string | null;
+    cancelAtPeriodEnd: boolean;
+    trialEndsAt: string | null;
+    createdAt: string;
+}
+
+interface IAdminWalletDTO extends IWalletDTO {
+    version: number;
+    updatedAt: string | null;
+}
+
+interface IAdminWalletLedgerPage {
+    currency: string;
+    entries: IWalletTransactionDTO[];
+    nextCursor: string | null;
+}
+
+interface IAdminPlanInput {
+    name?: string;
+    description?: string | null;
+    tier?: number;
+    seats?: number | null;
+    trialDays?: number;
+    monthlyAmount?: number | null;
+    monthlyPriceId?: string | null;
+    yearlyAmount?: number | null;
+    yearlyPriceId?: string | null;
+    features?: unknown;
+    metadata?: unknown;
+}
+
+interface IAdminGrantInput {
+    subscriberType: SubscriberType;
+    subscriberId: string;
+    amount: string | number;
+    currency?: string;
+    description?: string;
+    idempotencyKey: string;
+}
+
 interface IConfigEntry {
     key: string;
     value: unknown;

package/dist/index.cjs

@@ -24,6 +24,7 @@ __export(index_exports, {
   AuditClient: () => AuditClient,
   AuthAdminClient: () => AuthAdminClient,
   AuthClient: () => AuthClient,
+  BillingAdminClient: () => BillingAdminClient,
   BillingClient: () => BillingClient,
   ConfigAdminClient: () => ConfigAdminClient,
   CourierAdminClient: () => CourierAdminClient,
@@ -1836,6 +1837,66 @@ var AuthAdminClient = class {
   }
 };
 
+// src/modules/billing-admin.ts
+var BillingAdminClient = class {
+  http;
+  adminToken;
+  prefix;
+  actorHeaders;
+  constructor(opts) {
+    this.http = new HttpClient(opts.baseUrl);
+    this.adminToken = opts.adminToken;
+    this.prefix = (opts.prefix ?? "/_admin").replace(/\/+$/, "");
+    this.actorHeaders = opts.actor ? { "X-Actor": opts.actor } : void 0;
+  }
+  call(method, suffix, body) {
+    return this.http.request({
+      method,
+      path: `${this.prefix}${suffix}`,
+      token: this.adminToken,
+      headers: this.actorHeaders,
+      ...body !== void 0 ? { body } : {}
+    });
+  }
+  sub(type, id) {
+    return `/${type}/${encodeURIComponent(id)}`;
+  }
+  catalog() {
+    return this.call("GET", "/catalog");
+  }
+  createPlan(input) {
+    return this.call("POST", "/plans", input);
+  }
+  updatePlan(planId, input) {
+    return this.call("PUT", `/plans/${encodeURIComponent(planId)}`, input);
+  }
+  deletePlan(planId) {
+    return this.call("DELETE", `/plans/${encodeURIComponent(planId)}`);
+  }
+  subscription(type, id) {
+    return this.call("GET", `/subscriptions${this.sub(type, id)}`);
+  }
+  wallet(type, id, currency) {
+    const qs = currency ? `?currency=${encodeURIComponent(currency)}` : "";
+    return this.call("GET", `/wallet${this.sub(type, id)}${qs}`);
+  }
+  walletLedger(type, id, query = {}) {
+    const q = new URLSearchParams();
+    if (query.currency) q.set("currency", query.currency);
+    if (query.limit) q.set("limit", String(query.limit));
+    if (query.cursor) q.set("cursor", query.cursor);
+    const qs = q.toString();
+    return this.call(
+      "GET",
+      `/wallet${this.sub(type, id)}/ledger${qs ? `?${qs}` : ""}`
+    );
+  }
+  // Manual credit — an idempotency key is required by the server.
+  grant(input) {
+    return this.call("POST", "/wallet/grant", input);
+  }
+};
+
 // src/modules/courier-admin.ts
 var CourierAdminClient = class {
   http;
@@ -1930,6 +1991,7 @@ function isMfaRequired(result) {
   AuditClient,
   AuthAdminClient,
   AuthClient,
+  BillingAdminClient,
   BillingClient,
   ConfigAdminClient,
   CourierAdminClient,