@velajs/cloudflare 0.1.1 → 1.1.0

package/dist/modules/create-binding-module.js

@@ -0,0 +1,26 @@
+import { createModuleRef } from "@velajs/vela";
+import { BindingRef } from "../binding-ref.js";
+// Single factory for every Cloudflare binding module (KV, D1, R2, ...).
+// Each binding module is just a bag of (token, service); this generates
+// the canonical forRoot() shape for them.
+export function createBindingModule(opts) {
+    return {
+        forRoot ({ binding }) {
+            const ref = new BindingRef(binding);
+            return {
+                module: createModuleRef(`${opts.name}Module_${binding}`),
+                providers: [
+                    {
+                        provide: opts.bindingRefToken,
+                        useValue: ref
+                    },
+                    opts.serviceClass
+                ],
+                exports: [
+                    opts.serviceClass,
+                    opts.bindingRefToken
+                ]
+            };
+        }
+    };
+}

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

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

package/dist/modules/d1.module.js

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

package/dist/modules/durable-object.module.d.ts

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

package/dist/modules/durable-object.module.js

@@ -1,31 +1,8 @@
-import { MetadataRegistry } from "@velajs/vela";
-import { BindingRef } from "../binding-ref.js";
-import { DO_BINDING_REF, bindingsRegistry } from "../tokens.js";
 import { DurableObjectService } from "../services/durable-object.service.js";
-export class DurableObjectModule {
-    static forRoot(options) {
-        const ref = new BindingRef(options.binding);
-        bindingsRegistry.push(ref);
-        const moduleClass = class DurableObjectDynamicModule {
-        };
-        Object.defineProperty(moduleClass, 'name', {
-            value: `DurableObjectModule_${options.binding}`
-        });
-        MetadataRegistry.setModuleOptions(moduleClass, {
-            exports: [
-                DurableObjectService,
-                DO_BINDING_REF
-            ]
-        });
-        return {
-            module: moduleClass,
-            providers: [
-                {
-                    token: DO_BINDING_REF,
-                    useValue: ref
-                },
-                DurableObjectService
-            ]
-        };
-    }
-}
+import { DO_BINDING_REF } from "../tokens.js";
+import { createBindingModule } from "./create-binding-module.js";
+export const DurableObjectModule = createBindingModule({
+    name: 'DurableObject',
+    serviceClass: DurableObjectService,
+    bindingRefToken: DO_BINDING_REF
+});

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

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

package/dist/modules/hyperdrive.module.js

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

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

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

package/dist/modules/kv.module.js

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

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

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

package/dist/modules/queue.module.js

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

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

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

package/dist/modules/r2.module.js

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

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

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

package/dist/modules/vectorize.module.js

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

package/dist/services/ai.service.d.ts

@@ -1,16 +1,6 @@
 import type { BindingRef } from '../binding-ref';
