@applica-software-guru/persona-sdk 0.1.1 → 0.1.3

package/dist/index.d.ts

@@ -143,6 +143,46 @@ export declare class BearerTokenAuthenticationProvider implements Authentication
     getCredentials(): string;
 }
 
+export declare class BillingClient {
+    private readonly baseUrl;
+    private readonly authProvider;
+    constructor(baseUrl?: string, auth?: string | AuthenticationProvider | null);
+    private buildHeaders;
+    private request;
+    createCustomer(request: CreateCustomerRequest): Promise<Customer>;
+    updateCustomer(owner: string, request: UpdateCustomerRequest): Promise<Customer>;
+    getCustomer(owner: string): Promise<Customer>;
+    saveCustomer(customer: Customer): Promise<Customer>;
+    deleteCustomer(owner: string): Promise<void>;
+    createSubscription(request: CreateSubscriptionRequest): Promise<Subscription>;
+    getSubscription(owner: string): Promise<Subscription>;
+    getProjectSubscription(projectId: string): Promise<Subscription>;
+    changeProjectSubscriptionPlan(projectId: string, request: {
+        toPlanType: string;
+    }): Promise<Subscription>;
+    addProjectSubscriptionCredits(projectId: string, request: {
+        credits: number;
+    }): Promise<Subscription>;
+    beginUpgrade(owner: string, request: UpgradeSubscriptionRequest): Promise<Subscription>;
+    downgrade(owner: string, request: DowngradeSubscriptionRequest): Promise<Subscription>;
+    mentorize(owner: string, request: MentorizeSubscriptionRequest): Promise<Subscription>;
+    addCredits(owner: string, credits: number): Promise<Subscription>;
+    useCredits(owner: string, credits: number, services: string[], referenceId?: string): Promise<Subscription>;
+    getCredits(owner: string): Promise<number>;
+    isValid(owner: string): Promise<boolean>;
+    listInvoices(owner: string, dateFrom?: string, dateTo?: string): Promise<Invoice[]>;
+    cancelSubscription(owner: string): Promise<Subscription>;
+}
+
+export declare interface BillingUsage {
+    id?: string;
+    subscriptionId?: string;
+    creditsUsed?: number;
+    services?: string[];
+    referenceId?: string;
+    createdAt?: string;
+}
+
 export declare interface ChangeProjectSubscriptionPlanRequest {
     toPlanType: string;
 }
@@ -204,6 +244,17 @@ export declare interface ContentValue {
     content?: ContentItem[];
 }
 
