@firela/runtime-adapters 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 fire-la
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,156 @@
+# @firela/runtime-adapters
+
+Platform-agnostic runtime adapters for Cloudflare Workers, Node.js, and edge runtimes.
+
+## Overview
+
+This package provides a unified abstraction layer for runtime-specific capabilities, allowing your code to run seamlessly across different JavaScript environments:
+
+- **Cloudflare Workers** - KV storage, Web Crypto API
+- **Node.js** - File-based storage, Node crypto module
+- **Edge runtimes** - Any environment implementing the adapter interfaces
+
+## Installation
+
+```bash
+npm install @firela/runtime-adapters
+# or
+pnpm add @firela/runtime-adapters
+```
+
+## Quick Start
+
+### Cloudflare Workers
+
+```typescript
+import { createCloudflareAdapter } from '@firela/runtime-adapters/cloudflare'
+
+export default {
+  async fetch(request, env, ctx) {
+    const adapter = createCloudflareAdapter(env)
+
+    // Use KV store
+    await adapter.kv.set('session:abc', { userId: 'user1' }, { ttl: 3600000 })
+
+    // Use crypto
+    const signature = await adapter.crypto.hmacSha256('payload', 'secret')
+
+    // Log messages
+    adapter.logger.info('Request processed')
+
+    return new Response('OK')
+  }
+}
+```
+
+### Node.js
+
+```typescript
+import { createNodeAdapter } from '@firela/runtime-adapters/node'
+
+const adapter = createNodeAdapter()
+
+// Use in-memory KV store (useful for development/testing)
+await adapter.kv.set('key', 'value')
+
+// Use Node.js crypto
+const bytes = adapter.crypto.randomBytes(16)
+
+// Console logging
+adapter.logger.info('Application started')
+```
+
+## API Reference
+
+### Types
+
+```typescript
+interface KVStore {
+  get<T = unknown>(key: string): Promise<T | null>
+  set<T>(key: string, value: T, options?: { ttl?: number }): Promise<void>
+  delete(key: string): Promise<boolean>
+}
+
+interface CryptoAdapter {
+  hmacSha256(data: string, secret: string): Promise<string>
+  randomBytes(length: number): Uint8Array
+}
+
+interface Logger {
+  debug(message: string, ...args: unknown[]): void
+  info(message: string, ...args: unknown[]): void
+  warn(message: string, ...args: unknown[]): void
+  error(message: string, ...args: unknown[]): void
+}
+
+interface RuntimeAdapter {
+  kv: KVStore
+  crypto: CryptoAdapter
+  logger: Logger
+  platform: string
+}
+```
+
+### Cloudflare Adapter
+
+```typescript
+import { createCloudflareAdapter } from '@firela/runtime-adapters/cloudflare'
+
+const adapter = createCloudflareAdapter(env, 'KV') // 'KV' is the default namespace
+```
+
+**Features:**
+- `CloudflareKVStore` - Wraps KVNamespace for key-value storage
+- `CloudflareCryptoAdapter` - Uses Web Crypto API
+- `ConsoleLogger` - Console-based logging
+
+### Node.js Adapter
+
+```typescript
+import { createNodeAdapter } from '@firela/runtime-adapters/node'
+
+const adapter = createNodeAdapter()
+```
+
+**Features:**
+- `MemoryKVStore` - In-memory key-value storage (useful for development)
+- `NodeCryptoAdapter` - Uses Node.js crypto module
+- `ConsoleLogger` - Console-based logging
+
+## Usage Examples
+
+### Rate Limiting with KV Storage
+
+```typescript
+import { createCloudflareAdapter } from '@firela/runtime-adapters/cloudflare'
+
+const adapter = createCloudflareAdapter(env)
+
+async function checkRateLimit(key: string, limit: number, windowMs: number): Promise<boolean> {
+  const count = await adapter.kv.get<number>(key) || 0
+
+  if (count >= limit) {
+    return false
+  }
+
+  await adapter.kv.set(key, count + 1, { ttl: windowMs })
+  return true
+}
+```
+
+### HMAC Signature Verification
+
+```typescript
+import { createCloudflareAdapter } from '@firela/runtime-adapters/cloudflare'
+
+const adapter = createCloudflareAdapter(env)
+
+async function verifySignature(payload: string, signature: string, secret: string): Promise<boolean> {
+  const expected = await adapter.crypto.hmacSha256(payload, secret)
+  return expected === signature
+}
+```
+
+## License
+
+MIT

