@lateos/npm-scan 0.9.5 → 0.9.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSING.md CHANGED
@@ -1 +1,19 @@
1
- # LICENSING.md\n\n## Model: Apache-2.0 core + Commons Clause premium\n\n### Core (Apache-2.0):\n- Static analysis engine, ATK-001–007 detectors, CLI, lockfile scanner, SBOM output (CycloneDX), GitHub Action, Docker images, JSON output, SQLite-backed local storage, basic HTML report.\n\n### Premium (Apache-2.0 + Commons Clause):\n- Dynamic sandbox (ATK-008+), advanced compliance reports (PDF, regulatory templates), SIEM connectors, reachability analysis, team dashboard, SSO, audit logs, API/webhooks, on-prem/air-gapped licenses, priority support.\n\n## Commons Clause\nThe Commons Clause prohibits selling our open core software as a service. See https://commonsclause.com/ for details.\n\n## Feature Flags\nPremium features gated by license key validated at runtime. Keys issued per-seat CLI, per-org hosted.\n\nFull Apache-2.0 license in LICENSE file (TBD).\n\nLicensing boundaries defined before external contributions. Changes require PR updating this file.
1
+ # LICENSING.md
2
+
3
+ ## Model: Apache-2.0 core + Commons Clause premium
4
+
5
+ ### Core (Apache-2.0):
6
+ - Static analysis engine, ATK-001–007 detectors, CLI, lockfile scanner, SBOM output (CycloneDX), GitHub Action, Docker images, JSON output, SQLite-backed local storage, basic HTML report.
7
+
8
+ ### Premium (Apache-2.0 + Commons Clause):
9
+ - Dynamic sandbox (ATK-008+), advanced compliance reports (PDF, regulatory templates), SIEM connectors, reachability analysis, team dashboard, SSO, audit logs, API/webhooks, on-prem/air-gapped licenses, priority support.
10
+
11
+ ## Commons Clause
12
+ The Commons Clause prohibits selling our open core software as a service. See https://commonsclause.com/ for details.
13
+
14
+ ## Feature Flags
15
+ Premium features gated by license key validated at runtime. Keys issued per-seat CLI, per-org hosted.
16
+
17
+ Full Apache-2.0 license in LICENSE file (TBD).
18
+
19
+ Licensing boundaries defined before external contributions. Changes require PR updating this file.
package/README.de.md CHANGED
@@ -11,6 +11,7 @@
11
11
  [![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square)](package.json)