+export declare interface CreateCustomerRequest {
+    owner?: string;
+    name?: string;
+    email?: string;
+    phone?: string;
+}
+
+export declare interface CreateSubscriptionRequest {
+    owner: string;
+}
+
 export declare interface Credentials {
     id?: string;
     name?: string;
@@ -236,8 +287,22 @@ export declare class CredentialsApi extends HttpApi {
     remove(credentialsId: string): Promise<void>;
 }
 
+export declare interface Customer {
+    id?: string;
+    owner?: string;
+    name?: string;
+    email?: string;
+    phone?: string;
+    address?: string;
+    stripeCustomerId?: string;
+}
+
 export declare type DocumentExtractorName = 'fitz' | 'document-ai' | 'gemini' | 'markdown';
 
+export declare interface DowngradeSubscriptionRequest {
+    toPlanType: string;
+}
+
 export declare type EmbeddingModelName = 'text-multilingual-embedding-002' | 'gemini-embedding-001';
 
 export declare interface ExecuteRequest {
@@ -387,6 +452,23 @@ export declare interface ImapTriggerSourceConfiguration {
     allowedMimeTypes?: string[];
 }
 
+export declare interface Invoice {
+    id?: string;
+    subscriptionId?: string;
+    status?: string;
+    amountDue?: number;
+    amountPaid?: number;
+    currency?: string;
+    customerEmail?: string;
+    customerName?: string;
+    hostedInvoiceUrl?: string;
+    invoicePdf?: string;
+    dueDate?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    lines?: LineItem[];
+}
+
 export declare interface KnowledgeBase {
     id?: string;
     projectId?: string;
@@ -475,6 +557,15 @@ export declare type KnowledgeType = 'multi_hop' | 'simple';
 
 export declare type LanguageCode = 'en-US' | 'it-IT' | 'es-ES' | 'fr-FR' | 'de-DE' | 'pt-BR';
 
+export declare interface LineItem {
+    description?: string;
+    amount?: number;
+    currency?: string;
+    quantity?: number;
+    periodStart?: string;
+    periodEnd?: string;
+}
+
 export declare interface McpServerConfiguration {
     type?: string;
     name?: string;
@@ -488,6 +579,10 @@ export declare interface McpToolsResponse {
     error?: string;
 }
 
+export declare interface MentorizeSubscriptionRequest {
+    endDate?: string;
+}
+
 export declare interface Message {
     id?: string;
     sessionId?: string;
@@ -625,6 +720,20 @@ export declare interface Paginated<T> {
     size: number;
 }
 
+export declare interface Payment {
+    id?: string;
+    subscriptionId?: string;
+    status?: string;
+    product?: string;
+    quantity?: number;
+    createdAt?: string;
+    updatedAt?: string;
+    checkoutUrl?: string;
+    stripeCheckoutSessionId?: string;
+    stripeCustomerId?: string;
+    stripeSubscriptionId?: string;
+}
+
 export declare class PersonaSdk {
     private readonly baseUrl;
     private readonly workflowsBaseUrl;
@@ -649,6 +758,8 @@ export declare class PersonaSdk {
     sessions(authProvider: AuthenticationProvider): SessionsApi;
     missions(apiKey: string): MissionsApi;
     missions(authProvider: AuthenticationProvider): MissionsApi;
+    billing(baseUrl?: string): BillingClient;
+    billing(auth: string | AuthenticationProvider): BillingClient;
 }
 
 export declare interface Position {
@@ -860,6 +971,23 @@ export declare interface StmConfiguration {
 
 export declare type StmType = 'simple' | 'summary';
 
+export declare interface Subscription {
+    id?: string;
+    projectId?: string;
+    owner?: string;
+    planType?: string;
+    status?: string;
+    startDate?: string;
+    planCredits?: number;
+    extraCredits?: number;
+    keepCreditsOnRenew?: boolean;
+    endDate?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    stripeCustomerId?: string;
+    stripeSubscriptionId?: string;
+}
+
 export declare interface SynthesizerConfiguration {
     enabled?: boolean;
     synthesizerName?: SynthesizerName;
@@ -996,6 +1124,16 @@ export declare interface TwilioConfiguration {
     phoneNumber?: string;
 }
 
+export declare interface UpdateCustomerRequest {
+    name?: string;
+    email?: string;
+    phone?: string;
+}
+
+export declare interface UpgradeSubscriptionRequest {
+    toPlanType: string;
+}
+
 export declare interface UsageCost {
     service?: string;
     value?: number;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@applica-software-guru/persona-sdk",
   "description": "Official TypeScript SDK for the Persona API — manage agents, sessions, projects, knowledge bases, workflows, triggers and more.",
   "private": false,
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "scripts": {
     "dev": "vite",

package/src/billing/billing-client.ts

@@ -0,0 +1,142 @@
+import { AuthenticationProvider } from '../auth/authentication-provider';
+import { ApiException } from '../exceptions';
+import {
+  Customer,
+  Subscription,
+  Invoice,
+  CreateCustomerRequest,
+  UpdateCustomerRequest,
+  CreateSubscriptionRequest,
+  UpgradeSubscriptionRequest,
+  DowngradeSubscriptionRequest,
+  MentorizeSubscriptionRequest,
+} from './types';
+
+export class BillingClient {
+  private readonly baseUrl: string;
+  private readonly authProvider: AuthenticationProvider | string | null;
+
+  constructor(baseUrl?: string, auth?: string | AuthenticationProvider | null) {
+    this.baseUrl = (baseUrl || 'https://persona.applica.guru/billing').replace(/\/$/, '');
+    this.authProvider = auth ?? null;
+  }
+
+  private buildHeaders(): Headers {
+    const headers = new Headers();
+    headers.set('Content-Type', 'application/json');
+    if (this.authProvider) {
+      if (typeof this.authProvider === 'string') {
+        headers.set('x-persona-apikey', this.authProvider);
+      } else {
+        this.authProvider.applyHeaders(headers);
+      }
+    }
+    return headers;
+  }
+
+  private async request<T>(path: string, method: string, body?: unknown): Promise<T> {
+    const response = await fetch(this.baseUrl + path, {
+      method,
+      headers: this.buildHeaders(),
+      body: body ? JSON.stringify(body) : undefined,
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new ApiException(response.status, text);
+    }
+    const text = await response.text();
+    return text ? JSON.parse(text) : (undefined as T);
+  }
+
+  async createCustomer(request: CreateCustomerRequest): Promise<Customer> {
+    return this.request<Customer>('/customers', 'POST', request);
+  }
+
+  async updateCustomer(owner: string, request: UpdateCustomerRequest): Promise<Customer> {
+    return this.request<Customer>('/customers/' + owner, 'PUT', request);
+  }
+
+  async getCustomer(owner: string): Promise<Customer> {
+    return this.request<Customer>('/customers/' + owner, 'GET');
+  }
+
+  async saveCustomer(customer: Customer): Promise<Customer> {
+    return this.request<Customer>('/customers', 'POST', customer);
+  }
+
+  async deleteCustomer(owner: string): Promise<void> {
+    await this.request<void>('/customers/' + owner, 'DELETE');
+  }
+
+  async createSubscription(request: CreateSubscriptionRequest): Promise<Subscription> {
+    return this.request<Subscription>('/customers/' + request.owner + '/subscription', 'POST', request);
+  }
+
+  async getSubscription(owner: string): Promise<Subscription> {
+    return this.request<Subscription>('/customers/' + owner + '/subscription', 'GET');
+  }
+
+  async getProjectSubscription(projectId: string): Promise<Subscription> {
+    return this.request<Subscription>('/projects/' + projectId + '/subscription', 'GET');
+  }
+
+  async changeProjectSubscriptionPlan(projectId: string, request: { toPlanType: string }): Promise<Subscription> {
+    return this.request<Subscription>('/projects/' + projectId + '/subscription/actions/change-plan', 'POST', request);
+  }
+
+  async addProjectSubscriptionCredits(projectId: string, request: { credits: number }): Promise<Subscription> {
+    return this.request<Subscription>('/projects/' + projectId + '/subscription/actions/add-credits', 'POST', request);
+  }
+
+  async beginUpgrade(owner: string, request: UpgradeSubscriptionRequest): Promise<Subscription> {
+    return this.request<Subscription>('/customers/' + owner + '/subscription/actions/upgrade', 'POST', request);
+  }
+
+  async downgrade(owner: string, request: DowngradeSubscriptionRequest): Promise<Subscription> {
+    return this.request<Subscription>('/customers/' + owner + '/subscription/actions/downgrade', 'POST', request);
+  }
+
+  async mentorize(owner: string, request: MentorizeSubscriptionRequest): Promise<Subscription> {
+    return this.request<Subscription>('/customers/' + owner + '/subscription/actions/mentorize', 'POST', request);
+  }
+
+  async addCredits(owner: string, credits: number): Promise<Subscription> {
+    return this.request<Subscription>('/customers/' + owner + '/subscription/credits', 'POST', { credits });
+  }
+
+  async useCredits(owner: string, credits: number, services: string[], referenceId?: string): Promise<Subscription> {
+    const body: Record<string, unknown> = { credits, services };
+    if (referenceId) body.referenceId = referenceId;
+    return this.request<Subscription>('/customers/' + owner + '/subscription/credits', 'DELETE', body);
+  }
+
+  async getCredits(owner: string): Promise<number> {
+    try {
+      const result = await this.request<{ credits?: number }>('/customers/' + owner + '/subscription/credits', 'GET');
+      return result.credits ?? 0;
+    } catch {
+      return 0;
+    }
+  }
+
+  async isValid(owner: string): Promise<boolean> {
+    try {
+      const result = await this.request<{ valid?: boolean }>('/customers/' + owner + '/subscription/valid', 'GET');
+      return result.valid ?? false;
+    } catch {
+      return false;
+    }
+  }
+
+  async listInvoices(owner: string, dateFrom?: string, dateTo?: string): Promise<Invoice[]> {
+    const params: string[] = [];
+    if (dateFrom) params.push('date_from=' + dateFrom);
+    if (dateTo) params.push('date_to=' + dateTo);
+    const query = params.length > 0 ? '?' + params.join('&') : '';
+    return this.request<Invoice[]>('/customers/' + owner + '/invoices' + query, 'GET');
+  }
+
+  async cancelSubscription(owner: string): Promise<Subscription> {
+    return this.request<Subscription>('/customers/' + owner + '/subscription/actions/cancel', 'POST', {});
+  }
+}

package/src/billing/types.ts

@@ -0,0 +1,104 @@
+export interface Customer {
+  id?: string;
+  owner?: string;
+  name?: string;
+  email?: string;
+  phone?: string;
+  address?: string;
+  stripeCustomerId?: string;
+}
+
+export interface Subscription {
+  id?: string;
+  projectId?: string;
+  owner?: string;
+  planType?: string;
+  status?: string;
+  startDate?: string;
+  planCredits?: number;
+  extraCredits?: number;
+  keepCreditsOnRenew?: boolean;
+  endDate?: string;
+  createdAt?: string;
+  updatedAt?: string;
+  stripeCustomerId?: string;
+  stripeSubscriptionId?: string;
+}
+
+export interface Invoice {
+  id?: string;
+  subscriptionId?: string;
+  status?: string;
+  amountDue?: number;
+  amountPaid?: number;
+  currency?: string;
+  customerEmail?: string;
+  customerName?: string;
+  hostedInvoiceUrl?: string;
+  invoicePdf?: string;
+  dueDate?: string;
+  createdAt?: string;
+  updatedAt?: string;
+  lines?: LineItem[];
+}
+
+export interface LineItem {
+  description?: string;
+  amount?: number;
+  currency?: string;
+  quantity?: number;
+  periodStart?: string;
+  periodEnd?: string;
+}
+
+export interface Usage {
+  id?: string;
+  subscriptionId?: string;
+  creditsUsed?: number;
+  services?: string[];
+  referenceId?: string;
+  createdAt?: string;
+}
+
+export interface Payment {
+  id?: string;
+  subscriptionId?: string;
+  status?: string;
+  product?: string;
+  quantity?: number;
+  createdAt?: string;
+  updatedAt?: string;
+  checkoutUrl?: string;
+  stripeCheckoutSessionId?: string;
+  stripeCustomerId?: string;
+  stripeSubscriptionId?: string;
+}
+
+export interface CreateCustomerRequest {
+  owner?: string;
+  name?: string;
+  email?: string;
+  phone?: string;
+}
+
+export interface UpdateCustomerRequest {
+  name?: string;
+  email?: string;
+  phone?: string;
+}
+
+export interface CreateSubscriptionRequest {
+  owner: string;
+}
+
+export interface UpgradeSubscriptionRequest {
+  toPlanType: string;
+}
+
+export interface DowngradeSubscriptionRequest {
+  toPlanType: string;
+}
+
+export interface MentorizeSubscriptionRequest {
+  endDate?: string;
+}

package/src/index.ts

@@ -151,3 +151,18 @@ export type { Mission, MissionStatus } from './missions/types';
 export { ServicePricesApi } from './service-prices/service-prices-api';
 export type { ServicePrice } from './service-prices/types';
 export type { Revision as RevisionType } from './revisions/types';
+export { BillingClient } from './billing/billing-client';
+export type {
+  Customer,
+  Subscription,
+  Invoice,
+  LineItem,
+  Usage as BillingUsage,
+  Payment,
+  CreateCustomerRequest,
+  UpdateCustomerRequest,
+  CreateSubscriptionRequest,
+  UpgradeSubscriptionRequest,
+  DowngradeSubscriptionRequest,
+  MentorizeSubscriptionRequest,
+} from './billing/types';

package/src/persona-sdk.ts

@@ -9,6 +9,7 @@ import { TriggersApi } from './triggers/triggers-api';
 import { ServicePricesApi } from './service-prices/service-prices-api';
 import { SessionsApi } from './sessions/sessions-api';
 import { MissionsApi } from './missions/missions-api';
+import { BillingClient } from './billing/billing-client';
 
 export class PersonaSdk {
   private readonly baseUrl: string;
@@ -78,4 +79,13 @@ export class PersonaSdk {
   missions(auth: string | AuthenticationProvider): MissionsApi {
     return new MissionsApi(this.baseUrl, auth);
   }
+
+  billing(baseUrl?: string): BillingClient;
+  billing(auth: string | AuthenticationProvider): BillingClient;
+  billing(baseUrlOrAuth?: string | AuthenticationProvider): BillingClient {
+    if (!baseUrlOrAuth || typeof baseUrlOrAuth !== 'string') {
+      return new BillingClient(undefined, baseUrlOrAuth);
+    }
+    return new BillingClient(baseUrlOrAuth);
+  }
 }