@djangocfg/ext-payments 1.0.0

package/dist/index.js

@@ -0,0 +1 @@
+export { API, APIClient, APIError, APILogger, BalanceSchema, CookieStorageAdapter, CurrencySchema, DEFAULT_RETRY_CONFIG, enums_exports as Enums, models_exports as ExtPaymentsPaymentsTypes, FetchAdapter, fetchers_exports as Fetchers, LocalStorageAdapter, MemoryStorageAdapter, NetworkError, PAYMENT_EVENTS, PaginatedPaymentListListSchema, PaymentDetailSchema, PaymentListSchema, PaymentsLayout, REFRESH_TOKEN_KEY, schemas_exports as Schemas, TOKEN_KEY, TransactionSchema, apiPayments, clearAPITokens, closePaymentsDialog, configureAPI, createPaymentsPaymentsConfirmCreate, createPaymentsPaymentsCreateCreate, dispatchValidationError, formatZodError, getAPIInstance, getPaymentsBalanceRetrieve, getPaymentsCurrenciesList, getPaymentsPaymentsList, getPaymentsPaymentsRetrieve, getPaymentsPaymentsStatusRetrieve, getPaymentsTransactionsList, isAPIConfigured, onValidationError, openCreatePaymentDialog, openPaymentDetailsDialog, reconfigureAPI, resetAPI, shouldRetry, withRetry } from './chunk-5KY6HVXF.js';

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@djangocfg/ext-payments",
+  "version": "1.0.0",
+  "description": "Payments system extension for DjangoCFG",
+  "keywords": [
+    "django",
+    "djangocfg",
+    "extension",
+    "payments",
+    "stripe",
+    "billing",
+    "subscription",
+    "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/payments"
+  },
+  "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",
+    "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_payments/_utils/fetchers/ext_payments__payments.ts

