@velajs/cloudflare 1.9.0 → 1.10.1

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

@@ -1,17 +0,0 @@
-import type { DynamicModule } from '@velajs/vela';
-/**
- * Provides {@link EnvService} GLOBALLY so any module's provider factories can
- * `inject: [EnvService]`. Register once on the root module:
- *
- * ```ts
- * @Module({ imports: [EnvModule.forRoot(), AuthModule.forRootAsync({ ... })] })
- * class AppModule {}
- * ```
- *
- * The {@link EnvRef} it provides is collected and initialized by
- * createCloudflareApp's binding-init middleware on the first request (the
- * factory passes it the full `env`, not a single binding).
- */
-export declare class EnvModule {
-    static forRoot(): DynamicModule;
-}

package/dist/modules/env.module.js

@@ -1,35 +0,0 @@
-import { EnvRef } from "../env-ref.js";
-import { EnvService } from "../services/env.service.js";
-import { ENV_REF } from "../tokens.js";
-/**
- * Provides {@link EnvService} GLOBALLY so any module's provider factories can
- * `inject: [EnvService]`. Register once on the root module:
- *
- * ```ts
- * @Module({ imports: [EnvModule.forRoot(), AuthModule.forRootAsync({ ... })] })
- * class AppModule {}
- * ```
- *
- * The {@link EnvRef} it provides is collected and initialized by
- * createCloudflareApp's binding-init middleware on the first request (the
- * factory passes it the full `env`, not a single binding).
- */ export class EnvModule {
-    static forRoot() {
-        const ref = new EnvRef();
-        return {
-            module: EnvModule,
-            global: true,
-            providers: [
-                {
-                    provide: ENV_REF,
-                    useValue: ref
-                },
-                EnvService
-            ],
-            exports: [
-                EnvService,
-                ENV_REF
-            ]
-        };
-    }
-}

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

@@ -1 +0,0 @@
-export declare const HyperdriveModule: import("./create-binding-module").BindingModuleStatic;

package/dist/modules/hyperdrive.module.js

@@ -1,8 +0,0 @@
-import { HyperdriveService } from "../services/hyperdrive.service.js";
-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 +0,0 @@
-export declare const KVModule: import("./create-binding-module").BindingModuleStatic;

package/dist/modules/kv.module.js

@@ -1,8 +0,0 @@
-import { KVService } from "../services/kv.service.js";
-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 +0,0 @@
-export declare const QueueModule: import("./create-binding-module").BindingModuleStatic;

package/dist/modules/queue.module.js

@@ -1,8 +0,0 @@
-import { QueueService } from "../services/queue.service.js";
-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 +0,0 @@
-export declare const R2Module: import("./create-binding-module").BindingModuleStatic;

package/dist/modules/r2.module.js

@@ -1,8 +0,0 @@
-import { R2Service } from "../services/r2.service.js";
-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 +0,0 @@
-export declare const VectorizeModule: import("./create-binding-module").BindingModuleStatic;

package/dist/modules/vectorize.module.js

@@ -1,8 +0,0 @@
-import { VectorizeService } from "../services/vectorize.service.js";
-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,6 +0,0 @@
-import type { BindingRef } from '../binding-ref';
-export declare class AIService {
-    private ref;
-    constructor(ref: BindingRef<Ai>);
-    get binding(): Ai;
-}

package/dist/services/ai.service.js

@@ -1,33 +0,0 @@
-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;
-    }
-    get binding() {
-        return this.ref.value;
-    }
-}
-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

@@ -1,6 +0,0 @@
-import type { BindingRef } from '../binding-ref';
-export declare class D1Service {
-    private ref;
-    constructor(ref: BindingRef<D1Database>);
-    get database(): D1Database;
-}

package/dist/services/d1.service.js

@@ -1,33 +0,0 @@
-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;
-    }
-    get database() {
-        return this.ref.value;
-    }
-}
-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

@@ -1,6 +0,0 @@
-import type { BindingRef } from '../binding-ref';
-export declare class DurableObjectService {
-    private ref;
-    constructor(ref: BindingRef<DurableObjectNamespace>);
-    get namespace(): DurableObjectNamespace;
-}

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

@@ -1,33 +0,0 @@
-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;
-    }
-    get namespace() {
-        return this.ref.value;
-    }
-}
-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/env.service.d.ts

