@gnosticdev/hono-actions 1.2.5 → 2.0.1

package/README.md

@@ -18,16 +18,94 @@ This package requires:
 
 - `astro`: ^5.13.0
 
+## Supported Adapters
+
+This integration works with all supported Astro adapters:
+
+- `@astrojs/cloudflare`
+- `@astrojs/node`
+- `@astrojs/vercel`
+- `@astrojs/netlify`
+
 ## Setup
 
 ### 1. Add the integration to your Astro config
 
+The integration works with all Astro adapters. Here are examples for each:
+
+#### Cloudflare
+
+```typescript
+// astro.config.ts
+import { defineConfig } from 'astro/config'
+import cloudflare from '@astrojs/cloudflare'
+import honoActions from '@gnosticdev/hono-actions'
+
+export default defineConfig({
+  output: 'server',
+  adapter: cloudflare(),
+  integrations: [
+    honoActions({
+      basePath: '/api', // Optional: default is '/api'
+      actionsPath: 'src/server/actions.ts' // Optional: custom path to your actions file
+    })
+  ]
+})
+```
+
+#### Node.js
+
+```typescript
+// astro.config.ts
+import { defineConfig } from 'astro/config'
+import node from '@astrojs/node'
+import honoActions from '@gnosticdev/hono-actions'
+
+export default defineConfig({
+  output: 'server',
+  adapter: node({
+    mode: 'standalone' // or 'middleware'
+  }),
+  integrations: [
+    honoActions({
+      basePath: '/api', // Optional: default is '/api'
+      actionsPath: 'src/server/actions.ts' // Optional: custom path to your actions file
+    })
+  ]
+})
+```
+
+#### Vercel
+
 ```typescript
 // astro.config.ts
 import { defineConfig } from 'astro/config'
-import honoActions from '@gnosticdev/hono-actions/integration'
+import vercel from '@astrojs/vercel/serverless'
+import honoActions from '@gnosticdev/hono-actions'
 
 export default defineConfig({
+  output: 'server',
+  adapter: vercel(),
+  integrations: [
+    honoActions({
+      basePath: '/api', // Optional: default is '/api'
+      actionsPath: 'src/server/actions.ts' // Optional: custom path to your actions file
+    })
+  ]
+})
+```
+
+#### Netlify
+
+```typescript
+// astro.config.ts
+import { defineConfig } from 'astro/config'
+import netlify from '@astrojs/netlify'
+import honoActions from '@gnosticdev/hono-actions'
+
+export default defineConfig({
+  output: 'server',
+  adapter: netlify(),
   integrations: [
     honoActions({
       basePath: '/api', // Optional: default is '/api'
@@ -136,22 +214,28 @@ const { message } = await parseResponse(
 ```typescript
 // In a client-side script or component
 import { honoClient } from '@gnosticdev/hono-actions/client'
