shokupan 0.13.0 → 0.14.0

package/dist/level-BU87Jbus.js

@@ -0,0 +1,184 @@
+import { c as createLogger } from "./index-CUNBeZKj.js";
+class LevelAdapter {
+  constructor(options = {}) {
+    this.options = options;
+    if (options.db) {
+      this.db = options.db;
+    } else {
+      throw new Error("LevelAdapter requires an initialized AbstractLevel instance in options.db for now, or ensure classic-level is installed.");
+    }
+    process.on("exit", async () => {
+      await this.disconnect();
+    });
+  }
+  name = "leveldb";
+  db;
+  logger = createLogger("level-adapter");
+  async connect() {
+    if (this.db.status === "opening" || this.db.status === "open") return;
+    await this.db.open();
+  }
+  async disconnect() {
+    await this.db.close();
+  }
+  async setupSchema() {
+    if (process.env.NODE_ENV !== "test") this.logger.debug("LevelAdapter", "Clearing DB");
+    await this.db.clear();
+    if (process.env.NODE_ENV !== "test") this.logger.debug("LevelAdapter", "DB cleared");
+  }
+  getKey(table, id) {
+    return `${table}:${id}`;
+  }
+  async get(table, id) {
+    try {
+      const raw = await this.db.get(this.getKey(table, id));
+      if (raw === void 0) return null;
+      return JSON.parse(raw);
+    } catch (e) {
+      if (e.code === "LEVEL_NOT_FOUND" || e.notFound) return null;
+      throw e;
+    }
+  }
+  async create(table, id, data) {
+    const key = this.getKey(table, id);
+    try {
+      const val = await this.db.get(key);
+      if (val !== void 0) {
+        this.logger.error("LevelAdapter", `Record ${key} found unexpectedly`);
+        throw new Error(`Record ${id} already exists`);
+      }
+    } catch (e) {
+      const isNotFound = e.code === "LEVEL_NOT_FOUND" || e.notFound;
+      if (!isNotFound) {
+        this.logger.error("LevelAdapter", `Create error for ${key}:`, e);
+        throw e;
+      }
+    }
+    await this.db.put(key, JSON.stringify(data));
+    return data;
+  }
+  async update(table, id, data) {
+    const key = this.getKey(table, id);
+    let currentRaw;
+    try {
+      currentRaw = await this.db.get(key);
+    } catch (e) {
+      if (e.code === "LEVEL_NOT_FOUND" || e.notFound) {
+        throw new Error(`Record ${id} does not exist`);
+      }
+      throw e;
+    }
+    if (currentRaw === void 0) throw new Error(`Record ${id} does not exist`);
+    const current = JSON.parse(currentRaw);
+    const updated = { ...current, ...data };
+    await this.db.put(key, JSON.stringify(updated));
+    return updated;
+  }
+  async upsert(table, id, data) {
+    const key = this.getKey(table, id);
+    await this.db.put(key, JSON.stringify(data));
+    return data;
+  }
+  async delete(table, id) {
+    await this.db.del(this.getKey(table, id));
+  }
+  async count(table, query) {
+    const items = await this.scan(table, query);
+    return items.length;
+  }
+  async deleteMany(table, query) {
+    const items = await this.scan(table, query);
+    items.map((item) => ({ type: "del", key: this.getKey(table, item.id || item._id) }));
+    for (const item of items) {
+    }
+    const keysToDelete = [];
+    for await (const [key, value] of this.db.iterator({ gte: table + ":", lte: table + ":ÿ" })) {
+      try {
+        const data = JSON.parse(value);
+        if (this.matches(data, query)) {
+          keysToDelete.push(key);
+        }
+      } catch {
+      }
+    }
+    if (query?.sort || query?.limit) {
+      for (const key of keysToDelete) {
+      }
+    }
+    let matches = [];
+    for await (const [key, value] of this.db.iterator({ gte: table + ":", lte: table + ":ÿ" })) {
+      try {
+        const data = JSON.parse(value);
+        if (this.matches(data, query)) {
+          matches.push({ key, data });
+        }
+      } catch {
+      }
+    }
+    matches = this.applySortLimit(matches, query);
+    if (matches.length) {
+      await this.db.batch(matches.map((m) => ({ type: "del", key: m.key })));
+    }
+  }
+  async findMany(table, query) {
+    let matches = [];
+    for await (const [key, value] of this.db.iterator({ gte: table + ":", lte: table + ":ÿ" })) {
+      try {
+        const data = JSON.parse(value);
+        if (this.matches(data, query)) {
+          matches.push({ key, data });
+        }
+      } catch {
+      }
+    }
+    matches = this.applySortLimit(matches, query);
+    return matches.map((m) => m.data);
+  }
+  async scan(table, query) {
+    return this.findMany(table, query);
+  }
+  matches(data, query) {
+    if (!query) return true;
+    if (query.where) {
+      for (const [k, v] of Object.entries(query.where)) {
+        if (data[k] !== v) return false;
+      }
+    }
+    if (query.lt) {
+      for (const [k, v] of Object.entries(query.lt)) {
+        if (!(data[k] < v)) return false;
+      }
+    }
+    if (query.gt) {
+      for (const [k, v] of Object.entries(query.gt)) {
+        if (!(data[k] > v)) return false;
+      }
+    }
+    return true;
+  }
+  applySortLimit(items, query) {
+    if (!query) return items;
+    if (query.sort) {
+      items.sort((a, b) => {
+        for (const [k, dir] of Object.entries(query.sort)) {
+          const av = a.data[k];
+          const bv = b.data[k];
+          if (av < bv) return dir === "asc" ? -1 : 1;
+          if (av > bv) return dir === "asc" ? 1 : -1;
+        }
+        return 0;
+      });
+    }
+    if (query.offset) {
+      items = items.slice(query.offset);
+    }
+    if (query.limit) {
+      items = items.slice(0, query.limit);
+    }
+    return items;
+  }
+}
+export {
+  LevelAdapter
+};
+//# sourceMappingURL=level-BU87Jbus.js.map

