secondsky/claude-skills / plugins/cloudflare-workers/skills/cloudflare-workers-migration
cloudflare-workers-migration
VerifiedMigrate to Cloudflare Workers from AWS Lambda, Vercel, Express, and Node.js. Use when porting existing applications to the edge, adapting serverless functions, or resolving Node.js API compatibility issues.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.2 KB |
| references/express-migration.md | markdown | 13.0 KB |
| references/lambda-migration.md | markdown | 11.4 KB |
| references/node-compatibility.md | markdown | 11.1 KB |
| references/vercel-migration.md | markdown | 11.8 KB |
| scripts/analyze-migration.sh | script | 13.6 KB |
| templates/express-adapter.ts | script | 11.8 KB |
| templates/lambda-adapter.ts | script | 10.4 KB |
| templates/node-compat.ts | script | 12.6 KB |
| templates/vercel-adapter.ts | script | 12.6 KB |
templates/lambda-adapter.ts
View on GitHub/**
* AWS Lambda to Cloudflare Workers Adapter
*
* Enables minimal code changes when migrating Lambda handlers.
* Converts Lambda event/context to Workers Request/env.
*
* Usage:
* 1. Keep existing Lambda handler code
* 2. Import and wrap with adaptLambdaHandler
* 3. Export as Workers default
*/
// ============================================
// TYPE DEFINITIONS
// ============================================
export interface LambdaEvent {
body: string | null;
headers: Record<string, string | undefined>;
httpMethod: string;
path: string;
pathParameters: Record<string, string> | null;
queryStringParameters: Record<string, string> | null;
requestContext: {
requestId: string;
stage: string;
identity: {
sourceIp: string;
userAgent: string | null;
};
};
isBase64Encoded: boolean;
}
export interface LambdaContext {
awsRequestId: string;
functionName: string;
memoryLimitInMB: string;
getRemainingTimeInMillis: () => number;
callbackWaitsForEmptyEventLoop: boolean;
}
export interface LambdaResponse {
statusCode: number;
headers?: Record<string, string>;
multiValueHeaders?: Record<string, string[]>;
body?: string;
isBase64Encoded?: boolean;
}
export type LambdaHandler<TEnv = unknown> = (
event: LambdaEvent,
context: LambdaContext,
env?: TEnv
) => Promise<LambdaResponse>;
// ============================================
// PATH PARAMETER EXTRACTION
// ============================================
interface RoutePattern {
pattern: RegExp;
paramNames: string[];
}
const routePatterns: RoutePattern[] = [];
/**
* Register a route pattern for path parameter extraction
* @example registerRoute('/users/:id')
* @example registerRoute('/posts/:postId/comments/:commentId')
*/
export function registerRoute(pattern: string): void {
const paramNames: string[] = [];
const regexPattern = pattern.replace(/:(\w+)/g, (_, name) => {
paramNames.push(name);
return '([^/]+)';
});
routePatterns.push({
pattern: new RegExp(`^${regexPattern}$`),
paramNames,
});
}
function extractPathParams(path: string): Record<string, string> | null {
for (const { pattern, paramNames } of routePatterns) {
const match = path.match(pattern);
if (match) {
const params: Record<string, string> = {};
paramNames.forEach((name, index) => {
params[name] = match[index + 1];
});
return params;
}
}
return null;
}
// ============================================
// REQUEST CONVERSION
// ============================================
async function requestToLambdaEvent(request: Request): Promise<LambdaEvent> {
const url = new URL(request.url);
// Parse body
let body: string | null = null;
let isBase64Encoded = false;
if (request.method !== 'GET' && request.method !== 'HEAD') {
const contentType = request.headers.get('content-type') || '';
if (
contentType.includes('application/json') ||
contentType.includes('text/') ||
contentType.includes('application/x-www-form-urlencoded')
) {
body = await request.text();
} else {
// Binary data - base64 encode
const buffer = await request.arrayBuffer();
body = btoa(String.fromCharCode(...new Uint8Array(buffer)));
isBase64Encoded = true;
}
}
// Convert headers
const headers: Record<string, string> = {};
request.headers.forEach((value, key) => {
headers[key.toLowerCase()] = value;
});
// Parse query string
const queryStringParameters: Record<string, string> = {};
url.searchParams.forEach((value, key) => {
queryStringParameters[key] = value;
});
// Extract path parameters
const pathParameters = extractPathParams(url.pathname);
return {
body,
headers,
httpMethod: request.method,
path: url.pathname,
pathParameters,
queryStringParameters:
Object.keys(queryStringParameters).length > 0 ? queryStringParameters : null,
requestContext: {
requestId: crypto.randomUUID(),
stage: 'prod',
identity: {
sourceIp: request.headers.get('cf-connecting-ip') || '0.0.0.0',
userAgent: request.headers.get('user-agent'),
},
},
isBase64Encoded,
};
}
function createLambdaContext(): LambdaContext {
const startTime = Date.now();
const timeout = 50; // Workers limit in ms
return {
awsRequestId: crypto.randomUUID(),
functionName: 'cloudflare-worker',
memoryLimitInMB: '128',
getRemainingTimeInMillis: () => Math.max(0, timeout - (Date.now() - startTime)),
callbackWaitsForEmptyEventLoop: true,
};
}
// ============================================
// RESPONSE CONVERSION
// ============================================
function lambdaResponseToResponse(result: LambdaResponse): Response {
const headers = new Headers();
// Add regular headers
if (result.headers) {
Object.entries(result.headers).forEach(([key, value]) => {
headers.set(key, value);
});
}
// Add multi-value headers
if (result.multiValueHeaders) {
Object.entries(result.multiValueHeaders).forEach(([key, values]) => {
values.forEach((value) => {
headers.append(key, value);
});
});
}
// Handle body
let body: BodyInit | null = null;
if (result.body) {
if (result.isBase64Encoded) {
// Decode base64 to binary
const binaryString = atob(result.body);
const bytes = new Uint8Array(binaryString.length);
for (let i = 0; i < binaryString.length; i++) {
bytes[i] = binaryString.charCodeAt(i);
}
body = bytes;
} else {
body = result.body;
}
}
return new Response(body, {
status: result.statusCode,
headers,
});
}
// ============================================
// MAIN ADAPTER
// ============================================
/**
* Adapt a Lambda handler to work in Cloudflare Workers
*
* @example
* // Existing Lambda handler
* const handler = async (event, context) => {
* return { statusCode: 200, body: JSON.stringify({ hello: 'world' }) };
* };
*
* // Export for Workers
* export default adaptLambdaHandler(handler);
*/
export function adaptLambdaHandler<TEnv = unknown>(
handler: LambdaHandler<TEnv>,
options?: {
routes?: string[];
}
) {
// Register routes for path parameter extraction
if (options?.routes) {
options.routes.forEach(registerRoute);
}
return {
async fetch(request: Request, env: TEnv): Promise<Response> {
try {
// Convert Request to Lambda Event
const event = await requestToLambdaEvent(request);
const context = createLambdaContext();
// Call Lambda handler
const result = await handler(event, context, env);
// Convert Lambda Response to Response
return lambdaResponseToResponse(result);
} catch (error) {
console.error('Lambda adapter error:', error);
return new Response(
JSON.stringify({
error: 'Internal Server Error',
message: error instanceof Error ? error.message : 'Unknown error',
}),
{
status: 500,
headers: { 'Content-Type': 'application/json' },
}
);
}
},
};
}
// ============================================
// EXAMPLE USAGE
// ============================================
/*
// existing-lambda.ts (minimal changes)
import { LambdaEvent, LambdaContext } from './lambda-adapter';
export const handler = async (event: LambdaEvent, context: LambdaContext) => {
const userId = event.pathParameters?.id;
if (!userId) {
return {
statusCode: 400,
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ error: 'User ID required' }),
};
}
// Existing logic...
const user = await getUser(userId);
return {
statusCode: 200,
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(user),
};
};
// index.ts (Workers entry point)
import { adaptLambdaHandler } from './lambda-adapter';
import { handler } from './existing-lambda';
export default adaptLambdaHandler(handler, {
routes: [
'/users/:id',
'/posts/:postId/comments/:commentId',
],
});
*/
// ============================================
// DynamoDB COMPATIBILITY LAYER
// ============================================
export interface D1LikeDynamoDB {
get(params: { TableName: string; Key: Record<string, any> }): Promise<{ Item?: any }>;
put(params: { TableName: string; Item: Record<string, any> }): Promise<void>;
query(params: {
TableName: string;
KeyConditionExpression: string;
ExpressionAttributeValues: Record<string, any>;
}): Promise<{ Items: any[] }>;
delete(params: { TableName: string; Key: Record<string, any> }): Promise<void>;
}
/**
* Create a DynamoDB-like interface backed by D1
*
* Note: This is a simplified adapter. Production use may need
* more sophisticated mapping depending on your DynamoDB usage.
*/
export function createDynamoDBAdapter(db: D1Database): D1LikeDynamoDB {
return {
async get({ TableName, Key }) {
const keyName = Object.keys(Key)[0];
const keyValue = Key[keyName];
const result = await db
.prepare(`SELECT * FROM ${TableName} WHERE ${keyName} = ?`)
.bind(keyValue)
.first();
return { Item: result || undefined };
},
async put({ TableName, Item }) {
const columns = Object.keys(Item);
const values = Object.values(Item);
const placeholders = columns.map(() => '?').join(', ');
await db
.prepare(
`INSERT OR REPLACE INTO ${TableName} (${columns.join(', ')}) VALUES (${placeholders})`
)
.bind(...values)
.run();
},
async query({ TableName, KeyConditionExpression, ExpressionAttributeValues }) {
// Simplified: assumes format "pk = :pk"
const match = KeyConditionExpression.match(/(\w+)\s*=\s*:(\w+)/);
if (!match) {
throw new Error('Unsupported KeyConditionExpression');
}
const [, column, placeholder] = match;
const value = ExpressionAttributeValues[`:${placeholder}`];
const { results } = await db
.prepare(`SELECT * FROM ${TableName} WHERE ${column} = ?`)
.bind(value)
.all();
return { Items: results };
},
async delete({ TableName, Key }) {
const keyName = Object.keys(Key)[0];
const keyValue = Key[keyName];
await db
.prepare(`DELETE FROM ${TableName} WHERE ${keyName} = ?`)
.bind(keyValue)
.run();
},
};
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |