solokit 0.1.1__py3-none-any.whl

solokit/templates/fullstack_nextjs/tier-3-comprehensive/tests/integration/api.test.ts

@@ -0,0 +1,165 @@
+import { describe, it, expect, jest, beforeEach } from "@jest/globals";
+import { NextRequest } from "next/server";
+import { GET, POST } from "@/app/api/example/route";
+
+// Mock Prisma client
+jest.mock("@/lib/prisma", () => ({
+  prisma: {
+    user: {
+      findMany: jest.fn(),
+      create: jest.fn(),
+    },
+  },
+}));
+
+// Import the mocked prisma after mocking
+import { prisma } from "@/lib/prisma";
+
+describe("API Integration Tests", () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  describe("GET /api/example", () => {
+    it("should successfully fetch users from database", async () => {
+      const mockUsers = [
+        {
+          id: 1,
+          name: "John Doe",
+          email: "john@example.com",
+          createdAt: new Date("2024-01-01"),
+          updatedAt: new Date("2024-01-01"),
+        },
+        {
+          id: 2,
+          name: "Jane Smith",
+          email: "jane@example.com",
+          createdAt: new Date("2024-01-02"),
+          updatedAt: new Date("2024-01-02"),
+        },
+      ];
+
+      (prisma.user.findMany as jest.Mock).mockResolvedValue(mockUsers);
+
+      const response = await GET();
+      const data = await response.json();
+
+      expect(response.status).toBe(200);
+      expect(data).toHaveProperty("message");
+      expect(data.users).toEqual(mockUsers);
+      expect(prisma.user.findMany).toHaveBeenCalledWith({
+        take: 10,
+        orderBy: { createdAt: "desc" },
+      });
+    });
+
+    it("should handle empty user list", async () => {
+      (prisma.user.findMany as jest.Mock).mockResolvedValue([]);
+
+      const response = await GET();
+      const data = await response.json();
+
+      expect(response.status).toBe(200);
+      expect(data.users).toEqual([]);
+    });
+
+    it("should handle database connection errors", async () => {
+      (prisma.user.findMany as jest.Mock).mockRejectedValue(
+        new Error("Database connection failed")
+      );
+
+      const response = await GET();
+      const data = await response.json();
+
+      expect(response.status).toBe(500);
+      expect(data).toHaveProperty("error", "Failed to fetch users");
+    });
+  });
+
+  describe("POST /api/example", () => {
+    it("should create user with valid input", async () => {
+      const mockUser = {
+        id: 1,
+        name: "New User",
+        email: "newuser@example.com",
+        createdAt: new Date(),
+        updatedAt: new Date(),
+      };
+
+      (prisma.user.create as jest.Mock).mockResolvedValue(mockUser);
+
+      const request = new NextRequest("http://localhost:3000/api/example", {
+        method: "POST",
+        body: JSON.stringify({
+          name: "New User",
+          email: "newuser@example.com",
+        }),
+      });
+
+      const response = await POST(request);
+      const data = await response.json();
+
+      expect(response.status).toBe(201);
+      expect(data).toEqual(mockUser);
+      expect(prisma.user.create).toHaveBeenCalledWith({
+        data: {
+          name: "New User",
+          email: "newuser@example.com",
+        },
+      });
+    });
+
+    it("should reject invalid email format", async () => {
+      const request = new NextRequest("http://localhost:3000/api/example", {
+        method: "POST",
+        body: JSON.stringify({
+          name: "Test User",
+          email: "invalid-email",
+        }),
+      });
+
+      const response = await POST(request);
+      const data = await response.json();
+
+      expect(response.status).toBe(400);
+      expect(data).toHaveProperty("error", "Validation failed");
+      expect(data).toHaveProperty("details");
+    });
+
+    it("should reject empty name", async () => {
+      const request = new NextRequest("http://localhost:3000/api/example", {
+        method: "POST",
+        body: JSON.stringify({
+          name: "",
+          email: "test@example.com",
+        }),
+      });
+
+      const response = await POST(request);
+      const data = await response.json();
+
+      expect(response.status).toBe(400);
+      expect(data).toHaveProperty("error", "Validation failed");
+    });
+
+    it("should handle database creation errors", async () => {
+      (prisma.user.create as jest.Mock).mockRejectedValue(
+        new Error("Duplicate email")
+      );
+
+      const request = new NextRequest("http://localhost:3000/api/example", {
+        method: "POST",
+        body: JSON.stringify({
+          name: "Test User",
+          email: "test@example.com",
+        }),
+      });
+
+      const response = await POST(request);
+      const data = await response.json();
+
+      expect(response.status).toBe(500);
+      expect(data).toHaveProperty("error", "Failed to create user");
+    });
+  });
+});

solokit/templates/fullstack_nextjs/tier-3-comprehensive/type-coverage.json

