@djangocfg/ext-newsletter 1.0.0

package/dist/index.js

@@ -0,0 +1 @@
+export { API, APIClient, APIError, APILogger, BulkEmailRequestSchema, BulkEmailResponseSchema, CookieStorageAdapter, DEFAULT_RETRY_CONFIG, EmailLogSchema, enums_exports as Enums, ErrorResponseSchema, models_exports as ExtNewsletterBulkEmailTypes, models_exports2 as ExtNewsletterCampaignsTypes, models_exports3 as ExtNewsletterLogsTypes, models_exports7 as ExtNewsletterNewsletterTypes, models_exports4 as ExtNewsletterNewslettersTypes, models_exports5 as ExtNewsletterSubscriptionsTypes, models_exports6 as ExtNewsletterTestingTypes, FetchAdapter, fetchers_exports as Fetchers, LocalStorageAdapter, MemoryStorageAdapter, NetworkError, NewsletterCampaignRequestSchema, NewsletterCampaignSchema, NewsletterSchema, NewsletterSubscriptionSchema, PaginatedEmailLogListSchema, PaginatedNewsletterCampaignListSchema, PaginatedNewsletterListSchema, PaginatedNewsletterSubscriptionListSchema, PatchedNewsletterCampaignRequestSchema, PatchedUnsubscribeRequestSchema, REFRESH_TOKEN_KEY, schemas_exports as Schemas, SendCampaignRequestSchema, SendCampaignResponseSchema, SubscribeRequestSchema, SubscribeResponseSchema, SuccessResponseSchema, TOKEN_KEY, TestEmailRequestSchema, UnsubscribeRequestSchema, UnsubscribeSchema, apiNewsletter, clearAPITokens, configureAPI, createNewsletterBulkCreate, createNewsletterCampaignsCreate, createNewsletterCampaignsSendCreate, createNewsletterSubscribeCreate, createNewsletterTestCreate, createNewsletterUnsubscribeCreate, deleteNewsletterCampaignsDestroy, dispatchValidationError, formatZodError, getAPIInstance, getNewsletterCampaignsList, getNewsletterCampaignsRetrieve, getNewsletterLogsList, getNewsletterNewslettersList, getNewsletterNewslettersRetrieve, getNewsletterSubscriptionsList, isAPIConfigured, onValidationError, partialUpdateNewsletterCampaignsPartialUpdate, partialUpdateNewsletterUnsubscribePartialUpdate, reconfigureAPI, resetAPI, shouldRetry, updateNewsletterCampaignsUpdate, updateNewsletterUnsubscribeUpdate, withRetry } from './chunk-LQLPNWHR.js';

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@djangocfg/ext-newsletter",
+  "version": "1.0.0",
+  "description": "Newsletter and subscription management extension for DjangoCFG",
+  "keywords": [
+    "django",
+    "djangocfg",
+    "extension",
+    "newsletter",
+    "subscription",
+    "email",
+    "marketing",
+    "typescript",
+    "react"
+  ],
+  "author": {
+    "name": "DjangoCFG",
+    "url": "https://djangocfg.com"
+  },
+  "homepage": "https://djangocfg.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/markolofsen/django-cfg.git",
+    "directory": "extensions/newsletter"
+  },
+  "bugs": {
+    "url": "https://github.com/markolofsen/django-cfg/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./hooks": {
+      "types": "./dist/hooks.d.ts",
+      "import": "./dist/hooks.mjs",
+      "require": "./dist/hooks.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "check": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@djangocfg/api": "^2.1.14",
+    "@djangocfg/ext-base": "^1.0.0",
+    "@djangocfg/ui-nextjs": "^2.1.14",
+    "consola": "^3.4.2",
+    "lucide-react": "^0.545.0",
+    "next": "^15.5.7",
+    "p-retry": "^7.0.0",
+    "react": "^18 || ^19",
+    "react-dom": "^18 || ^19",
+    "swr": "^2.3.7",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@djangocfg/api": "^2.1.14",
+    "@djangocfg/ext-base": "^1.0.0",
+    "@djangocfg/typescript-config": "^2.1.14",
+    "@types/node": "^24.7.2",
+    "@types/react": "^19.0.0",
+    "consola": "^3.4.2",
+    "p-retry": "^7.0.0",
+    "swr": "^2.3.7",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3"
+  }
+}

