@codexsploitx/schemaapi 1.0.3 → 1.0.4

package/bin/schemaapi

@@ -249,6 +249,33 @@ function handleInit(adapterArg) {
     fs.writeFileSync(indexPath, 'export * from "./usersContract";\n');
   }
 
+  if (adapter === "next") {
+    const appApiUsersDir = path.join(cwd, "app", "api", "users");
+    if (!fs.existsSync(appApiUsersDir)) {
+      fs.mkdirSync(appApiUsersDir, { recursive: true });
+    }
+    const routePath = path.join(appApiUsersDir, "route.ts");
+    if (!fs.existsSync(routePath)) {
+      const nextRouteContent = [
+        'import { adapters } from "schemaapi";',
+        'import { usersContract } from "../../../contracts";',
+        "",
+        "const handlers = adapters.next.handleContract(usersContract, {",
+        '  "GET /users/:id": async ({ params }) => {',
+        "    return {",
+        "      id: String(params && params.id),",
+        '      name: "John Doe",',
+        "    };",
+        "  },",
+        "});",
+        "",
+        "export const GET = handlers.GET;",
+        "",
+      ].join("\n");
+      fs.writeFileSync(routePath, nextRouteContent);
+    }
+  }
+
   const configPath = path.join(cwd, "schemaapi.config.json");
   let existingConfig = null;
   if (fs.existsSync(configPath)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codexsploitx/schemaapi",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Type-safe API contracts (HTTP/WebSocket) with adapters, client and docs generator.",
   "main": "dist/schemaapi.cjs.js",
   "module": "dist/schemaapi.esm.js",

package/readme.md

@@ -45,6 +45,8 @@
 
 ## 📦 Installation
 
+### Core package
+
 ```bash
 # npm
 npm install schemaapi zod
@@ -56,6 +58,119 @@ pnpm add schemaapi zod
 yarn add schemaapi zod
 ```
 
+### Per-adapter setup
+
+Below are the recommended commands for **new projects** and for **existing projects**.
+
+#### Express
+
+- 🆕 **New project**
+
+```bash
+mkdir my-express-api && cd my-express-api
+npm init -y
+npm install express schemaapi zod
+npx schemaapi init express
+```
+
+- ♻️ **Existing Express project**
+
+```bash
+npm install schemaapi zod
+npx schemaapi init express
+```
+
+#### Next.js
+
+- 🆕 **New project**
+
+```bash
+npx create-next-app@latest my-next-api --ts
+cd my-next-api
+npm install schemaapi zod
+npx schemaapi init next
+```
+
+- ♻️ **Existing Next.js project**
+
+```bash
+npm install schemaapi zod
+npx schemaapi init next
+```
+
+El comando `schemaapi init next` creará automáticamente:
+
+- Carpeta `contracts/` con un contrato de ejemplo `usersContract.ts`.
+- `contracts/index.ts` exportando los contratos.
+- `schemaapi.config.json` apuntando a `contracts/`.
+- Un handler de ejemplo compatible con **App Router** en `app/api/users/route.ts`.
+
+#### Fastify
+
+- 🆕 **New project**
+
+```bash
+mkdir my-fastify-api && cd my-fastify-api
+npm init -y
+npm install fastify schemaapi zod
+npx schemaapi init fastify
+```
+
+- ♻️ **Existing Fastify project**
+
+```bash
+npm install schemaapi zod
+npx schemaapi init fastify
+```
+
+#### Remix
+
+- 🆕 **New project**
+
+```bash
+npx create-remix@latest
+npm install schemaapi zod
+npx schemaapi init remix
+```
+
+- ♻️ **Existing Remix project**
+
+```bash
+npm install schemaapi zod
+npx schemaapi init remix
+```
+
+#### NestJS
+
+- 🆕 **New project**
+
+```bash
+npm i -g @nestjs/cli
+nest new my-nest-api
+cd my-nest-api
+npm install schemaapi zod
+npx schemaapi init nest
+```
+
+- ♻️ **Existing NestJS project**
+
+```bash
+npm install schemaapi zod
+npx schemaapi init nest
+```
+
+#### Deno
+
+- 🆕 / ♻️ **Deno projects**
+
+En Deno no se usa npm para el runtime, pero puedes usar SchemaApi en tu
+tooling o en proyectos que usen `deno2node`. Para Node+Deno híbrido:
+
+```bash
+npm install schemaapi zod
+npx schemaapi init deno
+```
+
 ---
 
 ## 🛠 Usage