@microwiseai/snapshot 0.3.5 → 0.3.26

package/node_modules/@microwiseai/cache/dist/file.js

@@ -0,0 +1,256 @@
+/**
+ * Generic file-based cache with TTL support
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+const DEFAULT_TTL_SECONDS = 3600; // 1 hour
+/**
+ * Get default cache directory
+ */
+function getDefaultCacheDir() {
+    return path.join(os.homedir(), '.cache');
+}
+/**
+ * File-based cache with TTL support
+ *
+ * @example
+ * ```typescript
+ * const cache = new FileCache<ConfigData>({
+ *   baseDir: '~/.myapp',
+ *   fileName: 'config-cache.json',
+ *   ttlSeconds: 3600
+ * });
+ * cache.set('config', configData);
+ * const config = cache.get('config');
+ * ```
+ */
+export class FileCache {
+    baseDir;
+    fileName;
+    ttlSeconds;
+    constructor(options = {}) {
+        this.baseDir = options.baseDir ?? getDefaultCacheDir();
+        this.fileName = options.fileName ?? 'cache.json';
+        this.ttlSeconds = options.ttlSeconds ?? DEFAULT_TTL_SECONDS;
+    }
+    /**
+     * Get cache file path
+     */
+    getFilePath() {
+        return path.join(this.baseDir, this.fileName);
+    }
+    /**
+     * Ensure cache directory exists
+     */
+    ensureDir() {
+        if (!fs.existsSync(this.baseDir)) {
+            fs.mkdirSync(this.baseDir, { recursive: true });
+        }
+    }
+    /**
+     * Read all cache entries from file
+     */
+    readAll() {
+        try {
+            const filePath = this.getFilePath();
+            if (!fs.existsSync(filePath)) {
+                return new Map();
+            }
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const data = JSON.parse(content);
+            return new Map(Object.entries(data));
+        }
+        catch {
+            return new Map();
+        }
+    }
+    /**
+     * Write all cache entries to file
+     */
+    writeAll(entries) {
+        this.ensureDir();
+        const data = Object.fromEntries(entries);
+        const filePath = this.getFilePath();
+        fs.writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf-8');
+    }
+    /**
+     * Get cached value
+     */
+    get(key) {
+        const entries = this.readAll();
+        const entry = entries.get(key);
+        if (!entry) {
+            return null;
+        }
+        // Check if expired
+        const expiresAt = new Date(entry.expiresAt);
+        if (expiresAt <= new Date()) {
+            entries.delete(key);
+            this.writeAll(entries);
+            return null;
+        }
+        return entry.value;
+    }
+    /**
+     * Set value in cache
+     */
+    set(key, value) {
+        const entries = this.readAll();
+        const now = new Date();
+        const expiresAt = new Date(now.getTime() + this.ttlSeconds * 1000);
+        entries.set(key, {
+            value,
+            cachedAt: now.toISOString(),
+            expiresAt: expiresAt.toISOString(),
+        });
+        this.writeAll(entries);
+    }
+    /**
+     * Set value with custom TTL
+     */
+    setWithTTL(key, value, ttlSeconds) {
+        const entries = this.readAll();
+        const now = new Date();
+        const expiresAt = new Date(now.getTime() + ttlSeconds * 1000);
+        entries.set(key, {
+            value,
+            cachedAt: now.toISOString(),
+            expiresAt: expiresAt.toISOString(),
+        });
+        this.writeAll(entries);
+    }
+    /**
+     * Delete cached value
+     */
+    delete(key) {
+        const entries = this.readAll();
+        if (entries.delete(key)) {
+            this.writeAll(entries);
+        }
+    }
+    /**
+     * Clear all cached values
+     */
+    clear() {
+        try {
+            const filePath = this.getFilePath();
+            if (fs.existsSync(filePath)) {
+                fs.unlinkSync(filePath);
+            }
+        }
+        catch {
+            // Ignore deletion errors
+        }
+    }
+    /**
+     * Check if cache entry is valid
+     */
+    isValid(key) {
+        return this.get(key) !== null;
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats(key) {
+        const entries = this.readAll();
+        const entry = entries.get(key);
+        if (!entry) {
+            return { exists: false };
+        }
+        const now = new Date();
+        const expiresAt = new Date(entry.expiresAt);
+        const cachedAt = new Date(entry.cachedAt);
+        if (expiresAt <= now) {
+            return { exists: false };
+        }
+        return {
+            exists: true,
+            cachedAt,
+            expiresAt,
+            remainingMs: Math.max(0, expiresAt.getTime() - now.getTime()),
+        };
+    }
+    /**
+     * Get cache directory path
+     */
+    getDirectory() {
+        return this.baseDir;
+    }
+    /**
+     * Cleanup expired entries
+     */
+    cleanup() {
+        const entries = this.readAll();
+        const now = new Date();
+        let removed = 0;
+        for (const [key, entry] of entries) {
+            const expiresAt = new Date(entry.expiresAt);
+            if (expiresAt <= now) {
+                entries.delete(key);
+                removed++;
+            }
+        }
+        if (removed > 0) {
+            this.writeAll(entries);
+        }
+        return removed;
+    }
+}
+// ============================================================
+// Utility functions
+// ============================================================
+/**
+ * Get storage directory path (for compatibility)
+ */
+export function getStorageDir(name, basePath) {
+    const base = basePath ?? os.homedir();
+    return path.join(base, `.${name}`);
+}
+/**
+ * Ensure directory exists
+ */
+export function ensureDir(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+}
+/**
+ * Read JSON file safely
+ */
+export function readJsonFile(filePath) {
+    try {
+        if (!fs.existsSync(filePath)) {
+            return null;
+        }
+        const content = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write JSON file safely
+ */
+export function writeJsonFile(filePath, data) {
+    const dir = path.dirname(filePath);
+    ensureDir(dir);
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf-8');
+}
+/**
+ * Delete file safely
+ */
+export function deleteFile(filePath) {
+    try {
+        if (fs.existsSync(filePath)) {
+            fs.unlinkSync(filePath);
+            return true;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=file.js.map

package/node_modules/@microwiseai/cache/dist/file.js.map

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

package/node_modules/@microwiseai/cache/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @microwiseai/cache
+ *
+ * Generic caching utilities for Node.js
+ * Provides both in-memory and file-based caching with TTL support
+ */
+export type { Cache, CacheEntry, CacheStats, MemoryCacheOptions, FileCacheOptions, FileCacheEntry, } from './types.js';
+export { MemoryCache, getGlobalCache, clearAllGlobalCaches } from './memory.js';
+export { FileCache, getStorageDir, ensureDir, readJsonFile, writeJsonFile, deleteFile, } from './file.js';
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@microwiseai/cache/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,KAAK,EACL,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGhF,OAAO,EACL,SAAS,EACT,aAAa,EACb,SAAS,EACT,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,WAAW,CAAC"}

package/node_modules/@microwiseai/cache/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * @microwiseai/cache
+ *
+ * Generic caching utilities for Node.js
+ * Provides both in-memory and file-based caching with TTL support
+ */
+// Memory cache
+export { MemoryCache, getGlobalCache, clearAllGlobalCaches } from './memory.js';
+// File cache
+export { FileCache, getStorageDir, ensureDir, readJsonFile, writeJsonFile, deleteFile, } from './file.js';
+//# sourceMappingURL=index.js.map

package/node_modules/@microwiseai/cache/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEhF,aAAa;AACb,OAAO,EACL,SAAS,EACT,aAAa,EACb,SAAS,EACT,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,WAAW,CAAC"}

package/node_modules/@microwiseai/cache/dist/memory.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Generic in-memory cache with TTL support
+ */
+import type { Cache, CacheStats, MemoryCacheOptions } from './types.js';
+/**
+ * In-memory cache with TTL support
+ *
+ * @example
+ * ```typescript
+ * const cache = new MemoryCache<UserData>({ ttlMs: 60000 });
+ * cache.set('user:123', userData);
+ * const user = cache.get('user:123');
+ * ```
+ */
+export declare class MemoryCache<T> implements Cache<T> {
+    private store;
+    private readonly ttlMs;
+    private readonly prefix;
+    constructor(options?: MemoryCacheOptions);
+    /**
+     * Get full cache key with prefix
+     */
+    private getKey;
+    /**
+     * Get cached value
+     */
+    get(key: string): T | null;
+    /**
+     * Set value in cache
+     */
+    set(key: string, value: T): void;
+    /**
+     * Set value with custom TTL
+     */
+    setWithTTL(key: string, value: T, ttlMs: number): void;
+    /**
+     * Delete cached value
+     */
+    delete(key: string): void;
+    /**
+     * Clear all cached values
+     */
+    clear(): void;
+    /**
+     * Check if cache entry is valid (exists and not expired)
+     */
+    isValid(key: string): boolean;
+    /**
+     * Get cache statistics
+     */
+    getStats(key: string): CacheStats;
+    /**
+     * Get number of entries (including expired)
+     */
+    get size(): number;
+    /**
+     * Cleanup expired entries
+     */
+    cleanup(): number;
+}
+/**
+ * Get or create a named global cache
+ */
+export declare function getGlobalCache<T>(name: string, options?: MemoryCacheOptions): MemoryCache<T>;
+/**
+ * Clear all global caches
+ */
+export declare function clearAllGlobalCaches(): void;
+//# sourceMappingURL=memory.d.ts.map

package/node_modules/@microwiseai/cache/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAc,UAAU,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIpF;;;;;;;;;GASG;AACH,qBAAa,WAAW,CAAC,CAAC,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,GAAE,kBAAuB;IAK5C;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAiB1B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAWhC;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAWtD;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKzB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI7B;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU;IAuBjC;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,IAAI,MAAM;CAalB;AAQD;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAAC,CAAC,CAAC,CAK5F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C"}

package/node_modules/@microwiseai/cache/dist/memory.js

@@ -0,0 +1,152 @@
+/**
+ * Generic in-memory cache with TTL support
+ */
+const DEFAULT_TTL_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * In-memory cache with TTL support
+ *
+ * @example
+ * ```typescript
+ * const cache = new MemoryCache<UserData>({ ttlMs: 60000 });
+ * cache.set('user:123', userData);
+ * const user = cache.get('user:123');
+ * ```
+ */
+export class MemoryCache {
+    store = new Map();
+    ttlMs;
+    prefix;
+    constructor(options = {}) {
+        this.ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
+        this.prefix = options.prefix ?? '';
+    }
+    /**
+     * Get full cache key with prefix
+     */
+    getKey(key) {
+        return this.prefix ? `${this.prefix}:${key}` : key;
+    }
+    /**
+     * Get cached value
+     */
+    get(key) {
+        const fullKey = this.getKey(key);
+        const entry = this.store.get(fullKey);
+        if (!entry) {
+            return null;
+        }
+        // Check if expired
+        if (Date.now() > entry.expiresAt) {
+            this.store.delete(fullKey);
+            return null;
+        }
+        return entry.value;
+    }
+    /**
+     * Set value in cache
+     */
+    set(key, value) {
+        const fullKey = this.getKey(key);
+        const now = Date.now();
+        this.store.set(fullKey, {
+            value,
+            cachedAt: now,
+            expiresAt: now + this.ttlMs,
+        });
+    }
+    /**
+     * Set value with custom TTL
+     */
+    setWithTTL(key, value, ttlMs) {
+        const fullKey = this.getKey(key);
+        const now = Date.now();
+        this.store.set(fullKey, {
+            value,
+            cachedAt: now,
+            expiresAt: now + ttlMs,
+        });
+    }
+    /**
+     * Delete cached value
+     */
+    delete(key) {
+        const fullKey = this.getKey(key);
+        this.store.delete(fullKey);
+    }
+    /**
+     * Clear all cached values
+     */
+    clear() {
+        this.store.clear();
+    }
+    /**
+     * Check if cache entry is valid (exists and not expired)
+     */
+    isValid(key) {
+        return this.get(key) !== null;
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats(key) {
+        const fullKey = this.getKey(key);
+        const entry = this.store.get(fullKey);
+        if (!entry) {
+            return { exists: false };
+        }
+        const now = Date.now();
+        const isExpired = now > entry.expiresAt;
+        if (isExpired) {
+            return { exists: false };
+        }
+        return {
+            exists: true,
+            cachedAt: new Date(entry.cachedAt),
+            expiresAt: new Date(entry.expiresAt),
+            remainingMs: Math.max(0, entry.expiresAt - now),
+        };
+    }
+    /**
+     * Get number of entries (including expired)
+     */
+    get size() {
+        return this.store.size;
+    }
+    /**
+     * Cleanup expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [key, entry] of this.store) {
+            if (now > entry.expiresAt) {
+                this.store.delete(key);
+                removed++;
+            }
+        }
+        return removed;
+    }
+}
+// ============================================================
+// Convenience functions for simple use cases (global cache)
+// ============================================================
+const globalCache = new Map();
+/**
+ * Get or create a named global cache
+ */
+export function getGlobalCache(name, options) {
+    if (!globalCache.has(name)) {
+        globalCache.set(name, new MemoryCache(options));
+    }
+    return globalCache.get(name);
+}
+/**
+ * Clear all global caches
+ */
+export function clearAllGlobalCaches() {
+    for (const cache of globalCache.values()) {
+        cache.clear();
+    }
+    globalCache.clear();
+}
+//# sourceMappingURL=memory.js.map

package/node_modules/@microwiseai/cache/dist/memory.js.map

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

package/node_modules/@microwiseai/cache/dist/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Generic cache type definitions
+ */
+/**
+ * Cache entry with metadata
+ */
+export interface CacheEntry<T> {
+    /** Cached value */
+    value: T;
+    /** Timestamp when cached (ms since epoch) */
+    cachedAt: number;
+    /** Timestamp when entry expires (ms since epoch) */
+    expiresAt: number;
+}
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+    /** Whether entry exists */
+    exists: boolean;
+    /** When the entry was cached */
+    cachedAt?: Date;
+    /** When the entry will expire */
+    expiresAt?: Date;
+    /** Milliseconds until expiration */
+    remainingMs?: number;
+}
+/**
+ * Memory cache options
+ */
+export interface MemoryCacheOptions {
+    /** Time-to-live in milliseconds (default: 5 minutes) */
+    ttlMs?: number;
+    /** Optional key prefix */
+    prefix?: string;
+}
+/**
+ * File cache options
+ */
+export interface FileCacheOptions {
+    /** Base directory for cache files (default: ~/.cache) */
+    baseDir?: string;
+    /** Cache file name (default: cache.json) */
+    fileName?: string;
+    /** Time-to-live in seconds */
+    ttlSeconds?: number;
+}
+/**
+ * File cache entry stored on disk
+ */
+export interface FileCacheEntry<T> {
+    /** Cached value */
+    value: T;
+    /** ISO timestamp when cached */
+    cachedAt: string;
+    /** ISO timestamp when entry expires */
+    expiresAt: string;
+}
+/**
+ * Generic cache interface
+ */
+export interface Cache<T> {
+    /** Get cached value by key */
+    get(key: string): T | null;
+    /** Set value in cache */
+    set(key: string, value: T): void;
+    /** Delete cached value */
+    delete(key: string): void;
+    /** Clear all cached values */
+    clear(): void;
+    /** Check if cache entry is valid */
+    isValid(key: string): boolean;
+    /** Get cache statistics */
+    getStats(key: string): CacheStats;
+}
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@microwiseai/cache/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,mBAAmB;IACnB,KAAK,EAAE,CAAC,CAAC;IACT,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,iCAAiC;IACjC,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,mBAAmB;IACnB,KAAK,EAAE,CAAC,CAAC;IACT,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,8BAA8B;IAC9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC;IAC3B,yBAAyB;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACjC,0BAA0B;IAC1B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,8BAA8B;IAC9B,KAAK,IAAI,IAAI,CAAC;IACd,oCAAoC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,2BAA2B;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC;CACnC"}

package/node_modules/@microwiseai/cache/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Generic cache type definitions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/node_modules/@microwiseai/cache/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/node_modules/@microwiseai/cache/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@microwiseai/cache",
+  "version": "0.1.0",
+  "description": "Generic caching utilities for Node.js - memory and file-based caching",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "cache",
+    "memory-cache",
+    "file-cache",
+    "ttl",
+    "typescript"
+  ],
+  "author": "MicrowiseAI",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  }
+}

package/node_modules/@microwiseai/import-telemetry/dist/__tests__/detector.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for detector.ts
+ * - detectLicenseStatus()
+ * - detectBypass()
+ */
+export {};
+//# sourceMappingURL=detector.test.d.ts.map

package/node_modules/@microwiseai/import-telemetry/dist/__tests__/detector.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/detector.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}