package/src/api/generated/ext_newsletter/_utils/fetchers/ext_newsletter__newsletter.ts

@@ -0,0 +1,210 @@
+/**
+ * Typed fetchers for Newsletter
+ *
+ * Universal functions that work in any environment:
+ * - Next.js (App Router / Pages Router / Server Components)
+ * - React Native
+ * - Node.js backend
+ *
+ * These fetchers use Zod schemas for runtime validation.
+ *
+ * Usage:
+ * ```typescript
+ * // Configure API once (in your app entry point)
+ * import { configureAPI } from '../../api-instance'
+ * configureAPI({ baseUrl: 'https://api.example.com' })
+ *
+ * // Then use fetchers anywhere
+ * const users = await getUsers({ page: 1 })
+ *
+ * // With SWR
+ * const { data } = useSWR(['users', params], () => getUsers(params))
+ *
+ * // With React Query
+ * const { data } = useQuery(['users', params], () => getUsers(params))
+ *
+ * // In Server Component or SSR (pass custom client)
+ * import { API } from '../../index'
+ * const api = new API('https://api.example.com')
+ * const users = await getUsers({ page: 1 }, api)
+ * ```
+ */
+import { consola } from 'consola'
+import { NewsletterCampaignSchema, type NewsletterCampaign } from '../schemas/NewsletterCampaign.schema'
+import { PatchedNewsletterCampaignRequestSchema, type PatchedNewsletterCampaignRequest } from '../schemas/PatchedNewsletterCampaignRequest.schema'
+import { PatchedUnsubscribeRequestSchema, type PatchedUnsubscribeRequest } from '../schemas/PatchedUnsubscribeRequest.schema'
+import { UnsubscribeSchema, type Unsubscribe } from '../schemas/Unsubscribe.schema'
+import { UnsubscribeRequestSchema, type UnsubscribeRequest } from '../schemas/UnsubscribeRequest.schema'
+import { getAPIInstance } from '../../api-instance'
+
+/**
+ * API operation
+ *
+ * @method PATCH
+ * @path /cfg/newsletter/campaigns/{id}/
+ */
+export async function partialUpdateNewsletterCampaignsPartialUpdate(  id: number, data?: PatchedNewsletterCampaignRequest,  client?: any
+): Promise<NewsletterCampaign> {
+  const api = client || getAPIInstance()
+  const response = await api.ext_newsletter_newsletter.campaignsPartialUpdate(id, data)
+  try {
+    return NewsletterCampaignSchema.parse(response)
+  } catch (error) {
+    // Zod validation error - log detailed information
+    consola.error('❌ Zod Validation Failed');
+    consola.box(`partialUpdateNewsletterCampaignsPartialUpdate\nPath: /cfg/newsletter/campaigns/{id}/\nMethod: PATCH`);
+
+    if (error instanceof Error && 'issues' in error && Array.isArray((error as any).issues)) {
+      consola.error('Validation Issues:');
+      (error as any).issues.forEach((issue: any, index: number) => {
+        consola.error(`  ${index + 1}. ${issue.path.join('.') || 'root'}`);
+        consola.error(`     ├─ Message: ${issue.message}`);
+        if (issue.expected) consola.error(`     ├─ Expected: ${issue.expected}`);
+        if (issue.received) consola.error(`     └─ Received: ${issue.received}`);
+      });
+    }
+
+    consola.error('Response data:', response);
+
+    // Dispatch browser CustomEvent (only if window is defined)
+    if (typeof window !== 'undefined' && error instanceof Error && 'issues' in error) {
+      try {
+        const event = new CustomEvent('zod-validation-error', {
+          detail: {
+            operation: 'partialUpdateNewsletterCampaignsPartialUpdate',
+            path: '/cfg/newsletter/campaigns/{id}/',
+            method: 'PATCH',
+            error: error,
+            response: response,
+            timestamp: new Date(),
+          },
+          bubbles: true,
+          cancelable: false,
+        });
+        window.dispatchEvent(event);
+      } catch (eventError) {
+        // Silently fail - event dispatch should never crash the app
+        consola.warn('Failed to dispatch validation error event:', eventError);
+      }
+    }
+
+    // Re-throw the error
+    throw error;
+  }
+}
+
+
+/**
+ * API operation
+ *
+ * @method PUT
+ * @path /cfg/newsletter/unsubscribe/
+ */
+export async function updateNewsletterUnsubscribeUpdate(  data: UnsubscribeRequest,  client?: any
+): Promise<Unsubscribe> {
+  const api = client || getAPIInstance()
+  const response = await api.ext_newsletter_newsletter.unsubscribeUpdate(data)
+  try {
+    return UnsubscribeSchema.parse(response)
+  } catch (error) {
+    // Zod validation error - log detailed information
+    consola.error('❌ Zod Validation Failed');
+    consola.box(`updateNewsletterUnsubscribeUpdate\nPath: /cfg/newsletter/unsubscribe/\nMethod: PUT`);
+
+    if (error instanceof Error && 'issues' in error && Array.isArray((error as any).issues)) {
+      consola.error('Validation Issues:');
+      (error as any).issues.forEach((issue: any, index: number) => {
+        consola.error(`  ${index + 1}. ${issue.path.join('.') || 'root'}`);
+        consola.error(`     ├─ Message: ${issue.message}`);
+        if (issue.expected) consola.error(`     ├─ Expected: ${issue.expected}`);
+        if (issue.received) consola.error(`     └─ Received: ${issue.received}`);
+      });
+    }
+
+    consola.error('Response data:', response);
+
+    // Dispatch browser CustomEvent (only if window is defined)
+    if (typeof window !== 'undefined' && error instanceof Error && 'issues' in error) {
+      try {
+        const event = new CustomEvent('zod-validation-error', {
+          detail: {
+            operation: 'updateNewsletterUnsubscribeUpdate',
+            path: '/cfg/newsletter/unsubscribe/',
+            method: 'PUT',
+            error: error,
+            response: response,
+            timestamp: new Date(),
+          },
+          bubbles: true,
+          cancelable: false,
+        });
+        window.dispatchEvent(event);
+      } catch (eventError) {
+        // Silently fail - event dispatch should never crash the app
+        consola.warn('Failed to dispatch validation error event:', eventError);
+      }
+    }
+
+    // Re-throw the error
+    throw error;
+  }
+}
+
+
+/**
+ * API operation
+ *
+ * @method PATCH
+ * @path /cfg/newsletter/unsubscribe/
+ */
+export async function partialUpdateNewsletterUnsubscribePartialUpdate(  data?: PatchedUnsubscribeRequest,  client?: any
+): Promise<Unsubscribe> {
+  const api = client || getAPIInstance()
+  const response = await api.ext_newsletter_newsletter.unsubscribePartialUpdate(data)
+  try {
+    return UnsubscribeSchema.parse(response)
+  } catch (error) {
+    // Zod validation error - log detailed information
+    consola.error('❌ Zod Validation Failed');
+    consola.box(`partialUpdateNewsletterUnsubscribePartialUpdate\nPath: /cfg/newsletter/unsubscribe/\nMethod: PATCH`);
+
+    if (error instanceof Error && 'issues' in error && Array.isArray((error as any).issues)) {
+      consola.error('Validation Issues:');
+      (error as any).issues.forEach((issue: any, index: number) => {
+        consola.error(`  ${index + 1}. ${issue.path.join('.') || 'root'}`);
+        consola.error(`     ├─ Message: ${issue.message}`);
+        if (issue.expected) consola.error(`     ├─ Expected: ${issue.expected}`);
+        if (issue.received) consola.error(`     └─ Received: ${issue.received}`);
+      });
+    }
+
+    consola.error('Response data:', response);
+
+    // Dispatch browser CustomEvent (only if window is defined)
+    if (typeof window !== 'undefined' && error instanceof Error && 'issues' in error) {
+      try {
+        const event = new CustomEvent('zod-validation-error', {
+          detail: {
+            operation: 'partialUpdateNewsletterUnsubscribePartialUpdate',
+            path: '/cfg/newsletter/unsubscribe/',
+            method: 'PATCH',
+            error: error,
+            response: response,
+            timestamp: new Date(),
+          },
+          bubbles: true,
+          cancelable: false,
+        });
+        window.dispatchEvent(event);
+      } catch (eventError) {
+        // Silently fail - event dispatch should never crash the app
+        consola.warn('Failed to dispatch validation error event:', eventError);
+      }
+    }
+
+    // Re-throw the error
+    throw error;
+  }
+}
+
+

