@marvalt/madapter 1.0.14

package/LICENSE

@@ -0,0 +1,28 @@
+GPL-3.0-or-later
+
+Copyright (c) 2025 Vibune Pty Ltd.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see https://www.gnu.org/licenses/.
+
+
+
+
+
+
+
+
+
+
+
+

package/README.md

@@ -0,0 +1,422 @@
+# madapter
+
+A MarVAlt adapter for Mautic marketing automation in React, with static data generation support.
+
+## Features
+
+- 🚀 **Mautic API Client** - Full-featured client for Mautic API operations
+- 📝 **Dynamic Form Rendering** - Render Mautic forms dynamically in React
+- 📊 **Static Data Generation** - Generate static JSON files for build-time data
+- 🎯 **Event Tracking** - Mautic tracking script integration with proxy support
+- 🔧 **React Hooks** - Comprehensive React Query hooks for all Mautic operations
+- 🛡️ **TypeScript Support** - Full TypeScript support with comprehensive type definitions
+- 🔐 **Authentication Modes** - Support for Cloudflare Worker proxy and direct API access
+- ✅ **Form Validation** - Client-side validation with customizable rules
+- 🎨 **Customizable Components** - Flexible and customizable React components
+
+## Installation
+
+```bash
+npm install @marvalt/madapter
+```
+
+### Peer Dependencies
+
+```bash
+npm install @tanstack/react-query react react-dom
+```
+
+## Quick Start
+
+### 1. Environment Configuration
+
+Use the same auth mode variable used by all integrations: `VITE_AUTH_MODE`.
+
+Create `.env` (non‑secret):
+```bash
+# Global auth mode used across integrations
+VITE_AUTH_MODE=cloudflare_proxy # or direct (dev only)
+
+# Mautic via Cloudflare Worker proxy
+VITE_MAUTIC_PROXY_URL=https://your-mautic-proxy.workers.dev
+
+# Frontend app identity used by the Worker for auth headers
+VITE_FRONTEND_ID=your-app-id
+VITE_FRONTEND_SECRET=your-worker-secret
+
+# Mautic OAuth client credentials (typically configured on the Worker)
+# Add here only if your tooling expects them documented in the app env.
+VITE_MAUTIC_API_PUBLIC_KEY=your-mautic-api-public-key
+```
+
+Create `.env.local` (secrets for local dev only):
+```bash
+# Secret OAuth key (usually a Worker secret, optional in app env)
+VITE_MAUTIC_API_SECRET_KEY=your-mautic-api-secret-key
+```
+
+Notes:
+- In proxy mode, the Worker reads `MAUTIC_API_PUBLIC_KEY` and `MAUTIC_API_SECRET_KEY` from its own environment.
+- The frontend sends `x-app-id` and `x-worker-secret` headers; the client sets these automatically.
+
+### 2. React Query Setup
+
+```tsx
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+
+const queryClient = new QueryClient();
+
+function App() {
+  return (
+    <QueryClientProvider client={queryClient}>
+      {/* Your app components */}
+    </QueryClientProvider>
+  );
+}
+```
+
+The client auto‑configures from `import.meta.env`/`process.env`. If you prefer explicit configuration, wrap your app with the provider exported by the package and pass the config fields shown above.
+
+### 3. Form Rendering (recommended)
+
+```tsx
+import { MauticForm } from '@marvalt/madapter';
+
+function ContactPage() {
+  return (
+    <div>
+      <h1>Contact Us</h1>
+      <MauticForm
+        formId="1"
+        title="Get in Touch"
+        description="Send us a message and we'll get back to you soon."
+        onSuccess={(data) => console.log('Form submitted:', data)}
+        onError={(error) => console.error('Form error:', error)}
+      />
+    </div>
+  );
+}
+```
+
+### 4. Event Tracking
+
+```tsx
+import { MauticTracking } from '@marvalt/madapter';
+
+function App() {
+  return (
+    <MauticTracking
+      enabled={true}
+      proxyUrl={process.env.VITE_MAUTIC_PROXY_URL}
+      appId={process.env.VITE_FRONTEND_ID}
+      workerSecret={process.env.VITE_FRONTEND_SECRET}
+    >
+      {/* Your app content */}
+    </MauticTracking>
+  );
+}
+```
+
+## Static Data Generation
+
+### 1. Create Generation Script
+
+```typescript
+// scripts/generateMauticData.ts
+import { generateMauticData } from '@marvalt/madapter';
+
+async function generateData() {
+  try {
+    const staticData = await generateMauticData({
+      authMode: 'cloudflare_proxy',
+      cloudflareWorkerUrl: process.env.VITE_MAUTIC_PROXY_URL,
+      appId: process.env.VITE_FRONTEND_ID,
+      workerSecret: process.env.VITE_FRONTEND_SECRET,
+      outputPath: './src/data/mautic-data.json',
+      includeInactive: false,
+    });
+
+    console.log(`Generated data for ${staticData.total_forms} forms`);
+  } catch (error) {
+    console.error('Error generating Mautic data:', error);
+    process.exit(1);
+  }
+}
+
+generateData();
+```
+
+### 2. Update package.json
+
+```json
+{
+  "scripts": {
+    "generate:mautic-data": "tsx scripts/generateMauticData.ts",
+    "build": "npm run generate:mautic-data && vite build"
+  }
+}
+```
+
+## React Hooks
+
+### Form Submission
+
+```tsx
+import { useMauticFormSubmission } from '@marvalt/madapter';
+
+function CustomForm() {
+  const submitMutation = useMauticFormSubmission();
+
+  const handleSubmit = async (formData) => {
+    try {
+      await submitMutation.mutateAsync({
+        formId: 1,
+        fields: formData,
+        returnUrl: window.location.href,
+      });
+      console.log('Form submitted successfully!');
+    } catch (error) {
+      console.error('Form submission failed:', error);
+    }
+  };
+
+  return (
+    <form onSubmit={handleSubmit}>
+      {/* Your form fields */}
+    </form>
+  );
+}
+```
+
+### Contact Management
+
+```tsx
+import { useMauticCreateContact, useMauticContactByEmail } from '@marvalt/madapter';
+
+function ContactManager() {
+  const createMutation = useMauticCreateContact();
+  const { data: contact } = useMauticContactByEmail('user@example.com');
+
+  const handleCreateContact = async (contactData) => {
+    await createMutation.mutateAsync({
+      email: contactData.email,
+      firstname: contactData.firstName,
+      lastname: contactData.lastName,
+    });
+  };
+
+  return (
+    <div>
+      {contact && <p>Contact found: {contact.data?.firstname}</p>}
+      {/* Your contact management UI */}
+    </div>
+  );
+}
+```
+
+### Event Tracking
+
+```tsx
+import { useMauticEventTracking } from '@marvalt/madapter';
+
+function ProductPage() {
+  const trackEvent = useMauticEventTracking();
+
+  const handleProductView = () => {
+    trackEvent.mutate({
+      email: 'user@example.com',
+      eventName: 'product_view',
+      eventData: { productId: '123', category: 'electronics' },
+    });
+  };
+
+  return (
+    <div>
+      <button onClick={handleProductView}>Track Product View</button>
+    </div>
+  );
+}
+```
+
+## API Reference
+
+### MauticClient
+
+```typescript
+import { MauticClient } from '@marvalt/madapter';
+
+const client = new MauticClient({
+  authMode: 'cloudflare_proxy',
+  cloudflareWorkerUrl: 'https://proxy.workers.dev',
+  appId: 'your-app-id',
+  workerSecret: 'your-secret',
+});
+
+// Form operations
+await client.submitForm(1, { formId: 1, fields: { email: 'test@example.com' } });
+await client.getForms();
+await client.getForm(1);
+
+// Contact operations
+await client.createContact({ email: 'test@example.com', firstname: 'Test' });
+await client.updateContact(1, { firstname: 'Updated' });
+await client.getContactByEmail('test@example.com');
+
+// Event tracking
+await client.trackEvent('page_view', { page: '/home' });
+
+// Tag management
+await client.addTagToContact(1, ['newsletter', 'premium']);
+await client.removeTagFromContact(1, ['newsletter']);
+```
+
+### Configuration
+
+```typescript
+interface MauticConfig {
+  authMode: 'cloudflare_proxy' | 'direct';
+  apiUrl?: string;                    // Required for direct mode
+  cloudflareWorkerUrl?: string;       // Required for proxy mode
+  appId?: string;                     // Required for proxy mode
+  workerSecret?: string;              // Required for proxy mode
+  timeout?: number;                   // Default: 30000ms
+  retries?: number;                   // Default: 3
+}
+```
+
+## Authentication Modes
+
+### Cloudflare Worker Proxy (Recommended)
+
+```typescript
+const config = {
+  authMode: 'cloudflare_proxy',
+  cloudflareWorkerUrl: 'https://your-proxy.workers.dev',
+  appId: 'your-frontend-id',
+  workerSecret: 'your-worker-secret',
+};
+```
+
+### Direct API Access (Legacy)
+
+```typescript
+const config = {
+  authMode: 'direct',
+  apiUrl: 'https://your-mautic-instance.com',
+};
+```
+
+## Form Field Types
+
+The package supports all standard Mautic field types:
+
+- `text` - Text input
+- `email` - Email input with validation
+- `tel` - Phone number input
+- `url` - URL input
+- `textarea` - Multi-line text input
+- `select` - Dropdown selection
+- `checkbox` - Single checkbox
+- `radio` - Radio button group
+
+## Customization
+
+### Custom Form Styling
+
+```tsx
+<MauticForm
+  formId="1"
+  className="custom-form"
+  // Custom CSS classes will be applied to form elements
+/>
+```
+
+### Custom Validation
+
+```typescript
+import { validateField } from '@marvalt/madapter';
+
+const customValidation = (field, value) => {
+  const baseError = validateField(field, value);
+  if (baseError) return baseError;
+  
+  // Add custom validation logic
+  if (field.alias === 'custom_field' && value.length < 5) {
+    return 'Custom field must be at least 5 characters';
+  }
+  
+  return null;
+};
+```
+
+## Error Handling & Common Pitfalls
+
+```tsx
+import { MauticForm } from '@marvalt/madapter';
+
+function FormWithErrorHandling() {
+  const handleError = (error) => {
+    console.error('Form submission error:', error);
+    // Custom error handling logic
+  };
+
+  return (
+    <MauticForm
+      formId="1"
+      onError={handleError}
+      onSuccess={(data) => console.log('Success:', data)}
+    />
+  );
+}
+```
+
+Tips to avoid errors:
+
+- 404/HTML after submit: Some Mautic setups return an HTML page (even 404) after a successful submit. The client treats this as success. If you implement custom submission, do not rely on server redirects; handle redirects client‑side using the form’s configured `postAction`.
+- Redirects: Prefer client‑side redirects. The client sets `mauticform[return]` to an empty string and performs the redirect on the frontend.
+- Dev tracking: Tracking is disabled in `VITE_DEV`/development builds by design; don’t expect `mtc.js` to load locally.
+- Proxy headers: In proxy mode the client sends `x-app-id` and `x-worker-secret` automatically. Ensure `VITE_FRONTEND_ID` and `VITE_FRONTEND_SECRET` are set.
+- Forms data: If you reference a form ID that doesn’t exist in your Mautic instance, you’ll receive a 404 from the API. Use the static data generator or fetch `/forms` via the Worker to confirm IDs.
+
+## Development
+
+### Building the Package
+
+```bash
+npm run build
+```
+
+### Running Tests
+
+```bash
+npm test
+npm run test:watch
+npm run test:coverage
+```
+
+### Linting
+
+```bash
+npm run lint
+npm run lint:fix
+```
+
+## License
+
+GPL-3.0-or-later. See LICENSE.
+
+## Support
+
+For support and questions, please contact:
+- Email: support@vibune.com
+- Documentation: [GitHub Repository](https://github.com/MarVAlt/madapter)
+
+## Changelog
+
+### 1.0.0
+- Initial release
+- Mautic API client
+- React components and hooks
+- Static data generation
+- Event tracking
+- TypeScript support

package/dist/client/mautic-client.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @license GPL-3.0-or-later
+ *
+ * This file is part of the MarVAlt Open SDK.
+ * Copyright (c) 2025 Vibune Pty Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU General Public License for more details.
+ */
+import { MauticConfig } from '../types/config';
+import { MauticContact, MauticFormSubmission, MauticForm, MauticApiResponse } from '../types/mautic';
+export declare class MauticClient {
+    private baseUrl;
+    private proxyUrl?;
+    private appId?;
+    private workerSecret?;
+    private useProxy;
+    private isConfigured;
+    private config;
+    constructor(config: MauticConfig);
+    private validateConfiguration;
+    private getAuthHeaders;
+    private makeRequest;
+    /**
+     * Submit a form to Mautic
+     */
+    submitForm(formId: number, submission: MauticFormSubmission): Promise<MauticApiResponse>;
+    /**
+     * Create a new contact in Mautic
+     */
+    createContact(contact: MauticContact): Promise<MauticApiResponse>;
+    /**
+     * Update an existing contact in Mautic
+     */
+    updateContact(contactId: number, contact: Partial<MauticContact>): Promise<MauticApiResponse>;
+    /**
+     * Get a contact by email
+     */
+    getContactByEmail(email: string): Promise<MauticApiResponse>;
+    /**
+     * Get all forms from Mautic
+     */
+    getForms(): Promise<MauticForm[]>;
+    /**
+     * Get a specific form by ID
+     */
+    getForm(formId: number): Promise<MauticForm>;
+    /**
+     * Track an event in Mautic
+     */
+    trackEvent(eventName: string, eventData?: Record<string, any>): Promise<MauticApiResponse>;
+    /**
+     * Add tags to a contact
+     */
+    addTagToContact(contactId: number, tags: string[]): Promise<MauticApiResponse>;
+    /**
+     * Remove tags from a contact
+     */
+    removeTagFromContact(contactId: number, tags: string[]): Promise<MauticApiResponse>;
+    /**
+     * Get contact tags
+     */
+    getContactTags(contactId: number): Promise<MauticApiResponse>;
+    /**
+     * Get all tags
+     */
+    getTags(): Promise<MauticApiResponse>;
+    /**
+     * Get segments
+     */
+    getSegments(): Promise<MauticApiResponse>;
+    /**
+     * Add contact to segment
+     */
+    addContactToSegment(contactId: number, segmentId: number): Promise<MauticApiResponse>;
+    /**
+     * Remove contact from segment
+     */
+    removeContactFromSegment(contactId: number, segmentId: number): Promise<MauticApiResponse>;
+}
+//# sourceMappingURL=mautic-client.d.ts.map

package/dist/client/mautic-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mautic-client.d.ts","sourceRoot":"","sources":["../../src/client/mautic-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAY,MAAM,iBAAiB,CAAC;AACzD,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,UAAU,EAGV,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY;IAsBhC,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,cAAc;YAWR,WAAW;IA6EzB;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkC9F;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOvE;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOnG;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIlE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAKvC;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIlD;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAUpG;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOpF;;OAEG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOzF;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAInE;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAI3C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAI/C;;OAEG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAO3F;;OAEG;IACG,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAMjG"}

package/dist/data/mautic-data-store.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @license GPL-3.0-or-later
+ *
+ * This file is part of the MarVAlt Open SDK.
+ * Copyright (c) 2025 Vibune Pty Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU General Public License for more details.
+ */
+import { MauticForm, MauticFormField } from '../types/mautic';
+export interface MauticDataStore {
+    generated_at: string;
+    forms: MauticForm[];
+}
+/**
+ * Load Mautic data from JSON file
+ */
+export declare const loadMauticData: () => Promise<MauticDataStore>;
+/**
+ * Get the current Mautic data store
+ */
+export declare const getMauticData: () => MauticDataStore;
+/**
+ * Get all published forms
+ */
+export declare const getPublishedForms: () => MauticForm[];
+/**
+ * Get form by ID
+ */
+export declare const getFormById: (id: number) => MauticForm | undefined;
+/**
+ * Get form by alias
+ */
+export declare const getFormByAlias: (alias: string) => MauticForm | undefined;
+/**
+ * Get forms by type
+ */
+export declare const getFormsByType: (type: string) => MauticForm[];
+/**
+ * Get forms by field type
+ */
+export declare const getFormsByFieldType: (fieldType: string) => MauticForm[];
+/**
+ * Search forms by name or description
+ */
+export declare const searchForms: (query: string) => MauticForm[];
+/**
+ * Get form field by alias
+ */
+export declare const getFormFieldByAlias: (formId: number, fieldAlias: string) => MauticFormField | undefined;
+/**
+ * Get all unique field types across all forms
+ */
+export declare const getAllFieldTypes: () => string[];
+/**
+ * Get forms count by status
+ */
+export declare const getFormsCountByStatus: () => {
+    total: number;
+    published: number;
+    unpublished: number;
+};
+/**
+ * Check if data store is loaded
+ */
+export declare const isDataLoaded: () => boolean;
+/**
+ * Get data store metadata
+ */
+export declare const getDataMetadata: () => {
+    generated_at: string;
+    total_forms: number;
+    published_forms: number;
+    field_types: string[];
+    form_types: (string | undefined)[];
+};
+//# sourceMappingURL=mautic-data-store.d.ts.map

package/dist/data/mautic-data-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mautic-data-store.d.ts","sourceRoot":"","sources":["../../src/data/mautic-data-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAG9D,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAWD;;GAEG;AACH,eAAO,MAAM,cAAc,QAAa,OAAO,CAAC,eAAe,CAoD9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,QAAO,eAEhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,UAAU,EAE9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,KAAG,UAAU,GAAG,SAErD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,UAAU,GAAG,SAE3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,UAAU,EAEvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAM,KAAG,UAAU,EAIjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,UAAU,EAMrD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,MAAM,EAAE,YAAY,MAAM,KAAG,eAAe,GAAG,SAG1F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAO,MAAM,EAQzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;CAUjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,QAAO,OAE/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;CAQ3B,CAAC"}

package/dist/generators/mautic-generator.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @license GPL-3.0-or-later
+ *
+ * This file is part of the MarVAlt Open SDK.
+ * Copyright (c) 2025 Vibune Pty Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU General Public License for more details.
+ */
+import { MauticGeneratorConfig } from '../types/config';
+import { MauticStaticData } from '../types/static-data';
+export declare class MauticGenerator {
+    private client;
+    private config;
+    constructor(config: MauticGeneratorConfig);
+    /**
+     * Generate static data for Mautic forms
+     */
+    generateStaticData(): Promise<MauticStaticData>;
+    /**
+     * Write static data to file
+     */
+    writeStaticData(staticData: MauticStaticData): Promise<void>;
+    /**
+     * Generate and write static data
+     */
+    generateAndWrite(): Promise<MauticStaticData>;
+    /**
+     * Fetch list of forms from Mautic
+     */
+    private fetchMauticFormsList;
+    /**
+     * Fetch individual form details from Mautic
+     */
+    private fetchMauticForm;
+}
+/**
+ * Generate Mautic static data with configuration
+ */
+export declare function generateMauticData(config: MauticGeneratorConfig): Promise<MauticStaticData>;
+//# sourceMappingURL=mautic-generator.d.ts.map

package/dist/generators/mautic-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mautic-generator.d.ts","sourceRoot":"","sources":["../../src/generators/mautic-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAkB,MAAM,sBAAsB,CAAC;AAGxE,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,EAAE,qBAAqB;IAazC;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA2GrD;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAclE;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAMnD;;OAEG;YACW,oBAAoB;IA2BlC;;OAEG;YACW,eAAe;CAwB9B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGjG"}