@bropump/sdk 0.2.2 → 0.2.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BroPump
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,6 @@
 # @bropump/sdk
 
-TypeScript SDK for the BroPump API.
+TypeScript SDK for BroPump launches, fee previews, and realtime launch sessions.
 
 ## Install
 
@@ -33,23 +33,23 @@ const client = new BroPumpClient({
 })
 ```
 
-## Config Modes
+## Launch Modes
 
-Launch selection is driven by Cloudflare config binding names, not raw threshold numbers.
+Launch modes are the current available token fee, liquidity, and bonding setups.
 
-Fetch the currently available modes from the API:
+Fetch the currently available launch modes from the API:
 
 ```ts
 const launchConfig = await client.launchConfig.get()
 
-console.log(launchConfig.defaultConfigMode)
-console.log(launchConfig.availableConfigModes)
-console.log(launchConfig.configModeOptions)
+console.log(launchConfig.defaultLaunchMode)
+console.log(launchConfig.availableLaunchModes)
+console.log(launchConfig.launchModeOptions)
 ```
 
 Each option includes:
 
-- `configMode`, for example `MAINNET_CONFIG_25`
+- `launchMode`, for example `MAINNET_CONFIG_25`
 - `migrationThreshold`, the resolved quote target behind that mode
 - `configAddress`
 - `deploymentMode`
@@ -67,7 +67,7 @@ const token = await client.tokens.create({
   symbol: 'BRO',
   description: 'Simple token flow',
   deployer: 'YOUR_WALLET',
-  configMode: 'DEVNET_CONFIG_1',
+  launchMode: 'DEVNET_CONFIG_1',
   firstBuyAmount: 0.25,
   image: new Blob(['demo'], { type: 'image/png' }),
 })
@@ -96,12 +96,12 @@ try {
 
 ```ts
 const preview = await client.fees.preview({
-  configMode: 'MAINNET_CONFIG_25',
+  launchMode: 'MAINNET_CONFIG_25',
   firstBuyAmount: 0.5,
   deployerWallet: 'YOUR_WALLET',
 })
 
-console.log(preview.selectedConfigMode)
+console.log(preview.selectedLaunchMode)
 console.log(preview.curve.migrationThreshold)
 console.log(preview.costQuote.recommendedMinBalanceSol)
 ```
@@ -124,7 +124,7 @@ All wait helpers accept:
 ## Realtime / WSS
 
 You do not need to manage a separate websocket host manually. The SDK derives `ws://` or `wss://`
-from the API base URL automatically.
+from the API base URL automatically for both `mainnet` and `devnet`.
 
 ### Watch a Token Session
 
@@ -177,6 +177,9 @@ Common message types:
 - `runtime_snapshot`
 - `runtime_update`
 
+Use `client.tokens.watch(tokenId)` for a launch session and `client.tokens.watchPool(poolAddress)`
+for a live pool stream.
+
 ## Manual WSS URL Access
 
 If you need the derived websocket URL for your own socket layer, use `buildWebSocketUrl`:

package/dist/client.js

