@netkitty/analysis 1.0.0 → 1.2.0

package/CHANGELOG.md

@@ -1,3 +1,59 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+# [1.2.0](https://github.com/myq1991/netkitty/compare/@netkitty/analysis@1.1.0...@netkitty/analysis@1.2.0) (2026-07-23)
+
+
+### Features
+
+* **errors:** route pcap-core/pcap/analysis/replay/capture errors through NetKittyError ([19b0888](https://github.com/myq1991/netkitty/commit/19b08886f490afaeec3620745e545eb2446b4f83))
+
+
+
+
+
+# 1.1.0 (2026-07-22)
+
+
+### Bug Fixes
+
+* **analysis:** 惰性 require 改用行内 eslint-disable,与 GetBinding 既有写法一致 ([a508355](https://github.com/myq1991/netkitty/commit/a50835510780ef216558b09be08c542b950e71fd))
+* **analysis:** 消除 ESLint 报错(合并重复导入;关闭与 no-var-requires 一致的 no-require-imports) ([b1707d3](https://github.com/myq1991/netkitty/commit/b1707d3329496a80139c873b3a9d7ecc1f1ba552))
+
+
+### Features
+
+* **analysis:** 流式化 v1 步骤1 接口骨架 ([982c4a0](https://github.com/myq1991/netkitty/commit/982c4a074a0f48cff94138f47d1f70cfcad1276c))
+* **analysis:** 流式化 v1 步骤10a 浏览器读后端 BrowserFileReadBackend ([333d84a](https://github.com/myq1991/netkitty/commit/333d84a478a302127a5ff9fd5b7e10606377af89))
+* **analysis:** 流式化 v1 步骤10b-2 浏览器 worker 通道与门面 source 透传 ([a9ce915](https://github.com/myq1991/netkitty/commit/a9ce915741476050582b4ffbd9585ad906909355))
+* **analysis:** 流式化 v1 步骤2 node 读后端 IReadBackend ([1398158](https://github.com/myq1991/netkitty/commit/13981586df05cec7be04c9c5848b498a6c6edf5a))
+* **analysis:** 流式化 v1 步骤3 列式帧索引 ColumnarIndexStore ([cf6695f](https://github.com/myq1991/netkitty/commit/cf6695f64aeeb1f474e45aea5bdb6d39b70c37a5))
+* **analysis:** 流式化 v1 步骤4a-1 五元组抽取与帧索引器 ([ed752f6](https://github.com/myq1991/netkitty/commit/ed752f64b32491bdc30d6127fff4dc26d1cf46be))
+* **analysis:** 流式化 v1 步骤4a-2 端到端索引管线 PcapIndexBuilder ([b7e8ba1](https://github.com/myq1991/netkitty/commit/b7e8ba16829ae25d584f534458e40b36e39566d6))
+* **analysis:** 流式化 v1 步骤4b 工作线程通道 IWorkerChannel ([7f399d0](https://github.com/myq1991/netkitty/commit/7f399d058165aed2932d3373a11185d55804fc78))
+* **analysis:** 流式化 v1 步骤5 Analysis 门面串联与 open 端到端 ([375b6e9](https://github.com/myq1991/netkitty/commit/375b6e933183671e7c7ddde4050eb0ab195efbd4))
+* **analysis:** 流式化 v1 步骤6a 内置 Conversations/Endpoints reducer ([db6928a](https://github.com/myq1991/netkitty/commit/db6928a0f49a398bc87542e9802336ba9bc00c38))
+* **analysis:** 流式化 v1 步骤6b attachReducer 回放端到端 ([e6ac715](https://github.com/myq1991/netkitty/commit/e6ac7156978d23a1332b8819582fe21b19e964fe))
+* **analysis:** 流式化 v1 步骤7 用户 reducer 路径细化 ([ef53161](https://github.com/myq1991/netkitty/commit/ef53161c0450d447488fd7ea97813472f7a5d7bf))
+* **analysis:** 流式化 v1 步骤8a 内置 TcpStreamReducer ([8948c7b](https://github.com/myq1991/netkitty/commit/8948c7b928708c14fe2318874a625cf6f54a13cc))
+* **analysis:** 流式化 v1 步骤8b watch tail 实时索引与内存治理 ([3b23864](https://github.com/myq1991/netkitty/commit/3b23864d920cf3615d7ca23de02570c7d376f8fb))
+* **analysis:** 流式化 v1 步骤9 显示过滤器 filter ([25c5732](https://github.com/myq1991/netkitty/commit/25c573249c2dfe1a76970c7d72fc591b9d515adc))
+* **monorepo:** 阶段1c 迁移 @netkitty/analysis ([b880b95](https://github.com/myq1991/netkitty/commit/b880b95c44b96f5cd34ad0078e050edcf7894a85))
+
+
+### Performance Improvements
+
+* **analysis:** filter 列粗筛（无方向谓词零重解码，全表 filter 提速约 415×） ([8686f87](https://github.com/myq1991/netkitty/commit/8686f879273befa600b37095997c23bf8956f468))
+* **analysis:** P0 回放走列——indexOnly reducer 从索引列合成帧、跳过重解码（13×） ([0b19066](https://github.com/myq1991/netkitty/commit/0b190661204f01b06d84c9b2d5fe97668c15ab64))
+* **analysis:** 内置 Conversations/Endpoints 移入 worker 扫索引列（主线程零负担） ([ea7521a](https://github.com/myq1991/netkitty/commit/ea7521adf19dadf1e2ce21a486a753ecf7bf3214))
+* **analysis:** 索引加方向位，方向敏感 filter 也走列扫（ip.src 7240ms→26ms 约278×） ([649f0bb](https://github.com/myq1991/netkitty/commit/649f0bbfff18f6f596d218f3eb37935bf9fbf5cb))
+
+
+
+
+
 # Changelog
 
 All notable changes to this package are documented here, following

package/README.md

@@ -2,6 +2,12 @@
   <img src="https://raw.githubusercontent.com/myq1991/netkitty/main/assets/NetKittyLogo.webp" alt="NetKitty" width="180">
 </p>
 
+<p align="center">
+  <a href="https://www.npmjs.com/package/@netkitty/analysis"><img src="https://img.shields.io/npm/v/@netkitty/analysis?style=flat-square&labelColor=162032&color=2979ff&logo=npm&logoColor=white" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@netkitty/analysis"><img src="https://img.shields.io/npm/dm/@netkitty/analysis?style=flat-square&labelColor=162032&color=22c55e&logo=npm&logoColor=white" alt="npm downloads"></a>
+  <a href="https://github.com/myq1991/netkitty/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@netkitty/analysis?style=flat-square&labelColor=162032&color=2979ff" alt="license"></a>
+</p>
+
 # @netkitty/analysis
 
 Streaming, cross-packet analysis for capture files — a programmable, Wireshark-style front door over

package/README.zh-CN.md

@@ -2,6 +2,12 @@
   <img src="https://raw.githubusercontent.com/myq1991/netkitty/main/assets/NetKittyLogo.webp" alt="NetKitty" width="180">
 </p>
 
+<p align="center">
+  <a href="https://www.npmjs.com/package/@netkitty/analysis"><img src="https://img.shields.io/npm/v/@netkitty/analysis?style=flat-square&labelColor=162032&color=2979ff&logo=npm&logoColor=white" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@netkitty/analysis"><img src="https://img.shields.io/npm/dm/@netkitty/analysis?style=flat-square&labelColor=162032&color=22c55e&logo=npm&logoColor=white" alt="npm downloads"></a>
+  <a href="https://github.com/myq1991/netkitty/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@netkitty/analysis?style=flat-square&labelColor=162032&color=2979ff" alt="license"></a>
+</p>
+
 # @netkitty/analysis
 
 对抓包文件做流式的跨包分析——一个可编程的、类似 Wireshark 的 pcap/pcapng 入口。同一个 `Analysis` 类

package/dist/{lib/streaming/Analysis.js → Analysis.js}

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Analysis = void 0;
+const AnalysisStateError_1 = require("./errors/AnalysisStateError");
 //How many frames to pull per replay batch — bounds memory and back-pressures the worker naturally.
 const REPLAY_BATCH = 512;
 /**
@@ -145,7 +146,7 @@ class Analysis {
     }
     #require() {
         if (!this.#channel)
-            throw new Error('Analysis has no open source; call open() or watch() first');
+            throw new AnalysisStateError_1.AnalysisStateError('Analysis has no open source; call open() or watch() first');
         return this.#channel;
     }
     #emit(event, ...args) {

package/dist/errors/AnalysisStateError.d.ts

@@ -0,0 +1,6 @@
+import { NetKittyError } from '@netkitty/errors';
+/** Thrown when an Analysis method is used before a source is open — call open() or watch() first. */
+export declare class AnalysisStateError extends NetKittyError {
+    errno: number;
+    code: string;
+}

package/dist/errors/AnalysisStateError.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalysisStateError = void 0;
+const errors_1 = require("@netkitty/errors");
+/** Thrown when an Analysis method is used before a source is open — call open() or watch() first. */
+class AnalysisStateError extends errors_1.NetKittyError {
+    constructor() {
+        super(...arguments);
+        this.errno = errors_1.ErrorCode.E_ANALYSIS_STATE.errno;
+        this.code = errors_1.ErrorCode.E_ANALYSIS_STATE.code;
+    }
+}
+exports.AnalysisStateError = AnalysisStateError;

package/dist/index.d.ts

@@ -3,28 +3,32 @@
  * display filter, and the pluggable backend seams. node (worker_threads) and browser (Web Worker)
  * share one environment-agnostic API, verified field-for-field in both.
  */
-export { Analysis } from './lib/streaming/Analysis';
-export type { AnalysisOptions } from './lib/streaming/types/AnalysisOptions';
-export type { AnalysisSource } from './lib/streaming/types/AnalysisSource';
-export type { AnalysisEvents } from './lib/streaming/types/AnalysisEvents';
-export type { AnalysisPhase } from './lib/streaming/types/AnalysisPhase';
-export type { UpdateContext } from './lib/streaming/types/UpdateContext';
-export type { Frame } from './lib/streaming/types/Frame';
-export type { FrameRow } from './lib/streaming/types/FrameRow';
-export type { FrameIndexRecord } from './lib/streaming/types/FrameIndexRecord';
-export type { IAnalysisReducer } from './lib/streaming/interfaces/IAnalysisReducer';
-export type { IReadBackend } from './lib/streaming/interfaces/IReadBackend';
-export type { IWorkerChannel } from './lib/streaming/interfaces/IWorkerChannel';
-export type { IIndexStore } from './lib/streaming/interfaces/IIndexStore';
+export { Analysis } from './Analysis';
+export type { AnalysisOptions } from './types/AnalysisOptions';
+export type { AnalysisSource } from './types/AnalysisSource';
+export type { AnalysisEvents } from './types/AnalysisEvents';
+export type { AnalysisPhase } from './types/AnalysisPhase';
+export type { UpdateContext } from './types/UpdateContext';
+export type { Frame } from './types/Frame';
+export type { FrameRow } from './types/FrameRow';
+export type { FrameIndexRecord } from './types/FrameIndexRecord';
+export type { IAnalysisReducer } from './interfaces/IAnalysisReducer';
+export type { IReadBackend } from './interfaces/IReadBackend';
+export type { IWorkerChannel } from './interfaces/IWorkerChannel';
+export type { IIndexStore } from './interfaces/IIndexStore';
 /**
  * Built-in reducers (exported, not baked into Analysis) — attach them for Wireshark-style stats.
  */
-export { ConversationsReducer } from './lib/streaming/reducers/ConversationsReducer';
-export type { ConversationSummary } from './lib/streaming/reducers/ConversationsReducer';
-export { EndpointsReducer } from './lib/streaming/reducers/EndpointsReducer';
-export type { EndpointSummary } from './lib/streaming/reducers/EndpointsReducer';
-export { TcpStreamReducer } from './lib/streaming/reducers/TcpStreamReducer';
-export type { RttSample, TcpStreamDiagnostic } from './lib/streaming/reducers/TcpStreamReducer';
-export { reduceReducer, groupByReducer } from './lib/streaming/reducers/ReducerFactories';
-export { parseFilter, matchesFilter, matchesIndexed, indexableEval } from './lib/streaming/filter/FilterExpression';
-export type { FilterExpression, FilterPredicate } from './lib/streaming/filter/FilterExpression';
+export { ConversationsReducer } from './reducers/ConversationsReducer';
+export type { ConversationSummary } from './reducers/ConversationsReducer';
+export { EndpointsReducer } from './reducers/EndpointsReducer';
+export type { EndpointSummary } from './reducers/EndpointsReducer';
+export { TcpStreamReducer } from './reducers/TcpStreamReducer';
+export type { RttSample, TcpStreamDiagnostic } from './reducers/TcpStreamReducer';
+export { reduceReducer, groupByReducer } from './reducers/ReducerFactories';
+export { parseFilter, matchesFilter, matchesIndexed, indexableEval } from './filter/FilterExpression';
+export type { FilterExpression, FilterPredicate } from './filter/FilterExpression';
+/**
+ * Error classes (all extend NetKittyError)
+ */
+export { AnalysisStateError } from './errors/AnalysisStateError';

package/dist/index.js

@@ -1,27 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.indexableEval = exports.matchesIndexed = exports.matchesFilter = exports.parseFilter = exports.groupByReducer = exports.reduceReducer = exports.TcpStreamReducer = exports.EndpointsReducer = exports.ConversationsReducer = exports.Analysis = void 0;
+exports.AnalysisStateError = exports.indexableEval = exports.matchesIndexed = exports.matchesFilter = exports.parseFilter = exports.groupByReducer = exports.reduceReducer = exports.TcpStreamReducer = exports.EndpointsReducer = exports.ConversationsReducer = exports.Analysis = void 0;
 /**
  * Streaming capture-file analysis — the Analysis facade over a single worker, pluggable reducers, a
  * display filter, and the pluggable backend seams. node (worker_threads) and browser (Web Worker)
  * share one environment-agnostic API, verified field-for-field in both.
  */
-var Analysis_1 = require("./lib/streaming/Analysis");
+var Analysis_1 = require("./Analysis");
 Object.defineProperty(exports, "Analysis", { enumerable: true, get: function () { return Analysis_1.Analysis; } });
 /**
  * Built-in reducers (exported, not baked into Analysis) — attach them for Wireshark-style stats.
  */
-var ConversationsReducer_1 = require("./lib/streaming/reducers/ConversationsReducer");
+var ConversationsReducer_1 = require("./reducers/ConversationsReducer");
 Object.defineProperty(exports, "ConversationsReducer", { enumerable: true, get: function () { return ConversationsReducer_1.ConversationsReducer; } });
-var EndpointsReducer_1 = require("./lib/streaming/reducers/EndpointsReducer");
+var EndpointsReducer_1 = require("./reducers/EndpointsReducer");
 Object.defineProperty(exports, "EndpointsReducer", { enumerable: true, get: function () { return EndpointsReducer_1.EndpointsReducer; } });
-var TcpStreamReducer_1 = require("./lib/streaming/reducers/TcpStreamReducer");
+var TcpStreamReducer_1 = require("./reducers/TcpStreamReducer");
 Object.defineProperty(exports, "TcpStreamReducer", { enumerable: true, get: function () { return TcpStreamReducer_1.TcpStreamReducer; } });
-var ReducerFactories_1 = require("./lib/streaming/reducers/ReducerFactories");
+var ReducerFactories_1 = require("./reducers/ReducerFactories");
 Object.defineProperty(exports, "reduceReducer", { enumerable: true, get: function () { return ReducerFactories_1.reduceReducer; } });
 Object.defineProperty(exports, "groupByReducer", { enumerable: true, get: function () { return ReducerFactories_1.groupByReducer; } });
-var FilterExpression_1 = require("./lib/streaming/filter/FilterExpression");
+var FilterExpression_1 = require("./filter/FilterExpression");
 Object.defineProperty(exports, "parseFilter", { enumerable: true, get: function () { return FilterExpression_1.parseFilter; } });
 Object.defineProperty(exports, "matchesFilter", { enumerable: true, get: function () { return FilterExpression_1.matchesFilter; } });
 Object.defineProperty(exports, "matchesIndexed", { enumerable: true, get: function () { return FilterExpression_1.matchesIndexed; } });
 Object.defineProperty(exports, "indexableEval", { enumerable: true, get: function () { return FilterExpression_1.indexableEval; } });
+/**
+ * Error classes (all extend NetKittyError)
+ */
+var AnalysisStateError_1 = require("./errors/AnalysisStateError");
+Object.defineProperty(exports, "AnalysisStateError", { enumerable: true, get: function () { return AnalysisStateError_1.AnalysisStateError; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@netkitty/analysis",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Streaming cross-packet network analysis over the netkitty codec: TCP stream reassembly, flow tracking and Wireshark-style follow-stream, off a worker.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -51,8 +51,9 @@
     "typescript": "^5.8.2"
   },
   "dependencies": {
-    "@netkitty/codec": "^1.0.0",
-    "@netkitty/pcap-core": "^1.0.0"
+    "@netkitty/codec": "^1.2.0",
+    "@netkitty/errors": "^1.2.0",
+    "@netkitty/pcap-core": "^1.2.0"
   },
   "repository": {
     "type": "git",
@@ -61,5 +62,5 @@
   },
   "homepage": "https://github.com/myq1991/netkitty/tree/main/packages/analysis#readme",
   "bugs": "https://github.com/myq1991/netkitty/issues",
-  "gitHead": "d71e793d2017c0f207f7b829adfcce11b56fe7ee"
+  "gitHead": "52958b705354ac379a1a6d90a3955773c190d65a"
 }