madeonsol-x402 4.2.0 → 4.3.0

package/dist/terminal.js

@@ -0,0 +1,52 @@
+import { createTerminalTokenView } from "./terminal-watch.js";
+/**
+ * The existing stream's public `on` overloads use specific event signatures.
+ * Narrowly adapt those overloads to the small event-port used by the shared
+ * controller, without changing stream/client behavior.
+ *
+ * Exported for BROWSER terminals that must not hold an API key: pair it with
+ * `createTerminalTokenView({ stream: terminalStreamPort(stream), read })`, where
+ * `stream` gets its short-lived token from your backend (`getToken`) and `read`
+ * calls your backend, which calls the keyed intelligence endpoint.
+ */
+export function terminalStreamPort(stream) {
+    const listenerPort = stream;
+    return {
+        subscribe({ subId, channels, filters }) {
+            stream.subscribe({ subId, channels: channels, filters });
+        },
+        unsubscribe(subId) { stream.unsubscribe(subId); },
+        on(event, listener) { listenerPort.on(event, listener); },
+        off(event, listener) { listenerPort.off(event, listener); },
+    };
+}
+/** Creates an active, terminal-scoped view; returns a handle with dispose(). */
+export function createSolanaTerminalWatch(client, mint, options) {
+    if (!options || !options.stream)
+        throw new Error("shared_stream_required");
+    if (!options.subId || !/^[A-Za-z0-9_.-]{1,64}$/.test(options.subId) || options.subId === "default") {
+        throw new Error("unique_named_sub_id_required");
+    }
+    // A named subscribe REPLACES that subId's filters on the server. Never allow
+    // a different terminal widget to silently commandeer an existing watch.
+    if (options.stream.getSubscriptions().some(sub => sub.subId === options.subId)) {
+        throw new Error("named_sub_id_already_in_use");
+    }
+    const watch = createTerminalTokenView({
+        chain: "solana",
+        address: mint,
+        tier: options.tier,
+        include: options.include,
+        includeKolBroadcast: options.includeKolBroadcast,
+        subId: options.subId,
+        stream: terminalStreamPort(options.stream),
+        read: modules => client.tokenIntelligence(mint, { include: [...modules] }),
+        onChange: options.onChange,
+        onLive: options.onLive,
+        minModuleRefreshMs: options.minModuleRefreshMs,
+        debounceMs: options.debounceMs,
+    });
+    watch.start();
+    return watch;
+}
+//# sourceMappingURL=terminal.js.map

package/dist/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,uBAAuB,EACe,MAAM,qBAAqB,CAAC;AAsB3E;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAuB;IACxD,MAAM,YAAY,GAAG,MAGpB,CAAC;IACF,OAAO;QACL,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE;YACpC,MAAM,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAA2B,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,WAAW,CAAC,KAAK,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjD,EAAE,CAAC,KAAK,EAAE,QAAQ,IAAI,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzD,GAAG,CAAC,KAAK,EAAE,QAAQ,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,yBAAyB,CACvC,MAAqB,EACrB,IAAY,EACZ,OAAmC;IAEnC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC3E,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACnG,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IACD,6EAA6E;IAC7E,wEAAwE;IACxE,IAAI,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/E,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,KAAK,GAAG,uBAAuB,CAAC;QACpC,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAoC;QACrD,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;QAChD,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC;QAC1C,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAgC,EAAE,CAAC;QACzG,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/types.d.ts

@@ -3942,7 +3942,7 @@ export interface TokenLocksSummary {
     active_cancelable_by_sender: number;
 }
 /** Panels a terminal can ask for. There is no default set: name every module you render. */
-export type TokenIntelligenceModuleId = "snapshot" | "risk" | "buyer_quality" | "holders" | "flow" | "kol" | "locks" | "top_traders";
+export type TokenIntelligenceModuleId = "snapshot" | "risk" | "buyer_quality" | "holders" | "holder_count" | "flow" | "kol" | "locks" | "top_traders";
 /** Per-module outcome; a non-ready module never carries `data` (a failure is never a zero). */
 export type TokenIntelligenceModuleStatus = "ready" | "partial_history" | "unverified" | "unavailable" | "timeout";
 /** Query params for GET /tokens/{mint}/intelligence (and the RHC twin). */
@@ -3950,8 +3950,11 @@ export interface TokenIntelligenceParams {
     /**
      * Required. Modules as an array or a comma-separated string. Budget: at most
      * 5 modules and total cost 8 (snapshot 2, risk 2, buyer_quality 2, holders 3,
-     * flow 3, kol 1, locks 1, top_traders 2); over budget is HTTP 400
+     * holder_count 1, flow 3, kol 1, locks 1, top_traders 2); over budget is HTTP 400
      * `include_budget_exceeded` before any read. `holders` is opt-in only.
+     * `holder_count` (Solana) is the last complete holder census, stored: `ready`
+     * when fresh, `unverified` (`stale_measurement`) with the count and its
+     * `as_of` when older, `unavailable` (`not_measured`) when unknown (never 0).
      */
     include: readonly TokenIntelligenceModuleId[] | string;
 }