@@ -0,0 +1,12 @@
+{
+  "atLeast": 95,
+  "ignoreCatch": true,
+  "ignoreFiles": [
+    "**/*.test.ts",
+    "**/*.test.tsx",
+    "**/*.spec.ts",
+    "**/*.spec.tsx",
+    "node_modules/**",
+    ".next/**"
+  ]
+}

solokit/templates/fullstack_nextjs/tier-4-production/instrumentation.ts

@@ -0,0 +1,9 @@
+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");
+  }
+}

solokit/templates/fullstack_nextjs/tier-4-production/k6/load-test.js

@@ -0,0 +1,45 @@
+import http from 'k6/http';
+import { check, sleep } from 'k6';
+
+// Test configuration
+export const options = {
+  stages: [
+    { duration: '30s', target: 20 }, // Ramp up to 20 users
+    { duration: '1m', target: 20 },  // Stay at 20 users
+    { duration: '30s', target: 0 },  // Ramp down to 0 users
+  ],
+  thresholds: {
+    http_req_duration: ['p(95)<500'], // 95% of requests should be below 500ms
+    http_req_failed: ['rate<0.01'],   // Less than 1% of requests should fail
+  },
+};
+
+const BASE_URL = __ENV.BASE_URL || 'http://localhost:3000';
+
+export default function () {
+  // Test home page
+  const homeRes = http.get(`${BASE_URL}/`);
+  check(homeRes, {
+    'home page status is 200': (r) => r.status === 200,
+    'home page loads within 2s': (r) => r.timings.duration < 2000,
+  });
+
+  sleep(1);
+
+  // Test API endpoint
+  const apiRes = http.get(`${BASE_URL}/api/example`);
+  check(apiRes, {
+    'API status is 200': (r) => r.status === 200,
+    'API responds within 500ms': (r) => r.timings.duration < 500,
+  });
+
+  sleep(1);
+}
+
+// Summary handler
+export function handleSummary(data) {
+  return {
+    'stdout': textSummary(data, { indent: ' ', enableColors: true }),
+    'reports/load-test-summary.json': JSON.stringify(data),
+  };
+}

solokit/templates/fullstack_nextjs/tier-4-production/next.config.ts

@@ -0,0 +1,46 @@
+import type { NextConfig } from "next";
+import { withSentryConfig } from "@sentry/nextjs";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+// Injected content via Sentry wizard below
+export default withSentryConfig(nextConfig, {
+  // For all available options, see:
+  // https://github.com/getsentry/sentry-webpack-plugin#options
+
+  org: process.env.SENTRY_ORG,
+  project: process.env.SENTRY_PROJECT,
+
+  // Only print logs for uploading source maps in CI
+  silent: !process.env.CI,
+
+  // For all available options, see:
+  // https://docs.sentry.io/platforms/javascript/guides/nextjs/manual-setup/
+
+  // Upload a larger set of source maps for prettier stack traces (increases build time)
+  widenClientFileUpload: true,
+
+  // Automatically annotate React components to show their full name in breadcrumbs and session replay
+  reactComponentAnnotation: {
+    enabled: true,
+  },
+
+  // Route browser requests to Sentry through a Next.js rewrite to circumvent ad-blockers.
+  // This can increase your server load as well as your hosting bill.
+  // Note: Check that the configured route will not match with your Next.js middleware, otherwise reporting of client-
+  // side errors will fail.
+  tunnelRoute: "/monitoring",
+
+  // Hides source maps from generated client bundles
+
+  // Automatically tree-shake Sentry logger statements to reduce bundle size
+  disableLogger: true,
+
+  // Enables automatic instrumentation of Vercel Cron Monitors. (Does not yet work with App Router route handlers.)
+  // See the following for more information:
+  // https://docs.sentry.io/product/crons/
+  // https://vercel.com/docs/cron-jobs
+  automaticVercelMonitors: true,
+});

solokit/templates/fullstack_nextjs/tier-4-production/package.json.tier4.template

