@kar-mi/spirit-vale-tools-market 2.0.0

package/README.md

@@ -0,0 +1,46 @@
+# @kar-mi/spirit-vale-tools-market
+
+Spirit Vale market decoding and replay utilities.
+
+## Install
+
+```sh
+bun add @kar-mi/spirit-vale-tools-market
+```
+
+## Usage
+
+```ts
+import { FishNetMarketTracker } from "@kar-mi/spirit-vale-tools-market";
+
+const tracker = new FishNetMarketTracker();
+
+// packet: DecodedFishNetPacket from @kar-mi/spirit-vale-tools-capture
+tracker.consume(packet);
+
+const listings = tracker.query({ text: "sword", statMode: "all" });
+for (const listing of listings) {
+  console.log(listing.displayName, listing.shopName);
+}
+```
+
+The tracker understands fresh and cursor-based search pages, overview and
+collection results, vending-stall lifecycle events, and stall listing details.
+It accepts only RPCs resolved against the supported build. Numeric identifiers,
+prices, versions, and timestamps that use 64-bit wire values remain `bigint`.
+
+Use `replayMarketCapture` to rebuild tracker state from a recorded log session
+and `MarketSessionLogFollower` to follow a live session — either by polling it,
+or by iterating it (`MarketSessionLogFollower.watch()`), which wakes on a
+filesystem event instead of a timer and yields only batches that carry
+something. Call `close()` when done.
+
+Serialized market events retain `sellerDisplayName` for presentation but omit
+`sellerAccountId`. A decoded log event represents the omitted identifier as
+`null`. Stall events likewise omit `accountId` and `visualSnapshotJson`; the
+derived `archetype` is omitted as well. Decoded logs represent these redacted
+stall fields as `null`. Item `compatibilityFingerprint` and
+`payloadSchemaVersion` values are emitted once in a `market.metadata` record,
+then omitted from individual listings and represented as `null` when decoded.
+
+See the [package guide](https://github.com/kar-mi/spirit-vale-tools/blob/main/docs/packages.md) for registry setup and usage.

package/dist/event-log.d.ts

@@ -0,0 +1,7 @@
+import type { JsonObject } from "@kar-mi/spirit-vale-tools-logging";
+import type { FishNetMarketEvent } from "./market.ts";
+export declare function marketEventLogData(event: FishNetMarketEvent): JsonObject;
+/** Collects unique item-payload metadata for one session-level `market.metadata` record. */
+export declare function marketLogMetadataData(value: unknown): JsonObject | undefined;
+export declare function parseMarketEventLogData(value: unknown): FishNetMarketEvent | undefined;
+//# sourceMappingURL=event-log.d.ts.map

package/dist/event-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.d.ts","sourceRoot":"","sources":["../src/event-log.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAA2C,MAAM,aAAa,CAAC;AAE/F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,UAAU,CAMxE;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAS5E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CA4DtF"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { catalogItemType, decodeFishNetMarketPacket, FishNetMarketTracker, marketListingKey, parseFishNetMarketStats, queryFishNetMarketListings, resolveFishNetMarketListingDisplayName, } from "./market.ts";
+export { MarketLogFollower, MarketSessionLogFollower } from "./live-log.ts";
+export type { MarketLogBatch, MarketLogStatus, MarketSessionLogFollowerOptions } from "./live-log.ts";
+export { decodeMarketCaptureJsonLines, replayMarketCapture } from "./replay.ts";
+export type { MarketReplayResult } from "./replay.ts";
+export { marketEventLogData, marketLogMetadataData, parseMarketEventLogData } from "./event-log.ts";
+export { FISHNET_MARKET_STAT_NAMES, fishNetMarketStatName, parseFishNetMarketStatExpression, resolveFishNetMarketStat, } from "./market-stats.ts";
+export type { FishNetMarketStatName, ResolvedFishNetMarketStat } from "./market-stats.ts";
+export type { FishNetMarketCollectable, FishNetMarketEvent, FishNetMarketItem, FishNetMarketListing, FishNetMarketListingView, FishNetMarketOverview, FishNetMarketQuery, FishNetMarketSale, FishNetMarketSearchPage, FishNetMarketSearchRequest, FishNetMarketSearchState, FishNetMarketSnapshot, FishNetMarketStall, FishNetMarketStallStatus, FishNetMarketStat, FishNetMarketStatFilter, FishNetMarketTrackerOptions, } from "./market.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC1B,sCAAsC,GACvC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAC5E,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,+BAA+B,EAAE,MAAM,eAAe,CAAC;AACtG,OAAO,EAAE,4BAA4B,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAChF,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACpG,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,gCAAgC,EAChC,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,YAAY,EACV,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,aAAa,CAAC"}