@djangocfg/ext-base 1.0.0 → 1.0.2

package/dist/index.d.cts

@@ -1,246 +0,0 @@
-import { ReactNode } from 'react';
-export { createExtensionAPI, getSharedAuthStorage } from './api.cjs';
-
-/**
- * Pagination types for extension packages
- */
-interface PaginatedResponse<T> {
-    results: T[];
-    count: number;
-    next?: number | null;
-    previous?: number | null;
-    next_page?: number | null;
-    previous_page?: number | null;
-    has_next?: boolean;
-    has_previous?: boolean;
-    total_pages?: number;
-}
-interface PaginationParams {
-    page?: number;
-    page_size?: number;
-    ordering?: string;
-}
-interface PaginationState {
-    page: number;
-    pageSize: number;
-    totalCount: number;
-    totalPages: number;
-    hasNext: boolean;
-    hasPrevious: boolean;
-}
-interface InfinitePaginationReturn<T> {
-    items: T[];
-    isLoading: boolean;
-    isLoadingMore: boolean;
-    error: any;
-    hasMore: boolean;
-    totalCount: number;
-    loadMore: () => void;
-    refresh: () => Promise<void>;
-}
-interface InfinitePaginationOptions {
-    pageSize?: number;
-    revalidateFirstPage?: boolean;
-    parallel?: boolean;
-}
-
-/**
- * Context and provider types for extension packages
- */
-
-interface ExtensionContextOptions {
-    revalidateOnFocus?: boolean;
-    revalidateOnReconnect?: boolean;
-    revalidateIfStale?: boolean;
-}
-interface ExtensionMetadata {
-    /**
-     * Unique extension name (e.g., 'newsletter', 'payments')
-     */
-    name: string;
-    /**
-     * Extension version (semver format recommended)
-     */
-    version: string;
-    /**
-     * Extension author name or organization
-     */
-    author: string;
-    /**
-     * Extension display name
-     */
-    displayName?: string;
-    /**
-     * Extension description
-     */
-    description?: string;
-    /**
-     * GitHub repository URL
-     * @example 'https://github.com/username/repo'
-     */
-    githubUrl?: string;
-    /**
-     * Extension homepage URL
-     */
-    homepage?: string;
-    /**
-     * License identifier (e.g., 'MIT', 'Apache-2.0')
-     */
-    license?: string;
-    /**
-     * Keywords for search and discovery
-     */
-    keywords?: string[];
-    /**
-     * Extension icon URL or emoji
-     * @example '📧' or 'https://example.com/icon.png'
-     */
-    icon?: string;
-    /**
-     * List of extension dependencies
-     * @example ['payments', 'auth']
-     */
-    dependencies?: string[];
-    /**
-     * Minimum required DjangoCFG version
-     */
-    minVersion?: string;
-}
-interface ExtensionProviderProps {
-    /**
-     * Extension metadata for registration
-     */
-    metadata: ExtensionMetadata;
-    /**
-     * SWR configuration options
-     */
-    options?: ExtensionContextOptions;
-    /**
-     * Child components
-     */
-    children: ReactNode;
-}
-
-/**
- * Error types for extension packages
- */
-interface ExtensionError {
-    message: string;
-    code?: string;
-    details?: unknown;
-    timestamp: string;
-}
-type ErrorHandler = (error: Error | ExtensionError) => void;
-
-/**
- * Logger types for extension packages
- */
-interface ExtensionLogger {
-    info: (...args: any[]) => void;
-    warn: (...args: any[]) => void;
-    error: (...args: any[]) => void;
-    debug: (...args: any[]) => void;
-    success: (...args: any[]) => void;
-}
-interface LoggerOptions {
-    tag: string;
-    level?: 'debug' | 'info' | 'warn' | 'error';
-    enabled?: boolean;
-}
-
-/**
- * Environment configuration utilities
- *
- * Safe to use in both client and server contexts.
- * Can be imported from server-safe entry point.
- */
-/**
- * Check if running in development mode
- */
-declare const isDevelopment: boolean;
-/**
- * Check if running in production mode
- */
-declare const isProduction: boolean;
-/**
- * Check if running in test mode
- */
-declare const isTest: boolean;
-/**
- * Check if this is a static build (Next.js export)
- */
-declare const isStaticBuild: boolean;
-/**
- * Check if code is running on client side
- * Safe to use in both client and server contexts
- */
-declare const isClient: boolean;
-/**
- * Check if code is running on server side
- * Safe to use in both client and server contexts
- */
-declare const isServer: boolean;
-/**
- * Get API URL from environment
- * Returns empty string if not set
- */
-declare const getApiUrl: () => string;
-/**
- * Environment configuration object
- */
-declare const env: {
-    readonly isDevelopment: boolean;
-    readonly isProduction: boolean;
-    readonly isTest: boolean;
-    readonly isStaticBuild: boolean;
-    readonly isClient: boolean;
-    readonly isServer: boolean;
-    readonly getApiUrl: () => string;
-};
-
-/**
- * Error handling utilities for extension packages
- */
-
-/**
- * Checks if an error is an ExtensionError
- */
-declare function isExtensionError(error: unknown): error is ExtensionError;
-/**
- * Creates an ExtensionError from any error
- */
-declare function createExtensionError(error: unknown, code?: string, details?: unknown): ExtensionError;
-/**
- * Formats an error message for display
- */
-declare function formatErrorMessage(error: unknown): string;
-/**
- * Safe error handler that logs and optionally calls callback
- */
-declare function handleExtensionError(error: unknown, logger?: {
-    error: (...args: any[]) => void;
-}, callback?: (error: ExtensionError) => void): void;
-
-/**
- * Logger factory for extension packages
- */
-
-/**
- * Creates a tagged logger for an extension
- *
- * @example
- * ```ts
- * // In extension package
- * export const logger = createExtensionLogger({
- *   tag: 'ext-newsletter',
- *   level: 'info'
- * });
- *
- * // Usage
- * logger.info('Campaign created:', campaignId);
- * logger.error('Failed to send campaign:', error);
- * ```
- */
-declare function createExtensionLogger(options: LoggerOptions): ExtensionLogger;
-
-export { type ErrorHandler, type ExtensionContextOptions, type ExtensionError, type ExtensionLogger, type ExtensionMetadata, type ExtensionProviderProps, type InfinitePaginationOptions, type InfinitePaginationReturn, type LoggerOptions, type PaginatedResponse, type PaginationParams, type PaginationState, createExtensionError, createExtensionLogger, env, formatErrorMessage, getApiUrl, handleExtensionError, isClient, isDevelopment, isExtensionError, isProduction, isServer, isStaticBuild, isTest };

