@djangocfg/api 1.0.1

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@djangocfg/api",
+  "version": "1.0.1",
+  "author": {
+    "name": "DjangoCFG",
+    "url": "https://djangocfg.com"
+  },
+  "license": "MIT",
+  "description": "Auto-generated TypeScript API clients",
+  "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"
+    },
+    "./cfg/contexts": {
+      "types": "./src/cfg/contexts/index.ts",
+      "import": "./src/cfg/contexts/index.ts",
+      "default": "./src/cfg/contexts/index.ts"
+    },
+    "./cfg/generated": {
+      "types": "./src/cfg/generated/index.ts",
+      "import": "./src/cfg/generated/index.ts",
+      "default": "./src/cfg/generated/index.ts"
+    },
+    "./cfg/generated/hooks": {
+      "types": "./src/cfg/generated/_utils/hooks/index.ts",
+      "import": "./src/cfg/generated/_utils/hooks/index.ts",
+      "default": "./src/cfg/generated/_utils/hooks/index.ts"
+    },
+    "./cfg/generated/fetchers": {
+      "types": "./src/cfg/generated/_utils/fetchers/index.ts",
+      "import": "./src/cfg/generated/_utils/fetchers/index.ts",
+      "default": "./src/cfg/generated/_utils/fetchers/index.ts"
+    },
+    "./cfg/generated/schemas": {
+      "types": "./src/cfg/generated/_utils/schemas/index.ts",
+      "import": "./src/cfg/generated/_utils/schemas/index.ts",
+      "default": "./src/cfg/generated/_utils/schemas/index.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "dev": "tsup --watch",
+    "check": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "consola": "^3.4.2",
+    "moment": "^2.30.1",
+    "p-retry": "^7.0.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "swr": "^2.3.0",
+    "zod": "^4.0.10"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "@types/react": "19.2.2",
+    "@types/react-dom": "19.2.1",
+    "@djangocfg/typescript-config": "^1.0.1",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "tsup": "^8.5.0",
+    "typescript": "5.8.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.11.1"
+  }
+}

package/src/cfg/BaseClient.ts

@@ -0,0 +1,56 @@
+/**
+ * Base Client for all API services
+ *
+ * Provides:
+ * - Centralized API instance with JWT token management
+ * - LocalStorage adapter for browser environments
+ * - Singleton pattern for API client
+ */
+
+import { API, LocalStorageAdapter } from './generated';
+
+/**
+ * Singleton API instance with JWT token management
+ * Uses LocalStorage for token persistence
+ */
+const api = new API(
+  typeof process !== 'undefined' && process.env?.NEXT_PUBLIC_API_URL
+    ? process.env.NEXT_PUBLIC_API_URL
+    : 'http://localhost:8000',
+  {
+    storage: new LocalStorageAdapter()
+  }
+);
+
+/**
+ * Base Client Class
+ *
+ * Service classes can extend this to access api instance
+ */
+export class BaseClient {
+  /**
+   * Authenticated API instance with JWT management
+   */
+  protected static api = api;
+}
+
+/**
+ * Export API instance for direct access
+ *
+ * Usage:
+ * ```typescript
+ * import { api } from '@djangocfg/api';
+ *
+ * // Set JWT tokens after login
+ * api.setToken('access-token', 'refresh-token');
+ *
+ * // Check authentication
+ * if (api.isAuthenticated()) {
+ *   // Make authenticated requests
+ * }
+ *
+ * // Clear tokens on logout
+ * api.clearTokens();
+ * ```
+ */
+export { api };

package/src/cfg/contexts/AccountsContext.tsx

