@djangocfg/ext-newsletter 1.0.0

package/src/api/generated/ext_newsletter/_utils/hooks/ext_newsletter__newsletter__subscriptions.ts

@@ -0,0 +1,78 @@
+'use client';
+
+/**
+ * SWR Hooks for Subscriptions
+ *
+ * React hooks powered by SWR for data fetching with automatic caching,
+ * revalidation, and optimistic updates.
+ *
+ * Usage:
+ * ```typescript
+ * // Query hooks (GET)
+ * const { data, error, isLoading } = useUsers({ page: 1 })
+ *
+ * // Mutation hooks (POST/PUT/PATCH/DELETE)
+ * const createUser = useCreateUser()
+ * await createUser({ name: 'John', email: 'john@example.com' })
+ * ```
+ */
+import useSWR from 'swr'
+import { useSWRConfig } from 'swr'
+import * as Fetchers from '../fetchers/ext_newsletter__newsletter__subscriptions'
+import type { API } from '../../index'
+import type { PaginatedNewsletterSubscriptionList } from '../schemas/PaginatedNewsletterSubscriptionList.schema'
+import type { SubscribeRequest } from '../schemas/SubscribeRequest.schema'
+import type { SubscribeResponse } from '../schemas/SubscribeResponse.schema'
+import type { SuccessResponse } from '../schemas/SuccessResponse.schema'
+import type { UnsubscribeRequest } from '../schemas/UnsubscribeRequest.schema'
+
+/**
+ * Subscribe to Newsletter
+ *
+ * @method POST
+ * @path /cfg/newsletter/subscribe/
+ */
+export function useCreateNewsletterSubscribeCreate() {
+  const { mutate } = useSWRConfig()
+
+  return async (data: SubscribeRequest, client?: API): Promise<SubscribeResponse> => {
+    const result = await Fetchers.createNewsletterSubscribeCreate(data, client)
+    // Revalidate related queries
+    mutate('cfg-newsletter-subscribe')
+    return result
+  }
+}
+
+
+/**
+ * List User Subscriptions
+ *
+ * @method GET
+ * @path /cfg/newsletter/subscriptions/
+ */
+export function useNewsletterSubscriptionsList(params?: { page?: number; page_size?: number }, client?: API): ReturnType<typeof useSWR<PaginatedNewsletterSubscriptionList>> {
+  return useSWR<PaginatedNewsletterSubscriptionList>(
+    params ? ['cfg-newsletter-subscriptions', params] : 'cfg-newsletter-subscriptions',
+    () => Fetchers.getNewsletterSubscriptionsList(params, client)
+  )
+}
+
+
+/**
+ * Unsubscribe from Newsletter
+ *
+ * @method POST
+ * @path /cfg/newsletter/unsubscribe/
+ */
+export function useCreateNewsletterUnsubscribeCreate() {
+  const { mutate } = useSWRConfig()
+
+  return async (data: UnsubscribeRequest, client?: API): Promise<SuccessResponse> => {
+    const result = await Fetchers.createNewsletterUnsubscribeCreate(data, client)
+    // Revalidate related queries
+    mutate('cfg-newsletter-unsubscribe')
+    return result
+  }
+}
+
+

package/src/api/generated/ext_newsletter/_utils/hooks/ext_newsletter__newsletter__testing.ts

@@ -0,0 +1,42 @@
+'use client';
+
+/**
+ * SWR Hooks for Testing
+ *
+ * React hooks powered by SWR for data fetching with automatic caching,
+ * revalidation, and optimistic updates.
+ *
+ * Usage:
+ * ```typescript
+ * // Query hooks (GET)
+ * const { data, error, isLoading } = useUsers({ page: 1 })
+ *
+ * // Mutation hooks (POST/PUT/PATCH/DELETE)
+ * const createUser = useCreateUser()
+ * await createUser({ name: 'John', email: 'john@example.com' })
+ * ```
+ */
+import { useSWRConfig } from 'swr'
+import * as Fetchers from '../fetchers/ext_newsletter__newsletter__testing'
+import type { API } from '../../index'
+import type { BulkEmailResponse } from '../schemas/BulkEmailResponse.schema'
+import type { TestEmailRequest } from '../schemas/TestEmailRequest.schema'
+
+/**
+ * Test Email Sending
+ *
+ * @method POST
+ * @path /cfg/newsletter/test/
+ */
+export function useCreateNewsletterTestCreate() {
+  const { mutate } = useSWRConfig()
+
+  return async (data: TestEmailRequest, client?: API): Promise<BulkEmailResponse> => {
+    const result = await Fetchers.createNewsletterTestCreate(data, client)
+    // Revalidate related queries
+    mutate('cfg-newsletter-test')
+    return result
+  }
+}
+
+