package/dist/cloudflare.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Cloudflare Workers Runtime Adapter
+ *
+ * Provides RuntimeAdapter implementation for Cloudflare Workers environment:
+ * - KVNamespace for KVStore
+ * - Web Crypto API for CryptoAdapter
+ * - Console for Logger
+ */
+import type { KVStore, CryptoAdapter, Logger, RuntimeAdapter } from './types.js';
+/**
+ * CloudflareKVStore - KVNamespace wrapper implementing KVStore interface
+ *
+ * Uses Cloudflare KV for persistent storage with TTL support.
+ */
+export declare class CloudflareKVStore implements KVStore {
+    private kv;
+    constructor(kv: KVNamespace);
+    get<T = unknown>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, options?: {
+        ttl?: number;
+    }): Promise<void>;
+    delete(key: string): Promise<boolean>;
+}
+/**
+ * CloudflareCryptoAdapter - Web Crypto API implementation
+ *
+ * Uses the Web Crypto API available in Cloudflare Workers.
+ */
+export declare class CloudflareCryptoAdapter implements CryptoAdapter {
+    hmacSha256(data: string, secret: string): Promise<string>;
+    randomBytes(length: number): Uint8Array;
+}
+/**
+ * ConsoleLogger - Console-based logger for Cloudflare Workers
+ */
+export declare class ConsoleLogger implements Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Cloudflare environment bindings type
+ *
+ * Extend this interface to include your specific bindings.
+ */
+export interface CloudflareEnv {
+    /** Cloudflare KV namespace binding */
+    KV?: KVNamespace;
+}
+/**
+ * Create a RuntimeAdapter for Cloudflare Workers
+ *
+ * @param env - Cloudflare environment bindings (includes KV namespace)
+ * @param kvNamespace - Optional KV namespace name (defaults to 'KV')
+ * @returns RuntimeAdapter instance configured for Cloudflare Workers
+ *
+ * @example
+ * ```typescript
+ * import { createCloudflareAdapter } from '@firela/runtime-adapters/cloudflare'
+ *
+ * export default {
+ *   async fetch(request, env, ctx) {
+ *     const adapter = createCloudflareAdapter(env)
+ *
+ *     // Use KV store
+ *     await adapter.kv.set('session:abc', { userId: 'user1' }, { ttl: 3600000 })
+ *
+ *     // Use crypto
+ *     const signature = await adapter.crypto.hmacSha256('payload', 'secret')
+ *
+ *     return new Response('OK')
+ *   }
+ * }
+ * ```
+ */
+export declare function createCloudflareAdapter(env: CloudflareEnv, kvNamespace?: string): RuntimeAdapter;
+export type { KVStore, CryptoAdapter, Logger, RuntimeAdapter } from './types.js';
+//# sourceMappingURL=cloudflare.d.ts.map

package/dist/cloudflare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhF;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,OAAO;IACnC,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,WAAW;IAE7B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKhD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAO5C;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,aAAa;IACrD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwB/D,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;CAKxC;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAGjD;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,EAAE,CAAC,EAAE,WAAW,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,aAAa,EAClB,WAAW,GAAE,MAAa,GACzB,cAAc,CAchB;AAGD,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}

package/dist/cloudflare.js

