@djangocfg/layouts 2.0.5 → 2.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/layouts",
-  "version": "2.0.5",
+  "version": "2.0.6",
   "description": "Simple, straightforward layout components for Next.js - import and use with props",
   "keywords": [
     "layouts",
@@ -74,6 +74,11 @@
       "import": "./src/pages/index.ts",
       "default": "./src/pages/index.ts"
     },
+    "./contexts": {
+      "types": "./src/contexts/index.ts",
+      "import": "./src/contexts/index.ts",
+      "default": "./src/contexts/index.ts"
+    },
     "./styles": "./src/styles/index.css",
     "./styles/dashboard": "./src/styles/dashboard.css"
   },
@@ -87,9 +92,9 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/api": "^1.4.35",
-    "@djangocfg/centrifugo": "^1.4.35",
-    "@djangocfg/ui": "^1.4.35",
+    "@djangocfg/api": "^1.4.36",
+    "@djangocfg/centrifugo": "^1.4.36",
+    "@djangocfg/ui": "^1.4.36",
     "@hookform/resolvers": "^5.2.0",
     "consola": "^3.4.2",
     "lucide-react": "^0.468.0",
@@ -108,7 +113,7 @@
     "react-ga4": "^2.1.0"
   },
   "devDependencies": {
-    "@djangocfg/typescript-config": "^1.4.35",
+    "@djangocfg/typescript-config": "^1.4.36",
     "@types/node": "^24.7.2",
     "@types/react": "19.2.2",
     "@types/react-dom": "19.2.1",

package/src/contexts/LeadsContext.tsx

@@ -0,0 +1,156 @@
+'use client';
+
+import React, { createContext, useContext, type ReactNode } from 'react';
+import { SWRConfig } from 'swr';
+import { api } from '@djangocfg/api';
+import {
+  useLeadsList,
+  useLeadsRetrieve,
+  useCreateLeadsCreate,
+  useUpdateLeadsUpdate,
+  usePartialUpdateLeadsPartialUpdate,
+  useDeleteLeadsDestroy,
+} from '@djangocfg/api';
+import type { API } from '@djangocfg/api';
+import type {
+  LeadSubmission,
+  LeadSubmissionRequest,
+  PatchedLeadSubmissionRequest,
+  PaginatedLeadSubmissionList,
+} from '@djangocfg/api';
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context Type
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface LeadsContextValue {
+  // List operations
+  leads: PaginatedLeadSubmissionList | undefined;
+  isLoadingLeads: boolean;
+  leadsError: Error | undefined;
+  refreshLeads: () => Promise<void>;
+
+  // CRUD operations
+  getLead: (id: number) => Promise<LeadSubmission | undefined>;
+  createLead: (data: LeadSubmissionRequest) => Promise<LeadSubmission>;
+  updateLead: (id: number, data: LeadSubmissionRequest) => Promise<LeadSubmission>;
+  partialUpdateLead: (id: number, data: PatchedLeadSubmissionRequest) => Promise<LeadSubmission>;
+  deleteLead: (id: number) => Promise<void>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context
+// ─────────────────────────────────────────────────────────────────────────
+
+const LeadsContext = createContext<LeadsContextValue | undefined>(undefined);
+
+// ─────────────────────────────────────────────────────────────────────────
+// Provider
+// ─────────────────────────────────────────────────────────────────────────
+
+export function LeadsProvider({ children }: { children: ReactNode }) {
+  const swrConfig = {
+    revalidateOnFocus: false,
+    revalidateOnReconnect: false,
+    revalidateIfStale: false,
+  };
+  
+  // List leads
+  const {
+    data: leads,
+    error: leadsError,
+    isLoading: isLoadingLeads,
+    mutate: mutateLeads,
+  } = useLeadsList({}, api as unknown as API);
+
+  const refreshLeads = async () => {
+    await mutateLeads();
+  };
+
+  // Mutations
+  const createMutation = useCreateLeadsCreate();
+  const updateMutation = useUpdateLeadsUpdate();
+  const partialUpdateMutation = usePartialUpdateLeadsPartialUpdate();
+  const deleteMutation = useDeleteLeadsDestroy();
+
+  // Get single lead
+  const getLead = async (id: number): Promise<LeadSubmission | undefined> => {
+    const { data } = useLeadsRetrieve(id, api as unknown as API);
+    return data;
+  };
+
+  // Create lead
+  const createLead = async (data: LeadSubmissionRequest): Promise<LeadSubmission> => {
+    const result = await createMutation(data, api as unknown as API);
+    await refreshLeads();
+    return result as LeadSubmission;
+  };
+
+  // Update lead
+  const updateLead = async (id: number, data: LeadSubmissionRequest): Promise<LeadSubmission> => {
+    const result = await updateMutation(id, data, api as unknown as API);
+    await refreshLeads();
+    return result as LeadSubmission;
+  };
+
+  // Partial update lead (currently not supported by generated API)
+  const partialUpdateLead = async (
+    id: number,
+    data: PatchedLeadSubmissionRequest
+  ): Promise<LeadSubmission> => {
+    // TODO: Fix generator to include data parameter for PATCH requests
+    // const result = await partialUpdateMutation(id, data, api as unknown as API);
+    // For now, fallback to full update
+    const result = await updateMutation(id, data as unknown as LeadSubmissionRequest, api as unknown as API);
+    await refreshLeads();
+    return result as LeadSubmission;
+  };
+
+  // Delete lead
+  const deleteLead = async (id: number): Promise<void> => {
+    await deleteMutation(id, api as unknown as API);
+    await refreshLeads();
+  };
+
+  const value: LeadsContextValue = {
+    leads,
+    isLoadingLeads,
+    leadsError,
+    refreshLeads,
+    getLead,
+    createLead,
+    updateLead,
+    partialUpdateLead,
+    deleteLead,
+  };
+
+  return (
+    <SWRConfig value={swrConfig}>
+      <LeadsContext.Provider value={value}>{children}</LeadsContext.Provider>
+    </SWRConfig>
+  );
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────
+
+export function useLeadsContext(): LeadsContextValue {
+  const context = useContext(LeadsContext);
+  if (!context) {
+    throw new Error('useLeadsContext must be used within LeadsProvider');
+  }
+  return context;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Re-export types for external use
+// ─────────────────────────────────────────────────────────────────────────
+
+export type {
+  LeadSubmission,
+  LeadSubmissionRequest,
+  PatchedLeadSubmissionRequest,
+  PaginatedLeadSubmissionList,
+};
+

package/src/contexts/NewsletterContext.tsx

@@ -0,0 +1,263 @@
+/**
+ * Newsletter Context
+ * 
+ * Manages newsletter campaigns and subscriptions using generated SWR hooks
+ * 
+ * Features:
+ * - Campaign management (create, update, delete, send)
+ * - Subscription management (subscribe, unsubscribe)
+ * - Campaign lists with pagination
+ * - Subscription lists with pagination
+ */
+
+"use client";
+
+import { createContext, useContext, ReactNode } from 'react';
+import { SWRConfig, useSWRConfig } from 'swr';
+import { api } from '@djangocfg/api';
+import {
+  useNewsletterCampaignsList,
+  useNewsletterCampaignsRetrieve,
+  useCreateNewsletterCampaignsCreate,
+  useUpdateNewsletterCampaignsUpdate,
+  usePartialUpdateNewsletterCampaignsPartialUpdate,
+  useDeleteNewsletterCampaignsDestroy,
+  useCreateNewsletterCampaignsSendCreate,
+  useNewsletterSubscriptionsList,
+  useCreateNewsletterSubscribeCreate,
+  useCreateNewsletterUnsubscribeCreate,
+} from '@djangocfg/api';
+import type { API } from '@djangocfg/api';
+import type {
+  NewsletterCampaign,
+  NewsletterCampaignRequest,
+  PatchedNewsletterCampaignRequest,
+  NewsletterSubscription,
+  PaginatedNewsletterCampaignList,
+  PaginatedNewsletterSubscriptionList,
+  SubscribeRequest,
+  SubscribeResponse,
+  UnsubscribeRequest,
+  SuccessResponse,
+  SendCampaignRequest,
+  SendCampaignResponse,
+} from '@djangocfg/api';
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context Type
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface NewsletterContextValue {
+  // Campaigns list state
+  campaigns: NewsletterCampaign[];
+  isLoadingCampaigns: boolean;
+  campaignsError: Error | null;
+  pagination?: {
+    count: number;
+    next: number | null;
+    previous: number | null;
+  };
+
+  // Campaign operations
+  getCampaign: (id: number) => { data?: NewsletterCampaign; error?: Error; isLoading: boolean };
+  createCampaign: (data: NewsletterCampaignRequest) => Promise<NewsletterCampaign>;
+  updateCampaign: (id: number, data: NewsletterCampaignRequest) => Promise<NewsletterCampaign>;
+  partialUpdateCampaign: (id: number, data: PatchedNewsletterCampaignRequest) => Promise<NewsletterCampaign>;
+  deleteCampaign: (id: number) => Promise<void>;
+  sendCampaign: (campaignId: number) => Promise<SendCampaignResponse>;
+
+  // Subscriptions list state
+  subscriptions: NewsletterSubscription[];
+  isLoadingSubscriptions: boolean;
+  subscriptionsError: Error | null;
+
+  // Subscription operations
+  subscribe: (data: SubscribeRequest) => Promise<SubscribeResponse>;
+  unsubscribe: (data: UnsubscribeRequest) => Promise<SuccessResponse>;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context
+// ─────────────────────────────────────────────────────────────────────────
+
+const NewsletterContext = createContext<NewsletterContextValue | undefined>(undefined);
+
+// ─────────────────────────────────────────────────────────────────────────
+// Provider Props
+// ─────────────────────────────────────────────────────────────────────────
+
+interface NewsletterProviderProps {
+  children: ReactNode;
+  page?: number;
+  pageSize?: number;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Provider Component
+// ─────────────────────────────────────────────────────────────────────────
+
+export function NewsletterProvider({ 
+  children, 
+  page = 1, 
+  pageSize = 100 
+}: NewsletterProviderProps) {
+  const { mutate } = useSWRConfig();
+  
+  const swrConfig = {
+    revalidateOnFocus: false,
+    revalidateOnReconnect: false,
+    revalidateIfStale: false,
+  };
+
+  // List params for proper revalidation
+  const listParams = { page, page_size: pageSize };
+
+  // Campaigns list
+  const {
+    data: campaignsData,
+    error: campaignsError,
+    isLoading: isLoadingCampaigns,
+  } = useNewsletterCampaignsList(listParams, api as unknown as API);
+
+  // Subscriptions list
+  const {
+    data: subscriptionsData,
+    error: subscriptionsError,
+    isLoading: isLoadingSubscriptions,
+  } = useNewsletterSubscriptionsList(listParams, api as unknown as API);
+
+  // Mutation hooks
+  const createCampaignMutation = useCreateNewsletterCampaignsCreate();
+  const updateCampaignMutation = useUpdateNewsletterCampaignsUpdate();
+  const partialUpdateCampaignMutation = usePartialUpdateNewsletterCampaignsPartialUpdate();
+  const deleteCampaignMutation = useDeleteNewsletterCampaignsDestroy();
+  const sendCampaignMutation = useCreateNewsletterCampaignsSendCreate();
+  const subscribeMutation = useCreateNewsletterSubscribeCreate();
+  const unsubscribeMutation = useCreateNewsletterUnsubscribeCreate();
+
+  // Extract data from paginated responses
+  const campaigns = campaignsData?.results || [];
+  const subscriptions = subscriptionsData?.results || [];
+
+  // Get single campaign
+  const getCampaign = (id: number) => {
+    const { data, error, isLoading } = useNewsletterCampaignsRetrieve(id, api as unknown as API);
+    return { data, error, isLoading };
+  };
+
+  // Create campaign
+  const createCampaign = async (data: NewsletterCampaignRequest): Promise<NewsletterCampaign> => {
+    const result = await createCampaignMutation(data, api as unknown as API);
+    await mutate(['cfg-newsletter-campaigns-list', listParams]);
+    return result as NewsletterCampaign;
+  };
+
+  // Update campaign (full)
+  const updateCampaign = async (id: number, data: NewsletterCampaignRequest): Promise<NewsletterCampaign> => {
+    const result = await updateCampaignMutation(id, data, api as unknown as API);
+    await mutate(['cfg-newsletter-campaigns-list', listParams]);
+    await mutate(['cfg-newsletter-campaigns-retrieve', id]);
+    return result as NewsletterCampaign;
+  };
+
+  // Partial update campaign (currently not supported by generated API)
+  const partialUpdateCampaign = async (id: number, data: PatchedNewsletterCampaignRequest): Promise<NewsletterCampaign> => {
+    // TODO: Fix generator to include data parameter for PATCH requests
+    // const result = await partialUpdateCampaignMutation(id, data, api as unknown as API);
+    // For now, fallback to full update
+    const result = await updateCampaignMutation(id, data as NewsletterCampaignRequest, api as unknown as API);
+    await mutate(['cfg-newsletter-campaigns-list', listParams]);
+    await mutate(['cfg-newsletter-campaigns-retrieve', id]);
+    return result as NewsletterCampaign;
+  };
+
+  // Delete campaign
+  const deleteCampaign = async (id: number): Promise<void> => {
+    await deleteCampaignMutation(id, api as unknown as API);
+    await mutate(['cfg-newsletter-campaigns-list', listParams]);
+  };
+
+  // Send campaign
+  const sendCampaign = async (campaignId: number): Promise<SendCampaignResponse> => {
+    const result = await sendCampaignMutation({ campaign_id: campaignId }, api as unknown as API);
+    await mutate(['cfg-newsletter-campaigns-list', listParams]);
+    await mutate(['cfg-newsletter-campaigns-retrieve', campaignId]);
+    return result as SendCampaignResponse;
+  };
+
+  // Subscribe
+  const subscribe = async (data: SubscribeRequest): Promise<SubscribeResponse> => {
+    const result = await subscribeMutation(data, api as unknown as API);
+    await mutate(['cfg-newsletter-subscriptions-list', listParams]);
+    return result as SubscribeResponse;
+  };
+
+  // Unsubscribe
+  const unsubscribe = async (data: UnsubscribeRequest): Promise<SuccessResponse> => {
+    const result = await unsubscribeMutation(data, api as unknown as API);
+    await mutate(['cfg-newsletter-subscriptions-list', listParams]);
+    return result as SuccessResponse;
+  };
+
+  const value: NewsletterContextValue = {
+    campaigns,
+    isLoadingCampaigns,
+    campaignsError,
+    pagination: campaignsData ? {
+      count: campaignsData.count,
+      next: campaignsData.next_page ?? null,
+      previous: campaignsData.previous_page ?? null,
+    } : undefined,
+    getCampaign,
+    createCampaign,
+    updateCampaign,
+    partialUpdateCampaign,
+    deleteCampaign,
+    sendCampaign,
+    subscriptions,
+    isLoadingSubscriptions,
+    subscriptionsError,
+    subscribe,
+    unsubscribe,
+  };
+
+  return (
+    <SWRConfig value={swrConfig}>
+      <NewsletterContext.Provider value={value}>
+        {children}
+      </NewsletterContext.Provider>
+    </SWRConfig>
+  );
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────
+
+export function useNewsletterContext(): NewsletterContextValue {
+  const context = useContext(NewsletterContext);
+  if (!context) {
+    throw new Error('useNewsletterContext must be used within NewsletterProvider');
+  }
+  return context;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Re-export types for external use
+// ─────────────────────────────────────────────────────────────────────────
+
+export type {
+  NewsletterCampaign,
+  NewsletterCampaignRequest,
+  PatchedNewsletterCampaignRequest,
+  NewsletterSubscription,
+  PaginatedNewsletterCampaignList,
+  PaginatedNewsletterSubscriptionList,
+  SubscribeRequest,
+  SubscribeResponse,
+  UnsubscribeRequest,
+  SuccessResponse,
+  SendCampaignRequest,
+  SendCampaignResponse,
+};
+