package/dist/index.d.ts

@@ -1,246 +0,0 @@
-import { ReactNode } from 'react';
-export { createExtensionAPI, getSharedAuthStorage } from './api.js';
-
-/**
- * Pagination types for extension packages
- */
-interface PaginatedResponse<T> {
-    results: T[];
-    count: number;
-    next?: number | null;
-    previous?: number | null;
-    next_page?: number | null;
-    previous_page?: number | null;
-    has_next?: boolean;
-    has_previous?: boolean;
-    total_pages?: number;
-}
-interface PaginationParams {
-    page?: number;
-    page_size?: number;
-    ordering?: string;
-}
-interface PaginationState {
-    page: number;
-    pageSize: number;
-    totalCount: number;
-    totalPages: number;
-    hasNext: boolean;
-    hasPrevious: boolean;
-}
-interface InfinitePaginationReturn<T> {
-    items: T[];
-    isLoading: boolean;
-    isLoadingMore: boolean;
-    error: any;
-    hasMore: boolean;
-    totalCount: number;
-    loadMore: () => void;
-    refresh: () => Promise<void>;
-}
-interface InfinitePaginationOptions {
-    pageSize?: number;
-    revalidateFirstPage?: boolean;
-    parallel?: boolean;
-}
-
-/**
- * Context and provider types for extension packages
- */
-
-interface ExtensionContextOptions {
-    revalidateOnFocus?: boolean;
-    revalidateOnReconnect?: boolean;
-    revalidateIfStale?: boolean;
-}
-interface ExtensionMetadata {
-    /**
-     * Unique extension name (e.g., 'newsletter', 'payments')
-     */
-    name: string;
-    /**
-     * Extension version (semver format recommended)
-     */
-    version: string;
-    /**
-     * Extension author name or organization
-     */
-    author: string;
-    /**
-     * Extension display name
-     */
-    displayName?: string;
-    /**
-     * Extension description
-     */
-    description?: string;
-    /**
-     * GitHub repository URL
-     * @example 'https://github.com/username/repo'
-     */
-    githubUrl?: string;
-    /**
-     * Extension homepage URL
-     */
-    homepage?: string;
-    /**
-     * License identifier (e.g., 'MIT', 'Apache-2.0')
-     */
-    license?: string;
-    /**
-     * Keywords for search and discovery
-     */
-    keywords?: string[];
-    /**
-     * Extension icon URL or emoji
-     * @example '📧' or 'https://example.com/icon.png'
-     */
-    icon?: string;
-    /**
-     * List of extension dependencies
-     * @example ['payments', 'auth']
-     */
-    dependencies?: string[];
-    /**
-     * Minimum required DjangoCFG version
-     */
-    minVersion?: string;
-}
-interface ExtensionProviderProps {
-    /**
-     * Extension metadata for registration
-     */
-    metadata: ExtensionMetadata;
-    /**
-     * SWR configuration options
-     */
-    options?: ExtensionContextOptions;
-    /**
-     * Child components
-     */
-    children: ReactNode;
-}
-
-/**
- * Error types for extension packages
- */
-interface ExtensionError {
-    message: string;
-    code?: string;
-    details?: unknown;
-    timestamp: string;
-}
-type ErrorHandler = (error: Error | ExtensionError) => void;
-
-/**
- * Logger types for extension packages
- */
-interface ExtensionLogger {
-    info: (...args: any[]) => void;
-    warn: (...args: any[]) => void;
-    error: (...args: any[]) => void;
-    debug: (...args: any[]) => void;
-    success: (...args: any[]) => void;
-}
-interface LoggerOptions {
-    tag: string;
-    level?: 'debug' | 'info' | 'warn' | 'error';
-    enabled?: boolean;
-}
-
-/**
- * Environment configuration utilities
- *
- * Safe to use in both client and server contexts.
- * Can be imported from server-safe entry point.
- */
-/**
- * Check if running in development mode
- */
-declare const isDevelopment: boolean;
-/**
- * Check if running in production mode
- */
-declare const isProduction: boolean;
-/**
- * Check if running in test mode
- */
-declare const isTest: boolean;
-/**
- * Check if this is a static build (Next.js export)
- */
-declare const isStaticBuild: boolean;
-/**
- * Check if code is running on client side
- * Safe to use in both client and server contexts
- */
-declare const isClient: boolean;
-/**
- * Check if code is running on server side
- * Safe to use in both client and server contexts
- */
-declare const isServer: boolean;
-/**
- * Get API URL from environment
- * Returns empty string if not set
- */
-declare const getApiUrl: () => string;
-/**
- * Environment configuration object
- */
-declare const env: {
-    readonly isDevelopment: boolean;
-    readonly isProduction: boolean;
-    readonly isTest: boolean;
-    readonly isStaticBuild: boolean;
-    readonly isClient: boolean;
-    readonly isServer: boolean;
-    readonly getApiUrl: () => string;
-};
-
-/**
- * Error handling utilities for extension packages
- */
-
-/**
- * Checks if an error is an ExtensionError
- */
-declare function isExtensionError(error: unknown): error is ExtensionError;
-/**
- * Creates an ExtensionError from any error
- */
-declare function createExtensionError(error: unknown, code?: string, details?: unknown): ExtensionError;
-/**
- * Formats an error message for display
- */
-declare function formatErrorMessage(error: unknown): string;
-/**
- * Safe error handler that logs and optionally calls callback
- */
-declare function handleExtensionError(error: unknown, logger?: {
-    error: (...args: any[]) => void;
-}, callback?: (error: ExtensionError) => void): void;
-
-/**
- * Logger factory for extension packages
- */
-
-/**
- * Creates a tagged logger for an extension
- *
- * @example
- * ```ts
- * // In extension package
- * export const logger = createExtensionLogger({
- *   tag: 'ext-newsletter',
- *   level: 'info'
- * });
- *
- * // Usage
- * logger.info('Campaign created:', campaignId);
- * logger.error('Failed to send campaign:', error);
- * ```
- */
-declare function createExtensionLogger(options: LoggerOptions): ExtensionLogger;
-
-export { type ErrorHandler, type ExtensionContextOptions, type ExtensionError, type ExtensionLogger, type ExtensionMetadata, type ExtensionProviderProps, type InfinitePaginationOptions, type InfinitePaginationReturn, type LoggerOptions, type PaginatedResponse, type PaginationParams, type PaginationState, createExtensionError, createExtensionLogger, env, formatErrorMessage, getApiUrl, handleExtensionError, isClient, isDevelopment, isExtensionError, isProduction, isServer, isStaticBuild, isTest };

package/dist/index.js

@@ -1,3 +0,0 @@
-export { createExtensionError, createExtensionLogger, formatErrorMessage, handleExtensionError, isExtensionError } from './chunk-YQGNYUBX.js';
-export { createExtensionAPI, env, getApiUrl, getSharedAuthStorage, isClient, isDevelopment, isProduction, isServer, isStaticBuild, isTest } from './chunk-MECBWZG4.js';
-import './chunk-3RG5ZIWI.js';