npm - create-loadout - Versions diffs - 1.0.0 - Mend

create-loadout 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (72) hide show

package/README.md +154 -0
package/dist/claude-md.d.ts +3 -0
package/dist/claude-md.js +494 -0
package/dist/cli.d.ts +1 -0
package/dist/cli.js +186 -0
package/dist/config.d.ts +3 -0
package/dist/config.js +98 -0
package/dist/create-next.d.ts +1 -0
package/dist/create-next.js +17 -0
package/dist/detect.d.ts +4 -0
package/dist/detect.js +60 -0
package/dist/env.d.ts +3 -0
package/dist/env.js +183 -0
package/dist/generate-readme.d.ts +3 -0
package/dist/generate-readme.js +160 -0
package/dist/index.d.ts +2 -0
package/dist/index.js +3 -0
package/dist/instrumentation.d.ts +3 -0
package/dist/instrumentation.js +95 -0
package/dist/integrations/ai-sdk.d.ts +3 -0
package/dist/integrations/ai-sdk.js +20 -0
package/dist/integrations/clerk.d.ts +2 -0
package/dist/integrations/clerk.js +50 -0
package/dist/integrations/firecrawl.d.ts +2 -0
package/dist/integrations/firecrawl.js +26 -0
package/dist/integrations/index.d.ts +4 -0
package/dist/integrations/index.js +64 -0
package/dist/integrations/inngest.d.ts +2 -0
package/dist/integrations/inngest.js +45 -0
package/dist/integrations/neon-drizzle.d.ts +2 -0
package/dist/integrations/neon-drizzle.js +56 -0
package/dist/integrations/posthog.d.ts +2 -0
package/dist/integrations/posthog.js +25 -0
package/dist/integrations/resend.d.ts +2 -0
package/dist/integrations/resend.js +34 -0
package/dist/integrations/sentry.d.ts +2 -0
package/dist/integrations/sentry.js +47 -0
package/dist/integrations/stripe.d.ts +2 -0
package/dist/integrations/stripe.js +45 -0
package/dist/integrations/uploadthing.d.ts +2 -0
package/dist/integrations/uploadthing.js +34 -0
package/dist/landing-page.d.ts +2 -0
package/dist/landing-page.js +97 -0
package/dist/prompts.d.ts +7 -0
package/dist/prompts.js +99 -0
package/dist/setup-shadcn.d.ts +1 -0
package/dist/setup-shadcn.js +27 -0
package/dist/templates/ai-sdk.d.ts +12 -0
package/dist/templates/ai-sdk.js +96 -0
package/dist/templates/clerk.d.ts +6 -0
package/dist/templates/clerk.js +96 -0
package/dist/templates/firecrawl.d.ts +4 -0
package/dist/templates/firecrawl.js +106 -0
package/dist/templates/inngest.d.ts +6 -0
package/dist/templates/inngest.js +91 -0
package/dist/templates/neon-drizzle.d.ts +16 -0
package/dist/templates/neon-drizzle.js +343 -0
package/dist/templates/posthog.d.ts +3 -0
package/dist/templates/posthog.js +10 -0
package/dist/templates/resend.d.ts +5 -0
package/dist/templates/resend.js +102 -0
package/dist/templates/sentry.d.ts +8 -0
package/dist/templates/sentry.js +145 -0
package/dist/templates/stripe.d.ts +6 -0
package/dist/templates/stripe.js +215 -0
package/dist/templates/uploadthing.d.ts +7 -0
package/dist/templates/uploadthing.js +150 -0
package/dist/templates/zustand.d.ts +3 -0
package/dist/templates/zustand.js +26 -0
package/dist/types.d.ts +26 -0
package/dist/types.js +1 -0
package/package.json +46 -0

package/dist/templates/sentry.js ADDED Viewed

