@jayxuz/verdaccio-offline-storage 3.0.0

package/README.md

@@ -0,0 +1,138 @@
+# @jayxuz/verdaccio-offline-storage
+
+English | [中文](./README.zh-CN.md)
+
+A Verdaccio storage plugin that treats local package cache as first class citizen for offline environments.
+
+> **Fork of [verdaccio-offline-storage](https://github.com/g3ngar/verdaccio-offline-storage)** with improvements for Verdaccio 6.x compatibility and enhanced functionality.
+
+## What's Different from the Original?
+
+This is an improved fork of the original `verdaccio-offline-storage` plugin. Key improvements include:
+
+### Verdaccio 6.x Compatibility
+- **TypeScript Rewrite**: Fully rewritten in TypeScript for better type safety and maintainability
+- **Updated Dependencies**: Compatible with `@verdaccio/local-storage` 13.x and `@verdaccio/core` 8.x
+- **Dual Package Support**: Automatically detects and uses either `@verdaccio/local-storage-legacy` (Verdaccio 6.x) or `@verdaccio/local-storage` (newer versions)
+
+### Enhanced Version Handling
+- **Semver Validation**: Uses proper semver validation when extracting versions from tarball filenames
+- **Prerelease Handling**: Prefers stable versions over prereleases when setting `dist-tags.latest`
+- **Robust Sorting**: Uses `semver.compare()` instead of simple string comparison for accurate version ordering
+
+### Improved Error Handling
+- **Async/Await**: Uses modern async/await patterns with Promises instead of callbacks
+- **Graceful Degradation**: Better error handling that doesn't break the entire request on partial failures
+- **Detailed Logging**: More informative debug and trace logs for troubleshooting
+
+### Code Quality
+- **Modern JavaScript**: ES2020+ features, async/await, optional chaining
+- **Type Definitions**: Full TypeScript type definitions included
+- **Null Safety**: Proper null checks for `data.versions`, `packageAccess.proxy`, etc.
+
+## Features
+
+- **Offline-First**: Makes Verdaccio's package cache work properly when going offline
+- **No Lockfile Required**: All dependencies resolve correctly if they were cached when online
+- **Transparent**: Works with existing `local-storage` cache without modifications
+- **Selective Offline Mode**: Can be enabled globally or per-package based on proxy configuration
+- **Web UI Integration**: Lists all locally available packages in Verdaccio's web interface
+
+## Installation
+
+```bash
+npm install @jayxuz/verdaccio-offline-storage
+# or
+yarn add @jayxuz/verdaccio-offline-storage
+```
+
+## Configuration
+
+Edit your Verdaccio `config.yaml`:
+
+```yaml
+# Storage path (same as default local-storage)
+storage: /path/to/storage
+
+# Use this plugin instead of default storage
+store:
+  '@jayxuz/verdaccio-offline-storage':
+    # Optional: force offline mode for ALL packages
+    offline: true
+```
+
+### Offline Mode Options
+
+**Option 1: Selective Offline (Default)**
+
+Without `offline: true`, packages are resolved in offline mode only when they have no `proxy` defined:
+
+```yaml
+packages:
+  '@my-scope/*':
+    access: $all
+    publish: $authenticated
+    # No proxy = offline mode
+
+  '**':
+    access: $all
+    publish: $authenticated
+    proxy: npmjs  # Has proxy = online mode
+```
+
+**Option 2: Global Offline**
+
+With `offline: true`, ALL packages are resolved in offline mode regardless of proxy settings:
+
+```yaml
+store:
+  '@jayxuz/verdaccio-offline-storage':
+    offline: true
+```
+
+## How It Works
+
+1. When a package is requested, the plugin scans the storage directory for `.tgz` files
+2. It filters the package metadata to only include versions that have local tarballs
+3. It updates `dist-tags.latest` to the highest locally available stable version
+4. The modified metadata is returned to the client
+
+This means:
+- `npm install package@latest` installs the latest **locally available** version
+- Version ranges like `^1.0.0` resolve to locally available versions
+- No network errors when upstream registry is unreachable
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Verdaccio >= 5.0.0 (tested with 6.x)
+
+## Migration from Original Plugin
+
+If you're migrating from `verdaccio-offline-storage`:
+
+1. Install this package: `npm install @jayxuz/verdaccio-offline-storage`
+2. Update your `config.yaml`:
+   ```yaml
+   store:
+     '@jayxuz/verdaccio-offline-storage':
+       # your existing options
+   ```
+3. Restart Verdaccio
+
+Your existing storage data is fully compatible - no migration needed.
+
+## Related Plugins
+
+This plugin works well with:
+
+- **verdaccio-ingest-middleware**: Download packages from upstream for offline caching
+- **verdaccio-metadata-healer**: Automatically repair missing package metadata
+
+## License
+
+MIT
+
+## Credits
+
+Original plugin by [g3ngar](https://github.com/g3ngar/verdaccio-offline-storage)

package/README.zh-CN.md

@@ -0,0 +1,138 @@
+# @jayxuz/verdaccio-offline-storage
+
+[English](./README.md) | 中文
+
+一个将本地包缓存作为一等公民的 Verdaccio 存储插件，专为离线环境设计。
+
+> **[verdaccio-offline-storage](https://github.com/g3ngar/verdaccio-offline-storage) 的改进分支**，增强了 Verdaccio 6.x 兼容性和功能。
+
+## 与原版的区别
+
+这是原版 `verdaccio-offline-storage` 插件的改进分支。主要改进包括：
+
+### Verdaccio 6.x 兼容性
+- **TypeScript 重写**：完全使用 TypeScript 重写，提供更好的类型安全性和可维护性
+- **更新依赖**：兼容 `@verdaccio/local-storage` 13.x 和 `@verdaccio/core` 8.x
+- **双包支持**：自动检测并使用 `@verdaccio/local-storage-legacy`（Verdaccio 6.x）或 `@verdaccio/local-storage`（更新版本）
+
+### 增强的版本处理
+- **Semver 验证**：从 tarball 文件名提取版本时使用正确的 semver 验证
+- **预发布版本处理**：设置 `dist-tags.latest` 时优先选择稳定版本而非预发布版本
+- **健壮的排序**：使用 `semver.compare()` 而非简单字符串比较，确保版本排序准确
+
+### 改进的错误处理
+- **Async/Await**：使用现代 async/await 模式替代回调
+- **优雅降级**：更好的错误处理，部分失败不会导致整个请求失败
+- **详细日志**：更丰富的 debug 和 trace 日志，便于故障排查
+
+### 代码质量
+- **现代 JavaScript**：ES2020+ 特性、async/await、可选链
+- **类型定义**：包含完整的 TypeScript 类型定义
+- **空值安全**：对 `data.versions`、`packageAccess.proxy` 等进行正确的空值检查
+
+## 功能特性
+
+- **离线优先**：使 Verdaccio 的包缓存在离线时正常工作
+- **无需锁文件**：如果在线时已缓存，所有依赖都能正确解析
+- **透明**：与现有的 `local-storage` 缓存兼容，无需修改
+- **选择性离线模式**：可以全局启用或根据 proxy 配置按包启用
+- **Web 界面集成**：在 Verdaccio 的 Web 界面中列出所有本地可用的包
+
+## 安装
+
+```bash
+npm install @jayxuz/verdaccio-offline-storage
+# 或
+yarn add @jayxuz/verdaccio-offline-storage
+```
+
+## 配置
+
+编辑 Verdaccio 的 `config.yaml`：
+
+```yaml
+# 存储路径（与默认 local-storage 相同）
+storage: /path/to/storage
+
+# 使用此插件替代默认存储
+store:
+  '@jayxuz/verdaccio-offline-storage':
+    # 可选：强制所有包使用离线模式
+    offline: true
+```
+
+### 离线模式选项
+
+**选项 1：选择性离线（默认）**
+
+不设置 `offline: true` 时，只有未定义 `proxy` 的包才会以离线模式解析：
+
+```yaml
+packages:
+  '@my-scope/*':
+    access: $all
+    publish: $authenticated
+    # 无 proxy = 离线模式
+
+  '**':
+    access: $all
+    publish: $authenticated
+    proxy: npmjs  # 有 proxy = 在线模式
+```
+
+**选项 2：全局离线**
+
+设置 `offline: true` 时，所有包都以离线模式解析，忽略 proxy 设置：
+
+```yaml
+store:
+  '@jayxuz/verdaccio-offline-storage':
+    offline: true
+```
+
+## 工作原理
+
+1. 当请求包时，插件扫描存储目录中的 `.tgz` 文件
+2. 过滤包元数据，只包含有本地 tarball 的版本
+3. 将 `dist-tags.latest` 更新为本地可用的最高稳定版本
+4. 将修改后的元数据返回给客户端
+
+这意味着：
+- `npm install package@latest` 安装最新的**本地可用**版本
+- 版本范围如 `^1.0.0` 解析为本地可用的版本
+- 上游仓库不可达时不会出现网络错误
+
+## 系统要求
+
+- Node.js >= 18.0.0
+- Verdaccio >= 5.0.0（已在 6.x 测试）
+
+## 从原版插件迁移
+
+如果你正在从 `verdaccio-offline-storage` 迁移：
+
+1. 安装此包：`npm install @jayxuz/verdaccio-offline-storage`
+2. 更新 `config.yaml`：
+   ```yaml
+   store:
+     '@jayxuz/verdaccio-offline-storage':
+       # 你现有的选项
+   ```
+3. 重启 Verdaccio
+
+你现有的存储数据完全兼容 - 无需迁移。
+
+## 相关插件
+
+本插件可与以下插件配合使用：
+
+- **verdaccio-ingest-middleware**：从上游下载包用于离线缓存
+- **verdaccio-metadata-healer**：自动修复缺失的包元数据
+
+## 许可证
+
+MIT
+
+## 致谢
+
+原版插件作者 [g3ngar](https://github.com/g3ngar/verdaccio-offline-storage)

package/build/OfflinePackageStorage.d.ts

@@ -0,0 +1,21 @@
+import { Logger, Callback } from '@verdaccio/types';
+import { OfflineStorageConfig } from './types';
+declare let LocalFS: any;
+/**
+ * IPackageStorage implementation for offline mode
+ *
+ * This works just like the IPackageStorage used by the local-storage plugin but modifying
+ * the packages definition files so only the locally available versions appear in the definition.
+ * This does NOT modify the original package.json file stored in the local-storage cache.
+ */
+export declare class OfflinePackageStorage extends LocalFS {
+    private config;
+    protected logger: Logger;
+    constructor(path: string, logger: Logger, config: OfflineStorageConfig);
+    /**
+     * Computes a package's definition that only lists the locally available versions.
+     */
+    readPackage(name: string, cb: Callback): void;
+}
+export {};
+//# sourceMappingURL=OfflinePackageStorage.d.ts.map

package/build/OfflinePackageStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfflinePackageStorage.d.ts","sourceRoot":"","sources":["../src/OfflinePackageStorage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAY,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAI/C,QAAA,IAAI,OAAO,EAAE,GAAG,CAAC;AAejB;;;;;;GAMG;AACH,qBAAa,qBAAsB,SAAQ,OAAO;IAChD,OAAO,CAAC,MAAM,CAAuB;IACrC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEb,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB;IAMtE;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,IAAI;CAqG9C"}

package/build/OfflinePackageStorage.js

@@ -0,0 +1,109 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OfflinePackageStorage = void 0;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const semver_1 = __importDefault(require("semver"));
+// Import LocalFS from @verdaccio/local-storage-legacy
+// Verdaccio 6.x uses local-storage-legacy package
+let LocalFS;
+try {
+    // Try @verdaccio/local-storage-legacy first (used by Verdaccio 6.x)
+    LocalFS = require('@verdaccio/local-storage-legacy/lib/local-fs').default;
+}
+catch {
+    try {
+        // Fallback to @verdaccio/local-storage (newer versions)
+        LocalFS = require('@verdaccio/local-storage').LocalDriver ||
+            require('@verdaccio/local-storage/lib/local-fs').default;
+    }
+    catch (e) {
+        console.error('[verdaccio-offline-storage] Failed to load LocalFS:', e);
+        throw new Error('Could not load LocalFS from @verdaccio/local-storage-legacy or @verdaccio/local-storage');
+    }
+}
+/**
+ * IPackageStorage implementation for offline mode
+ *
+ * This works just like the IPackageStorage used by the local-storage plugin but modifying
+ * the packages definition files so only the locally available versions appear in the definition.
+ * This does NOT modify the original package.json file stored in the local-storage cache.
+ */
+class OfflinePackageStorage extends LocalFS {
+    constructor(path, logger, config) {
+        super(path, logger);
+        this.config = config;
+        this.logger = logger;
+    }
+    /**
+     * Computes a package's definition that only lists the locally available versions.
+     */
+    readPackage(name, cb) {
+        const packageAccess = this.config.getMatchedPackagesSpec
+            ? this.config.getMatchedPackagesSpec(name)
+            : { proxy: [] };
+        // It's offline if set explicitly in the config or if no proxy is defined for the package
+        const offline = this.config.offline || !packageAccess?.proxy || packageAccess.proxy.length === 0;
+        if (!offline) {
+            this.logger.debug({ packageName: name }, '[verdaccio-offline-storage/readPackage] Resolving package @{packageName} in online mode');
+            super.readPackage(name, cb);
+            return;
+        }
+        this.logger.debug({ packageName: name }, '[verdaccio-offline-storage/readPackage] Resolving package @{packageName} in offline mode');
+        super.readPackage(name, async (err, data) => {
+            if (err) {
+                cb(err, data);
+                return;
+            }
+            try {
+                this.logger.debug({ packageName: name }, '[verdaccio-offline-storage/readPackage] Discovering local versions for package: @{packageName}');
+                const items = await (0, promises_1.readdir)(this.path);
+                const localVersions = items
+                    .filter((item) => item.endsWith('.tgz'))
+                    .map((item) => {
+                    // Extract version from filename: package-name-1.0.0.tgz -> 1.0.0
+                    const baseName = (0, path_1.basename)(name);
+                    return item.substring(baseName.length + 1, item.length - 4);
+                })
+                    .filter((v) => semver_1.default.valid(v));
+                this.logger.debug({ packageName: name, count: localVersions.length }, '[verdaccio-offline-storage/readPackage] Discovered @{count} local versions for package: @{packageName}');
+                const allVersions = Object.keys(data.versions || {});
+                const originalVersionCount = allVersions.length;
+                // Remove versions that are not locally available
+                for (const version of allVersions) {
+                    if (!localVersions.includes(version)) {
+                        delete data.versions[version];
+                        this.logger.trace({ packageName: name, version }, '[verdaccio-offline-storage/readPackage] Removed @{packageName}@@{version}');
+                    }
+                }
+                const removedCount = originalVersionCount - Object.keys(data.versions).length;
+                this.logger.debug({ packageName: name, count: removedCount }, '[verdaccio-offline-storage/readPackage] Removed @{count} unavailable versions for package: @{packageName}');
+                // Update dist-tags.latest to the highest locally available version
+                const availableVersions = Object.keys(data.versions);
+                if (availableVersions.length > 0) {
+                    const sortedVersions = availableVersions
+                        .filter((v) => semver_1.default.valid(v))
+                        .sort((a, b) => semver_1.default.compare(b, a));
+                    // Prefer stable versions over prereleases
+                    const stableVersions = sortedVersions.filter((v) => !semver_1.default.prerelease(v));
+                    const latestVersion = stableVersions.length > 0 ? stableVersions[0] : sortedVersions[0];
+                    if (latestVersion) {
+                        data['dist-tags'] = data['dist-tags'] || {};
+                        data['dist-tags'].latest = latestVersion;
+                        this.logger.debug({ packageName: name, latest: latestVersion }, '[verdaccio-offline-storage/readPackage] Set latest version to @{latest} for package: @{packageName}');
+                    }
+                }
+                cb(null, data);
+            }
+            catch (readErr) {
+                this.logger.error({ err: readErr.message, packageName: name }, '[verdaccio-offline-storage/readPackage] Error discovering package "@{packageName}" files: @{err}');
+                cb(readErr, data);
+            }
+        });
+    }
+}
+exports.OfflinePackageStorage = OfflinePackageStorage;
+//# sourceMappingURL=OfflinePackageStorage.js.map

package/build/OfflinePackageStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfflinePackageStorage.js","sourceRoot":"","sources":["../src/OfflinePackageStorage.ts"],"names":[],"mappings":";;;;;;AAAA,0CAAsC;AACtC,+BAAgC;AAChC,oDAA4B;AAI5B,sDAAsD;AACtD,kDAAkD;AAClD,IAAI,OAAY,CAAC;AACjB,IAAI,CAAC;IACH,oEAAoE;IACpE,OAAO,GAAG,OAAO,CAAC,8CAA8C,CAAC,CAAC,OAAO,CAAC;AAC5E,CAAC;AAAC,MAAM,CAAC;IACP,IAAI,CAAC;QACH,wDAAwD;QACxD,OAAO,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC,WAAW;YAC/C,OAAO,CAAC,uCAAuC,CAAC,CAAC,OAAO,CAAC;IACrE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,qDAAqD,EAAE,CAAC,CAAC,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAC;IAC7G,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAa,qBAAsB,SAAQ,OAAO;IAIhD,YAAY,IAAY,EAAE,MAAc,EAAE,MAA4B;QACpE,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAY,EAAE,EAAY;QACpC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,sBAAsB;YACtD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,IAAI,CAAC;YAC1C,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QAElB,yFAAyF;QACzF,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,aAAa,EAAE,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;QAEjG,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,WAAW,EAAE,IAAI,EAAE,EACrB,yFAAyF,CAC1F,CAAC;YACF,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,WAAW,EAAE,IAAI,EAAE,EACrB,0FAA0F,CAC3F,CAAC;QAEF,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,GAAQ,EAAE,IAAc,EAAE,EAAE;YACzD,IAAI,GAAG,EAAE,CAAC;gBACR,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACd,OAAO;YACT,CAAC;YAED,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,WAAW,EAAE,IAAI,EAAE,EACrB,gGAAgG,CACjG,CAAC;gBAEF,MAAM,KAAK,GAAG,MAAM,IAAA,kBAAO,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACvC,MAAM,aAAa,GAAG,KAAK;qBACxB,MAAM,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;qBAC/C,GAAG,CAAC,CAAC,IAAY,EAAE,EAAE;oBACpB,iEAAiE;oBACjE,MAAM,QAAQ,GAAG,IAAA,eAAQ,EAAC,IAAI,CAAC,CAAC;oBAChC,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAC9D,CAAC,CAAC;qBACD,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,gBAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAE1C,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,EAAE,EAClD,wGAAwG,CACzG,CAAC;gBAEF,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;gBACrD,MAAM,oBAAoB,GAAG,WAAW,CAAC,MAAM,CAAC;gBAEhD,iDAAiD;gBACjD,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;oBAClC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;wBACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;wBAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,EAC9B,2EAA2E,CAC5E,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAED,MAAM,YAAY,GAAG,oBAAoB,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;gBAC9E,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,EAC1C,2GAA2G,CAC5G,CAAC;gBAEF,mEAAmE;gBACnE,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACrD,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACjC,MAAM,cAAc,GAAG,iBAAiB;yBACrC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;yBAC9B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,gBAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;oBAExC,0CAA0C;oBAC1C,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,gBAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC3E,MAAM,aAAa,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;oBAExF,IAAI,aAAa,EAAE,CAAC;wBAClB,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;wBAC5C,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,aAAa,CAAC;wBAEzC,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,EAC5C,qGAAqG,CACtG,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAED,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACjB,CAAC;YAAC,OAAO,OAAY,EAAE,CAAC;gBACtB,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,EAC3C,kGAAkG,CACnG,CAAC;gBACF,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAlHD,sDAkHC"}

package/build/OfflineStoragePlugin.d.ts

@@ -0,0 +1,32 @@
+import { Logger, Callback } from '@verdaccio/types';
+import { pluginUtils } from '@verdaccio/core';
+import { OfflineStorageConfig, PluginOptions } from './types';
+declare let LocalDatabase: any;
+/**
+ * Verdaccio storage plugin that provides only the locally available versions of
+ * packages cached in a local-storage storage.
+ *
+ * This is just like local-storage but modifying on the fly the available packages list
+ * and the packages definitions without altering the original files in the local-storage storage.
+ *
+ * @see https://verdaccio.org/docs/en/plugin-storage
+ */
+export default class OfflineStoragePlugin extends LocalDatabase {
+    protected config: OfflineStorageConfig;
+    protected logger: Logger;
+    protected data: {
+        list: string[];
+    };
+    constructor(config: OfflineStorageConfig, options: PluginOptions);
+    /**
+     * Retrieves all the locally available packages names.
+     * Packages with no cached versions (only package.json file in the directory) are ignored.
+     */
+    get(callback: Callback): void;
+    /**
+     * Returns the IPackageStorage used internally for packages I/O operations.
+     */
+    getPackageStorage(packageName: string): pluginUtils.StorageHandler;
+}
+export {};
+//# sourceMappingURL=OfflineStoragePlugin.d.ts.map

package/build/OfflineStoragePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfflineStoragePlugin.d.ts","sourceRoot":"","sources":["../src/OfflineStoragePlugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI9D,QAAA,IAAI,aAAa,EAAE,GAAG,CAAC;AAgBvB;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,aAAa;IAC7D,SAAS,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACvC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;gBAEvB,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,aAAa;IAmBhE;;;OAGG;IACH,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IA+C7B;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAAC,cAAc;CAInE"}

package/build/OfflineStoragePlugin.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = require("path");
+const promises_1 = require("fs/promises");
+const OfflinePackageStorage_1 = require("./OfflinePackageStorage");
+// Import LocalDatabase - try multiple package names for compatibility
+let LocalDatabase;
+try {
+    // Try @verdaccio/local-storage-legacy first (used by Verdaccio 6.x)
+    LocalDatabase = require('@verdaccio/local-storage-legacy').LocalDatabase ||
+        require('@verdaccio/local-storage-legacy').default;
+}
+catch {
+    try {
+        // Fallback to @verdaccio/local-storage (newer versions)
+        LocalDatabase = require('@verdaccio/local-storage').LocalDatabase ||
+            require('@verdaccio/local-storage').default;
+    }
+    catch (e) {
+        console.error('[verdaccio-offline-storage] Failed to load LocalDatabase:', e);
+        throw new Error('Could not load LocalDatabase from @verdaccio/local-storage-legacy or @verdaccio/local-storage');
+    }
+}
+/**
+ * Verdaccio storage plugin that provides only the locally available versions of
+ * packages cached in a local-storage storage.
+ *
+ * This is just like local-storage but modifying on the fly the available packages list
+ * and the packages definitions without altering the original files in the local-storage storage.
+ *
+ * @see https://verdaccio.org/docs/en/plugin-storage
+ */
+class OfflineStoragePlugin extends LocalDatabase {
+    constructor(config, options) {
+        super(config, options.logger);
+        this.config = config;
+        this.logger = options.logger;
+        this.data = { list: [] };
+        if (config.offline) {
+            this.logger.warn({}, '[verdaccio-offline-storage] Offline mode set explicitly in config. All packages will be resolved in offline mode.');
+        }
+        else {
+            this.logger.warn({}, '[verdaccio-offline-storage] Offline mode NOT set explicitly in config. Only packages with no `proxy` will be resolved in offline mode.');
+        }
+    }
+    /**
+     * Retrieves all the locally available packages names.
+     * Packages with no cached versions (only package.json file in the directory) are ignored.
+     */
+    get(callback) {
+        const packages = [];
+        this.search((item, cb) => {
+            this.logger.debug({ packageName: item.name }, '[verdaccio-offline-storage/get] Discovering local versions for package: @{packageName}');
+            (0, promises_1.readdir)(item.path)
+                .then((items) => {
+                const hasTgz = items.some((file) => file.endsWith('.tgz'));
+                if (hasTgz) {
+                    packages.push(item.name);
+                    this.logger.trace({ packageName: item.name }, '[verdaccio-offline-storage/get] Found locally available package: "@{packageName}"');
+                }
+                else {
+                    this.logger.trace({ packageName: item.name }, '[verdaccio-offline-storage/get] No locally available version found for package: "@{packageName}"');
+                }
+                cb();
+            })
+                .catch((err) => {
+                this.logger.trace({ err: err.message, packageName: item.name }, '[verdaccio-offline-storage/get] Error discovering package "@{packageName}\" files: @{err}');
+                cb(err);
+            });
+        }, () => {
+            this.data.list = packages;
+            callback(null, packages);
+            this.logger.debug({ totalItems: packages.length }, '[verdaccio-offline-storage/get] Full list of packages (@{totalItems}) has been fetched');
+        }, (name) => !name.startsWith('.') // Ignore .verdaccio-db.json etc.
+        );
+    }
+    /**
+     * Returns the IPackageStorage used internally for packages I/O operations.
+     */
+    getPackageStorage(packageName) {
+        const storagePath = (0, path_1.join)(this.config.storage, packageName);
+        return new OfflinePackageStorage_1.OfflinePackageStorage(storagePath, this.logger, this.config);
+    }
+}
+exports.default = OfflineStoragePlugin;
+//# sourceMappingURL=OfflineStoragePlugin.js.map

package/build/OfflineStoragePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfflineStoragePlugin.js","sourceRoot":"","sources":["../src/OfflineStoragePlugin.ts"],"names":[],"mappings":";;AAAA,+BAA4B;AAC5B,0CAAsC;AAItC,mEAAgE;AAEhE,sEAAsE;AACtE,IAAI,aAAkB,CAAC;AACvB,IAAI,CAAC;IACH,oEAAoE;IACpE,aAAa,GAAG,OAAO,CAAC,iCAAiC,CAAC,CAAC,aAAa;QACxD,OAAO,CAAC,iCAAiC,CAAC,CAAC,OAAO,CAAC;AACrE,CAAC;AAAC,MAAM,CAAC;IACP,IAAI,CAAC;QACH,wDAAwD;QACxD,aAAa,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC,aAAa;YACjD,OAAO,CAAC,0BAA0B,CAAC,CAAC,OAAO,CAAC;IAC9D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,2DAA2D,EAAE,CAAC,CAAC,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,+FAA+F,CAAC,CAAC;IACnH,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAqB,oBAAqB,SAAQ,aAAa;IAK7D,YAAY,MAA4B,EAAE,OAAsB;QAC9D,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QAEzB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAE,EACF,mHAAmH,CACpH,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAE,EACF,wIAAwI,CACzI,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,QAAkB;QACpB,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,IAAI,CAAC,MAAM,CACT,CAAC,IAAoC,EAAE,EAAgC,EAAE,EAAE;YACzE,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,EAC1B,wFAAwF,CACzF,CAAC;YAEF,IAAA,kBAAO,EAAC,IAAI,CAAC,IAAI,CAAC;iBACf,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;gBACd,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC3D,IAAI,MAAM,EAAE,CAAC;oBACX,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACzB,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,EAC1B,mFAAmF,CACpF,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,EAC1B,kGAAkG,CACnG,CAAC;gBACJ,CAAC;gBACD,EAAE,EAAE,CAAC;YACP,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACb,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,EAC5C,2FAA2F,CAC5F,CAAC;gBACF,EAAE,CAAC,GAAG,CAAC,CAAC;YACV,CAAC,CAAC,CAAC;QACP,CAAC,EACD,GAAG,EAAE;YACH,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;YAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,EAC/B,wFAAwF,CACzF,CAAC;QACJ,CAAC,EACD,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,iCAAiC;SAC1E,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,WAAmB;QACnC,MAAM,WAAW,GAAG,IAAA,WAAI,EAAC,IAAI,CAAC,MAAM,CAAC,OAAiB,EAAE,WAAW,CAAC,CAAC;QACrE,OAAO,IAAI,6CAAqB,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAA0C,CAAC;IACnH,CAAC;CACF;AAlFD,uCAkFC"}

package/build/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * verdaccio-offline-storage
+ *
+ * A Verdaccio storage plugin that treats local package cache as first class citizen.
+ * Provides only locally available versions of packages for offline environments.
+ *
+ * @see https://github.com/g3ngar/verdaccio-offline-storage
+ */
+import OfflineStoragePlugin from './OfflineStoragePlugin';
+import { OfflinePackageStorage } from './OfflinePackageStorage';
+import { OfflineStorageConfig, PluginOptions } from './types';
+export default OfflineStoragePlugin;
+export { OfflineStoragePlugin, OfflinePackageStorage, OfflineStorageConfig, PluginOptions };
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,oBAAoB,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE9D,eAAe,oBAAoB,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,aAAa,EAAE,CAAC"}

package/build/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * verdaccio-offline-storage
+ *
+ * A Verdaccio storage plugin that treats local package cache as first class citizen.
+ * Provides only locally available versions of packages for offline environments.
+ *
+ * @see https://github.com/g3ngar/verdaccio-offline-storage
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OfflinePackageStorage = exports.OfflineStoragePlugin = void 0;
+const OfflineStoragePlugin_1 = __importDefault(require("./OfflineStoragePlugin"));
+exports.OfflineStoragePlugin = OfflineStoragePlugin_1.default;
+const OfflinePackageStorage_1 = require("./OfflinePackageStorage");
+Object.defineProperty(exports, "OfflinePackageStorage", { enumerable: true, get: function () { return OfflinePackageStorage_1.OfflinePackageStorage; } });
+exports.default = OfflineStoragePlugin_1.default;
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;AAEH,kFAA0D;AAKjD,+BALF,8BAAoB,CAKE;AAJ7B,mEAAgE;AAIjC,sGAJtB,6CAAqB,OAIsB;AADpD,kBAAe,8BAAoB,CAAC"}

package/build/types.d.ts

@@ -0,0 +1,16 @@
+import { Config, Logger } from '@verdaccio/types';
+/**
+ * Offline storage plugin configuration
+ */
+export interface OfflineStorageConfig extends Config {
+    /** Force offline mode for all packages */
+    offline?: boolean;
+}
+/**
+ * Plugin options passed by Verdaccio
+ */
+export interface PluginOptions {
+    config: Config;
+    logger: Logger;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,MAAM;IAClD,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/build/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/types.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@jayxuz/verdaccio-offline-storage",
+  "version": "3.0.0",
+  "description": "Verdaccio storage plugin that treats local package cache as first class citizen for offline environments",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf build",
+    "prepublishOnly": "npm run build",
+    "test": "jest"
+  },
+  "keywords": [
+    "verdaccio",
+    "plugin",
+    "storage",
+    "offline",
+    "local",
+    "cache",
+    "npm",
+    "registry"
+  ],
+  "dependencies": {
+    "@verdaccio/local-storage": "13.0.0-next-8.28",
+    "semver": "^7.5.0"
+  },
+  "devDependencies": {
+    "@verdaccio/types": "13.0.0-next-8.10",
+    "@verdaccio/core": "8.0.0-next-8.28",
+    "@types/jsonwebtoken": "^9.0.0",
+    "@types/node": "^20.0.0",
+    "@types/semver": "^7.5.0",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "verdaccio": ">=5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT",
+  "repository": "https://github.com/g3ngar/verdaccio-offline-storage",
+  "author": "g3ngar <gengar@nauta.cu>",
+  "homepage": "https://github.com/g3ngar/verdaccio-offline-storage"
+}

package/src-backup/OfflinePackageStorage.js

@@ -0,0 +1,122 @@
+import { readdir } from 'fs';
+import { basename } from 'path';
+import cmp from 'semver-compare';
+import LocalFS from '@verdaccio/local-storage/lib/local-fs';
+
+/**
+ * `IPackageStorage` used internally for packages I/O operations.
+ *
+ * This works just like the `IPackageStorage` used by the local-storage plugin but modifying
+ * the packages definition files (the local-storage `package.json` files) so only the locally
+ * available versions appears in the definition. This does **NOT** modifies the original
+ * `package.json` file stored in the local-storage cache, meaning that all the modifications are
+ * done on the fly, on demand and in memory.
+ *
+ * @see https://verdaccio.org/docs/en/plugin-storage#api
+ * @see https://github.com/verdaccio/monorepo/tree/master/plugins/local-storage
+ */
+export default class OfflinePackageStorage extends LocalFS {
+  constructor(path, logger, config) {
+    super(path, logger);
+    this.config = config;
+  }
+  /**
+   * Computes a package's definition that only lists the locally available versions.
+   *
+   * @param {string} name Package name.
+   * @param cb Callback to invoke with the computed definition.
+   */
+  readPackage(name, cb) {
+    const packageAccess = this.config.getMatchedPackagesSpec(name);
+    // It's offline if set explicitly in the config or if no proxy is defined for the package
+    const offline = this.config.offline || !packageAccess.proxy || !packageAccess.proxy.length;
+    if (!offline) {
+      this.logger.trace(
+        {
+          packageName: name,
+        },
+        '[verdaccio-offline-storage/readPackage] Resolving package @{packageName} in online mode'
+      );
+      super.readPackage(name, cb);
+      return;
+    }
+    this.logger.trace(
+      {
+        packageName: name,
+      },
+      '[verdaccio-offline-storage/readPackage] Resolving package @{packageName} in offline mode'
+    );
+    super.readPackage(name, (err, data) => {
+      if (err) {
+        cb(err);
+      } else {
+        this.logger.trace(
+          {
+            packageName: name,
+          },
+          '[verdaccio-offline-storage/readPackage] Discovering local versions for package: @{packageName}'
+        );
+        readdir(this.path, (err, items) => {
+          if (err) {
+            this.logger.trace(
+              {
+                err,
+                packageName: name,
+              },
+              '[verdaccio-offline-storage/readPackage/readdir] Error discovering package "@{packageName}" files: @{err}'
+            );
+            cb(err);
+          } else {
+            const localVersions = items
+              .filter(item => item.endsWith('.tgz'))
+              .map(item => item.substring(basename(name).length + 1, item.length - 4));
+            this.logger.trace(
+              {
+                packageName: name,
+                count: localVersions.length,
+              },
+              '[verdaccio-offline-storage/readPackage/readdir] Discovered @{count} items for package: @{packageName}'
+            );
+            const allVersions = Object.keys(data.versions);
+            const originalVersionCount = allVersions.length;
+            this.logger.trace(
+              {
+                packageName: name,
+                count: originalVersionCount,
+              },
+              '[verdaccio-offline-storage/readPackage/readdir] Analyzing @{count} declared versions for package: @{packageName}'
+            );
+            for (const version of allVersions) {
+              if (!localVersions.includes(version)) {
+                delete data.versions[version];
+                this.logger.trace(
+                  {
+                    packageName: name,
+                    version,
+                  },
+                  '[verdaccio-offline-storage/readPackage/readdir] Removed @{packageName}@@{version}'
+                );
+              }
+            }
+            this.logger.trace(
+              {
+                packageName: name,
+                count: originalVersionCount - Object.keys(data.versions).length,
+              },
+              '[verdaccio-offline-storage/readPackage/readdir] Removed @{count} versions for package: @{packageName}'
+            );
+            data['dist-tags'].latest = Object.keys(data.versions).sort((a, b) => cmp(b, a))[0];
+            this.logger.trace(
+              {
+                packageName: name,
+                latest: data['dist-tags'].latest,
+              },
+              '[verdaccio-offline-storage/readPackage/readdir] Set latest version to @{latest} for package: @{packageName}'
+            );
+            cb(null, data);
+          }
+        });
+      }
+    });
+  }
+}

package/src-backup/OfflineStoragePlugin.js

@@ -0,0 +1,102 @@
+import { join } from 'path';
+import { readdir } from 'fs';
+import LocalDatabase from '@verdaccio/local-storage';
+import OfflinePackageStorage from './OfflinePackageStorage';
+
+/**
+ * Verdaccio storage plugin (`IPluginStorage`) that provides only the locally available versions of
+ * packages cached in a local-storage storage.
+ *
+ * Basically, this is just like local-storage but modifying on the fly the available packages list
+ * and the packages definitions without altering the original files in the local-storage storage.
+ *
+ * @see https://verdaccio.org/docs/en/plugin-storage
+ * @see https://github.com/verdaccio/monorepo/tree/master/plugins/local-storage
+ */
+export default class OfflineStoragePlugin extends LocalDatabase {
+  constructor(config, options) {
+    super(config, options.logger);
+    // eslint-disable-next-line no-console
+    if (config.offline) {
+      options.logger.warn({}, 'Offline mode set explicitly in config. All packages will be resolved in offline mode.');
+    } else {
+      options.logger.warn(
+        {},
+        'Offline mode NOT set explicitly in config. Only packages with no `proxy` will be resolved in offline mode.'
+      );
+    }
+  }
+
+  /**
+   * Retrieves all the locally available packages names. Packages with no cached versions (only
+   * `package.json` file in the directory) are ignored.
+   *
+   * @param callback: The callback to invoke with the found packages names.
+   * @see https://verdaccio.org/docs/en/plugin-storage#api
+   */
+  get(callback) {
+    const packages = [];
+    this.search(
+      (item, cb) => {
+        this.logger.debug(
+          {
+            packageName: item.name,
+          },
+          '[verdaccio-offline-storage/get/search] discovering local versions for package: @{packageName}'
+        );
+        readdir(item.path, (err, items) => {
+          if (err) {
+            this.logger.trace(
+              {
+                err,
+                packageName: item.name,
+              },
+              '[verdaccio-offline-storage/get/search/readdir] error discovering package "@{packageName}" files: @{err}'
+            );
+            cb(err);
+          } else {
+            if (items.find(item => item.endsWith('.tgz'))) {
+              packages.push(item.name);
+              this.logger.trace(
+                {
+                  packageName: item.name,
+                },
+                '[verdaccio-offline-storage/get/search/readdir] found locally available package: "@{packageName}"'
+              );
+            } else {
+              this.logger.trace(
+                {
+                  packageName: item.name,
+                },
+                '[verdaccio-offline-storage/get/search/readdir] no locally available version found for package: "@{packageName}"'
+              );
+            }
+            cb();
+          }
+        });
+      },
+      () => {
+        this.data.list = packages;
+        callback(null, packages);
+        this.logger.trace(
+          {
+            totalItems: packages.length,
+          },
+          'verdaccio-offline-storage: [get] full list of packages (@{totalItems}) has been fetched'
+        );
+      },
+      name => !name.startsWith('.') // so `.{sinopia|verdaccio}-db.json` gets ignored
+    );
+  }
+
+  /**
+   * Returns the `IPackageStorage` used internally for packages I/O operations.
+   *
+   * @param {string} packageName Package name.
+   * @return {OfflinePackageStorage}
+   * @see https://verdaccio.org/docs/en/plugin-storage#api
+   */
+  getPackageStorage(packageName) {
+    return new OfflinePackageStorage(join(this.config.storage, packageName), this.logger, this.config);
+  }
+}

package/src-backup/plugin.js

@@ -0,0 +1,4 @@
+/**
+ * The verdaccio-offline-storage plugin entry point.
+ */
+export { default } from './OfflineStoragePlugin';

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./build",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "node"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "build"]
+}