@velajs/cloudflare 0.1.1 → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+## 0.2.0 (2026-04-28)
+
+### Breaking changes
+
+- **`CloudflareFactory` renamed to `createCloudflareApp`.** The factory object exposed exactly one method (`.create`) and was a thin wrapper around `VelaFactory`. Replaced with a plain async function:
+
+  ```ts
+  // before
+  import { CloudflareFactory } from '@velajs/cloudflare';
+  const app = await CloudflareFactory.create(AppModule);
+
+  // after
+  import { createCloudflareApp } from '@velajs/cloudflare';
+  const app = await createCloudflareApp(AppModule);
+  ```
+
+### New
+
+- `CloudflareApplication.scheduled()` now also dispatches `@Cron('expr')` jobs from `@velajs/vela`. Use either the cloudflare-specific `@Scheduled()` decorator or the framework's `@Cron()` decorator — both are matched against the incoming cron event.
+
+### Compatibility
+
+- Requires `@velajs/vela` ≥ 1.0.0 for the `@Cron` integration. The schedule split in vela 0.10 makes its `ScheduleModule` metadata-only, which lets edge platforms drive cron via their native triggers.
+
+## 0.1.0 (2026-04-13)
+
+Initial release.

package/README.md

@@ -1,19 +1,40 @@
 # @velajs/cloudflare
 
