@ecodrix/erix-api 1.2.7 → 1.2.9

package/src/resources/logs.ts

@@ -1,97 +0,0 @@
-import { APIResource } from "../resource";
-
-export interface LogPaginationQuery {
-  page?: number;
-  limit?: number;
-  trigger?: string;
-  status?: "received" | "processing" | "completed" | "partial" | "failed";
-  from?: string;
-  to?: string;
-}
-
-export interface EventLog {
-  id: string;
-  trigger: string;
-  phone?: string;
-  email?: string;
-  status: "received" | "processing" | "completed" | "partial" | "failed";
-  rulesMatched: number;
-  jobsCreated: number;
-  meetLink?: string;
-  callbackUrl?: string;
-  callbackStatus: "not_required" | "sent" | "failed";
-  payload: any;
-  error?: string;
-  idempotencyKey?: string;
-  processedAt?: string;
-  createdAt: string;
-  updatedAt: string;
-}
-
-export interface CallbackLog {
-  id: string;
-  callbackUrl: string;
-  method: string;
-  payload: any;
-  jobId?: string;
-  enrollmentId?: string;
-  responseStatus: number;
-  responseBody: string;
-  status: "sent" | "failed" | "pending_retry";
-  attempts: number;
-  lastAttemptAt?: string;
-  signature?: string;
-  createdAt: string;
-}
-
-export interface LogResponse<T> {
-  success: boolean;
-  data: T[];
-  pagination: {
-    total: number;
-    page: number;
-    limit: number;
-    pages: number;
-  };
-}
-
-/**
- * Audit and execution logs for platform events and webhooks.
- *
- * Access via `ecod.logs`.
- */
-export class Logs extends APIResource {
-  /**
-   * List event execution logs with optional filtering.
-   *
-   * Use this to audit automation triggers and debug workflow execution.
-   */
-  async listEventLogs(query?: LogPaginationQuery): Promise<LogResponse<EventLog>> {
-    return this.get<LogResponse<EventLog>>("/api/saas/events/logs", {
-      params: query,
-    });
-  }
-
-  /**
-   * Get detailed information for a single event execution.
-   */
-  async getEventLog(id: string): Promise<{ success: boolean; data: EventLog }> {
-    return this.get<{ success: boolean; data: EventLog }>(`/api/saas/events/logs/${id}`);
-  }
-
-  /**
-   * List webhook callback logs (outbound responses from ECODrIx to your system).
-   */
-  async listCallbackLogs(query?: LogPaginationQuery): Promise<LogResponse<CallbackLog>> {
-    return this.get<LogResponse<CallbackLog>>("/api/saas/callbacks/logs", {
-      params: query,
-    });
-  }
-
-  /**
-   * Get high-level execution statistics for the tenant.
-   */
-  async getStats(): Promise<{ success: boolean; data: any }> {
-    return this.get<{ success: boolean; data: any }>("/api/saas/events/stats");
-  }
-}

package/src/resources/marketing.ts