@@ -0,0 +1,77 @@
+{
+  "name": "{project_name}",
+  "version": "0.1.0",
+  "description": "{project_description}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "type-check": "tsc --noEmit",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:e2e": "playwright test",
+    "test:e2e:ui": "playwright test --ui",
+    "test:integration": "jest --testPathPattern=integration",
+    "test:mutation": "stryker run",
+    "format": "prettier --write \"**/*.{js,jsx,ts,tsx,json,md}\"",
+    "format:check": "prettier --check \"**/*.{js,jsx,ts,tsx,json,md}\"",
+    "prepare": "husky install && patch-package",
+    "audit": "npm audit --audit-level=moderate",
+    "check:duplication": "jscpd .",
+    "check:types": "type-coverage",
+    "analyze": "ANALYZE=true npm run build",
+    "lighthouse": "lhci autorun",
+    "load-test": "k6 run k6/load-test.js"
+  },
+  "dependencies": {
+    "next": "16.0.1",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "prisma": "6.19.0",
+    "@prisma/client": "6.19.0",
+    "zod": "4.1.12",
+    "tailwindcss": "4.1.17",
+    "@tailwindcss/postcss": "4.1.17",
+    "clsx": "2.1.1",
+    "tailwind-merge": "3.3.1",
+    "@sentry/nextjs": "10.23.0",
+    "@vercel/analytics": "1.5.0"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3",
+    "@types/node": "20.19.24",
+    "@types/react": "19.2.2",
+    "@types/react-dom": "19.2.2",
+    "eslint": "9.39.1",
+    "eslint-config-next": "16.0.1",
+    "@typescript-eslint/parser": "8.46.3",
+    "@typescript-eslint/eslint-plugin": "8.46.3",
+    "prettier": "3.6.2",
+    "jest": "30.2.0",
+    "@types/jest": "30.0.0",
+    "ts-jest": "29.4.5",
+    "jest-environment-jsdom": "30.2.0",
+    "@testing-library/react": "16.3.0",
+    "@testing-library/jest-dom": "6.9.1",
+    "husky": "9.1.7",
+    "lint-staged": "16.2.6",
+    "jscpd": "4.0.5",
+    "ts-prune": "0.10.3",
+    "type-coverage": "2.29.7",
+    "@stryker-mutator/core": "9.3.0",
+    "@stryker-mutator/jest-runner": "9.3.0",
+    "@playwright/test": "1.56.1",
+    "playwright": "1.56.1",
+    "@axe-core/playwright": "4.11.0",
+    "eslint-plugin-jest-dom": "5.5.0",
+    "eslint-plugin-testing-library": "7.13.3",
+    "patch-package": "8.0.1",
+    "@next/bundle-analyzer": "16.0.1",
+    "@lhci/cli": "0.15.1",
+    "dotenv-cli": "11.0.0"
+  }
+}

solokit/templates/fullstack_nextjs/tier-4-production/sentry.client.config.ts

@@ -0,0 +1,26 @@
+import * as Sentry from "@sentry/nextjs";
+
+Sentry.init({
+  dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
+
+  // Adjust this value in production, or use tracesSampler for greater control
+  tracesSampleRate: 1,
+
+  // Setting this option to true will print useful information to the console while you're setting up Sentry.
+  debug: false,
+
+  replaysOnErrorSampleRate: 1.0,
+
+  // This sets the sample rate to be 10%. You may want this to be 100% while
+  // in development and sample at a lower rate in production
+  replaysSessionSampleRate: 0.1,
+
+  // You can remove this option if you're not planning to use the Sentry Session Replay feature:
+  integrations: [
+    Sentry.replayIntegration({
+      // Additional Replay configuration goes in here, for example:
+      maskAllText: true,
+      blockAllMedia: true,
+    }),
+  ],
+});

solokit/templates/fullstack_nextjs/tier-4-production/sentry.edge.config.ts

@@ -0,0 +1,11 @@
+import * as Sentry from "@sentry/nextjs";
+
+Sentry.init({
+  dsn: process.env.SENTRY_DSN,
+
+  // Adjust this value in production, or use tracesSampler for greater control
+  tracesSampleRate: 1,
+
+  // Setting this option to true will print useful information to the console while you're setting up Sentry.
+  debug: false,
+});

solokit/templates/fullstack_nextjs/tier-4-production/sentry.server.config.ts

@@ -0,0 +1,11 @@
+import * as Sentry from "@sentry/nextjs";
+
+Sentry.init({
+  dsn: process.env.SENTRY_DSN,
+
+  // Adjust this value in production, or use tracesSampler for greater control
+  tracesSampleRate: 1,
+
+  // Setting this option to true will print useful information to the console while you're setting up Sentry.
+  debug: false,
+});

solokit/templates/git-hooks/prepare-commit-msg

@@ -0,0 +1,24 @@
+#!/bin/bash
+
+COMMIT_MSG_FILE=$1
+COMMIT_SOURCE=$2
+
+# Only run for regular commits (not merges, amends, etc.)
+if [ -z "$COMMIT_SOURCE" ]; then
+    cat >> "$COMMIT_MSG_FILE" << 'EOF'
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# REMINDERS:
+#
+# 📝 CHANGELOG: Update CHANGELOG.md for notable changes
+#    (features, fixes, breaking changes)
+#
+# 💡 LEARNINGS: Add insights that will be auto-extracted during /sk:end
+#    LEARNING: <your learning here>
+#
+# Examples:
+#    LEARNING: JWT refresh tokens should expire faster than access tokens
+#    LEARNING: Always use parameterized queries to prevent SQL injection
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+EOF
+fi