@meshconnect/uwc-types 0.16.0 → 0.16.1-snapshot.8e3fd6b

package/dist/index.d.ts

@@ -12,4 +12,5 @@ export * from './signature';
 export * from './transactions';
 export * from './errors';
 export * from './solana-message';
+export * from './observability';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA"}

package/dist/index.js

@@ -12,4 +12,5 @@ export * from './signature';
 export * from './transactions';
 export * from './errors';
 export * from './solana-message';
+export * from './observability';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA"}

package/dist/observability.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Vendor-agnostic observability primitives for the Universal Wallet Connector.
+ *
+ * These are leaf types — no dependency on the core event bus — so any package
+ * (including consumers below UWC in the dep graph, e.g. link-v2) can import them
+ * without pulling in `@meshconnect/uwc-core`. The richer `UWCTelemetryEvent` /
+ * `UWCObserver` shapes live in `@meshconnect/uwc-core` because they reference the
+ * core event names.
+ *
+ * UWC ships NO third-party telemetry SDK. The consumer implements the sinks and
+ * wires them to whatever backend they run (Datadog, Amplitude, Segment, …).
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Pluggable logger. The default implementation (`createLogger`) is console-backed
+ * and level-gated; inject your own to redirect UWC's internal logging into your
+ * stack. Kept to the four standard levels so a consumer's existing logger usually
+ * satisfies it without an adapter.
+ */
+export interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Canonical wallet-handoff flow taxonomy.
+ *
+ * UWC is the single owner of this union so the two consumer layers (link-v2 and
+ * v3) don't drift. The string values are deliberately frozen to match link-v2's
+ * historical `wallet_flow_type` wire values so existing RUM / Segment facets keep
+ * matching after a consumer switches to importing this type — this is a
+ * lift-and-canonicalize, not a rename.
+ *
+ * Note: UWC's own `deriveWalletFlowType` only produces the extension / WC / TON /
+ * in-wallet / unknown values. The `dapp_*` members are part of the frozen wire
+ * taxonomy but are set only by a consumer with richer context — forward-compat,
+ * not dead code.
+ */
+export type WalletFlowType = 'browser_extension_flow' | 'wallet_connect_deep_link_flow' | 'wallet_connect_qr_flow' | 'dapp_deep_link_flow' | 'dapp_qr_flow' | 'ton_connect_qr_flow' | 'ton_connect_deep_link_flow' | 'in_wallet_browser_flow' | 'unknown';
+/**
+ * Coarse runtime surface. Intentionally a small enum — never a raw user-agent
+ * string, which is PII and high-cardinality. Used to decide whether mobile-only
+ * heuristics (e.g. focus bracketing) apply to a handoff.
+ */
+export type Platform = 'mobile' | 'desktop' | 'webview' | 'unknown';
+//# sourceMappingURL=observability.d.ts.map

package/dist/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CACjD;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,cAAc,GACtB,wBAAwB,GACxB,+BAA+B,GAC/B,wBAAwB,GACxB,qBAAqB,GACrB,cAAc,GACd,qBAAqB,GACrB,4BAA4B,GAC5B,wBAAwB,GACxB,SAAS,CAAA;AAEb;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA"}

package/dist/observability.js

@@ -0,0 +1,14 @@
+/**
+ * Vendor-agnostic observability primitives for the Universal Wallet Connector.
+ *
+ * These are leaf types — no dependency on the core event bus — so any package
+ * (including consumers below UWC in the dep graph, e.g. link-v2) can import them
+ * without pulling in `@meshconnect/uwc-core`. The richer `UWCTelemetryEvent` /
+ * `UWCObserver` shapes live in `@meshconnect/uwc-core` because they reference the
+ * core event names.
+ *
+ * UWC ships NO third-party telemetry SDK. The consumer implements the sinks and
+ * wires them to whatever backend they run (Datadog, Amplitude, Segment, …).
+ */
+export {};
+//# sourceMappingURL=observability.js.map

package/dist/observability.js.map

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

package/dist/tron-connector.d.ts