@@ -1,31 +0,0 @@
-import type { EnvRef } from '../env-ref';
-/**
- * Injectable access to the full Cloudflare Worker `env` (bindings + vars +
- * secrets).
- *
- * The per-binding services (`D1Service`, `KVService`, …) each expose a single
- * binding, and the `@Env()` param decorator only works inside a request-scoped
- * controller handler. `EnvService` fills the gap: it can be injected into
- * PROVIDER FACTORIES — e.g. `SomeModule.forRootAsync({ inject: [EnvService] })`
- * — so a factory can read secrets/origins without reaching for the request.
- *
- * Reads are lazy. `env` only exists per request, so a factory (which runs at
- * bootstrap) must capture the `EnvService` and read inside its callback:
- *
- * ```ts
- * AuthModule.forRootAsync({
- *   inject: [EnvService],
- *   useFactory: (env: EnvService) => buildAuth(() => env.get<string>('AUTH_SECRET')),
- * });
- * ```
- *
- * Reading eagerly at bootstrap (`env.get(...)` before any request) throws.
- */
-export declare class EnvService {
-    private ref;
-    constructor(ref: EnvRef);
-    /** The full env record. Throws if read before the first request. */
-    get env(): Record<string, unknown>;
-    /** Read a single env entry (binding, var, or secret) by name. */
-    get<T = unknown>(key: string): T | undefined;
-}

package/dist/services/env.service.js

@@ -1,36 +0,0 @@
-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 { Inject, Injectable } from "@velajs/vela";
-import { ENV_REF } from "../tokens.js";
-export class EnvService {
-    ref;
-    constructor(ref){
-        this.ref = ref;
-    }
-    /** The full env record. Throws if read before the first request. */ get env() {
-        return this.ref.value;
-    }
-    /** Read a single env entry (binding, var, or secret) by name. */ get(key) {
-        return this.ref.value[key];
-    }
-}
-EnvService = _ts_decorate([
-    Injectable(),
-    _ts_param(0, Inject(ENV_REF)),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof EnvRef === "undefined" ? Object : EnvRef
-    ])
-], EnvService);

package/dist/services/flagship-flag.driver.d.ts

@@ -1,57 +0,0 @@
-import type { FeatureFlagDriver, FlagContext } from '@velajs/feature-flags';
-/**
- * The subset of a Cloudflare **Flagship** binding this driver evaluates against
- * — the four typed value methods. The binding itself returns the supplied
- * `defaultValue` on evaluation errors; transport-level failures reject and are
- * left to propagate (never-throw is the service layer's job, not the driver's).
- *
- * @see https://developers.cloudflare.com/flagship/binding/
- */
-export interface FlagshipBinding {
-    getBooleanValue(key: string, defaultValue: boolean, context?: FlagContext): Promise<boolean>;
-    getStringValue(key: string, defaultValue: string, context?: FlagContext): Promise<string>;
-    getNumberValue(key: string, defaultValue: number, context?: FlagContext): Promise<number>;
-    getObjectValue<T extends object>(key: string, defaultValue: T, context?: FlagContext): Promise<T>;
-}
-export interface FlagshipFlagDriverOptions {
-    /** Driver name used for `use(name)` / default-driver selection. Default `"flagship"`. */
-    name?: string;
-}
-/**
- * {@link FeatureFlagDriver} backed by a Cloudflare Flagship binding.
- *
- * A thin, honest wrapper: each contract method maps 1:1 onto the binding's
- * corresponding value method, forwarding the caller's `fallback` (the binding's
- * `defaultValue`) and evaluation context. The binding resolves the fallback on
- * evaluation errors; anything the binding *rejects* with (e.g. a `remote: true`
- * dev-proxy tunnel dropping) propagates — `@velajs/feature-flags`'s service owns
- * the never-throw guarantee.
- *
- * The binding only exists per request in a Worker, so pass a lazy accessor when
- * wiring from a bootstrap factory (mirroring how {@link EnvService} reads are
- * deferred); a resolved binding may be passed directly in tests.
- *
- * ```ts
- * FeatureFlagsModule.forRootAsync({
- *   inject: [EnvService],
- *   useFactory: (env: EnvService) => ({
- *     drivers: [flagshipFlagDriver(() => env.get<FlagshipBinding>('FLAGS')!)],
- *   }),
- * });
- * ```
- *
- * Evaluation ergonomics (the 1:1 binding-method mapping) are ported from the
- * Stratal feature-flags service (MIT, © Temitayo Fadojutimi), reshaped as a
- * bare driver.
- */
-export declare class FlagshipFlagDriver implements FeatureFlagDriver {
-    readonly name: string;
-    private readonly resolve;
-    constructor(binding: FlagshipBinding | (() => FlagshipBinding), options?: FlagshipFlagDriverOptions);
-    getBoolean(key: string, fallback: boolean, ctx?: FlagContext): Promise<boolean>;
-    getString(key: string, fallback: string, ctx?: FlagContext): Promise<string>;
-    getNumber(key: string, fallback: number, ctx?: FlagContext): Promise<number>;
-    getObject<T extends object>(key: string, fallback: T, ctx?: FlagContext): Promise<T>;
-}
-/** Convenience factory for {@link FlagshipFlagDriver}. */
-export declare function flagshipFlagDriver(binding: FlagshipBinding | (() => FlagshipBinding), options?: FlagshipFlagDriverOptions): FlagshipFlagDriver;