@@ -0,0 +1,119 @@
+/**
+ * Cloudflare Workers Runtime Adapter
+ *
+ * Provides RuntimeAdapter implementation for Cloudflare Workers environment:
+ * - KVNamespace for KVStore
+ * - Web Crypto API for CryptoAdapter
+ * - Console for Logger
+ */
+/**
+ * CloudflareKVStore - KVNamespace wrapper implementing KVStore interface
+ *
+ * Uses Cloudflare KV for persistent storage with TTL support.
+ */
+export class CloudflareKVStore {
+    kv;
+    constructor(kv) {
+        this.kv = kv;
+    }
+    async get(key) {
+        const value = await this.kv.get(key, 'json');
+        return value;
+    }
+    async set(key, value, options) {
+        if (options?.ttl !== undefined) {
+            // Convert ms to seconds for Cloudflare KV expirationTtl
+            const expirationTtl = Math.floor(options.ttl / 1000);
+            await this.kv.put(key, JSON.stringify(value), { expirationTtl });
+        }
+        else {
+            await this.kv.put(key, JSON.stringify(value));
+        }
+    }
+    async delete(key) {
+        // Cloudflare KV delete doesn't return whether key existed
+        // We check first to provide consistent interface
+        const exists = await this.kv.get(key) !== null;
+        await this.kv.delete(key);
+        return exists;
+    }
+}
+/**
+ * CloudflareCryptoAdapter - Web Crypto API implementation
+ *
+ * Uses the Web Crypto API available in Cloudflare Workers.
+ */
+export class CloudflareCryptoAdapter {
+    async hmacSha256(data, secret) {
+        const encoder = new TextEncoder();
+        const keyData = encoder.encode(secret);
+        // Import the secret key
+        const key = await crypto.subtle.importKey('raw', keyData, { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
+        // Sign the data
+        const signature = await crypto.subtle.sign('HMAC', key, encoder.encode(data));
+        // Convert to base64
+        return btoa(String.fromCharCode(...new Uint8Array(signature)));
+    }
+    randomBytes(length) {
+        const bytes = new Uint8Array(length);
+        crypto.getRandomValues(bytes);
+        return bytes;
+    }
+}
+/**
+ * ConsoleLogger - Console-based logger for Cloudflare Workers
+ */
+export class ConsoleLogger {
+    debug(message, ...args) {
+        console.debug(message, ...args);
+    }
+    info(message, ...args) {
+        console.info(message, ...args);
+    }
+    warn(message, ...args) {
+        console.warn(message, ...args);
+    }
+    error(message, ...args) {
+        console.error(message, ...args);
+    }
+}
+/**
+ * Create a RuntimeAdapter for Cloudflare Workers
+ *
+ * @param env - Cloudflare environment bindings (includes KV namespace)
+ * @param kvNamespace - Optional KV namespace name (defaults to 'KV')
+ * @returns RuntimeAdapter instance configured for Cloudflare Workers
+ *
+ * @example
+ * ```typescript
+ * import { createCloudflareAdapter } from '@firela/runtime-adapters/cloudflare'
+ *
+ * export default {
+ *   async fetch(request, env, ctx) {
+ *     const adapter = createCloudflareAdapter(env)
+ *
+ *     // Use KV store
+ *     await adapter.kv.set('session:abc', { userId: 'user1' }, { ttl: 3600000 })
+ *
+ *     // Use crypto
+ *     const signature = await adapter.crypto.hmacSha256('payload', 'secret')
+ *
+ *     return new Response('OK')
+ *   }
+ * }
+ * ```
+ */
+export function createCloudflareAdapter(env, kvNamespace = 'KV') {
+    // Get KV namespace from env
+    const kv = env[kvNamespace];
+    if (!kv) {
+        throw new Error(`KV namespace '${kvNamespace}' not found in environment bindings`);
+    }
+    return {
+        kv: new CloudflareKVStore(kv),
+        logger: new ConsoleLogger(),
+        platform: 'cloudflare',
+        crypto: new CloudflareCryptoAdapter(),
+    };
+}
+//# sourceMappingURL=cloudflare.js.map

package/dist/cloudflare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare.js","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IACR;IAApB,YAAoB,EAAe;QAAf,OAAE,GAAF,EAAE,CAAa;IAAG,CAAC;IAEvC,KAAK,CAAC,GAAG,CAAc,GAAW;QAChC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAC5C,OAAO,KAAiB,CAAA;IAC1B,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,OAA0B;QAC5D,IAAI,OAAO,EAAE,GAAG,KAAK,SAAS,EAAE,CAAC;YAC/B,wDAAwD;YACxD,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAA;YACpD,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,aAAa,EAAE,CAAC,CAAA;QAClE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,0DAA0D;QAC1D,iDAAiD;QACjD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAA;QAC9C,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACzB,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,uBAAuB;IAClC,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,MAAc;QAC3C,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;QACjC,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAEtC,wBAAwB;QACxB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CACvC,KAAK,EACL,OAAO,EACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EACjC,KAAK,EACL,CAAC,MAAM,CAAC,CACT,CAAA;QAED,gBAAgB;QAChB,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CACxC,MAAM,EACN,GAAG,EACH,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CACrB,CAAA;QAED,oBAAoB;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;IAChE,CAAC;IAED,WAAW,CAAC,MAAc;QACxB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAA;QACpC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;QAC7B,OAAO,KAAK,CAAA;IACd,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACjC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IAChC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IAChC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACjC,CAAC;CACF;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,uBAAuB,CACrC,GAAkB,EAClB,cAAsB,IAAI;IAE1B,4BAA4B;IAC5B,MAAM,EAAE,GAAG,GAAG,CAAC,WAAkC,CAAC,CAAA;IAElD,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,iBAAiB,WAAW,qCAAqC,CAAC,CAAA;IACpF,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI,iBAAiB,CAAC,EAAiB,CAAC;QAC5C,MAAM,EAAE,IAAI,aAAa,EAAE;QAC3B,QAAQ,EAAE,YAAY;QACtB,MAAM,EAAE,IAAI,uBAAuB,EAAE;KACtC,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @firela/runtime-adapters - Platform-agnostic runtime abstraction
+ *
+ * This package provides interfaces and implementations for abstracting
+ * platform-specific capabilities across different runtime environments.
+ *
+ * ## Available Adapters
+ *
+ * - **Cloudflare Workers**: `import { createCloudflareAdapter } from '@firela/runtime-adapters/cloudflare'`
+ * - **Node.js**: `import { createNodeAdapter } from '@firela/runtime-adapters/node'`
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * // For Cloudflare Workers
+ * import { createCloudflareAdapter } from '@firela/runtime-adapters/cloudflare'
+ *
+ * export default {
+ *   async fetch(request, env) {
+ *     const adapter = createCloudflareAdapter(env)
+ *     await adapter.kv.set('key', 'value')
+ *     return new Response('OK')
+ *   }
+ * }
+ *
+ * // For Node.js
+ * import { createNodeAdapter } from '@firela/runtime-adapters/node'
+ *
+ * const adapter = createNodeAdapter()
+ * await adapter.kv.set('key', 'value')
+ * ```
+ */
+export type { KVStore, CryptoAdapter, Logger, RuntimeAdapter } from './types.js';
+export { createCloudflareAdapter, CloudflareKVStore, CloudflareCryptoAdapter } from './cloudflare.js';
+export { createNodeAdapter, MemoryKVStore, NodeCryptoAdapter, ConsoleLogger } from './node.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGhF,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AACrG,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -0,0 +1,36 @@
+/**
+ * @firela/runtime-adapters - Platform-agnostic runtime abstraction
+ *
+ * This package provides interfaces and implementations for abstracting
+ * platform-specific capabilities across different runtime environments.
+ *
+ * ## Available Adapters
+ *
+ * - **Cloudflare Workers**: `import { createCloudflareAdapter } from '@firela/runtime-adapters/cloudflare'`
+ * - **Node.js**: `import { createNodeAdapter } from '@firela/runtime-adapters/node'`
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * // For Cloudflare Workers
+ * import { createCloudflareAdapter } from '@firela/runtime-adapters/cloudflare'
+ *
+ * export default {
+ *   async fetch(request, env) {
+ *     const adapter = createCloudflareAdapter(env)
+ *     await adapter.kv.set('key', 'value')
+ *     return new Response('OK')
+ *   }
+ * }
+ *
+ * // For Node.js
+ * import { createNodeAdapter } from '@firela/runtime-adapters/node'
+ *
+ * const adapter = createNodeAdapter()
+ * await adapter.kv.set('key', 'value')
+ * ```
+ */
+// Re-export adapters for convenience (sub-path exports recommended)
+export { createCloudflareAdapter, CloudflareKVStore, CloudflareCryptoAdapter } from './cloudflare.js';
+export { createNodeAdapter, MemoryKVStore, NodeCryptoAdapter, ConsoleLogger } from './node.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAKH,oEAAoE;AACpE,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AACrG,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA"}

package/dist/node.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Node.js Runtime Adapter
+ *
+ * Provides RuntimeAdapter implementation for Node.js environment:
+ * - In-memory Map for KVStore (MemoryKVStore)
+ * - Node.js crypto module for CryptoAdapter
+ * - Console for Logger
+ */
+import type { KVStore, CryptoAdapter, Logger, RuntimeAdapter } from './types.js';
+/**
+ * MemoryKVStore - In-memory KVStore implementation
+ *
+ * Stores values in a Map with optional TTL support.
+ * Note: Data is not persisted and is lost on process restart.
+ */
+export declare class MemoryKVStore implements KVStore {
+    private store;
+    get<T = unknown>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, options?: {
+        ttl?: number;
+    }): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    /**
+     * Clear all entries (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Get number of entries (useful for testing)
+     */
+    get size(): number;
+}
+/**
+ * NodeCryptoAdapter - Node.js crypto module implementation
+ *
+ * Uses the built-in node:crypto module for cryptographic operations.
+ */
+export declare class NodeCryptoAdapter implements CryptoAdapter {
+    hmacSha256(data: string, secret: string): Promise<string>;
+    randomBytes(length: number): Uint8Array;
+}
+/**
+ * ConsoleLogger - Console-based logger for Node.js
+ */
+export declare class ConsoleLogger implements Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Create a RuntimeAdapter for Node.js
+ *
+ * @param kv - Optional KVStore instance (defaults to MemoryKVStore)
+ * @param logger - Optional Logger instance (defaults to ConsoleLogger)
+ * @returns RuntimeAdapter instance configured for Node.js
+ *
+ * @example
+ * ```typescript
+ * import { createNodeAdapter, MemoryKVStore } from '@firela/runtime-adapters/node'
+ *
+ * // Create adapter with default in-memory KV store
+ * const adapter = createNodeAdapter()
+ *
+ * // Or with custom KV store
+ * const customKV = new MemoryKVStore()
+ * const adapter = createNodeAdapter({ kv: customKV })
+ *
+ * // Use KV store
+ * await adapter.kv.set('session:abc', { userId: 'user1' }, { ttl: 3600000 })
+ *
+ * // Use crypto
+ * const signature = await adapter.crypto.hmacSha256('payload', 'secret')
+ * ```
+ */
+export declare function createNodeAdapter(options?: {
+    kv?: KVStore;
+    logger?: Logger;
+}): RuntimeAdapter;
+export type { KVStore, CryptoAdapter, Logger, RuntimeAdapter } from './types.js';
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhF;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,OAAO;IAC3C,OAAO,CAAC,KAAK,CAA4D;IAEnE,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAgBhD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3C;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IAC/C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM/D,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;CAGxC;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAGjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE;IAC1C,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,GAAG,cAAc,CAOjB;AAGD,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}