@@ -0,0 +1,408 @@
+/**
+ * Typed fetchers for Payments
+ *
+ * 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 { BalanceSchema, type Balance } from '../schemas/Balance.schema'
+import { PaginatedPaymentListListSchema, type PaginatedPaymentListList } from '../schemas/PaginatedPaymentListList.schema'
+import { PaymentDetailSchema, type PaymentDetail } from '../schemas/PaymentDetail.schema'
+import { PaymentListSchema, type PaymentList } from '../schemas/PaymentList.schema'
+import { getAPIInstance } from '../../api-instance'
+
+/**
+ * Get user balance
+ *
+ * @method GET
+ * @path /cfg/payments/balance/
+ */
+export async function getPaymentsBalanceRetrieve(  client?: any
+): Promise<Balance> {
+  const api = client || getAPIInstance()
+  const response = await api.ext_payments_payments.balanceRetrieve()
+  try {
+    return BalanceSchema.parse(response)
+  } catch (error) {
+    // Zod validation error - log detailed information
+    consola.error('❌ Zod Validation Failed');
+    consola.box(`getPaymentsBalanceRetrieve\nPath: /cfg/payments/balance/\nMethod: GET`);
+
+    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: 'getPaymentsBalanceRetrieve',
+            path: '/cfg/payments/balance/',
+            method: 'GET',
+            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;
+  }
+}
+
+
+/**
+ * Get available currencies
+ *
+ * @method GET
+ * @path /cfg/payments/currencies/
+ */
+export async function getPaymentsCurrenciesList(  client?: any
+): Promise<any> {
+  const api = client || getAPIInstance()
+  const response = await api.ext_payments_payments.currenciesList()
+  return response
+}
+
+
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/payments/payments/
+ */
+export async function getPaymentsPaymentsList(  params?: { page?: number; page_size?: number },  client?: any
+): Promise<PaginatedPaymentListList> {
+  const api = client || getAPIInstance()
+  const response = await api.ext_payments_payments.paymentsList(params?.page, params?.page_size)
+  try {
+    return PaginatedPaymentListListSchema.parse(response)
+  } catch (error) {
+    // Zod validation error - log detailed information
+    consola.error('❌ Zod Validation Failed');
+    consola.box(`getPaymentsPaymentsList\nPath: /cfg/payments/payments/\nMethod: GET`);
+
+    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: 'getPaymentsPaymentsList',
+            path: '/cfg/payments/payments/',
+            method: 'GET',
+            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 GET
+ * @path /cfg/payments/payments/{id}/
+ */
+export async function getPaymentsPaymentsRetrieve(  id: string,  client?: any
+): Promise<PaymentDetail> {
+  const api = client || getAPIInstance()
+  const response = await api.ext_payments_payments.paymentsRetrieve(id)
+  try {
+    return PaymentDetailSchema.parse(response)
+  } catch (error) {
+    // Zod validation error - log detailed information
+    consola.error('❌ Zod Validation Failed');
+    consola.box(`getPaymentsPaymentsRetrieve\nPath: /cfg/payments/payments/{id}/\nMethod: GET`);
+
+    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: 'getPaymentsPaymentsRetrieve',
+            path: '/cfg/payments/payments/{id}/',
+            method: 'GET',
+            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 POST
+ * @path /cfg/payments/payments/{id}/confirm/
+ */
+export async function createPaymentsPaymentsConfirmCreate(  id: string,  client?: any
+): Promise<PaymentList> {
+  const api = client || getAPIInstance()
+  const response = await api.ext_payments_payments.paymentsConfirmCreate(id)
+  try {
+    return PaymentListSchema.parse(response)
+  } catch (error) {
+    // Zod validation error - log detailed information
+    consola.error('❌ Zod Validation Failed');
+    consola.box(`createPaymentsPaymentsConfirmCreate\nPath: /cfg/payments/payments/{id}/confirm/\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: 'createPaymentsPaymentsConfirmCreate',
+            path: '/cfg/payments/payments/{id}/confirm/',
+            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;
+  }
+}
+
+
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/payments/payments/{id}/status/
+ */
+export async function getPaymentsPaymentsStatusRetrieve(  id: string,  client?: any
+): Promise<PaymentList> {
+  const api = client || getAPIInstance()
+  const response = await api.ext_payments_payments.paymentsStatusRetrieve(id)
+  try {
+    return PaymentListSchema.parse(response)
+  } catch (error) {
+    // Zod validation error - log detailed information
+    consola.error('❌ Zod Validation Failed');
+    consola.box(`getPaymentsPaymentsStatusRetrieve\nPath: /cfg/payments/payments/{id}/status/\nMethod: GET`);
+
+    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: 'getPaymentsPaymentsStatusRetrieve',
+            path: '/cfg/payments/payments/{id}/status/',
+            method: 'GET',
+            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 POST
+ * @path /cfg/payments/payments/create/
+ */
+export async function createPaymentsPaymentsCreateCreate(  client?: any
+): Promise<PaymentList> {
+  const api = client || getAPIInstance()
+  const response = await api.ext_payments_payments.paymentsCreateCreate()
+  try {
+    return PaymentListSchema.parse(response)
+  } catch (error) {
+    // Zod validation error - log detailed information
+    consola.error('❌ Zod Validation Failed');
+    consola.box(`createPaymentsPaymentsCreateCreate\nPath: /cfg/payments/payments/create/\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: 'createPaymentsPaymentsCreateCreate',
+            path: '/cfg/payments/payments/create/',
+            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;
+  }
+}
+
+
+/**
+ * Get user transactions
+ *
+ * @method GET
+ * @path /cfg/payments/transactions/
+ */
+export async function getPaymentsTransactionsList(  params?: { limit?: number; offset?: number; type?: string },  client?: any
+): Promise<any> {
+  const api = client || getAPIInstance()
+  const response = await api.ext_payments_payments.transactionsList(params?.limit, params?.offset, params?.type)
+  return response
+}
+
+

package/src/api/generated/ext_payments/_utils/fetchers/index.ts

@@ -0,0 +1,28 @@
+/**
+ * Typed Fetchers - Universal API functions
+ *
+ * Auto-generated from OpenAPI specification.
+ * These functions work in any JavaScript environment.
+ *
+ * Features:
+ * - Runtime validation with Zod
+ * - Type-safe parameters and responses
+ * - Works with any data-fetching library (SWR, React Query, etc)
+ * - Server Component compatible
+ *
+ * Usage:
+ * ```typescript
+ * import * as fetchers from './fetchers'
+ *
+ * // Direct usage
+ * const user = await fetchers.getUser(1)
+ *
+ * // With SWR
+ * const { data } = useSWR('user-1', () => fetchers.getUser(1))
+ *
+ * // With React Query
+ * const { data } = useQuery(['user', 1], () => fetchers.getUser(1))
+ * ```
+ */
+
+export * from './ext_payments__payments'

package/src/api/generated/ext_payments/_utils/hooks/ext_payments__payments.ts

@@ -0,0 +1,147 @@
+'use client';
+
+/**
+ * SWR Hooks for Payments
+ *
+ * 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_payments__payments'
+import type { API } from '../../index'
+import type { Balance } from '../schemas/Balance.schema'
+import type { PaginatedPaymentListList } from '../schemas/PaginatedPaymentListList.schema'
+import type { PaymentDetail } from '../schemas/PaymentDetail.schema'
+import type { PaymentList } from '../schemas/PaymentList.schema'
+
+/**
+ * Get user balance
+ *
+ * @method GET
+ * @path /cfg/payments/balance/
+ */
+export function usePaymentsBalanceRetrieve(client?: API): ReturnType<typeof useSWR<Balance>> {
+  return useSWR<Balance>(
+    'cfg-payments-balance',
+    () => Fetchers.getPaymentsBalanceRetrieve(client)
+  )
+}
+
+
+/**
+ * Get available currencies
+ *
+ * @method GET
+ * @path /cfg/payments/currencies/
+ */
+export function usePaymentsCurrenciesList(client?: API): ReturnType<typeof useSWR<any>> {
+  return useSWR<any>(
+    'cfg-payments-currencies',
+    () => Fetchers.getPaymentsCurrenciesList(client)
+  )
+}
+
+
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/payments/payments/
+ */
+export function usePaymentsPaymentsList(params?: { page?: number; page_size?: number }, client?: API): ReturnType<typeof useSWR<PaginatedPaymentListList>> {
+  return useSWR<PaginatedPaymentListList>(
+    params ? ['cfg-payments-payments', params] : 'cfg-payments-payments',
+    () => Fetchers.getPaymentsPaymentsList(params, client)
+  )
+}
+
+
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/payments/payments/{id}/
+ */
+export function usePaymentsPaymentsRetrieve(id: string, client?: API): ReturnType<typeof useSWR<PaymentDetail>> {
+  return useSWR<PaymentDetail>(
+    ['cfg-payments-payment', id],
+    () => Fetchers.getPaymentsPaymentsRetrieve(id, client)
+  )
+}
+
+
+/**
+ * API operation
+ *
+ * @method POST
+ * @path /cfg/payments/payments/{id}/confirm/
+ */
+export function useCreatePaymentsPaymentsConfirmCreate() {
+  const { mutate } = useSWRConfig()
+
+  return async (id: string, client?: API): Promise<PaymentList> => {
+    const result = await Fetchers.createPaymentsPaymentsConfirmCreate(id, client)
+    // Revalidate related queries
+    mutate('cfg-payments-payments-confirm')
+    return result
+  }
+}
+
+
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/payments/payments/{id}/status/
+ */
+export function usePaymentsPaymentsStatusRetrieve(id: string, client?: API): ReturnType<typeof useSWR<PaymentList>> {
+  return useSWR<PaymentList>(
+    ['cfg-payments-payments-statu', id],
+    () => Fetchers.getPaymentsPaymentsStatusRetrieve(id, client)
+  )
+}
+
+
+/**
+ * API operation
+ *
+ * @method POST
+ * @path /cfg/payments/payments/create/
+ */
+export function useCreatePaymentsPaymentsCreateCreate() {
+  const { mutate } = useSWRConfig()
+
+  return async (client?: API): Promise<PaymentList> => {
+    const result = await Fetchers.createPaymentsPaymentsCreateCreate(client)
+    // Revalidate related queries
+    mutate('cfg-payments-payments')
+    return result
+  }
+}
+
+
+/**
+ * Get user transactions
+ *
+ * @method GET
+ * @path /cfg/payments/transactions/
+ */
+export function usePaymentsTransactionsList(params?: { limit?: number; offset?: number; type?: string }, client?: API): ReturnType<typeof useSWR<any>> {
+  return useSWR<any>(
+    params ? ['cfg-payments-transactions', params] : 'cfg-payments-transactions',
+    () => Fetchers.getPaymentsTransactionsList(params, client)
+  )
+}
+
+

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

@@ -0,0 +1,28 @@
+'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_payments__payments'