@@ -0,0 +1,205 @@
+/**
+ * Accounts Context
+ * 
+ * Manages user authentication and profile operations using generated SWR hooks
+ * 
+ * Features:
+ * - OTP-based authentication
+ * - User profile management
+ * - Avatar upload
+ * - Profile updates
+ */
+
+"use client";
+
+import { createContext, useContext, ReactNode } from 'react';
+import { SWRConfig, useSWRConfig } from 'swr';
+import { api } from '../BaseClient';
+import {
+  useAccountsProfileRetrieve,
+  usePartialUpdateAccountsProfilePartialUpdate,
+  useUpdateAccountsProfileUpdateUpdate,
+  useCreateAccountsProfileAvatarCreate,
+  useCreateAccountsOtpRequestCreate,
+  useCreateAccountsOtpVerifyCreate,
+  useCreateAccountsTokenRefreshCreate,
+} from '../generated/_utils/hooks';
+import type { API } from '../generated';
+import type {
+  User,
+  UserProfileUpdateRequest,
+  PatchedUserProfileUpdateRequest,
+  OTPRequestRequest,
+  OTPVerifyRequest,
+  OTPRequestResponse,
+  OTPVerifyResponse,
+  TokenRefresh,
+} from '../generated/_utils/schemas';
+
+// Re-export schemas for external use
+export { PatchedUserProfileUpdateRequestSchema } from '../generated/_utils/schemas/PatchedUserProfileUpdateRequest.schema';
+export type { PatchedUserProfileUpdateRequest };
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context Type
+// ─────────────────────────────────────────────────────────────────────────
+
+export interface AccountsContextValue {
+  // Current user profile
+  profile?: User;
+  isLoadingProfile: boolean;
+  profileError: Error | null;
+
+  // Profile operations
+  updateProfile: (data: UserProfileUpdateRequest) => Promise<User>;
+  partialUpdateProfile: (data: PatchedUserProfileUpdateRequest) => Promise<User>;
+  uploadAvatar: (formData: FormData) => Promise<User>;
+  refreshProfile: () => Promise<User | undefined>;
+
+  // Authentication
+  requestOTP: (data: OTPRequestRequest) => Promise<OTPRequestResponse>;
+  verifyOTP: (data: OTPVerifyRequest) => Promise<OTPVerifyResponse>;
+  refreshToken: (refresh: string) => Promise<TokenRefresh>;
+  logout: () => void;
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Context
+// ─────────────────────────────────────────────────────────────────────────
+
+const AccountsContext = createContext<AccountsContextValue | undefined>(undefined);
+
+// ─────────────────────────────────────────────────────────────────────────
+// Provider Component
+// ─────────────────────────────────────────────────────────────────────────
+
+interface AccountsProviderProps {
+  children: ReactNode;
+}
+
+export function AccountsProvider({ children }: AccountsProviderProps) {
+  const { mutate } = useSWRConfig();
+  
+  // SWR config - disable auto-revalidation
+  const swrConfig = {
+    revalidateOnFocus: false,
+    revalidateOnReconnect: false,
+    revalidateIfStale: false,
+  };
+
+  // Get current user profile
+  const {
+    data: profile,
+    error: profileError,
+    isLoading: isLoadingProfile,
+    mutate: mutateProfile,
+  } = useAccountsProfileRetrieve(api as unknown as API);
+
+  // Mutation hooks
+  const updateMutation = useUpdateAccountsProfileUpdateUpdate();
+  const partialUpdateMutation = usePartialUpdateAccountsProfilePartialUpdate();
+  const avatarMutation = useCreateAccountsProfileAvatarCreate();
+  const otpRequestMutation = useCreateAccountsOtpRequestCreate();
+  const otpVerifyMutation = useCreateAccountsOtpVerifyCreate();
+  const tokenRefreshMutation = useCreateAccountsTokenRefreshCreate();
+
+  // Refresh profile
+  const refreshProfile = async (): Promise<User | undefined> => {
+    return await mutateProfile();
+  };
+
+  // Update profile (full)
+  const updateProfile = async (data: UserProfileUpdateRequest): Promise<User> => {
+    const result = await updateMutation(data, api as unknown as API);
+    await refreshProfile();
+    return result as User;
+  };
+
+  // Partial update profile
+  const partialUpdateProfile = async (data: PatchedUserProfileUpdateRequest): Promise<User> => {
+    const result = await partialUpdateMutation(data, api as unknown as API);
+    await refreshProfile();
+    return result as User;
+  };
+
+  // Upload avatar
+  const uploadAvatar = async (formData: FormData): Promise<User> => {
+    const result = await avatarMutation(formData, api as unknown as API);
+    await refreshProfile();
+    return result as User;
+  };
+
+  // Request OTP
+  const requestOTP = async (data: OTPRequestRequest): Promise<OTPRequestResponse> => {
+    const result = await otpRequestMutation(data, api as unknown as API);
+    return result as OTPRequestResponse;
+  };
+
+  // Verify OTP
+  const verifyOTP = async (data: OTPVerifyRequest): Promise<OTPVerifyResponse> => {
+    const result = await otpVerifyMutation(data, api as unknown as API);
+    
+    // Automatically save tokens after successful verification
+    if (result.access && result.refresh) {
+      api.setToken(result.access, result.refresh);
+      // Refresh profile to load user data with new token
+      await refreshProfile();
+    }
+    
+    return result as OTPVerifyResponse;
+  };
+
+  // Refresh token
+  const refreshToken = async (refresh: string): Promise<TokenRefresh> => {
+    const result = await tokenRefreshMutation({ refresh }, api as unknown as API);
+    
+    // Automatically save new access token
+    if (result.access) {
+      api.setToken(result.access, refresh);
+    }
+    
+    return result as TokenRefresh;
+  };
+
+  // Logout - clear tokens and invalidate profile cache
+  const logout = () => {
+    api.clearTokens();
+    // Invalidate profile cache to trigger re-fetch (which will fail and clear profile state)
+    mutateProfile(undefined, false);
+  };
+
+  const value: AccountsContextValue = {
+    profile,
+    isLoadingProfile,
+    profileError,
+    updateProfile,
+    partialUpdateProfile,
+    uploadAvatar,
+    refreshProfile,
+    requestOTP,
+    verifyOTP,
+    refreshToken,
+    logout,
+  };
+
+  return (
+    <SWRConfig value={swrConfig}>
+      <AccountsContext.Provider value={value}>
+        {children}
+      </AccountsContext.Provider>
+    </SWRConfig>
+  );
+}
+
+// ─────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────
+
+export function useAccountsContext(): AccountsContextValue {
+  const context = useContext(AccountsContext);
+  if (!context) {
+    throw new Error('useAccountsContext must be used within AccountsProvider');
+  }
+  return context;
+}
+

package/src/cfg/contexts/LeadsContext.tsx

@@ -0,0 +1,145 @@
+'use client';
+
+import React, { createContext, useContext, type ReactNode } from 'react';
+import { SWRConfig } from 'swr';
+import { api } from '../BaseClient';
+import {
+  useLeadsList,
+  useLeadsRetrieve,
+  useCreateLeadsCreate,
+  useUpdateLeadsUpdate,
+  usePartialUpdateLeadsPartialUpdate,
+  useDeleteLeadsDestroy,
+} from '../generated/_utils/hooks';
+import type { API } from '../generated';
+import type {
+  LeadSubmission,
+  LeadSubmissionRequest,
+  PatchedLeadSubmissionRequest,
+  PaginatedLeadSubmissionList,
+} from '../generated/_utils/schemas';
+
+// ─────────────────────────────────────────────────────────────────────────
+// 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;
+}
+