@codexsploitx/schemaapi 1.0.3 → 1.0.5

package/bin/schemaapi

@@ -23,6 +23,14 @@ function showHelp() {
   console.log("  schemaapi generate tests");
   console.log("  schemaapi audit");
   console.log("  schemaapi init <adapter>");
+  console.log("");
+  console.log("Adapters:");
+  console.log("  express");
+  console.log("  next");
+  console.log("  fastify");
+  console.log("  remix");
+  console.log("  nest");
+  console.log("  deno");
 }
 
 function loadConfig() {
@@ -228,7 +236,7 @@ function handleInit(adapterArg) {
   const usersContractPath = path.join(contractsDir, "usersContract.ts");
   if (!fs.existsSync(usersContractPath)) {
     const usersContractContent = [
-      'import { createContract } from "schemaapi";',
+      'import { createContract } from "@codexsploitx/schemaapi";',
       'import { z } from "zod";',
       "",
       "export const usersContract = createContract({",
@@ -249,6 +257,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 "@codexsploitx/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.5",
   "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

@@ -5,8 +5,8 @@
 **The Zod of APIs**  
 *Type-safe contracts. Runtime validation. Auto-generated docs.*
 
-[![npm version](https://img.shields.io/npm/v/schemaapi?style=flat-square&color=blue)](https://www.npmjs.com/package/schemaapi)
-[![License](https://img.shields.io/npm/l/schemaapi?style=flat-square&color=green)](LICENSE)
+[![npm version](https://img.shields.io/npm/v/%40codexsploitx%2Fschemaapi?style=flat-square&color=blue)](https://www.npmjs.com/package/@codexsploitx/schemaapi)
+[![License](https://img.shields.io/npm/l/%40codexsploitx%2Fschemaapi?style=flat-square&color=green)](LICENSE)
 [![Tests](https://img.shields.io/github/actions/workflow/status/CodexSploitx/SchemaApi/test.yml?label=tests&style=flat-square)](https://github.com/CodexSploitx/SchemaApi/actions)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
 
@@ -45,15 +45,140 @@
 
 ## 📦 Installation
 
+### Core package
+
 ```bash
 # npm
-npm install schemaapi zod
+npm install @codexsploitx/schemaapi zod
 
 # pnpm
-pnpm add schemaapi zod
+pnpm add @codexsploitx/schemaapi zod
 
 # yarn
-yarn add schemaapi zod
+yarn add @codexsploitx/schemaapi zod
+```
+
+### Per-adapter setup
+
+Below are the recommended commands for **new projects** and for **existing projects**.
+
+#### CLI quick reference
+
+| Adapter  | Init command                                      |
+|---------|----------------------------------------------------|
+| Express | `npx @codexsploitx/schemaapi init express`         |
+| Next.js | `npx @codexsploitx/schemaapi init next`            |
+| Fastify | `npx @codexsploitx/schemaapi init fastify`         |
+| Remix   | `npx @codexsploitx/schemaapi init remix`           |
+| NestJS  | `npx @codexsploitx/schemaapi init nest`            |
+| Deno    | `npx @codexsploitx/schemaapi init deno`            |
+
+#### Express
+
+- 🆕 **New project**
+
+```bash
+mkdir my-express-api && cd my-express-api
+npm init -y
+npm install express @codexsploitx/schemaapi zod
+npx @codexsploitx/schemaapi init express
+```
+
+- ♻️ **Existing Express project**
+
+```bash
+npm install @codexsploitx/schemaapi zod
+npx @codexsploitx/schemaapi init express
+```
+
+#### Next.js
+
+- 🆕 **New project**
+
+```bash
+npx create-next-app@latest my-next-api --ts
+cd my-next-api
+npm install @codexsploitx/schemaapi zod
+npx @codexsploitx/schemaapi init next
+```
+
+- ♻️ **Existing Next.js project**
+
+```bash
+npm install @codexsploitx/schemaapi zod
+npx @codexsploitx/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 @codexsploitx/schemaapi zod
+npx @codexsploitx/schemaapi init fastify
+```
+
+- ♻️ **Existing Fastify project**
+
+```bash
+npm install @codexsploitx/schemaapi zod
+npx @codexsploitx/schemaapi init fastify
+```
+
+#### Remix
+
+- 🆕 **New project**
+
+```bash
+npx create-remix@latest
+npm install @codexsploitx/schemaapi zod
+npx @codexsploitx/schemaapi init remix
+```
+
+- ♻️ **Existing Remix project**
+
+```bash
+npm install @codexsploitx/schemaapi zod
+npx @codexsploitx/schemaapi init remix
+
+#### NestJS
+
+- 🆕 **New project**
+
+```bash
+npm i -g @nestjs/cli
+nest new my-nest-api
+cd my-nest-api
+npm install @codexsploitx/schemaapi zod
+npx @codexsploitx/schemaapi init nest
+```
+
+- ♻️ **Existing NestJS project**
+
+```bash
+npm install @codexsploitx/schemaapi zod
+npx @codexsploitx/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 @codexsploitx/schemaapi zod
+npx @codexsploitx/schemaapi init deno
 ```
 
 ---
@@ -65,7 +190,7 @@ yarn add schemaapi zod
 Create a shared file (e.g., `contract.ts`). This is your API's law.
 
 ```typescript
-import { createContract } from "schemaapi";
+import { createContract } from "@codexsploitx/schemaapi";
 import { z } from "zod";
 
 export const contract = createContract({
@@ -116,7 +241,7 @@ app.get(
 No more manual fetch calls. No more `any`.
 
 ```typescript
-import { createClient } from "schemaapi";
+import { createClient } from "@codexsploitx/schemaapi";
 import { contract } from "./shared/contract";
 
 const client = createClient(contract, {