{"_id":"@axolot-ai/sdk","_rev":"5-0b7ba3fa351484f69d44ff07c5cf0ef4","name":"@axolot-ai/sdk","dist-tags":{"latest":"0.0.5"},"versions":{"0.0.1":{"name":"@axolot-ai/sdk","version":"0.0.1","_id":"@axolot-ai/sdk@0.0.1","maintainers":[{"name":"axolotagency","email":"axolotcontacto@gmail.com"}],"dist":{"shasum":"f8bdfec8698cb95ac781d1e87294ed819cf48da3","tarball":"https://registry.npmjs.org/@axolot-ai/sdk/-/sdk-0.0.1.tgz","fileCount":15,"integrity":"sha512-6UI4HTN+k28grMNp07RKBiQR2InOE15SX5ML4jzh6o68IPEb/tVUR2LgeQKs9ev4p4mmZNzVeXp7vC3dYS55mA==","signatures":[{"sig":"MEUCIAfyfYbw4+zTTwnFAJ/u7uFB2rSJ9wX82drvmgfTSitWAiEA5+0S9jAXvqZgb4eOyAwo84Po/Cfv8WKFSfFJDo5/3GA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20769},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":"./dist/index.js","./cms":"./dist/lib/cms.js","./components":"./dist/components/index.js"},"gitHead":"def1b6d9690829d91870e91f24cf364969b08704","scripts":{"lint":"tsc --noEmit","build":"tsc"},"_npmUser":{"name":"axolotagency","email":"axolotcontacto@gmail.com"},"_npmVersion":"10.9.3","description":"The AI-native CMS infrastructure for Astro.","directories":{},"_nodeVersion":"22.18.0","dependencies":{"astro":"^5.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.0.1_1778871955108_0.5106305872719652","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@axolot-ai/sdk","version":"0.0.2","_id":"@axolot-ai/sdk@0.0.2","maintainers":[{"name":"axolotagency","email":"axolotcontacto@gmail.com"}],"homepage":"https://github.com/AxolotDevelopment/Axolot-SDK#readme","bugs":{"url":"https://github.com/AxolotDevelopment/Axolot-SDK/issues"},"dist":{"shasum":"1fabc7560577b08f48cc3235d9560e8da4a702d6","tarball":"https://registry.npmjs.org/@axolot-ai/sdk/-/sdk-0.0.2.tgz","fileCount":12,"integrity":"sha512-UsLF6yy+A2+khvq/0mQrk7ZTYHTpNn1T/hytqNr/OzVKU5q1MCYG1IdKzv5klF0B10rqht6kb7BT/l9l8jr8Ug==","signatures":[{"sig":"MEUCIQDmRNDoFAZsv4ESFxUjji6ue75Rosf9BxfcfGtl9ntLngIgCOTOFriD6al+U/5BDjj/+sr08vLZH/DiWoHy0OILxoA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38925},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./cms":{"types":"./dist/lib/cms.d.ts","default":"./dist/lib/cms.js"},"./components":{"types":"./dist/components/index.d.ts","default":"./dist/components/index.js"}},"gitHead":"33c42f951a52a08d45cb502b70bf10f6aedb2b0a","scripts":{"lint":"tsc --noEmit","build":"tsup"},"_npmUser":{"name":"axolotagency","email":"axolotcontacto@gmail.com"},"repository":{"url":"git+https://github.com/AxolotDevelopment/Axolot-SDK.git","type":"git"},"_npmVersion":"10.9.3","description":"[![NPM Version](https://img.shields.io/npm/v/@axolot-ai/sdk?color=E67E22&style=flat-square)](https://www.npmjs.com/package/@axolot-ai/sdk) [![Astro Version](https://img.shields.io/badge/Astro-v5.0+-BC3FEE?style=flat-square)](https://astro.build) [![Licens","directories":{},"_nodeVersion":"22.18.0","dependencies":{"ws":"^8.18.0","astro":"^5.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","@types/ws":"^8.5.14","typescript":"^5.8.3"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.0.2_1779511130387_0.09049660263756065","host":"s3://npm-registry-packages-npm-production"}},"0.0.3":{"name":"@axolot-ai/sdk","version":"0.0.3","license":"MIT","_id":"@axolot-ai/sdk@0.0.3","maintainers":[{"name":"axolotagency","email":"axolotcontacto@gmail.com"}],"homepage":"https://github.com/AxolotDevelopment/Axolot-SDK#readme","bugs":{"url":"https://github.com/AxolotDevelopment/Axolot-SDK/issues"},"dist":{"shasum":"6488064b178904cfd564269298dc4059f5800132","tarball":"https://registry.npmjs.org/@axolot-ai/sdk/-/sdk-0.0.3.tgz","fileCount":12,"integrity":"sha512-fVZ83F6BdYYfTDeDbX4fQvFBda+u8ovtsEoB/loMFhhiieaYwixtr38N4ey6Gl768TdwE/szOJcPHwUOo2urnQ==","signatures":[{"sig":"MEYCIQC82kWAl6SsWsD7Hj3L07T5nbKXzn91ZmDHfU1eChTKbAIhAMcGFx/j5t38kafa+tSBO8g11H9BS5dAufeGSzvkJtkF","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38945},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./cms":{"types":"./dist/lib/cms.d.ts","default":"./dist/lib/cms.js"},"./components":{"types":"./dist/components/index.d.ts","default":"./dist/components/index.js"}},"gitHead":"88ff87f9a4ddbcb9b38bf68883ac629ccfb93e29","scripts":{"lint":"tsc --noEmit","build":"tsup"},"_npmUser":{"name":"axolotagency","email":"axolotcontacto@gmail.com"},"repository":{"url":"git+https://github.com/AxolotDevelopment/Axolot-SDK.git","type":"git"},"_npmVersion":"10.9.3","description":"[![NPM Version](https://img.shields.io/npm/v/@axolot-ai/sdk?color=E67E22&style=flat-square)](https://www.npmjs.com/package/@axolot-ai/sdk) [![Astro Version](https://img.shields.io/badge/Astro-v5.0+-BC3FEE?style=flat-square)](https://astro.build) [![Licens","directories":{},"_nodeVersion":"22.18.0","dependencies":{"ws":"^8.18.0","astro":"^5.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","@types/ws":"^8.5.14","typescript":"^5.8.3"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.0.3_1779512283944_0.9001637303357546","host":"s3://npm-registry-packages-npm-production"}},"0.0.4":{"name":"@axolot-ai/sdk","version":"0.0.4","license":"MIT","_id":"@axolot-ai/sdk@0.0.4","maintainers":[{"name":"axolotagency","email":"axolotcontacto@gmail.com"}],"homepage":"https://github.com/AxolotDevelopment/Axolot-SDK#readme","bugs":{"url":"https://github.com/AxolotDevelopment/Axolot-SDK/issues"},"dist":{"shasum":"7593767e38246b9946f7723975974e63b29d0dd4","tarball":"https://registry.npmjs.org/@axolot-ai/sdk/-/sdk-0.0.4.tgz","fileCount":12,"integrity":"sha512-yE69kJKpJ696ZPZCwC3tpwxCg94LMDER5s9u/f7mjfsvBOTaPnUjwhPeKyhmVjicS4eYKen9BJqQb8LyTy62xg==","signatures":[{"sig":"MEYCIQD17Fu9H7WQQUoBCsrwq0NzoBpLU42ilST6Mut+90LEnwIhAOhL+Bkb5BuGg9Mn0J4RhbDAdaiLHmhRtcoLWdKFtEX8","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":51245},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./cms":{"types":"./dist/lib/cms.d.ts","default":"./dist/lib/cms.js"},"./components":{"types":"./dist/components/index.d.ts","default":"./dist/components/index.js"}},"gitHead":"25935af0369141a3103ab7eb728d85e2a6e96013","scripts":{"lint":"tsc --noEmit","build":"tsup"},"_npmUser":{"name":"axolotagency","email":"axolotcontacto@gmail.com"},"repository":{"url":"git+https://github.com/AxolotDevelopment/Axolot-SDK.git","type":"git"},"_npmVersion":"10.9.3","description":"[![NPM Version](https://img.shields.io/npm/v/@axolot-ai/sdk?color=E67E22&style=flat-square)](https://www.npmjs.com/package/@axolot-ai/sdk) [![Astro Version](https://img.shields.io/badge/Astro-v5.0+-BC3FEE?style=flat-square)](https://astro.build) [![Licens","directories":{},"_nodeVersion":"22.18.0","dependencies":{"ws":"^8.18.0","astro":"^5.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","@types/ws":"^8.5.14","typescript":"^5.8.3"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.0.4_1779846101455_0.9427469890152018","host":"s3://npm-registry-packages-npm-production"}},"0.0.5":{"name":"@axolot-ai/sdk","version":"0.0.5","license":"MIT","repository":{"type":"git","url":"git+https://github.com/AxolotDevelopment/Axolot-SDK.git"},"description":"The AI-Native Visual Headless CMS integration for Astro. Connect layouts with WebSocket tunnels and local MCP servers.","keywords":["astro","cms","headless-cms","visual-cms","visual-editor","mcp-server","model-context-protocol","ai-native","astro-integration","typescript"],"bugs":{"url":"https://github.com/AxolotDevelopment/Axolot-SDK/issues"},"homepage":"https://github.com/AxolotDevelopment/Axolot-SDK#readme","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./components":{"types":"./dist/components/index.d.ts","default":"./dist/components/index.js"},"./cms":{"types":"./dist/lib/cms.d.ts","default":"./dist/lib/cms.js"},"./middleware":{"types":"./dist/middleware.d.ts","default":"./dist/middleware.js"}},"dependencies":{"astro":"^5.0.0","ws":"^8.18.0"},"devDependencies":{"@types/ws":"^8.5.14","tsup":"^8.5.1","typescript":"^5.8.3"},"scripts":{"build":"tsup","lint":"tsc --noEmit"},"_id":"@axolot-ai/sdk@0.0.5","_integrity":"sha512-5BavDnH8yz9A3kz6K+e0yFmjc9hJKYOfrkExbyQCtvQZBT72pZrX0lYH55MnYloDkBxf0ZVAhjpz+0fNrza/hA==","_resolved":"C:\\Users\\byhug\\AppData\\Local\\Temp\\da1501afe02aa65af1d72c5415d006aa\\axolot-ai-sdk-0.0.5.tgz","_from":"file:axolot-ai-sdk-0.0.5.tgz","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-5BavDnH8yz9A3kz6K+e0yFmjc9hJKYOfrkExbyQCtvQZBT72pZrX0lYH55MnYloDkBxf0ZVAhjpz+0fNrza/hA==","shasum":"448d667fb38e36e969b60a7fa993e93b8d790b9c","tarball":"https://registry.npmjs.org/@axolot-ai/sdk/-/sdk-0.0.5.tgz","fileCount":14,"unpackedSize":63365,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCMEIgqgwHqdPb+z+HH53u+j2agHoqNdvOiZ2io1RDq1wIgMsvHSLNysBIY0hl2q4I5los3AFQcTxGZ2AWst868bVA="}]},"_npmUser":{"name":"axolotagency","email":"axolotcontacto@gmail.com"},"directories":{},"maintainers":[{"name":"axolotagency","email":"axolotcontacto@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_0.0.5_1780065361788_0.35353229869227754"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-15T19:05:55.025Z","modified":"2026-05-29T14:36:02.059Z","0.0.1":"2026-05-15T19:05:55.265Z","0.0.2":"2026-05-23T04:38:50.540Z","0.0.3":"2026-05-23T04:58:04.088Z","0.0.4":"2026-05-27T01:41:41.609Z","0.0.5":"2026-05-29T14:36:01.948Z"},"bugs":{"url":"https://github.com/AxolotDevelopment/Axolot-SDK/issues"},"license":"MIT","homepage":"https://github.com/AxolotDevelopment/Axolot-SDK#readme","repository":{"type":"git","url":"git+https://github.com/AxolotDevelopment/Axolot-SDK.git"},"description":"The AI-Native Visual Headless CMS integration for Astro. Connect layouts with WebSocket tunnels and local MCP servers.","maintainers":[{"name":"axolotagency","email":"axolotcontacto@gmail.com"}],"readme":"#  Axolot SDK — The AI-Native CMS Integration for Astro\n\n[![NPM Version](https://img.shields.io/npm/v/@axolot-ai/sdk?color=E67E22&style=flat-square)](https://www.npmjs.com/package/@axolot-ai/sdk)\n[![Astro Version](https://img.shields.io/badge/Astro-v5.0+-BC3FEE?style=flat-square)](https://astro.build)\n[![License](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](https://github.com/axolot-ai/sdk/blob/main/LICENSE)\n\n**Axolot SDK** (`@axolot-ai/sdk`) is the developer gateway to **Axolot CMS** — an ultra-lightweight, modular, and AI-native multi-tenant headless CMS built specifically for web design agencies and modern frontend developers.\n\nIt connects your local **Astro** layouts directly with the **Axolot Live Visual Editor** and autonomous AI agents, combining absolute design control with no-code client content editing.\n\n> 💡 **The Philosophy**: **Apple simplicity. Developer power. AI-native.**\n\n---\n\n## ⚡ Why Axolot SDK?\n\nUnlike traditional heavy database-driven CMSs (like WordPress) or complex API-only headless CMSs (like Contentful), Axolot works **code-first**:\n\n*   **Zero Production JavaScript (Zero JS)**: The SDK parses and processes everything at build time. Your production site compiles to pure static HTML/CSS with a **Lighthouse Performance Score of 100**.\n*   **Surgical Local Code Updates**: During development, the SDK starts a secure WebSocket dev tunnel. When the client edits text or images in the cloud editor, changes are written **directly** into your local `.astro` files as clean code.\n*   **AI-Native & MCP Powered**: Exposes a direct link to the Model Context Protocol (MCP) server, allowing local AI assistants (Cursor, Claude Desktop, Antigravity) to read design tokens, upload media, and build sections using your exact CSS system.\n*   **Structured Content Modules**: Built-in support for standard modules like **Blog Pro**, **Tienda Online (E-commerce)**, **Reseñas Pro**, and **Consultor IA**.\n\n---\n\n## 🚀 Quickstart Guide\n\n### 1. Installation\n\nInstall the package in your Astro project directory:\n\n```bash\nnpm install @axolot-ai/sdk\n# or\npnpm add @axolot-ai/sdk\n# or\nyarn add @axolot-ai/sdk\n```\n\n### 2. Configure Astro\n\nAdd the `axolot` integration to your `astro.config.mjs`:\n\n```javascript\nimport { defineConfig } from 'astro/config';\nimport tailwind from '@astrojs/tailwind'; // optional\nimport axolot from '@axolot-ai/sdk';\n\nexport default defineConfig({\n  integrations: [\n    tailwind(),\n    axolot(), // Connects the local dev server with the CMS API\n  ],\n});\n```\n\n### 3. Setup Environment Variables\n\nCreate a `.env` file in the root of your project:\n\n```env\n# Credentials obtained from your Axolot Dashboard\nAXOLOT_SITE_ID=\"your-site-uuid-here\"\nAXOLOT_API_TOKEN=\"your-api-key-here\"\n\n# API Endpoint (Defaults to production)\nAXOLOT_API_URL=\"https://api.axolotcms.com\"\n```\n\n### 4. Inject the Sync Bridge\n\nAdd the `<AxolotBridge />` component to your main layout file (usually `src/layouts/Layout.astro`). This handles page auto-syncing and visual select clicks when loaded inside the Dashboard Iframe.\n\n```astro\n---\nimport { AxolotBridge } from '@axolot-ai/sdk/components';\n---\n<!DOCTYPE html>\n<html lang=\"es\">\n  <head>\n    <meta charset=\"utf-8\" />\n    <title>My Astro Site</title>\n  </head>\n  <body>\n    <!-- Your layout content -->\n    <slot />\n    \n    <!-- Render dev bridge ONLY in development mode -->\n    <AxolotBridge />\n  </body>\n</html>\n```\n\n### 5. Define Editable Slots\n\nYou have two ways to define editable slots for your clients:\n\n#### Option A: HTML Attributes (Recommended - Auto-registered)\nSimply tag any standard HTML element with the `data-slot` attribute. The SDK will scan, register, and update them automatically during development:\n\n```astro\n<header class=\"hero-section\">\n  <!-- Dynamic text slot (Auto-registered as text) -->\n  <h1 data-slot=\"home.hero.title\">Especialistas en tu sonrisa</h1>\n\n  <!-- Dynamic image slot (Auto-registered as image) -->\n  <img data-slot=\"home.hero.image\" src=\"/logo.png\" alt=\"Logo\" />\n</header>\n```\n\n#### Option B: Slot Component (Explicit)\nUse the explicit `<Slot>` component:\n\n```astro\n---\nimport { Slot } from '@axolot-ai/sdk/components';\n---\n\n<header class=\"hero-section\">\n  <!-- Explicit text slot -->\n  <Slot id=\"home.hero.title\" type=\"text\" placeholder=\"Especialistas en tu sonrisa\" />\n  \n  <!-- Explicit CTA link -->\n  <Slot id=\"home.hero.cta\" type=\"link\" placeholder=\"/contacto\">\n    <a class=\"btn-primary\">¡Reservar cita!</a>\n  </Slot>\n</header>\n```\n\n---\n\n## ⚙️ How the Dev Bridge works\n\nWhen running `pnpm dev`, the SDK runs a local server that exposes three endpoints under `/_axolot/fs`:\n*   `POST /_axolot/fs/read` - Returns the source code of components to the visual editor.\n*   `POST /_axolot/fs/write` - Writes visual edits back to Astro files.\n*   `GET /_axolot/fs/list` - Lists current pages.\n\nAll endpoints are strictly authenticated using your `AXOLOT_API_TOKEN` and secured behind a private signature validation to prevent arbitrary local file reading/writing.\n\n---\n\n## 🔗 Useful Links\n\n*   **Official Website**: [axolotcms.com](https://axolotcms.com)\n*   **Client Dashboard**: [ai.axolotcms.com](https://ai.axolotcms.com)\n*   **Documentation & API Reference**: [axolotcms.com/docs](https://axolotcms.com/docs)\n*   **Hosting Partner**: [oaxhosting.com](https://oaxhosting.com)\n\n---\n\n## 🛡️ Security & Privacy\n\nAxolot CMS does not store your code layouts in the cloud database unless you perform a production build. All development changes occur strictly between your local machine and the editor client via secure WebSocket tunnels. Marketing credentials and third-party API keys (Stripe, Google Ads) are encrypted using **AES-256-GCM** inside tenant-isolated database schemas.\n\n## 📄 License\n\nDistributed under the MIT License. See `LICENSE` for more information.\n","readmeFilename":"README.md","keywords":["astro","cms","headless-cms","visual-cms","visual-editor","mcp-server","model-context-protocol","ai-native","astro-integration","typescript"]}