frappe-nextjs 0.1.0

package/README.md

@@ -0,0 +1,90 @@
+# frappe-nextjs
+
+A TypeScript package to manage **Next.js** frontends for **Frappe** apps — with full SSR support, React hooks, and CLI tools.
+
+Think of it as [Doppio](https://github.com/NagariaHussain/doppio) but purpose-built for Next.js.
+
+## Features
+
+- 🚀 **CLI** — Scaffold, build, and deploy Next.js apps inside Frappe custom apps
+- 🔌 **API Client** — Type-safe Frappe REST API client with CRUD, method calls, file uploads
+- ⚛️ **React Hooks** — SWR-based hooks for data fetching, auth, and file uploads
+- 🖥️ **SSR** — Full server-side rendering via supervisor-managed Node.js server
+- 📦 **Static Export** — Simple static build that works on Frappe Cloud
+- 📖 **TypeScript** — Fully typed, first-class TypeScript support
+
+## Quick Start
+
+```bash
+# Install
+npm install -g frappe-nextjs
+
+# Scaffold (inside your bench directory)
+frappe-nextjs init --app myapp --name dashboard --mode ssr
+
+# Start development
+cd apps/myapp/dashboard && npm run dev
+```
+
+## Usage
+
+### React Hooks
+
+```tsx
+import { useFrappeDocList, useFrappeAuth } from 'frappe-nextjs';
+
+function TodoList() {
+  const { isLoggedIn, user } = useFrappeAuth();
+  const { data, isLoading } = useFrappeDocList({
+    doctype: 'ToDo',
+    fields: ['name', 'description', 'status'],
+    filters: [['status', '=', 'Open']],
+    limit: 20,
+  });
+
+  return (/* ... */);
+}
+```
+
+### Server Components (SSR)
+
+```tsx
+// app/todos/page.tsx — Server Component
+import { frappe } from "@/lib/frappe";
+
+export default async function TodosPage() {
+  const todos = await frappe.getDocList({
+    doctype: "ToDo",
+    fields: ["name", "description"],
+  });
+
+  return (
+    <ul>
+      {todos.map((t) => (
+        <li key={t.name}>{t.description}</li>
+      ))}
+    </ul>
+  );
+}
+```
+
+## CLI Commands
+
+| Command                   | Description                                  |
+| ------------------------- | -------------------------------------------- |
+| `frappe-nextjs init`      | Scaffold Next.js project inside a Frappe app |
+| `frappe-nextjs build`     | Build and deploy (static or SSR)             |
+| `frappe-nextjs setup-ssr` | Generate supervisor + nginx configs          |
+
+## Documentation
+
+- [Getting Started](docs/01-getting-started.md)
+- [Architecture](docs/02-architecture.md)
+- [Connecting to Frappe](docs/03-connecting-to-frappe.md)
+- [Data Fetching & SSR](docs/04-data-fetching-and-ssr.md)
+- [Build & Deployment](docs/05-build-and-deployment.md)
+- [API Reference](docs/06-api-reference.md)
+
+## License
+
+MIT

package/dist/bin/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/bin/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":""}

package/dist/bin/cli.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const init_1 = require("../build/init");
+const build_1 = require("../build/build");
+const supervisor_generator_1 = require("../build/supervisor-generator");
+const nginx_generator_1 = require("../build/nginx-generator");
+const program = new commander_1.Command();
+// Read package version
+// Compiled output is at dist/bin/cli.js, so go up two levels to reach root
+const pkgPath = path.join(__dirname, '..', '..', 'package.json');
+const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+program
+    .name('frappe-nextjs')
+    .description('CLI to manage Next.js frontends for Frappe apps')
+    .version(pkg.version);
+// ─── init command ────────────────────────────────────────────────
+program
+    .command('init')
+    .description('Scaffold a new Next.js project inside a Frappe app')
+    .requiredOption('--app <app-name>', 'Frappe app name (directory name in apps/)')
+    .requiredOption('--name <spa-name>', 'Name for the SPA and route prefix (e.g. dashboard)')
+    .option('--mode <mode>', 'Deployment mode: ssr | static', 'ssr')
+    .option('--frappe-port <port>', 'Frappe webserver port', '8000')
+    .action(async (opts) => {
+    const benchPath = findBenchPath();
+    const appPath = path.join(benchPath, 'apps', opts.app);
+    if (!fs.existsSync(appPath)) {
+        console.error(`❌ App '${opts.app}' not found at ${appPath}`);
+        process.exit(1);
+    }
+    await (0, init_1.initNextJsProject)({
+        appPath,
+        appName: opts.app,
+        spaName: opts.name,
+        mode: opts.mode,
+        frappePort: parseInt(opts.frappePort),
+    });
+});
+// ─── build command ───────────────────────────────────────────────
+program
+    .command('build')
+    .description('Build and deploy the Next.js project for Frappe')
+    .requiredOption('--app <app-name>', 'Frappe app name')
+    .requiredOption('--name <spa-name>', 'SPA name')
+    .option('--mode <mode>', 'Build mode: ssr | static', 'ssr')
+    .action(async (opts) => {
+    const benchPath = findBenchPath();
+    const appPath = path.join(benchPath, 'apps', opts.app);
+    await (0, build_1.buildNextJsProject)({
+        appPath,
+        appName: opts.app,
+        spaName: opts.name,
+        mode: opts.mode,
+    });
+});
+// ─── setup-ssr command ───────────────────────────────────────────
+program
+    .command('setup-ssr')
+    .description('Generate supervisor and nginx configurations for SSR')
+    .requiredOption('--app <app-name>', 'Frappe app name')
+    .requiredOption('--name <spa-name>', 'SPA name')
+    .option('--port <port>', 'Next.js server port', '3100')
+    .option('--user <user>', 'System user to run the process as')
+    .action((opts) => {
+    const benchPath = findBenchPath();
+    const appPath = path.join(benchPath, 'apps', opts.app);
+    const spaPath = path.join(appPath, opts.name);
+    if (!fs.existsSync(spaPath)) {
+        console.error(`❌ SPA directory not found: ${spaPath}`);
+        process.exit(1);
+    }
+    const port = parseInt(opts.port);
+    // Generate supervisor config
+    const supervisorConfig = (0, supervisor_generator_1.generateSupervisorConfig)({
+        spaPath,
+        spaName: opts.name,
+        port,
+        benchPath,
+        user: opts.user,
+    });
+    // Save supervisor config
+    const supervisorFile = path.join(benchPath, 'config', `nextjs-${opts.name}.conf`);
+    fs.mkdirSync(path.join(benchPath, 'config'), { recursive: true });
+    fs.writeFileSync(supervisorFile, supervisorConfig, 'utf-8');
+    console.log(`📄 Supervisor config saved to: ${supervisorFile}`);
+    console.log(supervisorConfig);
+    console.log((0, supervisor_generator_1.getSupervisorInstructions)(opts.name, benchPath));
+    // Generate nginx config
+    const nginxConfig = (0, nginx_generator_1.generateNginxConfig)({
+        spaName: opts.name,
+        port,
+        spaPath,
+    });
+    const nginxFile = path.join(benchPath, 'config', `nextjs-${opts.name}-nginx.conf`);
+    fs.writeFileSync(nginxFile, nginxConfig, 'utf-8');
+    console.log(`📄 Nginx config saved to: ${nginxFile}`);
+    console.log(nginxConfig);
+    console.log((0, nginx_generator_1.getNginxInstructions)(opts.name));
+});
+// ─── Helper: find bench root ─────────────────────────────────────
+function findBenchPath() {
+    // Look upward for a directory containing 'sites' and 'apps' dirs
+    let dir = process.cwd();
+    for (let i = 0; i < 10; i++) {
+        if (fs.existsSync(path.join(dir, 'sites')) &&
+            fs.existsSync(path.join(dir, 'apps'))) {
+            return dir;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break; // reached root
+        dir = parent;
+    }
+    // Fallback: assume we're somewhere in the bench
+    console.warn('⚠️  Could not detect bench root. Using current directory.');
+    return process.cwd();
+}
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":"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"}

package/dist/build/boilerplates.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Template strings for scaffolding a Next.js project inside a Frappe app.
+ */
+export declare function getContextPyBoilerplate(spaName: string): string;
+export declare function getLayoutBoilerplate(spaName: string): string;
+export declare function getProvidersBoilerplate(): string;
+export declare function getHomePageBoilerplate(spaName: string): string;
+export declare function getGlobalsCssBoilerplate(): string;
+export declare function getServerClientBoilerplate(): string;
+export declare function getEnvBoilerplate(frappePort?: number): string;
+export declare function getHtmlEntryBoilerplate(spaName: string): string;
+//# sourceMappingURL=boilerplates.d.ts.map

package/dist/build/boilerplates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boilerplates.d.ts","sourceRoot":"","sources":["../../src/build/boilerplates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgC/D;AAID,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA0B5D;AAID,wBAAgB,uBAAuB,IAAI,MAAM,CAmBhD;AAID,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA6C9D;AAID,wBAAgB,wBAAwB,IAAI,MAAM,CAyDjD;AAID,wBAAgB,0BAA0B,IAAI,MAAM,CAoBnD;AAID,wBAAgB,iBAAiB,CAAC,UAAU,GAAE,MAAa,GAAG,MAAM,CAYnE;AAID,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoB/D"}

package/dist/build/boilerplates.js

@@ -0,0 +1,261 @@
+"use strict";
+/**
+ * Template strings for scaffolding a Next.js project inside a Frappe app.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getContextPyBoilerplate = getContextPyBoilerplate;
+exports.getLayoutBoilerplate = getLayoutBoilerplate;
+exports.getProvidersBoilerplate = getProvidersBoilerplate;
+exports.getHomePageBoilerplate = getHomePageBoilerplate;
+exports.getGlobalsCssBoilerplate = getGlobalsCssBoilerplate;
+exports.getServerClientBoilerplate = getServerClientBoilerplate;
+exports.getEnvBoilerplate = getEnvBoilerplate;
+exports.getHtmlEntryBoilerplate = getHtmlEntryBoilerplate;
+// ─── Context Python File (served by Frappe as www page) ─────────
+function getContextPyBoilerplate(spaName) {
+    return `import frappe
+from frappe.utils import get_system_timezone
+
+no_cache = 1
+
+
+def get_context():
+    csrf_token = frappe.sessions.get_csrf_token()
+    context = frappe._dict()
+    context.boot = get_boot()
+    context.boot.csrf_token = csrf_token
+    return context
+
+
+@frappe.whitelist(methods=["POST"], allow_guest=True)
+def get_context_for_dev():
+    if not frappe.conf.developer_mode:
+        frappe.throw("This method is only meant for developer mode")
+    return get_boot()
+
+
+def get_boot():
+    return frappe._dict(
+        {
+            "frappe_version": frappe.version,
+            "site_name": frappe.local.site,
+            "read_only_mode": frappe.flags.read_only,
+            "system_timezone": get_system_timezone(),
+        }
+    )
+`;
+}
+// ─── Next.js Layout (Root) ──────────────────────────────────────
+function getLayoutBoilerplate(spaName) {
+    return `import type { Metadata } from 'next';
+import { Providers } from './providers';
+import './globals.css';
+
+export const metadata: Metadata = {
+  title: '${spaName}',
+  description: 'Powered by Next.js + Frappe',
+};
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en">
+      <body>
+        <Providers>
+          {children}
+        </Providers>
+      </body>
+    </html>
+  );
+}
+`;
+}
+// ─── Providers Component ────────────────────────────────────────
+function getProvidersBoilerplate() {
+    return `'use client';
+
+import { FrappeProvider } from 'frappe-nextjs';
+
+export function Providers({ children }: { children: React.ReactNode }) {
+  return (
+    <FrappeProvider
+      config={{
+        // In dev mode, Next.js rewrites proxy /api/* to Frappe.
+        // In production (static export), set NEXT_PUBLIC_FRAPPE_URL.
+        baseUrl: process.env.NEXT_PUBLIC_FRAPPE_URL || '',
+      }}
+    >
+      {children}
+    </FrappeProvider>
+  );
+}
+`;
+}
+// ─── Home Page ──────────────────────────────────────────────────
+function getHomePageBoilerplate(spaName) {
+    return `'use client';
+
+import { useFrappeCall, useFrappeAuth } from 'frappe-nextjs';
+
+export default function Home() {
+  const { isLoggedIn, user, login, logout, isLoading: authLoading } = useFrappeAuth();
+  const { data: pingData, isLoading: pingLoading } = useFrappeCall({
+    method: 'frappe.ping',
+  });
+
+  return (
+    <main style={{ maxWidth: '640px', margin: '4rem auto', padding: '0 1rem' }}>
+      <h1 style={{ fontSize: '2rem', marginBottom: '1rem' }}>
+        🚀 ${spaName}
+      </h1>
+
+      <section style={{ marginBottom: '2rem' }}>
+        <h2>Frappe Connection</h2>
+        {pingLoading ? (
+          <p>Pinging Frappe...</p>
+        ) : (
+          <p>
+            ✅ Connected! Response: <code>{JSON.stringify(pingData)}</code>
+          </p>
+        )}
+      </section>
+
+      <section>
+        <h2>Authentication</h2>
+        {authLoading ? (
+          <p>Checking auth...</p>
+        ) : isLoggedIn ? (
+          <div>
+            <p>Logged in as: <strong>{user}</strong></p>
+            <button onClick={logout}>Logout</button>
+          </div>
+        ) : (
+          <p>Not logged in. Visit <a href="/login">Frappe login</a> first.</p>
+        )}
+      </section>
+    </main>
+  );
+}
+`;
+}
+// ─── Globals CSS ────────────────────────────────────────────────
+function getGlobalsCssBoilerplate() {
+    return `* {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+html,
+body {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto,
+    Oxygen-Sans, Ubuntu, Cantarell, 'Helvetica Neue', sans-serif;
+  color: #1a1a2e;
+  background-color: #f8f9fa;
+  line-height: 1.6;
+}
+
+a {
+  color: #0070f3;
+  text-decoration: none;
+}
+
+a:hover {
+  text-decoration: underline;
+}
+
+button {
+  cursor: pointer;
+  padding: 0.5rem 1rem;
+  border: 1px solid #ddd;
+  border-radius: 4px;
+  background: white;
+  font-size: 0.875rem;
+}
+
+button:hover {
+  background: #f0f0f0;
+}
+
+code {
+  background: #eee;
+  padding: 0.15rem 0.4rem;
+  border-radius: 3px;
+  font-size: 0.875rem;
+}
+
+h1, h2, h3 {
+  margin-bottom: 0.5rem;
+}
+
+section {
+  padding: 1.5rem;
+  background: white;
+  border-radius: 8px;
+  border: 1px solid #e5e7eb;
+  margin-bottom: 1rem;
+}
+`;
+}
+// ─── Lib/frappe.ts (Server Client) ──────────────────────────────
+function getServerClientBoilerplate() {
+    return `import { createServerClient } from 'frappe-nextjs/ssr';
+
+/**
+ * Server-side Frappe client for use in Server Components,
+ * Route Handlers, and Server Actions.
+ *
+ * Requires these environment variables:
+ *   FRAPPE_URL          - e.g. http://localhost:8000
+ *   FRAPPE_API_KEY      - API Key from Frappe User settings
+ *   FRAPPE_API_SECRET   - API Secret from Frappe User settings
+ */
+export const frappe = createServerClient({
+  baseUrl: process.env.FRAPPE_URL || 'http://localhost:8000',
+  token: {
+    apiKey: process.env.FRAPPE_API_KEY || '',
+    apiSecret: process.env.FRAPPE_API_SECRET || '',
+  },
+});
+`;
+}
+// ─── .env.local ─────────────────────────────────────────────────
+function getEnvBoilerplate(frappePort = 8000) {
+    return `# Frappe backend URL (used by Next.js rewrites in dev and by server client)
+FRAPPE_URL=http://localhost:${frappePort}
+
+# API credentials for server-side data fetching (SSR)
+# Generate these in Frappe: User > API Access > Generate Keys
+FRAPPE_API_KEY=
+FRAPPE_API_SECRET=
+
+# Public Frappe URL for client-side (only needed if different from proxy)
+# NEXT_PUBLIC_FRAPPE_URL=
+`;
+}
+// ─── HTML entry point for static export ─────────────────────────
+function getHtmlEntryBoilerplate(spaName) {
+    return `{%- extends "templates/web.html" -%}
+
+{%- block page_content -%}
+<div id="__next"></div>
+
+<script>
+  window.csrf_token = '{{ csrf_token }}';
+  window.frappe_boot = {{ boot | tojson }};
+</script>
+
+{%- for file in frappe.utils.get_assets_json().get('${spaName}', {}).get('js', []) -%}
+<script type="module" src="{{ file }}"></script>
+{%- endfor -%}
+
+{%- for file in frappe.utils.get_assets_json().get('${spaName}', {}).get('css', []) -%}
+<link rel="stylesheet" href="{{ file }}">
+{%- endfor -%}
+{%- endblock -%}
+`;
+}
+//# sourceMappingURL=boilerplates.js.map

package/dist/build/boilerplates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boilerplates.js","sourceRoot":"","sources":["../../src/build/boilerplates.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAIH,0DAgCC;AAID,oDA0BC;AAID,0DAmBC;AAID,wDA6CC;AAID,4DAyDC;AAID,gEAoBC;AAID,8CAYC;AAID,0DAoBC;AArQD,mEAAmE;AAEnE,SAAgB,uBAAuB,CAAC,OAAe;IACrD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BR,CAAC;AACF,CAAC;AAED,mEAAmE;AAEnE,SAAgB,oBAAoB,CAAC,OAAe;IAClD,OAAO;;;;;YAKG,OAAO;;;;;;;;;;;;;;;;;;;CAmBlB,CAAC;AACF,CAAC;AAED,mEAAmE;AAEnE,SAAgB,uBAAuB;IACrC,OAAO;;;;;;;;;;;;;;;;;CAiBR,CAAC;AACF,CAAC;AAED,mEAAmE;AAEnE,SAAgB,sBAAsB,CAAC,OAAe;IACpD,OAAO;;;;;;;;;;;;;aAaI,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BnB,CAAC;AACF,CAAC;AAED,mEAAmE;AAEnE,SAAgB,wBAAwB;IACtC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDR,CAAC;AACF,CAAC;AAED,mEAAmE;AAEnE,SAAgB,0BAA0B;IACxC,OAAO;;;;;;;;;;;;;;;;;;CAkBR,CAAC;AACF,CAAC;AAED,mEAAmE;AAEnE,SAAgB,iBAAiB,CAAC,aAAqB,IAAI;IACzD,OAAO;8BACqB,UAAU;;;;;;;;;CASvC,CAAC;AACF,CAAC;AAED,mEAAmE;AAEnE,SAAgB,uBAAuB,CAAC,OAAe;IACrD,OAAO;;;;;;;;;;sDAU6C,OAAO;;;;sDAIP,OAAO;;;;CAI5D,CAAC;AACF,CAAC"}

package/dist/build/build.d.ts

@@ -0,0 +1,27 @@
+interface BuildOptions {
+    /** Absolute path to the Frappe app root */
+    appPath: string;
+    /** Python package name of the app */
+    appName: string;
+    /** SPA name */
+    spaName: string;
+    /** Build mode */
+    mode: 'ssr' | 'static';
+}
+/**
+ * Build the Next.js project and deploy it for Frappe.
+ *
+ * Static mode:
+ *   1. Runs `next build` (output: 'export')
+ *   2. Copies static files to <app>/public/<spa>/
+ *   3. Copies index.html to <app>/www/<spa>.html
+ *   4. Injects CSRF token
+ *
+ * SSR mode:
+ *   1. Runs `next build` (output: 'standalone')
+ *   2. Copies static assets for nginx to serve
+ *   3. Prints setup instructions for supervisor/nginx
+ */
+export declare function buildNextJsProject(options: BuildOptions): Promise<void>;
+export {};
+//# sourceMappingURL=build.d.ts.map

package/dist/build/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/build/build.ts"],"names":[],"mappings":"AAIA,UAAU,YAAY;IACpB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;CACxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B7E"}