package/dist/services/flagship-flag.driver.js

@@ -1,49 +0,0 @@
-/**
- * {@link FeatureFlagDriver} backed by a Cloudflare Flagship binding.
- *
- * A thin, honest wrapper: each contract method maps 1:1 onto the binding's
- * corresponding value method, forwarding the caller's `fallback` (the binding's
- * `defaultValue`) and evaluation context. The binding resolves the fallback on
- * evaluation errors; anything the binding *rejects* with (e.g. a `remote: true`
- * dev-proxy tunnel dropping) propagates — `@velajs/feature-flags`'s service owns
- * the never-throw guarantee.
- *
- * The binding only exists per request in a Worker, so pass a lazy accessor when
- * wiring from a bootstrap factory (mirroring how {@link EnvService} reads are
- * deferred); a resolved binding may be passed directly in tests.
- *
- * ```ts
- * FeatureFlagsModule.forRootAsync({
- *   inject: [EnvService],
- *   useFactory: (env: EnvService) => ({
- *     drivers: [flagshipFlagDriver(() => env.get<FlagshipBinding>('FLAGS')!)],
- *   }),
- * });
- * ```
- *
- * Evaluation ergonomics (the 1:1 binding-method mapping) are ported from the
- * Stratal feature-flags service (MIT, © Temitayo Fadojutimi), reshaped as a
- * bare driver.
- */ export class FlagshipFlagDriver {
-    name;
-    resolve;
-    constructor(binding, options = {}){
-        this.resolve = typeof binding === 'function' ? binding : ()=>binding;
-        this.name = options.name ?? 'flagship';
-    }
-    getBoolean(key, fallback, ctx) {
-        return this.resolve().getBooleanValue(key, fallback, ctx);
-    }
-    getString(key, fallback, ctx) {
-        return this.resolve().getStringValue(key, fallback, ctx);
-    }
-    getNumber(key, fallback, ctx) {
-        return this.resolve().getNumberValue(key, fallback, ctx);
-    }
-    getObject(key, fallback, ctx) {
-        return this.resolve().getObjectValue(key, fallback, ctx);
-    }
-}
-/** Convenience factory for {@link FlagshipFlagDriver}. */ export function flagshipFlagDriver(binding, options) {
-    return new FlagshipFlagDriver(binding, options);
-}

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

@@ -1,12 +0,0 @@
-import type { BindingRef } from '../binding-ref';
-export declare class HyperdriveService {
-    private ref;
-    constructor(ref: BindingRef<Hyperdrive>);
-    get binding(): Hyperdrive;
-    get connectionString(): string;
-    get host(): string;
-    get port(): number;
-    get user(): string;
-    get password(): string;
-    get database(): string;
-}

package/dist/services/hyperdrive.service.js

@@ -1,51 +0,0 @@
-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;
-    }
-    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-cache.store.d.ts

@@ -1,19 +0,0 @@
-import { type AsyncCacheStore } from '@velajs/vela';
-import { KVService } from './kv.service';
-/**
- * Cloudflare KV-backed {@link CacheStore}. Values are JSON-encoded. Intended as
- * the slow tier under a `TieredCacheStore` (memory L1 → KV L2), but usable
- * standalone as `CacheModule.forRootAsync({ inject: [KVService], useFactory: (kv) => ({ store: new KVCacheStore(kv) }) })`.
- *
- * Note: Cloudflare KV requires `expirationTtl >= 60s`, so sub-minute TTLs are
- * clamped up. Keep short TTLs on the memory tier; use KV for longer-lived entries.
- */
-export declare class KVCacheStore implements AsyncCacheStore {
-    private readonly kv;
-    constructor(kv: KVService);
-    private get ns();
-    get<T = unknown>(key: string): Promise<T | undefined>;
-    set<T = unknown>(key: string, value: T, ttl?: number): Promise<void>;
-    del(key: string): Promise<void>;
-    clear(): Promise<void>;
-}

