@djangocfg/ext-base 1.0.0 → 1.0.2

package/templates/extension-template/README.md.template

@@ -0,0 +1,62 @@
+<div align="center">
+
+![DjangoCFG Extension Preview](https://unpkg.com/@djangocfg/ext-__NAME__@latest/preview.png)
+
+</div>
+
+# @djangocfg/ext-__NAME__
+
+__DESCRIPTION__
+
+**Part of [DjangoCFG](https://djangocfg.com)** — modern Django framework for production-ready SaaS applications.
+
+## Features
+
+- Feature 1
+- Feature 2
+- Feature 3
+
+## Install
+
+```bash
+pnpm add @djangocfg/ext-__NAME__
+```
+
+## Usage
+
+### Provider Setup
+
+```typescript
+import { __PROVIDER_NAME__ExtensionProvider } from '@djangocfg/ext-__NAME__/hooks';
+
+export default function RootLayout({ children }) {
+  return (
+    <__PROVIDER_NAME__ExtensionProvider>
+      {children}
+    </__PROVIDER_NAME__ExtensionProvider>
+  );
+}
+```
+
+### Using Hooks
+
+```typescript
+'use client';
+
+import { use__PROVIDER_NAME__ } from '@djangocfg/ext-__NAME__/hooks';
+
+export function MyComponent() {
+  const context = use__PROVIDER_NAME__();
+
+  return <div>Your component</div>;
+}
+```
+
+## License
+
+MIT
+
+## Links
+
+- [DjangoCFG Documentation](https://djangocfg.com)
+- [GitHub](https://github.com/markolofsen/django-cfg)

package/templates/extension-template/package.json.template

@@ -0,0 +1,73 @@
+{
+  "name": "@djangocfg/ext-__NAME__",
+  "version": "1.0.0",
+  "description": "__DESCRIPTION__",
+  "keywords": [
+    "django",
+    "djangocfg",
+    "extension",
+    "__NAME__",
+    "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/__NAME__"
+  },
+  "bugs": {
+    "url": "https://github.com/markolofsen/django-cfg/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./hooks": {
+      "types": "./dist/hooks.d.ts",
+      "import": "./dist/hooks.js",
+      "require": "./dist/hooks.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "preview.png"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "check": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@djangocfg/ext-base": "latest",
+    "@djangocfg/ui-core": "latest",
+    "@djangocfg/ui-nextjs": "latest",
+    "consola": "^3.4.2",
+    "lucide-react": "^0.545.0",
+    "next": "^15.5.7",
+    "react": "^18 || ^19",
+    "swr": "^2.3.7"
+  },
+  "devDependencies": {
+    "@djangocfg/ext-base": "latest",
+    "@djangocfg/typescript-config": "latest",
+    "@types/node": "^24.7.2",
+    "@types/react": "^19.0.0",
+    "consola": "^3.4.2",
+    "swr": "^2.3.7",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3"
+  }
+}

package/templates/extension-template/src/config.ts

@@ -0,0 +1,35 @@
+/**
+ * __DISPLAY_NAME__ extension configuration
+ */
+
+import { createExtensionConfig } from '@djangocfg/ext-base';
+import packageJson from '../package.json';
+
+export const extensionConfig = createExtensionConfig(packageJson, {
+  name: '__NAME__',
+  displayName: '__DISPLAY_NAME__',
+  icon: '__ICON__',
+  category: '__CATEGORY__',
+  features: [
+    'Feature 1',
+    'Feature 2',
+    'Feature 3',
+  ],
+  minVersion: '2.0.0',
+  examples: [
+    {
+      title: 'Basic Usage',
+      description: 'How to use this extension',
+      code: `import { __PROVIDER_NAME__ExtensionProvider } from '@djangocfg/ext-__NAME__/hooks';
+
+export default function RootLayout({ children }) {
+  return (
+    <__PROVIDER_NAME__ExtensionProvider>
+      {children}
+    </__PROVIDER_NAME__ExtensionProvider>
+  );
+}`,
+      language: 'tsx',
+    },
+  ],
+});

package/templates/extension-template/src/contexts/__PROVIDER_NAME__Context.tsx

@@ -0,0 +1,41 @@
+'use client';
+
+/**
+ * Main __DISPLAY_NAME__ Context
+ */
+
+import { createContext, useContext, type ReactNode } from 'react';
+
+interface __PROVIDER_NAME__ContextValue {
+  // Add your context values here
+}
+
+const __PROVIDER_NAME__Context = createContext<__PROVIDER_NAME__ContextValue | undefined>(undefined);
+
+export interface __PROVIDER_NAME__ProviderProps {
+  children: ReactNode;
+}
+
+export function __PROVIDER_NAME__Provider({ children }: __PROVIDER_NAME__ProviderProps) {
+  const value: __PROVIDER_NAME__ContextValue = {
+    // Implement your context logic here
+  };
+
+  return (
+    <__PROVIDER_NAME__Context.Provider value={value}>
+      {children}
+    </__PROVIDER_NAME__Context.Provider>
+  );
+}
+
+export function use__PROVIDER_NAME__() {
+  const context = useContext(__PROVIDER_NAME__Context);
+  if (context === undefined) {
+    throw new Error('use__PROVIDER_NAME__ must be used within __PROVIDER_NAME__Provider');
+  }
+  return context;
+}
+
+export function use__PROVIDER_NAME__Optional() {
+  return useContext(__PROVIDER_NAME__Context);
+}

package/templates/extension-template/src/contexts/__PROVIDER_NAME__ExtensionProvider.tsx

@@ -0,0 +1,36 @@
+/**
+ * Main __DISPLAY_NAME__ Extension Provider
+ *
+ * Wraps all contexts with ExtensionProvider for proper registration
+ */
+
+'use client';
+
+import type { ReactNode } from 'react';
+import { ExtensionProvider } from '@djangocfg/ext-base/hooks';
+import { extensionConfig } from '../config';
+import { __PROVIDER_NAME__Provider } from './__PROVIDER_NAME__Context';
+
+interface __PROVIDER_NAME__ExtensionProviderProps {
+  children: ReactNode;
+}
+
+/**
+ * Main provider for __DISPLAY_NAME__ extension
+ *
+ * @example
+ * ```tsx
+ * <__PROVIDER_NAME__ExtensionProvider>
+ *   <YourApp />
+ * </__PROVIDER_NAME__ExtensionProvider>
+ * ```
+ */
+export function __PROVIDER_NAME__ExtensionProvider({ children }: __PROVIDER_NAME__ExtensionProviderProps) {
+  return (
+    <ExtensionProvider metadata={extensionConfig}>
+      <__PROVIDER_NAME__Provider>
+        {children}
+      </__PROVIDER_NAME__Provider>
+    </ExtensionProvider>
+  );
+}

package/templates/extension-template/src/hooks/index.ts

@@ -0,0 +1,27 @@
+'use client';
+
+/**
+ * @djangocfg/ext-__NAME__/hooks
+ * React hooks and client-only components
+ *
+ * This entry point includes React components, hooks, and SWR functionality.
+ * NOT safe for Server Components.
+ */
+
+// ============================================================================
+// Re-export everything from main entry (types, constants)
+// ============================================================================
+export * from '../index';
+
+// ============================================================================
+// Contexts & Hooks
+// ============================================================================
+export {
+  __PROVIDER_NAME__ExtensionProvider,
+} from '../contexts/__PROVIDER_NAME__ExtensionProvider';
+
+export {
+  __PROVIDER_NAME__Provider,
+  use__PROVIDER_NAME__,
+  use__PROVIDER_NAME__Optional,
+} from '../contexts/__PROVIDER_NAME__Context';

package/templates/extension-template/src/index.ts

@@ -0,0 +1,17 @@
+/**
+ * @djangocfg/ext-__NAME__
+ * Server-safe entry point (no client-only code)
+ *
+ * Contains types and server-safe exports only.
+ * For React hooks and SWR, use '@djangocfg/ext-__NAME__/hooks'
+ */
+
+// ============================================================================
+// Config
+// ============================================================================
+export { extensionConfig } from './config';
+
+// ============================================================================
+// Types
+// ============================================================================
+export type * from './types';

package/templates/extension-template/src/types.ts

@@ -0,0 +1,7 @@
+/**
+ * Extension TypeScript types
+ */
+
+export interface ExtensionData {
+  // Add your types here
+}

package/templates/extension-template/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "@djangocfg/typescript-config/nextjs.json",
+  "compilerOptions": {
+    "outDir": "dist"
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/extension-template/tsup.config.ts

@@ -0,0 +1,26 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: {
+    index: 'src/index.ts',
+    hooks: 'src/hooks/index.ts',
+  },
+  format: ['esm', 'cjs'],
+  dts: true,
+  splitting: false,
+  sourcemap: true,
+  clean: true,
+  external: [
+    'react',
+    'react-dom',
+    'next',
+    'lucide-react',
+    '@djangocfg/ext-base',
+    '@djangocfg/ui-nextjs',
+    'swr',
+    'consola',
+  ],
+  banner: {
+    js: "'use client';",
+  },
+});

package/dist/api.cjs

@@ -1,41 +0,0 @@
-'use strict';
-
-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
-process.env.NODE_ENV === "development";
-process.env.NODE_ENV === "production";
-process.env.NODE_ENV === "test";
-var isStaticBuild = process.env.NEXT_PUBLIC_STATIC_BUILD === "true";
-var getApiUrl = () => {
-  return process.env.NEXT_PUBLIC_API_URL || "";
-};
-
-// 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;
-  }
-}
-
-exports.createExtensionAPI = createExtensionAPI;
-exports.getSharedAuthStorage = getSharedAuthStorage;

package/dist/api.d.cts

@@ -1,35 +0,0 @@
-/**
- * Factory for creating extension API instances
- *
- * Provides consistent API setup across all extensions with shared authentication
- */
-/**
- * Creates an extension API instance with shared authentication storage
- *
- * @param APIClass - The generated API class from your extension
- * @returns Configured API instance with shared auth storage
- *
- * @example
- * ```typescript
- * // In your extension's api/index.ts
- * import { API } from './generated/ext_newsletter';
- * import { createExtensionAPI } from '@djangocfg/ext-base/api';
- *
- * export const apiNewsletter = createExtensionAPI(API);
- * ```
- */
-declare function createExtensionAPI<T>(APIClass: new (url: string, options?: any) => T): T;
-/**
- * Get shared authentication storage from accounts API
- *
- * @returns Storage instance or undefined if not available
- *
- * @example
- * ```typescript
- * const storage = getSharedAuthStorage();
- * const api = new API(apiUrl, { storage });
- * ```
- */
-declare function getSharedAuthStorage(): any | undefined;
-
-export { createExtensionAPI, getSharedAuthStorage };

package/dist/api.d.ts

@@ -1,35 +0,0 @@
-/**
- * Factory for creating extension API instances
- *
- * Provides consistent API setup across all extensions with shared authentication
- */
-/**
- * Creates an extension API instance with shared authentication storage
- *
- * @param APIClass - The generated API class from your extension
- * @returns Configured API instance with shared auth storage
- *
- * @example
- * ```typescript
- * // In your extension's api/index.ts
- * import { API } from './generated/ext_newsletter';
- * import { createExtensionAPI } from '@djangocfg/ext-base/api';
- *
- * export const apiNewsletter = createExtensionAPI(API);
- * ```
- */
-declare function createExtensionAPI<T>(APIClass: new (url: string, options?: any) => T): T;
-/**
- * Get shared authentication storage from accounts API
- *
- * @returns Storage instance or undefined if not available
- *
- * @example
- * ```typescript
- * const storage = getSharedAuthStorage();
- * const api = new API(apiUrl, { storage });
- * ```
- */
-declare function getSharedAuthStorage(): any | undefined;
-
-export { createExtensionAPI, getSharedAuthStorage };

package/dist/api.js

@@ -1,2 +0,0 @@
-export { createExtensionAPI, getSharedAuthStorage } from './chunk-MECBWZG4.js';
-import './chunk-3RG5ZIWI.js';

package/dist/auth.cjs

@@ -1,10 +0,0 @@
-'use strict';
-
-var auth = require('@djangocfg/api/auth');
-
-
-
-Object.defineProperty(exports, "useAuth", {
-  enumerable: true,
-  get: function () { return auth.useAuth; }
-});

package/dist/auth.d.cts

@@ -1 +0,0 @@
-export { AuthContextType, UserProfile, useAuth } from '@djangocfg/api/auth';

package/dist/auth.d.ts

@@ -1 +0,0 @@
-export { AuthContextType, UserProfile, useAuth } from '@djangocfg/api/auth';

package/dist/auth.js

@@ -1,2 +0,0 @@
-import './chunk-3RG5ZIWI.js';
-export { useAuth } from '@djangocfg/api/auth';

package/dist/chunk-3RG5ZIWI.js

@@ -1,8 +0,0 @@
-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');
-});
-
-export { __require };

package/dist/chunk-MECBWZG4.js

@@ -1,44 +0,0 @@
-import { __require } from './chunk-3RG5ZIWI.js';
-
-// 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;
-  }
-}
-
-export { createExtensionAPI, env, getApiUrl, getSharedAuthStorage, isClient, isDevelopment, isProduction, isServer, isStaticBuild, isTest };

package/dist/chunk-YQGNYUBX.js

@@ -1,67 +0,0 @@
-import { createConsola } from 'consola';
-
-// 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 isDevelopment = 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 = isDevelopment ? LEVEL_MAP[level] : LEVEL_MAP.error;
-  const consola = createConsola({
-    level: logLevel
-  }).withTag(tag);
-  return {
-    info: (...args) => consola.info(...args),
-    warn: (...args) => consola.warn(...args),
-    error: (...args) => consola.error(...args),
-    debug: (...args) => consola.debug(...args),
-    success: (...args) => consola.success(...args)
-  };
-}
-
-export { createExtensionError, createExtensionLogger, formatErrorMessage, handleExtensionError, isExtensionError };