@autonoma-ai/server-express 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,72 @@
+# @autonoma-ai/server-express
+
+Express/Fastify server adapter for the Autonoma SDK.
+
+## Install
+
+```bash
+pnpm add @autonoma-ai/sdk @autonoma-ai/sdk-prisma @autonoma-ai/server-express
+```
+
+## Usage
+
+### Express
+
+```typescript
+import express from 'express'
+import { createExpressHandler } from '@autonoma-ai/server-express'
+import { prismaAdapter } from '@autonoma-ai/sdk-prisma'
+import { prisma } from './db'
+
+const app = express()
+
+app.post('/api/autonoma', createExpressHandler({
+  adapter: prismaAdapter(prisma, { scopeField: 'organizationId' }),
+  sharedSecret: process.env.AUTONOMA_SHARED_SECRET!,
+  signingSecret: process.env.AUTONOMA_SIGNING_SECRET!,
+  auth: async (user) => {
+    const session = await createSession(user.id as string)
+    return { token: session.token }
+  },
+}))
+```
+
+### Fastify
+
+```typescript
+import Fastify from 'fastify'
+import { createExpressHandler } from '@autonoma-ai/server-express'
+
+const app = Fastify()
+const handler = createExpressHandler(config)
+
+app.post('/api/autonoma', async (req, reply) => {
+  await handler(req.raw, reply.raw)
+})
+```
+
+> **Note:** Do not add `express.json()` middleware before this route. The adapter needs the raw body string to verify the HMAC signature.
+
+## Auth callback
+
+The `auth` callback receives the first `User` created during setup and must return real credentials that the test runner can use to log in:
+
+```typescript
+// Session cookie
+auth: async (user) => {
+  const session = await createSession(user.id as string)
+  return {
+    cookies: [{ name: 'session', value: session.token, httpOnly: true, sameSite: 'lax', path: '/' }],
+  }
+}
+
+// Bearer token
+auth: async (user) => {
+  const token = jwt.sign({ sub: user.id }, SECRET)
+  return { token }
+}
+```
+
+## Documentation
+
+Full docs: [docs/](../../docs/) — see [setup guide](../../docs/setup.txt).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autonoma-ai/server-express",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Express/Fastify server adapter for Autonoma SDK",
   "type": "module",
   "exports": {
@@ -16,7 +16,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@autonoma-ai/sdk": "0.1.0"
+    "@autonoma-ai/sdk": "0.1.2"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",