@pepshlr/pepdoc 0.2.2 → 0.2.3

package/dist/bin/postinstall.d.ts

@@ -1,14 +1,7 @@
 #!/usr/bin/env node
 /**
- * PepsDoc - Post-install onboarding message
- * Uses stderr so npm always shows it (stdout is suppressed for dependency scripts)
+ * PepsDoc - Post-install onboarding
+ * Creates PEPSDOC.md in the user's project root so it appears in VS Code
  */
-declare const PURPLE = "\u001B[35m";
-declare const GREEN = "\u001B[32m";
-declare const YELLOW = "\u001B[33m";
-declare const DIM = "\u001B[2m";
-declare const RESET = "\u001B[0m";
-declare const BOLD = "\u001B[1m";
-declare const line: string;
-declare const lines: string[];
+export {};
 //# sourceMappingURL=postinstall.d.ts.map

package/dist/bin/postinstall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postinstall.d.ts","sourceRoot":"","sources":["../../src/bin/postinstall.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,QAAA,MAAM,MAAM,eAAa,CAAC;AAC1B,QAAA,MAAM,KAAK,eAAa,CAAC;AACzB,QAAA,MAAM,MAAM,eAAa,CAAC;AAC1B,QAAA,MAAM,GAAG,cAAY,CAAC;AACtB,QAAA,MAAM,KAAK,cAAY,CAAC;AACxB,QAAA,MAAM,IAAI,cAAY,CAAC;AAEvB,QAAA,MAAM,IAAI,QAAiB,CAAC;AAE5B,QAAA,MAAM,KAAK,UAyBV,CAAC"}
+{"version":3,"file":"postinstall.d.ts","sourceRoot":"","sources":["../../src/bin/postinstall.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/bin/postinstall.js

@@ -1,41 +1,81 @@
 #!/usr/bin/env node
 "use strict";
 /**
- * PepsDoc - Post-install onboarding message
- * Uses stderr so npm always shows it (stdout is suppressed for dependency scripts)
+ * PepsDoc - Post-install onboarding
+ * Creates PEPSDOC.md in the user's project root so it appears in VS Code
  */
-const PURPLE = '\x1b[35m';
-const GREEN = '\x1b[32m';
-const YELLOW = '\x1b[33m';
-const DIM = '\x1b[2m';
-const RESET = '\x1b[0m';
-const BOLD = '\x1b[1m';
-const line = '─'.repeat(58);
-const lines = [
-    '',
-    `  ${PURPLE}${BOLD}✦ PepsDoc${RESET} installed!`,
-    '',
-    `  ${GREEN}${BOLD}Let AI document your entire API automatically.${RESET}`,
-    `  ${DIM}Copy the prompt below and paste it into your AI assistant:${RESET}`,
-    '',
-    `  ┌${line}┐`,
-    `  │ ${YELLOW}pepsdoc: integrate and document my entire API            ${RESET} │`,
-    `  │                                                          │`,
-    `  │ @pepshlr/pepdoc is already installed. Do the following:  │`,
-    `  │                                                          │`,
-    `  │ 1. Find my main server file and add the adapter:         │`,
-    `  │    Express → pepsdoc(app, { title: '...' })              │`,
-    `  │    Fastify → fastifyAdapter(app, { title: '...' })       │`,
-    `  │    Hono    → honoAdapter(app, { title: '...' })          │`,
-    `  │                                                          │`,
-    `  │ 2. Read all route files in the project and generate      │`,
-    `  │    JSON docs in pepsdoc/data/v1/ (one file per group).   │`,
-    `  │    Schema: node_modules/@pepshlr/pepdoc/templates/       │`,
-    `  │            ai-skill.md                                   │`,
-    `  │                                                          │`,
-    `  │ 3. Start the server and tell me the docs URL.            │`,
-    `  └${line}┘`,
-    '',
-];
-process.stderr.write(lines.join('\n') + '\n');
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// INIT_CWD = the directory where the user ran `npm install`
+const projectRoot = process.env.INIT_CWD || process.cwd();
+const outputFile = path.join(projectRoot, 'PEPSDOC.md');
+// Don't run inside the pepsdoc package itself
+if (projectRoot.includes('pepsdoc') && !process.env.INIT_CWD) {
+    process.exit(0);
+}
+const content = `# PepsDoc is ready!
+
+Paste the prompt below into your AI assistant and it will set everything up automatically:
+
+---
+
+\`\`\`
+@pepshlr/pepdoc is already installed. Do the following:
+
+1. Find my main server file and add the adapter:
+   - Express  → const { pepsdoc } = require('@pepshlr/pepdoc'); pepsdoc(app, { title: 'My API' })
+   - Fastify  → const { fastifyAdapter } = require('@pepshlr/pepdoc'); fastifyAdapter(app, { title: 'My API' })
+   - Hono     → const { honoAdapter } = require('@pepshlr/pepdoc'); honoAdapter(app, { title: 'My API' })
+
+2. Read all route files in the project and generate JSON documentation
+   files in pepsdoc/data/v1/ (one file per group of routes).
+   Follow the schema in: node_modules/@pepshlr/pepdoc/templates/ai-skill.md
+
+3. Start the server and tell me the URL to access the docs.
+\`\`\`
+
+---
+
+You can delete this file after setting up.
+`;
+try {
+    fs.writeFileSync(outputFile, content);
+}
+catch {
+    // Silently ignore — don't break the install
+}
 //# sourceMappingURL=postinstall.js.map

package/dist/bin/postinstall.js.map

@@ -1 +1 @@
-{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../../src/bin/postinstall.ts"],"names":[],"mappings":";;AAEA;;;GAGG;AAEH,MAAM,MAAM,GAAG,UAAU,CAAC;AAC1B,MAAM,KAAK,GAAG,UAAU,CAAC;AACzB,MAAM,MAAM,GAAG,UAAU,CAAC;AAC1B,MAAM,GAAG,GAAG,SAAS,CAAC;AACtB,MAAM,KAAK,GAAG,SAAS,CAAC;AACxB,MAAM,IAAI,GAAG,SAAS,CAAC;AAEvB,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE5B,MAAM,KAAK,GAAG;IACZ,EAAE;IACF,KAAK,MAAM,GAAG,IAAI,YAAY,KAAK,aAAa;IAChD,EAAE;IACF,KAAK,KAAK,GAAG,IAAI,iDAAiD,KAAK,EAAE;IACzE,KAAK,GAAG,6DAA6D,KAAK,EAAE;IAC5E,EAAE;IACF,MAAM,IAAI,GAAG;IACb,OAAO,MAAM,4DAA4D,KAAK,IAAI;IAClF,gEAAgE;IAChE,gEAAgE;IAChE,gEAAgE;IAChE,gEAAgE;IAChE,gEAAgE;IAChE,gEAAgE;IAChE,gEAAgE;IAChE,gEAAgE;IAChE,gEAAgE;IAChE,gEAAgE;IAChE,gEAAgE;IAChE,gEAAgE;IAChE,gEAAgE;IAChE,gEAAgE;IAChE,MAAM,IAAI,GAAG;IACb,EAAE;CACH,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC"}
+{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../../src/bin/postinstall.ts"],"names":[],"mappings":";;AAEA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAE7B,4DAA4D;AAC5D,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AAExD,8CAA8C;AAC9C,IAAI,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBf,CAAC;AAEF,IAAI,CAAC;IACH,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC;AAAC,MAAM,CAAC;IACP,4CAA4C;AAC9C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pepshlr/pepdoc",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "API documentation, beautifully automated.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",