@l4yercak3/cli 1.2.16 → 1.2.18

package/src/generators/api-only/client.js

@@ -0,0 +1,683 @@
+/**
+ * Typed API Client Generator
+ * Generates a fully-typed API client for L4YERCAK3
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { ensureDir, writeFileWithBackup, checkFileOverwrite } = require('../../utils/file-utils');
+
+class ClientGenerator {
+  /**
+   * Generate the typed API client
+   * @param {Object} options - Generation options
+   * @returns {Promise<string|null>} - Path to generated file or null if skipped
+   */
+  async generate(options) {
+    const { projectPath, isTypeScript, organizationId, backendUrl } = options;
+
+    // Determine output directory
+    let outputDir;
+    if (fs.existsSync(path.join(projectPath, 'src'))) {
+      outputDir = path.join(projectPath, 'src', 'lib', 'l4yercak3');
+    } else {
+      outputDir = path.join(projectPath, 'lib', 'l4yercak3');
+    }
+
+    ensureDir(outputDir);
+
+    const extension = isTypeScript ? 'ts' : 'js';
+    const outputPath = path.join(outputDir, `client.${extension}`);
+
+    const action = await checkFileOverwrite(outputPath);
+    if (action === 'skip') {
+      return null;
+    }
+
+    const content = isTypeScript
+      ? this.generateTypeScriptClient({ organizationId, backendUrl })
+      : this.generateJavaScriptClient({ organizationId, backendUrl });
+
+    return writeFileWithBackup(outputPath, content, action);
+  }
+
+  generateTypeScriptClient({ organizationId, backendUrl }) {
+    return `/**
+ * L4YERCAK3 API Client
+ * Auto-generated by @l4yercak3/cli
+ *
+ * A fully-typed API client for the L4YERCAK3 platform.
+ * Organization ID: ${organizationId}
+ */
+
+import type {
+  Contact, ContactCreateInput, ContactUpdateInput,
+  Organization, OrganizationCreateInput,
+  Event, EventCreateInput,
+  Attendee,
+  Form, FormSubmission,
+  Product, Order, OrderItem,
+  Invoice, InvoiceCreateInput,
+  BenefitClaim, BenefitClaimInput,
+  CommissionPayout,
+  PaginatedResponse,
+} from './types';
+
+export class L4yercak3Client {
+  private apiKey: string;
+  private baseUrl: string;
+  private organizationId: string;
+
+  constructor(config: { apiKey: string; baseUrl?: string; organizationId?: string }) {
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl || '${backendUrl}';
+    this.organizationId = config.organizationId || '${organizationId}';
+  }
+
+  // ============ CRM: Contacts ============
+
+  async listContacts(params?: {
+    limit?: number;
+    offset?: number;
+    status?: 'active' | 'inactive' | 'archived';
+    subtype?: 'customer' | 'lead' | 'prospect' | 'partner';
+    search?: string;
+    tags?: string[];
+  }): Promise<PaginatedResponse<Contact>> {
+    return this.request('GET', '/api/v1/crm/contacts', { params });
+  }
+
+  async getContact(id: string, options?: {
+    includeActivities?: boolean;
+    includeNotes?: boolean;
+    includeOrganization?: boolean;
+  }): Promise<Contact> {
+    return this.request('GET', \`/api/v1/crm/contacts/\${id}\`, { params: options });
+  }
+
+  async createContact(data: ContactCreateInput): Promise<Contact> {
+    return this.request('POST', '/api/v1/crm/contacts', { body: data });
+  }
+
+  async updateContact(id: string, data: ContactUpdateInput): Promise<Contact> {
+    return this.request('PATCH', \`/api/v1/crm/contacts/\${id}\`, { body: data });
+  }
+
+  async deleteContact(id: string): Promise<void> {
+    return this.request('DELETE', \`/api/v1/crm/contacts/\${id}\`);
+  }
+
+  async addTagsToContact(id: string, tags: string[]): Promise<Contact> {
+    return this.request('POST', \`/api/v1/crm/contacts/\${id}/tags\`, { body: { tags } });
+  }
+
+  async removeTagsFromContact(id: string, tags: string[]): Promise<Contact> {
+    return this.request('DELETE', \`/api/v1/crm/contacts/\${id}/tags\`, { body: { tags } });
+  }
+
+  // ============ CRM: Organizations ============
+
+  async listOrganizations(params?: {
+    limit?: number;
+    offset?: number;
+    subtype?: 'customer' | 'prospect' | 'partner' | 'vendor';
+    search?: string;
+  }): Promise<PaginatedResponse<Organization>> {
+    return this.request('GET', '/api/v1/crm/organizations', { params });
+  }
+
+  async getOrganization(id: string, options?: {
+    includeContacts?: boolean;
+  }): Promise<Organization> {
+    return this.request('GET', \`/api/v1/crm/organizations/\${id}\`, { params: options });
+  }
+
+  async createOrganization(data: OrganizationCreateInput): Promise<Organization> {
+    return this.request('POST', '/api/v1/crm/organizations', { body: data });
+  }
+
+  // ============ Events ============
+
+  async listEvents(params?: {
+    status?: 'draft' | 'published' | 'cancelled' | 'completed';
+    fromDate?: string;
+    toDate?: string;
+    limit?: number;
+    offset?: number;
+  }): Promise<PaginatedResponse<Event>> {
+    return this.request('GET', '/api/v1/events', { params });
+  }
+
+  async getEvent(id: string, options?: {
+    includeProducts?: boolean;
+    includeSponsors?: boolean;
+    includeForms?: boolean;
+  }): Promise<Event> {
+    return this.request('GET', \`/api/v1/events/\${id}\`, { params: options });
+  }
+
+  async createEvent(data: EventCreateInput): Promise<Event> {
+    return this.request('POST', '/api/v1/events', { body: data });
+  }
+
+  async updateEvent(id: string, data: Partial<EventCreateInput>): Promise<Event> {
+    return this.request('PATCH', \`/api/v1/events/\${id}\`, { body: data });
+  }
+
+  async getEventAttendees(eventId: string, params?: {
+    status?: 'registered' | 'checked_in' | 'cancelled' | 'no_show';
+    limit?: number;
+    offset?: number;
+  }): Promise<PaginatedResponse<Attendee>> {
+    return this.request('GET', \`/api/v1/events/\${eventId}/attendees\`, { params });
+  }
+
+  async checkInAttendee(eventId: string, attendeeId: string): Promise<Attendee> {
+    return this.request('POST', \`/api/v1/events/\${eventId}/attendees/\${attendeeId}/check-in\`);
+  }
+
+  // ============ Forms ============
+
+  async listForms(params?: {
+    status?: 'draft' | 'published' | 'closed';
+    eventId?: string;
+    subtype?: 'registration' | 'survey' | 'application' | 'feedback' | 'contact';
+    limit?: number;
+  }): Promise<PaginatedResponse<Form>> {
+    return this.request('GET', '/api/v1/forms', { params });
+  }
+
+  async getForm(id: string): Promise<Form> {
+    return this.request('GET', \`/api/v1/forms/\${id}\`);
+  }
+
+  async submitForm(formId: string, data: Record<string, unknown>): Promise<FormSubmission> {
+    return this.request('POST', \`/api/v1/forms/\${formId}/submit\`, { body: data });
+  }
+
+  async getFormResponses(formId: string, params?: {
+    status?: 'submitted' | 'reviewed' | 'approved' | 'rejected';
+    limit?: number;
+    offset?: number;
+  }): Promise<PaginatedResponse<FormSubmission>> {
+    return this.request('GET', \`/api/v1/forms/\${formId}/responses\`, { params });
+  }
+
+  // ============ Products ============
+
+  async listProducts(params?: {
+    eventId?: string;
+    status?: 'active' | 'sold_out' | 'hidden';
+    category?: string;
+    limit?: number;
+  }): Promise<PaginatedResponse<Product>> {
+    return this.request('GET', '/api/v1/products', { params });
+  }
+
+  async getProduct(id: string): Promise<Product> {
+    return this.request('GET', \`/api/v1/products/\${id}\`);
+  }
+
+  // ============ Checkout ============
+
+  async createCheckoutSession(data: {
+    items: Array<{ productId: string; quantity: number }>;
+    contactId?: string;
+    email?: string;
+    successUrl: string;
+    cancelUrl: string;
+    metadata?: Record<string, string>;
+  }): Promise<{ sessionId: string; checkoutUrl: string }> {
+    return this.request('POST', '/api/v1/checkout/sessions', { body: data });
+  }
+
+  async getCheckoutSession(sessionId: string): Promise<{
+    sessionId: string;
+    status: 'open' | 'complete' | 'expired';
+    order?: Order;
+  }> {
+    return this.request('GET', \`/api/v1/checkout/sessions/\${sessionId}\`);
+  }
+
+  // ============ Orders ============
+
+  async listOrders(params?: {
+    contactId?: string;
+    status?: 'pending' | 'paid' | 'refunded' | 'cancelled';
+    fromDate?: string;
+    toDate?: string;
+    limit?: number;
+  }): Promise<PaginatedResponse<Order>> {
+    return this.request('GET', '/api/v1/orders', { params });
+  }
+
+  async getOrder(id: string): Promise<Order> {
+    return this.request('GET', \`/api/v1/orders/\${id}\`);
+  }
+
+  // ============ Invoicing ============
+
+  async listInvoices(params?: {
+    contactId?: string;
+    organizationId?: string;
+    status?: 'draft' | 'sent' | 'paid' | 'overdue' | 'cancelled';
+    type?: 'b2b' | 'b2c';
+    limit?: number;
+  }): Promise<PaginatedResponse<Invoice>> {
+    return this.request('GET', '/api/v1/invoices', { params });
+  }
+
+  async getInvoice(id: string): Promise<Invoice> {
+    return this.request('GET', \`/api/v1/invoices/\${id}\`);
+  }
+
+  async createInvoice(data: InvoiceCreateInput): Promise<Invoice> {
+    return this.request('POST', '/api/v1/invoices', { body: data });
+  }
+
+  async sendInvoice(id: string, options?: {
+    emailTo?: string;
+    message?: string;
+  }): Promise<void> {
+    return this.request('POST', \`/api/v1/invoices/\${id}/send\`, { body: options });
+  }
+
+  async markInvoicePaid(id: string, data?: {
+    paidAt?: string;
+    paymentMethod?: string;
+    paymentReference?: string;
+  }): Promise<Invoice> {
+    return this.request('POST', \`/api/v1/invoices/\${id}/mark-paid\`, { body: data });
+  }
+
+  async getInvoicePdf(id: string): Promise<{ pdfUrl: string }> {
+    return this.request('GET', \`/api/v1/invoices/\${id}/pdf\`);
+  }
+
+  // ============ Benefits ============
+
+  async listBenefitClaims(params?: {
+    memberId?: string;
+    status?: 'pending' | 'approved' | 'rejected' | 'paid' | 'cancelled';
+    benefitType?: string;
+    limit?: number;
+  }): Promise<PaginatedResponse<BenefitClaim>> {
+    return this.request('GET', '/api/v1/benefits/claims', { params });
+  }
+
+  async getBenefitClaim(id: string): Promise<BenefitClaim> {
+    return this.request('GET', \`/api/v1/benefits/claims/\${id}\`);
+  }
+
+  async createBenefitClaim(data: BenefitClaimInput): Promise<BenefitClaim> {
+    return this.request('POST', '/api/v1/benefits/claims', { body: data });
+  }
+
+  async approveBenefitClaim(id: string, notes?: string): Promise<BenefitClaim> {
+    return this.request('POST', \`/api/v1/benefits/claims/\${id}/approve\`, { body: { notes } });
+  }
+
+  async rejectBenefitClaim(id: string, reason: string): Promise<BenefitClaim> {
+    return this.request('POST', \`/api/v1/benefits/claims/\${id}/reject\`, { body: { reason } });
+  }
+
+  async listCommissionPayouts(params?: {
+    memberId?: string;
+    status?: 'pending' | 'processing' | 'completed' | 'failed';
+    limit?: number;
+  }): Promise<PaginatedResponse<CommissionPayout>> {
+    return this.request('GET', '/api/v1/benefits/commissions', { params });
+  }
+
+  // ============ Projects ============
+
+  async listProjects(params?: {
+    status?: 'active' | 'completed' | 'archived';
+    limit?: number;
+  }): Promise<PaginatedResponse<{ id: string; name: string; status: string }>> {
+    return this.request('GET', '/api/v1/projects', { params });
+  }
+
+  async getProject(id: string): Promise<{ id: string; name: string; status: string; tasks: unknown[] }> {
+    return this.request('GET', \`/api/v1/projects/\${id}\`);
+  }
+
+  // ============ Internal Request Handler ============
+
+  private async request<T>(
+    method: string,
+    path: string,
+    options?: {
+      params?: Record<string, unknown>;
+      body?: unknown;
+    }
+  ): Promise<T> {
+    const url = new URL(path, this.baseUrl);
+
+    if (options?.params) {
+      Object.entries(options.params).forEach(([key, value]) => {
+        if (value !== undefined && value !== null) {
+          if (Array.isArray(value)) {
+            value.forEach(v => url.searchParams.append(key, String(v)));
+          } else {
+            url.searchParams.set(key, String(value));
+          }
+        }
+      });
+    }
+
+    const response = await fetch(url.toString(), {
+      method,
+      headers: {
+        'Authorization': \`Bearer \${this.apiKey}\`,
+        'Content-Type': 'application/json',
+        'X-Organization-Id': this.organizationId,
+      },
+      body: options?.body ? JSON.stringify(options.body) : undefined,
+    });
+
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new L4yercak3Error(
+        response.status,
+        error.message || \`Request failed: \${response.status}\`,
+        error.code,
+        error
+      );
+    }
+
+    // Handle 204 No Content
+    if (response.status === 204) {
+      return undefined as T;
+    }
+
+    return response.json();
+  }
+}
+
+export class L4yercak3Error extends Error {
+  constructor(
+    public status: number,
+    message: string,
+    public code?: string,
+    public details?: unknown
+  ) {
+    super(message);
+    this.name = 'L4yercak3Error';
+  }
+}
+
+// Singleton instance
+let client: L4yercak3Client | null = null;
+
+export function getL4yercak3Client(): L4yercak3Client {
+  if (!client) {
+    const apiKey = process.env.L4YERCAK3_API_KEY;
+    if (!apiKey) {
+      throw new Error('L4YERCAK3_API_KEY environment variable is required');
+    }
+    client = new L4yercak3Client({ apiKey });
+  }
+  return client;
+}
+`;
+  }
+
+  generateJavaScriptClient({ organizationId, backendUrl }) {
+    return `/**
+ * L4YERCAK3 API Client
+ * Auto-generated by @l4yercak3/cli
+ *
+ * A typed API client for the L4YERCAK3 platform.
+ * Organization ID: ${organizationId}
+ */
+
+class L4yercak3Client {
+  /**
+   * @param {Object} config
+   * @param {string} config.apiKey
+   * @param {string} [config.baseUrl]
+   * @param {string} [config.organizationId]
+   */
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl || '${backendUrl}';
+    this.organizationId = config.organizationId || '${organizationId}';
+  }
+
+  // ============ CRM: Contacts ============
+
+  /** @returns {Promise<{items: Array, total: number, hasMore: boolean}>} */
+  async listContacts(params) {
+    return this.request('GET', '/api/v1/crm/contacts', { params });
+  }
+
+  async getContact(id, options) {
+    return this.request('GET', \`/api/v1/crm/contacts/\${id}\`, { params: options });
+  }
+
+  async createContact(data) {
+    return this.request('POST', '/api/v1/crm/contacts', { body: data });
+  }
+
+  async updateContact(id, data) {
+    return this.request('PATCH', \`/api/v1/crm/contacts/\${id}\`, { body: data });
+  }
+
+  async deleteContact(id) {
+    return this.request('DELETE', \`/api/v1/crm/contacts/\${id}\`);
+  }
+
+  // ============ CRM: Organizations ============
+
+  async listOrganizations(params) {
+    return this.request('GET', '/api/v1/crm/organizations', { params });
+  }
+
+  async getOrganization(id, options) {
+    return this.request('GET', \`/api/v1/crm/organizations/\${id}\`, { params: options });
+  }
+
+  async createOrganization(data) {
+    return this.request('POST', '/api/v1/crm/organizations', { body: data });
+  }
+
+  // ============ Events ============
+
+  async listEvents(params) {
+    return this.request('GET', '/api/v1/events', { params });
+  }
+
+  async getEvent(id, options) {
+    return this.request('GET', \`/api/v1/events/\${id}\`, { params: options });
+  }
+
+  async createEvent(data) {
+    return this.request('POST', '/api/v1/events', { body: data });
+  }
+
+  async getEventAttendees(eventId, params) {
+    return this.request('GET', \`/api/v1/events/\${eventId}/attendees\`, { params });
+  }
+
+  async checkInAttendee(eventId, attendeeId) {
+    return this.request('POST', \`/api/v1/events/\${eventId}/attendees/\${attendeeId}/check-in\`);
+  }
+
+  // ============ Forms ============
+
+  async listForms(params) {
+    return this.request('GET', '/api/v1/forms', { params });
+  }
+
+  async getForm(id) {
+    return this.request('GET', \`/api/v1/forms/\${id}\`);
+  }
+
+  async submitForm(formId, data) {
+    return this.request('POST', \`/api/v1/forms/\${formId}/submit\`, { body: data });
+  }
+
+  async getFormResponses(formId, params) {
+    return this.request('GET', \`/api/v1/forms/\${formId}/responses\`, { params });
+  }
+
+  // ============ Products ============
+
+  async listProducts(params) {
+    return this.request('GET', '/api/v1/products', { params });
+  }
+
+  async getProduct(id) {
+    return this.request('GET', \`/api/v1/products/\${id}\`);
+  }
+
+  // ============ Checkout ============
+
+  async createCheckoutSession(data) {
+    return this.request('POST', '/api/v1/checkout/sessions', { body: data });
+  }
+
+  async getCheckoutSession(sessionId) {
+    return this.request('GET', \`/api/v1/checkout/sessions/\${sessionId}\`);
+  }
+
+  // ============ Orders ============
+
+  async listOrders(params) {
+    return this.request('GET', '/api/v1/orders', { params });
+  }
+
+  async getOrder(id) {
+    return this.request('GET', \`/api/v1/orders/\${id}\`);
+  }
+
+  // ============ Invoicing ============
+
+  async listInvoices(params) {
+    return this.request('GET', '/api/v1/invoices', { params });
+  }
+
+  async getInvoice(id) {
+    return this.request('GET', \`/api/v1/invoices/\${id}\`);
+  }
+
+  async createInvoice(data) {
+    return this.request('POST', '/api/v1/invoices', { body: data });
+  }
+
+  async sendInvoice(id, options) {
+    return this.request('POST', \`/api/v1/invoices/\${id}/send\`, { body: options });
+  }
+
+  async markInvoicePaid(id, data) {
+    return this.request('POST', \`/api/v1/invoices/\${id}/mark-paid\`, { body: data });
+  }
+
+  // ============ Benefits ============
+
+  async listBenefitClaims(params) {
+    return this.request('GET', '/api/v1/benefits/claims', { params });
+  }
+
+  async createBenefitClaim(data) {
+    return this.request('POST', '/api/v1/benefits/claims', { body: data });
+  }
+
+  async approveBenefitClaim(id, notes) {
+    return this.request('POST', \`/api/v1/benefits/claims/\${id}/approve\`, { body: { notes } });
+  }
+
+  async rejectBenefitClaim(id, reason) {
+    return this.request('POST', \`/api/v1/benefits/claims/\${id}/reject\`, { body: { reason } });
+  }
+
+  // ============ Projects ============
+
+  async listProjects(params) {
+    return this.request('GET', '/api/v1/projects', { params });
+  }
+
+  async getProject(id) {
+    return this.request('GET', \`/api/v1/projects/\${id}\`);
+  }
+
+  // ============ Internal Request Handler ============
+
+  async request(method, path, options = {}) {
+    const url = new URL(path, this.baseUrl);
+
+    if (options.params) {
+      Object.entries(options.params).forEach(([key, value]) => {
+        if (value !== undefined && value !== null) {
+          if (Array.isArray(value)) {
+            value.forEach(v => url.searchParams.append(key, String(v)));
+          } else {
+            url.searchParams.set(key, String(value));
+          }
+        }
+      });
+    }
+
+    const response = await fetch(url.toString(), {
+      method,
+      headers: {
+        'Authorization': \`Bearer \${this.apiKey}\`,
+        'Content-Type': 'application/json',
+        'X-Organization-Id': this.organizationId,
+      },
+      body: options.body ? JSON.stringify(options.body) : undefined,
+    });
+
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new L4yercak3Error(
+        response.status,
+        error.message || \`Request failed: \${response.status}\`,
+        error.code,
+        error
+      );
+    }
+
+    if (response.status === 204) {
+      return undefined;
+    }
+
+    return response.json();
+  }
+}
+
+class L4yercak3Error extends Error {
+  constructor(status, message, code, details) {
+    super(message);
+    this.name = 'L4yercak3Error';
+    this.status = status;
+    this.code = code;
+    this.details = details;
+  }
+}
+
+// Singleton instance
+let client = null;
+
+function getL4yercak3Client() {
+  if (!client) {
+    const apiKey = process.env.L4YERCAK3_API_KEY;
+    if (!apiKey) {
+      throw new Error('L4YERCAK3_API_KEY environment variable is required');
+    }
+    client = new L4yercak3Client({ apiKey });
+  }
+  return client;
+}
+
+module.exports = {
+  L4yercak3Client,
+  L4yercak3Error,
+  getL4yercak3Client,
+};
+`;
+  }
+}
+
+module.exports = new ClientGenerator();