@autonoma-ai/server-express 0.1.0 → 0.1.3

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/dist/index.js

@@ -1,6 +1,7 @@
 // src/index.ts
 import { handleRequest } from "@autonoma-ai/sdk";
 function createExpressHandler(config) {
+  const enrichedConfig = { ...config, sdk: { ...config.sdk, server: "express" } };
   return async (req, res) => {
     const body = await readBody(req);
     const headers = {};
@@ -9,7 +10,7 @@ function createExpressHandler(config) {
       else if (Array.isArray(val)) headers[key.toLowerCase()] = val[0] ?? "";
     }
     const handlerReq = { body, headers };
-    const result = await handleRequest(config, handlerReq);
+    const result = await handleRequest(enrichedConfig, handlerReq);
     res.status(result.status).json(result.body);
   };
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { handleRequest } from '@autonoma-ai/sdk'\nimport type { HandlerConfig, HandlerRequest } from '@autonoma-ai/sdk'\n\ninterface ExpressRequest {\n  body?: unknown\n  headers: Record<string, string | string[] | undefined>\n  on(event: string, listener: (...args: unknown[]) => void): void\n}\n\ninterface ExpressResponse {\n  status(code: number): ExpressResponse\n  json(body: unknown): void\n}\n\n/**\n * Create an Express-compatible handler.\n *\n * @example\n * ```ts\n * import { createExpressHandler } from '@autonoma-ai/server-express'\n * app.post('/api/autonoma', createExpressHandler(config))\n * ```\n */\nexport function createExpressHandler(config: HandlerConfig) {\n  return async (req: ExpressRequest, res: ExpressResponse): Promise<void> => {\n    const body = await readBody(req)\n    const headers: Record<string, string> = {}\n    for (const [key, val] of Object.entries(req.headers)) {\n      if (typeof val === 'string') headers[key.toLowerCase()] = val\n      else if (Array.isArray(val)) headers[key.toLowerCase()] = val[0] ?? ''\n    }\n\n    const handlerReq: HandlerRequest = { body, headers }\n    const result = await handleRequest(config, handlerReq)\n    res.status(result.status).json(result.body)\n  }\n}\n\nfunction readBody(req: ExpressRequest): Promise<string> {\n  if (req.body !== undefined && req.body !== null) {\n    return Promise.resolve(\n      typeof req.body === 'string' ? req.body : JSON.stringify(req.body),\n    )\n  }\n\n  return new Promise((resolve, reject) => {\n    const chunks: unknown[] = []\n    req.on('data', (...args: unknown[]) => chunks.push(args[0]))\n    req.on('end', () => resolve(Buffer.concat(chunks as Uint8Array[]).toString()))\n    req.on('error', (...args: unknown[]) => reject(args[0]))\n  })\n}\n"],"mappings":";AAAA,SAAS,qBAAqB;AAuBvB,SAAS,qBAAqB,QAAuB;AAC1D,SAAO,OAAO,KAAqB,QAAwC;AACzE,UAAM,OAAO,MAAM,SAAS,GAAG;AAC/B,UAAM,UAAkC,CAAC;AACzC,eAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,IAAI,OAAO,GAAG;AACpD,UAAI,OAAO,QAAQ,SAAU,SAAQ,IAAI,YAAY,CAAC,IAAI;AAAA,eACjD,MAAM,QAAQ,GAAG,EAAG,SAAQ,IAAI,YAAY,CAAC,IAAI,IAAI,CAAC,KAAK;AAAA,IACtE;AAEA,UAAM,aAA6B,EAAE,MAAM,QAAQ;AACnD,UAAM,SAAS,MAAM,cAAc,QAAQ,UAAU;AACrD,QAAI,OAAO,OAAO,MAAM,EAAE,KAAK,OAAO,IAAI;AAAA,EAC5C;AACF;AAEA,SAAS,SAAS,KAAsC;AACtD,MAAI,IAAI,SAAS,UAAa,IAAI,SAAS,MAAM;AAC/C,WAAO,QAAQ;AAAA,MACb,OAAO,IAAI,SAAS,WAAW,IAAI,OAAO,KAAK,UAAU,IAAI,IAAI;AAAA,IACnE;AAAA,EACF;AAEA,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,SAAoB,CAAC;AAC3B,QAAI,GAAG,QAAQ,IAAI,SAAoB,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC;AAC3D,QAAI,GAAG,OAAO,MAAM,QAAQ,OAAO,OAAO,MAAsB,EAAE,SAAS,CAAC,CAAC;AAC7E,QAAI,GAAG,SAAS,IAAI,SAAoB,OAAO,KAAK,CAAC,CAAC,CAAC;AAAA,EACzD,CAAC;AACH;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { handleRequest } from '@autonoma-ai/sdk'\nimport type { HandlerConfig, HandlerRequest } from '@autonoma-ai/sdk'\n\ninterface ExpressRequest {\n  body?: unknown\n  headers: Record<string, string | string[] | undefined>\n  on(event: string, listener: (...args: unknown[]) => void): void\n}\n\ninterface ExpressResponse {\n  status(code: number): ExpressResponse\n  json(body: unknown): void\n}\n\n/**\n * Create an Express-compatible handler.\n *\n * @example\n * ```ts\n * import { createExpressHandler } from '@autonoma-ai/server-express'\n * app.post('/api/autonoma', createExpressHandler(config))\n * ```\n */\nexport function createExpressHandler(config: HandlerConfig) {\n  const enrichedConfig = { ...config, sdk: { ...config.sdk, server: 'express' } }\n  return async (req: ExpressRequest, res: ExpressResponse): Promise<void> => {\n    const body = await readBody(req)\n    const headers: Record<string, string> = {}\n    for (const [key, val] of Object.entries(req.headers)) {\n      if (typeof val === 'string') headers[key.toLowerCase()] = val\n      else if (Array.isArray(val)) headers[key.toLowerCase()] = val[0] ?? ''\n    }\n\n    const handlerReq: HandlerRequest = { body, headers }\n    const result = await handleRequest(enrichedConfig, handlerReq)\n    res.status(result.status).json(result.body)\n  }\n}\n\nfunction readBody(req: ExpressRequest): Promise<string> {\n  if (req.body !== undefined && req.body !== null) {\n    return Promise.resolve(\n      typeof req.body === 'string' ? req.body : JSON.stringify(req.body),\n    )\n  }\n\n  return new Promise((resolve, reject) => {\n    const chunks: unknown[] = []\n    req.on('data', (...args: unknown[]) => chunks.push(args[0]))\n    req.on('end', () => resolve(Buffer.concat(chunks as Uint8Array[]).toString()))\n    req.on('error', (...args: unknown[]) => reject(args[0]))\n  })\n}\n"],"mappings":";AAAA,SAAS,qBAAqB;AAuBvB,SAAS,qBAAqB,QAAuB;AAC1D,QAAM,iBAAiB,EAAE,GAAG,QAAQ,KAAK,EAAE,GAAG,OAAO,KAAK,QAAQ,UAAU,EAAE;AAC9E,SAAO,OAAO,KAAqB,QAAwC;AACzE,UAAM,OAAO,MAAM,SAAS,GAAG;AAC/B,UAAM,UAAkC,CAAC;AACzC,eAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,IAAI,OAAO,GAAG;AACpD,UAAI,OAAO,QAAQ,SAAU,SAAQ,IAAI,YAAY,CAAC,IAAI;AAAA,eACjD,MAAM,QAAQ,GAAG,EAAG,SAAQ,IAAI,YAAY,CAAC,IAAI,IAAI,CAAC,KAAK;AAAA,IACtE;AAEA,UAAM,aAA6B,EAAE,MAAM,QAAQ;AACnD,UAAM,SAAS,MAAM,cAAc,gBAAgB,UAAU;AAC7D,QAAI,OAAO,OAAO,MAAM,EAAE,KAAK,OAAO,IAAI;AAAA,EAC5C;AACF;AAEA,SAAS,SAAS,KAAsC;AACtD,MAAI,IAAI,SAAS,UAAa,IAAI,SAAS,MAAM;AAC/C,WAAO,QAAQ;AAAA,MACb,OAAO,IAAI,SAAS,WAAW,IAAI,OAAO,KAAK,UAAU,IAAI,IAAI;AAAA,IACnE;AAAA,EACF;AAEA,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,SAAoB,CAAC;AAC3B,QAAI,GAAG,QAAQ,IAAI,SAAoB,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC;AAC3D,QAAI,GAAG,OAAO,MAAM,QAAQ,OAAO,OAAO,MAAsB,EAAE,SAAS,CAAC,CAAC;AAC7E,QAAI,GAAG,SAAS,IAAI,SAAoB,OAAO,KAAK,CAAC,CAAC,CAAC;AAAA,EACzD,CAAC;AACH;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autonoma-ai/server-express",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "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.3"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",