@@ -29,16 +29,23 @@ export interface TronGridConfig {
  * `UniversalWalletConnector` once the core wiring lands; until then it is
  * supplied directly when constructing a `TronConnector`.
  *
- * The `enabledWallets` set is the per-wallet feature-flag surface: it gates
- * both discovery and connect dispatch, so a single wallet can be ramped up or
- * disabled in production independently of the others. Passing an empty set/array
- * effectively disables the connector.
+ * The `enabledWallets` set is an OPTIONAL per-wallet feature-flag surface. When
+ * omitted, the connector is fully catalog-driven: every wallet whose metadata
+ * declares a `namespaceMetaData.tron.injectedId` is enabled — the backend
+ * (Retool) is the single source of truth. Provide it only to gate a subset, so a
+ * single wallet can be ramped up or disabled in production independently of the
+ * others. Passing an empty set/array enables nothing (disables the connector).
  */
 export interface TronConnectorConfig {
     /**
-     * Wallets to enable, matched against each wallet's `WalletMetadata.id` or its
-     * `namespaceMetaData.tron.injectedId` (case-insensitive). Wallets not enabled
-     * are neither surfaced by `getAvailableWallets` nor connectable.
+     * Optional allow-list of wallets to enable, matched against each wallet's
+     * `WalletMetadata.id` or its `namespaceMetaData.tron.injectedId`
+     * (case-insensitive). Wallets not enabled are neither surfaced by
+     * `getAvailableWallets` nor connectable.
+     *
+     * **Omit it** to enable every wallet the passed-in metadata marks Tron-capable
+     * (the recommended, catalog-driven default — consumers then need no hardcoded
+     * wallet list). An **empty** set/array enables nothing.
      *
      * Matching by `WalletMetadata.id` requires the wallet metadata to be available
      * — i.e. `getAvailableWallets` is called with `expectedWallets` (the standard
@@ -46,7 +53,7 @@ export interface TronConnectorConfig {
      * without `expectedWallets` has only the configured keys to go on, so those
      * keys must be **injectedIds** (e.g. `tronLink`, not `tronlink`).
      */
-    enabledWallets: ReadonlySet<TronWalletId> | readonly TronWalletId[];
+    enabledWallets?: ReadonlySet<TronWalletId> | readonly TronWalletId[];
     /** Full-node endpoints, API key, and TRC20 fee limit. */
     tronGrid?: TronGridConfig;
     /** Timeout (ms) for the per-wallet injection probe during `connect()`. Default: 3000. */

package/dist/tron-connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tron-connector.d.ts","sourceRoot":"","sources":["../src/tron-connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAA;AAEjC,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA;IAC9C,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;OAUG;IACH,cAAc,EAAE,WAAW,CAAC,YAAY,CAAC,GAAG,SAAS,YAAY,EAAE,CAAA;IAEnE,yDAAyD;IACzD,QAAQ,CAAC,EAAE,cAAc,CAAA;IAEzB,yFAAyF;IACzF,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAE5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAE3B,8DAA8D;IAC9D,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAClC"}
+{"version":3,"file":"tron-connector.d.ts","sourceRoot":"","sources":["../src/tron-connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAA;AAEjC,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA;IAC9C,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,GAAG,SAAS,YAAY,EAAE,CAAA;IAEpE,yDAAyD;IACzD,QAAQ,CAAC,EAAE,cAAc,CAAA;IAEzB,yFAAyF;IACzF,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAE5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAE3B,8DAA8D;IAC9D,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAClC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshconnect/uwc-types",
-  "version": "0.16.0",
+  "version": "0.16.1-snapshot.8e3fd6b",
   "description": "TypeScript types for Universal Wallet Connector",
   "type": "module",
   "main": "dist/index.js",

package/src/index.ts

@@ -12,3 +12,4 @@ export * from './signature'
 export * from './transactions'
 export * from './errors'
 export * from './solana-message'
+export * from './observability'

package/src/observability.ts

@@ -0,0 +1,59 @@
+/**
+ * Vendor-agnostic observability primitives for the Universal Wallet Connector.
+ *
+ * These are leaf types — no dependency on the core event bus — so any package
+ * (including consumers below UWC in the dep graph, e.g. link-v2) can import them
+ * without pulling in `@meshconnect/uwc-core`. The richer `UWCTelemetryEvent` /
+ * `UWCObserver` shapes live in `@meshconnect/uwc-core` because they reference the
+ * core event names.
+ *
+ * UWC ships NO third-party telemetry SDK. The consumer implements the sinks and
+ * wires them to whatever backend they run (Datadog, Amplitude, Segment, …).
+ */
+
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error'
+
+/**
+ * Pluggable logger. The default implementation (`createLogger`) is console-backed
+ * and level-gated; inject your own to redirect UWC's internal logging into your
+ * stack. Kept to the four standard levels so a consumer's existing logger usually
+ * satisfies it without an adapter.
+ */
+export interface Logger {
+  debug(message: string, ...args: unknown[]): void
+  info(message: string, ...args: unknown[]): void
+  warn(message: string, ...args: unknown[]): void
+  error(message: string, ...args: unknown[]): void
+}
+
+/**
+ * Canonical wallet-handoff flow taxonomy.
+ *
+ * UWC is the single owner of this union so the two consumer layers (link-v2 and
+ * v3) don't drift. The string values are deliberately frozen to match link-v2's
+ * historical `wallet_flow_type` wire values so existing RUM / Segment facets keep
+ * matching after a consumer switches to importing this type — this is a
+ * lift-and-canonicalize, not a rename.
+ *
+ * Note: UWC's own `deriveWalletFlowType` only produces the extension / WC / TON /
+ * in-wallet / unknown values. The `dapp_*` members are part of the frozen wire
+ * taxonomy but are set only by a consumer with richer context — forward-compat,
+ * not dead code.
+ */
+export type WalletFlowType =
+  | 'browser_extension_flow'
+  | 'wallet_connect_deep_link_flow'
+  | 'wallet_connect_qr_flow'
+  | 'dapp_deep_link_flow'
+  | 'dapp_qr_flow'
+  | 'ton_connect_qr_flow'
+  | 'ton_connect_deep_link_flow'
+  | 'in_wallet_browser_flow'
+  | 'unknown'
+
+/**
+ * Coarse runtime surface. Intentionally a small enum — never a raw user-agent
+ * string, which is PII and high-cardinality. Used to decide whether mobile-only
+ * heuristics (e.g. focus bracketing) apply to a handoff.
+ */
+export type Platform = 'mobile' | 'desktop' | 'webview' | 'unknown'

package/src/tron-connector.ts

@@ -32,16 +32,23 @@ export interface TronGridConfig {
  * `UniversalWalletConnector` once the core wiring lands; until then it is
  * supplied directly when constructing a `TronConnector`.
  *
- * The `enabledWallets` set is the per-wallet feature-flag surface: it gates
- * both discovery and connect dispatch, so a single wallet can be ramped up or
- * disabled in production independently of the others. Passing an empty set/array
- * effectively disables the connector.
+ * The `enabledWallets` set is an OPTIONAL per-wallet feature-flag surface. When
+ * omitted, the connector is fully catalog-driven: every wallet whose metadata
+ * declares a `namespaceMetaData.tron.injectedId` is enabled — the backend
+ * (Retool) is the single source of truth. Provide it only to gate a subset, so a
+ * single wallet can be ramped up or disabled in production independently of the
+ * others. Passing an empty set/array enables nothing (disables the connector).
  */
 export interface TronConnectorConfig {
   /**
-   * Wallets to enable, matched against each wallet's `WalletMetadata.id` or its
-   * `namespaceMetaData.tron.injectedId` (case-insensitive). Wallets not enabled
-   * are neither surfaced by `getAvailableWallets` nor connectable.
+   * Optional allow-list of wallets to enable, matched against each wallet's
+   * `WalletMetadata.id` or its `namespaceMetaData.tron.injectedId`
+   * (case-insensitive). Wallets not enabled are neither surfaced by
+   * `getAvailableWallets` nor connectable.
+   *
+   * **Omit it** to enable every wallet the passed-in metadata marks Tron-capable
+   * (the recommended, catalog-driven default — consumers then need no hardcoded
+   * wallet list). An **empty** set/array enables nothing.
    *
    * Matching by `WalletMetadata.id` requires the wallet metadata to be available
    * — i.e. `getAvailableWallets` is called with `expectedWallets` (the standard
@@ -49,7 +56,7 @@ export interface TronConnectorConfig {
    * without `expectedWallets` has only the configured keys to go on, so those
    * keys must be **injectedIds** (e.g. `tronLink`, not `tronlink`).
    */
-  enabledWallets: ReadonlySet<TronWalletId> | readonly TronWalletId[]
+  enabledWallets?: ReadonlySet<TronWalletId> | readonly TronWalletId[]
 
   /** Full-node endpoints, API key, and TRC20 fee limit. */
   tronGrid?: TronGridConfig