@gala-chain/launchpad-sdk 8.0.2 → 9.0.0-rc.0

package/dist/utils/tokenNormalizer.d.ts

@@ -4,8 +4,8 @@
  * This module provides utilities for normalizing different token identifier formats
  * into a consistent TokenInstanceKey format that can be used with GalaChain APIs.
  */
-import type { TokenClassKey, TokenId, TokenInstanceKey } from '../types/common';
-import { isTokenClassKey as isTokenClassKeyStrict } from './token-parser';
+import { type GalaChainTokenClassKey, type GalaChainTokenInstanceKey } from '@gala-chain/gala-core-sdk';
+import type { TokenId } from '../types/common';
 /**
  * Normalizes any token identifier format to TokenInstanceKey
  *
@@ -39,31 +39,7 @@ import { isTokenClassKey as isTokenClassKeyStrict } from './token-parser';
  * // → Same object returned
  * ```
  */
-export declare function normalizeToTokenInstanceKey(tokenId: TokenId): TokenInstanceKey;
-/**
- * Type guard to check if a TokenId is a TokenInstanceKey object
- *
- * @param tokenId Token identifier to check
- * @returns True if tokenId is a TokenInstanceKey object
- */
-export declare function isTokenInstanceKey(tokenId: TokenId): tokenId is TokenInstanceKey;
-/**
- * Strict type guard that validates all TokenClassKey fields are non-empty strings.
- *
- * Re-export of `isTokenClassKey` from `./token-parser` for convenience.
- * This is the recommended function for validating TokenClassKey objects.
- *
- * @see isTokenClassKey from './token-parser' for the canonical implementation
- * @since 6.6.1
- */
-export { isTokenClassKeyStrict };
-/**
- * Type guard to check if a TokenId is a string
- *
- * @param tokenId Token identifier to check
- * @returns True if tokenId is a string
- */
-export declare function isTokenIdString(tokenId: TokenId): tokenId is string;
+export declare function normalizeToTokenInstanceKey(tokenId: TokenId): GalaChainTokenInstanceKey;
 /**
  * Validates that a TokenId has all required fields
  *
@@ -94,7 +70,7 @@ export declare function validateTokenId(tokenId: TokenId): void;
  *
  * @since 3.32.0
  */
-export declare function parseVaultAddressToTokenClassKey(vaultAddress: string): TokenClassKey;
+export declare function parseVaultAddressToTokenClassKey(vaultAddress: string): GalaChainTokenClassKey;
 /**
  * Parses a vault address into a TokenInstanceKey
  *
@@ -115,7 +91,7 @@ export declare function parseVaultAddressToTokenClassKey(vaultAddress: string):
  *
  * @since 3.32.0
  */
-export declare function parseVaultAddressToTokenInstance(vaultAddress: string): TokenInstanceKey;
+export declare function parseVaultAddressToTokenInstance(vaultAddress: string): GalaChainTokenInstanceKey;
 /**
  * Extracts the launchpad token symbol (carried in `type` of the shared `Token` collection) from a
  * launchpad vault address. Throws for any other collection: a symbol cannot be derived from a class key.

package/dist/utils/tokenNormalizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenNormalizer.d.ts","sourceRoot":"","sources":["../../src/utils/tokenNormalizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAIhF,OAAO,EAEL,eAAe,IAAI,qBAAqB,EAEzC,MAAM,gBAAgB,CAAC;AAGxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAsE9E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,gBAAgB,CAOhF;AAED;;;;;;;;GAQG;AACH,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,MAAM,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CActD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gCAAgC,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,CAGpF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gCAAgC,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,CAMvF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAYxE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAMjE"}
+{"version":3,"file":"tokenNormalizer.d.ts","sourceRoot":"","sources":["../../src/utils/tokenNormalizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC/B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAO/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,yBAAyB,CAsEvF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CActD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gCAAgC,CAAC,YAAY,EAAE,MAAM,GAAG,sBAAsB,CAG7F;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gCAAgC,CAAC,YAAY,EAAE,MAAM,GAAG,yBAAyB,CAMhG;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAYxE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAMjE"}

package/dist/utils/trade-quote.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Trade quote wire format.
+ *
+ * The launchpad backend (`GET /v1/trading/quote`, `/v1/trading/premint-quote`) answers with the
+ * chain's own quote shape, `{ calculatedQuantity, extraFees: { reverseBondingCurve, transactionFees } }`.
+ * The SDK's public {@link AmountCalculationResult} is `{ amount, reverseBondingCurveFee,
+ * transactionFee, gasFee }`, which is also what the local bonding-curve calculator returns.
+ * Every quote read goes through {@link toAmountCalculationResult} so the declared type, the
+ * runtime value and the documentation are the same shape in every calculation mode.
+ *
+ * @packageDocumentation
+ */
+import type { AmountCalculationResult } from '../types/launchpad.dto';
+/** The quote shape the launchpad backend returns on the wire. */
+export interface TradeQuoteWire {
+    calculatedQuantity: string;
+    extraFees: {
+        reverseBondingCurve: string;
+        transactionFees: string;
+    };
+}
+/** Narrow an unknown backend value to the quote wire shape. */
+export declare function isTradeQuoteWire(value: unknown): value is TradeQuoteWire;
+/**
+ * Convert a backend quote into the SDK's declared {@link AmountCalculationResult}.
+ *
+ * @param wire - The `data` of a `/v1/trading/quote` or `/v1/trading/premint-quote` response
+ * @param context - What was being quoted, used in the error message
+ * @throws NetworkError when the backend answers with anything other than the quote shape
+ */
+export declare function toAmountCalculationResult(wire: unknown, context: string): AmountCalculationResult;
+//# sourceMappingURL=trade-quote.d.ts.map