@@ -0,0 +1,145 @@
+export const sentryTemplates = {
+    instrumentation: `import * as Sentry from '@sentry/nextjs';
+export async function register() {
+  if (process.env.NEXT_RUNTIME === 'nodejs') {
+    await import('./sentry.server.config');
+  }
+  if (process.env.NEXT_RUNTIME === 'edge') {
+    await import('./sentry.edge.config');
+  }
+}
+export const onRequestError = Sentry.captureRequestError;
+`,
+    instrumentationClient: `import * as Sentry from '@sentry/nextjs';
+import { SENTRY_DSN } from '@/lib/config';
+Sentry.init({
+  dsn: SENTRY_DSN,
+  environment: process.env.NODE_ENV,
+  sendDefaultPii: false,
+  tracesSampleRate: process.env.NODE_ENV === 'production' ? 0.1 : 0,
+  replaysSessionSampleRate: 0.1,
+  replaysOnErrorSampleRate: 1.0,
+  integrations: [
+    Sentry.replayIntegration({
+      maskAllText: true,
+      blockAllMedia: true,
+    }),
+  ],
+  beforeSend(event) {
+    if (process.env.NODE_ENV === 'development') return null;
+    if (event.user) {
+      delete event.user.email;
+      delete event.user.ip_address;
+      delete event.user.username;
+    }
+    if (event.request?.headers) {
+      delete event.request.headers['authorization'];
+      delete event.request.headers['cookie'];
+    }
+    return event;
+  },
+});
+export const onRouterTransitionStart = Sentry.captureRouterTransitionStart;
+`,
+    serverConfig: `import * as Sentry from '@sentry/nextjs';
+import { SENTRY_DSN } from '@/lib/config';
+Sentry.init({
+  dsn: SENTRY_DSN,
+  environment: process.env.NODE_ENV,
+  sendDefaultPii: false,
+  tracesSampleRate: process.env.NODE_ENV === 'production' ? 0.1 : 0,
+  beforeSend(event) {
+    if (process.env.NODE_ENV === 'development') return null;
+    if (event.user) {
+      delete event.user.email;
+      delete event.user.ip_address;
+      delete event.user.username;
+    }
+    if (event.request?.headers) {
+      delete event.request.headers['authorization'];
+      delete event.request.headers['cookie'];
+    }
+    return event;
+  },
+});
+`,
+    edgeConfig: `import * as Sentry from '@sentry/nextjs';
+import { SENTRY_DSN } from '@/lib/config';
+Sentry.init({
+  dsn: SENTRY_DSN,
+  environment: process.env.NODE_ENV,
+  sendDefaultPii: false,
+  tracesSampleRate: process.env.NODE_ENV === 'production' ? 0.1 : 0,
+  beforeSend(event) {
+    if (process.env.NODE_ENV === 'development') return null;
+    if (event.user) {
+      delete event.user.email;
+      delete event.user.ip_address;
+      delete event.user.username;
+    }
+    if (event.request?.headers) {
+      delete event.request.headers['authorization'];
+      delete event.request.headers['cookie'];
+    }
+    return event;
+  },
+});
+`,
+    globalError: `'use client';
+import * as Sentry from '@sentry/nextjs';
+import NextError from 'next/error';
+import { useEffect } from 'react';
+export default function GlobalError({
+  error,
+}: {
+  error: Error & { digest?: string };
+}) {
+  useEffect(() => {
+    Sentry.captureException(error);
+  }, [error]);
+  return (
+    <html lang="en">
+      <body>
+        <NextError statusCode={0} />
+      </body>
+    </html>
+  );
+}
+`,
+    nextConfig: `import { withSentryConfig } from '@sentry/nextjs';
+import type { NextConfig } from 'next';
+import { SENTRY_ORG, SENTRY_PROJECT } from './lib/config';
+const nextConfig: NextConfig = {};
+export default withSentryConfig(nextConfig, {
+  org: SENTRY_ORG,
+  project: SENTRY_PROJECT,
+  silent: !process.env.CI,
+  widenClientFileUpload: true,
+  tunnelRoute: '/monitoring',
+  hideSourceMaps: true,
+  disableLogger: true,
+});
+`,
+};

package/dist/templates/stripe.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+export declare const stripeTemplates: {
+    paymentService: string;
+    checkoutRoute: string;
+    webhooksRoute: string;
+    portalRoute: string;
+};

package/dist/templates/stripe.js ADDED Viewed