@@ -1,179 +0,0 @@
-import { APIResource } from "../resource";
-
-export interface SendCampaignParams {
-  recipients: string[];
-  subject: string;
-  html: string;
-}
-
-export class Emails extends APIResource {
-  /**
-   * Dispatch a bulk email campaign to a list of recipients.
-   *
-   * @param params - The campaign details (recipients, subject, html).
-   * @returns The dispatch result.
-   * @example
-   * ```typescript
-   * await erixClient.marketing.emails.sendCampaign({
-   *   recipients: ["user@example.com"],
-   *   subject: "Special Offer",
-   *   html: "<p>Check out our deal!</p>"
-   * });
-   * ```
-   */
-  async sendCampaign<T = any>(params: SendCampaignParams) {
-    return this.post<T>("/api/saas/marketing/emails/campaign", params);
-  }
-
-  /**
-   * Send a test verification email (used to verify SMTP functionality).
-   */
-  async sendTest<T = any>(to: string) {
-    return this.post<T>("/api/saas/marketing/emails/test", { to });
-  }
-}
-export class Campaigns extends APIResource {
-  /**
-   * List all email and SMS marketing campaigns with optional status filtering.
-   *
-   * @param params - Optional filters (status, limit).
-   * @returns Paginated list of campaign objects.
-   * @example
-   * ```typescript
-   * const campaigns = await erixClient.marketing.campaigns.list({ status: "sent" });
-   * ```
-   */
-  async list<T = any>(params?: { status?: string; limit?: number }) {
-    return this.get<T>("/api/saas/marketing/campaigns", { params } as any);
-  }
-
-  /**
-   * Create a new marketing campaign (Email or SMS).
-   *
-   * @param payload - Campaign details (name, type, content).
-   * @returns The created campaign record.
-   * @example
-   * ```typescript
-   * await erixClient.marketing.campaigns.create({
-   *   name: "Spring Sale",
-   *   type: "email",
-   *   subject: "Our Spring Sale is Here!",
-   *   html: "<h1>BIG DEALS!</h1>"
-   * });
-   * ```
-   */
-  async create<T = any>(payload: {
-    name: string;
-    type: string;
-    subject?: string;
-    html?: string;
-    templateId?: string;
-    recipients?: string[];
-  }) {
-    return this.post<T>("/api/saas/marketing/campaigns", payload);
-  }
-
-  /**
-   * Retrieve full details for a specific marketing campaign.
-   *
-   * @param campaignId - The unique ID of the campaign.
-   * @example
-   * ```typescript
-   * const campaign = await erixClient.marketing.campaigns.retrieve("camp_123");
-   * ```
-   */
-  async retrieve<T = any>(campaignId: string) {
-    return this.get<T>(`/api/saas/marketing/campaigns/${campaignId}`);
-  }
-
-  /**
-   * Update a campaign.
-   */
-  async update<T = any>(campaignId: string, payload: any) {
-    return this.patch<T>(`/api/saas/marketing/campaigns/${campaignId}`, payload);
-  }
-
-  /**
-   * Delete a campaign.
-   */
-  async delete<T = any>(campaignId: string) {
-    return this.deleteRequest<T>(`/api/saas/marketing/campaigns/${campaignId}`);
-  }
-
-  /**
-   * Send a campaign immediately or schedule it for a later date.
-   *
-   * @param campaignId - The ID of the campaign to dispatch.
-   * @param payload - Optional scheduling information (ISO timestamp).
-   * @example
-   * ```typescript
-   * // Send immediately
-   * await erixClient.marketing.campaigns.send("camp_123");
-   *
-   * // Schedule for tomorrow
-   * await erixClient.marketing.campaigns.send("camp_123", {
-   *   scheduledAt: "2026-04-10T09:00:00Z"
-   * });
-   * ```
-   */
-  async send<T = any>(campaignId: string, payload?: { scheduledAt?: string }) {
-    return this.post<T>(`/api/saas/marketing/campaigns/${campaignId}/send`, payload || {});
-  }
-
-  /**
-   * Get detailed delivery and engagement statistics for a campaign.
-   * Includes opens, clicks, bounces, and delivery failures.
-   *
-   * @param campaignId - The ID of the campaign.
-   * @returns Stats summary object.
-   * @example
-   * ```typescript
-   * const report = await erixClient.marketing.campaigns.stats("camp_123");
-   * console.log(`Open Rate: ${report.openRate}%`);
-   * ```
-   */
-  async stats<T = any>(campaignId: string) {
-    return this.get<T>(`/api/saas/marketing/campaigns/${campaignId}/stats`);
-  }
-}
-
-export class WhatsAppMarketing extends APIResource {
-  /**
-   * Dispatch a template-based WhatsApp message with CRM-integrated variable resolution.
-   *
-   * Unlike direct WhatsApp sending, this endpoint documentation automatically pulls data from the CRM
-   * based on the provided variables mapping.
-   *
-   * @param params - Template details and recipient phone.
-   * @example
-   * ```typescript
-   * await erixClient.marketing.whatsapp.sendTemplate({
-   *   phone: "+919876543210",
-   *   templateName: "order_update",
-   *   variables: { "1": "Order #123" }
-   * });
-   * ```
-   */
-  async sendTemplate<T = any>(params: {
-    phone: string;
-    templateName: string;
-    languageCode?: string;
-    variables?: Record<string, string>;
-    resolvedVariables?: Record<string, string>;
-  }) {
-    return this.post<T>("/api/saas/marketing/whatsapp/send-template", params);
-  }
-}
-
-export class Marketing extends APIResource {
-  public emails: Emails;
-  public campaigns: Campaigns;
-  public whatsapp: WhatsAppMarketing;
-
-  constructor(client: any) {
-    super(client);
-    this.emails = new Emails(client);
-    this.campaigns = new Campaigns(client);
-    this.whatsapp = new WhatsAppMarketing(client);
-  }
-}

