miragedev-sdk 0.1.0

package/dist/chunk-75ZPJI57.cjs

@@ -0,0 +1,9 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+exports.__export = __export;

package/dist/chunk-BW4BLEIM.cjs

@@ -0,0 +1,18 @@
+'use strict';
+
+// src/errors.ts
+var MirageDevError = class _MirageDevError extends Error {
+  code;
+  details;
+  constructor(code, message, details) {
+    super(message);
+    this.name = "MirageDevError";
+    this.code = code;
+    this.details = details;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _MirageDevError);
+    }
+  }
+};
+
+exports.MirageDevError = MirageDevError;

package/dist/chunk-DZDDLA4G.js

@@ -0,0 +1,271 @@
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import ora from 'ora';
+import fs from 'fs/promises';
+
+// cli/commands/init.ts
+async function initCommand() {
+  console.log(chalk.blue.bold("\n\u{1F680} MirageDev SDK Setup\n"));
+  const answers = await inquirer.prompt([
+    {
+      type: "list",
+      name: "authProvider",
+      message: "Choose your auth provider:",
+      choices: [
+        { name: "NextAuth.js", value: "nextauth" },
+        { name: "Clerk", value: "clerk" },
+        { name: "Supabase Auth", value: "supabase" }
+      ],
+      default: "nextauth"
+    },
+    {
+      type: "list",
+      name: "billingProvider",
+      message: "Choose your billing provider:",
+      choices: [
+        { name: "Stripe", value: "stripe" },
+        { name: "Paddle", value: "paddle" },
+        { name: "LemonSqueezy", value: "lemonsqueezy" }
+      ],
+      default: "stripe"
+    },
+    {
+      type: "list",
+      name: "emailProvider",
+      message: "Choose your email provider:",
+      choices: [
+        { name: "Resend", value: "resend" },
+        { name: "SendGrid", value: "sendgrid" },
+        { name: "Postmark", value: "postmark" }
+      ],
+      default: "resend"
+    },
+    {
+      type: "checkbox",
+      name: "features",
+      message: "Select additional features:",
+      choices: [
+        { name: "PWA Support", value: "pwa", checked: true },
+        { name: "Biometric Auth", value: "biometric", checked: false },
+        { name: "Mobile Optimizations", value: "mobile", checked: true }
+      ]
+    }
+  ]);
+  const spinner = ora("Generating configuration files...").start();
+  try {
+    await generateConfigFile(answers);
+    await generateEnvTemplate(answers);
+    await generateInitFile(answers);
+    await generateAgentRules(answers);
+    spinner.succeed(chalk.green("Configuration files created!"));
+    console.log(chalk.cyan("\n\u{1F4DD} Next steps:\n"));
+    console.log("1. Fill in your API keys in .env.local");
+    console.log("2. Import and call initMirageDev() in your app");
+    console.log("3. Start building your SAAS! \u{1F389}\n");
+    console.log(chalk.gray("Documentation: https://github.com/yourusername/miragedev-sdk\n"));
+  } catch (error) {
+    spinner.fail(chalk.red("Failed to generate files"));
+    console.error(error);
+    process.exit(1);
+  }
+}
+async function generateConfigFile(answers) {
+  const config = `// MirageDev SDK Configuration
+import { initMirageDev } from 'miragedev-sdk'
+
+export function initializeMirageDev() {
+  initMirageDev({
+    auth: {
+      provider: '${answers.authProvider}',
+      sessionSecret: process.env.AUTH_SECRET!,
+    },
+    billing: {
+      provider: '${answers.billingProvider}',
+      ${answers.billingProvider === "stripe" ? "stripeSecretKey: process.env.STRIPE_SECRET_KEY!," : ""}
+      webhookSecret: process.env.${answers.billingProvider.toUpperCase()}_WEBHOOK_SECRET!,
+    },
+    email: {
+      provider: '${answers.emailProvider}',
+      apiKey: process.env.${answers.emailProvider.toUpperCase()}_API_KEY!,
+      from: process.env.EMAIL_FROM!,
+    },
+  })
+}
+`;
+  await fs.writeFile("miragedev.config.ts", config, "utf-8");
+}
+async function generateEnvTemplate(answers) {
+  const env = `# MirageDev SDK Environment Variables
+
+# Auth
+AUTH_SECRET=your-secret-key-here
+
+# Billing (${answers.billingProvider})
+${answers.billingProvider === "stripe" ? "STRIPE_SECRET_KEY=sk_test_xxx" : ""}
+${answers.billingProvider.toUpperCase()}_WEBHOOK_SECRET=whsec_xxx
+
+# Email (${answers.emailProvider})
+${answers.emailProvider.toUpperCase()}_API_KEY=your-api-key-here
+EMAIL_FROM=noreply@yourapp.com
+`;
+  const envPath = ".env.local.example";
+  await fs.writeFile(envPath, env, "utf-8");
+}
+async function generateInitFile(answers) {
+  const hasFeature = (feature) => answers.features.includes(feature);
+  const imports = [];
+  const setup = [];
+  if (hasFeature("pwa")) {
+    imports.push("import { configurePWA } from 'miragedev-sdk/pwa'");
+    setup.push(`
+// PWA Configuration
+export const pwaConfig = configurePWA({
+  name: 'Your App Name',
+  theme: '#000000',
+  offline: { enabled: true, pages: ['/'] }
+})`);
+  }
+  const content = `// MirageDev SDK Initialization
+import { initializeMirageDev } from './miragedev.config'
+${imports.join("\n")}
+
+// Initialize SDK
+initializeMirageDev()
+
+${setup.join("\n\n")}
+`;
+  await fs.writeFile("miragedev.init.ts", content, "utf-8");
+}
+async function generateAgentRules(answers) {
+  const modules = ["auth", "billing", "email"];
+  if (answers.features.includes("pwa")) modules.push("pwa");
+  if (answers.features.includes("mobile")) modules.push("mobile");
+  if (answers.features.includes("biometric")) modules.push("auth/biometric");
+  const content = `# AI Agent Instructions
+
+> **For AI Assistants (GitHub Copilot, OpenCode, Cursor, etc.):**
+> This project uses **MirageDev SDK**. Always prefer SDK functions over manual implementations.
+
+## Installed SDK Modules
+
+${modules.map((mod) => `- \`miragedev-sdk/${mod}\` - ${getModuleDescription(mod)}`).join("\n")}
+
+## Configuration
+
+- **Auth Provider:** ${answers.authProvider}
+- **Billing Provider:** ${answers.billingProvider}
+- **Email Provider:** ${answers.emailProvider}
+${answers.features.includes("pwa") ? "- **PWA:** Enabled" : ""}
+${answers.features.includes("biometric") ? "- **Biometric Auth:** Enabled" : ""}
+${answers.features.includes("mobile") ? "- **Mobile Optimizations:** Enabled" : ""}
+
+## Code Generation Rules
+
+### \u2705 DO: Use MirageDev SDK
+
+When developer needs authentication:
+\`\`\`typescript
+// \u2705 CORRECT
+import { requireAuth } from 'miragedev-sdk/auth'
+
+export default async function Page() {
+  const session = await requireAuth()
+  return <div>Hello {session.user.name}</div>
+}
+\`\`\`
+
+When developer needs billing:
+\`\`\`typescript
+// \u2705 CORRECT  
+import { createCheckout } from 'miragedev-sdk/billing'
+
+const { url } = await createCheckout({
+  priceId: 'price_xxx',
+  userId: session.user.id,
+  successUrl: '/success',
+  cancelUrl: '/cancel',
+})
+\`\`\`
+
+When developer needs email:
+\`\`\`typescript
+// \u2705 CORRECT
+import { sendTemplateEmail } from 'miragedev-sdk/email'
+
+await sendTemplateEmail({
+  to: user.email,
+  template: 'welcome',
+  data: { userName: user.name }
+})
+\`\`\`
+
+### \u274C DON'T: Manual Implementation
+
+\`\`\`typescript
+// \u274C WRONG - Don't do this when SDK exists
+import Stripe from 'stripe'
+const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!)
+// ... manual implementation
+\`\`\`
+
+## Discovery & Documentation
+
+- **JSDoc Examples:** Every SDK function has \`@example\` tags - read them!
+- **TypeScript Types:** Check types for exact parameters
+- **Full Docs:** See \`node_modules/miragedev-sdk/README.md\`
+- **Examples:** Check SDK's \`examples/\` directory for patterns
+
+## Module Reference
+
+### Authentication (\`miragedev-sdk/auth\`)
+- \`requireAuth()\` - Server-side, throws if not authenticated
+- \`getSession()\` - Server-side, returns session or null
+- \`useSession()\` - Client hook from \`/auth/client\`
+- \`authMiddleware()\` - Next.js middleware from \`/auth/middleware\`
+${answers.features.includes("biometric") ? "- `enableBiometric()`, `signInWithBiometric()` - from `/auth/biometric`" : ""}
+
+### Billing (\`miragedev-sdk/billing\`)
+- \`createCheckout()\` - Create Stripe checkout session
+- \`createPortal()\` - Create billing portal session
+- \`getSubscription()\` - Get subscription status
+- \`handleWebhook()\` - Process Stripe webhooks from \`/billing/webhook\`
+- \`useSubscription()\` - Client hook from \`/billing/client\`
+
+### Email (\`miragedev-sdk/email\`)
+- \`sendEmail()\` - Send basic email
+- \`sendTemplateEmail()\` - Send with template (welcome, reset-password, etc)
+
+${answers.features.includes("pwa") ? `### PWA (\`miragedev-sdk/pwa\`)
+- \`configurePWA()\` - Generate manifest and service worker` : ""}
+
+${answers.features.includes("mobile") ? `### Mobile (\`miragedev-sdk/mobile\`)
+- \`useNetworkStatus()\` - Online/offline detection
+- \`useInstallPrompt()\` - PWA install prompt
+- \`useNotifications()\` - Push notifications
+- \`usePullToRefresh()\` - Pull-to-refresh gesture` : ""}
+
+## Important Notes
+
+1. SDK is already initialized in \`miragedev.config.ts\`
+2. All async SDK functions should be wrapped in try/catch
+3. SDK throws \`MirageDevError\` with error codes - handle them
+4. For NEW features not in SDK, implement normally - but check SDK first!
+
+---
+*Generated by MirageDev SDK CLI - Updated when you add new modules*
+`;
+  await fs.writeFile("AGENTS.md", content, "utf-8");
+}
+function getModuleDescription(module) {
+  const descriptions = {
+    "auth": "requireAuth(), getSession(), middleware",
+    "auth/biometric": "enableBiometric(), signInWithBiometric()",
+    "billing": "createCheckout(), createPortal(), webhooks",
+    "email": "sendEmail(), sendTemplateEmail() with 5 templates",
+    "pwa": "configurePWA(), manifest + service worker",
+    "mobile": "useNetworkStatus(), useInstallPrompt(), etc"
+  };
+  return descriptions[module] || "Available functions";
+}
+
+export { initCommand };