@@ -123,19 +123,21 @@ export class BroPumpClient {
         });
     }
     async previewFees(input, options) {
-        return this.request({
+        const preview = await this.request({
             path: '/fees/preview',
             method: 'POST',
-            body: input ?? {},
+            body: buildFeePreviewPayload(input),
             options,
         });
+        return normalizeCurvePreview(preview);
     }
     async getLaunchConfig(options) {
-        return this.request({
+        const launchConfig = await this.request({
             path: '/launch-config',
             method: 'GET',
             options,
         });
+        return normalizeLaunchConfigView(launchConfig);
     }
     async getWalletBalance(address, options) {
         return this.request({
@@ -198,7 +200,8 @@ function buildCreateTokenFormData(input) {
     appendFormValue(form, 'symbol', input.symbol);
     appendFormValue(form, 'description', input.description);
     appendFormValue(form, 'deployer', input.deployer);
-    appendFormValue(form, 'configMode', input.configMode);
+    appendFormValue(form, 'launchMode', input.launchMode);
+    appendFormValue(form, 'configMode', input.launchMode);
     appendFormValue(form, 'firstBuyAmount', input.firstBuyAmount);
     appendFormValue(form, 'x', input.x);
     appendFormValue(form, 'website', input.website);
@@ -212,6 +215,72 @@ function appendFormValue(form, key, value) {
         return;
     form.set(key, String(value));
 }
+function buildFeePreviewPayload(input) {
+    if (!input)
+        return {};
+    return {
+        ...input,
+        ...(input.launchMode ? { configMode: input.launchMode } : {}),
+    };
+}
+function normalizeLaunchModeOption(input) {
+    const launchMode = typeof input.launchMode === 'string'
+        ? input.launchMode
+        : typeof input.configMode === 'string'
+            ? input.configMode
+            : '';
+    return {
+        launchMode,
+        migrationThreshold: Number(input.migrationThreshold ?? 0),
+        configAddress: typeof input.configAddress === 'string' || input.configAddress === null
+            ? input.configAddress
+            : null,
+        deploymentMode: input.deploymentMode === 'per-launch-config' ? 'per-launch-config' : 'predeployed-config',
+    };
+}
+function normalizeLaunchConfigView(input) {
+    const optionRows = Array.isArray(input.launchModeOptions)
+        ? input.launchModeOptions
+        : Array.isArray(input.configModeOptions)
+            ? input.configModeOptions
+            : [];
+    const launchModeOptions = optionRows
+        .filter((value) => Boolean(value) && typeof value === 'object')
+        .map(normalizeLaunchModeOption);
+    return {
+        network: input.network === 'devnet' ? 'devnet' : 'mainnet',
+        defaultLaunchMode: typeof input.defaultLaunchMode === 'string'
+            ? input.defaultLaunchMode
+            : typeof input.defaultConfigMode === 'string'
+                ? input.defaultConfigMode
+                : launchModeOptions[0]?.launchMode || '',
+        availableLaunchModes: Array.isArray(input.availableLaunchModes)
+            ? input.availableLaunchModes.filter((value) => typeof value === 'string')
+            : Array.isArray(input.availableConfigModes)
+                ? input.availableConfigModes.filter((value) => typeof value === 'string')
+                : launchModeOptions.map((option) => option.launchMode),
+        launchModeOptions,
+    };
+}
+function normalizeCurvePreview(input) {
+    const optionRows = Array.isArray(input.launchModeOptions)
+        ? input.launchModeOptions
+        : Array.isArray(input.configModeOptions)
+            ? input.configModeOptions
+            : [];
+    const launchModeOptions = optionRows
+        .filter((value) => Boolean(value) && typeof value === 'object')
+        .map(normalizeLaunchModeOption);
+    return {
+        ...input,
+        launchModeOptions,
+        selectedLaunchMode: typeof input.selectedLaunchMode === 'string'
+            ? input.selectedLaunchMode
+            : typeof input.selectedConfigMode === 'string'
+                ? input.selectedConfigMode
+                : launchModeOptions[0]?.launchMode || '',
+    };
+}
 function toImagePart(image) {
     if (isBlob(image)) {
         return {

package/dist/types.d.ts

@@ -38,7 +38,7 @@ export type CreateTokenInput = {
     symbol: string;
     description: string;
     deployer: string;
-    configMode?: string;
+    launchMode?: string;
     firstBuyAmount?: number;
     x?: string;
     website?: string;
@@ -90,17 +90,17 @@ export type LaunchCostQuote = {
     };
     breakdown: LaunchCostBreakdown;
 };
-export type ConfigModeOption = {
-    configMode: string;
+export type LaunchModeOption = {
+    launchMode: string;
     migrationThreshold: number;
     configAddress: string | null;
     deploymentMode: 'predeployed-config' | 'per-launch-config';
 };
 export type LaunchConfigView = {
     network: 'devnet' | 'mainnet';
-    defaultConfigMode: string;
-    availableConfigModes: string[];
-    configModeOptions: ConfigModeOption[];
+    defaultLaunchMode: string;
+    availableLaunchModes: string[];
+    launchModeOptions: LaunchModeOption[];
 };
 export type SubmitAction = {
     id: string;
@@ -157,8 +157,8 @@ export type RealtimeMessage<T> = {
     data: T | null;
 };
 export type CurvePreview = {
-    configModeOptions: ConfigModeOption[];
-    selectedConfigMode: string;
+    launchModeOptions: LaunchModeOption[];
+    selectedLaunchMode: string;
     curve: {
         startingMC: number;
         endingMC: number;
@@ -199,7 +199,7 @@ export type CurvePreview = {
 };
 export type FeePreviewRequest = {
     totalSupply?: string;
-    configMode?: string;
+    launchMode?: string;
     firstBuyAmount?: number;
     deployerWallet?: string;
 };

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "@bropump/sdk",
-  "version": "0.2.2",
-  "description": "TypeScript SDK for the BroPump API",
-  "license": "UNLICENSED",
+  "version": "0.2.3",
+  "description": "TypeScript SDK for BroPump launches, fee previews, and realtime sessions",
+  "license": "MIT",
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "repository": {
     "type": "git",
@@ -21,7 +22,8 @@
     "sdk",
     "typescript",
     "api",
-    "cloudflare"
+    "launches",
+    "solana"
   ],
   "engines": {
     "node": ">=18"