@djangocfg/ext-newsletter 1.0.9 → 1.0.11

package/dist/index.d.cts

@@ -607,6 +607,8 @@ interface HttpRequest {
     params?: Record<string, any>;
     /** FormData for file uploads (multipart/form-data) */
     formData?: FormData;
+    /** Binary data for octet-stream uploads */
+    binaryBody?: Blob | ArrayBuffer;
 }
 interface HttpResponse<T = any> {
     data: T;
@@ -859,6 +861,7 @@ declare class APIClient {
     private httpClient;
     private logger;
     private retryConfig;
+    private tokenGetter;
     ext_newsletter_bulk_email: ExtNewsletterBulkEmail;
     ext_newsletter_campaigns: ExtNewsletterCampaigns;
     ext_newsletter_logs: ExtNewsletterLogs;
@@ -870,6 +873,7 @@ declare class APIClient {
         httpClient?: HttpClientAdapter;
         loggerConfig?: Partial<LoggerConfig>;
         retryConfig?: RetryConfig;
+        tokenGetter?: () => string | null;
     });
     /**
      * Get CSRF token from cookies (for SessionAuthentication).
@@ -877,6 +881,15 @@ declare class APIClient {
      * Returns null if cookie doesn't exist (JWT-only auth).
      */
     getCsrfToken(): string | null;
+    /**
+     * Get the base URL for building streaming/download URLs.
+     */
+    getBaseUrl(): string;
+    /**
+     * Get JWT token for URL authentication (used in streaming endpoints).
+     * Returns null if no token getter is configured or no token is available.
+     */
+    getToken(): string | null;
     /**
      * Make HTTP request with Django CSRF and session handling.
      * Automatically retries on network errors and 5xx server errors.
@@ -885,6 +898,7 @@ declare class APIClient {
         params?: Record<string, any>;
         body?: any;
         formData?: FormData;
+        binaryBody?: Blob | ArrayBuffer;
         headers?: Record<string, string>;
     }): Promise<T>;
     /**
@@ -966,7 +980,7 @@ declare const BulkEmailRequestSchema: z.ZodObject<{
     main_text: z.ZodString;
     main_html_content: z.ZodOptional<z.ZodString>;
     button_text: z.ZodOptional<z.ZodString>;
-    button_url: z.ZodOptional<z.ZodURL>;
+    button_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
     secondary_text: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
@@ -1088,7 +1102,7 @@ declare const NewsletterCampaignSchema: z.ZodObject<{
     main_text: z.ZodString;
     main_html_content: z.ZodOptional<z.ZodString>;
     button_text: z.ZodOptional<z.ZodString>;
-    button_url: z.ZodOptional<z.ZodURL>;
+    button_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
     secondary_text: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<typeof NewsletterCampaignStatus>;
     created_at: z.ZodISODateTime;
@@ -1117,7 +1131,7 @@ declare const NewsletterCampaignRequestSchema: z.ZodObject<{
     main_text: z.ZodString;
     main_html_content: z.ZodOptional<z.ZodString>;
     button_text: z.ZodOptional<z.ZodString>;
-    button_url: z.ZodOptional<z.ZodURL>;
+    button_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
     secondary_text: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
@@ -1198,7 +1212,7 @@ declare const PaginatedNewsletterCampaignListSchema: z.ZodObject<{
         main_text: z.ZodString;
         main_html_content: z.ZodOptional<z.ZodString>;
         button_text: z.ZodOptional<z.ZodString>;
-        button_url: z.ZodOptional<z.ZodURL>;
+        button_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
         secondary_text: z.ZodOptional<z.ZodString>;
         status: z.ZodEnum<typeof NewsletterCampaignStatus>;
         created_at: z.ZodISODateTime;
@@ -1291,7 +1305,7 @@ declare const PatchedNewsletterCampaignRequestSchema: z.ZodObject<{
     main_text: z.ZodOptional<z.ZodString>;
     main_html_content: z.ZodOptional<z.ZodString>;
     button_text: z.ZodOptional<z.ZodString>;
-    button_url: z.ZodOptional<z.ZodURL>;
+    button_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
     secondary_text: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
@@ -1796,30 +1810,38 @@ declare namespace index {
 }
 
 /**
- * Global API Instance - Singleton configuration
+ * Global API Instance - Singleton configuration with auto-configuration support
  *
- * This module provides a global API instance that can be configured once
- * and used throughout your application.
+ * This module provides a global API instance that auto-configures from
+ * environment variables or can be configured manually.
  *
- * Usage:
+ * AUTO-CONFIGURATION (recommended):
+ * Set one of these environment variables and the API will auto-configure:
+ * - NEXT_PUBLIC_API_URL (Next.js)
+ * - VITE_API_URL (Vite)
+ * - REACT_APP_API_URL (Create React App)
+ * - API_URL (generic)
+ *
+ * Then just use fetchers and hooks directly:
+ * ```typescript
+ * import { getUsers } from './_utils/fetchers'
+ * const users = await getUsers({ page: 1 })
+ * ```
+ *
+ * MANUAL CONFIGURATION:
  * ```typescript
- * // Configure once (e.g., in your app entry point)
  * import { configureAPI } from './api-instance'
  *
  * configureAPI({
  *   baseUrl: 'https://api.example.com',
  *   token: 'your-jwt-token'
  * })
- *
- * // Then use fetchers and hooks anywhere without configuration
- * import { getUsers } from './fetchers'
- * const users = await getUsers({ page: 1 })
  * ```
  *
  * For SSR or multiple instances:
  * ```typescript
  * import { API } from './index'
- * import { getUsers } from './fetchers'
+ * import { getUsers } from './_utils/fetchers'
  *
  * const api = new API('https://api.example.com')
  * const users = await getUsers({ page: 1 }, api)
@@ -1828,11 +1850,12 @@ declare namespace index {
 
 /**
  * Get the global API instance
- * @throws Error if API is not configured
+ * Auto-configures from environment variables on first call if not manually configured.
+ * @throws Error if API is not configured and no env variable is set
  */
 declare function getAPIInstance(): API;
 /**
- * Check if API is configured
+ * Check if API is configured (or can be auto-configured)
  */
 declare function isAPIConfigured(): boolean;
 /**

package/dist/index.d.ts

@@ -607,6 +607,8 @@ interface HttpRequest {
     params?: Record<string, any>;
     /** FormData for file uploads (multipart/form-data) */
     formData?: FormData;
+    /** Binary data for octet-stream uploads */
+    binaryBody?: Blob | ArrayBuffer;
 }
 interface HttpResponse<T = any> {
     data: T;
@@ -859,6 +861,7 @@ declare class APIClient {
     private httpClient;
     private logger;
     private retryConfig;
+    private tokenGetter;
     ext_newsletter_bulk_email: ExtNewsletterBulkEmail;
     ext_newsletter_campaigns: ExtNewsletterCampaigns;
     ext_newsletter_logs: ExtNewsletterLogs;
@@ -870,6 +873,7 @@ declare class APIClient {
         httpClient?: HttpClientAdapter;
         loggerConfig?: Partial<LoggerConfig>;
         retryConfig?: RetryConfig;
+        tokenGetter?: () => string | null;
     });
     /**
      * Get CSRF token from cookies (for SessionAuthentication).
@@ -877,6 +881,15 @@ declare class APIClient {
      * Returns null if cookie doesn't exist (JWT-only auth).
      */
     getCsrfToken(): string | null;
+    /**
+     * Get the base URL for building streaming/download URLs.
+     */
+    getBaseUrl(): string;
+    /**
+     * Get JWT token for URL authentication (used in streaming endpoints).
+     * Returns null if no token getter is configured or no token is available.
+     */
+    getToken(): string | null;
     /**
      * Make HTTP request with Django CSRF and session handling.
      * Automatically retries on network errors and 5xx server errors.
@@ -885,6 +898,7 @@ declare class APIClient {
         params?: Record<string, any>;
         body?: any;
         formData?: FormData;
+        binaryBody?: Blob | ArrayBuffer;
         headers?: Record<string, string>;
     }): Promise<T>;
     /**
@@ -966,7 +980,7 @@ declare const BulkEmailRequestSchema: z.ZodObject<{
     main_text: z.ZodString;
     main_html_content: z.ZodOptional<z.ZodString>;
     button_text: z.ZodOptional<z.ZodString>;
-    button_url: z.ZodOptional<z.ZodURL>;
+    button_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
     secondary_text: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
@@ -1088,7 +1102,7 @@ declare const NewsletterCampaignSchema: z.ZodObject<{
     main_text: z.ZodString;
     main_html_content: z.ZodOptional<z.ZodString>;
     button_text: z.ZodOptional<z.ZodString>;
-    button_url: z.ZodOptional<z.ZodURL>;
+    button_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
     secondary_text: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<typeof NewsletterCampaignStatus>;
     created_at: z.ZodISODateTime;
@@ -1117,7 +1131,7 @@ declare const NewsletterCampaignRequestSchema: z.ZodObject<{
     main_text: z.ZodString;
     main_html_content: z.ZodOptional<z.ZodString>;
     button_text: z.ZodOptional<z.ZodString>;
-    button_url: z.ZodOptional<z.ZodURL>;
+    button_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
     secondary_text: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
@@ -1198,7 +1212,7 @@ declare const PaginatedNewsletterCampaignListSchema: z.ZodObject<{
         main_text: z.ZodString;
         main_html_content: z.ZodOptional<z.ZodString>;
         button_text: z.ZodOptional<z.ZodString>;
-        button_url: z.ZodOptional<z.ZodURL>;
+        button_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
         secondary_text: z.ZodOptional<z.ZodString>;
         status: z.ZodEnum<typeof NewsletterCampaignStatus>;
         created_at: z.ZodISODateTime;
@@ -1291,7 +1305,7 @@ declare const PatchedNewsletterCampaignRequestSchema: z.ZodObject<{
     main_text: z.ZodOptional<z.ZodString>;
     main_html_content: z.ZodOptional<z.ZodString>;
     button_text: z.ZodOptional<z.ZodString>;
-    button_url: z.ZodOptional<z.ZodURL>;
+    button_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
     secondary_text: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
@@ -1796,30 +1810,38 @@ declare namespace index {
 }
 
 /**
- * Global API Instance - Singleton configuration
+ * Global API Instance - Singleton configuration with auto-configuration support
  *
- * This module provides a global API instance that can be configured once
- * and used throughout your application.
+ * This module provides a global API instance that auto-configures from
+ * environment variables or can be configured manually.
  *
- * Usage:
+ * AUTO-CONFIGURATION (recommended):
+ * Set one of these environment variables and the API will auto-configure:
+ * - NEXT_PUBLIC_API_URL (Next.js)
+ * - VITE_API_URL (Vite)
+ * - REACT_APP_API_URL (Create React App)
+ * - API_URL (generic)
+ *
+ * Then just use fetchers and hooks directly:
+ * ```typescript
+ * import { getUsers } from './_utils/fetchers'
+ * const users = await getUsers({ page: 1 })
+ * ```
+ *
+ * MANUAL CONFIGURATION:
  * ```typescript
- * // Configure once (e.g., in your app entry point)
  * import { configureAPI } from './api-instance'
  *
  * configureAPI({
  *   baseUrl: 'https://api.example.com',
  *   token: 'your-jwt-token'
  * })
- *
- * // Then use fetchers and hooks anywhere without configuration
- * import { getUsers } from './fetchers'
- * const users = await getUsers({ page: 1 })
  * ```
  *
  * For SSR or multiple instances:
  * ```typescript
  * import { API } from './index'
- * import { getUsers } from './fetchers'
+ * import { getUsers } from './_utils/fetchers'
  *
  * const api = new API('https://api.example.com')
  * const users = await getUsers({ page: 1 }, api)
@@ -1828,11 +1850,12 @@ declare namespace index {
 
 /**
  * Get the global API instance
- * @throws Error if API is not configured
+ * Auto-configures from environment variables on first call if not manually configured.
+ * @throws Error if API is not configured and no env variable is set
  */
 declare function getAPIInstance(): API;
 /**
- * Check if API is configured
+ * Check if API is configured (or can be auto-configured)
  */
 declare function isAPIConfigured(): boolean;
 /**

package/dist/index.js

@@ -1,7 +1,7 @@
 import { createConsola, consola } from 'consola';
 import pRetry, { AbortError } from 'p-retry';
 import { z } from 'zod';
-import { createExtensionAPI } from '@djangocfg/ext-base/api';
+import { initializeExtensionAPI, createExtensionAPI } from '@djangocfg/ext-base/api';
 import { createExtensionConfig } from '@djangocfg/ext-base';
 
 var __defProp = Object.defineProperty;
@@ -265,7 +265,7 @@ var models_exports7 = {};
 // src/api/generated/ext_newsletter/http.ts
 var FetchAdapter = class {
   async request(request) {
-    const { method, url, headers, body, params, formData } = request;
+    const { method, url, headers, body, params, formData, binaryBody } = request;
     let finalUrl = url;
     if (params) {
       const searchParams = new URLSearchParams();
@@ -283,6 +283,9 @@ var FetchAdapter = class {
     let requestBody;
     if (formData) {
       requestBody = formData;
+    } else if (binaryBody) {
+      finalHeaders["Content-Type"] = "application/octet-stream";
+      requestBody = binaryBody;
     } else if (body) {
       finalHeaders["Content-Type"] = "application/json";
       requestBody = JSON.stringify(body);
@@ -607,6 +610,7 @@ var APIClient = class {
   httpClient;
   logger = null;
   retryConfig = null;
+  tokenGetter = null;
   // Sub-clients
   ext_newsletter_bulk_email;
   ext_newsletter_campaigns;
@@ -618,6 +622,7 @@ var APIClient = class {
   constructor(baseUrl, options) {
     this.baseUrl = baseUrl.replace(/\/$/, "");
     this.httpClient = options?.httpClient || new FetchAdapter();
+    this.tokenGetter = options?.tokenGetter || null;
     if (options?.loggerConfig !== void 0) {
       this.logger = new APILogger(options.loggerConfig);
     }
@@ -646,6 +651,19 @@ var APIClient = class {
     }
     return null;
   }
+  /**
+   * Get the base URL for building streaming/download URLs.
+   */
+  getBaseUrl() {
+    return this.baseUrl;
+  }
+  /**
+   * Get JWT token for URL authentication (used in streaming endpoints).
+   * Returns null if no token getter is configured or no token is available.
+   */
+  getToken() {
+    return this.tokenGetter ? this.tokenGetter() : null;
+  }
   /**
    * Make HTTP request with Django CSRF and session handling.
    * Automatically retries on network errors and 5xx server errors.
@@ -676,7 +694,7 @@ var APIClient = class {
     const headers = {
       ...options?.headers || {}
     };
-    if (!options?.formData && !headers["Content-Type"]) {
+    if (!options?.formData && !options?.binaryBody && !headers["Content-Type"]) {
       headers["Content-Type"] = "application/json";
     }
     if (this.logger) {
@@ -695,7 +713,8 @@ var APIClient = class {
         headers,
         params: options?.params,
         body: options?.body,
-        formData: options?.formData
+        formData: options?.formData,
+        binaryBody: options?.binaryBody
       });
       const duration = Date.now() - startTime;
       if (response.status >= 400) {
@@ -976,7 +995,7 @@ var BulkEmailRequestSchema = z.object({
   main_text: z.string().min(1),
   main_html_content: z.string().optional(),
   button_text: z.string().max(100).optional(),
-  button_url: z.url().optional(),
+  button_url: z.union([z.url(), z.literal("")]).optional(),
   secondary_text: z.string().optional()
 });
 var BulkEmailResponseSchema = z.object({
@@ -1023,7 +1042,7 @@ var NewsletterCampaignSchema = z.object({
   main_text: z.string(),
   main_html_content: z.string().optional(),
   button_text: z.string().max(100).optional(),
-  button_url: z.url().optional(),
+  button_url: z.union([z.url(), z.literal("")]).optional(),
   secondary_text: z.string().optional(),
   status: z.nativeEnum(NewsletterCampaignStatus),
   created_at: z.iso.datetime(),
@@ -1037,7 +1056,7 @@ var NewsletterCampaignRequestSchema = z.object({
   main_text: z.string().min(1),
   main_html_content: z.string().optional(),
   button_text: z.string().max(100).optional(),
-  button_url: z.url().optional(),
+  button_url: z.union([z.url(), z.literal("")]).optional(),
   secondary_text: z.string().optional()
 });
 var NewsletterSubscriptionSchema = z.object({
@@ -1102,7 +1121,7 @@ var PatchedNewsletterCampaignRequestSchema = z.object({
   main_text: z.string().min(1).optional(),
   main_html_content: z.string().optional(),
   button_text: z.string().max(100).optional(),
-  button_url: z.url().optional(),
+  button_url: z.union([z.url(), z.literal("")]).optional(),
   secondary_text: z.string().optional()
 });
 var PatchedUnsubscribeRequestSchema = z.object({
@@ -1212,15 +1231,28 @@ __export(fetchers_exports, {
 
 // src/api/generated/ext_newsletter/api-instance.ts
 var globalAPI = null;
+var autoConfigAttempted = false;
+function tryAutoConfigureFromEnv() {
+  if (autoConfigAttempted) return;
+  autoConfigAttempted = true;
+  if (globalAPI) return;
+  if (typeof process === "undefined" || !process.env) return;
+  const baseUrl = process.env.NEXT_PUBLIC_API_URL || process.env.VITE_API_URL || process.env.REACT_APP_API_URL || process.env.API_URL;
+  if (baseUrl) {
+    globalAPI = new API(baseUrl);
+  }
+}
 function getAPIInstance() {
+  tryAutoConfigureFromEnv();
   if (!globalAPI) {
     throw new Error(
-      'API not configured. Call configureAPI() with your base URL before using fetchers or hooks.\n\nExample:\n  import { configureAPI } from "./api-instance"\n  configureAPI({ baseUrl: "https://api.example.com" })'
+      'API not configured. Call configureAPI() with your base URL before using fetchers or hooks.\n\nExample:\n  import { configureAPI } from "./api-instance"\n  configureAPI({ baseUrl: "https://api.example.com" })\n\nOr set environment variable: NEXT_PUBLIC_API_URL, VITE_API_URL, or REACT_APP_API_URL'
     );
   }
   return globalAPI;
 }
 function isAPIConfigured() {
+  tryAutoConfigureFromEnv();
   return globalAPI !== null;
 }
 function configureAPI(config) {
@@ -1956,7 +1988,8 @@ var API = class {
     this._loadTokensFromStorage();
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
-      loggerConfig: this.options?.loggerConfig
+      loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken()
     });
     this._injectAuthHeader();
     this.ext_newsletter_bulk_email = this._client.ext_newsletter_bulk_email;
@@ -1974,7 +2007,8 @@ var API = class {
   _reinitClients() {
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
-      loggerConfig: this.options?.loggerConfig
+      loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken()
     });
     this._injectAuthHeader();
     this.ext_newsletter_bulk_email = this._client.ext_newsletter_bulk_email;
@@ -2071,12 +2105,13 @@ var API = class {
     return "./schema.json";
   }
 };
+initializeExtensionAPI(configureAPI);
 var apiNewsletter = createExtensionAPI(API);
 
 // package.json
 var package_default = {
   name: "@djangocfg/ext-newsletter",
-  version: "1.0.9",
+  version: "1.0.11",
   description: "Newsletter and subscription management extension for DjangoCFG",
   keywords: [
     "django",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/ext-newsletter",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "Newsletter and subscription management extension for DjangoCFG",
   "keywords": [
     "django",
@@ -59,9 +59,9 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/api": "^2.1.104",
+    "@djangocfg/api": "^2.1.107",
     "@djangocfg/ext-base": "^1.0.8",
-    "@djangocfg/ui-core": "^2.1.104",
+    "@djangocfg/ui-core": "^2.1.107",
     "consola": "^3.4.2",
     "lucide-react": "^0.545.0",
     "next": "^15.5.7",
@@ -72,9 +72,9 @@
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@djangocfg/api": "^2.1.104",
+    "@djangocfg/api": "^2.1.107",
     "@djangocfg/ext-base": "^1.0.8",
-    "@djangocfg/typescript-config": "^2.1.104",
+    "@djangocfg/typescript-config": "^2.1.107",
     "@types/node": "^24.7.2",
     "@types/react": "^19.0.0",
     "consola": "^3.4.2",

package/src/api/generated/ext_newsletter/CLAUDE.md

@@ -60,12 +60,5 @@ openapi_client = OpenAPIClientConfig(
 )
 ```
 
-**Copy to Next.js** (if `nextjs_admin` configured):
-```python
-nextjs_admin = NextJsAdminConfig(
-    project_path="../frontend/apps/...",
-    api_output_path="app/_lib/api/generated",
-)
-```
-
 @see https://djangocfg.com/docs/features/api-generation
+

package/src/api/generated/ext_newsletter/_utils/schemas/BulkEmailRequest.schema.ts

@@ -16,7 +16,7 @@ export const BulkEmailRequestSchema = z.object({
   main_text: z.string().min(1),
   main_html_content: z.string().optional(),
   button_text: z.string().max(100).optional(),
-  button_url: z.url().optional(),
+  button_url: z.union([z.url(), z.literal('')]).optional(),
   secondary_text: z.string().optional(),
 })
 

package/src/api/generated/ext_newsletter/_utils/schemas/NewsletterCampaign.schema.ts

@@ -19,7 +19,7 @@ export const NewsletterCampaignSchema = z.object({
   main_text: z.string(),
   main_html_content: z.string().optional(),
   button_text: z.string().max(100).optional(),
-  button_url: z.url().optional(),
+  button_url: z.union([z.url(), z.literal('')]).optional(),
   secondary_text: z.string().optional(),
   status: z.nativeEnum(Enums.NewsletterCampaignStatus),
   created_at: z.iso.datetime(),

package/src/api/generated/ext_newsletter/_utils/schemas/NewsletterCampaignRequest.schema.ts

@@ -16,7 +16,7 @@ export const NewsletterCampaignRequestSchema = z.object({
   main_text: z.string().min(1),
   main_html_content: z.string().optional(),
   button_text: z.string().max(100).optional(),
-  button_url: z.url().optional(),
+  button_url: z.union([z.url(), z.literal('')]).optional(),
   secondary_text: z.string().optional(),
 })
 

package/src/api/generated/ext_newsletter/_utils/schemas/PatchedNewsletterCampaignRequest.schema.ts

@@ -16,7 +16,7 @@ export const PatchedNewsletterCampaignRequestSchema = z.object({
   main_text: z.string().min(1).optional(),
   main_html_content: z.string().optional(),
   button_text: z.string().max(100).optional(),
-  button_url: z.url().optional(),
+  button_url: z.union([z.url(), z.literal('')]).optional(),
   secondary_text: z.string().optional(),
 })