12
12
  [![Tests](https://img.shields.io/badge/tests-222%20passing-brightgreen?style=flat-square)](https://github.com/lateos-ai/npm-scan)
13
13
  [![Coverage](https://img.shields.io/badge/coverage-85%25-yellowgreen?style=flat-square)](https://github.com/lateos-ai/npm-scan)
14
+ [![Docker](https://img.shields.io/badge/docker-ghcr.io%2Flateos%2Fnpm--scan-2496ED?style=flat-square&logo=docker)](https://github.com/lateos-ai/npm-scan/pkgs/container/npm-scan)
14
15
 
15
16
  **Moderne Lieferkettensicherheit für das npm-Ökosystem.**
16
17
  Statische + verhaltensbasierte Analyse, die erkennt, was npm audit, Snyk und Socket übersehen — obfuskierte Payloads, Credential-Stealer, bedingte Auslöser, Sandbox-Evasion und wurmartige Verbreitung.
@@ -93,6 +94,20 @@ npx @lateos/npm-scan scan commander
93
94
 
94
95
  ---
95
96
 
97
+ ## 🐳 @lateos/npm-scan überall mit Docker ausführen — keine Installation
98
+
99
+ ```bash
100
+ # Einmaligen Scan pullen und ausführen — kein Node.js oder npm erforderlich
101
+ docker run --rm ghcr.io/lateos/npm-scan:cli scan lodash
102
+
103
+ # Vollständige Pipeline mit persistentem Speicher und Compose
104
+ docker compose --profile pipeline up -d
105
+ ```
106
+
107
+ Kein Node.js. Kein `npm install`. Keine globalen Pakete. Funktioniert auf jedem System mit Docker — CI-Server, Air-Gapped-Umgebungen, Kubernetes-Cluster. Multi-Arch-Images für `linux/amd64` und `linux/arm64`.
108
+
109
+ ---
110
+
96
111
  ## 📖 Verwendungsbeispiele
97
112
 
98
113
  ### Ein einzelnes Paket scannen
@@ -392,21 +407,7 @@ npm-scan report --html > report.html
392
407
 
393
408
  ### Docker
394
409
 
395
- ```bash
396
- # Pull and run
397
- docker pull ghcr.io/lateos/npm-scan:cli
398
- docker run --rm ghcr.io/lateos/npm-scan:cli scan lodash
399
-
400
- # Vollständige Pipeline mit Compose (Redis-basierte Warteschlange)
401
- docker compose --profile pipeline up -d
402
-
403
- # CLI mit persistentem Speicher
404
- docker compose --profile cli up -d
405
- ```
406
-
407
- Multi-Arch-Images für `linux/amd64` und `linux/arm64` verfügbar.
408
-
409
- ### GitHub Action (für nachgelagerte Benutzer)
410
+ Siehe den obigen [Docker-Schnellstart-Abschnitt](#-lateosnpm-scan-überall-mit-docker-ausführen--keine-installation) für Pull-Befehle, Compose-Pipeline und Multi-Arch-Images.
410
411
 
411
412
  Scannen Sie die `package-lock.json` Ihres Projekts bei jedem PR — erkennt Typosquatting, obfuskierte Payloads, Credential-Stealer und Wurmverbreitung, bevor sie die Produktion erreichen:
412
413
 
@@ -500,19 +501,7 @@ npm-scan report --html > report.html
500
501
 
501
502
  ### Docker
502
503
 
503
- ```bash
504
- # Pull and run
505
- docker pull ghcr.io/lateos/npm-scan:cli
506
- docker run --rm ghcr.io/lateos/npm-scan:cli scan lodash
507
-
508
- # Vollständige Pipeline mit Compose (Redis-basierte Warteschlange)
509
- docker compose --profile pipeline up -d
510
-
511
- # CLI mit persistentem Speicher
512
- docker compose --profile cli up -d
513
- ```
514
-
515
- Multi-Arch-Images für `linux/amd64` und `linux/arm64` verfügbar.
504
+ Siehe den obigen [Docker-Schnellstart-Abschnitt](#-lateosnpm-scan-überall-mit-docker-ausführen--keine-installation) für Pull-Befehle, Compose-Pipeline und Multi-Arch-Images.
516
505
 
517
506
  ---
518
507
 
package/README.fr.md CHANGED
@@ -11,6 +11,7 @@
11
11
  [![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square)](package.json)
12
12
  [![Tests](https://img.shields.io/badge/tests-222%20passing-brightgreen?style=flat-square)](https://github.com/lateos-ai/npm-scan)
13
13
  [![Coverage](https://img.shields.io/badge/coverage-85%25-yellowgreen?style=flat-square)](https://github.com/lateos-ai/npm-scan)
14
+ [![Docker](https://img.shields.io/badge/docker-ghcr.io%2Flateos%2Fnpm--scan-2496ED?style=flat-square&logo=docker)](https://github.com/lateos-ai/npm-scan/pkgs/container/npm-scan)
14
15
 
15
16
  **Sécurité moderne de la chaîne d'approvisionnement pour l'écosystème npm.**
16
17
  Analyse statique + comportementale qui détecte ce que npm audit, Snyk et Socket manquent — charges utiles obfusquées, voleurs d'identifiants, déclencheurs conditionnels, contournement de sandbox et propagation de type ver.
@@ -93,6 +94,20 @@ npx @lateos/npm-scan scan commander
93
94
 
94
95
  ---
95
96
 
97
+ ## 🐳 Exécutez @lateos/npm-scan partout avec Docker — zéro installation
98
+
99
+ ```bash
100
+ # Tirez et exécutez un scan unique — pas de Node.js ni npm requis
101
+ docker run --rm ghcr.io/lateos/npm-scan:cli scan lodash
102
+
103
+ # Pipeline complet avec stockage persistant et Compose
104
+ docker compose --profile pipeline up -d
105
+ ```
106
+
107
+ Pas de Node.js. Pas de `npm install`. Pas de paquets globaux. Fonctionne sur tout système avec Docker — serveurs CI, environnements air-gap, clusters Kubernetes. Images multi-arch pour `linux/amd64` et `linux/arm64`.
108
+
109
+ ---
110
+
96
111
  ## 📖 Exemples d'utilisation
97
112
 
98
113
  ### Scanner un seul paquet
@@ -392,21 +407,7 @@ npm-scan report --html > report.html
392
407
 
393
408
  ### Docker
394
409
 
395
- ```bash
396
- # Tirer et exécuter
397
- docker pull ghcr.io/lateos/npm-scan:cli
398
- docker run --rm ghcr.io/lateos/npm-scan:cli scan lodash
399
-
400
- # Pipeline complet avec Compose (file d'attente basée sur Redis)
401
- docker compose --profile pipeline up -d
402
-
403
- # CLI avec stockage persistant
404
- docker compose --profile cli up -d
405
- ```
406
-
407
- Images multi-arch disponibles pour `linux/amd64` et `linux/arm64`.
408
-
409
- ### GitHub Action (pour les utilisateurs en aval)
410
+ Voir la [section Démarrage rapide Docker](#-exécutez-lateosnpm-scan-partout-avec-docker--zéro-installation) ci-dessus pour les commandes de tirage, le pipeline Compose et les images multi-arch.
410
411
 
411
412
  Scannez le `package-lock.json` de votre projet à chaque PR — détecte les typosquattings, les charges utiles obfusquées, les voleurs d'identifiants et la propagation de ver avant qu'ils n'atteignent la production :
412
413
 
@@ -500,19 +501,7 @@ npm-scan report --html > report.html
500
501
 
501
502
  ### Docker
502
503
 
503
- ```bash
504
- # Tirer et exécuter
505
- docker pull ghcr.io/lateos/npm-scan:cli
506
- docker run --rm ghcr.io/lateos/npm-scan:cli scan lodash
507
-
508
- # Pipeline complet avec Compose (file d'attente basée sur Redis)
509
- docker compose --profile pipeline up -d
510
-
511
- # CLI avec stockage persistant
512
- docker compose --profile cli up -d
513
- ```
514
-
515
- Images multi-arch disponibles pour `linux/amd64` et `linux/arm64`.
504
+ Voir la [section Démarrage rapide Docker](#-exécutez-lateosnpm-scan-partout-avec-docker--zéro-installation) ci-dessus pour les commandes de tirage, le pipeline Compose et les images multi-arch.
516
505
 
517
506
  ---
518
507
 
package/README.ja.md CHANGED
@@ -11,6 +11,7 @@
11
11
  [![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square)](package.json)
12
12
  [![Tests](https://img.shields.io/badge/tests-222%20passing-brightgreen?style=flat-square)](https://github.com/lateos-ai/npm-scan)
13
13
  [![Coverage](https://img.shields.io/badge/coverage-85%25-yellowgreen?style=flat-square)](https://github.com/lateos-ai/npm-scan)
14
+ [![Docker](https://img.shields.io/badge/docker-ghcr.io%2Flateos%2Fnpm--scan-2496ED?style=flat-square&logo=docker)](https://github.com/lateos-ai/npm-scan/pkgs/container/npm-scan)
14
15
 
15
16
  **npmエコシステムのためのモダンなサプライチェーンセキュリティ。**
16
17
  静的解析+行動分析で、npm audit、Snyk、Socketが見逃す脅威——難読化ペイロード、認証情報窃取、条件付きトリガー、サンドボックス回避、ワーム型伝播——を検出します。
@@ -93,6 +94,20 @@ npx @lateos/npm-scan scan commander
93
94
 
94
95
  ---
95
96
 
97
+ ## 🐳 Dockerで@lateos/npm-scanをどこでも実行 — インストール不要
98
+
99
+ ```bash
100
+ # 単一スキャンをプルして実行 — Node.jsやnpmは不要
101
+ docker run --rm ghcr.io/lateos/npm-scan:cli scan lodash
102
+
103
+ # 永続ストレージとComposeを使用した完全パイプライン
104
+ docker compose --profile pipeline up -d
105
+ ```
106
+
107
+ Node.js不要。`npm install`不要。グローバルパッケージ不要。Dockerがあればどんなシステムでも動作——CIサーバー、エアギャップ環境、Kubernetesクラスター。`linux/amd64`および`linux/arm64`向けマルチアーキテクチャイメージ。
108
+
109
+ ---
110
+
96
111
  ## 📖 使用例
97
112
 
98
113
  ### 単一パッケージのスキャン
@@ -392,21 +407,7 @@ npm-scan report --html > report.html
392
407
 
393
408
  ### Docker
394
409
 
395
- ```bash
396
- # プルして実行
397
- docker pull ghcr.io/lateos/npm-scan:cli
398
- docker run --rm ghcr.io/lateos/npm-scan:cli scan lodash
399
-
400
- # Composeを使用した完全パイプライン(Redisベースのキュー)
401
- docker compose --profile pipeline up -d
402
-
403
- # 永続ストレージ付きCLI
404
- docker compose --profile cli up -d
405
- ```
406
-
407
- `linux/amd64`および`linux/arm64`向けマルチアーキテクチャイメージを提供。
408
-
409
- ### GitHub Action(ダウンストリームユーザー向け)
410
+ 上記の[Dockerクイックスタート](#-dockerでlateosnpm-scanをどこでも実行--インストール不要)セクションを参照してください。プルコマンド、Composeパイプライン、マルチアーキテクチャイメージについて説明しています。
410
411
 
411
412
  すべてのPRでプロジェクトの`package-lock.json`をスキャン——タイポスクワッティング、難読化ペイロード、認証情報窃取ツール、ワーム伝播を本番環境に到達する前に検出:
412
413
 
@@ -500,19 +501,7 @@ npm-scan report --html > report.html
500
501
 
501
502
  ### Docker
502
503
 
503
- ```bash
504
- # プルして実行
505
- docker pull ghcr.io/lateos/npm-scan:cli
506
- docker run --rm ghcr.io/lateos/npm-scan:cli scan lodash
507
-
508
- # Composeを使用した完全パイプライン(Redisベースのキュー)
509
- docker compose --profile pipeline up -d
510
-
511
- # 永続ストレージ付きCLI
512
- docker compose --profile cli up -d
513
- ```
514
-
515
- `linux/amd64`および`linux/arm64`向けマルチアーキテクチャイメージを提供。
504
+ 上記の[Dockerクイックスタート](#-dockerでlateosnpm-scanをどこでも実行--インストール不要)セクションを参照してください。プルコマンド、Composeパイプライン、マルチアーキテクチャイメージについて説明しています。
516
505
 
517
506
  ---
518
507
 
package/README.md CHANGED
@@ -5,6 +5,7 @@
5
5
  [![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square)](package.json)
6
6
  [![Tests](https://img.shields.io/badge/tests-222%20passing-brightgreen?style=flat-square)](https://github.com/lateos-ai/npm-scan)
7
7
  [![Coverage](https://img.shields.io/badge/coverage-85%25-yellowgreen?style=flat-square)](https://github.com/lateos-ai/npm-scan)
8
+ [![Docker](https://img.shields.io/badge/docker-ghcr.io%2Flateos%2Fnpm--scan-2496ED?style=flat-square&logo=docker)](https://github.com/lateos-ai/npm-scan/pkgs/container/npm-scan)
8
9
 
9
10
  [![中文](https://img.shields.io/badge/lang-zh--CN-red?style=flat-square)](https://github.com/lateos-ai/npm-scan/blob/main/README.zh.md)
10
11
  [![日本語](https://img.shields.io/badge/lang-ja-purple?style=flat-square)](https://github.com/lateos-ai/npm-scan/blob/main/README.ja.md)
@@ -92,6 +93,34 @@ npx @lateos/npm-scan scan commander
92
93
 
93
94
  ---
94
95
 
96
+ ## 🐳 Run @lateos/npm-scan anywhere with Docker — zero installation
97
+
98
+ ```bash
99
+ # Pull and run a single scan — no Node.js or npm required
100
+ docker run --rm ghcr.io/lateos/npm-scan:cli scan lodash
101
+
102
+ # Full pipeline with persistent storage and Compose
103
+ docker compose --profile pipeline up -d
104
+ ```
105
+
106
+ No Node.js. No `npm install`. No global packages. Works on any system with Docker — CI servers, air-gapped environments, Kubernetes clusters. Multi-arch images for `linux/amd64` and `linux/arm64`.
107
+
108
+ ---
109
+
110
+ ## 🐳 Run @lateos/npm-scan anywhere with Docker — zero installation
111
+
112
+ ```bash
113
+ # Pull and run a single scan — no Node.js or npm required
114
+ docker run --rm ghcr.io/lateos/npm-scan:cli scan lodash
115
+
116
+ # Full pipeline with persistent storage and Compose
117
+ docker compose --profile pipeline up -d
118
+ ```
119
+
120
+ No Node.js. No `npm install`. No global packages. Works on any system with Docker — CI servers, air-gapped environments, Kubernetes clusters. Multi-arch images for `linux/amd64` and `linux/arm64`.
121
+
122
+ ---
123
+
95
124
  ## 📖 Usage Examples
96
125
 
97
126
  ### Scan a single package
@@ -391,21 +420,7 @@ npm-scan report --html > report.html
391
420
 
392
421
  ### Docker
393
422
 
394
- ```bash
395
- # Pull and run
396
- docker pull ghcr.io/lateos/npm-scan:cli
397
- docker run --rm ghcr.io/lateos/npm-scan:cli scan lodash
398
-
399
- # Full pipeline with Compose (Redis-based queue)
400
- docker compose --profile pipeline up -d
401
-
402
- # CLI with persistent storage
403
- docker compose --profile cli up -d
404
- ```
405
-
406
- Multi-arch images available for `linux/amd64` and `linux/arm64`.
407
-
408
- ### GitHub Action (for downstream users)
423
+ See the [Docker quick-start section](#-run-lateosnpm-scan-anywhere-with-docker--zero-installation) above for pull commands, Compose pipeline, and multi-arch images.
409
424
 
410
425
  Scan your project's `package-lock.json` on every PR — detects typosquats, obfuscated payloads, credential harvesters, and worm propagation before they reach production:
411
426
 
@@ -499,19 +514,7 @@ npm-scan report --html > report.html
499
514
 
500
515
  ### Docker
501
516
 
502
- ```bash
503
- # Pull and run
504
- docker pull ghcr.io/lateos/npm-scan:cli
505
- docker run --rm ghcr.io/lateos/npm-scan:cli scan lodash
506
-
507
- # Full pipeline with Compose (Redis-based queue)
508
- docker compose --profile pipeline up -d
509
-
510
- # CLI with persistent storage
511
- docker compose --profile cli up -d
512
- ```
513
-
514
- Multi-arch images available for `linux/amd64` and `linux/arm64`.
517
+ See the [Docker quick-start section](#-run-lateosnpm-scan-anywhere-with-docker--zero-installation) above for pull commands, Compose pipeline, and multi-arch images.
515
518
 
516
519
  ---
517
520
 
package/README.zh.md CHANGED
@@ -11,6 +11,7 @@
11
11
  [![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square)](package.json)
12
12
  [![Tests](https://img.shields.io/badge/tests-222%20passing-brightgreen?style=flat-square)](https://github.com/lateos-ai/npm-scan)
13
13
  [![Coverage](https://img.shields.io/badge/coverage-85%25-yellowgreen?style=flat-square)](https://github.com/lateos-ai/npm-scan)
14
+ [![Docker](https://img.shields.io/badge/docker-ghcr.io%2Flateos%2Fnpm--scan-2496ED?style=flat-square&logo=docker)](https://github.com/lateos-ai/npm-scan/pkgs/container/npm-scan)
14
15
 
15
16
  **适用于 npm 生态系统的现代供应链安全工具。**
16
17
  静态 + 行为分析,捕获 npm audit、Snyk 和 Socket 遗漏的威胁——混淆载荷、凭证窃取器、条件触发器、沙箱逃逸以及蠕虫式传播。
@@ -93,6 +94,20 @@ npx @lateos/npm-scan scan commander
93
94
 
94
95
  ---
95
96
 
97
+ ## 🐳 在任何地方通过 Docker 运行 @lateos/npm-scan — 零安装
98
+
99
+ ```bash
100
+ # 拉取并运行单次扫描 — 无需 Node.js 或 npm
101
+ docker run --rm ghcr.io/lateos/npm-scan:cli scan lodash
102
+
103
+ # 使用持久化存储和 Compose 的完整流水线
104
+ docker compose --profile pipeline up -d
105
+ ```
106
+
107
+ 无需 Node.js。无需 `npm install`。无需全局包。适用于任何拥有 Docker 的系统——CI 服务器、气隙环境、Kubernetes 集群。支持 `linux/amd64` 和 `linux/arm64` 的多架构镜像。
108
+
109
+ ---
110
+
96
111
  ## 📖 使用示例
97
112
 
98
113
  ### 扫描单个包
@@ -392,21 +407,7 @@ npm-scan report --html > report.html
392
407
 
393
408
  ### Docker
394
409
 
395
- ```bash
396
- # 拉取并运行
397
- docker pull ghcr.io/lateos/npm-scan:cli
398
- docker run --rm ghcr.io/lateos/npm-scan:cli scan lodash
399
-
400
- # 使用 Compose 的完整流水线(基于 Redis 的队列)
401
- docker compose --profile pipeline up -d
402
-
403
- # 带持久化存储的 CLI
404
- docker compose --profile cli up -d
405
- ```
406
-
407
- 支持 `linux/amd64` 和 `linux/arm64` 的多架构镜像。
408
-
409
- ### GitHub Action(面向下游用户)
410
+ 请参见上方的 [Docker 快速入门部分](#-在任何地方通过-docker-运行-lateosnpm-scan--零安装),了解拉取命令、Compose 流水线和多架构镜像。
410
411
 
411
412
  在每个 PR 上扫描您项目的 `package-lock.json`——在它们进入生产环境之前检测域名抢注、混淆载荷、凭证窃取器和蠕虫传播:
412
413
 
@@ -500,19 +501,7 @@ npm-scan report --html > report.html
500
501
 
501
502
  ### Docker
502
503
 
503
- ```bash
504
- # 拉取并运行
505
- docker pull ghcr.io/lateos/npm-scan:cli
506
- docker run --rm ghcr.io/lateos/npm-scan:cli scan lodash
507
-
508
- # 使用 Compose 的完整流水线(基于 Redis 的队列)
509
- docker compose --profile pipeline up -d
510
-
511
- # 带持久化存储的 CLI
512
- docker compose --profile cli up -d
513
- ```
514
-
515
- 支持 `linux/amd64` 和 `linux/arm64` 的多架构镜像。
504
+ 请参见上方的 [Docker 快速入门部分](#-在任何地方通过-docker-运行-lateosnpm-scan--零安装),了解拉取命令、Compose 流水线和多架构镜像。
516
505
 
517
506
  ---
518
507
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lateos/npm-scan",
3
- "version": "0.9.5",
3
+ "version": "0.9.6",
4
4
  "description": "Modern npm supply chain security scanner — detects obfuscated payloads, credential stealers, conditional triggers, sandbox evasion, and worm-like propagation. 11 attack types, SBOM, NIST/EU CRA compliance reporting.",
5
5
  "main": "backend/index.js",
6
6
  "bin": {