package/dist/utils/trade-quote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade-quote.d.ts","sourceRoot":"","sources":["../../src/utils/trade-quote.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAGtE,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE;QACT,mBAAmB,EAAE,MAAM,CAAC;QAC5B,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAMD,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAUxE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,uBAAuB,CAUjG"}

package/dist/utils/unique-key-generator.d.ts

@@ -1,147 +1,20 @@
 /**
- * GalaChain Unique Operation Key Generator
+ * The uniqueKey of a launchpad bundle trade (BundleService buy/sell).
  *
- * Generates unique identifiers for GalaChain bundle transactions and operations
- * that require idempotency keys. Consolidated from 14+ duplicated patterns across
- * transfer and lock/unlock operations.
+ * A generic GalaChain uniqueKey is gala-core-sdk's `createUniqueKey(prefix)` (CSPRNG,
+ * `<prefix><uuid v4>`); launchpad-sdk 9.0 removed its own `generateUniqueKey`, which duplicated it.
  *
  * @category Utilities
  * @since 6.14.0
  */
 /**
- * Generate a unique operation key for GalaChain bundle transactions.
- *
- * Creates a deterministic yet unique identifier combining:
- * - Timestamp (millisecond precision)
- * - Cryptographically random suffix (derived from a UUID v4, ~104 bits of entropy)
- *
- * Format: `galaconnect-operation-{timestamp}_{randomSuffix}`
- *
- * Used for idempotency across:
- * - Token transfers (uniqueKey parameter)
- * - Token locks/unlocks (uniqueKey parameter)
- * - Token burns (uniqueKey parameter)
- * - Any operation requiring request deduplication
- *
- * @returns Unique operation key in format `galaconnect-operation-{timestamp}_{randomSuffix}`
- *
- * @example Basic usage
- * ```typescript
- * import { generateUniqueKey } from '@gala-chain/launchpad-sdk';
- *
- * const key = generateUniqueKey();
- * console.log(key); // 'galaconnect-operation-1735857234567_abc123'
- *
- * // Use in transfer operation
- * await sdk.transferGala({
- *   recipientAddress: 'eth|0x...',
- *   amount: '100',
- *   uniqueKey: generateUniqueKey()
- * });
- * ```
- *
- * @example With explicit key
- * ```typescript
- * // For operations where you control the idempotency key
- * const operationKey = `my-operation-${Date.now()}`;
- * await sdk.transferToken({
- *   to: 'eth|0x...',
- *   tokenName: 'anime',
- *   amount: '1000',
- *   uniqueKey: operationKey
- * });
- * ```
- *
- * @see {@link https://docs.galachain.com/idempotency GalaChain Idempotency}
- */
-export declare function generateUniqueKey(): string;
-/**
- * Generate a unique operation key for GalaSwap bundle (buy/sell) transactions.
- *
- * Same shape and entropy guarantees as {@link generateUniqueKey}, but uses the
- * `galaswap-operation-` prefix GalaSwap trade operations are identified by
- * (`UNIQUE_KEY_CONSTRAINT.PATTERN` accepts either prefix).
+ * Generate a unique operation key for GalaSwap bundle (buy/sell) transactions:
+ * `galaswap-operation-{timestamp}_{randomSuffix}`, the suffix 26 hex digits of a UUID v4
+ * (~104 bits; never `Math.random()`: a collision would let GalaChain treat two different trades as
+ * retries of one), within `UNIQUE_KEY_CONSTRAINT.MAX_LENGTH` (64) and its `PATTERN`.
  *
  * @returns Unique operation key in format `galaswap-operation-{timestamp}_{randomSuffix}`
  * @since 6.14.0
  */
 export declare function generateSwapOperationKey(): string;
