@velajs/cloudflare 0.1.0

package/dist/services/hyperdrive.service.js

@@ -0,0 +1,51 @@
+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 { HYPERDRIVE_BINDING_REF } from "../tokens.js";
+export class HyperdriveService {
+    ref;
+    constructor(ref){
+        this.ref = ref;
+    }
+    /** Access the raw Hyperdrive binding directly. */ get binding() {
+        return this.ref.value;
+    }
+    get connectionString() {
+        return this.binding.connectionString;
+    }
+    get host() {
+        return this.binding.host;
+    }
+    get port() {
+        return this.binding.port;
+    }
+    get user() {
+        return this.binding.user;
+    }
+    get password() {
+        return this.binding.password;
+    }
+    get database() {
+        return this.binding.database;
+    }
+}
+HyperdriveService = _ts_decorate([
+    Injectable(),
+    _ts_param(0, Inject(HYPERDRIVE_BINDING_REF)),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof BindingRef === "undefined" ? Object : BindingRef
+    ])
+], HyperdriveService);

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

@@ -0,0 +1,24 @@
+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' })`.
+ */
+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>;
+}
+export {};

package/dist/services/kv.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 { KV_BINDING_REF } from "../tokens.js";
+export class KVService {
+    ref;
+    constructor(ref){
+        this.ref = ref;
+    }
+    /** Access the raw KVNamespace binding directly. */ 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(),
+    _ts_param(0, Inject(KV_BINDING_REF)),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof BindingRef === "undefined" ? Object : BindingRef
+    ])
+], KVService);

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

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

package/dist/services/queue.service.js

@@ -0,0 +1,39 @@
+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 { QUEUE_BINDING_REF } from "../tokens.js";
+export class QueueService {
+    ref;
+    constructor(ref){
+        this.ref = ref;
+    }
+    /** Access the raw Queue binding directly. */ 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(),
+    _ts_param(0, Inject(QUEUE_BINDING_REF)),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof BindingRef === "undefined" ? Object : BindingRef
+    ])
+], QueueService);

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

@@ -0,0 +1,18 @@
+import type { BindingRef } from '../binding-ref';
+type R2Binding = Record<string, any>;
+/**
+ * Wrapper around Cloudflare R2 Bucket.
+ * Injected via `R2Module.forRoot({ binding: 'ASSETS' })`.
+ */
+export declare class R2Service {
+    private ref;
+    constructor(ref: BindingRef);
+    /** Access the raw R2Bucket binding directly. */
+    get bucket(): R2Binding;
+    get(key: string, options?: Record<string, unknown>): Promise<unknown>;
+    head(key: string): Promise<unknown>;
+    put(key: string, value: ReadableStream | ArrayBuffer | ArrayBufferView | string | null | Blob, options?: Record<string, unknown>): Promise<unknown>;
+    delete(keys: string | string[]): Promise<void>;
+    list(options?: Record<string, unknown>): Promise<unknown>;
+}
+export {};

package/dist/services/r2.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 { R2_BINDING_REF } from "../tokens.js";
+export class R2Service {
+    ref;
+    constructor(ref){
+        this.ref = ref;
+    }
+    /** Access the raw R2Bucket binding directly. */ get bucket() {
+        return this.ref.value;
+    }
+    get(key, options) {
+        return this.bucket.get(key, options);
+    }
+    head(key) {
+        return this.bucket.head(key);
+    }
+    put(key, value, options) {
+        return this.bucket.put(key, value, options);
+    }
+    delete(keys) {
+        return this.bucket.delete(keys);
+    }
+    list(options) {
+        return this.bucket.list(options);
+    }
+}
+R2Service = _ts_decorate([
+    Injectable(),
+    _ts_param(0, Inject(R2_BINDING_REF)),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof BindingRef === "undefined" ? Object : BindingRef
+    ])
+], R2Service);

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

@@ -0,0 +1,26 @@
+import type { BindingRef } from '../binding-ref';
+type VectorizeBinding = {
+    query: Function;
+    insert: Function;
+    upsert: Function;
+    getByIds: Function;
+    deleteByIds: Function;
+    describe: Function;
+} & Record<string, any>;
+/**
+ * Wrapper around Cloudflare Vectorize Index.
+ * Injected via `VectorizeModule.forRoot({ binding: 'EMBEDDINGS' })`.
+ */
+export declare class VectorizeService {
+    private ref;
+    constructor(ref: BindingRef);
+    /** Access the raw VectorizeIndex binding directly. */
+    get index(): VectorizeBinding;
+    query(vector: number[], options?: Record<string, unknown>): Promise<unknown>;
+    insert(vectors: unknown[]): Promise<unknown>;
+    upsert(vectors: unknown[]): Promise<unknown>;
+    getByIds(ids: string[]): Promise<unknown>;
+    deleteByIds(ids: string[]): Promise<unknown>;
+    describe(): Promise<unknown>;
+}
+export {};

package/dist/services/vectorize.service.js