@@ -0,0 +1,215 @@
+export const stripeTemplates = {
+    paymentService: `import Stripe from 'stripe';
+import { STRIPE_SECRET_KEY } from '@/lib/config';
+export interface CreateCheckoutOptions {
+  priceId: string;
+  customerId?: string;
+  mode?: 'payment' | 'subscription';
+  successUrl: string;
+  cancelUrl: string;
+  metadata?: Record<string, string>;
+}
+export interface CreatePortalOptions {
+  customerId: string;
+  returnUrl: string;
+}
+export class PaymentService {
+  private stripe: Stripe;
+  constructor(secretKey: string) {
+    this.stripe = new Stripe(secretKey, {
+      apiVersion: '2024-12-18.acacia',
+      typescript: true,
+    });
+  }
+  async createCheckoutSession(options: CreateCheckoutOptions): Promise<Stripe.Checkout.Session> {
+    return this.stripe.checkout.sessions.create({
+      mode: options.mode ?? 'subscription',
+      payment_method_types: ['card'],
+      line_items: [
+        {
+          price: options.priceId,
+          quantity: 1,
+        },
+      ],
+      customer: options.customerId,
+      success_url: options.successUrl,
+      cancel_url: options.cancelUrl,
+      metadata: options.metadata,
+    });
+  }
+  async createPortalSession(options: CreatePortalOptions): Promise<Stripe.BillingPortal.Session> {
+    return this.stripe.billingPortal.sessions.create({
+      customer: options.customerId,
+      return_url: options.returnUrl,
+    });
+  }
+  async getSubscription(subscriptionId: string): Promise<Stripe.Subscription> {
+    return this.stripe.subscriptions.retrieve(subscriptionId);
+  }
+  async cancelSubscription(subscriptionId: string): Promise<Stripe.Subscription> {
+    return this.stripe.subscriptions.cancel(subscriptionId);
+  }
+  async getCustomer(customerId: string): Promise<Stripe.Customer | Stripe.DeletedCustomer> {
+    return this.stripe.customers.retrieve(customerId);
+  }
+  async createCustomer(email: string, metadata?: Record<string, string>): Promise<Stripe.Customer> {
+    return this.stripe.customers.create({
+      email,
+      metadata,
+    });
+  }
+  constructWebhookEvent(
+    payload: string | Buffer,
+    signature: string,
+    webhookSecret: string
+  ): Stripe.Event {
+    return this.stripe.webhooks.constructEvent(payload, signature, webhookSecret);
+  }
+}
+export const paymentService = new PaymentService(STRIPE_SECRET_KEY);
+export type { Stripe };
+`,
+    checkoutRoute: `import { NextResponse } from 'next/server';
+import { paymentService } from '@/services/payment.service';
+import { z } from 'zod';
+const checkoutSchema = z.object({
+  priceId: z.string(),
+  customerId: z.string().optional(),
+  successUrl: z.url(),
+  cancelUrl: z.url(),
+});
+export async function POST(req: Request) {
+  try {
+    const body = await req.json();
+    const { priceId, customerId, successUrl, cancelUrl } = checkoutSchema.parse(body);
+    const session = await paymentService.createCheckoutSession({
+      priceId,
+      customerId,
+      successUrl,
+      cancelUrl,
+    });
+    return NextResponse.json({ url: session.url });
+  } catch (error) {
+    if (error instanceof z.ZodError) {
+      return NextResponse.json(
+        { error: 'Invalid request', details: error.errors },
+        { status: 400 }
+      );
+    }
+    return NextResponse.json(
+      { error: error instanceof Error ? error.message : 'Failed to create checkout' },
+      { status: 500 }
+    );
+  }
+}
+`,
+    webhooksRoute: `import { headers } from 'next/headers';
+import { NextResponse } from 'next/server';
+import { paymentService, type Stripe } from '@/services/payment.service';
+import { STRIPE_WEBHOOK_SECRET } from '@/lib/config';
+export async function POST(req: Request) {
+  const body = await req.text();
+  const headersList = await headers();
+  const signature = headersList.get('stripe-signature')!;
+  let event: Stripe.Event;
+  try {
+    event = paymentService.constructWebhookEvent(body, signature, STRIPE_WEBHOOK_SECRET);
+  } catch (error) {
+    console.error('Webhook signature verification failed:', error);
+    return NextResponse.json({ error: 'Invalid signature' }, { status: 400 });
+  }
+  switch (event.type) {
+    case 'checkout.session.completed': {
+      const session = event.data.object as Stripe.Checkout.Session;
+      console.log('Checkout completed:', session.id);
+      break;
+    }
+    case 'customer.subscription.created':
+    case 'customer.subscription.updated': {
+      const subscription = event.data.object as Stripe.Subscription;
+      console.log('Subscription updated:', subscription.id, subscription.status);
+      break;
+    }
+    case 'customer.subscription.deleted': {
+      const subscription = event.data.object as Stripe.Subscription;
+      console.log('Subscription cancelled:', subscription.id);
+      break;
+    }
+    case 'invoice.payment_succeeded': {
+      const invoice = event.data.object as Stripe.Invoice;
+      console.log('Payment succeeded:', invoice.id);
+      break;
+    }
+    case 'invoice.payment_failed': {
+      const invoice = event.data.object as Stripe.Invoice;
+      console.log('Payment failed:', invoice.id);
+      break;
+    }
+    default:
+      console.log('Unhandled event type:', event.type);
+  }
+  return NextResponse.json({ received: true });
+}
+`,
+    portalRoute: `import { NextResponse } from 'next/server';
+import { paymentService } from '@/services/payment.service';
+import { z } from 'zod';
+const portalSchema = z.object({
+  customerId: z.string(),
+  returnUrl: z.url(),
+});
+export async function POST(req: Request) {
+  try {
+    const body = await req.json();
+    const { customerId, returnUrl } = portalSchema.parse(body);
+    const session = await paymentService.createPortalSession({
+      customerId,
+      returnUrl,
+    });
+    return NextResponse.json({ url: session.url });
+  } catch (error) {
+    if (error instanceof z.ZodError) {
+      return NextResponse.json(
+        { error: 'Invalid request', details: error.errors },
+        { status: 400 }
+      );
+    }
+    return NextResponse.json(
+      { error: error instanceof Error ? error.message : 'Failed to create portal session' },
+      { status: 500 }
+    );
+  }
+}
+`,
+};

