@econneq/auth-cli 1.0.1 → 1.0.2

package/README.md

@@ -0,0 +1,67 @@
+# @econneq/auth-cli
+
+Interactive scaffolder for new Econneq Auth integrations. One command, a few prompts, a working `auth/` folder.
+
+## Position in the install order
+
+```
+auth-cli   (independent — no SDK packages required to run it)
+```
+
+The CLI is standalone. You **don't** need `auth-core`, `auth-react`, or anything else installed to run it — it just *generates* files that depend on those packages. You'll install those after the CLI scaffolds your config.
+
+## Use without installing
+
+```bash
+npx @econneq/auth-cli init
+# or, after global install:
+npm install -g @econneq/auth-cli
+econneq-auth init
+```
+
+The single command available today is `init`.
+
+## What `init` asks
+
+| Prompt | Notes |
+|---|---|
+| Application name | Free text — used in generated comments |
+| Auth API base URL | e.g. `https://auth.example.com` |
+| Enable multi-tenant mode? | yes/no |
+| Framework | Next.js, Remix, Vite, … |
+| Token storage strategy | cookie / localStorage / memory |
+| Auth methods | password, otp, oauth, … (multi-select) |
+
+## What `init` creates
+
+```
+src/auth/auth.config.ts     # defineAuthConfig(...) populated from your answers
+src/auth/provider.tsx       # <AuthProvider> wrapper ready to mount
+proxy.ts                    # Next.js middleware (only when Next.js was picked)
+```
+
+After the CLI finishes, install the SDK packages it referenced:
+
+```bash
+npm install @econneq/auth-core @econneq/auth-react
+# Next.js apps:
+npm install @econneq/auth-nextjs
+# If you want the hosted UI screens:
+npm install @econneq/auth-ui
+```
+
+Then mount the generated `Providers` component in your root layout and you're done.
+
+## Build
+
+```bash
+npm run build      # tsup → dist/bin.js (and dist/index.js)
+npm run typecheck
+npm run dev        # tsup --watch
+```
+
+## Notes
+
+- `bin` is set to `dist/bin.js`, so `npx @econneq/auth-cli` and a global `econneq-auth` shim both work after publish.
+- The generator is template-based — edit `src/templates/` to change the scaffolded output.
+- Runs on Node — no React or browser globals required.

package/dist/bin.js

