codehooks-js 1.4.1 → 1.4.2

package/README.md

@@ -1,15 +1,18 @@
 # codehooks-js
 
-The official JavaScript/TypeScript library for [Codehooks.io](https://codehooks.io) - the platform for webhooks, automations, and integrations.
+The official JavaScript/TypeScript library for [Codehooks.io](https://codehooks.io) — the agent-native backend platform. A complete backend — API routes, NoSQL database, key-value store, worker queues, cron jobs, and static asset hosting — in a single import.
 
 ## Why Codehooks?
 
-Deploy production-ready webhook endpoints in under a minute. No need to assemble API Gateway, Lambda, DynamoDB, and SQS yourself.
+**Single Cohesive Library** – REST routes, NoSQL database, key-value store, queues, scheduled jobs, file storage, and real-time APIs. One library, one pattern, everything works together.
 
-- **Webhook-First Design** - Built-in `rawBody` access for HMAC signature verification
-- **Reliable Processing** - Automatic retries via queues and workers
-- **All-in-One Infrastructure** - Database, key-value store, queues, and workers included
-- **Flat-Rate Pricing** - Unlimited compute, no surprise bills from webhook volume
+**Zero Infrastructure Assembly** – No AWS/GCP service configuration. No API Gateway + Lambda + DynamoDB + SQS wiring. Write code and deploy — the platform handles everything else.
+
+**AI Agent Native** – The entire lifecycle is CLI-native. Any tool that can run shell commands — Claude Code, Cursor, Codex, Cline — can autonomously create, deploy, verify, and iterate on a production backend.
+
+**Sub-5-Second Deploys** – Your agent can iterate 50 times in the time it takes other platforms to deploy once.
+
+**Flat-Rate Pricing** – Unlimited compute included. No per-request fees, no surprise bills.
 
 ## Quick Start
 
@@ -27,6 +30,51 @@ cd myproject
 npm install codehooks-js
 ```
 
+## AI Agent Setup
+
+### Claude Code Plugin (Recommended)
+
+```
+/plugin marketplace add RestDB/codehooks-claude-plugin
+/plugin install codehooks@codehooks
+```
+
+Then use `/codehooks:backend` to start building.
+
+### Built-in AI Prompt
+
+```bash
+coho prompt                 # Display the Codehooks development prompt
+coho prompt | pbcopy        # Copy to clipboard (macOS)
+```
+
+### MCP Server
+
+For tools without terminal access (Claude Desktop, Cline, Zed): [codehooks-mcp-server](https://github.com/RestDB/codehooks-mcp-server). Always prefer the CLI when available.
+
+## REST API Example
+
+```javascript
+import { app, Datastore } from 'codehooks-js';
+
+// REST API routes
+app.get('/hello', (req, res) => {
+  res.json({ message: 'Hello World!' });
+});
+
+// Store and query data
+app.post('/items', async (req, res) => {
+  const conn = await Datastore.open();
+  const result = await conn.insertOne('items', req.body);
+  res.json(result);
+});
+
+// Auto-generate CRUD REST API for any collection
+app.crudlify();
+
+export default app.init();
+```
+
 ## Webhook Handler Example
 
 Handle incoming webhooks with signature verification and reliable background processing:
@@ -103,31 +151,6 @@ app.post('/webhooks/github', async (req: httpRequest, res: httpResponse) => {
 export default app.init();
 ```
 
-## REST API Example
-
-Build traditional REST APIs with the same simplicity:
-
-```javascript
-import { app, datastore } from 'codehooks-js';
-
-app.get('/api/users/:id', async (req, res) => {
-  const conn = await datastore.open();
-  const user = await conn.getOne('users', req.params.id);
-  res.json(user);
-});
-
-app.post('/api/users', async (req, res) => {
-  const conn = await datastore.open();
-  const user = await conn.insertOne('users', req.body);
-  res.status(201).json(user);
-});
-
-// Auto-generate CRUD endpoints for any collection
-app.crudlify();
-
-export default app.init();
-```
-
 ## OpenAPI Documentation
 
 Automatically generate interactive API documentation with Swagger UI:
@@ -198,10 +221,21 @@ From the project directory run:
 $ codehooks deploy
 ```
 
+## What You Can Build
+
+- **Webhook Handlers** – Receive and process webhooks from Stripe, Shopify, GitHub, Slack, Discord, Twilio, and any service. Built-in `request.rawBody` for signature verification.
+- **REST APIs** – Express.js-like routing with `app.get()`, `app.post()`, etc. Full CRUD with `app.crudlify()`.
+- **AI Agent Tool Backends** – Give your agents APIs they can call — store data, trigger workflows, query results.
+- **Scheduled Automations** – Cron jobs that sync data, send digests, clean up records, or poll external APIs.
+- **Multi-Step Workflows** – Chain API calls, queue tasks, and orchestrate services with the Workflow API. Automatic retries, state persistence, and error recovery.
+- **SaaS Integrations** – Connect any service that sends webhooks. Process, transform, and route to where it matters.
+
 ## Documentation
 
 For complete documentation, visit [https://codehooks.io/docs](https://codehooks.io/docs).
 
+For AI-optimized documentation, see [https://codehooks.io/llms.txt](https://codehooks.io/llms.txt).
+
 ## API
 
 ## Codehooks Class API Reference

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codehooks-js",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "type": "module",
   "description": "Codehooks.io official library - provides express.JS like syntax",
   "main": "index.js",