package/dist/templates/uploadthing.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+export declare const uploadthingTemplates: {
+    uploadthingClient: string;
+    fileService: string;
+    uploadthingCore: string;
+    uploadthingRoute: string;
+    uploadButton: string;
+};

package/dist/templates/uploadthing.js ADDED Viewed

@@ -0,0 +1,150 @@
+export const uploadthingTemplates = {
+    uploadthingClient: `import {
+  generateUploadButton,
+  generateUploadDropzone,
+  generateReactHelpers,
+} from '@uploadthing/react';
+import type { OurFileRouter } from '@/app/api/uploadthing/core';
+export const UploadButton = generateUploadButton<OurFileRouter>();
+export const UploadDropzone = generateUploadDropzone<OurFileRouter>();
+export const { useUploadThing } = generateReactHelpers<OurFileRouter>();
+`,
+    fileService: `import { UTApi } from 'uploadthing/server';
+export interface UploadedFile {
+  key: string;
+  url: string;
+  name: string;
+  size: number;
+}
+export class FileService {
+  constructor(private utapi: UTApi) {}
+  async deleteFile(key: string): Promise<void> {
+    await this.utapi.deleteFiles(key);
+  }
+  async deleteFiles(keys: string[]): Promise<void> {
+    await this.utapi.deleteFiles(keys);
+  }
+  async getFileUrls(keys: string[]): Promise<string[]> {
+    const result = await this.utapi.getFileUrls(keys);
+    return result.data.map((f) => f.url);
+  }
+  async renameFile(key: string, newName: string): Promise<void> {
+    await this.utapi.renameFiles({ fileKey: key, newName });
+  }
+}
+export const fileService = new FileService(new UTApi());
+`,
+    uploadthingCore: `import { createUploadthing, type FileRouter } from 'uploadthing/next';
+import { UploadThingError } from 'uploadthing/server';
+const f = createUploadthing();
+const auth = (req: Request) => ({ id: 'user-id' });
+export const ourFileRouter = {
+  imageUploader: f({
+    image: {
+      maxFileSize: '4MB',
+      maxFileCount: 4,
+    },
+  })
+    .middleware(async ({ req }) => {
+      const user = await auth(req);
+      if (!user) throw new UploadThingError('Unauthorized');
+      return { userId: user.id };
+    })
+    .onUploadComplete(async ({ metadata, file }) => {
+      console.log('Upload complete for userId:', metadata.userId);
+      console.log('File URL:', file.ufsUrl);
+      return { uploadedBy: metadata.userId, url: file.ufsUrl };
+    }),
+  documentUploader: f({
+    pdf: { maxFileSize: '16MB' },
+    'application/msword': { maxFileSize: '16MB' },
+    'application/vnd.openxmlformats-officedocument.wordprocessingml.document': {
+      maxFileSize: '16MB',
+    },
+  })
+    .middleware(async ({ req }) => {
+      const user = await auth(req);
+      if (!user) throw new UploadThingError('Unauthorized');
+      return { userId: user.id };
+    })
+    .onUploadComplete(async ({ metadata, file }) => {
+      return { uploadedBy: metadata.userId, url: file.ufsUrl };
+    }),
+} satisfies FileRouter;
+export type OurFileRouter = typeof ourFileRouter;
+`,
+    uploadthingRoute: `import { createRouteHandler } from 'uploadthing/next';
+import { ourFileRouter } from './core';
+export const { GET, POST } = createRouteHandler({
+  router: ourFileRouter,
+});
+`,
+    uploadButton: `'use client';
+import { UploadButton, UploadDropzone } from '@/lib/uploadthing.client';
+import { useState } from 'react';
+interface UploadedFile {
+  url: string;
+  name: string;
+}
+export function ImageUploadButton({
+  onUpload,
+}: {
+  onUpload?: (files: UploadedFile[]) => void;
+}) {
+  const [isUploading, setIsUploading] = useState(false);
+  return (
+    <UploadButton
+      endpoint="imageUploader"
+      onUploadBegin={() => setIsUploading(true)}
+      onClientUploadComplete={(res) => {
+        setIsUploading(false);
+        const files = res.map((f) => ({ url: f.ufsUrl, name: f.name }));
+        onUpload?.(files);
+      }}
+      onUploadError={(error: Error) => {
+        setIsUploading(false);
+        console.error('Upload error:', error.message);
+      }}
+    />
+  );
+}
+export function ImageUploadDropzone({
+  onUpload,
+}: {
+  onUpload?: (files: UploadedFile[]) => void;
+}) {
+  return (
+    <UploadDropzone
+      endpoint="imageUploader"
+      onClientUploadComplete={(res) => {
+        const files = res.map((f) => ({ url: f.ufsUrl, name: f.name }));
+        onUpload?.(files);
+      }}
+      onUploadError={(error: Error) => {
+        console.error('Upload error:', error.message);
+      }}
+    />
+  );
+}
+`,
+};

