cnippet-stack 0.0.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cnippet
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OF ANY OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,64 @@
+# cnippet-stack
+
+Install full integrations — auth, database, payments, email, storage — into your **existing** Next.js app in minutes.
+
+```bash
+npx cnippet-stack init better-auth
+```
+
+Unlike boilerplates you fork or greenfield generators, cnippet-stack injects working integrations into the project you already have. It detects your setup (App Router, `src/` dir, package manager, ORM, path aliases), asks only the questions it can't answer itself, and writes production-quality code with safe merge strategies — never blindly overwriting your files.
+
+## How it works
+
+1. **Detects** your project: Next.js version, router, TypeScript, package manager, Prisma, aliases — all read statically, nothing executed.
+2. **Asks** a few questions (e.g. which OAuth providers) — everything detectable is never prompted.
+3. **Plans** the install and shows you a full diff preview before touching anything.
+4. **Applies** files with per-file strategies: `create` (fails if the file exists), `append` (idempotent, markered blocks — e.g. Prisma schema models), and AST-based injection (e.g. wrapping a provider in your `layout.tsx`).
+5. **Finishes** the plumbing: appends env placeholders (auto-generating secrets), installs dependencies with your package manager, runs post-install commands, and lists the manual steps no CLI can do for you (like OAuth console setup).
+
+Backups of every modified file are kept in `.cnippet/backup/<timestamp>/`.
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `npx cnippet-stack init <recipe>` | Install a recipe into the current project |
+| `npx cnippet-stack list` | List available recipes |
+| `npx cnippet-stack login` | Log in (required for pro recipes) |
+| `npx cnippet-stack logout` | Log out and revoke this device's token |
+| `npx cnippet-stack whoami` | Show the logged-in user |
+
+### Useful flags for `init`
+
+| Flag | Effect |
+|---|---|
+| `--dry-run` | Show the full install plan without writing anything |
+| `--yes` | Skip prompts and confirmation, use recipe defaults |
+| `--overwrite` | Allow overwriting files that already exist |
+| `--cwd <path>` | Install into a different directory |
+| `--json` | Machine-readable output (for scripts and AI agents), answers via `--answers '<json>'` |
+
+## Recipes
+
+Recipes are versioned, Zod-validated manifests rendered server-side by the registry — browse them at [stack.cnippet.dev/recipes](https://stack.cnippet.dev/recipes). Free recipes need no account; pro recipes require `cnippet-stack login` and a license.
+
+Current lineup includes `better-auth` (email/password + OAuth, Prisma models, middleware, starter UI), `prisma`, `biome`, and more shipping continuously — no CLI update needed when recipes are added or improved.
+
+## Requirements
+
+- Node.js 18+
+- A Next.js project using the App Router
+
+## Telemetry
+
+The CLI sends anonymous install events (recipe name, version, success, duration). Opt out with `CNIPPET_TELEMETRY=0`.
+
+## Ecosystem
+
+- [stack.cnippet.dev](https://stack.cnippet.dev) — recipe browser, dashboard, licensing
+- [next.cnippet.dev](https://next.cnippet.dev) — in-depth written integration guides
+- [ui.cnippet.dev](https://ui.cnippet.dev) — component library
+
+## License
+
+MIT — see [LICENSE](https://github.com/cnippet-dev/cnippet-stack/blob/main/packages/cli/LICENSE). Recipe templates are rendered by the registry service and are subject to their own tiers/terms.

package/dist/index.js

@@ -5930,6 +5930,13 @@ var require_lib = __commonJS({
 import { Command } from "commander";
 import pc7 from "picocolors";
 
+// src/commands/doctor.ts
+function runDoctor(recipe) {
+  console.log(
+    `\`cnippet-stack doctor ${recipe}\` isn't implemented yet \u2014 post-install verification lands in Phase 7.`
+  );
+}
+
 // src/commands/init.ts
 import * as clack2 from "@clack/prompts";
 import pc2 from "picocolors";
@@ -11536,13 +11543,6 @@ async function runInit(options) {
   return { applied: true, preview, recipeVersion: plan.manifest.version, result };
 }
 
-// src/commands/doctor.ts
-function runDoctor(recipe) {
-  console.log(
-    `\`cnippet-stack doctor ${recipe}\` isn't implemented yet \u2014 post-install verification lands in Phase 7.`
-  );
-}
-
 // src/commands/list.ts
 import pc3 from "picocolors";
 async function runList(options = {}) {
@@ -11672,8 +11672,9 @@ async function runWhoami() {
 // src/program.ts
 function resolveRegistrySource(opts) {
   if (opts.localRegistry) return new LocalRegistrySource();
-  const url = opts.registry ?? process.env.CNIPPET_REGISTRY_URL;
-  return url ? new HttpRegistrySource(url) : void 0;
+  return new HttpRegistrySource(
+    opts.registry ?? process.env.CNIPPET_REGISTRY_URL ?? DEFAULT_REGISTRY_URL
+  );
 }
 function sendTelemetry(registrySource, event) {
   if (process.env.CNIPPET_TELEMETRY === "0") return;
@@ -11729,7 +11730,7 @@ ${pc7.bold("Manual steps:")}`);
 }
 function createProgram() {
   const program = new Command();
-  program.name("cnippet-stack").description("Integration installer for Next.js apps.").version("0.0.0");
+  program.name("cnippet-stack").description("Integration installer for Next.js apps.").version(cliVersion());
   program.command("init <recipe>").description("Install a recipe into the current project.").option("--cwd <path>", "Project directory to install into.", process.cwd()).option(
     "--dry-run",
     "Show the install plan without writing anything.",
@@ -11814,7 +11815,10 @@ function createProgram() {
     false
   ).action(async (opts) => {
     try {
-      await runList({ json: opts.json, registrySource: resolveRegistrySource(opts) });
+      await runList({
+        json: opts.json,
+        registrySource: resolveRegistrySource(opts)
+      });
     } catch (error) {
       if (error instanceof RegistryHttpError) {
         console.error(pc7.red(`\u2716 ${error.message}`));

package/package.json

@@ -1,13 +1,16 @@
 {
+  "author": "cnippet <cnippet.dev@gmail.com>",
   "bin": {
     "cnippet-stack": "./dist/index.js"
   },
+  "bugs": "https://github.com/cnippet-dev/cnippet-stack/issues",
   "dependencies": {
     "@clack/prompts": "^0.10.0",
     "commander": "^13.1.0",
     "picocolors": "^1.1.1",
     "ts-morph": "^25.0.1"
   },
+  "description": "CLI that installs full integrations (auth, payments, email, storage) into your existing Next.js app — detection, prompts, safe file injection, env setup.",
   "devDependencies": {
     "@cnippet/registry": "workspace:*",
     "@cnippet/validators": "workspace:*",
@@ -28,12 +31,28 @@
   "files": [
     "dist"
   ],
+  "homepage": "https://stack.cnippet.dev",
+  "keywords": [
+    "nextjs",
+    "cli",
+    "integrations",
+    "installer",
+    "scaffold",
+    "better-auth",
+    "prisma",
+    "cnippet"
+  ],
   "license": "MIT",
   "main": "./dist/index.js",
   "name": "cnippet-stack",
   "publishConfig": {
     "access": "public"
   },
+  "repository": {
+    "directory": "packages/cli",
+    "type": "git",
+    "url": "git+https://github.com/cnippet-dev/cnippet-stack.git"
+  },
   "scripts": {
     "build": "tsup",
     "check-types": "tsc --noEmit",
@@ -43,5 +62,5 @@
   },
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "0.0.0"
+  "version": "0.2.0"
 }