+[![npm version](https://img.shields.io/npm/v/@velajs/cloudflare)](https://www.npmjs.com/package/@velajs/cloudflare)
+[![CI](https://github.com/velajs/cloudflare/actions/workflows/ci.yml/badge.svg)](https://github.com/velajs/cloudflare/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/npm/l/@velajs/cloudflare)](https://github.com/velajs/cloudflare/blob/main/LICENSE)
+
 Cloudflare Workers integration for the [Vela](https://github.com/velajs/vela) framework. NestJS-style per-service modules for KV, D1, R2, Queues, Durable Objects, Workers AI, Vectorize, and Hyperdrive.
 
 ## Install
 
 ```bash
-bun add @velajs/cloudflare @velajs/vela hono
+pnpm add @velajs/cloudflare @velajs/vela hono
+pnpm add -D @cloudflare/workers-types
+```
+
+`@cloudflare/workers-types` is a required peer (types-only — zero runtime cost). It's what gives `KVNamespace`, `D1Database`, `R2Bucket`, `Queue`, `DurableObjectNamespace`, `Ai`, `VectorizeIndex`, and `Hyperdrive` their proper types when you reach into the underlying binding.
+
+## Service shape
+
+Every service is a thin typed wrapper around its Cloudflare binding. Use the accessor (`.namespace`, `.database`, `.bucket`, `.queue`, `.binding`, `.index`) to call the binding's methods directly — full `@cloudflare/workers-types` autocomplete, no shim layer in between.
+
+```ts
+class KVService { readonly namespace: KVNamespace; }
+class D1Service { readonly database: D1Database; }
+class R2Service { readonly bucket: R2Bucket; }
+class QueueService<T> { readonly queue: Queue<T>; }
+class DurableObjectService { readonly namespace: DurableObjectNamespace; }
+class AIService { readonly binding: Ai; }
+class VectorizeService { readonly index: VectorizeIndex; }
+class HyperdriveService { readonly binding: Hyperdrive; }
 ```
 
 ## Quick Start
 
 ```ts
 import { Controller, Get, Module, Injectable, Param } from '@velajs/vela';
-import { CloudflareFactory, KVModule, D1Module } from '@velajs/cloudflare';
-import type { KVService, D1Service } from '@velajs/cloudflare';
+import { CloudflareFactory, KVModule, KVService, D1Module, D1Service } from '@velajs/cloudflare';
 
 @Injectable()
 class UserService {
@@ -23,11 +44,11 @@ class UserService {
   ) {}
 
   async findById(id: string) {
-    const cached = await this.kv.get(`user:${id}`);
+    const cached = await this.kv.namespace.get(`user:${id}`);
     if (cached) return JSON.parse(cached as string);
 
-    const user = await this.d1.prepare('SELECT * FROM users WHERE id = ?').bind(id).first();
-    if (user) await this.kv.put(`user:${id}`, JSON.stringify(user));
+    const user = await this.d1.database.prepare('SELECT * FROM users WHERE id = ?').bind(id).first();
+    if (user) await this.kv.namespace.put(`user:${id}`, JSON.stringify(user));
     return user;
   }
 }
@@ -85,8 +106,7 @@ Each module follows the same pattern: `XModule.forRoot({ binding: 'NAME' })` ret
 ### KVModule
 
 ```ts
-import { KVModule } from '@velajs/cloudflare';
-import type { KVService } from '@velajs/cloudflare';
+import { KVModule, KVService } from '@velajs/cloudflare';
 
 @Module({ imports: [KVModule.forRoot({ binding: 'MY_KV' })] })
 class AppModule {}
@@ -95,18 +115,17 @@ class AppModule {}
 class CacheService {
   constructor(private kv: KVService) {}
 
-  async get(key: string) { return this.kv.get(key); }
-  async set(key: string, value: string) { return this.kv.put(key, value); }
-  async remove(key: string) { return this.kv.delete(key); }
-  async keys() { return this.kv.list(); }
+  async get(key: string) { return this.kv.namespace.get(key); }
+  async set(key: string, value: string) { return this.kv.namespace.put(key, value); }
+  async remove(key: string) { return this.kv.namespace.delete(key); }
+  async keys() { return this.kv.namespace.list(); }
 }
 ```
 
 ### D1Module
 
 ```ts
-import { D1Module } from '@velajs/cloudflare';
-import type { D1Service } from '@velajs/cloudflare';
+import { D1Module, D1Service } from '@velajs/cloudflare';
 
 @Module({ imports: [D1Module.forRoot({ binding: 'DB' })] })
 class AppModule {}
@@ -116,11 +135,11 @@ class PostService {
   constructor(private d1: D1Service) {}
 
   async findAll() {
-    return this.d1.prepare('SELECT * FROM posts').all();
+    return this.d1.database.prepare('SELECT * FROM posts').all();
   }
 
   async create(title: string) {
-    return this.d1.prepare('INSERT INTO posts (title) VALUES (?)').bind(title).run();
+    return this.d1.database.prepare('INSERT INTO posts (title) VALUES (?)').bind(title).run();
   }
 }
 ```
@@ -128,8 +147,7 @@ class PostService {
 ### R2Module
 
 ```ts
-import { R2Module } from '@velajs/cloudflare';
-import type { R2Service } from '@velajs/cloudflare';
+import { R2Module, R2Service } from '@velajs/cloudflare';
 
 @Module({ imports: [R2Module.forRoot({ binding: 'ASSETS' })] })
 class AppModule {}
@@ -138,17 +156,16 @@ class AppModule {}
 class StorageService {
   constructor(private r2: R2Service) {}
 
-  async upload(key: string, data: string) { return this.r2.put(key, data); }
-  async download(key: string) { return this.r2.get(key); }
-  async remove(key: string) { return this.r2.delete(key); }
+  async upload(key: string, data: string) { return this.r2.bucket.put(key, data); }
+  async download(key: string) { return this.r2.bucket.get(key); }
+  async remove(key: string) { return this.r2.bucket.delete(key); }
 }
 ```
 
 ### QueueModule
 
 ```ts
-import { QueueModule } from '@velajs/cloudflare';
-import type { QueueService } from '@velajs/cloudflare';
+import { QueueModule, QueueService } from '@velajs/cloudflare';
 
 @Module({ imports: [QueueModule.forRoot({ binding: 'EMAIL_QUEUE' })] })
 class AppModule {}
@@ -158,7 +175,7 @@ class NotificationService {
   constructor(private queue: QueueService) {}
 
   async sendEmail(to: string, subject: string) {
-    await this.queue.send({ to, subject });
+    await this.queue.queue.send({ to, subject });
   }
 }
 ```
@@ -166,8 +183,7 @@ class NotificationService {
 ### DurableObjectModule
 
 ```ts
-import { DurableObjectModule } from '@velajs/cloudflare';
-import type { DurableObjectService } from '@velajs/cloudflare';
+import { DurableObjectModule, DurableObjectService } from '@velajs/cloudflare';
 
 @Module({ imports: [DurableObjectModule.forRoot({ binding: 'COUNTER' })] })
 class AppModule {}
@@ -177,8 +193,8 @@ class CounterService {
   constructor(private doNs: DurableObjectService) {}
 
   async increment(name: string) {
-    const id = this.doNs.idFromName(name);
-    const stub = this.doNs.get(id);
+    const id = this.doNs.namespace.idFromName(name);
+    const stub = this.doNs.namespace.get(id);
     return (stub as any).fetch('/increment');
   }
 }
@@ -187,8 +203,7 @@ class CounterService {
 ### AIModule
 
 ```ts
-import { AIModule } from '@velajs/cloudflare';
-import type { AIService } from '@velajs/cloudflare';
+import { AIModule, AIService } from '@velajs/cloudflare';
 
 @Module({ imports: [AIModule.forRoot({ binding: 'AI' })] })
 class AppModule {}
@@ -198,7 +213,7 @@ class ChatService {
   constructor(private ai: AIService) {}
 
   async chat(prompt: string) {
-    return this.ai.run('@cf/meta/llama-3.1-8b-instruct', {
+    return this.ai.binding.run('@cf/meta/llama-3.1-8b-instruct', {
       messages: [{ role: 'user', content: prompt }],
     });
   }
@@ -208,8 +223,7 @@ class ChatService {
 ### VectorizeModule
 
 ```ts
-import { VectorizeModule } from '@velajs/cloudflare';
-import type { VectorizeService } from '@velajs/cloudflare';
+import { VectorizeModule, VectorizeService } from '@velajs/cloudflare';
 
 @Module({ imports: [VectorizeModule.forRoot({ binding: 'EMBEDDINGS' })] })
 class AppModule {}
@@ -219,11 +233,11 @@ class SearchService {
   constructor(private vectorize: VectorizeService) {}
 
   async search(vector: number[]) {
-    return this.vectorize.query(vector, { topK: 10 });
+    return this.vectorize.index.query(vector, { topK: 10 });
   }
 
   async addVectors(vectors: unknown[]) {
-    return this.vectorize.upsert(vectors);
+    return this.vectorize.index.upsert(vectors);
   }
 }
 ```
@@ -231,8 +245,7 @@ class SearchService {
 ### HyperdriveModule
 
 ```ts
-import { HyperdriveModule } from '@velajs/cloudflare';
-import type { HyperdriveService } from '@velajs/cloudflare';
+import { HyperdriveModule, HyperdriveService } from '@velajs/cloudflare';
 
 @Module({ imports: [HyperdriveModule.forRoot({ binding: 'POSTGRES' })] })
 class AppModule {}
@@ -242,11 +255,11 @@ class DbService {
   constructor(private hd: HyperdriveService) {}
 
   getConnectionString() {
-    return this.hd.connectionString;
+    return this.hd.binding.connectionString;
   }
 
   getConfig() {
-    return { host: this.hd.host, port: this.hd.port, database: this.hd.database };
+    return { host: this.hd.binding.host, port: this.hd.binding.port, database: this.hd.binding.database };
   }
 }
 ```

package/dist/binding-ref.d.ts

@@ -1,15 +1,8 @@
-/**
- * Mutable holder for a Cloudflare binding value.
- *
- * Created by each module's `forRoot()` and populated by
- * CloudflareFactory's one-time middleware on the first request.
- * Services access the binding lazily via `.value`.
- */
 export declare class BindingRef<T = unknown> {
     readonly bindingName: string;
     private _value;
     constructor(bindingName: string);
     get value(): T;
-    /** @internal — called by CloudflareFactory middleware */
-    _initialize(value: any): void;
+    /** @internal — called by createCloudflareApp middleware */
+    _initialize(value: T): void;
 }

package/dist/binding-ref.js

@@ -1,10 +1,7 @@
-/**
- * Mutable holder for a Cloudflare binding value.
- *
- * Created by each module's `forRoot()` and populated by
- * CloudflareFactory's one-time middleware on the first request.
- * Services access the binding lazily via `.value`.
- */ export class BindingRef {
+// Mutable holder for a Cloudflare binding value. Created by each module's
+// forRoot() and populated by createCloudflareApp's one-time middleware on
+// the first request. Services access the binding lazily via .value.
+export class BindingRef {
     bindingName;
     _value;
     constructor(bindingName){
@@ -12,12 +9,11 @@
     }
     get value() {
         if (this._value === undefined) {
-            throw new Error(`Cloudflare binding '${this.bindingName}' not initialized. ` + `Ensure CloudflareFactory.create() is used and a request has been made.`);
+            throw new Error(`Cloudflare binding '${this.bindingName}' not initialized. ` + `Ensure createCloudflareApp() is used and a request has been made.`);
         }
         return this._value;
     }
-    /** @internal — called by CloudflareFactory middleware */ // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    _initialize(value) {
+    /** @internal — called by createCloudflareApp middleware */ _initialize(value) {
         this._value = value;
     }
 }

package/dist/cloudflare-application.d.ts

@@ -1,15 +1,16 @@
 import type { Hono } from 'hono';
-import type { VelaApplication } from '@velajs/vela';
+import { type VelaApplication } from '@velajs/vela';
 import type { CloudflareEnv } from './types';
 /**
  * Wraps VelaApplication with Cloudflare-specific handlers:
  * - `fetch` — HTTP request handler (from Hono)
- * - `scheduled` — Cron trigger handler (matches `@Scheduled()` decorators)
+ * - `scheduled` — Cron trigger handler (matches `@Scheduled()` decorators
+ *                 AND vela's own `@Cron()` jobs)
  * - `queue` — Queue consumer handler (matches `@QueueConsumer()` decorators)
  *
  * @example
  * ```ts
- * const app = await CloudflareFactory.create(AppModule);
+ * const app = await createCloudflareApp(AppModule);
  * export default {
  *   fetch: app.fetch,
  *   scheduled: app.scheduled.bind(app),
@@ -24,11 +25,11 @@ export declare class CloudflareApplication {
     constructor(app: VelaApplication);
     get fetch(): Hono['fetch'];
     getHonoApp(): Hono;
-    /** @internal — scans instances for @Scheduled and @QueueConsumer metadata */
+    /** @internal — scans instances for @Scheduled, @Cron, and @QueueConsumer metadata */
     scanInstances(instances: unknown[]): void;
     /**
      * Handle Cloudflare scheduled (cron) events.
-     * Matches the event's cron expression to `@Scheduled()` handlers.
+     * Matches the event's cron expression to `@Scheduled()` and vela `@Cron()` handlers.
      */
     scheduled(event: {
         cron: string;
@@ -46,6 +47,5 @@ export declare class CloudflareApplication {
     }, env: CloudflareEnv, ctx: {
         waitUntil: (promise: Promise<unknown>) => void;
     }): Promise<void>;
-    /** Gracefully shut down the application. */
     close(signal?: string): Promise<void>;
 }

package/dist/cloudflare-application.js

@@ -1,14 +1,23 @@
+import { CRON_METADATA, getMetadata } from "@velajs/vela";
 import { getScheduledMetadata } from "./decorators/scheduled.js";
 import { getQueueConsumerMetadata } from "./decorators/queue-consumer.js";
+function invoke(instance, methodName, args) {
+    const method = instance[methodName];
+    if (typeof method !== 'function') {
+        throw new Error(`Method '${methodName}' is not a function on ${instance.constructor.name}`);
+    }
+    return method.apply(instance, args);
+}
 /**
  * Wraps VelaApplication with Cloudflare-specific handlers:
  * - `fetch` — HTTP request handler (from Hono)
- * - `scheduled` — Cron trigger handler (matches `@Scheduled()` decorators)
+ * - `scheduled` — Cron trigger handler (matches `@Scheduled()` decorators
+ *                 AND vela's own `@Cron()` jobs)
  * - `queue` — Queue consumer handler (matches `@QueueConsumer()` decorators)
  *
  * @example
  * ```ts
- * const app = await CloudflareFactory.create(AppModule);
+ * const app = await createCloudflareApp(AppModule);
  * export default {
  *   fetch: app.fetch,
  *   scheduled: app.scheduled.bind(app),
@@ -28,19 +37,26 @@ import { getQueueConsumerMetadata } from "./decorators/queue-consumer.js";
     getHonoApp() {
         return this.app.getHonoApp();
     }
-    /** @internal — scans instances for @Scheduled and @QueueConsumer metadata */ scanInstances(instances) {
+    /** @internal — scans instances for @Scheduled, @Cron, and @QueueConsumer metadata */ scanInstances(instances) {
         for (const instance of instances){
             if (!instance || typeof instance !== 'object') continue;
-            const scheduledMeta = getScheduledMetadata(instance);
-            for (const meta of scheduledMeta){
+            for (const meta of getScheduledMetadata(instance)){
                 this.scheduledHandlers.push({
                     instance,
                     methodName: meta.methodName,
                     cron: meta.cron
                 });
             }
-            const queueMeta = getQueueConsumerMetadata(instance);
-            for (const meta of queueMeta){
+            // vela's @Cron jobs run via the same Workers cron trigger.
+            const cronMeta = getMetadata(CRON_METADATA, instance.constructor) ?? [];
+            for (const meta of cronMeta){
+                this.scheduledHandlers.push({
+                    instance,
+                    methodName: meta.methodName,
+                    cron: meta.expression
+                });
+            }
+            for (const meta of getQueueConsumerMetadata(instance)){
                 this.queueConsumers.push({
                     instance,
                     methodName: meta.methodName,
@@ -51,27 +67,27 @@ import { getQueueConsumerMetadata } from "./decorators/queue-consumer.js";
     }
     /**
    * Handle Cloudflare scheduled (cron) events.
-   * Matches the event's cron expression to `@Scheduled()` handlers.
+   * Matches the event's cron expression to `@Scheduled()` and vela `@Cron()` handlers.
    */ async scheduled(event, env, ctx) {
         const matching = this.scheduledHandlers.filter((h)=>h.cron === event.cron);
-        const promises = matching.map((handler)=>{
-            const method = handler.instance[handler.methodName];
-            return method.call(handler.instance, event, env, ctx);
-        });
-        await Promise.all(promises);
+        await Promise.all(matching.map((h)=>invoke(h.instance, h.methodName, [
+                event,
+                env,
+                ctx
+            ])));
     }
     /**
    * Handle Cloudflare Queue consumer events.
    * Matches the batch queue name to `@QueueConsumer()` handlers.
    */ async queue(batch, env, ctx) {
         const matching = this.queueConsumers.filter((h)=>h.queueName === batch.queue);
-        const promises = matching.map((handler)=>{
-            const method = handler.instance[handler.methodName];
-            return method.call(handler.instance, batch, env, ctx);
-        });
-        await Promise.all(promises);
+        await Promise.all(matching.map((h)=>invoke(h.instance, h.methodName, [
+                batch,
+                env,
+                ctx
+            ])));
     }
-    /** Gracefully shut down the application. */ async close(signal) {
+    async close(signal) {
         return this.app.close(signal);
     }
 }

package/dist/cloudflare-factory.d.ts

@@ -1,18 +1,15 @@
 import type { Type } from '@velajs/vela';
 import { CloudflareApplication } from './cloudflare-application';
 /**
- * Factory for creating Cloudflare Worker applications.
- * Replaces `VelaFactory.create()` for Cloudflare apps.
+ * Create a Cloudflare Workers application.
  *
- * Sets up a one-time Hono middleware that captures `c.env` on the
- * first request and initializes all configured binding refs.
+ * Sets up a one-time Hono middleware that captures `c.env` on the first
+ * request and initializes all configured binding refs.
  *
  * @example
  * ```ts
- * const app = await CloudflareFactory.create(AppModule);
+ * const app = await createCloudflareApp(AppModule);
  * export default app; // has .fetch, .scheduled, .queue
  * ```
  */
-export declare const CloudflareFactory: {
-    create(rootModule: Type): Promise<CloudflareApplication>;
-};
+export declare function createCloudflareApp(rootModule: Type): Promise<CloudflareApplication>;

package/dist/cloudflare-factory.js

@@ -1,42 +1,53 @@
 import { VelaFactory } from "@velajs/vela";
+import { BindingRef } from "./binding-ref.js";
 import { CloudflareApplication } from "./cloudflare-application.js";
-import { bindingsRegistry } from "./tokens.js";
+// Walks every provider registered in the container and pulls out the
+// BindingRef instances. Replaces the old module-level `bindingsRegistry`
+// global so two CloudflareApplication instances in one process don't
+// share state.
+function collectBindingRefs(container) {
+    const refs = [];
+    for (const token of container.getTokens()){
+        let value;
+        try {
+            value = container.resolve(token);
+        } catch  {
+            continue;
+        }
+        if (value instanceof BindingRef) refs.push(value);
+    }
+    return refs;
+}
 /**
- * Factory for creating Cloudflare Worker applications.
- * Replaces `VelaFactory.create()` for Cloudflare apps.
+ * Create a Cloudflare Workers application.
  *
- * Sets up a one-time Hono middleware that captures `c.env` on the
- * first request and initializes all configured binding refs.
+ * Sets up a one-time Hono middleware that captures `c.env` on the first
+ * request and initializes all configured binding refs.
  *
  * @example
  * ```ts
- * const app = await CloudflareFactory.create(AppModule);
+ * const app = await createCloudflareApp(AppModule);
  * export default app; // has .fetch, .scheduled, .queue
  * ```
- */ export const CloudflareFactory = {
-    async create (rootModule) {
-        const velaApp = await VelaFactory.create(rootModule);
-        // One-time middleware: captures c.env on first request
-        // and initializes all BindingRef instances from bindingsRegistry.
-        // Registered via useGlobalMiddleware so it persists across rebuilds.
-        let initialized = false;
-        velaApp.useGlobalMiddleware({
-            use: async (c, next)=>{
+ */ export async function createCloudflareApp(rootModule) {
+    let initialized = false;
+    let refs;
+    const velaApp = await VelaFactory.create(rootModule, {
+        middleware: [
+            async (c, next)=>{
                 if (!initialized) {
                     initialized = true;
-                    const ctx = c;
-                    const env = ctx.env ?? {};
-                    for (const ref of bindingsRegistry){
+                    const env = c.env ?? {};
+                    for (const ref of refs){
                         ref._initialize(env[ref.bindingName]);
                     }
                 }
                 await next();
             }
-        });
-        // Rebuild so the init middleware is placed before route handlers
-        await velaApp.rebuild();
-        const cfApp = new CloudflareApplication(velaApp);
-        cfApp.scanInstances(velaApp.getInstances());
-        return cfApp;
-    }
-};
+        ]
+    });
+    refs = collectBindingRefs(velaApp.getContainer());
+    const cfApp = new CloudflareApplication(velaApp);
+    cfApp.scanInstances(velaApp.getInstances());
+    return cfApp;
+}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { CloudflareFactory } from './cloudflare-factory';
+export { createCloudflareApp } from './cloudflare-factory';
 export { CloudflareApplication } from './cloudflare-application';
 export { KVModule } from './modules/kv.module';
 export { D1Module } from './modules/d1.module';
@@ -19,9 +19,6 @@ export { HyperdriveService } from './services/hyperdrive.service';
 export { Env } from './decorators/env';
 export { Scheduled } from './decorators/scheduled';
 export { QueueConsumer } from './decorators/queue-consumer';
-export { BindingRef } from './binding-ref';
-export { bindingsRegistry, clearBindingsRegistry } from './tokens';
-export { KV_BINDING_REF, D1_BINDING_REF, R2_BINDING_REF, QUEUE_BINDING_REF, DO_BINDING_REF, AI_BINDING_REF, VECTORIZE_BINDING_REF, HYPERDRIVE_BINDING_REF, } from './tokens';
 export type { CloudflareEnv, ScheduledRegistration, QueueRegistration } from './types';
 export type { ScheduledMetadata } from './decorators/scheduled';
 export type { QueueConsumerMetadata } from './decorators/queue-consumer';

package/dist/index.js

@@ -1,5 +1,5 @@
 // Factory & Application
-export { CloudflareFactory } from "./cloudflare-factory.js";
+export { createCloudflareApp } from "./cloudflare-factory.js";
 export { CloudflareApplication } from "./cloudflare-application.js";
 // Modules
 export { KVModule } from "./modules/kv.module.js";
@@ -23,7 +23,3 @@ export { HyperdriveService } from "./services/hyperdrive.service.js";
 export { Env } from "./decorators/env.js";
 export { Scheduled } from "./decorators/scheduled.js";
 export { QueueConsumer } from "./decorators/queue-consumer.js";
-// Internals (for advanced usage / testing)
-export { BindingRef } from "./binding-ref.js";
-export { bindingsRegistry, clearBindingsRegistry } from "./tokens.js";
-export { KV_BINDING_REF, D1_BINDING_REF, R2_BINDING_REF, QUEUE_BINDING_REF, DO_BINDING_REF, AI_BINDING_REF, VECTORIZE_BINDING_REF, HYPERDRIVE_BINDING_REF } from "./tokens.js";

package/dist/modules/ai.module.d.ts

@@ -1,6 +1 @@
-import type { DynamicModule } from '@velajs/vela';
-export declare class AIModule {
-    static forRoot(options: {
-        binding: string;
-    }): DynamicModule;
-}
+export declare const AIModule: import("./create-binding-module").BindingModuleStatic;

package/dist/modules/ai.module.js

@@ -1,31 +1,8 @@
-import { MetadataRegistry } from "@velajs/vela";
-import { BindingRef } from "../binding-ref.js";
-import { AI_BINDING_REF, bindingsRegistry } from "../tokens.js";
 import { AIService } from "../services/ai.service.js";
-export class AIModule {
-    static forRoot(options) {
-        const ref = new BindingRef(options.binding);
-        bindingsRegistry.push(ref);
-        const moduleClass = class AIDynamicModule {
-        };
-        Object.defineProperty(moduleClass, 'name', {
-            value: `AIModule_${options.binding}`
-        });
-        MetadataRegistry.setModuleOptions(moduleClass, {
-            exports: [
-                AIService,
-                AI_BINDING_REF
-            ]
-        });
-        return {
-            module: moduleClass,
-            providers: [
-                {
-                    token: AI_BINDING_REF,
-                    useValue: ref
-                },
-                AIService
-            ]
-        };
-    }
-}
+import { AI_BINDING_REF } from "../tokens.js";
+import { createBindingModule } from "./create-binding-module.js";
+export const AIModule = createBindingModule({
+    name: 'AI',
+    serviceClass: AIService,
+    bindingRefToken: AI_BINDING_REF
+});

package/dist/modules/create-binding-module.d.ts

@@ -0,0 +1,14 @@
+import { type DynamicModule, type InjectionToken, type Type } from '@velajs/vela';
+import { BindingRef } from '../binding-ref';
+interface CreateBindingModuleOptions<TService> {
+    name: string;
+    serviceClass: Type<TService>;
+    bindingRefToken: InjectionToken<BindingRef>;
+}
+export interface BindingModuleStatic {
+    forRoot(options: {
+        binding: string;
+    }): DynamicModule;
+}
+export declare function createBindingModule<TService>(opts: CreateBindingModuleOptions<TService>): BindingModuleStatic;
+export {};