@@ -0,0 +1,246 @@
+#!/usr/bin/env node
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/commands/init.ts
+var import_prompts = __toESM(require("prompts"));
+var import_chalk = __toESM(require("chalk"));
+var import_ora = __toESM(require("ora"));
+var import_fs_extra = __toESM(require("fs-extra"));
+var import_path = __toESM(require("path"));
+
+// src/templates/auth.config.template.ts
+function generateAuthConfig(a) {
+  const methods = a.authMethods.map((m) => `'${m}'`).join(", ");
+  return `import { defineAuthConfig } from '@econneq/auth-react'
+
+export const authConfig = defineAuthConfig({
+  appName:    '${a.appName}',
+  apiBaseUrl: process.env.NEXT_PUBLIC_AUTH_API_URL ?? '${a.apiBaseUrl}',
+  tenantMode: ${a.tenantMode},
+
+  routing: {
+    strategy: 'subdomain',
+  },
+
+  auth: {
+    methods:        [${methods}],
+    mfa:            false,
+    rememberSession: true,
+  },
+
+  storage: {
+    strategy: '${a.storage}',
+  },
+
+  tokens: {
+    autoRefresh:         true,
+    accessTokenExpiry:   900,
+    refreshTokenExpiry:  604800,
+  },
+
+  security: {
+    csrf:                true,
+    sameSite:            'lax',
+    rotateRefreshTokens: true,
+  },
+
+  ui: {
+    hostedPages: true,
+    darkMode:    false,
+  },
+})
+`;
+}
+
+// src/templates/provider.template.ts
+function generateProviderFile(a) {
+  const pkg = a.framework === "nextjs" ? "@econneq/auth-react" : "@econneq/auth-react";
+  return `'use client'
+import { AuthProvider } from '${pkg}'
+import { authConfig }   from './auth.config'
+import type { ReactNode } from 'react'
+
+export function AppAuthProvider({ children }: { children: ReactNode }) {
+  return (
+    <AuthProvider config={authConfig}>
+      {children}
+    </AuthProvider>
+  )
+}
+`;
+}
+
+// src/templates/proxy.template.ts
+function generateProxyFile(_a) {
+  return `/**
+ * proxy.ts \u2014 Econneq Auth Middleware
+ * Generated by: npx econneq-auth init
+ */
+import { createAuthMiddleware } from '@econneq/auth-react/middleware'
+import { authConfig } from './src/auth/auth.config'
+
+export default createAuthMiddleware(authConfig, {
+  protectedRoutes:  ['/dashboard', '/app', '/admin'],
+  publicRoutes:     ['/auth/login', '/auth/register', '/auth/select-tenant'],
+  loginUrl:         '/auth/login',
+  tenantSelectUrl:  '/auth/select-tenant',
+})
+
+export const config = {
+  matcher: ['/((?!_next/static|_next/image|favicon\\.ico|.*\\.[a-zA-Z]{2,5}$).*)'],
+}
+`;
+}
+
+// src/templates/env.template.ts
+function generateEnvFile(a) {
+  return `# @econneq-auth \u2014 generated by npx econneq-auth init
+NEXT_PUBLIC_AUTH_API_URL=${a.apiBaseUrl}
+NEXT_PUBLIC_ROOT_DOMAIN=yourdomain.com
+
+# Optional: set these server-side only (not NEXT_PUBLIC_)
+# AUTH_SECRET=your-jwt-secret
+# AUTH_CSRF_SECRET=your-csrf-secret
+`;
+}
+
+// src/commands/init.ts
+async function initCommand() {
+  console.log("\n" + import_chalk.default.bold.cyan("\u{1F510} @econneq-auth init") + "\n");
+  const answers = await (0, import_prompts.default)([
+    {
+      type: "text",
+      name: "appName",
+      message: "Application name?",
+      initial: "My Enterprise App"
+    },
+    {
+      type: "text",
+      name: "apiBaseUrl",
+      message: "Auth API base URL?",
+      initial: "https://api.yourdomain.com"
+    },
+    {
+      type: "confirm",
+      name: "tenantMode",
+      message: "Enable multi-tenant mode?",
+      initial: true
+    },
+    {
+      type: "select",
+      name: "framework",
+      message: "Framework?",
+      choices: [
+        { title: "Next.js (App Router)", value: "nextjs" },
+        { title: "React (Vite/CRA)", value: "react" }
+      ]
+    },
+    {
+      type: "select",
+      name: "storage",
+      message: "Token storage strategy?",
+      choices: [
+        { title: "Cookies (recommended for SSR)", value: "cookies" },
+        { title: "localStorage", value: "localStorage" },
+        { title: "Memory", value: "memory" }
+      ]
+    },
+    {
+      type: "multiselect",
+      name: "authMethods",
+      message: "Auth methods to enable?",
+      choices: [
+        { title: "Password", value: "password", selected: true },
+        { title: "OTP", value: "otp", selected: false },
+        { title: "Google", value: "google", selected: false },
+        { title: "Magic Link", value: "magic-link", selected: false }
+      ]
+    }
+  ]);
+  if (!answers.appName) {
+    console.log(import_chalk.default.red("\nAborted."));
+    process.exit(1);
+  }
+  const spinner = (0, import_ora.default)("Generating auth files\u2026").start();
+  try {
+    const srcDir = import_path.default.join(process.cwd(), "src");
+    await import_fs_extra.default.outputFile(
+      import_path.default.join(srcDir, "auth", "auth.config.ts"),
+      generateAuthConfig(answers)
+    );
+    await import_fs_extra.default.outputFile(
+      import_path.default.join(srcDir, "auth", "provider.tsx"),
+      generateProviderFile(answers)
+    );
+    if (answers.framework === "nextjs") {
+      await import_fs_extra.default.outputFile(
+        import_path.default.join(process.cwd(), "proxy.ts"),
+        generateProxyFile(answers)
+      );
+    }
+    await import_fs_extra.default.outputFile(
+      import_path.default.join(process.cwd(), ".env.local"),
+      generateEnvFile(answers)
+    );
+    spinner.succeed("Auth files generated!");
+    console.log("\n" + import_chalk.default.bold("Files created:"));
+    console.log("  " + import_chalk.default.green("src/auth/auth.config.ts"));
+    console.log("  " + import_chalk.default.green("src/auth/provider.tsx"));
+    if (answers.framework === "nextjs") {
+      console.log("  " + import_chalk.default.green("proxy.ts"));
+    }
+    console.log("  " + import_chalk.default.green(".env.local"));
+    console.log("\n" + import_chalk.default.bold("Next steps:"));
+    if (answers.framework === "nextjs") {
+      console.log(`  1. npm install @econneq/auth-react @econneq/auth-ui`);
+      console.log(`  2. Wrap your root layout with <AuthProvider config={authConfig}>`);
+      console.log(`  3. Ensure proxy.ts is at your project root`);
+    } else {
+      console.log(`  1. npm install @econneq/auth-react @econneq/auth-ui`);
+      console.log(`  2. Wrap your App with <AuthProvider config={authConfig}>`);
+    }
+    console.log(`  4. Set your API URL in .env.local`);
+    console.log("\n" + import_chalk.default.cyan("Docs: https://github.com/econneq/econneq-auth") + "\n");
+  } catch (err) {
+    spinner.fail("Generation failed");
+    console.error(err);
+    process.exit(1);
+  }
+}
+
+// src/index.ts
+async function run() {
+  const [, , cmd = "init"] = process.argv;
+  switch (cmd) {
+    case "init":
+      await initCommand();
+      break;
+    default:
+      console.log("Unknown command. Available: init");
+      process.exit(1);
+  }
+}
+
+// src/bin.ts
+run();

