@sellhapi/mcp 0.0.0-stage → 0.1.2

package/dist/tools/studio.js

@@ -0,0 +1,342 @@
+"use strict";
+/**
+ * Studio tools — website lifecycle management.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerStudioTools = registerStudioTools;
+const v4_1 = require("zod/v4");
+const client_js_1 = require("../client.js");
+const util_js_1 = require("../util.js");
+const runtime_hooks_js_1 = require("../resources/runtime-hooks.js");
+const build_rules_js_1 = require("../resources/build-rules.js");
+function registerStudioTools(server) {
+    // ── List projects ──────────────────────────────────────────────────────────
+    server.registerTool("list_projects", {
+        title: "List Projects",
+        description: "List all Studio projects for this vendor. Returns project name, status, capabilities, and preview URL.",
+        annotations: { readOnlyHint: true },
+    }, async () => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.get)("/api/mcp/projects");
+        return JSON.stringify(data.projects, null, 2);
+    }));
+    // ── Get project ────────────────────────────────────────────────────────────
+    server.registerTool("get_project", {
+        title: "Get Project",
+        description: "Get full project details including current code, design direction, capabilities, and preview URL.",
+        inputSchema: { projectId: v4_1.z.string().describe("Studio project ID") },
+        annotations: { readOnlyHint: true },
+    }, async ({ projectId }) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.get)(`/api/mcp/projects/${projectId}`);
+        return JSON.stringify(data, null, 2);
+    }));
+    // ── Create project ─────────────────────────────────────────────────────────
+    server.registerTool("create_project", {
+        title: "Create Project",
+        description: "Create a new Studio project. Specify name, business type, and capabilities (physical_products, digital_products, services, appointments, events, donations, memberships, content, listings, customer_accounts). The response includes required_reading with full build rules and runtime hook signatures — read them before generating any code.",
+        inputSchema: {
+            name: v4_1.z.string().describe("Project name (e.g. 'My Fashion Store')"),
+            businessType: v4_1.z.string().optional().describe("Business type (e.g. 'fashion', 'restaurant', 'bakery')"),
+            description: v4_1.z.string().optional().describe("Brief description of the business"),
+            capabilities: v4_1.z.array(v4_1.z.string()).optional().describe("Capability IDs to enable"),
+        },
+    }, async ({ name, businessType, description, capabilities }) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.post)("/api/mcp/projects", { name, businessType, description, capabilities });
+        // Inject full reference docs so every client (ChatGPT, Claude, Cursor) has them
+        // before any code generation — regardless of whether it supports MCP Resources.
+        const result = {
+            ...data,
+            workflow: {
+                instruction: "Follow this sequence in order. Skipping steps produces a broken or unstyled website.",
+                steps: [
+                    {
+                        step: 1,
+                        tool: "apply_design_direction",
+                        required: true,
+                        description: "Generate and store a full DesignDirection — colors, fonts, pages, business context. Do this NOW before anything else. Read sellhapi://design-direction-schema for the exact shape. Present the direction summary to the user (palette, pages, mood) and get confirmation before calling apply_design_direction. Alternatively use set_design_direction to let SellHapi's Claude generate it (costs credits).",
+                    },
+                    {
+                        step: 2,
+                        tool: "apply_wireframe",
+                        required: false,
+                        description: "Optional but recommended. Generate mid-fidelity HTML wireframes for each page, present them section-by-section to the user, collect feedback, then store the approved wireframes. Read sellhapi://wireframe-schema first.",
+                    },
+                    {
+                        step: 3,
+                        tool: "push_code",
+                        required: true,
+                        description: "Generate and push the full React storefront code. Read build_rules and runtime_hooks in full before writing any code — violating build_rules causes this step to fail with a BuildGuard error.",
+                    },
+                    {
+                        step: 4,
+                        tool: "deploy_website",
+                        required: true,
+                        description: "Deploy to the live storefront ONLY after the user has reviewed the preview from push_code and confirmed it looks correct.",
+                    },
+                ],
+            },
+            required_reading: {
+                instruction: "Read build_rules and runtime_hooks in full before generating any storefront code. Violating build_rules causes push_code to fail with a BuildGuard error.",
+                build_rules: build_rules_js_1.BUILD_RULES,
+                runtime_hooks: runtime_hooks_js_1.RUNTIME_HOOKS,
+            },
+        };
+        return JSON.stringify(result, null, 2);
+    }));
+    // ── List revisions ─────────────────────────────────────────────────────────
+    server.registerTool("list_revisions", {
+        title: "List Revisions",
+        description: "List all revision history for a project. Returns version numbers, messages, and timestamps — no file payloads. Use get_revision to inspect a specific version's code.",
+        inputSchema: { projectId: v4_1.z.string().describe("Studio project ID") },
+        annotations: { readOnlyHint: true },
+    }, async ({ projectId }) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.get)(`/api/mcp/projects/${projectId}/revisions`);
+        return JSON.stringify(data.revisions, null, 2);
+    }));
+    // ── Get revision ────────────────────────────────────────────────────────────
+    server.registerTool("get_revision", {
+        title: "Get Revision",
+        description: "Get a specific revision including its full code files. Use list_revisions first to find version numbers. Files can be large — only fetch when you need to inspect or restore a specific version.",
+        inputSchema: {
+            projectId: v4_1.z.string().describe("Studio project ID"),
+            version: v4_1.z.number().int().min(1).describe("Revision version number (from list_revisions)"),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ projectId, version }) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.get)(`/api/mcp/projects/${projectId}/revisions/${version}`);
+        return JSON.stringify(data.revision, null, 2);
+    }));
+    // ── Restore revision ────────────────────────────────────────────────────────
+    server.registerTool("restore_revision", {
+        title: "Restore Revision",
+        description: "Restore a project to a specific revision. Atomically restores code, design direction, wireframes, and conversation history from that snapshot, creates an audit entry, then rebuilds and returns a preview URL. History grows forward — the restore is recorded as a new revision.",
+        inputSchema: {
+            projectId: v4_1.z.string().describe("Studio project ID"),
+            version: v4_1.z.number().int().min(1).describe("Revision version number to restore to"),
+        },
+    }, async ({ projectId, version }) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.post)(`/api/mcp/projects/${projectId}/revisions/${version}/restore`);
+        return JSON.stringify(data, null, 2);
+    }));
+    // ── Push code (zero credits) ───────────────────────────────────────────────
+    server.registerTool("push_code", {
+        title: "Push Code",
+        description: "Push client-generated React code to a project. Runs BuildGuard validation + esbuild bundling and returns a preview URL. ZERO AI credit cost — you generate the code, SellHapi only builds it. CRITICAL RULES: (1) import ONLY from @sellhapi/studio-runtime and react — NO external packages; (2) every top-level JSX section must have data-region, data-label, data-scope attributes; (3) NO inline style={{}} — use Tailwind only; (4) NO localStorage/sessionStorage for state management — EXCEPTION: window.location.href IS required and allowed for payment redirects (all commerce hooks return { paymentLink } — redirect with window.location.href = result.paymentLink); (5) prices via priceKobo / 100 — never hardcode currency. Call get_build_rules or get_runtime_hooks for full reference.",
+        inputSchema: {
+            projectId: v4_1.z.string().describe("Studio project ID"),
+            files: v4_1.z.record(v4_1.z.string(), v4_1.z.string()).describe("Map of filename → code content. Must include App.tsx as entry point."),
+        },
+    }, async ({ projectId, files }) => {
+        try {
+            const data = await (0, client_js_1.post)(`/api/mcp/projects/${projectId}/push-code`, { files });
+            // Surface capability warnings prominently so the AI client acts on them
+            const warnings = data.capabilityWarnings ?? [];
+            const lines = [JSON.stringify(data, null, 2)];
+            if (warnings.length > 0) {
+                lines.push("", "⚠ BuildGuard warnings — fix before deploying:", ...warnings.map((w, i) => `${i + 1}. [${w.rule}] ${w.message}${w.fix ? `\n   Fix: ${w.fix}` : ""}`));
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (err) {
+            // Surface BuildGuard violations as structured data for AI retry
+            if (err instanceof client_js_1.ApiError && err.body?.violations) {
+                const msg = [
+                    `BuildGuard violation — fix these issues and push again:`,
+                    "",
+                    ...err.body.violations.map((v, i) => `${i + 1}. [${v.severity ?? "error"}] ${v.message}${v.file ? ` (${v.file}:${v.line ?? "?"})` : ""}`),
+                ].join("\n");
+                return { content: [{ type: "text", text: msg }] };
+            }
+            return {
+                content: [{ type: "text", text: `Error: ${err?.message ?? String(err)}` }],
+            };
+        }
+    });
+    // ── Patch code (zero credits) ──────────────────────────────────────────────
+    server.registerTool("patch_code", {
+        title: "Patch Code",
+        description: "Send ONLY the files you changed. Merges them into the project's existing code, then runs BuildGuard + esbuild and returns a preview URL. Use this for targeted edits — changing one section, fixing a bug, tweaking styles — when you don't need to resend the entire project. Use push_code when you're generating the site from scratch or replacing all files.",
+        inputSchema: {
+            projectId: v4_1.z.string().describe("Studio project ID"),
+            files: v4_1.z.record(v4_1.z.string(), v4_1.z.string()).describe("Only the files that changed. Keys are filenames (e.g. 'HeroSection.tsx'), values are full file content. Other files in the project are preserved unchanged."),
+        },
+    }, async ({ projectId, files }) => {
+        try {
+            const data = await (0, client_js_1.post)(`/api/mcp/projects/${projectId}/patch-code`, { files });
+            const warnings = data.capabilityWarnings ?? [];
+            const lines = [JSON.stringify(data, null, 2)];
+            if (warnings.length > 0) {
+                lines.push("", "⚠ BuildGuard warnings — fix before deploying:", ...warnings.map((w, i) => `${i + 1}. [${w.rule}] ${w.message}${w.fix ? `\n   Fix: ${w.fix}` : ""}`));
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (err) {
+            if (err instanceof client_js_1.ApiError && err.body?.violations) {
+                const msg = [
+                    `BuildGuard violation — fix these issues and patch again:`,
+                    "",
+                    ...err.body.violations.map((v, i) => `${i + 1}. [${v.severity ?? "error"}] ${v.message}${v.file ? ` (${v.file}:${v.line ?? "?"})` : ""}`),
+                ].join("\n");
+                return { content: [{ type: "text", text: msg }] };
+            }
+            return {
+                content: [{ type: "text", text: `Error: ${err?.message ?? String(err)}` }],
+            };
+        }
+    });
+    // ── Deploy website ─────────────────────────────────────────────────────────
+    server.registerTool("deploy_website", {
+        title: "Deploy Website",
+        description: "Deploy the project to the live storefront. Only call this AFTER push_code succeeds and the user has confirmed the preview looks good. Compiles, bundles, and publishes to the vendor's custom domain or sellhapi.shop subdomain.",
+        inputSchema: {
+            projectId: v4_1.z.string().describe("Studio project ID"),
+        },
+    }, async ({ projectId }) => {
+        try {
+            const data = await (0, client_js_1.post)(`/api/mcp/projects/${projectId}/publish`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (err) {
+            if (err instanceof client_js_1.ApiError && err.body?.violations) {
+                const msg = [
+                    `Build failed during deploy — fix these issues:`,
+                    "",
+                    ...err.body.violations.map((v, i) => `${i + 1}. [${v.severity ?? "error"}] ${v.message}${v.file ? ` (${v.file}:${v.line ?? "?"})` : ""}`),
+                ].join("\n");
+                return { content: [{ type: "text", text: msg }] };
+            }
+            return {
+                content: [{ type: "text", text: `Error: ${err?.message ?? String(err)}` }],
+            };
+        }
+    });
+    // ── Get preview ────────────────────────────────────────────────────────────
+    server.registerTool("get_preview", {
+        title: "Get Preview URL",
+        description: "Get the current sandbox preview URL for a project.",
+        inputSchema: {
+            projectId: v4_1.z.string().describe("Studio project ID"),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ projectId }) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.get)(`/api/mcp/projects/${projectId}`);
+        return JSON.stringify({ previewUrl: data.previewUrl ?? null }, null, 2);
+    }));
+    // ── Get vendor context ─────────────────────────────────────────────────────
+    server.registerTool("get_vendor_context", {
+        title: "Get Vendor Context",
+        description: "CALL THIS FIRST before writing any storefront code. Returns in a single call: active capability IDs, store slug, business name and category, product count, collection names, and service names. Eliminates the 4-call context-gathering chain and ensures code is generated for the actual store contents.",
+        annotations: { readOnlyHint: true },
+    }, async () => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.get)("/api/mcp/vendor-context");
+        return JSON.stringify(data, null, 2);
+    }));
+    // ── Suggest capabilities ───────────────────────────────────────────────────
+    server.registerTool("suggest_capabilities", {
+        title: "Suggest Capabilities",
+        description: "Given a business brief, returns a ranked list of capability IDs to activate. Uses keyword matching against the platform capability registry — no LLM cost. Call after get_vendor_context to identify which capabilities are missing. Examples: 'Lagos bakery selling bread and custom cakes' → physical_products + appointments. 'DJ booking agency' → services + appointments.",
+        inputSchema: {
+            brief: v4_1.z.string().describe("Business description or brief text — what the business does, what it sells, its services"),
+        },
+    }, async ({ brief }) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.post)("/api/mcp/suggest-capabilities", { brief });
+        return JSON.stringify(data, null, 2);
+    }));
+    // ── Import website content ─────────────────────────────────────────────────
+    server.registerTool("import_website_content", {
+        title: "Import Website Content",
+        description: "Scrape up to 6 pages of an existing website via Firecrawl and store the combined markdown as contentBrief on the project. Use this when the vendor wants to pull copy (headlines, taglines, service descriptions, about text) from their current website into the new one. Returns the scraped content — use it to inform businessContext in apply_design_direction and to pre-fill section copy in the wireframe. Different from analyze_reference: this extracts full page copy, not just OG metadata.",
+        inputSchema: {
+            projectId: v4_1.z.string().describe("Studio project ID"),
+            urls: v4_1.z.array(v4_1.z.string()).min(1).max(6).describe("URLs to scrape — homepage first, then inner pages (e.g. /about, /services). Max 6. Must be publicly accessible https URLs."),
+        },
+    }, async ({ projectId, urls }) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.post)(`/api/mcp/projects/${projectId}/import-website-content`, { urls });
+        return JSON.stringify(data, null, 2);
+    }));
+    // ── Apply design direction (zero cost — client generates) ─────────────────
+    server.registerTool("apply_design_direction", {
+        title: "Apply Design Direction",
+        description: "Store a DesignDirection JSON object you generated yourself on a project. ZERO Claude API cost — your LLM does the work. Read sellhapi://design-direction-schema first to understand the exact shape. After generating the direction, show the summary (palette, pages, mood) to the user and get confirmation before calling this. Returns the stored designDirection.",
+        inputSchema: {
+            projectId: v4_1.z.string().describe("Studio project ID"),
+            direction: v4_1.z.record(v4_1.z.string(), v4_1.z.unknown()).describe("Complete DesignDirection object. Must include: businessType, capabilityIds, pages (slug+title+sections), visualDirection (colors+fonts+style tokens), businessContext (name+tagline+targetAudience+USPs)."),
+        },
+    }, async ({ projectId, direction }) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.post)(`/api/mcp/projects/${projectId}/apply-direction`, { direction });
+        return JSON.stringify(data, null, 2);
+    }));
+    // ── Set design direction (SellHapi's Claude generates — costs credits) ─────
+    server.registerTool("set_design_direction", {
+        title: "Set Design Direction (AI-generated)",
+        description: "Ask SellHapi's Claude to generate a design direction from a plain-text brief. NOTE: costs AI credits. Prefer apply_design_direction instead — read sellhapi://design-direction-schema and generate the direction yourself for free. Use this only when the brief is very ambiguous and you want SellHapi's AI to interpret it.",
+        inputSchema: {
+            projectId: v4_1.z.string().describe("Studio project ID"),
+            brief: v4_1.z.string().describe("Design brief — business description, desired mood, target audience, visual references. The richer the better."),
+            storeType: v4_1.z.string().optional().describe("Store category hint for layout optimisation: fashion | beauty | food | electronics | general"),
+        },
+    }, async ({ projectId, brief, storeType }) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.post)(`/api/mcp/projects/${projectId}/design-direction`, { brief, storeType });
+        return JSON.stringify(data, null, 2);
+    }));
+    // ── Apply wireframe (zero cost — client generates, user approves) ──────────
+    server.registerTool("apply_wireframe", {
+        title: "Apply Wireframe",
+        description: "Store approved mid-fidelity HTML wireframes on a project — one per page. ZERO Claude API cost. IMPORTANT: Read sellhapi://wireframe-schema first. Generate wireframe HTML for each page, present each one to the user in plain text (section-by-section summary), collect feedback, revise if needed, then call this ONLY after the user explicitly approves all pages. The wireframe is the user's last checkpoint before code is written.",
+        inputSchema: {
+            projectId: v4_1.z.string().describe("Studio project ID"),
+            wireframes: v4_1.z.record(v4_1.z.string(), v4_1.z.string()).describe("Map of pageSlug → mid-fidelity HTML string. Each slug must match one in designDirection.pages."),
+        },
+    }, async ({ projectId, wireframes }) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.post)(`/api/mcp/projects/${projectId}/apply-wireframe`, { wireframes });
+        return JSON.stringify(data, null, 2);
+    }));
+    // ── Analyze design image / website / Pinterest pins (costs Claude credits) ─
+    server.registerTool("analyze_design_reference", {
+        title: "Analyze Design Reference (Visual)",
+        description: "Send a design reference image URL, website URL, or Pinterest pins to Claude vision and get back a fully populated DesignDirection. Use when the user provides a visual reference (screenshot, moodboard, inspiration website, Pinterest board). Three exclusive modes: imageUrl (direct image link), websiteUrl (screenshotted + analyzed), pinUrls (up to 4 pin.it or pinterest.com/pin/ URLs synthesized into one direction). NOTE: costs AI credits — prefer apply_design_direction when you can derive the direction yourself from conversation context.",
+        inputSchema: {
+            projectId: v4_1.z.string().describe("Studio project ID"),
+            imageUrl: v4_1.z.string().optional().describe("Direct image URL to analyze (http/https, publicly accessible). Use when user pastes an image link."),
+            websiteUrl: v4_1.z.string().optional().describe("Website URL to screenshot and analyze for visual inspiration. Different from import_website_content which extracts copy — this extracts visual design DNA."),
+            pinUrls: v4_1.z.array(v4_1.z.string()).min(1).max(4).optional().describe("Up to 4 pin.it or pinterest.com/pin/ URLs. Synthesized into a single unified design direction."),
+            brief: v4_1.z.string().optional().describe("Optional vendor context to guide interpretation (business type, target audience, etc.)"),
+            mode: v4_1.z.enum(["inspiration", "recreate"]).optional().describe("inspiration (default): adapt visual DNA to the business. recreate: match the reference as closely as possible."),
+        },
+    }, async ({ projectId, imageUrl, websiteUrl, pinUrls, brief, mode }) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.post)(`/api/mcp/projects/${projectId}/analyze-image`, { imageUrl, websiteUrl, pinUrls, brief, mode });
+        return JSON.stringify(data, null, 2);
+    }));
+    // ── Analyze reference URL ──────────────────────────────────────────────────
+    server.registerTool("analyze_reference", {
+        title: "Analyze Reference URL",
+        description: "Fetch OG metadata, page title, description, and theme-color hint from any URL. Returns a suggestedBrief string you can pass directly to set_design_direction. Use this when the user provides a reference website they want to draw inspiration from.",
+        inputSchema: {
+            url: v4_1.z.string().describe("URL to analyze — must be https://. The server fetches this directly with a 6-second timeout."),
+        },
+    }, async ({ url }) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.post)("/api/mcp/analyze-reference", { url });
+        return JSON.stringify(data, null, 2);
+    }));
+    // ── Get build rules (mid-session reference) ────────────────────────────────
+    server.registerTool("get_build_rules", {
+        title: "Get Build Rules",
+        description: "Returns the full BuildGuard validation rules — every constraint push_code enforces. Call this when push_code fails with a BuildGuard violation and you need to understand the rule in full detail, or whenever you need a refresher on what code patterns are allowed.",
+        annotations: { readOnlyHint: true },
+    }, async () => ({
+        content: [{ type: "text", text: build_rules_js_1.BUILD_RULES }],
+    }));
+    // ── Get runtime hooks (mid-session reference) ──────────────────────────────
+    server.registerTool("get_runtime_hooks", {
+        title: "Get Runtime Hooks",
+        description: "Returns the complete @sellhapi/studio-runtime hook reference — every hook, its signature, return shape, and usage example. Call this when you need to look up how a specific hook works (e.g. useProducts, useBookAppointment, useCart) before writing or fixing code.",
+        annotations: { readOnlyHint: true },
+    }, async () => ({
+        content: [{ type: "text", text: runtime_hooks_js_1.RUNTIME_HOOKS }],
+    }));
+}

package/dist/util.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared utilities for the MCP server.
+ */
+/** MCP tool content result shape. */
+type ToolResult = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+/**
+ * Wraps a tool callback with structured error handling.
+ * Returns the stringified result on success, or an isError response on failure.
+ */
+export declare function safeCall(fn: () => Promise<string>): Promise<ToolResult>;
+export {};

package/dist/util.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Shared utilities for the MCP server.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeCall = safeCall;
+/**
+ * Wraps a tool callback with structured error handling.
+ * Returns the stringified result on success, or an isError response on failure.
+ */
+async function safeCall(fn) {
+    try {
+        const text = await fn();
+        return { content: [{ type: "text", text }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Error: ${err?.message ?? String(err)}` }],
+        };
+    }
+}

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@sellhapi/mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.2",
+  "description": "SellHapi MCP server — build and manage SellHapi storefronts from AI tools",
+  "bin": {
+    "sellhapi-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "start:hosted": "node dist/hosted.js"
+  },
+  "keywords": [
+    "mcp",
+    "sellhapi",
+    "ai",
+    "storefront",
+    "commerce"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ]
+}