-/**
- * Generate unique operation key with UUID, timestamp, and wallet address
- *
- * Creates a unique identifier for GalaSwap operations combining:
- * - Prefix (customizable, defaults to 'galaswap-operation')
- * - UUID v4 for global uniqueness
- * - Timestamp (millisecond precision)
- * - Wallet address for context
- *
- * Format: `{prefix}-${uuid}-${timestamp}-${walletAddress}`
- *
- * Used for idempotent GalaSwap operations including:
- * - Liquidity additions (add/remove)
- * - Swap executions
- * - Fee collections
- * - Bundle transactions
- *
- * @param walletAddress The wallet address associated with the operation (required)
- * @param prefix Optional custom prefix (defaults to 'galaswap-operation')
- * @returns Unique operation key combining UUID, timestamp, and wallet address
- *
- * @example Basic usage with default prefix
- * ```typescript
- * import { generateOperationKey } from '@gala-chain/launchpad-sdk';
- *
- * const operationKey = generateOperationKey('eth|0x1234567890abcdef...');
- * console.log(operationKey);
- * // 'galaswap-operation-550e8400-e29b-41d4-a716-446655440000-1735857234567-eth|0x1234...'
- * ```
- *
- * @example With custom prefix
- * ```typescript
- * import { generateOperationKey } from '@gala-chain/launchpad-sdk';
- *
- * const operationKey = generateOperationKey(
- *   'eth|0x1234567890abcdef...',
- *   'custom-swap'
- * );
- * console.log(operationKey);
- * // 'custom-swap-550e8400-e29b-41d4-a716-446655440000-1735857234567-eth|0x1234...'
- * ```
- *
- * @example With an operation that accepts a caller-supplied uniqueKey
- * ```typescript
- * import { generateOperationKey } from '@gala-chain/launchpad-sdk';
- *
- * // transferGala/transferToken/lockToken/unlockToken accept an optional
- * // uniqueKey for idempotency (sdk.dex.* writes generate their own internally).
- * const result = await sdk.transferGala({
- *   recipientAddress,
- *   amount: '100',
- *   uniqueKey: generateOperationKey(walletAddress),
- * });
- * ```
- *
- * @example Handling operation idempotency
- * ```typescript
- * // sdk.dex.swaps.swap() generates its own durable uniqueKey and returns it on the
- * // SubmittedTransaction, so recovering an in-flight swap replays confirmation instead
- * // of resubmitting with a caller-supplied key:
- * let submitted;
- * try {
- *   submitted = await sdk.dex.swaps.swap('GALA', 'GUSDC', 3000, {
- *     exactIn: '100',
- *     amountOutMinimum: '95',
- *   });
- *   await submitted.confirm();
- * } catch (error) {
- *   if (submitted) {
- *     // Recover by uniqueKey - does not resubmit, avoids duplicate execution
- *     await sdk.dex.swaps.confirmSwap(submitted.uniqueKey);
- *   }
- * }
- * ```
- *
- * @since 3.50.0
- */
-export declare function generateOperationKey(walletAddress: string, prefix?: string): string;
 //# sourceMappingURL=unique-key-generator.d.ts.map