+import type { DetailedError } from '@gnosticdev/hono-actions/client'
 
 // Make requests from the browser
 const handleSubmit = async (formData: FormData) => {
-  const response = await honoClient.api.anotherAction.$post({
+  const { data, error } = await parseResponse(await honoClient.api.anotherAction.$post({
     json: {
       name2: formData.get('name') as string
     }
+  }).catch((err: DetailedError) => {
+    console.error('Error:', err)
+    return {
+      data: null,
+      error: err
+    }
   })
 
-  if (response.ok) {
-    const result = await response.json()
-    console.log('Success:', result)
-  } else {
-    const error = await response.text()
-    console.error('Error:', error)
+  if (error){
+    throw new Error(`Action failed: ${error.message}`)
   }
+
+// type safe access to the data
+  console.log('my name is ', data.name2)
 }
 ```
 
@@ -159,11 +243,11 @@ const handleSubmit = async (formData: FormData) => {
 
 This package provides these entry points:
 
-- **`@gnosticdev/hono-actions/actions`**: Action definition utilities (`defineHonoAction`, `HonoActionError`, `HonoEnv`)
+- **`@gnosticdev/hono-actions/actions`**: Action definition utilities (`defineHonoAction`, `HonoActionError`, `HonoEnv` (for cloudflare usage))
   - Used in your actions file(s)
 - **`@gnosticdev/hono-actions/client`**: Pre-built Hono client and helpers (`honoClient`, `parseResponse`)
   - Safe for browser and server environments
-- **`@gnosticdev/hono-actions/integration`**: Astro integration
+- **`@gnosticdev/hono-actions`**: Astro integration
   - Uses Node.js built-ins (fs, path)
   - Only used in `astro.config.ts`
 

package/dist/index.js

@@ -11,7 +11,11 @@ import { glob } from "tinyglobby";
 
 // src/integration-files.ts
 function generateRouter(opts) {
-  const { basePath, relativeActionsPath } = opts;
+  const { basePath, relativeActionsPath, adapter } = opts;
+  let exportedApp = `export default app`;
+  if (adapter === "@astrojs/netlify") {
+    exportedApp = `export default handle(app)`;
+  }
   return `import type { HonoEnv, MergeActionKeyIntoPath } from '@gnosticdev/hono-actions/actions'
 import { Hono } from 'hono'
 import { cors } from 'hono/cors'
@@ -19,12 +23,13 @@ import { showRoutes } from 'hono/dev'
 import { logger } from 'hono/logger'
 import { prettyJSON } from 'hono/pretty-json'
 import type { ExtractSchema, MergeSchemaPath } from 'hono/types'
+${adapter === "@astrojs/netlify" ? "import { handle } from 'hono/netlify'" : ""}
 
 async function buildRouter(){
     type ActionsWithKeyedPaths = MergeActionKeyIntoPath<typeof honoActions>
     type ActionSchema = ExtractSchema<ActionsWithKeyedPaths[keyof ActionsWithKeyedPaths]>
     const { honoActions} = await import('${relativeActionsPath}')
-    const app = new Hono<HonoEnv, MergeSchemaPath<ActionSchema, \`${basePath}\`>>().basePath('${basePath}')
+    const app = new Hono<HonoEnv, MergeSchemaPath<ActionSchema, '${basePath}'>>().basePath('${basePath}')
 
     app.use('*', cors(), logger(), prettyJSON())
 
@@ -41,7 +46,7 @@ const app = await buildRouter()
 console.log('------- Hono Routes -------')
 showRoutes(app)
 console.log('---------------------------')
-export default app`;
+${exportedApp}`;
 }
 var generateAstroHandler = (adapter) => {
   switch (adapter) {
@@ -49,17 +54,49 @@ var generateAstroHandler = (adapter) => {
       return `
 /// <reference types="./types.d.ts" />
 // Generated by Hono Actions Integration
+// adapter: ${adapter}
+import type { APIContext, APIRoute } from 'astro'
+import router from './router.js'
+
+const handler: APIRoute<APIContext> = async (ctx) => {
+    return router.fetch(
+        ctx.request,
+        ctx.locals.runtime.env, // required for cloudflare adapter
+        ctx.locals.runtime.ctx, // required for cloudflare adapter
+    )
+}
+
+export { handler as ALL }
+`;
+    case "@astrojs/node":
+    case "@astrojs/vercel":
+      return `
+/// <reference types="./types.d.ts" />
+// Generated by Hono Actions Integration
+// adapter: ${adapter}
 import type { APIContext, APIRoute } from 'astro'
 import router from './router.js'
 
 const handler: APIRoute<APIContext> = async (ctx) => {
     return router.fetch(
         ctx.request,
-        ctx.locals.runtime.env,
-        ctx.locals.runtime.ctx,
     )
 }
 
+export { handler as ALL }
+`;
+    case "@astrojs/netlify":
+      return `
+/// <reference types="./types.d.ts" />
+// Generated by Hono Actions Integration
+// adapter: ${adapter}
+import type { APIContext, APIRoute } from 'astro'
+import netlifyHandler from './router.js'
+
+const handler: APIRoute<APIContext> = async (ctx) => {
+    return netlifyHandler(ctx.request, ctx)
+}
+
 export { handler as ALL }
 `;
     default:
@@ -70,6 +107,7 @@ var generateHonoClient = (port) => `
 // Generated by Hono Actions Integration
 import type { HonoRouter } from './router.js'
 import { hc, parseResponse } from 'hono/client'
+import type { DetailedError } from 'hono/client'
 
 function getBaseUrl() {
     // client side can just use the base path
@@ -86,11 +124,16 @@ function getBaseUrl() {
     return import.meta.env.SITE ?? ''
 }
 export { parseResponse, hc }
+export type { DetailedError }
 export const honoClient = hc<HonoRouter>(getBaseUrl())
 `;
 
 // src/lib/utils.ts
 var reservedRoutes = ["_astro", "_actions", "_server_islands"];
+var SUPPORTED_ADAPTERS = ["@astrojs/cloudflare", "@astrojs/node", "@astrojs/netlify", "@astrojs/vercel"];
+function isSupportedAdapter(adapter) {
+  return SUPPORTED_ADAPTERS.includes(adapter);
+}
 
 // src/integration.ts
 var optionsSchema = z.object({
@@ -119,10 +162,6 @@ var ACTION_PATTERNS = [
   "src/hono/index.ts",
   "src/hono.ts"
 ];
-var SUPPORTED_ADAPTERS = ["@astrojs/cloudflare"];
-function isSupportedAdapter(adapter) {
-  return SUPPORTED_ADAPTERS.includes(adapter);
-}
 var integration_default = defineIntegration({
   name: "@gnosticdev/hono-actions",
   optionsSchema,
@@ -164,33 +203,31 @@ ${ACTION_PATTERNS.map((p) => ` - ${p}`).join("\n")}`
             "router.ts"
           );
           const relFromGenToActions = path.relative(codeGenDir.pathname, resolvedActionsPath).split(path.sep).join("/");
-          const routerContent = generateRouter({
-            basePath,
-            relativeActionsPath: relFromGenToActions
-          });
-          await fs.writeFile(routerPathAbs, routerContent, "utf-8");
-          const astroHandlerPathAbs = path.join(
-            codeGenDir.pathname,
-            "api.ts"
-          );
           const adapter = params.config.adapter?.name;
           if (!adapter) {
             logger.error(
               `No Astro adapter found. Add one of:
-                            - ${SUPPORTED_ADAPTERS.join("\n - ")} to your astro.config.mjs`
+                                - ${SUPPORTED_ADAPTERS.join("\n - ")} to your astro.config.mjs`
             );
             return;
           }
-          let astroHandlerContent;
-          if (isSupportedAdapter(adapter)) {
-            astroHandlerContent = generateAstroHandler(adapter);
-          } else {
-            throw new Error(`Unsupported adapter: ${adapter}`, {
-              cause: `Only ${SUPPORTED_ADAPTERS.join(
-                ", "
-              )} are supported for now`
-            });
+          if (!isSupportedAdapter(adapter)) {
+            logger.error(
+              `Unsupported adapter: ${adapter}. Only ${SUPPORTED_ADAPTERS.join("\n - ")} are supported`
+            );
+            return;
           }
+          const routerContent = generateRouter({
+            basePath,
+            relativeActionsPath: relFromGenToActions,
+            adapter
+          });
+          await fs.writeFile(routerPathAbs, routerContent, "utf-8");
+          const astroHandlerPathAbs = path.join(
+            codeGenDir.pathname,
+            "api.ts"
+          );
+          const astroHandlerContent = generateAstroHandler(adapter);
           await fs.writeFile(
             astroHandlerPathAbs,
             astroHandlerContent,
@@ -241,22 +278,28 @@ export {}
 declare module '@gnosticdev/hono-actions/client' {
     export const honoClient: typeof import('./client').honoClient
     export const parseResponse: typeof import('./client').parseResponse
+    exoprt type DetailedError = import('./client').DetailedError
 }
 `;
-          if (!config.adapter?.name) {
+          const adapter = config.adapter?.name;
+          if (!adapter) {
             logger.warn("No adapter found...");
             return;
           }
-          if (config.adapter.name !== "@astrojs/cloudflare") {
-            logger.warn("Unsupported adapter...");
+          if (!isSupportedAdapter(adapter)) {
+            logger.warn(
+              `Unsupported adapter: ${adapter}. Only ${SUPPORTED_ADAPTERS.join("\n - ")} are supported`
+            );
             return;
           }
-          clientTypes += `
+          if (adapter === "@astrojs/cloudflare") {
+            clientTypes += `
     type Runtime = import('@astrojs/cloudflare').Runtime<Env>
-    declare namespace App {
-        interface Locals extends Runtime {}
-    }
-`;
+        declare namespace App {
+            interface Locals extends Runtime {}
+        }
+    `;
+          }
           injectTypes({
             filename: "types.d.ts",
             content: clientTypes

package/package.json

@@ -14,7 +14,12 @@
   "devDependencies": {
     "tsup": "^8.5.0",
     "typescript": "catalog:",
-    "vitest": "catalog:"
+    "vitest": "catalog:",
+    "@astrojs/cloudflare": "catalog:",
+    "@astrojs/netlify": "catalog:",
+    "@astrojs/node": "catalog:",
+    "@astrojs/vercel": "catalog:",
+    "astro": "catalog:"
   },
   "exports": {
     ".": {
@@ -56,5 +61,5 @@
   },
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "1.2.5"
+  "version": "2.0.1"
 }