package/dist/node.js

@@ -0,0 +1,118 @@
+/**
+ * Node.js Runtime Adapter
+ *
+ * Provides RuntimeAdapter implementation for Node.js environment:
+ * - In-memory Map for KVStore (MemoryKVStore)
+ * - Node.js crypto module for CryptoAdapter
+ * - Console for Logger
+ */
+import crypto from 'node:crypto';
+/**
+ * MemoryKVStore - In-memory KVStore implementation
+ *
+ * Stores values in a Map with optional TTL support.
+ * Note: Data is not persisted and is lost on process restart.
+ */
+export class MemoryKVStore {
+    store = new Map();
+    async get(key) {
+        const entry = this.store.get(key);
+        if (!entry) {
+            return null;
+        }
+        // Check TTL expiration
+        if (entry.expiresAt !== undefined && Date.now() > entry.expiresAt) {
+            this.store.delete(key);
+            return null;
+        }
+        return entry.value;
+    }
+    async set(key, value, options) {
+        const entry = { value };
+        if (options?.ttl !== undefined) {
+            entry.expiresAt = Date.now() + options.ttl;
+        }
+        this.store.set(key, entry);
+    }
+    async delete(key) {
+        return this.store.delete(key);
+    }
+    /**
+     * Clear all entries (useful for testing)
+     */
+    clear() {
+        this.store.clear();
+    }
+    /**
+     * Get number of entries (useful for testing)
+     */
+    get size() {
+        return this.store.size;
+    }
+}
+/**
+ * NodeCryptoAdapter - Node.js crypto module implementation
+ *
+ * Uses the built-in node:crypto module for cryptographic operations.
+ */
+export class NodeCryptoAdapter {
+    async hmacSha256(data, secret) {
+        const hmac = crypto.createHmac('sha256', secret);
+        hmac.update(data);
+        return hmac.digest('base64');
+    }
+    randomBytes(length) {
+        return crypto.randomBytes(length);
+    }
+}
+/**
+ * ConsoleLogger - Console-based logger for Node.js
+ */
+export class ConsoleLogger {
+    debug(message, ...args) {
+        console.debug(message, ...args);
+    }
+    info(message, ...args) {
+        console.info(message, ...args);
+    }
+    warn(message, ...args) {
+        console.warn(message, ...args);
+    }
+    error(message, ...args) {
+        console.error(message, ...args);
+    }
+}
+/**
+ * Create a RuntimeAdapter for Node.js
+ *
+ * @param kv - Optional KVStore instance (defaults to MemoryKVStore)
+ * @param logger - Optional Logger instance (defaults to ConsoleLogger)
+ * @returns RuntimeAdapter instance configured for Node.js
+ *
+ * @example
+ * ```typescript
+ * import { createNodeAdapter, MemoryKVStore } from '@firela/runtime-adapters/node'
+ *
+ * // Create adapter with default in-memory KV store
+ * const adapter = createNodeAdapter()
+ *
+ * // Or with custom KV store
+ * const customKV = new MemoryKVStore()
+ * const adapter = createNodeAdapter({ kv: customKV })
+ *
+ * // Use KV store
+ * await adapter.kv.set('session:abc', { userId: 'user1' }, { ttl: 3600000 })
+ *
+ * // Use crypto
+ * const signature = await adapter.crypto.hmacSha256('payload', 'secret')
+ * ```
+ */
+export function createNodeAdapter(options) {
+    return {
+        kv: options?.kv ?? new MemoryKVStore(),
+        logger: options?.logger ?? new ConsoleLogger(),
+        platform: 'node',
+        crypto: new NodeCryptoAdapter(),
+    };
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,139 @@
+/**
+ * RuntimeAdapter Types - Platform-agnostic runtime abstraction
+ *
+ * This module defines interfaces for abstracting platform-specific capabilities
+ * across different runtime environments (Cloudflare Workers, Node.js, Vercel, etc.)
+ *
+ * ## Design Decisions (Expert Review 2026-03-12)
+ *
+ * 1. **RuntimeAdapter vs RuntimeContext** - These are independent interfaces:
+ *    - RuntimeAdapter: Platform capabilities (kv, crypto) - for Workers
+ *    - RuntimeContext: Application context (config, storage, events) - for CLI/OpenClaw
+ *
+ * 2. **No SQLDatabase interface** - Existing StorageAdapter satisfies business needs
+ *
+ * 3. **KVStore usage** - For session, rate limit counter, cache
+ */
+/**
+ * Logger interface - Platform-agnostic logging
+ *
+ * Implementations:
+ * - Cloudflare: console (native)
+ * - Node.js: console or pino/winston
+ */
+export interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * KVStore - Key-value storage for session, rate limiting, and caching
+ *
+ * Implementations:
+ * - Cloudflare: KVNamespace binding
+ * - Node.js: MemoryKVStore / SQLite
+ * - Vercel/Netlify: Upstash Redis
+ *
+ * @example
+ * ```typescript
+ * // Store session with TTL
+ * await kv.set('session:abc123', { userId: 'user1' }, { ttl: 3600000 }) // 1 hour
+ *
+ * // Retrieve session
+ * const session = await kv.get<{ userId: string }>('session:abc123')
+ *
+ * // Delete session
+ * await kv.delete('session:abc123')
+ * ```
+ */
+export interface KVStore {
+    /**
+     * Get a value by key
+     * @param key - The key to retrieve
+     * @returns The value or null if not found
+     */
+    get<T = unknown>(key: string): Promise<T | null>;
+    /**
+     * Set a value with optional TTL
+     * @param key - The key to set
+     * @param value - The value to store
+     * @param options - Optional settings including TTL in milliseconds
+     */
+    set<T>(key: string, value: T, options?: {
+        ttl?: number;
+    }): Promise<void>;
+    /**
+     * Delete a key
+     * @param key - The key to delete
+     * @returns true if the key existed and was deleted
+     */
+    delete(key: string): Promise<boolean>;
+}
+/**
+ * CryptoAdapter - Platform-agnostic cryptographic capabilities
+ *
+ * Implementations:
+ * - Cloudflare: Web Crypto API
+ * - Node.js: node:crypto module
+ *
+ * @example
+ * ```typescript
+ * // HMAC for webhook signature verification
+ * const signature = await crypto.hmacSha256(payload, secret)
+ *
+ * // Generate random bytes for session IDs
+ * const sessionId = crypto.randomBytes(16)
+ * ```
+ */
+export interface CryptoAdapter {
+    /**
+     * Compute HMAC-SHA256
+     * @param data - The data to sign
+     * @param secret - The secret key
+     * @returns Base64-encoded signature
+     */
+    hmacSha256(data: string, secret: string): Promise<string>;
+    /**
+     * Generate cryptographically secure random bytes
+     * @param length - Number of bytes to generate
+     * @returns Uint8Array of random bytes
+     */
+    randomBytes(length: number): Uint8Array;
+}
+/**
+ * RuntimeAdapter - Platform abstraction for Worker environments
+ *
+ * This interface abstracts platform-specific capabilities for Cloudflare Workers,
+ * Vercel Edge Functions, Netlify Edge Functions, and similar edge runtimes.
+ *
+ * Note: CLI/OpenClaw continue using RuntimeContext (includes config, platform.openUrl).
+ * The two interfaces are independent and serve different purposes:
+ * - RuntimeAdapter: Platform capabilities (kv, crypto)
+ * - RuntimeContext: Application context (config, storage, events)
+ *
+ * @example
+ * ```typescript
+ * // In Cloudflare Worker
+ * import { createCloudflareAdapter } from '@firela/runtime-adapters/cloudflare'
+ *
+ * export default {
+ *   async fetch(request, env) {
+ *     const adapter = createCloudflareAdapter(env)
+ *     await adapter.kv.set('key', 'value')
+ *     return new Response('OK')
+ *   }
+ * }
+ * ```
+ */
+export interface RuntimeAdapter {
+    /** Key-value store for session, rate limiting, and cache */
+    readonly kv: KVStore;
+    /** Logger instance */
+    readonly logger: Logger;
+    /** Platform identifier */
+    readonly platform: 'cloudflare' | 'node' | 'vercel' | 'netlify';
+    /** Cryptographic utilities */
+    readonly crypto: CryptoAdapter;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CACjD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,OAAO;IACtB;;;;OAIG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAEhD;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAExE;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACtC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEzD;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;CACxC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;IAEpB,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAA;IAE/D,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAC/B"}

package/dist/types.js

@@ -0,0 +1,18 @@
+/**
+ * RuntimeAdapter Types - Platform-agnostic runtime abstraction
+ *
+ * This module defines interfaces for abstracting platform-specific capabilities
+ * across different runtime environments (Cloudflare Workers, Node.js, Vercel, etc.)
+ *
+ * ## Design Decisions (Expert Review 2026-03-12)
+ *
+ * 1. **RuntimeAdapter vs RuntimeContext** - These are independent interfaces:
+ *    - RuntimeAdapter: Platform capabilities (kv, crypto) - for Workers
+ *    - RuntimeContext: Application context (config, storage, events) - for CLI/OpenClaw
+ *
+ * 2. **No SQLDatabase interface** - Existing StorageAdapter satisfies business needs
+ *
+ * 3. **KVStore usage** - For session, rate limit counter, cache
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@firela/runtime-adapters",
+  "version": "0.1.0",
+  "description": "Platform-agnostic runtime adapters for Cloudflare Workers, Node.js, and edge runtimes",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./cloudflare": {
+      "types": "./dist/cloudflare.d.ts",
+      "import": "./dist/cloudflare.js",
+      "default": "./dist/cloudflare.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js",
+      "default": "./dist/node.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "runtime",
+    "adapters",
+    "cloudflare-workers",
+    "nodejs",
+    "edge-computing",
+    "platform-agnostic"
+  ],
+  "author": "fire-la",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fire-la/billclaw.git",
+    "directory": "packages/runtime-adapters"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20260312.0",
+    "@types/node": "^25.2.0",
+    "oxfmt": "^0.1.0",
+    "oxlint": "^0.15.0",
+    "typescript": "^5.8.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "oxlint",
+    "format": "oxfmt src/",
+    "format:write": "oxfmt -w src/",
+    "clean": "rm -rf dist"
+  }
+}