@dipansrimany/mlink-sdk 0.1.0

package/README.md

@@ -0,0 +1,86 @@
+# @mantle-blinks/sdk
+
+SDK for building Mantle Blinks - shareable blockchain transaction URLs for Mantle Network.
+
+## Installation
+
+```bash
+npm install @mantle-blinks/sdk
+```
+
+## Quick Start
+
+### 1. Create an Action
+
+```typescript
+import { createAction, button, input, parseEther } from '@mantle-blinks/sdk';
+
+export const tipAction = createAction({
+  title: 'Tip the Developer',
+  icon: 'https://example.com/icon.png',
+  description: 'Send a tip in MNT',
+
+  actions: [
+    button({ label: '1 MNT', value: '1' }),
+    button({ label: '5 MNT', value: '5' }),
+    input({ label: 'Send', placeholder: 'Custom amount' }),
+  ],
+
+  handler: async ({ account, action, input }) => {
+    const amount = input || action;
+
+    return {
+      transaction: {
+        to: '0xYourAddress',
+        value: parseEther(amount),
+        data: '0x',
+        chainId: 5003, // Mantle Sepolia
+      },
+      message: `Thanks for the ${amount} MNT tip!`,
+    };
+  },
+});
+```
+
+### 2. Create an API Route (Next.js)
+
+```typescript
+// app/api/actions/tip/route.ts
+import { createNextHandler } from '@mantle-blinks/sdk/next';
+import { tipAction } from './action';
+
+export const { GET, POST, OPTIONS } = createNextHandler(tipAction);
+```
+
+### 3. Create an API Route (Express)
+
+```typescript
+import express from 'express';
+import { createExpressHandler } from '@mantle-blinks/sdk/express';
+import { tipAction } from './action';
+
+const app = express();
+app.use('/api/actions/tip', createExpressHandler(tipAction));
+```
+
+## Supported Networks
+
+| Network | Chain ID |
+|---------|----------|
+| Mantle Mainnet | 5000 |
+| Mantle Sepolia | 5003 |
+
+## Publishing to npm
+
+```bash
+# Login to npm
+npm login
+
+# Build and publish
+npm run build
+npm publish --access public
+```
+
+## License
+
+MIT

package/dist/adapters/express.d.mts

@@ -0,0 +1,6 @@
+import { Router } from 'express';
+import { k as Action } from '../builders-OoJ5KB_g.mjs';
+
+declare function createExpressHandler(action: Action, RouterClass: new () => Router): Router;
+
+export { createExpressHandler };

package/dist/adapters/express.d.ts

@@ -0,0 +1,6 @@
+import { Router } from 'express';
+import { k as Action } from '../builders-OoJ5KB_g.js';
+
+declare function createExpressHandler(action: Action, RouterClass: new () => Router): Router;
+
+export { createExpressHandler };

package/dist/adapters/express.js

@@ -0,0 +1,85 @@
+'use strict';
+
+var zod = require('zod');
+
+// src/validators.ts
+var addressRegex = /^0x[a-fA-F0-9]{40}$/;
+var hexRegex = /^0x[a-fA-F0-9]*$/;
+var ActionButtonSchema = zod.z.object({
+  label: zod.z.string().min(1).max(50),
+  value: zod.z.string().min(1),
+  type: zod.z.enum(["button", "input"]),
+  placeholder: zod.z.string().optional(),
+  disabled: zod.z.boolean().optional()
+});
+zod.z.object({
+  title: zod.z.string().min(1).max(100),
+  icon: zod.z.string().url(),
+  description: zod.z.string().min(1).max(500),
+  actions: zod.z.array(ActionButtonSchema).min(1),
+  disabled: zod.z.boolean().optional(),
+  error: zod.z.object({ message: zod.z.string() }).optional()
+});
+var TransactionRequestSchema = zod.z.object({
+  account: zod.z.string().regex(addressRegex, "Invalid Ethereum address"),
+  action: zod.z.string().min(1),
+  input: zod.z.string().optional()
+});
+var EVMTransactionSchema = zod.z.object({
+  to: zod.z.string().regex(addressRegex, "Invalid to address"),
+  value: zod.z.string(),
+  data: zod.z.string().regex(hexRegex, "Invalid hex data"),
+  chainId: zod.z.number().positive()
+});
+zod.z.object({
+  transaction: EVMTransactionSchema,
+  message: zod.z.string().optional()
+});
+function validateTransactionRequest(data) {
+  const result = TransactionRequestSchema.safeParse(data);
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+  return { success: false, error: result.error.message };
+}
+
+// src/adapters/express.ts
+function createExpressHandler(action, RouterClass) {
+  const router = new RouterClass();
+  router.use((_req, res, next) => {
+    res.header("Access-Control-Allow-Origin", "*");
+    res.header("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+    res.header("Access-Control-Allow-Headers", "Content-Type");
+    next();
+  });
+  router.options("/", (_req, res) => {
+    res.sendStatus(200);
+  });
+  router.get("/", (_req, res) => {
+    try {
+      const metadata = action.getMetadata();
+      res.json(metadata);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      res.status(500).json({ error: { message } });
+    }
+  });
+  router.post("/", async (req, res) => {
+    try {
+      const validation = validateTransactionRequest(req.body);
+      if (!validation.success) {
+        return res.status(400).json({ error: { message: validation.error } });
+      }
+      const response = await action.handleRequest(validation.data);
+      res.json(response);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      res.status(500).json({ error: { message } });
+    }
+  });
+  return router;
+}
+
+exports.createExpressHandler = createExpressHandler;
+//# sourceMappingURL=express.js.map
+//# sourceMappingURL=express.js.map

package/dist/adapters/express.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/validators.ts","../../src/adapters/express.ts"],"names":["z"],"mappings":"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","file":"express.js","sourcesContent":["import { z } from 'zod';\nimport type {\n  ActionMetadata,\n  TransactionRequest,\n  TransactionResponse,\n  ValidationResult,\n} from './types';\n\n// Ethereum address regex\nconst addressRegex = /^0x[a-fA-F0-9]{40}$/;\n\n// Hex string regex\nconst hexRegex = /^0x[a-fA-F0-9]*$/;\n\n// Zod Schemas\nexport const ActionButtonSchema = z.object({\n  label: z.string().min(1).max(50),\n  value: z.string().min(1),\n  type: z.enum(['button', 'input']),\n  placeholder: z.string().optional(),\n  disabled: z.boolean().optional(),\n});\n\nexport const ActionMetadataSchema = z.object({\n  title: z.string().min(1).max(100),\n  icon: z.string().url(),\n  description: z.string().min(1).max(500),\n  actions: z.array(ActionButtonSchema).min(1),\n  disabled: z.boolean().optional(),\n  error: z.object({ message: z.string() }).optional(),\n});\n\nexport const TransactionRequestSchema = z.object({\n  account: z.string().regex(addressRegex, 'Invalid Ethereum address'),\n  action: z.string().min(1),\n  input: z.string().optional(),\n});\n\nexport const EVMTransactionSchema = z.object({\n  to: z.string().regex(addressRegex, 'Invalid to address'),\n  value: z.string(),\n  data: z.string().regex(hexRegex, 'Invalid hex data'),\n  chainId: z.number().positive(),\n});\n\nexport const TransactionResponseSchema = z.object({\n  transaction: EVMTransactionSchema,\n  message: z.string().optional(),\n});\n\n// Validation functions\nexport function validateActionMetadata(\n  data: unknown\n): ValidationResult<ActionMetadata> {\n  const result = ActionMetadataSchema.safeParse(data);\n  if (result.success) {\n    return { success: true, data: result.data as ActionMetadata };\n  }\n  return { success: false, error: result.error.message };\n}\n\nexport function validateTransactionRequest(\n  data: unknown\n): ValidationResult<TransactionRequest> {\n  const result = TransactionRequestSchema.safeParse(data);\n  if (result.success) {\n    return { success: true, data: result.data };\n  }\n  return { success: false, error: result.error.message };\n}\n\nexport function validateTransactionResponse(\n  data: unknown\n): ValidationResult<TransactionResponse> {\n  const result = TransactionResponseSchema.safeParse(data);\n  if (result.success) {\n    return { success: true, data: result.data as TransactionResponse };\n  }\n  return { success: false, error: result.error.message };\n}\n\nexport function isValidAddress(address: string): boolean {\n  return addressRegex.test(address);\n}\n\nexport function isValidHex(hex: string): boolean {\n  return hexRegex.test(hex);\n}\n","import type { Router, Request, Response, NextFunction } from 'express';\nimport type { Action } from '../builders';\nimport { validateTransactionRequest } from '../validators';\n\n// Create Express router\nexport function createExpressHandler(\n  action: Action,\n  RouterClass: new () => Router\n): Router {\n  const router = new RouterClass();\n\n  // CORS middleware\n  router.use((_req: Request, res: Response, next: NextFunction) => {\n    res.header('Access-Control-Allow-Origin', '*');\n    res.header('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');\n    res.header('Access-Control-Allow-Headers', 'Content-Type');\n    next();\n  });\n\n  // OPTIONS handler\n  router.options('/', (_req: Request, res: Response) => {\n    res.sendStatus(200);\n  });\n\n  // GET handler\n  router.get('/', (_req: Request, res: Response) => {\n    try {\n      const metadata = action.getMetadata();\n      res.json(metadata);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      res.status(500).json({ error: { message } });\n    }\n  });\n\n  // POST handler\n  router.post('/', async (req: Request, res: Response) => {\n    try {\n      const validation = validateTransactionRequest(req.body);\n\n      if (!validation.success) {\n        return res.status(400).json({ error: { message: validation.error } });\n      }\n\n      const response = await action.handleRequest(validation.data);\n      res.json(response);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      res.status(500).json({ error: { message } });\n    }\n  });\n\n  return router;\n}\n"]}

package/dist/adapters/express.mjs

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+
+// src/validators.ts
+var addressRegex = /^0x[a-fA-F0-9]{40}$/;
+var hexRegex = /^0x[a-fA-F0-9]*$/;
+var ActionButtonSchema = z.object({
+  label: z.string().min(1).max(50),
+  value: z.string().min(1),
+  type: z.enum(["button", "input"]),
+  placeholder: z.string().optional(),
+  disabled: z.boolean().optional()
+});
+z.object({
+  title: z.string().min(1).max(100),
+  icon: z.string().url(),
+  description: z.string().min(1).max(500),
+  actions: z.array(ActionButtonSchema).min(1),
+  disabled: z.boolean().optional(),
+  error: z.object({ message: z.string() }).optional()
+});
+var TransactionRequestSchema = z.object({
+  account: z.string().regex(addressRegex, "Invalid Ethereum address"),
+  action: z.string().min(1),
+  input: z.string().optional()
+});
+var EVMTransactionSchema = z.object({
+  to: z.string().regex(addressRegex, "Invalid to address"),
+  value: z.string(),
+  data: z.string().regex(hexRegex, "Invalid hex data"),
+  chainId: z.number().positive()
+});
+z.object({
+  transaction: EVMTransactionSchema,
+  message: z.string().optional()
+});
+function validateTransactionRequest(data) {
+  const result = TransactionRequestSchema.safeParse(data);
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+  return { success: false, error: result.error.message };
+}
+
+// src/adapters/express.ts
+function createExpressHandler(action, RouterClass) {
+  const router = new RouterClass();
+  router.use((_req, res, next) => {
+    res.header("Access-Control-Allow-Origin", "*");
+    res.header("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+    res.header("Access-Control-Allow-Headers", "Content-Type");
+    next();
+  });
+  router.options("/", (_req, res) => {
+    res.sendStatus(200);
+  });
+  router.get("/", (_req, res) => {
+    try {
+      const metadata = action.getMetadata();
+      res.json(metadata);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      res.status(500).json({ error: { message } });
+    }
+  });
+  router.post("/", async (req, res) => {
+    try {
+      const validation = validateTransactionRequest(req.body);
+      if (!validation.success) {
+        return res.status(400).json({ error: { message: validation.error } });
+      }
+      const response = await action.handleRequest(validation.data);
+      res.json(response);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      res.status(500).json({ error: { message } });
+    }
+  });
+  return router;
+}
+
+export { createExpressHandler };
+//# sourceMappingURL=express.mjs.map
+//# sourceMappingURL=express.mjs.map

package/dist/adapters/express.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/validators.ts","../../src/adapters/express.ts"],"names":[],"mappings":"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","file":"express.mjs","sourcesContent":["import { z } from 'zod';\nimport type {\n  ActionMetadata,\n  TransactionRequest,\n  TransactionResponse,\n  ValidationResult,\n} from './types';\n\n// Ethereum address regex\nconst addressRegex = /^0x[a-fA-F0-9]{40}$/;\n\n// Hex string regex\nconst hexRegex = /^0x[a-fA-F0-9]*$/;\n\n// Zod Schemas\nexport const ActionButtonSchema = z.object({\n  label: z.string().min(1).max(50),\n  value: z.string().min(1),\n  type: z.enum(['button', 'input']),\n  placeholder: z.string().optional(),\n  disabled: z.boolean().optional(),\n});\n\nexport const ActionMetadataSchema = z.object({\n  title: z.string().min(1).max(100),\n  icon: z.string().url(),\n  description: z.string().min(1).max(500),\n  actions: z.array(ActionButtonSchema).min(1),\n  disabled: z.boolean().optional(),\n  error: z.object({ message: z.string() }).optional(),\n});\n\nexport const TransactionRequestSchema = z.object({\n  account: z.string().regex(addressRegex, 'Invalid Ethereum address'),\n  action: z.string().min(1),\n  input: z.string().optional(),\n});\n\nexport const EVMTransactionSchema = z.object({\n  to: z.string().regex(addressRegex, 'Invalid to address'),\n  value: z.string(),\n  data: z.string().regex(hexRegex, 'Invalid hex data'),\n  chainId: z.number().positive(),\n});\n\nexport const TransactionResponseSchema = z.object({\n  transaction: EVMTransactionSchema,\n  message: z.string().optional(),\n});\n\n// Validation functions\nexport function validateActionMetadata(\n  data: unknown\n): ValidationResult<ActionMetadata> {\n  const result = ActionMetadataSchema.safeParse(data);\n  if (result.success) {\n    return { success: true, data: result.data as ActionMetadata };\n  }\n  return { success: false, error: result.error.message };\n}\n\nexport function validateTransactionRequest(\n  data: unknown\n): ValidationResult<TransactionRequest> {\n  const result = TransactionRequestSchema.safeParse(data);\n  if (result.success) {\n    return { success: true, data: result.data };\n  }\n  return { success: false, error: result.error.message };\n}\n\nexport function validateTransactionResponse(\n  data: unknown\n): ValidationResult<TransactionResponse> {\n  const result = TransactionResponseSchema.safeParse(data);\n  if (result.success) {\n    return { success: true, data: result.data as TransactionResponse };\n  }\n  return { success: false, error: result.error.message };\n}\n\nexport function isValidAddress(address: string): boolean {\n  return addressRegex.test(address);\n}\n\nexport function isValidHex(hex: string): boolean {\n  return hexRegex.test(hex);\n}\n","import type { Router, Request, Response, NextFunction } from 'express';\nimport type { Action } from '../builders';\nimport { validateTransactionRequest } from '../validators';\n\n// Create Express router\nexport function createExpressHandler(\n  action: Action,\n  RouterClass: new () => Router\n): Router {\n  const router = new RouterClass();\n\n  // CORS middleware\n  router.use((_req: Request, res: Response, next: NextFunction) => {\n    res.header('Access-Control-Allow-Origin', '*');\n    res.header('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');\n    res.header('Access-Control-Allow-Headers', 'Content-Type');\n    next();\n  });\n\n  // OPTIONS handler\n  router.options('/', (_req: Request, res: Response) => {\n    res.sendStatus(200);\n  });\n\n  // GET handler\n  router.get('/', (_req: Request, res: Response) => {\n    try {\n      const metadata = action.getMetadata();\n      res.json(metadata);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      res.status(500).json({ error: { message } });\n    }\n  });\n\n  // POST handler\n  router.post('/', async (req: Request, res: Response) => {\n    try {\n      const validation = validateTransactionRequest(req.body);\n\n      if (!validation.success) {\n        return res.status(400).json({ error: { message: validation.error } });\n      }\n\n      const response = await action.handleRequest(validation.data);\n      res.json(response);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      res.status(500).json({ error: { message } });\n    }\n  });\n\n  return router;\n}\n"]}

package/dist/adapters/next.d.mts

@@ -0,0 +1,18 @@
+import { k as Action, A as ActionMetadata, a as TransactionResponse } from '../builders-OoJ5KB_g.mjs';
+import { NextResponse, NextRequest } from 'next/server';
+
+declare function createNextHandler(action: Action): {
+    GET: () => Promise<NextResponse<ActionMetadata> | NextResponse<{
+        error: {
+            message: string;
+        };
+    }>>;
+    POST: (request: NextRequest) => Promise<NextResponse<{
+        error: {
+            message: string;
+        };
+    }> | NextResponse<TransactionResponse>>;
+    OPTIONS: () => Promise<NextResponse<unknown>>;
+};
+
+export { createNextHandler };

package/dist/adapters/next.d.ts

@@ -0,0 +1,18 @@
+import { k as Action, A as ActionMetadata, a as TransactionResponse } from '../builders-OoJ5KB_g.js';
+import { NextResponse, NextRequest } from 'next/server';
+
+declare function createNextHandler(action: Action): {
+    GET: () => Promise<NextResponse<ActionMetadata> | NextResponse<{
+        error: {
+            message: string;
+        };
+    }>>;
+    POST: (request: NextRequest) => Promise<NextResponse<{
+        error: {
+            message: string;
+        };
+    }> | NextResponse<TransactionResponse>>;
+    OPTIONS: () => Promise<NextResponse<unknown>>;
+};
+
+export { createNextHandler };

package/dist/adapters/next.js

@@ -0,0 +1,94 @@
+'use strict';
+
+var server = require('next/server');
+var zod = require('zod');
+
+// src/adapters/next.ts
+var addressRegex = /^0x[a-fA-F0-9]{40}$/;
+var hexRegex = /^0x[a-fA-F0-9]*$/;
+var ActionButtonSchema = zod.z.object({
+  label: zod.z.string().min(1).max(50),
+  value: zod.z.string().min(1),
+  type: zod.z.enum(["button", "input"]),
+  placeholder: zod.z.string().optional(),
+  disabled: zod.z.boolean().optional()
+});
+zod.z.object({
+  title: zod.z.string().min(1).max(100),
+  icon: zod.z.string().url(),
+  description: zod.z.string().min(1).max(500),
+  actions: zod.z.array(ActionButtonSchema).min(1),
+  disabled: zod.z.boolean().optional(),
+  error: zod.z.object({ message: zod.z.string() }).optional()
+});
+var TransactionRequestSchema = zod.z.object({
+  account: zod.z.string().regex(addressRegex, "Invalid Ethereum address"),
+  action: zod.z.string().min(1),
+  input: zod.z.string().optional()
+});
+var EVMTransactionSchema = zod.z.object({
+  to: zod.z.string().regex(addressRegex, "Invalid to address"),
+  value: zod.z.string(),
+  data: zod.z.string().regex(hexRegex, "Invalid hex data"),
+  chainId: zod.z.number().positive()
+});
+zod.z.object({
+  transaction: EVMTransactionSchema,
+  message: zod.z.string().optional()
+});
+function validateTransactionRequest(data) {
+  const result = TransactionRequestSchema.safeParse(data);
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+  return { success: false, error: result.error.message };
+}
+
+// src/adapters/next.ts
+var corsHeaders = {
+  "Access-Control-Allow-Origin": "*",
+  "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+  "Access-Control-Allow-Headers": "Content-Type"
+};
+function createNextHandler(action) {
+  async function GET() {
+    try {
+      const metadata = action.getMetadata();
+      return server.NextResponse.json(metadata, { headers: corsHeaders });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      return server.NextResponse.json(
+        { error: { message } },
+        { status: 500, headers: corsHeaders }
+      );
+    }
+  }
+  async function POST(request) {
+    try {
+      const body = await request.json();
+      const validation = validateTransactionRequest(body);
+      if (!validation.success) {
+        return server.NextResponse.json(
+          { error: { message: validation.error } },
+          { status: 400, headers: corsHeaders }
+        );
+      }
+      const response = await action.handleRequest(validation.data);
+      return server.NextResponse.json(response, { headers: corsHeaders });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      return server.NextResponse.json(
+        { error: { message } },
+        { status: 500, headers: corsHeaders }
+      );
+    }
+  }
+  async function OPTIONS() {
+    return new server.NextResponse(null, { headers: corsHeaders });
+  }
+  return { GET, POST, OPTIONS };
+}
+
+exports.createNextHandler = createNextHandler;
+//# sourceMappingURL=next.js.map
+//# sourceMappingURL=next.js.map

package/dist/adapters/next.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/validators.ts","../../src/adapters/next.ts"],"names":["z","NextResponse"],"mappings":";;;;;;AASA,IAAM,YAAA,GAAe,qBAAA;AAGrB,IAAM,QAAA,GAAW,kBAAA;AAGV,IAAM,kBAAA,GAAqBA,MAAE,MAAA,CAAO;AAAA,EACzC,KAAA,EAAOA,MAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,IAAI,EAAE,CAAA;AAAA,EAC/B,KAAA,EAAOA,KAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA;AAAA,EACvB,MAAMA,KAAA,CAAE,IAAA,CAAK,CAAC,QAAA,EAAU,OAAO,CAAC,CAAA;AAAA,EAChC,WAAA,EAAaA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,QAAA,EAAUA,KAAA,CAAE,OAAA,EAAQ,CAAE,QAAA;AACxB,CAAC,CAAA;AAEmCA,MAAE,MAAA,CAAO;AAAA,EAC3C,KAAA,EAAOA,MAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,IAAI,GAAG,CAAA;AAAA,EAChC,IAAA,EAAMA,KAAA,CAAE,MAAA,EAAO,CAAE,GAAA,EAAI;AAAA,EACrB,WAAA,EAAaA,MAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,IAAI,GAAG,CAAA;AAAA,EACtC,SAASA,KAAA,CAAE,KAAA,CAAM,kBAAkB,CAAA,CAAE,IAAI,CAAC,CAAA;AAAA,EAC1C,QAAA,EAAUA,KAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,EAC/B,KAAA,EAAOA,KAAA,CAAE,MAAA,CAAO,EAAE,OAAA,EAASA,MAAE,MAAA,EAAO,EAAG,CAAA,CAAE,QAAA;AAC3C,CAAC;AAEM,IAAM,wBAAA,GAA2BA,MAAE,MAAA,CAAO;AAAA,EAC/C,SAASA,KAAA,CAAE,MAAA,EAAO,CAAE,KAAA,CAAM,cAAc,0BAA0B,CAAA;AAAA,EAClE,MAAA,EAAQA,KAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA;AAAA,EACxB,KAAA,EAAOA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACpB,CAAC,CAAA;AAEM,IAAM,oBAAA,GAAuBA,MAAE,MAAA,CAAO;AAAA,EAC3C,IAAIA,KAAA,CAAE,MAAA,EAAO,CAAE,KAAA,CAAM,cAAc,oBAAoB,CAAA;AAAA,EACvD,KAAA,EAAOA,MAAE,MAAA,EAAO;AAAA,EAChB,MAAMA,KAAA,CAAE,MAAA,EAAO,CAAE,KAAA,CAAM,UAAU,kBAAkB,CAAA;AAAA,EACnD,OAAA,EAASA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACtB,CAAC,CAAA;AAEwCA,MAAE,MAAA,CAAO;AAAA,EAChD,WAAA,EAAa,oBAAA;AAAA,EACb,OAAA,EAASA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACtB,CAAC;AAaM,SAAS,2BACd,IAAA,EACsC;AACtC,EAAA,MAAM,MAAA,GAAS,wBAAA,CAAyB,SAAA,CAAU,IAAI,CAAA;AACtD,EAAA,IAAI,OAAO,OAAA,EAAS;AAClB,IAAA,OAAO,EAAE,OAAA,EAAS,IAAA,EAAM,IAAA,EAAM,OAAO,IAAA,EAAK;AAAA,EAC5C;AACA,EAAA,OAAO,EAAE,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,MAAA,CAAO,MAAM,OAAA,EAAQ;AACvD;;;AC/DA,IAAM,WAAA,GAAc;AAAA,EAClB,6BAAA,EAA+B,GAAA;AAAA,EAC/B,8BAAA,EAAgC,oBAAA;AAAA,EAChC,8BAAA,EAAgC;AAClC,CAAA;AAGO,SAAS,kBAAkB,MAAA,EAAgB;AAEhD,EAAA,eAAe,GAAA,GAAM;AACnB,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,OAAO,WAAA,EAAY;AACpC,MAAA,OAAOC,oBAAa,IAAA,CAAK,QAAA,EAAU,EAAE,OAAA,EAAS,aAAa,CAAA;AAAA,IAC7D,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,OAAA,GAAU,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,eAAA;AACzD,MAAA,OAAOA,mBAAA,CAAa,IAAA;AAAA,QAClB,EAAE,KAAA,EAAO,EAAE,OAAA,EAAQ,EAAE;AAAA,QACrB,EAAE,MAAA,EAAQ,GAAA,EAAK,OAAA,EAAS,WAAA;AAAY,OACtC;AAAA,IACF;AAAA,EACF;AAGA,EAAA,eAAe,KAAK,OAAA,EAAsB;AACxC,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,GAAO,MAAM,OAAA,CAAQ,IAAA,EAAK;AAGhC,MAAA,MAAM,UAAA,GAAa,2BAA2B,IAAI,CAAA;AAClD,MAAA,IAAI,CAAC,WAAW,OAAA,EAAS;AACvB,QAAA,OAAOA,mBAAA,CAAa,IAAA;AAAA,UAClB,EAAE,KAAA,EAAO,EAAE,OAAA,EAAS,UAAA,CAAW,OAAM,EAAE;AAAA,UACvC,EAAE,MAAA,EAAQ,GAAA,EAAK,OAAA,EAAS,WAAA;AAAY,SACtC;AAAA,MACF;AAGA,MAAA,MAAM,QAAA,GAAW,MAAM,MAAA,CAAO,aAAA,CAAc,WAAW,IAAI,CAAA;AAE3D,MAAA,OAAOA,oBAAa,IAAA,CAAK,QAAA,EAAU,EAAE,OAAA,EAAS,aAAa,CAAA;AAAA,IAC7D,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,OAAA,GAAU,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,eAAA;AACzD,MAAA,OAAOA,mBAAA,CAAa,IAAA;AAAA,QAClB,EAAE,KAAA,EAAO,EAAE,OAAA,EAAQ,EAAE;AAAA,QACrB,EAAE,MAAA,EAAQ,GAAA,EAAK,OAAA,EAAS,WAAA;AAAY,OACtC;AAAA,IACF;AAAA,EACF;AAGA,EAAA,eAAe,OAAA,GAAU;AACvB,IAAA,OAAO,IAAIA,mBAAA,CAAa,IAAA,EAAM,EAAE,OAAA,EAAS,aAAa,CAAA;AAAA,EACxD;AAEA,EAAA,OAAO,EAAE,GAAA,EAAK,IAAA,EAAM,OAAA,EAAQ;AAC9B","file":"next.js","sourcesContent":["import { z } from 'zod';\nimport type {\n  ActionMetadata,\n  TransactionRequest,\n  TransactionResponse,\n  ValidationResult,\n} from './types';\n\n// Ethereum address regex\nconst addressRegex = /^0x[a-fA-F0-9]{40}$/;\n\n// Hex string regex\nconst hexRegex = /^0x[a-fA-F0-9]*$/;\n\n// Zod Schemas\nexport const ActionButtonSchema = z.object({\n  label: z.string().min(1).max(50),\n  value: z.string().min(1),\n  type: z.enum(['button', 'input']),\n  placeholder: z.string().optional(),\n  disabled: z.boolean().optional(),\n});\n\nexport const ActionMetadataSchema = z.object({\n  title: z.string().min(1).max(100),\n  icon: z.string().url(),\n  description: z.string().min(1).max(500),\n  actions: z.array(ActionButtonSchema).min(1),\n  disabled: z.boolean().optional(),\n  error: z.object({ message: z.string() }).optional(),\n});\n\nexport const TransactionRequestSchema = z.object({\n  account: z.string().regex(addressRegex, 'Invalid Ethereum address'),\n  action: z.string().min(1),\n  input: z.string().optional(),\n});\n\nexport const EVMTransactionSchema = z.object({\n  to: z.string().regex(addressRegex, 'Invalid to address'),\n  value: z.string(),\n  data: z.string().regex(hexRegex, 'Invalid hex data'),\n  chainId: z.number().positive(),\n});\n\nexport const TransactionResponseSchema = z.object({\n  transaction: EVMTransactionSchema,\n  message: z.string().optional(),\n});\n\n// Validation functions\nexport function validateActionMetadata(\n  data: unknown\n): ValidationResult<ActionMetadata> {\n  const result = ActionMetadataSchema.safeParse(data);\n  if (result.success) {\n    return { success: true, data: result.data as ActionMetadata };\n  }\n  return { success: false, error: result.error.message };\n}\n\nexport function validateTransactionRequest(\n  data: unknown\n): ValidationResult<TransactionRequest> {\n  const result = TransactionRequestSchema.safeParse(data);\n  if (result.success) {\n    return { success: true, data: result.data };\n  }\n  return { success: false, error: result.error.message };\n}\n\nexport function validateTransactionResponse(\n  data: unknown\n): ValidationResult<TransactionResponse> {\n  const result = TransactionResponseSchema.safeParse(data);\n  if (result.success) {\n    return { success: true, data: result.data as TransactionResponse };\n  }\n  return { success: false, error: result.error.message };\n}\n\nexport function isValidAddress(address: string): boolean {\n  return addressRegex.test(address);\n}\n\nexport function isValidHex(hex: string): boolean {\n  return hexRegex.test(hex);\n}\n","import type { NextRequest } from 'next/server';\nimport { NextResponse } from 'next/server';\nimport type { Action } from '../builders';\nimport { validateTransactionRequest } from '../validators';\n\n// CORS headers\nconst corsHeaders = {\n  'Access-Control-Allow-Origin': '*',\n  'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',\n  'Access-Control-Allow-Headers': 'Content-Type',\n};\n\n// Create Next.js App Router handlers\nexport function createNextHandler(action: Action) {\n  // GET handler - returns action metadata\n  async function GET() {\n    try {\n      const metadata = action.getMetadata();\n      return NextResponse.json(metadata, { headers: corsHeaders });\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      return NextResponse.json(\n        { error: { message } },\n        { status: 500, headers: corsHeaders }\n      );\n    }\n  }\n\n  // POST handler - returns transaction\n  async function POST(request: NextRequest) {\n    try {\n      const body = await request.json();\n\n      // Validate request\n      const validation = validateTransactionRequest(body);\n      if (!validation.success) {\n        return NextResponse.json(\n          { error: { message: validation.error } },\n          { status: 400, headers: corsHeaders }\n        );\n      }\n\n      // Handle request\n      const response = await action.handleRequest(validation.data);\n\n      return NextResponse.json(response, { headers: corsHeaders });\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      return NextResponse.json(\n        { error: { message } },\n        { status: 500, headers: corsHeaders }\n      );\n    }\n  }\n\n  // OPTIONS handler - CORS preflight\n  async function OPTIONS() {\n    return new NextResponse(null, { headers: corsHeaders });\n  }\n\n  return { GET, POST, OPTIONS };\n}\n"]}

package/dist/adapters/next.mjs

@@ -0,0 +1,92 @@
+import { NextResponse } from 'next/server';
+import { z } from 'zod';
+
+// src/adapters/next.ts
+var addressRegex = /^0x[a-fA-F0-9]{40}$/;
+var hexRegex = /^0x[a-fA-F0-9]*$/;
+var ActionButtonSchema = z.object({
+  label: z.string().min(1).max(50),
+  value: z.string().min(1),
+  type: z.enum(["button", "input"]),
+  placeholder: z.string().optional(),
+  disabled: z.boolean().optional()
+});
+z.object({
+  title: z.string().min(1).max(100),
+  icon: z.string().url(),
+  description: z.string().min(1).max(500),
+  actions: z.array(ActionButtonSchema).min(1),
+  disabled: z.boolean().optional(),
+  error: z.object({ message: z.string() }).optional()
+});
+var TransactionRequestSchema = z.object({
+  account: z.string().regex(addressRegex, "Invalid Ethereum address"),
+  action: z.string().min(1),
+  input: z.string().optional()
+});
+var EVMTransactionSchema = z.object({
+  to: z.string().regex(addressRegex, "Invalid to address"),
+  value: z.string(),
+  data: z.string().regex(hexRegex, "Invalid hex data"),
+  chainId: z.number().positive()
+});
+z.object({
+  transaction: EVMTransactionSchema,
+  message: z.string().optional()
+});
+function validateTransactionRequest(data) {
+  const result = TransactionRequestSchema.safeParse(data);
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+  return { success: false, error: result.error.message };
+}
+
+// src/adapters/next.ts
+var corsHeaders = {
+  "Access-Control-Allow-Origin": "*",
+  "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+  "Access-Control-Allow-Headers": "Content-Type"
+};
+function createNextHandler(action) {
+  async function GET() {
+    try {
+      const metadata = action.getMetadata();
+      return NextResponse.json(metadata, { headers: corsHeaders });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      return NextResponse.json(
+        { error: { message } },
+        { status: 500, headers: corsHeaders }
+      );
+    }
+  }
+  async function POST(request) {
+    try {
+      const body = await request.json();
+      const validation = validateTransactionRequest(body);
+      if (!validation.success) {
+        return NextResponse.json(
+          { error: { message: validation.error } },
+          { status: 400, headers: corsHeaders }
+        );
+      }
+      const response = await action.handleRequest(validation.data);
+      return NextResponse.json(response, { headers: corsHeaders });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      return NextResponse.json(
+        { error: { message } },
+        { status: 500, headers: corsHeaders }
+      );
+    }
+  }
+  async function OPTIONS() {
+    return new NextResponse(null, { headers: corsHeaders });
+  }
+  return { GET, POST, OPTIONS };
+}
+
+export { createNextHandler };
+//# sourceMappingURL=next.mjs.map
+//# sourceMappingURL=next.mjs.map

package/dist/adapters/next.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/validators.ts","../../src/adapters/next.ts"],"names":[],"mappings":"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","file":"next.mjs","sourcesContent":["import { z } from 'zod';\nimport type {\n  ActionMetadata,\n  TransactionRequest,\n  TransactionResponse,\n  ValidationResult,\n} from './types';\n\n// Ethereum address regex\nconst addressRegex = /^0x[a-fA-F0-9]{40}$/;\n\n// Hex string regex\nconst hexRegex = /^0x[a-fA-F0-9]*$/;\n\n// Zod Schemas\nexport const ActionButtonSchema = z.object({\n  label: z.string().min(1).max(50),\n  value: z.string().min(1),\n  type: z.enum(['button', 'input']),\n  placeholder: z.string().optional(),\n  disabled: z.boolean().optional(),\n});\n\nexport const ActionMetadataSchema = z.object({\n  title: z.string().min(1).max(100),\n  icon: z.string().url(),\n  description: z.string().min(1).max(500),\n  actions: z.array(ActionButtonSchema).min(1),\n  disabled: z.boolean().optional(),\n  error: z.object({ message: z.string() }).optional(),\n});\n\nexport const TransactionRequestSchema = z.object({\n  account: z.string().regex(addressRegex, 'Invalid Ethereum address'),\n  action: z.string().min(1),\n  input: z.string().optional(),\n});\n\nexport const EVMTransactionSchema = z.object({\n  to: z.string().regex(addressRegex, 'Invalid to address'),\n  value: z.string(),\n  data: z.string().regex(hexRegex, 'Invalid hex data'),\n  chainId: z.number().positive(),\n});\n\nexport const TransactionResponseSchema = z.object({\n  transaction: EVMTransactionSchema,\n  message: z.string().optional(),\n});\n\n// Validation functions\nexport function validateActionMetadata(\n  data: unknown\n): ValidationResult<ActionMetadata> {\n  const result = ActionMetadataSchema.safeParse(data);\n  if (result.success) {\n    return { success: true, data: result.data as ActionMetadata };\n  }\n  return { success: false, error: result.error.message };\n}\n\nexport function validateTransactionRequest(\n  data: unknown\n): ValidationResult<TransactionRequest> {\n  const result = TransactionRequestSchema.safeParse(data);\n  if (result.success) {\n    return { success: true, data: result.data };\n  }\n  return { success: false, error: result.error.message };\n}\n\nexport function validateTransactionResponse(\n  data: unknown\n): ValidationResult<TransactionResponse> {\n  const result = TransactionResponseSchema.safeParse(data);\n  if (result.success) {\n    return { success: true, data: result.data as TransactionResponse };\n  }\n  return { success: false, error: result.error.message };\n}\n\nexport function isValidAddress(address: string): boolean {\n  return addressRegex.test(address);\n}\n\nexport function isValidHex(hex: string): boolean {\n  return hexRegex.test(hex);\n}\n","import type { NextRequest } from 'next/server';\nimport { NextResponse } from 'next/server';\nimport type { Action } from '../builders';\nimport { validateTransactionRequest } from '../validators';\n\n// CORS headers\nconst corsHeaders = {\n  'Access-Control-Allow-Origin': '*',\n  'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',\n  'Access-Control-Allow-Headers': 'Content-Type',\n};\n\n// Create Next.js App Router handlers\nexport function createNextHandler(action: Action) {\n  // GET handler - returns action metadata\n  async function GET() {\n    try {\n      const metadata = action.getMetadata();\n      return NextResponse.json(metadata, { headers: corsHeaders });\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      return NextResponse.json(\n        { error: { message } },\n        { status: 500, headers: corsHeaders }\n      );\n    }\n  }\n\n  // POST handler - returns transaction\n  async function POST(request: NextRequest) {\n    try {\n      const body = await request.json();\n\n      // Validate request\n      const validation = validateTransactionRequest(body);\n      if (!validation.success) {\n        return NextResponse.json(\n          { error: { message: validation.error } },\n          { status: 400, headers: corsHeaders }\n        );\n      }\n\n      // Handle request\n      const response = await action.handleRequest(validation.data);\n\n      return NextResponse.json(response, { headers: corsHeaders });\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      return NextResponse.json(\n        { error: { message } },\n        { status: 500, headers: corsHeaders }\n      );\n    }\n  }\n\n  // OPTIONS handler - CORS preflight\n  async function OPTIONS() {\n    return new NextResponse(null, { headers: corsHeaders });\n  }\n\n  return { GET, POST, OPTIONS };\n}\n"]}

package/dist/builders-OoJ5KB_g.d.mts

@@ -0,0 +1,84 @@
+type ActionType = 'button' | 'input';
+interface ActionButton {
+    label: string;
+    value: string;
+    type: ActionType;
+    placeholder?: string;
+    disabled?: boolean;
+}
+interface ActionError {
+    message: string;
+}
+interface ActionMetadata {
+    title: string;
+    icon: string;
+    description: string;
+    actions: ActionButton[];
+    disabled?: boolean;
+    error?: ActionError;
+}
+interface TransactionRequest {
+    account: string;
+    action: string;
+    input?: string;
+}
+interface EVMTransaction {
+    to: string;
+    value: string;
+    data: string;
+    chainId: number;
+}
+interface TransactionResponse {
+    transaction: EVMTransaction;
+    message?: string;
+}
+interface ActionContext {
+    account: string;
+    action: string;
+    input?: string;
+}
+type ActionHandler = (context: ActionContext) => Promise<TransactionResponse>;
+interface ActionDefinition {
+    title: string;
+    icon: string;
+    description: string;
+    actions: ActionButton[];
+    disabled?: boolean;
+    handler: ActionHandler;
+}
+interface ChainConfig {
+    chainId: number;
+    name: string;
+    rpcUrl: string;
+    explorerUrl: string;
+    nativeCurrency: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+}
+type ValidationResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: string;
+};
+
+declare function button(config: {
+    label: string;
+    value: string;
+    disabled?: boolean;
+}): ActionButton;
+declare function input(config: {
+    label: string;
+    placeholder?: string;
+    disabled?: boolean;
+}): ActionButton;
+interface Action {
+    getMetadata(): ActionMetadata;
+    handleRequest(request: TransactionRequest): Promise<TransactionResponse>;
+}
+declare function createAction(definition: ActionDefinition): Action;
+
+export { type ActionMetadata as A, type ChainConfig as C, type EVMTransaction as E, type TransactionRequest as T, type ValidationResult as V, type TransactionResponse as a, type ActionType as b, type ActionButton as c, type ActionError as d, type ActionHandler as e, type ActionDefinition as f, type ActionContext as g, createAction as h, button as i, input as j, type Action as k };