package/dist/templates/zustand.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export declare const zustandTemplates: {
+    exampleStore: string;
+};

package/dist/templates/zustand.js ADDED Viewed

@@ -0,0 +1,26 @@
+export const zustandTemplates = {
+    exampleStore: `import { createStore, useStore } from 'zustand';
+interface CounterState {
+  count: number;
+  increment: () => void;
+  decrement: () => void;
+  reset: () => void;
+}
+const initialState = {
+  count: 0,
+};
+export const counterStore = createStore<CounterState>()((set) => ({
+  ...initialState,
+  increment: () => set((state) => ({ count: state.count + 1 })),
+  decrement: () => set((state) => ({ count: state.count - 1 })),
+  reset: () => set(initialState),
+}));
+export const useCounterStore = <T>(selector: (state: CounterState) => T): T => {
+  return useStore(counterStore, selector);
+};
+`,
+};

package/dist/types.d.ts ADDED Viewed

@@ -0,0 +1,26 @@
+export type IntegrationId = 'clerk' | 'neon-drizzle' | 'ai-sdk' | 'resend' | 'firecrawl' | 'inngest' | 'uploadthing' | 'stripe' | 'posthog' | 'sentry';
+export interface Integration {
+    id: IntegrationId;
+    name: string;
+    description: string;
+    packages: string[];
+    devPackages?: string[];
+    envVars: EnvVar[];
+    setup: (projectPath: string) => Promise<void>;
+}
+export interface EnvVar {
+    key: string;
+    description: string;
+    example: string;
+    isPublic?: boolean;
+}
+export type AIProviderChoice = 'openai' | 'anthropic' | 'google';
+export interface ProjectConfig {
+    name: string;
+    integrations: IntegrationId[];
+    aiProvider?: AIProviderChoice;
+}
+export interface TemplateFile {
+    path: string;
+    content: string;
+}

package/dist/types.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/package.json ADDED Viewed

@@ -0,0 +1,46 @@
+{
+  "name": "create-loadout",
+  "version": "1.0.0",
+  "description": "Custom Next.js scaffolding CLI with optional SaaS integrations",
+  "type": "module",
+  "bin": {
+    "create-loadout": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "nextjs",
+    "cli",
+    "scaffolding",
+    "saas",
+    "boilerplate"
+  ],
+  "author": {
+    "name": "Kyle Davidson"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kylerd/loadout.git"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.0.0",
+    "ora": "^8.0.0",
+    "execa": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.0.0",
+    "tsx": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}