package/src/api/generated/ext_newsletter/_utils/hooks/index.ts

@@ -0,0 +1,34 @@
+'use client';
+
+/**
+ * SWR Hooks - React data fetching hooks
+ *
+ * Auto-generated from OpenAPI specification.
+ * Powered by SWR for automatic caching and revalidation.
+ *
+ * Features:
+ * - Automatic caching and deduplication
+ * - Revalidation on focus/reconnect
+ * - Optimistic updates
+ * - Type-safe parameters and responses
+ *
+ * Usage:
+ * ```typescript
+ * import * as hooks from './hooks'
+ *
+ * // Query hooks (GET)
+ * const { data, error, isLoading } = hooks.useUsers({ page: 1 })
+ *
+ * // Mutation hooks (POST/PUT/PATCH/DELETE)
+ * const createUser = hooks.useCreateUser()
+ * await createUser({ name: 'John' })
+ * ```
+ */
+
+export * from './ext_newsletter__newsletter__bulk_email'
+export * from './ext_newsletter__newsletter__campaigns'
+export * from './ext_newsletter__newsletter__logs'
+export * from './ext_newsletter__newsletter__newsletters'
+export * from './ext_newsletter__newsletter__subscriptions'
+export * from './ext_newsletter__newsletter__testing'
+export * from './ext_newsletter__newsletter'

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