package/dist/utils/unique-key-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unique-key-generator.d.ts","sourceRoot":"","sources":["../../src/utils/unique-key-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoBH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4EG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,MAA6B,GACpC,MAAM,CAIR"}
+{"version":3,"file":"unique-key-generator.d.ts","sourceRoot":"","sources":["../../src/utils/unique-key-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAIjD"}

package/dist/utils/validation-helpers.d.ts

@@ -275,10 +275,8 @@ export interface MutualExclusivityResult {
 /**
  * Validates that exactly one of two parameters is provided (mutual exclusivity)
  *
- * Consolidates 12+ instances of identical validation logic found across services:
- * - PriceHistoryService: tokenName XOR tokenId (lines 451-470)
- * - DexService: Similar patterns with token identification
- * - Other services: Scattered mutual exclusivity validation
+ * Consolidates the mutual-exclusivity checks the services used to repeat (e.g. tokenName XOR
+ * tokenId for a token identification).
  *
  * ## Use Cases
  *
@@ -322,7 +320,7 @@ export interface MutualExclusivityResult {
  *
  * @example Token identifier validation
  * ```typescript
- * // PriceHistoryService.fetchAllPriceHistory() - replaces 20-line validation method
+ * // a method that takes a token by name or by id, never both
  * const { hasA } = validateMutualExclusive(options, 'tokenName', 'tokenId', {
  *   description: 'token identifier'
  * });

package/dist/utils/validation-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/validation-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAW9B,OAAO,EAAiD,YAAY,IAAI,qBAAqB,EAAE,gBAAgB,IAAI,yBAAyB,EAAE,SAAS,IAAI,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAIpM;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,qBAAqB,GACjC,IAAI,CAYN;AAGD,eAAO,MAAM,gBAAgB;;;;CAA6B,CAAC;AAC3D,eAAO,MAAM,gBAAgB,kCAA4B,CAAC;AAC1D,eAAO,MAAM,YAAY,8BAAwB,CAAC;AAClD,eAAO,MAAM,SAAS,2BAAqB,CAAC;AAI5C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,GAAE,MAAY,EACtB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CA4BN;AAED;;;GAGG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,EACvB,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,MAAe,EAC1B,SAAS,GAAE,MAAuB,GACjC,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,KAAK,IAAI,CAAC,CAUxC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAClE,OAAO,EAAE,CAAC,GACT,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAIzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzD,OAAO,EAAE,CAAC,GACT,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAEd;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,kCAAkC;IAClC,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IACP,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACvB,GACL,uBAAuB,CA8BzB;AAID,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAoB,EAC3B,UAAU,GAAE,mBAAqD,GAChE,IAAI,CA+BN;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,OAAO,EAClB,KAAK,GAAE,MAAoB,EAC3B,UAAU,GAAE,mBAAqD,GAChE,IAAI,CAyBN;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,OAAO,EAClB,UAAU,GAAE,mBAAqD,GAChE,SAAS,IAAI,MAAM,CASrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,OAAO,EAClB,KAAK,GAAE,MAAoB,EAC3B,UAAU,GAAE,mBAAqD,GAChE,IAAI,CAyBN;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iEAAiE;IACjE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EACzC,MAAM,EAAE,kBAAkB,EAAE,GAC3B,CAAC,GAAG,EAAE,OAAO,KAAK,GAAG,IAAI,CAAC,CA+B5B;AAMD,OAAO,KAAK,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAExF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;4BACqB,MAAM,MAAM,OAAO,OAAO,KAAG,MAAM,GAAG,SAAS;IAavE;;OAEG;uBACgB,MAAM,OAAO,MAAM,MAAM,OAAO,OAAO,KAAG,MAAM,GAAG,SAAS;IAa/E;;OAEG;6BACsB,MAAM,MAAM,OAAO,OAAO,KAAG,MAAM,GAAG,SAAS;IAaxE;;OAEG;qCAC8B,MAAM,MAAM,OAAO,OAAO,KAAG,MAAM,GAAG,SAAS;IAahF;;OAEG;gBACS,CAAC,SAAS,MAAM,SAAS,MAAM,eAAe,SAAS,CAAC,EAAE,MACnE,OAAO,OAAO,KAAG,MAAM,GAAG,SAAS;IAUtC;;OAEG;wBACiB,CAAC,SAAS,MAAM,SAAS,MAAM,eAAe,SAAS,CAAC,EAAE,MAC3E,OAAO,OAAO,KAAG,MAAM,GAAG,SAAS;IAUtC;;OAEG;qBACc,MAAM,MAAM,OAAO,OAAO,KAAG,MAAM,GAAG,SAAS;IAahE;;OAEG;2BACoB,MAAM,0BAAwB,OAAO,OAAO,KAAG,MAAM,GAAG,SAAS;CAiBzF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,OAAO,EAAE,oBAAoB,EAAE,GAC9B,0BAA0B,CAAC,CAAC,CAAC,CAmD/B;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,QAAkB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GACpC,IAAI,CA2BN;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,IAAI,CAaN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,IAAI,CAUN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAa7E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAIpE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,EACjD,SAAS,EAAE,MAAM,GAChB,IAAI,CAIN;AAMD;;;;;;;;;;GAUG;AAMH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAC3B,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,CAAC,CAKH;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEpE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,GAAE,MAAkB,GAAG,IAAI,CAE/E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAK9D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUlE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAYnE"}
+{"version":3,"file":"validation-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/validation-helpers.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "type": "module",
   "name": "@gala-chain/launchpad-sdk",
-  "version": "8.0.2",
-  "description": "TypeScript SDK for Gala Launchpad Backend API - 273 public methods supporting optional wallet (read-only and full-access modes). Production-ready DeFi token launchpad integration with AgentConfig setup, GalaChain trading, GSwap DEX integration, price history, token creation, DEX pool discovery, WebSocket event watchers, streaming, chat, bans, moderator invites, and comprehensive user operations. Multi-format output (ESM, CJS, UMD).",
+  "version": "9.0.0-rc.0",
+  "description": "TypeScript SDK for the Gala Launchpad backend: launchpad tokens, pools, bonding-curve trades and quotes, token creation, holders, charts, users, API keys, bans, moderation, overseers, flags, reactions, messages, notifications, streaming and stream chat, WebSocket events, the bundler write transport and auth. Optional wallet (read-only and full-access modes). Gateway-generic GalaChain pieces are @gala-chain/gala-core-sdk's (a peer); the DEX is @gala-chain/gswap-sdk's. Multi-format output (ESM, CJS, UMD).",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
   "types": "dist/index.d.ts",
@@ -15,12 +15,13 @@
     "!dist/**/*.test.*",
     "!dist/**/tests/**",
     "!dist/**/fixtures/**",
+    "!dist/setup.d.ts",
+    "!dist/setup.d.ts.map",
     "package.json",
     "README.md",
-    "API.md",
     "EXAMPLES.md",
-    "TESTING.md",
     "CHANGELOG.md",
+    "MIGRATING-TO-9.0.md",
     "LICENSE"
   ],
   "exports": {
@@ -39,18 +40,6 @@
       "import": "./dist/native.esm.js",
       "require": "./dist/native.cjs",
       "default": "./dist/native.esm.js"
-    },
-    "./wallet": {
-      "types": "./dist/wallet/index.d.ts",
-      "import": "./dist/wallet.esm.js",
-      "require": "./dist/wallet.cjs",
-      "default": "./dist/wallet.esm.js"
-    },
-    "./react": {
-      "types": "./dist/react/index.d.ts",
-      "import": "./dist/react.esm.js",
-      "require": "./dist/react.cjs",
-      "default": "./dist/react.esm.js"
     }
   },
   "sideEffects": false,