package/dist/level-BU87Jbus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-BU87Jbus.js","sources":["../src/util/adapter/datastore/level.ts"],"sourcesContent":["import type { AbstractLevel } from 'abstract-level';\nimport { createLogger } from '../../logger';\nimport type { DatastoreAdapter, QueryOptions } from '../datastore';\n\nexport class LevelAdapter implements DatastoreAdapter {\n    name = 'leveldb';\n    private db: AbstractLevel<any, string, string>;\n    private logger = createLogger('level-adapter');\n\n    constructor(\n        private options: { location?: string, db?: any; } = {}\n    ) {\n        if (options.db) {\n            this.db = options.db;\n        } else {\n            // Dynamic import to avoid hard dependency if not used\n            // This expects user to have installed classic-level\n            // We can't easily dynamically new it without knowing the module name or having it passed.\n            // For now, we assume options.db is passed OR we try to require 'classic-level'\n            // But usually adapters inject the instance or factory.\n            // We'll try to import classic-level if location is provided.\n            throw new Error(\"LevelAdapter requires an initialized AbstractLevel instance in options.db for now, or ensure classic-level is installed.\");\n        }\n\n        process.on(\"exit\", async () => {\n            await this.disconnect();\n        });\n    }\n\n    async connect(): Promise<void> {\n        if (this.db.status === 'opening' || this.db.status === 'open') return;\n        await this.db.open();\n    }\n\n    async disconnect(): Promise<void> {\n        await this.db.close();\n    }\n\n    async setupSchema(): Promise<void> {\n        // Ensure fresh state for tests that might reuse instances (though we try not to)\n        // Ensure fresh state for tests that might reuse instances (though we try not to)\n        if (process.env.NODE_ENV !== 'test') this.logger.debug('LevelAdapter', \"Clearing DB\");\n        await this.db.clear();\n        if (process.env.NODE_ENV !== 'test') this.logger.debug('LevelAdapter', \"DB cleared\");\n    }\n\n    private getKey(table: string, id: string) {\n        return `${table}:${id}`;\n    }\n\n    async get<T>(table: string, id: string): Promise<T | null> {\n        try {\n            const raw = await this.db.get(this.getKey(table, id));\n            if (raw === undefined) return null;\n            return JSON.parse(raw);\n        } catch (e: any) {\n            if (e.code === 'LEVEL_NOT_FOUND' || e.notFound) return null;\n            throw e;\n        }\n    }\n\n    async create<T>(table: string, id: string, data: T): Promise<T> {\n        const key = this.getKey(table, id);\n        try {\n            const val = await this.db.get(key);\n            if (val !== undefined) {\n                this.logger.error('LevelAdapter', `Record ${key} found unexpectedly`);\n                throw new Error(`Record ${id} already exists`);\n            }\n        } catch (e: any) {\n            // Check for various not found error codes/flags\n            const isNotFound = e.code === 'LEVEL_NOT_FOUND' || e.notFound;\n            if (!isNotFound) {\n                this.logger.error('LevelAdapter', `Create error for ${key}:`, e);\n                throw e;\n            }\n        }\n\n        await this.db.put(key, JSON.stringify(data));\n        return data;\n    }\n\n    async update<T>(table: string, id: string, data: Partial<T>): Promise<T> {\n        const key = this.getKey(table, id);\n        let currentRaw: string | undefined;\n        try {\n            currentRaw = await this.db.get(key);\n        } catch (e: any) {\n            if (e.code === 'LEVEL_NOT_FOUND' || e.notFound) {\n                throw new Error(`Record ${id} does not exist`);\n            }\n            throw e;\n        }\n\n        if (currentRaw === undefined) throw new Error(`Record ${id} does not exist`);\n\n        const current = JSON.parse(currentRaw);\n        const updated = { ...current, ...data };\n        await this.db.put(key, JSON.stringify(updated));\n        return updated;\n    }\n\n    async upsert<T>(table: string, id: string, data: T): Promise<T> {\n        const key = this.getKey(table, id);\n        // LevelDB put IS upsert basically (overwrite)\n        // But if we want merge, we need read first. \n        // Surreal upsert replaces content? Yes.\n        await this.db.put(key, JSON.stringify(data));\n        return data;\n    }\n\n    async delete(table: string, id: string): Promise<void> {\n        await this.db.del(this.getKey(table, id));\n    }\n\n    async count(table: string, query?: QueryOptions): Promise<number> {\n        // Full scan required if internal implementation\n        // Optimization: Maintain counters? Too complex for generic adapter.\n        // Scan keys for table prefix\n        const items = await this.scan(table, query);\n        return items.length;\n    }\n\n    async deleteMany(table: string, query?: QueryOptions): Promise<void> {\n        const items = await this.scan(table, query);\n        // Batch delete\n        const ops = items.map(item => ({ type: 'del' as const, key: this.getKey(table, (item as any).id || (item as any)._id) }));\n        // Wait, we need the ID. \n        // If stored data has ID, good. If not, we need to return keys from scan.\n        // Let's make scan return keys?\n\n        // Re-implement scan to return keys+values or just support delete loop.\n        // Since we don't have atomic batch delete by query in Level without keys.\n\n        // Let's assume scan returns objects and we rely on ID being in the object (Shokupan convention).\n        // Or we parse key.\n        // Key format: table:id.\n\n        // Impl:\n        for (const item of items) {\n            // Extract ID from object or re-scan keys? \n            // Ideally scan should return { key, value }.\n            // But existing findMany returns T[].\n\n            // If we really need robust deleteMany, we need scan to return keys.\n            // We can iterate generic iterator.\n        }\n\n        // Simple generic delete:\n        // This is inefficient but functional for small datasets (like failed requests buffer).\n        // Better leveldb usage would be separate indexes.\n\n        // Re-scan finding keys\n        const keysToDelete: string[] = [];\n        for await (const [key, value] of this.db.iterator({ gte: table + ':', lte: table + ':\\xFF' })) {\n            try {\n                const data = JSON.parse(value);\n                if (this.matches(data, query)) {\n                    keysToDelete.push(key);\n                }\n            } catch { }\n        }\n\n        // Apply limit/sort? \n        // Applying limit/sort on deletions matches logic in other adapters.\n        // If sort is needed, we must fetch all matching, sort, slice, then delete.\n\n        if (query?.sort || query?.limit) {\n            // We need full objects to sort\n            const candidates: { key: string, data: any; }[] = [];\n            for (const key of keysToDelete) {\n                // We already parsed it above but didn't keep it.\n                // Rescan properly:\n            }\n            // Let's combine logic.\n        }\n\n        // Proper implementation:\n        let matches: { key: string, data: any; }[] = [];\n        for await (const [key, value] of this.db.iterator({ gte: table + ':', lte: table + ':\\xFF' })) {\n            try {\n                const data = JSON.parse(value);\n                if (this.matches(data, query)) {\n                    matches.push({ key, data });\n                }\n            } catch { }\n        }\n\n        matches = this.applySortLimit(matches, query);\n\n        if (matches.length) {\n            await this.db.batch(matches.map(m => ({ type: 'del', key: m.key })));\n        }\n    }\n\n    async findMany<T>(table: string, query?: QueryOptions): Promise<T[]> {\n        let matches: { key: string, data: T; }[] = [];\n        for await (const [key, value] of this.db.iterator({ gte: table + ':', lte: table + ':\\xFF' })) {\n            try {\n                const data = JSON.parse(value);\n                if (this.matches(data, query)) {\n                    matches.push({ key, data });\n                }\n            } catch { }\n        }\n\n        matches = this.applySortLimit(matches, query);\n        return matches.map(m => m.data);\n    }\n\n    private async scan<T>(table: string, query?: QueryOptions): Promise<T[]> {\n        return this.findMany(table, query);\n    }\n\n    private matches(data: any, query?: QueryOptions): boolean {\n        if (!query) return true;\n        if (query.where) {\n            for (const [k, v] of Object.entries(query.where)) {\n                if (data[k] !== v) return false;\n            }\n        }\n        if (query.lt) {\n            for (const [k, v] of Object.entries(query.lt)) {\n                if (!(data[k] < (v as any))) return false;\n            }\n        }\n        if (query.gt) {\n            for (const [k, v] of Object.entries(query.gt)) {\n                if (!(data[k] > (v as any))) return false;\n            }\n        }\n        return true;\n    }\n\n    private applySortLimit<T>(items: { key: string, data: T; }[], query?: QueryOptions): { key: string, data: T; }[] {\n        if (!query) return items;\n\n        if (query.sort) {\n            items.sort((a, b) => {\n                for (const [k, dir] of Object.entries(query.sort!)) {\n                    const av = (a.data as any)[k];\n                    const bv = (b.data as any)[k];\n                    if (av < bv) return dir === 'asc' ? -1 : 1;\n                    if (av > bv) return dir === 'asc' ? 1 : -1;\n                }\n                return 0;\n            });\n        }\n\n        if (query.offset) {\n            items = items.slice(query.offset);\n        }\n\n        if (query.limit) {\n            items = items.slice(0, query.limit);\n        }\n\n        return items;\n    }\n}\n"],"names":[],"mappings":"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"}

package/dist/level-DNFl2n-m.cjs

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const index = require("./index-BP7v0Hiv.cjs");
+class LevelAdapter {
+  constructor(options = {}) {
+    this.options = options;
+    if (options.db) {
+      this.db = options.db;
+    } else {
+      throw new Error("LevelAdapter requires an initialized AbstractLevel instance in options.db for now, or ensure classic-level is installed.");
+    }
+    process.on("exit", async () => {
+      await this.disconnect();
+    });
+  }
+  name = "leveldb";
+  db;
+  logger = index.createLogger("level-adapter");
+  async connect() {
+    if (this.db.status === "opening" || this.db.status === "open") return;
+    await this.db.open();
+  }
+  async disconnect() {
+    await this.db.close();
+  }
+  async setupSchema() {
+    if (process.env.NODE_ENV !== "test") this.logger.debug("LevelAdapter", "Clearing DB");
+    await this.db.clear();
+    if (process.env.NODE_ENV !== "test") this.logger.debug("LevelAdapter", "DB cleared");
+  }
+  getKey(table, id) {
+    return `${table}:${id}`;
+  }
+  async get(table, id) {
+    try {
+      const raw = await this.db.get(this.getKey(table, id));
+      if (raw === void 0) return null;
+      return JSON.parse(raw);
+    } catch (e) {
+      if (e.code === "LEVEL_NOT_FOUND" || e.notFound) return null;
+      throw e;
+    }
+  }
+  async create(table, id, data) {
+    const key = this.getKey(table, id);
+    try {
+      const val = await this.db.get(key);
+      if (val !== void 0) {
+        this.logger.error("LevelAdapter", `Record ${key} found unexpectedly`);
+        throw new Error(`Record ${id} already exists`);
+      }
+    } catch (e) {
+      const isNotFound = e.code === "LEVEL_NOT_FOUND" || e.notFound;
+      if (!isNotFound) {
+        this.logger.error("LevelAdapter", `Create error for ${key}:`, e);
+        throw e;
+      }
+    }
+    await this.db.put(key, JSON.stringify(data));
+    return data;
+  }
+  async update(table, id, data) {
+    const key = this.getKey(table, id);
+    let currentRaw;
+    try {
+      currentRaw = await this.db.get(key);
+    } catch (e) {
+      if (e.code === "LEVEL_NOT_FOUND" || e.notFound) {
+        throw new Error(`Record ${id} does not exist`);
+      }
+      throw e;
+    }
+    if (currentRaw === void 0) throw new Error(`Record ${id} does not exist`);
+    const current = JSON.parse(currentRaw);
+    const updated = { ...current, ...data };
+    await this.db.put(key, JSON.stringify(updated));
+    return updated;
+  }
+  async upsert(table, id, data) {
+    const key = this.getKey(table, id);
+    await this.db.put(key, JSON.stringify(data));
+    return data;
+  }
+  async delete(table, id) {
+    await this.db.del(this.getKey(table, id));
+  }
+  async count(table, query) {
+    const items = await this.scan(table, query);
+    return items.length;
+  }
+  async deleteMany(table, query) {
+    const items = await this.scan(table, query);
+    items.map((item) => ({ type: "del", key: this.getKey(table, item.id || item._id) }));
+    for (const item of items) {
+    }
+    const keysToDelete = [];
+    for await (const [key, value] of this.db.iterator({ gte: table + ":", lte: table + ":ÿ" })) {
+      try {
+        const data = JSON.parse(value);
+        if (this.matches(data, query)) {
+          keysToDelete.push(key);
+        }
+      } catch {
+      }
+    }
+    if (query?.sort || query?.limit) {
+      for (const key of keysToDelete) {
+      }
+    }
+    let matches = [];
+    for await (const [key, value] of this.db.iterator({ gte: table + ":", lte: table + ":ÿ" })) {
+      try {
+        const data = JSON.parse(value);
+        if (this.matches(data, query)) {
+          matches.push({ key, data });
+        }
+      } catch {
+      }
+    }
+    matches = this.applySortLimit(matches, query);
+    if (matches.length) {
+      await this.db.batch(matches.map((m) => ({ type: "del", key: m.key })));
+    }
+  }
+  async findMany(table, query) {
+    let matches = [];
+    for await (const [key, value] of this.db.iterator({ gte: table + ":", lte: table + ":ÿ" })) {
+      try {
+        const data = JSON.parse(value);
+        if (this.matches(data, query)) {
+          matches.push({ key, data });
+        }
+      } catch {
+      }
+    }
+    matches = this.applySortLimit(matches, query);
+    return matches.map((m) => m.data);
+  }
+  async scan(table, query) {
+    return this.findMany(table, query);
+  }
+  matches(data, query) {
+    if (!query) return true;
+    if (query.where) {
+      for (const [k, v] of Object.entries(query.where)) {
+        if (data[k] !== v) return false;
+      }
+    }
+    if (query.lt) {
+      for (const [k, v] of Object.entries(query.lt)) {
+        if (!(data[k] < v)) return false;
+      }
+    }
+    if (query.gt) {
+      for (const [k, v] of Object.entries(query.gt)) {
+        if (!(data[k] > v)) return false;
+      }
+    }
+    return true;
+  }
+  applySortLimit(items, query) {
+    if (!query) return items;
+    if (query.sort) {
+      items.sort((a, b) => {
+        for (const [k, dir] of Object.entries(query.sort)) {
+          const av = a.data[k];
+          const bv = b.data[k];
+          if (av < bv) return dir === "asc" ? -1 : 1;
+          if (av > bv) return dir === "asc" ? 1 : -1;
+        }
+        return 0;
+      });
+    }
+    if (query.offset) {
+      items = items.slice(query.offset);
+    }
+    if (query.limit) {
+      items = items.slice(0, query.limit);
+    }
+    return items;
+  }
+}
+exports.LevelAdapter = LevelAdapter;
+//# sourceMappingURL=level-DNFl2n-m.cjs.map

package/dist/level-DNFl2n-m.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-DNFl2n-m.cjs","sources":["../src/util/adapter/datastore/level.ts"],"sourcesContent":["import type { AbstractLevel } from 'abstract-level';\nimport { createLogger } from '../../logger';\nimport type { DatastoreAdapter, QueryOptions } from '../datastore';\n\nexport class LevelAdapter implements DatastoreAdapter {\n    name = 'leveldb';\n    private db: AbstractLevel<any, string, string>;\n    private logger = createLogger('level-adapter');\n\n    constructor(\n        private options: { location?: string, db?: any; } = {}\n    ) {\n        if (options.db) {\n            this.db = options.db;\n        } else {\n            // Dynamic import to avoid hard dependency if not used\n            // This expects user to have installed classic-level\n            // We can't easily dynamically new it without knowing the module name or having it passed.\n            // For now, we assume options.db is passed OR we try to require 'classic-level'\n            // But usually adapters inject the instance or factory.\n            // We'll try to import classic-level if location is provided.\n            throw new Error(\"LevelAdapter requires an initialized AbstractLevel instance in options.db for now, or ensure classic-level is installed.\");\n        }\n\n        process.on(\"exit\", async () => {\n            await this.disconnect();\n        });\n    }\n\n    async connect(): Promise<void> {\n        if (this.db.status === 'opening' || this.db.status === 'open') return;\n        await this.db.open();\n    }\n\n    async disconnect(): Promise<void> {\n        await this.db.close();\n    }\n\n    async setupSchema(): Promise<void> {\n        // Ensure fresh state for tests that might reuse instances (though we try not to)\n        // Ensure fresh state for tests that might reuse instances (though we try not to)\n        if (process.env.NODE_ENV !== 'test') this.logger.debug('LevelAdapter', \"Clearing DB\");\n        await this.db.clear();\n        if (process.env.NODE_ENV !== 'test') this.logger.debug('LevelAdapter', \"DB cleared\");\n    }\n\n    private getKey(table: string, id: string) {\n        return `${table}:${id}`;\n    }\n\n    async get<T>(table: string, id: string): Promise<T | null> {\n        try {\n            const raw = await this.db.get(this.getKey(table, id));\n            if (raw === undefined) return null;\n            return JSON.parse(raw);\n        } catch (e: any) {\n            if (e.code === 'LEVEL_NOT_FOUND' || e.notFound) return null;\n            throw e;\n        }\n    }\n\n    async create<T>(table: string, id: string, data: T): Promise<T> {\n        const key = this.getKey(table, id);\n        try {\n            const val = await this.db.get(key);\n            if (val !== undefined) {\n                this.logger.error('LevelAdapter', `Record ${key} found unexpectedly`);\n                throw new Error(`Record ${id} already exists`);\n            }\n        } catch (e: any) {\n            // Check for various not found error codes/flags\n            const isNotFound = e.code === 'LEVEL_NOT_FOUND' || e.notFound;\n            if (!isNotFound) {\n                this.logger.error('LevelAdapter', `Create error for ${key}:`, e);\n                throw e;\n            }\n        }\n\n        await this.db.put(key, JSON.stringify(data));\n        return data;\n    }\n\n    async update<T>(table: string, id: string, data: Partial<T>): Promise<T> {\n        const key = this.getKey(table, id);\n        let currentRaw: string | undefined;\n        try {\n            currentRaw = await this.db.get(key);\n        } catch (e: any) {\n            if (e.code === 'LEVEL_NOT_FOUND' || e.notFound) {\n                throw new Error(`Record ${id} does not exist`);\n            }\n            throw e;\n        }\n\n        if (currentRaw === undefined) throw new Error(`Record ${id} does not exist`);\n\n        const current = JSON.parse(currentRaw);\n        const updated = { ...current, ...data };\n        await this.db.put(key, JSON.stringify(updated));\n        return updated;\n    }\n\n    async upsert<T>(table: string, id: string, data: T): Promise<T> {\n        const key = this.getKey(table, id);\n        // LevelDB put IS upsert basically (overwrite)\n        // But if we want merge, we need read first. \n        // Surreal upsert replaces content? Yes.\n        await this.db.put(key, JSON.stringify(data));\n        return data;\n    }\n\n    async delete(table: string, id: string): Promise<void> {\n        await this.db.del(this.getKey(table, id));\n    }\n\n    async count(table: string, query?: QueryOptions): Promise<number> {\n        // Full scan required if internal implementation\n        // Optimization: Maintain counters? Too complex for generic adapter.\n        // Scan keys for table prefix\n        const items = await this.scan(table, query);\n        return items.length;\n    }\n\n    async deleteMany(table: string, query?: QueryOptions): Promise<void> {\n        const items = await this.scan(table, query);\n        // Batch delete\n        const ops = items.map(item => ({ type: 'del' as const, key: this.getKey(table, (item as any).id || (item as any)._id) }));\n        // Wait, we need the ID. \n        // If stored data has ID, good. If not, we need to return keys from scan.\n        // Let's make scan return keys?\n\n        // Re-implement scan to return keys+values or just support delete loop.\n        // Since we don't have atomic batch delete by query in Level without keys.\n\n        // Let's assume scan returns objects and we rely on ID being in the object (Shokupan convention).\n        // Or we parse key.\n        // Key format: table:id.\n\n        // Impl:\n        for (const item of items) {\n            // Extract ID from object or re-scan keys? \n            // Ideally scan should return { key, value }.\n            // But existing findMany returns T[].\n\n            // If we really need robust deleteMany, we need scan to return keys.\n            // We can iterate generic iterator.\n        }\n\n        // Simple generic delete:\n        // This is inefficient but functional for small datasets (like failed requests buffer).\n        // Better leveldb usage would be separate indexes.\n\n        // Re-scan finding keys\n        const keysToDelete: string[] = [];\n        for await (const [key, value] of this.db.iterator({ gte: table + ':', lte: table + ':\\xFF' })) {\n            try {\n                const data = JSON.parse(value);\n                if (this.matches(data, query)) {\n                    keysToDelete.push(key);\n                }\n            } catch { }\n        }\n\n        // Apply limit/sort? \n        // Applying limit/sort on deletions matches logic in other adapters.\n        // If sort is needed, we must fetch all matching, sort, slice, then delete.\n\n        if (query?.sort || query?.limit) {\n            // We need full objects to sort\n            const candidates: { key: string, data: any; }[] = [];\n            for (const key of keysToDelete) {\n                // We already parsed it above but didn't keep it.\n                // Rescan properly:\n            }\n            // Let's combine logic.\n        }\n\n        // Proper implementation:\n        let matches: { key: string, data: any; }[] = [];\n        for await (const [key, value] of this.db.iterator({ gte: table + ':', lte: table + ':\\xFF' })) {\n            try {\n                const data = JSON.parse(value);\n                if (this.matches(data, query)) {\n                    matches.push({ key, data });\n                }\n            } catch { }\n        }\n\n        matches = this.applySortLimit(matches, query);\n\n        if (matches.length) {\n            await this.db.batch(matches.map(m => ({ type: 'del', key: m.key })));\n        }\n    }\n\n    async findMany<T>(table: string, query?: QueryOptions): Promise<T[]> {\n        let matches: { key: string, data: T; }[] = [];\n        for await (const [key, value] of this.db.iterator({ gte: table + ':', lte: table + ':\\xFF' })) {\n            try {\n                const data = JSON.parse(value);\n                if (this.matches(data, query)) {\n                    matches.push({ key, data });\n                }\n            } catch { }\n        }\n\n        matches = this.applySortLimit(matches, query);\n        return matches.map(m => m.data);\n    }\n\n    private async scan<T>(table: string, query?: QueryOptions): Promise<T[]> {\n        return this.findMany(table, query);\n    }\n\n    private matches(data: any, query?: QueryOptions): boolean {\n        if (!query) return true;\n        if (query.where) {\n            for (const [k, v] of Object.entries(query.where)) {\n                if (data[k] !== v) return false;\n            }\n        }\n        if (query.lt) {\n            for (const [k, v] of Object.entries(query.lt)) {\n                if (!(data[k] < (v as any))) return false;\n            }\n        }\n        if (query.gt) {\n            for (const [k, v] of Object.entries(query.gt)) {\n                if (!(data[k] > (v as any))) return false;\n            }\n        }\n        return true;\n    }\n\n    private applySortLimit<T>(items: { key: string, data: T; }[], query?: QueryOptions): { key: string, data: T; }[] {\n        if (!query) return items;\n\n        if (query.sort) {\n            items.sort((a, b) => {\n                for (const [k, dir] of Object.entries(query.sort!)) {\n                    const av = (a.data as any)[k];\n                    const bv = (b.data as any)[k];\n                    if (av < bv) return dir === 'asc' ? -1 : 1;\n                    if (av > bv) return dir === 'asc' ? 1 : -1;\n                }\n                return 0;\n            });\n        }\n\n        if (query.offset) {\n            items = items.slice(query.offset);\n        }\n\n        if (query.limit) {\n            items = items.slice(0, query.limit);\n        }\n\n        return items;\n    }\n}\n"],"names":["createLogger"],"mappings":"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"}

package/dist/plugins/application/api-explorer/static/explorer-client.mjs

@@ -64,7 +64,7 @@ function renderInfoSection(info) {
     const { title, description } = info;
     return `
         <div class="info-section">
-            <h1>${title || 'API Explorer'}</h1>
+            <h1>${escapeHtml(title || 'API Explorer')}</h1>
             ${description ? `<div class="markdown-content" data-markdown="true">${parseMarkdown(description)}</div>` : ''}
         </div>
     `;
@@ -74,9 +74,9 @@ function renderMiddlewareView(middleware, container) {
     const html = `
         <div class="middleware-detail-view">
             <div class="middleware-header">
-                <h1>${middleware.name}</h1>
+                <h1>${escapeHtml(middleware.name)}</h1>
                 <div class="middleware-meta">
-                    ${middleware.scope ? `<span class="badge">${middleware.scope}</span>` : ''}
+                    ${middleware.scope ? `<span class="badge">${escapeHtml(middleware.scope)}</span>` : ''}
                     ${middleware.file ? `
                         <a href="vscode://file/${middleware.file}:${middleware.startLine || 1}" class="doc-source-link">
                             <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
@@ -139,10 +139,10 @@ function renderMiddlewareView(middleware, container) {
         const route = explorerData.routes.find(r => r.path === routePath);
         if (route) {
             return `
-                                            <tr>
-                                                <td class="col-method"><span class="badge badge-${route.method.toUpperCase()}">${route.method.toUpperCase()}</span></td>
-                                                <td class="col-path"><a href="#${route.op.operationId}" class="route-link">${routePath}</a></td>
-                                                <td class="col-desc">${route.op.summary || route.op.description || '-'}</td>
+                                        <tr>
+                                                <td class="col-method"><span class="badge badge-${escapeHtml(route.method.toUpperCase())}">${escapeHtml(route.method.toUpperCase())}</span></td>
+                                                <td class="col-path"><a href="#${escapeHtml(route.op.operationId)}" class="route-link">${highlightPath(routePath)}</a></td>
+                                                <td class="col-desc">${escapeHtml(route.op.summary || route.op.description || '-')}</td>
                                             </tr>
                                         `;
         }
@@ -270,14 +270,14 @@ function renderSchema(schema, depth = 0, isResponse = false) {
             return `
                 <div style="margin-left: ${indent}px;">
                     <div class="property-heading" style="display: flex; align-items: center; gap: 8px; padding: 6px 0;">
-                        <div class="property-name" style="font-family: monospace; font-weight: 500; color: var(--text-primary);">${key}</div>
+                        <div class="property-name" style="font-family: monospace; font-weight: 500; color: var(--text-primary);">${escapeHtml(key)}</div>
                         <span class="property-detail" style="color: var(--text-secondary); font-size: 0.85rem;">
-                            <span class="property-detail-value">${propType}</span>
+                            <span class="property-detail-value">${escapeHtml(propType)}</span>
                             ${isUnknown ? '<span class="unknown-marker" title="Type could not be determined statically" style="color: #ff9800; margin-left: 4px;">⚠️</span>' : ''}
                         </span>
                         ${badgeHtml}
                     </div>
-                    ${prop.description ? `<div style="color: var(--text-secondary); font-size: 0.85rem; margin-left: 0; margin-top: -4px; margin-bottom: 4px;">${prop.description}</div>` : ''}
+                    ${prop.description ? `<div style="color: var(--text-secondary); font-size: 0.85rem; margin-left: 0; margin-top: -4px; margin-bottom: 4px;">${escapeHtml(prop.description)}</div>` : ''}
                     ${hasNested ? renderSchema(propType === 'array' ? prop.items : prop, depth + 1, isResponse) : ''}
                 </div>
             `;
@@ -296,18 +296,37 @@ function renderSchema(schema, depth = 0, isResponse = false) {
 
     return `
         <div style="margin-left: ${indent}px; padding: 4px 0;">
-            <span class="property-detail-value" style="color: var(--text-secondary); font-family: monospace;">${type}</span>
-            ${schema.format ? `<span style="color: var(--text-secondary); font-size: 0.85rem; margin-left: 6px;">(${schema.format})</span>` : ''}
-            ${schema.description ? `<div style="color: var(--text-secondary); font-size: 0.85rem; margin-top: 4px;">${schema.description}</div>` : ''}
+            <span class="property-detail-value" style="color: var(--text-secondary); font-family: monospace;">${escapeHtml(type)}</span>
+            ${schema.format ? `<span style="color: var(--text-secondary); font-size: 0.85rem; margin-left: 6px;">(${escapeHtml(schema.format)})</span>` : ''}
+            ${schema.description ? `<div style="color: var(--text-secondary); font-size: 0.85rem; margin-top: 4px;">${escapeHtml(schema.description)}</div>` : ''}
         </div>
     `;
 }
 
+// Helper to escape HTML
+function escapeHtml(text) {
+    if (!text) return '';
+    return String(text)
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#039;");
+}
+
 // Helper to highlight path operators
 function highlightPath(path) {
     if (!path) return '';
 
-    return path
+    // specific pattern replacements on ESCAPED string
+    // {{...}} -> <span...>...</span>
+    // :param -> <span...>...</span>
+    // * -> <span...>...</span>
+
+    // We must escape the path first to prevent XSS
+    let safePath = escapeHtml(path);
+
+    return safePath
         // Highlight {{substitution}} patterns
         .replace(/\{\{([^}]+)\}\}/g, '<span style="color: #4caf50;">{{$1}}</span>')
         // Highlight :parameter patterns
@@ -321,10 +340,11 @@ function highlightPath(path) {
 function renderRequestView(route, container) {
     const { method, path, op } = route;
 
+    // Extract metadata
     // Extract metadata
     const source = op['x-shokupan-source'];
     const middlewares = op['x-shokupan-middleware'] || [];
-    const summary = op.summary || highlightPath(route.path);
+    const summary = op.summary ? escapeHtml(op.summary) : highlightPath(route.path);
 
     // Build tabs for Request Body, Params, Auth, etc.
     const uniqueParams = getUniqueParams(op);
@@ -337,7 +357,7 @@ function renderRequestView(route, container) {
                 <div class="request-panel-header">
                     <div class="request-header-main">
                         <div class="request-url-bar">
-                            <span class="url-method badge-${method}">${method.toUpperCase()}</span>
+                            <span class="url-method badge-${escapeHtml(method)}">${escapeHtml(method.toUpperCase())}</span>
                             <div class="url-input" style="display: flex; align-items: center; font-family: monospace; white-space: nowrap; overflow-x: auto;">${highlightPath(path)}</div>
                         </div>
                         <button class="send-btn" id="btn-send">Send</button>
@@ -422,7 +442,7 @@ function renderRequestView(route, container) {
                                 <div class="middleware-list" style="display: flex; flex-direction: column; gap: 4px;">
                                     ${middlewares.map((mw, idx) => `<div style="display: flex; align-items: center; gap: 8px;">
                                         <span style="font-family: monospace; color: var(--text-secondary); min-width: 20px;">${idx + 1}.</span>
-                                        <span class="middleware-badge" title="${mw.metadata ? JSON.stringify(mw.metadata).replace(/"/g, '&quot;') : ''}">${mw.name}</span>
+                                        <span class="middleware-badge" title="${mw.metadata ? escapeHtml(JSON.stringify(mw.metadata)) : ''}">${escapeHtml(mw.name)}</span>
                                     </div>`).join('')}
                                 </div>
                             </div>
@@ -432,8 +452,8 @@ function renderRequestView(route, container) {
                                 <h3 style="margin-top: 0; margin-bottom: 12px; font-size: 1rem;">Request</h3>
                                 <div style="display: grid; gap: 8px; font-size: 0.9rem;">
                                     <div style="display: flex; gap: 8px;">
-                                        <span class="badge badge-${method.toUpperCase()}">${method.toUpperCase()}</span>
-                                        <code style="background: var(--bg-primary); padding: 2px 6px; border-radius: 4px;">${path}</code>
+                                        <span class="badge badge-${escapeHtml(method.toUpperCase())}">${escapeHtml(method.toUpperCase())}</span>
+                                        <code style="background: var(--bg-primary); padding: 2px 6px; border-radius: 4px;">${escapeHtml(path)}</code>
                                     </div>
                                     ${op.parameters && op.parameters.length > 0 ? `
                                     <div style="display: grid; grid-template-columns: 120px 1fr; gap: 8px;">
@@ -441,12 +461,12 @@ function renderRequestView(route, container) {
                                         <div style="display: flex; flex-wrap: wrap; gap: 4px;">
                                             ${op.parameters.filter(p => p.in === 'query').map(p =>
         `<span style="background: var(--bg-primary); padding: 2px 6px; border-radius: 4px; font-size: 0.85rem;">
-                                                    <code>${p.name}</code>${p.required ? '*' : ''}
+                                                    <code>${escapeHtml(p.name)}</code>${p.required ? '*' : ''}
                                                 </span>`
     ).join('')}
                                             ${op.parameters.filter(p => p.in === 'path').map(p =>
         `<span style="background: var(--bg-primary); padding: 2px 6px; border-radius: 4px; font-size: 0.85rem;">
-                                                    <code>{${p.name}}</code>
+                                                    <code>{${escapeHtml(p.name)}}</code>
                                                 </span>`
     ).join('')}
                                         </div>
@@ -457,7 +477,7 @@ function renderRequestView(route, container) {
                                         <span style="color: var(--text-secondary);">Body:</span>
                                         <div style="display: flex; flex-wrap: wrap; gap: 4px;">
                                             ${Object.keys(op.requestBody.content || {}).map(ct =>
-        `<code style="background: var(--bg-primary); padding: 2px 6px; border-radius: 4px; font-size: 0.85rem;">${ct}</code>`
+        `<code style="background: var(--bg-primary); padding: 2px 6px; border-radius: 4px; font-size: 0.85rem;">${escapeHtml(ct)}</code>`
     ).join('')}
                                         </div>
                                     </div>
@@ -474,13 +494,13 @@ function renderRequestView(route, container) {
         return `
                                         <div style="border-left: 2px solid var(--text-secondary); padding-left: 12px;">
                                             <div style="display: flex; align-items: center; gap: 8px; margin-bottom: 8px;">
-                                                <code style="background: var(--bg-primary); padding: 2px 8px; border-radius: 4px; font-weight: bold;">${code}</code>
-                                                <span style="color: var(--text-secondary);">${resp.description || 'Response'}</span>
+                                                <code style="background: var(--bg-primary); padding: 2px 8px; border-radius: 4px; font-weight: bold;">${escapeHtml(code)}</code>
+                                                <span style="color: var(--text-secondary);">${escapeHtml(resp.description || 'Response')}</span>
                                             </div>
                                             ${contentTypes.length > 0 ? `
                                                 <div style="display: flex; flex-wrap: wrap; gap: 4px; margin-bottom: 8px;">
                                                     ${contentTypes.map(ct =>
-            `<code style="background: var(--bg-primary); padding: 2px 6px; border-radius: 4px; font-size: 0.8rem;">${ct}</code>`
+            `<code style="background: var(--bg-primary); padding: 2px 6px; border-radius: 4px; font-size: 0.8rem;">${escapeHtml(ct)}</code>`
         ).join('')}
                                                 </div>
                                             ` : ''}
@@ -894,9 +914,9 @@ function renderParamsTable(params) {
         <div class="params-table">
             ${params.map(p => `
                 <div class="param-row">
-                    <div class="param-key">${p.name}${p.required ? '*' : ''}</div>
+                    <div class="param-key">${escapeHtml(p.name)}${p.required ? '*' : ''}</div>
                     <div class="param-value">
-                        <input type="text" name="param-${p.name}" data-in="${p.in}" placeholder="${p.description || ''}" />
+                        <input type="text" name="param-${escapeHtml(p.name)}" data-in="${p.in}" placeholder="${escapeHtml(p.description || '')}" />
                     </div>
                 </div>
             `).join('')}
@@ -1267,7 +1287,13 @@ function parseMarkdown(text) {
         return originalBlockquote(quote);
     };
 
-    return marked.parse(text, { renderer });
+    const html = marked.parse(text, { renderer });
+
+    if (typeof DOMPurify !== 'undefined') {
+        return DOMPurify.sanitize(html);
+    }
+
+    return html;
 }
 
 

package/dist/plugins/application/asyncapi/plugin.d.ts

@@ -3,6 +3,7 @@ import { Shokupan } from '../../../shokupan';
 import { DeepPartial, ShokupanPlugin, ShokupanPluginOptions } from '../../../util/types';
 export interface AsyncApiPluginOptions {
     path?: string;
+    serverUrl?: string;
     spec?: DeepPartial<any>;
     disableSourceView?: boolean;
 }