@djangocfg/ext-base 1.0.0 → 1.0.1

package/dist/hooks.js

@@ -1,65 +0,0 @@
-import { createExtensionLogger } from './chunk-YQGNYUBX.js';
-export { createExtensionError, createExtensionLogger, formatErrorMessage, handleExtensionError, isExtensionError } from './chunk-YQGNYUBX.js';
-import { isDevelopment } from './chunk-MECBWZG4.js';
-export { createExtensionAPI, env, getApiUrl, getSharedAuthStorage, isClient, isDevelopment, isProduction, isServer, isStaticBuild, isTest } from './chunk-MECBWZG4.js';
-import './chunk-3RG5ZIWI.js';
-import { createContext, useEffect, useContext } from 'react';
-import { jsx } from 'react/jsx-runtime';
-import { SWRConfig } from 'swr';
-
-function createExtensionContext({
-  displayName,
-  errorMessage
-}) {
-  const Context = createContext(void 0);
-  Context.displayName = displayName;
-  const Provider = ({ value, children }) => {
-    return /* @__PURE__ */ jsx(Context.Provider, { value, children });
-  };
-  const useContextHook = () => {
-    const context = useContext(Context);
-    if (context === void 0) {
-      throw new Error(
-        errorMessage || `use${displayName} must be used within ${displayName}Provider`
-      );
-    }
-    return context;
-  };
-  return {
-    Context,
-    Provider,
-    useContext: useContextHook
-  };
-}
-var DEFAULT_OPTIONS = {
-  revalidateOnFocus: false,
-  revalidateOnReconnect: false,
-  revalidateIfStale: false
-};
-var registeredExtensions = /* @__PURE__ */ new Set();
-function ExtensionProvider({ children, metadata, options = {} }) {
-  const config = { ...DEFAULT_OPTIONS, ...options };
-  useEffect(() => {
-    if (registeredExtensions.has(metadata.name)) {
-      if (isDevelopment) {
-        console.warn(
-          `[ExtensionProvider] Extension "${metadata.name}" is already registered. This might indicate that the extension is mounted multiple times.`
-        );
-      }
-      return;
-    }
-    registeredExtensions.add(metadata.name);
-    if (isDevelopment) {
-      const logger = createExtensionLogger({ tag: "ext-base", level: "info" });
-      logger.info(
-        `Extension registered: ${metadata.displayName || metadata.name} v${metadata.version}`
-      );
-    }
-    return () => {
-      registeredExtensions.delete(metadata.name);
-    };
-  }, [metadata.name, metadata.version, metadata.displayName]);
-  return /* @__PURE__ */ jsx(SWRConfig, { value: config, children });
-}
-
-export { ExtensionProvider, createExtensionContext };

package/dist/index.cjs

@@ -1,131 +0,0 @@
-'use strict';
-
-var consola = require('consola');
-
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-// src/config/env.ts
-var isDevelopment = process.env.NODE_ENV === "development";
-var isProduction = process.env.NODE_ENV === "production";
-var isTest = process.env.NODE_ENV === "test";
-var isStaticBuild = process.env.NEXT_PUBLIC_STATIC_BUILD === "true";
-var isClient = typeof window !== "undefined";
-var isServer = !isClient;
-var getApiUrl = () => {
-  return process.env.NEXT_PUBLIC_API_URL || "";
-};
-var env = {
-  isDevelopment,
-  isProduction,
-  isTest,
-  isStaticBuild,
-  isClient,
-  isServer,
-  getApiUrl
-};
-
-// src/api/createExtensionAPI.ts
-function createExtensionAPI(APIClass) {
-  let storage;
-  try {
-    const { api: accountsApi } = __require("@djangocfg/api");
-    storage = accountsApi._storage;
-  } catch (error) {
-    storage = void 0;
-  }
-  const apiUrl = isStaticBuild ? "" : getApiUrl();
-  return new APIClass(apiUrl, storage ? { storage } : void 0);
-}
-function getSharedAuthStorage() {
-  try {
-    const { api: accountsApi } = __require("@djangocfg/api");
-    return accountsApi._storage;
-  } catch (error) {
-    return void 0;
-  }
-}
-
-// src/utils/errors.ts
-function isExtensionError(error) {
-  return typeof error === "object" && error !== null && "message" in error && "timestamp" in error;
-}
-function createExtensionError(error, code, details) {
-  const message = error instanceof Error ? error.message : String(error);
-  return {
-    message,
-    code,
-    details,
-    timestamp: (/* @__PURE__ */ new Date()).toISOString()
-  };
-}
-function formatErrorMessage(error) {
-  if (isExtensionError(error)) {
-    return error.code ? `[${error.code}] ${error.message}` : error.message;
-  }
-  if (error instanceof Error) {
-    return error.message;
-  }
-  return String(error);
-}
-function handleExtensionError(error, logger, callback) {
-  const extensionError = isExtensionError(error) ? error : createExtensionError(error);
-  if (logger) {
-    logger.error("Extension error:", extensionError);
-  }
-  if (callback) {
-    callback(extensionError);
-  }
-}
-var isDevelopment2 = process.env.NODE_ENV === "development";
-var LEVEL_MAP = {
-  debug: 4,
-  info: 3,
-  warn: 2,
-  error: 1
-};
-function createExtensionLogger(options) {
-  const { tag, level = "info", enabled = true } = options;
-  if (!enabled) {
-    const noop = () => {
-    };
-    return {
-      info: noop,
-      warn: noop,
-      error: noop,
-      debug: noop,
-      success: noop
-    };
-  }
-  const logLevel = isDevelopment2 ? LEVEL_MAP[level] : LEVEL_MAP.error;
-  const consola$1 = consola.createConsola({
-    level: logLevel
-  }).withTag(tag);
-  return {
-    info: (...args) => consola$1.info(...args),
-    warn: (...args) => consola$1.warn(...args),
-    error: (...args) => consola$1.error(...args),
-    debug: (...args) => consola$1.debug(...args),
-    success: (...args) => consola$1.success(...args)
-  };
-}
-
-exports.createExtensionAPI = createExtensionAPI;
-exports.createExtensionError = createExtensionError;
-exports.createExtensionLogger = createExtensionLogger;
-exports.env = env;
-exports.formatErrorMessage = formatErrorMessage;
-exports.getApiUrl = getApiUrl;
-exports.getSharedAuthStorage = getSharedAuthStorage;
-exports.handleExtensionError = handleExtensionError;
-exports.isClient = isClient;
-exports.isDevelopment = isDevelopment;
-exports.isExtensionError = isExtensionError;
-exports.isProduction = isProduction;
-exports.isServer = isServer;
-exports.isStaticBuild = isStaticBuild;
-exports.isTest = isTest;

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';