package/src/api/generated/ext_newsletter/_utils/fetchers/ext_newsletter__newsletter__bulk_email.ts

@@ -0,0 +1,93 @@
+/**
+ * Typed fetchers for Bulk Email
+ *
+ * Universal functions that work in any environment:
+ * - Next.js (App Router / Pages Router / Server Components)
+ * - React Native
+ * - Node.js backend
+ *
+ * These fetchers use Zod schemas for runtime validation.
+ *
+ * Usage:
+ * ```typescript
+ * // Configure API once (in your app entry point)
+ * import { configureAPI } from '../../api-instance'
+ * configureAPI({ baseUrl: 'https://api.example.com' })
+ *
+ * // Then use fetchers anywhere
+ * const users = await getUsers({ page: 1 })
+ *
+ * // With SWR
+ * const { data } = useSWR(['users', params], () => getUsers(params))
+ *
+ * // With React Query
+ * const { data } = useQuery(['users', params], () => getUsers(params))
+ *
+ * // In Server Component or SSR (pass custom client)
+ * import { API } from '../../index'
+ * const api = new API('https://api.example.com')
+ * const users = await getUsers({ page: 1 }, api)
+ * ```
+ */
+import { consola } from 'consola'
+import { BulkEmailRequestSchema, type BulkEmailRequest } from '../schemas/BulkEmailRequest.schema'
+import { BulkEmailResponseSchema, type BulkEmailResponse } from '../schemas/BulkEmailResponse.schema'
+import { getAPIInstance } from '../../api-instance'
+
+/**
+ * Send Bulk Email
+ *
+ * @method POST
+ * @path /cfg/newsletter/bulk/
+ */
+export async function createNewsletterBulkCreate(  data: BulkEmailRequest,  client?: any
+): Promise<BulkEmailResponse> {
+  const api = client || getAPIInstance()
+  const response = await api.ext_newsletter_bulk_email.newsletterBulkCreate(data)
+  try {
+    return BulkEmailResponseSchema.parse(response)
+  } catch (error) {
+    // Zod validation error - log detailed information
+    consola.error('❌ Zod Validation Failed');
+    consola.box(`createNewsletterBulkCreate\nPath: /cfg/newsletter/bulk/\nMethod: POST`);
+
+    if (error instanceof Error && 'issues' in error && Array.isArray((error as any).issues)) {
+      consola.error('Validation Issues:');
+      (error as any).issues.forEach((issue: any, index: number) => {
+        consola.error(`  ${index + 1}. ${issue.path.join('.') || 'root'}`);
+        consola.error(`     ├─ Message: ${issue.message}`);
+        if (issue.expected) consola.error(`     ├─ Expected: ${issue.expected}`);
+        if (issue.received) consola.error(`     └─ Received: ${issue.received}`);
+      });
+    }
+
+    consola.error('Response data:', response);
+
+    // Dispatch browser CustomEvent (only if window is defined)
+    if (typeof window !== 'undefined' && error instanceof Error && 'issues' in error) {
+      try {
+        const event = new CustomEvent('zod-validation-error', {
+          detail: {
+            operation: 'createNewsletterBulkCreate',
+            path: '/cfg/newsletter/bulk/',
+            method: 'POST',
+            error: error,
+            response: response,
+            timestamp: new Date(),
+          },
+          bubbles: true,
+          cancelable: false,
+        });
+        window.dispatchEvent(event);
+      } catch (eventError) {
+        // Silently fail - event dispatch should never crash the app
+        consola.warn('Failed to dispatch validation error event:', eventError);
+      }
+    }
+
+    // Re-throw the error
+    throw error;
+  }
+}
+
+