-type AIBinding = {
-    run: Function;
-} & Record<string, any>;
-/**
- * Wrapper around Cloudflare Workers AI binding.
- * Injected via `AIModule.forRoot({ binding: 'AI' })`.
- */
 export declare class AIService {
     private ref;
-    constructor(ref: BindingRef);
-    /** Access the raw Ai binding directly. */
-    get binding(): AIBinding;
-    run(model: string, inputs: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
+    constructor(ref: BindingRef<Ai>);
+    get binding(): Ai;
 }
-export {};

package/dist/services/ai.service.js

@@ -19,12 +19,9 @@ export class AIService {
     constructor(ref){
         this.ref = ref;
     }
-    /** Access the raw Ai binding directly. */ get binding() {
+    get binding() {
         return this.ref.value;
     }
-    run(model, inputs, options) {
-        return this.binding.run(model, inputs, options);
-    }
 }
 AIService = _ts_decorate([
     Injectable(),

package/dist/services/d1.service.d.ts

@@ -1,22 +1,6 @@
 import type { BindingRef } from '../binding-ref';
-type D1Binding = {
-    prepare: Function;
-    batch: Function;
-    exec: Function;
-    dump: Function;
-} & Record<string, any>;
-/**
- * Wrapper around Cloudflare D1 Database.
- * Injected via `D1Module.forRoot({ binding: 'DB' })`.
- */
 export declare class D1Service {
     private ref;
-    constructor(ref: BindingRef);
-    /** Access the raw D1Database binding directly. */
-    get database(): D1Binding;
-    prepare(query: string): any;
-    batch(statements: unknown[]): Promise<any[]>;
-    exec(query: string): Promise<unknown>;
-    dump(): Promise<ArrayBuffer>;
+    constructor(ref: BindingRef<D1Database>);
+    get database(): D1Database;
 }
-export {};

package/dist/services/d1.service.js

@@ -19,23 +19,9 @@ export class D1Service {
     constructor(ref){
         this.ref = ref;
     }
-    /** Access the raw D1Database binding directly. */ get database() {
+    get database() {
         return this.ref.value;
     }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    prepare(query) {
-        return this.database.prepare(query);
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    batch(statements) {
-        return this.database.batch(statements);
-    }
-    exec(query) {
-        return this.database.exec(query);
-    }
-    dump() {
-        return this.database.dump();
-    }
 }
 D1Service = _ts_decorate([
     Injectable(),

package/dist/services/durable-object.service.d.ts

@@ -1,24 +1,6 @@
 import type { BindingRef } from '../binding-ref';
-type DOBinding = {
-    newUniqueId: Function;
-    idFromName: Function;
-    idFromString: Function;
-    get: Function;
-    jurisdiction: Function;
-} & Record<string, any>;
-/**
- * Wrapper around Cloudflare DurableObjectNamespace.
- * Injected via `DurableObjectModule.forRoot({ binding: 'COUNTER' })`.
- */
 export declare class DurableObjectService {
     private ref;
-    constructor(ref: BindingRef);
-    /** Access the raw DurableObjectNamespace binding directly. */
-    get namespace(): DOBinding;
-    newUniqueId(options?: Record<string, unknown>): unknown;
-    idFromName(name: string): unknown;
-    idFromString(hexStr: string): unknown;
-    get(id: unknown): unknown;
-    jurisdiction(name: string): unknown;
+    constructor(ref: BindingRef<DurableObjectNamespace>);
+    get namespace(): DurableObjectNamespace;
 }
-export {};

package/dist/services/durable-object.service.js

@@ -19,24 +19,9 @@ export class DurableObjectService {
     constructor(ref){
         this.ref = ref;
     }
-    /** Access the raw DurableObjectNamespace binding directly. */ get namespace() {
+    get namespace() {
         return this.ref.value;
     }
-    newUniqueId(options) {
-        return this.namespace.newUniqueId(options);
-    }
-    idFromName(name) {
-        return this.namespace.idFromName(name);
-    }
-    idFromString(hexStr) {
-        return this.namespace.idFromString(hexStr);
-    }
-    get(id) {
-        return this.namespace.get(id);
-    }
-    jurisdiction(name) {
-        return this.namespace.jurisdiction(name);
-    }
 }
 DurableObjectService = _ts_decorate([
     Injectable(),

package/dist/services/hyperdrive.service.d.ts

@@ -1,21 +1,8 @@
 import type { BindingRef } from '../binding-ref';
-type HyperdriveBinding = {
-    connectionString: string;
-    host: string;
-    port: number;
-    user: string;
-    password: string;
-    database: string;
-} & Record<string, any>;
-/**
- * Wrapper around Cloudflare Hyperdrive binding.
- * Injected via `HyperdriveModule.forRoot({ binding: 'POSTGRES' })`.
- */
 export declare class HyperdriveService {
     private ref;
-    constructor(ref: BindingRef);
-    /** Access the raw Hyperdrive binding directly. */
-    get binding(): HyperdriveBinding;
+    constructor(ref: BindingRef<Hyperdrive>);
+    get binding(): Hyperdrive;
     get connectionString(): string;
     get host(): string;
     get port(): number;
@@ -23,4 +10,3 @@ export declare class HyperdriveService {
     get password(): string;
     get database(): string;
 }
-export {};

package/dist/services/hyperdrive.service.js

@@ -19,7 +19,7 @@ export class HyperdriveService {
     constructor(ref){
         this.ref = ref;
     }
-    /** Access the raw Hyperdrive binding directly. */ get binding() {
+    get binding() {
         return this.ref.value;
     }
     get connectionString() {

package/dist/services/kv.service.d.ts

@@ -1,24 +1,11 @@
 import type { BindingRef } from '../binding-ref';
-type KVBinding = {
-    get: Function;
-    getWithMetadata: Function;
-    put: Function;
-    delete: Function;
-    list: Function;
-} & Record<string, any>;
 /**
- * Wrapper around Cloudflare KV Namespace.
- * Injected via `KVModule.forRoot({ binding: 'MY_KV' })`.
+ * Wrapper around a Cloudflare KV namespace binding.
+ * Use `kv.namespace.get(...)`, `kv.namespace.put(...)`, etc. — the namespace
+ * is the standard @cloudflare/workers-types `KVNamespace`.
  */
 export declare class KVService {
     private ref;
-    constructor(ref: BindingRef);
-    /** Access the raw KVNamespace binding directly. */
-    get namespace(): KVBinding;
-    get(key: string, typeOrOptions?: string | Record<string, unknown>): Promise<unknown>;
-    getWithMetadata(key: string, typeOrOptions?: string | Record<string, unknown>): Promise<unknown>;
-    put(key: string, value: string | ArrayBuffer | ReadableStream, options?: Record<string, unknown>): Promise<void>;
-    delete(key: string): Promise<void>;
-    list(options?: Record<string, unknown>): Promise<unknown>;
+    constructor(ref: BindingRef<KVNamespace>);
+    get namespace(): KVNamespace;
 }
-export {};

package/dist/services/kv.service.js

@@ -19,24 +19,9 @@ export class KVService {
     constructor(ref){
         this.ref = ref;
     }
-    /** Access the raw KVNamespace binding directly. */ get namespace() {
+    get namespace() {
         return this.ref.value;
     }
-    get(key, typeOrOptions) {
-        return this.namespace.get(key, typeOrOptions);
-    }
-    getWithMetadata(key, typeOrOptions) {
-        return this.namespace.getWithMetadata(key, typeOrOptions);
-    }
-    put(key, value, options) {
-        return this.namespace.put(key, value, options);
-    }
-    delete(key) {
-        return this.namespace.delete(key);
-    }
-    list(options) {
-        return this.namespace.list(options);
-    }
 }
 KVService = _ts_decorate([
     Injectable(),

package/dist/services/queue.service.d.ts

@@ -1,20 +1,6 @@
 import type { BindingRef } from '../binding-ref';
-type QueueBinding = Record<string, any>;
-/**
- * Wrapper around Cloudflare Queue (producer side).
- * Injected via `QueueModule.forRoot({ binding: 'MY_QUEUE' })`.
- *
- * For consuming messages, use the `@QueueConsumer()` decorator.
- */
-export declare class QueueService {
+export declare class QueueService<Body = unknown> {
     private ref;
-    constructor(ref: BindingRef);
-    /** Access the raw Queue binding directly. */
-    get queue(): QueueBinding;
-    send(message: unknown, options?: Record<string, unknown>): Promise<void>;
-    sendBatch(messages: Iterable<{
-        body: unknown;
-        [key: string]: unknown;
-    }>, options?: Record<string, unknown>): Promise<void>;
+    constructor(ref: BindingRef<Queue<Body>>);
+    get queue(): Queue<Body>;
 }
-export {};

package/dist/services/queue.service.js

@@ -19,15 +19,9 @@ export class QueueService {
     constructor(ref){
         this.ref = ref;
     }
-    /** Access the raw Queue binding directly. */ get queue() {
+    get queue() {
         return this.ref.value;
     }
-    send(message, options) {
-        return this.queue.send(message, options);
-    }
-    sendBatch(messages, options) {
-        return this.queue.sendBatch(messages, options);
-    }
 }
 QueueService = _ts_decorate([
     Injectable(),