package/dist/services/kv-cache.store.js

@@ -1,58 +0,0 @@
-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 { Inject, Injectable } from "@velajs/vela";
-import { KVService } from "./kv.service.js";
-export class KVCacheStore {
-    kv;
-    constructor(kv){
-        this.kv = kv;
-    }
-    get ns() {
-        return this.kv.namespace;
-    }
-    async get(key) {
-        const value = await this.ns.get(key, 'json');
-        return value === null ? undefined : value;
-    }
-    async set(key, value, ttl) {
-        // KV enforces a 60s minimum expirationTtl; clamp up. Omit for no-TTL.
-        const options = ttl !== undefined ? {
-            expirationTtl: Math.max(60, Math.floor(ttl))
-        } : undefined;
-        await this.ns.put(key, JSON.stringify(value), options);
-    }
-    async del(key) {
-        await this.ns.delete(key);
-    }
-    async clear() {
-        // KV has no native clear — page through and delete. Best-effort.
-        let cursor;
-        do {
-            const list = await this.ns.list(cursor ? {
-                cursor
-            } : undefined);
-            await Promise.all(list.keys.map((entry)=>this.ns.delete(entry.name)));
-            cursor = list.list_complete ? undefined : list.cursor;
-        }while (cursor)
-    }
-}
-KVCacheStore = _ts_decorate([
-    Injectable(),
-    _ts_param(0, Inject(KVService)),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof KVService === "undefined" ? Object : KVService
-    ])
-], KVCacheStore);

package/dist/services/kv-flag.driver.d.ts

@@ -1,48 +0,0 @@
-import type { FeatureFlagDriver, FlagContext } from '@velajs/feature-flags';
-import { KVService } from './kv.service';
-export interface KvFlagDriverOptions {
-    /** Driver name used for `use(name)` / default-driver selection. Default `"kv"`. */
-    name?: string;
-    /** Prefix prepended to every flag key before the KV read. Default `""` (none). */
-    prefix?: string;
-}
-/**
- * Cloudflare KV-backed {@link FeatureFlagDriver}. Flags are stored as JSON
- * values under an optional key prefix and read with `get(key, 'json')`. Reads
- * are type-checked against the requested type: a missing key or a value of the
- * wrong JSON type returns the caller's `fallback`. KV has no targeting, so the
- * evaluation context is ignored.
- *
- * The driver stays honest — it does **not** swallow errors. A KV failure (or a
- * `SyntaxError` from a malformed stored value) propagates; the never-throw
- * guarantee lives in `@velajs/feature-flags`'s service layer.
- *
- * Placed like {@link KVCacheStore}: construct it in a wiring factory over a
- * resolved {@link KVService}.
- *
- * ```ts
- * FeatureFlagsModule.forRootAsync({
- *   inject: [KVService],
- *   useFactory: (kv: KVService) => ({ drivers: [new KvFlagDriver(kv, { prefix: 'flag:' })] }),
- * });
- * ```
- */
-export declare class KvFlagDriver implements FeatureFlagDriver {
-    private readonly kv;
-    readonly name: string;
-    private readonly prefix;
-    constructor(kv: KVService, options?: KvFlagDriverOptions);
-    private get ns();
-    getBoolean(key: string, fallback: boolean, _ctx?: FlagContext): Promise<boolean>;
-    getString(key: string, fallback: string, _ctx?: FlagContext): Promise<string>;
-    getNumber(key: string, fallback: number, _ctx?: FlagContext): Promise<number>;
-    getObject<T extends object>(key: string, fallback: T, _ctx?: FlagContext): Promise<T>;
-    /**
-     * Reads and JSON-parses the (prefixed) key, returning the parsed value only
-     * when `matches` accepts its type; otherwise the caller's fallback. A missing
-     * key reads as `null` → fallback. Read/parse errors are left to propagate.
-     */
-    private read;
-}
-/** Convenience factory for {@link KvFlagDriver}. */
-export declare function kvFlagDriver(kv: KVService, options?: KvFlagDriverOptions): KvFlagDriver;