package/src/resources/media.ts

@@ -1,184 +0,0 @@
-import axios from "axios";
-import { APIResource } from "../resource";
-
-/**
- * Options for the `upload()` elite helper.
- */
-export interface UploadOptions {
-  /**
-   * The destination folder key in R2.
-   * @example "customer_documents" | "avatars" | "invoices"
-   */
-  folder: string;
-  /**
-   * The desired filename, including extension.
-   * @example "contract.pdf" | "profile.jpg"
-   */
-  filename: string;
-  /**
-   * The MIME type of the file.
-   * @example "application/pdf" | "image/jpeg" | "video/mp4"
-   */
-  contentType: string;
-}
-
-/**
- * Cloudflare R2-backed media resource.
- *
- * Access via `ecod.media`.
- *
- * The `upload()` method is the recommended approach. It acts as a client-side
- * orchestrator: it fetches a presigned URL from the backend, uploads directly
- * to R2 (bypassing the API server), then confirms the upload — all in one call.
- *
- * @example
- * ```typescript
- * const { data } = await ecod.media.upload(fileBuffer, {
- *   folder: "invoices",
- *   filename: "invoice-001.pdf",
- *   contentType: "application/pdf",
- * });
- * console.log(data.url); // → https://cdn.ecodrix.com/invoices/invoice-001.pdf
- * ```
- */
-export class Media extends APIResource {
-  /**
-   * Get current storage usage metrics for the tenant.
-   *
-   * @returns `{ usedMB, limitMB, fileCount }`
-   *
-   * @example
-   * ```typescript
-   * const { data } = await ecod.media.getUsage();
-   * console.log(`${data.usedMB} / ${data.limitMB} MB used`);
-   * ```
-   */
-  async getUsage() {
-    return this.get("/api/saas/storage/usage");
-  }
-
-  /**
-   * Create a new top-level folder in the tenant's R2 bucket.
-   *
-   * @param name - Folder name (alphanumeric, hyphens, underscores).
-   *
-   * @example
-   * ```typescript
-   * await ecod.media.createFolder("patient_records");
-   * ```
-   */
-  async createFolder(name: string) {
-    return this.post("/api/saas/storage/folders", { name });
-  }
-
-  /**
-   * List files within a folder, with optional date / search filtering.
-   *
-   * @param folder - The folder name to list, **or `"*"` to fetch all folders**
-   *   for the tenant in a single call (returns a merged flat list with a
-   *   `folder` field on each file so callers can group/filter client-side).
-   * @param params - Optional `year`, `month`, and keyword search `q` filters.
-   * @returns `{ data: { files, count, totalSizeBytes } }`.
-   *
-   * @example Single folder
-   * ```typescript
-   * const { data } = await ecod.media.list("invoices", { q: "contract" });
-   * // data.files → files only from the "invoices" folder
-   * ```
-   *
-   * @example All folders
-   * ```typescript
-   * const { data } = await ecod.media.list("*");
-   * // data.files → merged files from every folder the tenant has
-   * // Each file has a `folder` field indicating its source folder
-   * ```
-   */
-  async list(folder: string, params?: { year?: string; month?: string; q?: string }) {
-    return this.get(`/api/saas/storage/files/${folder}`, { params } as any);
-  }
-
-  /**
-   * Delete a file from R2 by its storage key.
-   *
-   * @param key - The full storage key of the file (e.g. `"invoices/contract.pdf"`).
-   *
-   * @example
-   * ```typescript
-   * await ecod.media.delete("invoices/old-contract.pdf");
-   * ```
-   */
-  async delete(key: string) {
-    return this.deleteRequest("/api/saas/storage/files", { params: { key } });
-  }
-
-  /**
-   * Request a temporary presigned download URL for a private file.
-   *
-   * @param key - The full storage key of the file.
-   * @returns `{ url }` — a time-limited download URL.
-   *
-   * @example
-   * ```typescript
-   * const { data } = await ecod.media.getDownloadUrl("invoices/contract.pdf");
-   * // → { url: "https://cdn.ecodrix.com/...?token=..." }
-   * ```
-   */
-  async getDownloadUrl(key: string) {
-    return this.post("/api/saas/storage/download-url", { key });
-  }
-
-  /**
-   * **Elite Upload Helper** — uploads a file to Cloudflare R2 in a single call.
-   *
-   * This orchestrates 3 steps transparently:
-   * 1. Fetch a presigned `PUT` URL from the ECODrIx backend.
-   * 2. Upload the file _directly_ to R2 (no API proxy, maximum throughput).
-   * 3. Confirm the upload with the backend so it is indexed and tracked.
-   *
-   * Works with Node.js `Buffer`, browser `File`/`Blob`, or any stream-like
-   * object that Axios can PUT.
-   *
-   * @param file - The file data to upload.
-   * @param options - Folder, filename, and content type.
-   * @returns Confirmed file metadata including `key` and `url`.
-   *
-   * @example Node.js
-   * ```typescript
-   * import { readFileSync } from "fs";
-   * const buf = readFileSync("./invoice.pdf");
-   * const { data } = await ecod.media.upload(buf, {
-   *   folder: "invoices",
-   *   filename: "invoice-001.pdf",
-   *   contentType: "application/pdf",
-   * });
-   * ```
-   *
-   * @example Browser
-   * ```typescript
-   * const file = inputElement.files[0];
-   * const { data } = await ecod.media.upload(file, {
-   *   folder: "avatars",
-   *   filename: file.name,
-   *   contentType: file.type,
-   * });
-   * ```
-   */
-  async upload(file: any, options: UploadOptions): Promise<any> {
-    // Step 1: Get presigned URL
-    const response = await this.post<any>("/api/saas/storage/upload-url", options);
-    const { uploadUrl, key } = response.data;
-
-    // Step 2: Upload directly to R2 (bypasses the API server for performance)
-    await axios.put(uploadUrl, file, {
-      headers: { "Content-Type": options.contentType },
-    });
-
-    const sizeBytes = file.size || file.byteLength || 0;
-
-    // Step 3: Confirm with backend
-    return this.post("/api/saas/storage/confirm-upload", { key, sizeBytes });
-  }
-}
-
-/** @deprecated Use Media instead */
-export class MediaResource extends Media {}