@@ -0,0 +1,51 @@
+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 { VECTORIZE_BINDING_REF } from "../tokens.js";
+export class VectorizeService {
+    ref;
+    constructor(ref){
+        this.ref = ref;
+    }
+    /** Access the raw VectorizeIndex binding directly. */ get index() {
+        return this.ref.value;
+    }
+    query(vector, options) {
+        return this.index.query(vector, options);
+    }
+    insert(vectors) {
+        return this.index.insert(vectors);
+    }
+    upsert(vectors) {
+        return this.index.upsert(vectors);
+    }
+    getByIds(ids) {
+        return this.index.getByIds(ids);
+    }
+    deleteByIds(ids) {
+        return this.index.deleteByIds(ids);
+    }
+    describe() {
+        return this.index.describe();
+    }
+}
+VectorizeService = _ts_decorate([
+    Injectable(),
+    _ts_param(0, Inject(VECTORIZE_BINDING_REF)),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof BindingRef === "undefined" ? Object : BindingRef
+    ])
+], VectorizeService);

package/dist/tokens.d.ts

@@ -0,0 +1,17 @@
+import { InjectionToken } from '@velajs/vela';
+import type { BindingRef } from './binding-ref';
+export declare const KV_BINDING_REF: InjectionToken<BindingRef<unknown>>;
+export declare const D1_BINDING_REF: InjectionToken<BindingRef<unknown>>;
+export declare const R2_BINDING_REF: InjectionToken<BindingRef<unknown>>;
+export declare const QUEUE_BINDING_REF: InjectionToken<BindingRef<unknown>>;
+export declare const DO_BINDING_REF: InjectionToken<BindingRef<unknown>>;
+export declare const AI_BINDING_REF: InjectionToken<BindingRef<unknown>>;
+export declare const VECTORIZE_BINDING_REF: InjectionToken<BindingRef<unknown>>;
+export declare const HYPERDRIVE_BINDING_REF: InjectionToken<BindingRef<unknown>>;
+/**
+ * Global registry of binding refs to initialize on first request.
+ * Each module's `forRoot()` pushes its BindingRef here.
+ * CloudflareFactory reads from this to populate bindings.
+ */
+export declare const bindingsRegistry: BindingRef[];
+export declare function clearBindingsRegistry(): void;

package/dist/tokens.js

@@ -0,0 +1,18 @@
+import { InjectionToken } from "@velajs/vela";
+// Internal tokens for binding refs — used by services
+export const KV_BINDING_REF = new InjectionToken('CF_KV_BINDING_REF');
+export const D1_BINDING_REF = new InjectionToken('CF_D1_BINDING_REF');
+export const R2_BINDING_REF = new InjectionToken('CF_R2_BINDING_REF');
+export const QUEUE_BINDING_REF = new InjectionToken('CF_QUEUE_BINDING_REF');
+export const DO_BINDING_REF = new InjectionToken('CF_DO_BINDING_REF');
+export const AI_BINDING_REF = new InjectionToken('CF_AI_BINDING_REF');
+export const VECTORIZE_BINDING_REF = new InjectionToken('CF_VECTORIZE_BINDING_REF');
+export const HYPERDRIVE_BINDING_REF = new InjectionToken('CF_HYPERDRIVE_BINDING_REF');
+/**
+ * Global registry of binding refs to initialize on first request.
+ * Each module's `forRoot()` pushes its BindingRef here.
+ * CloudflareFactory reads from this to populate bindings.
+ */ export const bindingsRegistry = [];
+export function clearBindingsRegistry() {
+    bindingsRegistry.length = 0;
+}

package/dist/types.d.ts

@@ -0,0 +1,13 @@
+export interface CloudflareEnv {
+    [key: string]: unknown;
+}
+export interface ScheduledRegistration {
+    instance: unknown;
+    methodName: string;
+    cron: string;
+}
+export interface QueueRegistration {
+    instance: unknown;
+    methodName: string;
+    queueName: string;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export { };

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@velajs/cloudflare",
+  "version": "0.1.0",
+  "description": "Cloudflare Workers integration for Vela framework",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "vela",
+    "cloudflare",
+    "cloudflare-workers",
+    "kv",
+    "d1",
+    "r2",
+    "queues",
+    "edge",
+    "framework",
+    "decorators"
+  ],
+  "author": "ksh",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/velajs/cloudflare.git"
+  },
+  "homepage": "https://github.com/velajs/cloudflare#readme",
+  "bugs": {
+    "url": "https://github.com/velajs/cloudflare/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "@velajs/vela": ">=0.1.0",
+    "hono": ">=4"
+  },
+  "peerDependenciesMeta": {
+    "@velajs/vela": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@swc/cli": "^0.8.0",
+    "@swc/core": "^1.15.11",
+    "@velajs/vela": "^0.2.0",
+    "hono": "^4",
+    "typescript": "^5",
+    "unplugin-swc": "^1.5.9",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "rm -rf dist && swc src -d dist --strip-leading-paths && tsc --emitDeclarationOnly",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}