@velajs/cloudflare 0.1.0

package/dist/decorators/scheduled.d.ts

@@ -0,0 +1,20 @@
+export interface ScheduledMetadata {
+    cron: string;
+    methodName: string;
+}
+/**
+ * Marks a method as a scheduled (cron) handler.
+ *
+ * @example
+ * ```ts
+ * @Injectable()
+ * class WorkerService {
+ *   @Scheduled('0 * * * *')
+ *   async hourlyCron() {
+ *     console.log('Running hourly');
+ *   }
+ * }
+ * ```
+ */
+export declare function Scheduled(cron: string): MethodDecorator;
+export declare function getScheduledMetadata(target: object): ScheduledMetadata[];

package/dist/decorators/scheduled.js

@@ -0,0 +1,29 @@
+import { defineMetadata, getMetadata } from "@velajs/vela";
+const SCHEDULED_METADATA_KEY = 'cloudflare:scheduled';
+/**
+ * Marks a method as a scheduled (cron) handler.
+ *
+ * @example
+ * ```ts
+ * @Injectable()
+ * class WorkerService {
+ *   @Scheduled('0 * * * *')
+ *   async hourlyCron() {
+ *     console.log('Running hourly');
+ *   }
+ * }
+ * ```
+ */ export function Scheduled(cron) {
+    return (target, propertyKey, _descriptor)=>{
+        const existing = getMetadata(SCHEDULED_METADATA_KEY, target.constructor) ?? [];
+        existing.push({
+            cron,
+            methodName: String(propertyKey)
+        });
+        defineMetadata(SCHEDULED_METADATA_KEY, existing, target.constructor);
+    };
+}
+export function getScheduledMetadata(target) {
+    const ctor = target.constructor ?? target;
+    return getMetadata(SCHEDULED_METADATA_KEY, ctor) ?? [];
+}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export { CloudflareFactory } from './cloudflare-factory';
+export { CloudflareApplication } from './cloudflare-application';
+export { KVModule } from './modules/kv.module';
+export { D1Module } from './modules/d1.module';
+export { R2Module } from './modules/r2.module';
+export { QueueModule } from './modules/queue.module';
+export { DurableObjectModule } from './modules/durable-object.module';
+export { AIModule } from './modules/ai.module';
+export { VectorizeModule } from './modules/vectorize.module';
+export { HyperdriveModule } from './modules/hyperdrive.module';
+export { KVService } from './services/kv.service';
+export { D1Service } from './services/d1.service';
+export { R2Service } from './services/r2.service';
+export { QueueService } from './services/queue.service';
+export { DurableObjectService } from './services/durable-object.service';
+export { AIService } from './services/ai.service';
+export { VectorizeService } from './services/vectorize.service';
+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

@@ -0,0 +1,29 @@
+// Factory & Application
+export { CloudflareFactory } from "./cloudflare-factory.js";
+export { CloudflareApplication } from "./cloudflare-application.js";
+// Modules
+export { KVModule } from "./modules/kv.module.js";
+export { D1Module } from "./modules/d1.module.js";
+export { R2Module } from "./modules/r2.module.js";
+export { QueueModule } from "./modules/queue.module.js";
+export { DurableObjectModule } from "./modules/durable-object.module.js";
+export { AIModule } from "./modules/ai.module.js";
+export { VectorizeModule } from "./modules/vectorize.module.js";
+export { HyperdriveModule } from "./modules/hyperdrive.module.js";
+// Services
+export { KVService } from "./services/kv.service.js";
+export { D1Service } from "./services/d1.service.js";
+export { R2Service } from "./services/r2.service.js";
+export { QueueService } from "./services/queue.service.js";
+export { DurableObjectService } from "./services/durable-object.service.js";
+export { AIService } from "./services/ai.service.js";
+export { VectorizeService } from "./services/vectorize.service.js";
+export { HyperdriveService } from "./services/hyperdrive.service.js";
+// Decorators
+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

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

package/dist/modules/ai.module.js

@@ -0,0 +1,31 @@
+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
+            ]
+        };
+    }
+}

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

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

package/dist/modules/d1.module.js

@@ -0,0 +1,31 @@
+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
+            ]
+        };
+    }
+}

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

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

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

@@ -0,0 +1,31 @@
+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
+            ]
+        };
+    }
+}

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

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

package/dist/modules/hyperdrive.module.js

@@ -0,0 +1,31 @@
+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
+            ]
+        };
+    }
+}

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

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

package/dist/modules/kv.module.js

@@ -0,0 +1,31 @@
+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
+            ]
+        };
+    }
+}

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

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

package/dist/modules/queue.module.js

@@ -0,0 +1,31 @@
+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
+            ]
+        };
+    }
+}

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

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

package/dist/modules/r2.module.js

@@ -0,0 +1,31 @@
+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
+            ]
+        };
+    }
+}

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

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

package/dist/modules/vectorize.module.js

@@ -0,0 +1,31 @@
+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
+            ]
+        };
+    }
+}

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

@@ -0,0 +1,16 @@
+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>;
+}
+export {};

package/dist/services/ai.service.js

@@ -0,0 +1,36 @@
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param(paramIndex, decorator) {
+    return function(target, key) {
+        decorator(target, key, paramIndex);
+    };
+}
+import { Injectable, Inject } from "@velajs/vela";
+import { AI_BINDING_REF } from "../tokens.js";
+export class AIService {
+    ref;
+    constructor(ref){
+        this.ref = ref;
+    }
+    /** Access the raw Ai binding directly. */ get binding() {
+        return this.ref.value;
+    }
+    run(model, inputs, options) {
+        return this.binding.run(model, inputs, options);
+    }
+}
+AIService = _ts_decorate([
+    Injectable(),
+    _ts_param(0, Inject(AI_BINDING_REF)),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof BindingRef === "undefined" ? Object : BindingRef
+    ])
+], AIService);

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

@@ -0,0 +1,22 @@
+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>;
+}
+export {};

package/dist/services/d1.service.js

@@ -0,0 +1,47 @@
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param(paramIndex, decorator) {
+    return function(target, key) {
+        decorator(target, key, paramIndex);
+    };
+}
+import { Injectable, Inject } from "@velajs/vela";
+import { D1_BINDING_REF } from "../tokens.js";
+export class D1Service {
+    ref;
+    constructor(ref){
+        this.ref = ref;
+    }
+    /** Access the raw D1Database binding directly. */ 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(),
+    _ts_param(0, Inject(D1_BINDING_REF)),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof BindingRef === "undefined" ? Object : BindingRef
+    ])
+], D1Service);

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

@@ -0,0 +1,24 @@
+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;
+}
+export {};

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

@@ -0,0 +1,48 @@
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param(paramIndex, decorator) {
+    return function(target, key) {
+        decorator(target, key, paramIndex);
+    };
+}
+import { Injectable, Inject } from "@velajs/vela";
+import { DO_BINDING_REF } from "../tokens.js";
+export class DurableObjectService {
+    ref;
+    constructor(ref){
+        this.ref = ref;
+    }
+    /** Access the raw DurableObjectNamespace binding directly. */ 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(),
+    _ts_param(0, Inject(DO_BINDING_REF)),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof BindingRef === "undefined" ? Object : BindingRef
+    ])
+], DurableObjectService);

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

@@ -0,0 +1,26 @@
+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;
+    get connectionString(): string;
+    get host(): string;
+    get port(): number;
+    get user(): string;
+    get password(): string;
+    get database(): string;
+}
+export {};