koishi-plugin-media-luna 0.0.1

package/lib/plugins/billing/middleware.js

@@ -0,0 +1,233 @@
+// 计费中间件
+import { billingCardFields } from './config';
+// Store keys for passing data between prepare and finalize phases
+const STORE_KEY = 'billing:charged';
+const STORE_AMOUNT_KEY = 'billing:amount';
+const STORE_USER_KEY = 'billing:userId';
+const STORE_CURRENCY_KEY = 'billing:currencyValue';
+/** 获取用户 ID（通过 Koishi binding 表查询） */
+async function resolveUserId(ctx, mctx) {
+    // 优先使用 mctx.uid（来自生成请求）
+    if (mctx.uid) {
+        return mctx.uid;
+    }
+    // 否则从 session 解析
+    if (!mctx.session)
+        return null;
+    try {
+        const bindings = await ctx.database.get('binding', {
+            platform: mctx.session.platform,
+            pid: mctx.session.userId
+        });
+        return bindings[0]?.aid ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 获取有效配置值（渠道覆盖 > 全局配置）
+ */
+function getEffectiveValue(config, mctx, key) {
+    // 先检查渠道覆盖配置
+    const override = mctx.channel?.pluginOverrides?.billing?.[key];
+    if (override !== undefined && override !== null && override !== '') {
+        return override;
+    }
+    // 回退到全局配置
+    return config?.[key];
+}
+/** 构建查询条件 */
+function buildQueryCondition(config, userId, currencyValue) {
+    const condition = {
+        [config.userIdField]: userId
+    };
+    if (config.currencyField) {
+        condition[config.currencyField] = currencyValue;
+    }
+    return condition;
+}
+/** 查询用户余额 */
+async function getBalance(ctx, config, userId, currencyValue) {
+    try {
+        const condition = buildQueryCondition(config, userId, currencyValue);
+        const rows = await ctx.database.get(config.tableName, condition);
+        if (rows.length === 0)
+            return 0;
+        return Number(rows[0][config.balanceField]) || 0;
+    }
+    catch (e) {
+        const errMsg = e instanceof Error ? e.message : String(e);
+        if (errMsg.includes('cannot resolve table')) {
+            throw new Error(`表 "${config.tableName}" 未被声明。请确保已安装并启用声明该表的插件（如 koishi-plugin-monetary）`);
+        }
+        throw new Error(`查询余额失败: ${errMsg}`);
+    }
+}
+/** 更新用户余额 */
+async function updateBalance(ctx, config, userId, delta, currencyValue) {
+    try {
+        const condition = buildQueryCondition(config, userId, currencyValue);
+        const balanceField = config.balanceField;
+        await ctx.database.set(config.tableName, condition, (row) => ({
+            [balanceField]: { $add: [row[balanceField], delta] }
+        }));
+    }
+    catch (e) {
+        throw new Error(`更新余额失败: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}
+/**
+ * 创建预扣费中间件
+ * 在 lifecycle-prepare 阶段检查余额并扣费
+ */
+export function createBillingPrepareMiddleware() {
+    return {
+        name: 'billing-prepare',
+        displayName: '预扣费',
+        description: '在生成前检查余额并扣费',
+        category: 'billing',
+        phase: 'lifecycle-prepare',
+        configGroup: 'billing',
+        cardFields: billingCardFields,
+        async execute(mctx, next) {
+            const config = await mctx.getMiddlewareConfig('billing');
+            // 获取有效的费用（渠道覆盖 > 全局配置）
+            const cost = getEffectiveValue(config, mctx, 'cost') ?? 0;
+            // cost = 0 表示免费渠道，跳过计费检查
+            if (cost <= 0) {
+                mctx.setMiddlewareLog('billing-prepare', { skipped: true, reason: 'free channel', cost });
+                return next();
+            }
+            // 以下为严格模式：cost > 0 时必须满足所有条件才能继续
+            // 检查数据库配置是否完整
+            if (!config?.tableName || !config?.userIdField || !config?.balanceField) {
+                const missing = [];
+                if (!config?.tableName)
+                    missing.push('tableName');
+                if (!config?.userIdField)
+                    missing.push('userIdField');
+                if (!config?.balanceField)
+                    missing.push('balanceField');
+                mctx.setMiddlewareLog('billing-prepare', {
+                    error: true,
+                    reason: 'database config missing',
+                    missing
+                });
+                throw new Error(`计费配置不完整，缺少: ${missing.join(', ')}`);
+            }
+            // 解析用户 ID
+            const userId = await resolveUserId(mctx.ctx, mctx);
+            if (!userId) {
+                mctx.setMiddlewareLog('billing-prepare', { error: true, reason: 'no user id' });
+                throw new Error('无法识别用户身份，请先绑定账号');
+            }
+            // 获取有效的货币类型（渠道覆盖 > 全局配置）
+            const currencyValue = getEffectiveValue(config, mctx, 'currencyValue') ?? 'default';
+            const currencyLabel = config.currencyLabel || '积分';
+            try {
+                // 查询余额
+                const balance = await getBalance(mctx.ctx, config, userId, currencyValue);
+                // 检查余额是否充足
+                if (balance < cost) {
+                    mctx.setMiddlewareLog('billing-prepare', {
+                        error: true,
+                        reason: 'insufficient balance',
+                        balance,
+                        required: cost,
+                        currency: currencyValue
+                    });
+                    throw new Error(`余额不足：需要 ${cost} ${currencyLabel}，当前余额 ${balance} ${currencyLabel}`);
+                }
+                // 扣费
+                await updateBalance(mctx.ctx, config, userId, -cost, currencyValue);
+                // 记录扣费信息到 store，供 finalize 阶段使用
+                mctx.store.set(STORE_KEY, true);
+                mctx.store.set(STORE_AMOUNT_KEY, cost);
+                mctx.store.set(STORE_USER_KEY, userId);
+                mctx.store.set(STORE_CURRENCY_KEY, currencyValue);
+                mctx.setMiddlewareLog('billing-prepare', {
+                    charged: cost,
+                    userId,
+                    currency: currencyValue,
+                    balanceBefore: balance,
+                    balanceAfter: balance - cost
+                });
+                return next();
+            }
+            catch (error) {
+                mctx.setMiddlewareLog('billing-prepare', {
+                    error: true,
+                    message: error instanceof Error ? error.message : 'Unknown error'
+                });
+                throw error;
+            }
+        }
+    };
+}
+/**
+ * 创建计费结算中间件
+ * 在 lifecycle-finalize 阶段处理失败退款
+ */
+export function createBillingFinalizeMiddleware() {
+    return {
+        name: 'billing-finalize',
+        displayName: '计费结算',
+        description: '生成失败时自动退款',
+        category: 'billing',
+        phase: 'lifecycle-finalize',
+        configGroup: 'billing',
+        async execute(mctx, next) {
+            const config = await mctx.getMiddlewareConfig('billing');
+            // 检查是否已扣费
+            const wasCharged = mctx.store.get(STORE_KEY);
+            if (!wasCharged) {
+                return next();
+            }
+            const chargedAmount = mctx.store.get(STORE_AMOUNT_KEY);
+            const storedUserId = mctx.store.get(STORE_USER_KEY);
+            const currencyValue = mctx.store.get(STORE_CURRENCY_KEY);
+            // 判断生成是否成功
+            const isSuccess = mctx.output && mctx.output.length > 0;
+            if (isSuccess) {
+                // 生成成功，确认扣费
+                mctx.setMiddlewareLog('billing-finalize', {
+                    confirmed: chargedAmount,
+                    userId: storedUserId,
+                    currency: currencyValue
+                });
+            }
+            else if (config?.refundOnFail !== false) {
+                // 生成失败且启用了失败退款，执行退款
+                try {
+                    await updateBalance(mctx.ctx, config, storedUserId, chargedAmount, currencyValue);
+                    mctx.setMiddlewareLog('billing-finalize', {
+                        refunded: chargedAmount,
+                        reason: 'generation failed',
+                        userId: storedUserId,
+                        currency: currencyValue
+                    });
+                }
+                catch (error) {
+                    mctx.setMiddlewareLog('billing-finalize', {
+                        refundFailed: true,
+                        amount: chargedAmount,
+                        error: error instanceof Error ? error.message : 'Unknown error'
+                    });
+                }
+            }
+            else {
+                // 生成失败但未启用退款
+                mctx.setMiddlewareLog('billing-finalize', {
+                    noRefund: true,
+                    reason: 'refundOnFail disabled',
+                    charged: chargedAmount,
+                    userId: storedUserId,
+                    currency: currencyValue
+                });
+            }
+            return next();
+        }
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/lib/plugins/billing/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../src/plugins/billing/middleware.ts"],"names":[],"mappings":"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"}

package/lib/plugins/cache/config.d.ts

@@ -0,0 +1,44 @@
+import type { ConfigField } from '../../core';
+/** 本地缓存配置 */
+export interface LocalCacheConfig {
+    /** 是否启用本地缓存 */
+    enabled: boolean;
+    /** 缓存目录路径（相对于 Koishi 根目录） */
+    cacheDir: string;
+    /** HTTP 路由路径 */
+    publicPath: string;
+    /** 外部访问 URL 前缀（可选，留空则使用 selfUrl + publicPath） */
+    publicBaseUrl?: string;
+    /** 最大缓存大小（MB） */
+    maxCacheSize: number;
+    /** 单个文件最大大小（MB） */
+    maxFileSize: number;
+    /** 缓存过期时间（天），0 表示永不过期 */
+    expireDays: number;
+}
+/** 外部存储配置 */
+export interface StorageConfig {
+    /** 存储后端 */
+    backend: 'local' | 'none' | 's3' | 'webdav';
+    s3Endpoint?: string;
+    s3Region?: string;
+    s3AccessKeyId?: string;
+    s3SecretAccessKey?: string;
+    s3Bucket?: string;
+    s3PublicBaseUrl?: string;
+    s3ForcePathStyle?: boolean;
+    s3Acl?: 'private' | 'public-read';
+    webdavEndpoint?: string;
+    webdavUsername?: string;
+    webdavPassword?: string;
+    webdavBasePath?: string;
+    webdavPublicBaseUrl?: string;
+}
+/** 完整缓存插件配置 */
+export interface CachePluginConfig extends LocalCacheConfig, StorageConfig {
+}
+/** 完整配置字段（在"扩展插件"面板显示） */
+export declare const cacheConfigFields: ConfigField[];
+/** 默认配置 */
+export declare const defaultCacheConfig: CachePluginConfig;
+//# sourceMappingURL=config.d.ts.map

package/lib/plugins/cache/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/plugins/cache/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAI7C,aAAa;AACb,MAAM,WAAW,gBAAgB;IAC/B,eAAe;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAA;CACnB;AAID,aAAa;AACb,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAA;IAG3C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,KAAK,CAAC,EAAE,SAAS,GAAG,aAAa,CAAA;IAGjC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAID,eAAe;AACf,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB,EAAE,aAAa;CAAG;AAE7E,0BAA0B;AAC1B,eAAO,MAAM,iBAAiB,EAAE,WAAW,EAgL1C,CAAA;AAED,WAAW;AACX,eAAO,MAAM,kBAAkB,EAAE,iBAQhC,CAAA"}

package/lib/plugins/cache/config.js

@@ -0,0 +1,187 @@
+// 缓存插件配置字段定义
+/** 完整配置字段（在"扩展插件"面板显示） */
+export const cacheConfigFields = [
+    // 基础配置
+    {
+        key: 'enabled',
+        label: '启用缓存',
+        type: 'boolean',
+        default: true,
+        description: '是否启用文件缓存功能'
+    },
+    {
+        key: 'backend',
+        label: '存储后端',
+        type: 'select',
+        default: 'local',
+        options: [
+            { label: '本地存储（通过 HTTP 访问）', value: 'local' },
+            { label: '不使用（保留原始 URL）', value: 'none' },
+            { label: 'S3 兼容存储', value: 's3' },
+            { label: 'WebDAV', value: 'webdav' }
+        ],
+        description: '选择存储后端用于缓存生成结果'
+    },
+    // ========== 本地存储配置 ==========
+    {
+        key: 'cacheDir',
+        label: '缓存目录',
+        type: 'text',
+        default: 'data/media-luna/cache',
+        placeholder: 'data/media-luna/cache',
+        description: '本地缓存目录路径（相对于 Koishi 根目录）',
+        showWhen: { field: 'backend', value: 'local' }
+    },
+    {
+        key: 'publicPath',
+        label: 'URL 路径',
+        type: 'text',
+        default: '/media-luna/cache',
+        placeholder: '/media-luna/cache',
+        description: 'HTTP 路由路径（会注册到 Koishi 服务器）',
+        showWhen: { field: 'backend', value: 'local' }
+    },
+    {
+        key: 'publicBaseUrl',
+        label: '外部访问地址',
+        type: 'text',
+        placeholder: 'https://cdn.example.com/media-luna/cache',
+        description: '对外访问的完整 URL 前缀（留空则使用 selfUrl + 路径）',
+        showWhen: { field: 'backend', value: 'local' }
+    },
+    {
+        key: 'maxCacheSize',
+        label: '最大缓存大小',
+        type: 'number',
+        default: 500,
+        description: '本地缓存最大占用空间（MB）',
+        showWhen: { field: 'backend', value: 'local' }
+    },
+    {
+        key: 'maxFileSize',
+        label: '单文件大小限制',
+        type: 'number',
+        default: 50,
+        description: '单个文件最大大小（MB）',
+        showWhen: { field: 'backend', value: 'local' }
+    },
+    {
+        key: 'expireDays',
+        label: '缓存过期时间',
+        type: 'number',
+        default: 30,
+        description: '缓存过期时间（天），0 表示永不过期',
+        showWhen: { field: 'backend', value: 'local' }
+    },
+    // ========== S3 配置 ==========
+    {
+        key: 's3Endpoint',
+        label: 'S3 端点',
+        type: 'text',
+        placeholder: 'https://s3.amazonaws.com',
+        description: 'S3 兼容服务端点地址',
+        showWhen: { field: 'backend', value: 's3' }
+    },
+    {
+        key: 's3Region',
+        label: 'S3 区域',
+        type: 'text',
+        default: 'us-east-1',
+        placeholder: 'us-east-1',
+        showWhen: { field: 'backend', value: 's3' }
+    },
+    {
+        key: 's3AccessKeyId',
+        label: 'Access Key ID',
+        type: 'text',
+        showWhen: { field: 'backend', value: 's3' }
+    },
+    {
+        key: 's3SecretAccessKey',
+        label: 'Secret Access Key',
+        type: 'password',
+        showWhen: { field: 'backend', value: 's3' }
+    },
+    {
+        key: 's3Bucket',
+        label: 'Bucket 名称',
+        type: 'text',
+        placeholder: 'my-bucket',
+        showWhen: { field: 'backend', value: 's3' }
+    },
+    {
+        key: 's3PublicBaseUrl',
+        label: '公开访问 URL',
+        type: 'text',
+        placeholder: 'https://cdn.example.com',
+        description: 'CDN 或直接访问的 URL 前缀（可选）',
+        showWhen: { field: 'backend', value: 's3' }
+    },
+    {
+        key: 's3ForcePathStyle',
+        label: '强制路径风格',
+        type: 'boolean',
+        default: false,
+        description: '使用路径风格而非虚拟主机风格（适用于 MinIO 等）',
+        showWhen: { field: 'backend', value: 's3' }
+    },
+    {
+        key: 's3Acl',
+        label: 'ACL 权限',
+        type: 'select',
+        default: 'public-read',
+        options: [
+            { label: '公开读取', value: 'public-read' },
+            { label: '私有', value: 'private' }
+        ],
+        showWhen: { field: 'backend', value: 's3' }
+    },
+    // WebDAV 配置
+    {
+        key: 'webdavEndpoint',
+        label: 'WebDAV 端点',
+        type: 'text',
+        placeholder: 'https://dav.example.com/files',
+        description: 'WebDAV 服务根地址',
+        showWhen: { field: 'backend', value: 'webdav' }
+    },
+    {
+        key: 'webdavUsername',
+        label: '用户名',
+        type: 'text',
+        showWhen: { field: 'backend', value: 'webdav' }
+    },
+    {
+        key: 'webdavPassword',
+        label: '密码',
+        type: 'password',
+        showWhen: { field: 'backend', value: 'webdav' }
+    },
+    {
+        key: 'webdavBasePath',
+        label: '基础路径',
+        type: 'text',
+        placeholder: 'media-luna',
+        description: '上传文件的目录路径（可选）',
+        showWhen: { field: 'backend', value: 'webdav' }
+    },
+    {
+        key: 'webdavPublicBaseUrl',
+        label: '公开访问 URL',
+        type: 'text',
+        placeholder: 'https://files.example.com',
+        description: '对外访问的 URL 前缀（若与端点不同）',
+        showWhen: { field: 'backend', value: 'webdav' }
+    }
+];
+/** 默认配置 */
+export const defaultCacheConfig = {
+    enabled: true,
+    cacheDir: 'data/media-luna/cache',
+    publicPath: '/media-luna/cache',
+    maxCacheSize: 500,
+    maxFileSize: 50,
+    expireDays: 30,
+    backend: 'local'
+};
+//# sourceMappingURL=config.js.map

package/lib/plugins/cache/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/plugins/cache/config.ts"],"names":[],"mappings":"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"}

package/lib/plugins/cache/index.d.ts

@@ -0,0 +1,6 @@
+declare const _default: import("../../core").PluginDefinition;
+export default _default;
+export { CacheService } from './service';
+export type { CachedFile, CacheStats } from './service';
+export type { CachePluginConfig, StorageConfig, LocalCacheConfig } from './config';
+//# sourceMappingURL=index.d.ts.map

package/lib/plugins/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/cache/index.ts"],"names":[],"mappings":";AASA,wBAsFE;AAGF,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACvD,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA"}

package/lib/plugins/cache/index.js

@@ -0,0 +1,87 @@
+// 缓存插件入口
+import { createReadStream } from 'fs';
+import { basename } from 'path';
+import { definePlugin } from '../../core';
+import { CacheService } from './service';
+import { createStorageMiddleware, createStorageInputMiddleware } from './middleware';
+import { cacheConfigFields, defaultCacheConfig } from './config';
+export default definePlugin({
+    id: 'cache',
+    name: '缓存管理',
+    description: '本地文件缓存和外部存储支持（S3/WebDAV）',
+    version: '1.0.0',
+    services: [
+        {
+            name: 'cache',
+            factory: (ctx) => {
+                const config = ctx.getConfig();
+                return new CacheService(ctx.ctx, { ...defaultCacheConfig, ...config });
+            }
+        }
+    ],
+    middlewares: [
+        createStorageInputMiddleware(),
+        createStorageMiddleware()
+    ],
+    // 所有配置都在"扩展插件"面板显示
+    configFields: cacheConfigFields,
+    configDefaults: defaultCacheConfig,
+    settingsActions: [
+        {
+            name: 'stats',
+            label: '查看统计',
+            type: 'default',
+            icon: 'chart',
+            apiEvent: 'media-luna/cache/stats'
+        },
+        {
+            name: 'clear',
+            label: '清空缓存',
+            type: 'error',
+            icon: 'delete',
+            apiEvent: 'media-luna/cache/clear'
+        }
+    ],
+    async onLoad(ctx) {
+        ctx.logger.info('Cache plugin loaded');
+        // 获取配置的 publicPath
+        const config = ctx.getConfig();
+        const publicPath = config.publicPath || defaultCacheConfig.publicPath;
+        // 注册 HTTP 路由提供缓存文件访问
+        ctx.ctx.inject(['server'], (injectedCtx) => {
+            const cache = ctx.getService('cache');
+            if (!cache) {
+                ctx.logger.warn('Cache service not available, skipping HTTP route registration');
+                return;
+            }
+            // 获取 selfUrl 并设置 baseUrl
+            const selfUrl = injectedCtx.server.config.selfUrl;
+            if (selfUrl) {
+                cache.setBaseUrl(selfUrl.replace(/\/$/, ''));
+                ctx.logger.info('Cache HTTP route registered at %s', publicPath);
+            }
+            else {
+                ctx.logger.warn('selfUrl not configured, cache URLs will not be available');
+            }
+            // 注册文件访问路由: {publicPath}/:filename
+            injectedCtx.server.get(publicPath + '/:filename', async (koaCtx) => {
+                const filename = koaCtx.params.filename;
+                // 从文件名中提取 ID（去掉扩展名）
+                const id = basename(filename).replace(/\.[^.]+$/, '');
+                const cached = await cache.get(id);
+                if (!cached) {
+                    koaCtx.status = 404;
+                    koaCtx.body = 'Not found';
+                    return;
+                }
+                // 更新访问时间已在 get() 中处理
+                const stream = createReadStream(cached.localPath);
+                koaCtx.type = cached.mime;
+                koaCtx.body = stream;
+            });
+        });
+    }
+});
+// 导出类型和服务
+export { CacheService } from './service';
+//# sourceMappingURL=index.js.map

package/lib/plugins/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/cache/index.ts"],"names":[],"mappings":"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"}

package/lib/plugins/cache/middleware.d.ts

@@ -0,0 +1,12 @@
+import type { MiddlewareDefinition } from '../../core';
+/**
+ * 输入文件存储中间件
+ * 在 lifecycle-prepare 阶段将输入文件上传到存储后端
+ */
+export declare function createStorageInputMiddleware(): MiddlewareDefinition;
+/**
+ * 输出存储中间件
+ * 在 lifecycle-post-request 阶段将生成结果上传到存储后端
+ */
+export declare function createStorageMiddleware(): MiddlewareDefinition;
+//# sourceMappingURL=middleware.d.ts.map

package/lib/plugins/cache/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/plugins/cache/middleware.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EAIrB,MAAM,YAAY,CAAA;AA0EnB;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,oBAAoB,CAkEnE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,CAiF9D"}