@@ -0,0 +1,26 @@
+/**
+ * Zod schema for BulkEmailRequest
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Simple serializer for bulk email.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Simple serializer for bulk email.
+ */
+export const BulkEmailRequestSchema = z.object({
+  recipients: z.array(z.email()),
+  subject: z.string().min(1).max(255),
+  email_title: z.string().min(1).max(255),
+  main_text: z.string().min(1),
+  main_html_content: z.string().optional(),
+  button_text: z.string().max(100).optional(),
+  button_url: z.url().optional(),
+  secondary_text: z.string().optional(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type BulkEmailRequest = z.infer<typeof BulkEmailRequestSchema>

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

@@ -0,0 +1,23 @@
+/**
+ * Zod schema for BulkEmailResponse
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Response for bulk email sending.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Response for bulk email sending.
+ */
+export const BulkEmailResponseSchema = z.object({
+  success: z.boolean(),
+  sent_count: z.int(),
+  failed_count: z.int(),
+  total_recipients: z.int(),
+  error: z.string().optional(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type BulkEmailResponse = z.infer<typeof BulkEmailResponseSchema>

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

@@ -0,0 +1,31 @@
+/**
+ * Zod schema for EmailLog
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Serializer for EmailLog model.
+ *  */
+import { z } from 'zod'
+import * as Enums from '../../enums'
+
+/**
+ * Serializer for EmailLog model.
+ */
+export const EmailLogSchema = z.object({
+  id: z.string().regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i),
+  user: z.int().nullable(),
+  user_email: z.string(),
+  newsletter: z.int().nullable(),
+  newsletter_title: z.string(),
+  recipient: z.string(),
+  subject: z.string(),
+  body: z.string(),
+  status: z.nativeEnum(Enums.EmailLogStatus),
+  created_at: z.iso.datetime(),
+  sent_at: z.iso.datetime().nullable(),
+  error_message: z.string().nullable(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type EmailLog = z.infer<typeof EmailLogSchema>

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

@@ -0,0 +1,20 @@
+/**
+ * Zod schema for ErrorResponse
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Generic error response.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Generic error response.
+ */
+export const ErrorResponseSchema = z.object({
+  success: z.boolean().optional(),
+  message: z.string(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type ErrorResponse = z.infer<typeof ErrorResponseSchema>

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

@@ -0,0 +1,26 @@
+/**
+ * Zod schema for Newsletter
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Serializer for Newsletter model.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Serializer for Newsletter model.
+ */
+export const NewsletterSchema = z.object({
+  id: z.int(),
+  title: z.string().max(255),
+  description: z.string().optional(),
+  is_active: z.boolean().optional(),
+  auto_subscribe: z.boolean().optional(),
+  created_at: z.iso.datetime(),
+  updated_at: z.iso.datetime(),
+  subscribers_count: z.int(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type Newsletter = z.infer<typeof NewsletterSchema>

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

@@ -0,0 +1,33 @@
+/**
+ * Zod schema for NewsletterCampaign
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Serializer for NewsletterCampaign model.
+ *  */
+import { z } from 'zod'
+import * as Enums from '../../enums'
+
+/**
+ * Serializer for NewsletterCampaign model.
+ */
+export const NewsletterCampaignSchema = z.object({
+  id: z.int(),
+  newsletter: z.int(),
+  newsletter_title: z.string(),
+  subject: z.string().max(255),
+  email_title: z.string().max(255),
+  main_text: z.string(),
+  main_html_content: z.string().optional(),
+  button_text: z.string().max(100).optional(),
+  button_url: z.url().optional(),
+  secondary_text: z.string().optional(),
+  status: z.nativeEnum(Enums.NewsletterCampaignStatus),
+  created_at: z.iso.datetime(),
+  sent_at: z.iso.datetime().nullable(),
+  recipient_count: z.int(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type NewsletterCampaign = z.infer<typeof NewsletterCampaignSchema>

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

@@ -0,0 +1,26 @@
+/**
+ * Zod schema for NewsletterCampaignRequest
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Serializer for NewsletterCampaign model.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Serializer for NewsletterCampaign model.
+ */
+export const NewsletterCampaignRequestSchema = z.object({
+  newsletter: z.int(),
+  subject: z.string().min(1).max(255),
+  email_title: z.string().min(1).max(255),
+  main_text: z.string().min(1),
+  main_html_content: z.string().optional(),
+  button_text: z.string().max(100).optional(),
+  button_url: z.url().optional(),
+  secondary_text: z.string().optional(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type NewsletterCampaignRequest = z.infer<typeof NewsletterCampaignRequestSchema>

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

@@ -0,0 +1,27 @@
+/**
+ * Zod schema for NewsletterSubscription
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Serializer for NewsletterSubscription model.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Serializer for NewsletterSubscription model.
+ */
+export const NewsletterSubscriptionSchema = z.object({
+  id: z.int(),
+  newsletter: z.int(),
+  newsletter_title: z.string(),
+  user: z.int().nullable().optional(),
+  user_email: z.string(),
+  email: z.email(),
+  is_active: z.boolean().optional(),
+  subscribed_at: z.iso.datetime(),
+  unsubscribed_at: z.iso.datetime().nullable(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type NewsletterSubscription = z.infer<typeof NewsletterSubscriptionSchema>

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

@@ -0,0 +1,24 @@
+/**
+ * Zod schema for PaginatedEmailLogList
+ *
+ * This schema provides runtime validation and type inference.
+ *  */
+import { z } from 'zod'
+import { EmailLogSchema } from './EmailLog.schema'
+
+export const PaginatedEmailLogListSchema = z.object({
+  count: z.int(),
+  page: z.int(),
+  pages: z.int(),
+  page_size: z.int(),
+  has_next: z.boolean(),
+  has_previous: z.boolean(),
+  next_page: z.int().nullable().optional(),
+  previous_page: z.int().nullable().optional(),
+  results: z.array(EmailLogSchema),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type PaginatedEmailLogList = z.infer<typeof PaginatedEmailLogListSchema>

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

@@ -0,0 +1,24 @@
+/**
+ * Zod schema for PaginatedNewsletterCampaignList
+ *
+ * This schema provides runtime validation and type inference.
+ *  */
+import { z } from 'zod'
+import { NewsletterCampaignSchema } from './NewsletterCampaign.schema'
+
+export const PaginatedNewsletterCampaignListSchema = z.object({
+  count: z.int(),
+  page: z.int(),
+  pages: z.int(),
+  page_size: z.int(),
+  has_next: z.boolean(),
+  has_previous: z.boolean(),
+  next_page: z.int().nullable().optional(),
+  previous_page: z.int().nullable().optional(),
+  results: z.array(NewsletterCampaignSchema),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type PaginatedNewsletterCampaignList = z.infer<typeof PaginatedNewsletterCampaignListSchema>

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

@@ -0,0 +1,24 @@
+/**
+ * Zod schema for PaginatedNewsletterList
+ *
+ * This schema provides runtime validation and type inference.
+ *  */
+import { z } from 'zod'
+import { NewsletterSchema } from './Newsletter.schema'
+
+export const PaginatedNewsletterListSchema = z.object({
+  count: z.int(),
+  page: z.int(),
+  pages: z.int(),
+  page_size: z.int(),
+  has_next: z.boolean(),
+  has_previous: z.boolean(),
+  next_page: z.int().nullable().optional(),
+  previous_page: z.int().nullable().optional(),
+  results: z.array(NewsletterSchema),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type PaginatedNewsletterList = z.infer<typeof PaginatedNewsletterListSchema>

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

@@ -0,0 +1,24 @@
+/**
+ * Zod schema for PaginatedNewsletterSubscriptionList
+ *
+ * This schema provides runtime validation and type inference.
+ *  */
+import { z } from 'zod'
+import { NewsletterSubscriptionSchema } from './NewsletterSubscription.schema'
+
+export const PaginatedNewsletterSubscriptionListSchema = z.object({
+  count: z.int(),
+  page: z.int(),
+  pages: z.int(),
+  page_size: z.int(),
+  has_next: z.boolean(),
+  has_previous: z.boolean(),
+  next_page: z.int().nullable().optional(),
+  previous_page: z.int().nullable().optional(),
+  results: z.array(NewsletterSubscriptionSchema),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type PaginatedNewsletterSubscriptionList = z.infer<typeof PaginatedNewsletterSubscriptionListSchema>

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

@@ -0,0 +1,26 @@
+/**
+ * Zod schema for PatchedNewsletterCampaignRequest
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Serializer for NewsletterCampaign model.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Serializer for NewsletterCampaign model.
+ */
+export const PatchedNewsletterCampaignRequestSchema = z.object({
+  newsletter: z.int().optional(),
+  subject: z.string().min(1).max(255).optional(),
+  email_title: z.string().min(1).max(255).optional(),
+  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(),
+  secondary_text: z.string().optional(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type PatchedNewsletterCampaignRequest = z.infer<typeof PatchedNewsletterCampaignRequestSchema>

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

@@ -0,0 +1,19 @@
+/**
+ * Zod schema for PatchedUnsubscribeRequest
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Simple serializer for unsubscribe.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Simple serializer for unsubscribe.
+ */
+export const PatchedUnsubscribeRequestSchema = z.object({
+  subscription_id: z.int().optional(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type PatchedUnsubscribeRequest = z.infer<typeof PatchedUnsubscribeRequestSchema>

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

@@ -0,0 +1,19 @@
+/**
+ * Zod schema for SendCampaignRequest
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Simple serializer for sending campaign.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Simple serializer for sending campaign.
+ */
+export const SendCampaignRequestSchema = z.object({
+  campaign_id: z.int(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type SendCampaignRequest = z.infer<typeof SendCampaignRequestSchema>

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

@@ -0,0 +1,22 @@
+/**
+ * Zod schema for SendCampaignResponse
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Response for sending campaign.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Response for sending campaign.
+ */
+export const SendCampaignResponseSchema = z.object({
+  success: z.boolean(),
+  message: z.string().optional(),
+  sent_count: z.int().optional(),
+  error: z.string().optional(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type SendCampaignResponse = z.infer<typeof SendCampaignResponseSchema>

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

@@ -0,0 +1,20 @@
+/**
+ * Zod schema for SubscribeRequest
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Simple serializer for newsletter subscription.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Simple serializer for newsletter subscription.
+ */
+export const SubscribeRequestSchema = z.object({
+  newsletter_id: z.int(),
+  email: z.email(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type SubscribeRequest = z.infer<typeof SubscribeRequestSchema>

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

@@ -0,0 +1,21 @@
+/**
+ * Zod schema for SubscribeResponse
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Response for subscription.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Response for subscription.
+ */
+export const SubscribeResponseSchema = z.object({
+  success: z.boolean(),
+  message: z.string(),
+  subscription_id: z.int().optional(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type SubscribeResponse = z.infer<typeof SubscribeResponseSchema>

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

@@ -0,0 +1,20 @@
+/**
+ * Zod schema for SuccessResponse
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Generic success response.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Generic success response.
+ */
+export const SuccessResponseSchema = z.object({
+  success: z.boolean(),
+  message: z.string(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type SuccessResponse = z.infer<typeof SuccessResponseSchema>

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

@@ -0,0 +1,21 @@
+/**
+ * Zod schema for TestEmailRequest
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Simple serializer for test email.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Simple serializer for test email.
+ */
+export const TestEmailRequestSchema = z.object({
+  email: z.email(),
+  subject: z.string().min(1).max(255).optional(),
+  message: z.string().min(1).optional(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type TestEmailRequest = z.infer<typeof TestEmailRequestSchema>

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

@@ -0,0 +1,19 @@
+/**
+ * Zod schema for Unsubscribe
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Simple serializer for unsubscribe.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Simple serializer for unsubscribe.
+ */
+export const UnsubscribeSchema = z.object({
+  subscription_id: z.int(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type Unsubscribe = z.infer<typeof UnsubscribeSchema>