@@ -109,17 +98,12 @@
   },
   "peerDependencies": {
     "@gala-chain/api": "^3.3.0",
+    "@gala-chain/gala-core-sdk": ">=1.0.0-rc.4 <2",
     "axios": "^1.20.0",
     "bignumber.js": "^11.1.5",
     "ethers": "^6.16.0",
-    "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
     "socket.io-client": "^4.8.3",
-    "zod": "^3.25.76"
-  },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    }
+    "zod": "^4.3.6"
   },
   "browserslist": [
     "> 1%",
@@ -129,20 +113,12 @@
   ],
   "dependencies": {
     "@gala-chain/api": "^3.3.0",
-    "@gala-chain/gswap-sdk": "^1.2.0",
-    "@modelcontextprotocol/sdk": "^1.30.1",
-    "@solana/spl-token": "^0.4.15",
-    "@solana/web3.js": "^1.99.0",
     "axios": "^1.20.0",
     "bignumber.js": "^11.1.5",
-    "bs58": "^6.0.0",
-    "dotenv": "^18.0.3",
     "ethers": "^6.16.0",
-    "json-stringify-deterministic": "^1.0.16",
     "socket.io-client": "^4.8.3",
     "uuid": "^14.0.2",
-    "web-file-polyfill": "^1.0.4",
-    "zod": "^4.3.6"
+    "web-file-polyfill": "^1.0.4"
   },
   "size-limit": [
     {
@@ -192,31 +168,52 @@
     }
   ],
   "devDependencies": {
-    "@testing-library/dom": "^10.4.2",
-    "@testing-library/react": "^16.3.3",
-    "@types/react": "^19.3.0",
+    "@microsoft/api-documenter": "^7.30.16",
+    "@microsoft/api-extractor": "^7.59.2",
+    "@modelcontextprotocol/sdk": "^1.30.1",
+    "@rollup/plugin-commonjs": "^29.0.3",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-terser": "^1.0.0",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@size-limit/preset-small-lib": "^14.0.0",
+    "@solana/spl-token": "^0.4.15",
+    "@solana/web3.js": "^1.99.0",
+    "@types/node": "^26.6.2",
     "@typescript-eslint/eslint-plugin": "^8.70.1",
     "@typescript-eslint/parser": "^8.70.1",
     "@typescript/native": "npm:typescript@^7.0.2",
     "@vitest/coverage-v8": "^5.0.1",
+    "bs58": "^6.0.0",
+    "concurrently": "^10.0.5",
+    "dotenv": "^18.0.3",
     "eslint": "^10.11.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.6",
     "eslint-plugin-unused-imports": "^4.4.1",
+    "http-server": "^14.1.1",
+    "jiti": "^2.7.0",
     "jscpd": "^5.1.2",
-    "react": "^19.3.0",
-    "react-dom": "^19.3.0",
+    "jsdom": "^27.4.0",
+    "prettier": "^3.9.9",
+    "rimraf": "^6.1.2",
+    "rollup": "^4.63.4",
+    "rollup-plugin-analyzer": "^4.0.0",
+    "rollup-plugin-bundle-size": "^1.0.3",
+    "size-limit": "^14.0.0",
     "tsx": "^4.21.0",
+    "typedoc": "^0.28.20",
+    "typedoc-plugin-markdown": "^4.13.1",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
     "vite": "^8.3.0",
-    "vitest": "^5.0.1"
+    "vitest": "^5.0.1",
+    "zod": "^4.3.6",
+    "@gala-chain/gala-core-sdk": "^1.0.0-rc.4"
   },
   "scripts": {
     "build": "pnpm run build:version && pnpm run clean && pnpm run build:types && pnpm run build:bundle",
     "build:version": "tsx scripts/inject-version.ts",
     "build:types": "tsc --declaration --emitDeclarationOnly --outDir dist",
     "build:bundle": "rollup -c rollup.config.ts",
-    "build:declarations": "tsx scripts/finalize-declarations.ts",
     "build:watch": "rollup -c rollup.config.ts --watch",
     "clean": "rimraf dist coverage .nyc_output",
     "test": "vitest run",
@@ -227,9 +224,10 @@
     "test:ci": "vitest run --coverage --reporter=verbose --maxWorkers=6",
     "coverage:goal": "tsx scripts/check-coverage-threshold.ts",
     "check:coverage:goal": "pnpm run test:cov && pnpm run coverage:goal",
-    "check:clones": "jscpd --min-lines 12 --min-tokens 70 --threshold 0 src tests",
-    "check:strict": "pnpm run typecheck && pnpm run typecheck:tests && pnpm run lint && pnpm run check:clones",
-    "check:all": "pnpm run check:strict && pnpm run check:coverage:goal && pnpm run build",
+    "check:clones": "jscpd --min-lines 12 --min-tokens 70 --threshold 0 src tests --ignore \"tests/golden/*.golden.json\"",
+    "check:strict": "pnpm run typecheck && pnpm run typecheck:tests && pnpm run typecheck:examples && pnpm run lint && pnpm run check:clones",
+    "check:all": "pnpm run check:strict && pnpm run check:coverage:goal && pnpm run build && pnpm run check:pack",
+    "check:pack": "tsx scripts/packed-smoke.ts",
     "test:integration": "vitest run --config vitest.integration.config.ts",
     "test:integration:trading": "vitest run --config vitest.integration.config.ts tests/integration/trading",
     "test:integration:dex": "vitest run --config vitest.integration.config.ts tests/integration/dex",
@@ -276,20 +274,9 @@
     "demo:bonding:volume-trading": "tsx examples/bonding-curve/volume-trading.ts",
     "demo:bonding:pagination-variants": "tsx examples/bonding-curve/pagination-variants.ts",
     "demo:bonding:pool-creator-filtering": "tsx examples/bonding-curve/pool-creator-filtering.ts",
-    "demo:liquidity": "tsx examples/liquidity/positions-cli.ts",
-    "demo:liquidity:detailed": "tsx examples/liquidity/detailed.ts",
-    "demo:liquidity:ticks": "tsx examples/liquidity/ticks.ts",
-    "demo:liquidity:portfolio": "tsx examples/liquidity/multi-position.ts",
-    "demo:liquidity:apr": "tsx examples/liquidity/apr-calculator.ts",
-    "demo:liquidity:errors": "tsx examples/liquidity/errors.ts",
-    "demo:liquidity:fetch-all": "tsx examples/liquidity/demo-fetch-all-positions.ts",
-    "demo:liquidity:positions-with-prices": "tsx examples/liquidity/demo-positions-with-chunked-pricing.ts",
-    "demo:liquidity:fee-collection": "tsx examples/liquidity/fee-collection.ts",
     "demo:cache": "tsx examples/utilities/demo-cache.ts",
     "demo:utilities:balance": "tsx examples/utilities/balance.ts",
-    "demo:utilities:balances": "tsx examples/utilities/balances.ts",
     "demo:utilities:key-derivation": "tsx examples/utilities/key-derivation.ts",
-    "demo:utilities:price-history": "tsx examples/utilities/price-history.ts",
     "demo:utilities:wrappable-tokens": "tsx examples/utilities/wrappable-tokens.ts",
     "demo:utilities:referrals": "tsx examples/utilities/referrals.ts",
     "demo:utilities:account": "tsx examples/utilities/account.ts",
@@ -297,51 +284,23 @@
     "demo:utilities:transfers": "tsx examples/utilities/transfers.ts",
     "demo:utilities:multi-token-portfolio": "tsx examples/utilities/multi-token-portfolio.ts",
     "demo:utilities:discovery": "tsx examples/utilities/token-discovery.ts",
-    "demo:utilities:pool-discovery-advanced": "tsx examples/utilities/pool-discovery-advanced.ts",
     "demo:utilities:token-metadata-advanced": "tsx examples/utilities/token-metadata-advanced.ts",
-    "demo:utilities:pool-pair-analysis": "tsx examples/utilities/pool-pair-analysis.ts",
     "demo:utilities:token-classification": "tsx examples/utilities/token-classification.ts",
     "demo:queries:complex-filtering": "tsx examples/queries/complex-filtering.ts",
     "demo:queries:advanced-sorting": "tsx examples/queries/advanced-sorting.ts",
     "derive-public-key-from-private-key": "tsx scripts/derive-public-key-from-private-key.ts",
-    "verify:stage-dex-reads": "tsx scripts/stage-verify-dex-reads.ts",
-    "demo:dex": "tsx examples/dex/swap-workflow.ts",
-    "demo:dex:pools": "tsx examples/dex/pool-discovery.ts",
-    "demo:dex:pricing": "tsx examples/dex/pools-with-pricing.ts",
-    "demo:dex:quotes": "tsx examples/dex/quote-comparison.ts",
-    "demo:dex:roundtrip": "tsx examples/dex/demo-roundtrip-liquidity.ts",
-    "demo:dex:leaderboard": "tsx examples/dex/leaderboard.ts",
-    "demo:dex:volume-summary": "tsx examples/dex/volume-summary.ts",
-    "demo:dex:token-discovery": "tsx examples/dex/token-discovery.ts",
-    "demo:dex:liquidity-management-advanced": "tsx examples/dex/dex-liquidity-management-advanced.ts",
-    "demo:dex:slippage-protection": "tsx examples/dex/dex-slippage-protection.ts",
-    "demo:dex:impermanent-loss-analysis": "tsx examples/dex/dex-impermanent-loss-analysis.ts",
-    "demo:dex:multi-hop-swaps": "tsx examples/dex/dex-multi-hop-swaps.ts",
     "demo:socials": "tsx examples/launchpad/demo-socials.ts",
     "demo:monitoring:stream-events": "tsx examples/monitoring/demo-stream-events.ts",
     "demo:monitoring:websocket-events": "tsx examples/monitoring/websocket-event-handlers.ts",
-    "demo:watch": "tsx examples/monitoring/demo-watch-pools.ts",
     "demo:watch:tokens": "tsx examples/monitoring/demo-watch-tokens.ts",
     "demo:watch:integration": "tsx examples/monitoring/token-creation-integration.ts",
     "demo:subscribe": "tsx examples/monitoring/token-creation-integration.ts",
-    "demo:fees": "tsx examples/fees/demo-fee-generation-and-collection.ts",
-    "demo:fees:high-volume": "tsx examples/fees/demo-fees-high-volume.ts",
-    "demo:fees:test": "tsx examples/fees/complete-fee-test.ts",
-    "demo:fees:trade-collect": "tsx examples/fees/trade-and-collect-fees.ts",
-    "demo:fees:multi-wallet": "tsx examples/fees/demo-multi-wallet-fee-generation.ts",
-    "demo:liquidity:bundler-test": "tsx examples/liquidity/demo-bundler-operations.ts",
-    "demo:liquidity:roundtrip-remove": "tsx examples/liquidity/demo-roundtrip-remove.ts",
-    "demo:liquidity:direct": "tsx examples/liquidity/demo-position-direct.ts",
     "demo:token-supply": "tsx examples/utilities/demo-token-supply.ts",
     "demo:token-info:token-name-resolution": "tsx examples/token-info/token-name-resolution.ts",
     "debug:websocket:stage": "ENVIRONMENT=stage tsx examples/debug/websocket-monitor.ts",
     "debug:websocket:prod": "ENVIRONMENT=prod tsx examples/debug/websocket-monitor.ts",
     "debug:websocket:discovery": "ENVIRONMENT=stage tsx examples/debug/websocket-event-discovery.ts",
     "demo:subscribe:tokens": "ENVIRONMENT=stage tsx examples/monitoring/subscribe-token-creations.ts",
-    "demo:subscribe:pools:integration": "ENVIRONMENT=stage tsx examples/monitoring/pool-creation-integration.ts",
-    "demo:watch:liquidity:e2e": "tsx examples/monitoring/liquidity-e2e-test.ts",
-    "demo:watch:fees:e2e": "tsx examples/monitoring/fees-collection-e2e.ts",
-    "demo:watch:fees:guaranteed": "tsx examples/monitoring/fees-collection-guaranteed.ts",
     "demo:bridge:tokens": "tsx examples/bridge/supported-tokens.ts",
     "demo:bridge:fee": "tsx examples/bridge/fee-estimation.ts",
     "demo:bridge:status": "tsx examples/bridge/status-tracking.ts",
@@ -420,12 +379,10 @@
     "demo:persistence:local-storage": "tsx examples/persistence/local-storage-patterns.ts",
     "demo:persistence:backup-recovery": "tsx examples/persistence/data-backup-recovery.ts",
     "test:demos:core": "npm run demo && npm run demo:read-only && npm run demo:authenticated && npm run demo:privatekey-override",
-    "test:demos:dex": "npm run demo:dex:pools && npm run demo:dex:pricing && npm run demo:dex:quotes && npm run demo:dex && npm run demo:dex:roundtrip",
-    "test:demos:fees": "npm run demo:fees && npm run demo:fees:high-volume && npm run demo:fees:test && npm run demo:fees:trade-collect && npm run demo:fees:multi-wallet",
     "test:demos:utilities": "npm run demo:cache && npm run demo:token-supply",
     "test:demos:bonding": "npm run demo:trades",
     "test:demos:quick": "npm run demo:cache && npm run demo:read-only",
-    "test:demos:all": "npm run test:demos:core && npm run test:demos:bonding && npm run test:demos:dex && npm run test:demos:fees && npm run test:demos:utilities",
+    "test:demos:all": "npm run test:demos:core && npm run test:demos:bonding && npm run test:demos:utilities",
     "test:env:check": "npm run validate:env && echo '✅ Environment validation passed'",
     "test:system": "npm run test:env:check && echo '' && echo '📋 Starting comprehensive system tests...' && npm run test:demos:all && echo '' && echo '✅ All system tests passed!'",
     "demo:list": "tsx examples/demo-librarian.ts list",
@@ -437,6 +394,8 @@
     "demo:tasks:small": "tsx examples/orchestrator-tasks.ts --batch-size=10",
     "demo:tasks:large": "tsx examples/orchestrator-tasks.ts --batch-size=30",
     "demo:run": "tsx examples/demo-runner.ts",
+    "demo:run:method": "tsx examples/demo-runner.ts --by-method",
+    "demo:run:endpoint": "tsx examples/demo-runner.ts --by-endpoint",
     "demo:registry:generate": "tsx scripts/generate-demo-registry.ts",
     "demo:registry:validate": "tsx scripts/validate-demo-registry.ts",
     "test:demos": "tsx examples/testing/index.ts",
@@ -452,6 +411,7 @@
     "lint:strict": "pnpm run lint",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "typecheck:tests": "tsc -p tsconfig.tests.json --noEmit",
+    "typecheck:examples": "tsc -p tsconfig.examples.json --noEmit",
     "typecheck:watch": "tsc --noEmit --watch",
     "format": "prettier --write \"src/**/*.{ts,tsx,json,md}\"",
     "format:check": "prettier --check \"src/**/*.{ts,tsx,json,md}\"",
@@ -465,10 +425,10 @@
     "docs:extract:markdown": "api-documenter markdown -i temp -o docs/api-markdown",
     "docs:typedoc": "typedoc --options typedoc-html.json",
     "docs:typedoc:markdown": "typedoc --plugin typedoc-plugin-markdown --out docs/markdown",
-    "docs:validate": "tsx scripts/validate-examples.ts",
     "docs:generate": "pnpm run docs:prebuild && pnpm run docs:extract && pnpm run docs:typedoc",
     "docs:serve": "http-server docs/api -p 8080",
+    "docs:migration": "tsx scripts/generate-migration-doc.ts",
     "size": "size-limit",
-    "analyze": "rollup -c rollup.config.mjs --bundleAnalyzerReport"
+    "analyze": "BUNDLE_ANALYZER=true rollup -c rollup.config.ts"
   }
 }