package/dist/index.js

@@ -0,0 +1,259 @@
+#!/usr/bin/env node
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  run: () => run
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/commands/init.ts
+var import_prompts = __toESM(require("prompts"));
+var import_chalk = __toESM(require("chalk"));
+var import_ora = __toESM(require("ora"));
+var import_fs_extra = __toESM(require("fs-extra"));
+var import_path = __toESM(require("path"));
+
+// src/templates/auth.config.template.ts
+function generateAuthConfig(a) {
+  const methods = a.authMethods.map((m) => `'${m}'`).join(", ");
+  return `import { defineAuthConfig } from '@econneq/auth-react'
+
+export const authConfig = defineAuthConfig({
+  appName:    '${a.appName}',
+  apiBaseUrl: process.env.NEXT_PUBLIC_AUTH_API_URL ?? '${a.apiBaseUrl}',
+  tenantMode: ${a.tenantMode},
+
+  routing: {
+    strategy: 'subdomain',
+  },
+
+  auth: {
+    methods:        [${methods}],
+    mfa:            false,
+    rememberSession: true,
+  },
+
+  storage: {
+    strategy: '${a.storage}',
+  },
+
+  tokens: {
+    autoRefresh:         true,
+    accessTokenExpiry:   900,
+    refreshTokenExpiry:  604800,
+  },
+
+  security: {
+    csrf:                true,
+    sameSite:            'lax',
+    rotateRefreshTokens: true,
+  },
+
+  ui: {
+    hostedPages: true,
+    darkMode:    false,
+  },
+})
+`;
+}
+
+// src/templates/provider.template.ts
+function generateProviderFile(a) {
+  const pkg = a.framework === "nextjs" ? "@econneq/auth-react" : "@econneq/auth-react";
+  return `'use client'
+import { AuthProvider } from '${pkg}'
+import { authConfig }   from './auth.config'
+import type { ReactNode } from 'react'
+
+export function AppAuthProvider({ children }: { children: ReactNode }) {
+  return (
+    <AuthProvider config={authConfig}>
+      {children}
+    </AuthProvider>
+  )
+}
+`;
+}
+
+// src/templates/proxy.template.ts
+function generateProxyFile(_a) {
+  return `/**
+ * proxy.ts \u2014 Econneq Auth Middleware
+ * Generated by: npx econneq-auth init
+ */
+import { createAuthMiddleware } from '@econneq/auth-react/middleware'
+import { authConfig } from './src/auth/auth.config'
+
+export default createAuthMiddleware(authConfig, {
+  protectedRoutes:  ['/dashboard', '/app', '/admin'],
+  publicRoutes:     ['/auth/login', '/auth/register', '/auth/select-tenant'],
+  loginUrl:         '/auth/login',
+  tenantSelectUrl:  '/auth/select-tenant',
+})
+
+export const config = {
+  matcher: ['/((?!_next/static|_next/image|favicon\\.ico|.*\\.[a-zA-Z]{2,5}$).*)'],
+}
+`;
+}
+
+// src/templates/env.template.ts
+function generateEnvFile(a) {
+  return `# @econneq-auth \u2014 generated by npx econneq-auth init
+NEXT_PUBLIC_AUTH_API_URL=${a.apiBaseUrl}
+NEXT_PUBLIC_ROOT_DOMAIN=yourdomain.com
+
+# Optional: set these server-side only (not NEXT_PUBLIC_)
+# AUTH_SECRET=your-jwt-secret
+# AUTH_CSRF_SECRET=your-csrf-secret
+`;
+}
+
+// src/commands/init.ts
+async function initCommand() {
+  console.log("\n" + import_chalk.default.bold.cyan("\u{1F510} @econneq-auth init") + "\n");
+  const answers = await (0, import_prompts.default)([
+    {
+      type: "text",
+      name: "appName",
+      message: "Application name?",
+      initial: "My Enterprise App"
+    },
+    {
+      type: "text",
+      name: "apiBaseUrl",
+      message: "Auth API base URL?",
+      initial: "https://api.yourdomain.com"
+    },
+    {
+      type: "confirm",
+      name: "tenantMode",
+      message: "Enable multi-tenant mode?",
+      initial: true
+    },
+    {
+      type: "select",
+      name: "framework",
+      message: "Framework?",
+      choices: [
+        { title: "Next.js (App Router)", value: "nextjs" },
+        { title: "React (Vite/CRA)", value: "react" }
+      ]
+    },
+    {
+      type: "select",
+      name: "storage",
+      message: "Token storage strategy?",
+      choices: [
+        { title: "Cookies (recommended for SSR)", value: "cookies" },
+        { title: "localStorage", value: "localStorage" },
+        { title: "Memory", value: "memory" }
+      ]
+    },
+    {
+      type: "multiselect",
+      name: "authMethods",
+      message: "Auth methods to enable?",
+      choices: [
+        { title: "Password", value: "password", selected: true },
+        { title: "OTP", value: "otp", selected: false },
+        { title: "Google", value: "google", selected: false },
+        { title: "Magic Link", value: "magic-link", selected: false }
+      ]
+    }
+  ]);
+  if (!answers.appName) {
+    console.log(import_chalk.default.red("\nAborted."));
+    process.exit(1);
+  }
+  const spinner = (0, import_ora.default)("Generating auth files\u2026").start();
+  try {
+    const srcDir = import_path.default.join(process.cwd(), "src");
+    await import_fs_extra.default.outputFile(
+      import_path.default.join(srcDir, "auth", "auth.config.ts"),
+      generateAuthConfig(answers)
+    );
+    await import_fs_extra.default.outputFile(
+      import_path.default.join(srcDir, "auth", "provider.tsx"),
+      generateProviderFile(answers)
+    );
+    if (answers.framework === "nextjs") {
+      await import_fs_extra.default.outputFile(
+        import_path.default.join(process.cwd(), "proxy.ts"),
+        generateProxyFile(answers)
+      );
+    }
+    await import_fs_extra.default.outputFile(
+      import_path.default.join(process.cwd(), ".env.local"),
+      generateEnvFile(answers)
+    );
+    spinner.succeed("Auth files generated!");
+    console.log("\n" + import_chalk.default.bold("Files created:"));
+    console.log("  " + import_chalk.default.green("src/auth/auth.config.ts"));
+    console.log("  " + import_chalk.default.green("src/auth/provider.tsx"));
+    if (answers.framework === "nextjs") {
+      console.log("  " + import_chalk.default.green("proxy.ts"));
+    }
+    console.log("  " + import_chalk.default.green(".env.local"));
+    console.log("\n" + import_chalk.default.bold("Next steps:"));
+    if (answers.framework === "nextjs") {
+      console.log(`  1. npm install @econneq/auth-react @econneq/auth-ui`);
+      console.log(`  2. Wrap your root layout with <AuthProvider config={authConfig}>`);
+      console.log(`  3. Ensure proxy.ts is at your project root`);
+    } else {
+      console.log(`  1. npm install @econneq/auth-react @econneq/auth-ui`);
+      console.log(`  2. Wrap your App with <AuthProvider config={authConfig}>`);
+    }
+    console.log(`  4. Set your API URL in .env.local`);
+    console.log("\n" + import_chalk.default.cyan("Docs: https://github.com/econneq/econneq-auth") + "\n");
+  } catch (err) {
+    spinner.fail("Generation failed");
+    console.error(err);
+    process.exit(1);
+  }
+}
+
+// src/index.ts
+async function run() {
+  const [, , cmd = "init"] = process.argv;
+  switch (cmd) {
+    case "init":
+      await initCommand();
+      break;
+    default:
+      console.log("Unknown command. Available: init");
+      process.exit(1);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  run
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@econneq/auth-cli",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "CLI — npx econneq-auth init",
   "author": "Econneq",
   "license": "MIT",