unconventional 1.13.2 → 1.14.1

package/dist/core/base.cache.d.ts

@@ -1,7 +1,10 @@
 /// <reference types="@cloudflare/workers-types" />
+import { CloudflareKVAPI } from "../utils/cloudflare.utils";
 import { BaseModel } from "./base.model";
 export declare class BaseCache {
     private static kvKeySizeLimit;
+    private static kvApi;
+    static setKVApi(config: CloudflareKVAPI): Promise<void>;
     static get<T>(cache: KVNamespace, key: string): Promise<T | null>;
     static set<T>(cache: KVNamespace, key: string, value: T, ttl?: number): Promise<void>;
     static delete(cache: KVNamespace, key: string): Promise<void>;

package/dist/core/base.cache.js

@@ -3,9 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseCache = void 0;
 const api_types_1 = require("../types/api.types");
 const array_utils_1 = require("../utils/array.utils");
+const cloudflare_utils_1 = require("../utils/cloudflare.utils");
 const crypto_utils_1 = require("../utils/crypto.utils");
 class BaseCache {
     static kvKeySizeLimit = 512;
+    static kvApi;
+    static async setKVApi(config) {
+        this.kvApi = new cloudflare_utils_1.CloudflareKV(config);
+    }
     static async get(cache, key) {
         if (key.length > this.kvKeySizeLimit)
             return null;
@@ -44,21 +49,22 @@ class BaseCache {
         const identifier = model?.$id();
         if (!identifier)
             return;
-        // Delete by ID
+        // Get keys by ID
         const idList = await cache.list({ prefix: `${api_types_1.CachePrefix.Record}${model.constructor.name}:${identifier.toString()}` });
-        const idPromises = idList.keys.map(async (key) => {
-            await this.delete(cache, key.name);
-        });
-        // Delete by Key
-        let keyPromises = [];
+        const keysToDelete = idList.keys.map(key => key.name);
+        // Get keys by Key
         if (model.$key()) {
             const keyList = await cache.list({ prefix: `${api_types_1.CachePrefix.Record}${model.constructor.name}:${model.$key()}` });
-            keyPromises = keyList.keys.map(async (key) => {
-                await this.delete(cache, key.name);
-            });
+            keysToDelete.push(...keyList.keys.map(key => key.name));
+        }
+        if (this.kvApi) {
+            // Use bulk delete if KV API is available
+            await this.kvApi.deleteKeys(keysToDelete);
+        }
+        else {
+            // Fallback to parallel individual deletes
+            await Promise.all(keysToDelete.map(key => this.delete(cache, key)));
         }
-        // Execute
-        await Promise.all([...idPromises, ...keyPromises]);
     }
     //#endregion
     //#region Page Methods
@@ -77,9 +83,15 @@ class BaseCache {
     /** Deletes a page from the cache. Deletes all modified versions too. */
     static async clearPage(cache, model) {
         const list = await cache.list({ prefix: `${api_types_1.CachePrefix.Page}${model.name}` });
-        Promise.all(list.keys.map(async (key) => {
-            await this.delete(cache, key.name);
-        }));
+        const keys = list.keys.map(key => key.name);
+        if (this.kvApi) {
+            // Use bulk delete if KV API is available
+            await this.kvApi.deleteKeys(keys);
+        }
+        else {
+            // Fallback to parallel individual deletes
+            await Promise.all(keys.map(key => this.delete(cache, key)));
+        }
     }
     //#endregion
     //#region Helpers

package/dist/types/server.types.d.ts

@@ -2,9 +2,20 @@ import { MiddlewareHandler } from "hono";
 import { DBFactory } from "./db.types";
 import { cors } from "hono/cors";
 export interface ServerConfig {
+    /** Name of the server. */
     name: string;
+    /** Base path for all routes. */
     basePath?: string;
+    /** Middleware to apply to all routes. */
     middleware?: MiddlewareHandler[];
+    /**
+     * Options for CORS middleware.
+     * If not provided, all origins and methods are permitted by default.
+     */
     cors?: Parameters<typeof cors>[0];
+    /**
+     * Factory producing a database driver.
+     * Required to communicate with a database via BaseModel's methods.
+     */
     getDB: DBFactory;
 }

package/dist/utils/cache.utils.js

@@ -14,7 +14,12 @@ async function getCachedOrFetch(cache, key, fetchFn, ttl = api_types_1.DefaultCa
     const response = await fetchFn();
     // Cache if successful
     if (response && cache) {
-        await cache.put(key, JSON.stringify(response), { expirationTtl: ttl });
+        try {
+            await cache.put(key, JSON.stringify(response), { expirationTtl: ttl });
+        }
+        catch (error) {
+            // Suppress cache errors (e.g. rate limiting) so response is still returned
+        }
     }
     return response;
 }

package/dist/utils/cloudflare.utils.d.ts

@@ -0,0 +1,32 @@
+interface CloudflareMessage {
+    code: number;
+    message: string;
+}
+interface CloudflareResponse {
+    success: boolean;
+    errors: CloudflareMessage[];
+    messages: CloudflareMessage[];
+}
+interface BulkDeleteResponse extends CloudflareResponse {
+    result: {
+        successful_key_count: number;
+        unsuccessful_keys: string[];
+    };
+}
+export interface CloudflareKVAPI {
+    accountId: string;
+    apiToken: string;
+    namespaceId: string;
+}
+export declare class CloudflareKV {
+    private api;
+    private url;
+    constructor(api: CloudflareKVAPI);
+    /**
+     * Deletes multiple keys from a KV namespace
+     * @param namespaceId The namespace to delete keys from
+     * @param keys Array of key names to delete (max 10,000)
+     */
+    deleteKeys(keys: string[]): Promise<BulkDeleteResponse>;
+}
+export {};

package/dist/utils/cloudflare.utils.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudflareKV = void 0;
+class CloudflareKV {
+    api;
+    url;
+    constructor(api) {
+        this.api = api;
+        this.url = `https://api.cloudflare.com/client/v4/accounts/${this.api.accountId}/storage/kv/namespaces/${this.api.namespaceId}`;
+    }
+    /**
+     * Deletes multiple keys from a KV namespace
+     * @param namespaceId The namespace to delete keys from
+     * @param keys Array of key names to delete (max 10,000)
+     */
+    async deleteKeys(keys) {
+        if (keys.length > 10000) {
+            throw new Error('Cannot delete more than 10,000 keys at once');
+        }
+        const response = await fetch(`${this.url}/bulk/delete`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.api.apiToken}`,
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(keys)
+        });
+        return response.json();
+    }
+}
+exports.CloudflareKV = CloudflareKV;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unconventional",
-  "version": "1.13.2",
+  "version": "1.14.1",
   "description": "A complete server built on Cloudflare Workers/Pages",
   "keywords": [
     "cloudflare",