@fonderie/client 0.26.0 → 0.28.0

package/brain/signatures.md

@@ -305,6 +305,49 @@ 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 IAuditAdminClientOptions {
+    baseUrl: string;
+    adminToken: string;
+    prefix?: string;
+    actor?: string;
+}
+
+interface IAdminAuditQuery {
+    workspaceId?: string;
+    type?: string;
+    actorId?: string;
+    from?: Date;
+    to?: Date;
+    limit?: number;
+    cursor?: string;
+}
+
+new AuditAdminClient(opts: IAuditAdminClientOptions): AuditAdminClient
+  .listAudit(query?: IAdminAuditQuery): Promise<IApiResponse<IAuditPageResult>>
+
 interface ICourierAdminClientOptions {
     baseUrl: string;
     adminToken: string;
@@ -763,6 +806,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

@@ -21,9 +21,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AdminClient: () => AdminClient,
+  AuditAdminClient: () => AuditAdminClient,
   AuditClient: () => AuditClient,
   AuthAdminClient: () => AuthAdminClient,
   AuthClient: () => AuthClient,
+  BillingAdminClient: () => BillingAdminClient,
   BillingClient: () => BillingClient,
   ConfigAdminClient: () => ConfigAdminClient,
   CourierAdminClient: () => CourierAdminClient,
@@ -1836,6 +1838,98 @@ 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/audit-admin.ts
+var AuditAdminClient = 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;
+  }
+  // Every workspace unless one is named. Newest first, keyset-paged.
+  listAudit(query = {}) {
+    const q = new URLSearchParams();
+    if (query.workspaceId) q.set("workspaceId", query.workspaceId);
+    if (query.type) q.set("type", query.type);
+    if (query.actorId) q.set("actorId", query.actorId);
+    if (query.from) q.set("from", query.from.toISOString());
+    if (query.to) q.set("to", query.to.toISOString());
+    if (query.limit) q.set("limit", String(query.limit));
+    if (query.cursor) q.set("cursor", query.cursor);
+    const qs = q.toString();
+    return this.http.request({
+      method: "GET",
+      path: `${this.prefix}/audit${qs ? `?${qs}` : ""}`,
+      token: this.adminToken,
+      headers: this.actorHeaders
+    });
+  }
+};
+
 // src/modules/courier-admin.ts
 var CourierAdminClient = class {
   http;
@@ -1927,9 +2021,11 @@ function isMfaRequired(result) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AdminClient,
+  AuditAdminClient,
   AuditClient,
   AuthAdminClient,
   AuthClient,
+  BillingAdminClient,
   BillingClient,
   ConfigAdminClient,
   CourierAdminClient,