package/src/resources/meet.ts

@@ -1,163 +0,0 @@
-import { APIResource } from "../resource";
-
-/**
- * Parameters for scheduling a new Google Meet appointment.
- */
-export interface CreateMeetingParams {
-  /** The CRM Lead ID this meeting belongs to. */
-  leadId: string;
-  /** Full name of the external participant. */
-  participantName: string;
-  /** Phone number of the participant in E.164 format. */
-  participantPhone: string;
-  /**
-   * Meeting start time.
-   * @example new Date("2026-04-10T10:00:00.000Z")
-   */
-  startTime: Date | string;
-  /**
-   * Meeting end time.
-   * @example new Date("2026-04-10T10:30:00.000Z")
-   */
-  endTime: Date | string;
-  /** Arbitrary metadata to attach to the meeting record. */
-  metadata?: Record<string, any>;
-}
-
-/**
- * Parameters for updating an existing meeting.
- */
-export interface UpdateMeetingParams {
-  /**
-   * Update the meeting status.
-   * @example "scheduled" | "completed" | "cancelled"
-   */
-  status?: string;
-  /** Update the payment status for paid consultations. */
-  paymentStatus?: string;
-  /** New start time for rescheduling. */
-  startTime?: Date | string;
-  /** New end time for rescheduling. */
-  endTime?: Date | string;
-  /** Duration in minutes. */
-  duration?: number;
-}
-
-/**
- * Google Meet appointment scheduling resource.
- *
- * Access via `ecod.meet`.
- *
- * @example
- * ```typescript
- * const { data } = await ecod.meet.create({
- *   leadId: "64abc...",
- *   participantName: "Alice",
- *   participantPhone: "+919876543210",
- *   startTime: "2026-04-10T10:00:00Z",
- *   endTime: "2026-04-10T10:30:00Z",
- * });
- * console.log(data.meetLink); // → https://meet.google.com/abc-defg-hij
- * ```
- */
-export class Meetings extends APIResource {
-  /**
-   * Schedule a new Google Meet with a lead.
-   *
-   * The backend automatically creates a Google Calendar event and generates
-   * a Meet link, then sends confirmation notifications via WhatsApp.
-   *
-   * @param data - Meeting details.
-   * @returns The created Meeting document including `meetLink`.
-   *
-   * @example
-   * ```typescript
-   * const { data } = await ecod.meet.create({
-   *   leadId: "64abc...",
-   *   participantName: "Alice",
-   *   participantPhone: "+91...",
-   *   startTime: "2026-04-10T10:00:00Z",
-   *   endTime: "2026-04-10T10:30:00Z",
-   * });
-   * ```
-   */
-  async create(data: CreateMeetingParams): Promise<any> {
-    return this.post("/api/saas/meet", data);
-  }
-
-  /**
-   * List all meetings for the tenant, with optional filters.
-   *
-   * @param params - `leadId` to filter by lead; `status` to filter by state.
-   * @returns Array of Meeting documents.
-   *
-   * @example
-   * ```typescript
-   * const { data } = await ecod.meet.list({ status: "scheduled" });
-   * ```
-   */
-  async list(params?: { leadId?: string; status?: string }): Promise<any> {
-    return this.get("/api/saas/meet", { params } as any);
-  }
-
-  /**
-   * Retrieve the full details for a specific meeting.
-   *
-   * @param meetingId - The unique meeting ID.
-   * @returns The Meeting document.
-   *
-   * @example
-   * ```typescript
-   * const { data } = await ecod.meet.retrieve("meeting_id");
-   * ```
-   */
-  async retrieve(meetingId: string): Promise<any> {
-    return this.get(`/api/saas/meet/${meetingId}`);
-  }
-
-  /**
-   * Update or reschedule an existing meeting.
-   *
-   * Partial updates are supported — only supply the fields you wish to change.
-   *
-   * @param meetingId - The meeting to update.
-   * @param data - Fields to update.
-   * @returns The updated Meeting document.
-   *
-   * @example
-   * ```typescript
-   * // Reschedule
-   * await ecod.meet.update("meeting_id", {
-   *   startTime: "2026-04-11T11:00:00Z",
-   *   endTime: "2026-04-11T11:30:00Z",
-   * });
-   * ```
-   */
-  async update<T = any>(meetingId: string, data: UpdateMeetingParams) {
-    return this.patch<T>(`/api/saas/meet/${meetingId}`, data);
-  }
-
-  /**
-   * Reschedule an existing meeting. Provides explicit method for time modifications.
-   */
-  async reschedule<T = any>(
-    meetingId: string,
-    params: { startTime: Date | string; endTime: Date | string; duration?: number },
-  ) {
-    return this.patch<T>(`/api/saas/meet/${meetingId}`, params);
-  }
-
-  /**
-   * Cancel a meeting. This sets the meeting status to `"cancelled"`.
-   *
-   * @param meetingId - The meeting to cancel.
-   *
-   * @example
-   * ```typescript
-   * await ecod.meet.delete("meeting_id");
-   * ```
-   */
-  async delete(meetingId: string): Promise<any> {
-    return this.update(meetingId, { status: "cancelled" });
-  }
-}