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

package/dist/launchpad/bundle-submission.d.ts

@@ -1,5 +1,6 @@
-import type { HttpRequestor } from '@gala-chain/gala-core-sdk';
+import { type HttpRequestor } from '@gala-chain/gala-core-sdk';
 import type { LaunchpadSigner } from '../signing/types.js';
+import { type BundleAttachment } from './transport.js';
 /** Result delivered by the bundle socket or its REST confirmation fallback. */
 export interface BundleResult {
     status: 'PROCESSED' | 'FAILED';
@@ -13,8 +14,19 @@ export interface BundleSocket {
 export type SocketFactory = (url: string) => BundleSocket;
 /** Options accepted by {@link BundleSubmission.wait}. */
 export interface BundleWaitOptions {
+    /** How long to wait in all (default 60 s). The deadline ends the wait with `BUNDLE_CONFIRMATION_TIMEOUT`. */
     timeoutMs?: number;
+    /** Pause between confirmation reads (default 2.5 s); a read that failed is repeated after it too. */
     pollIntervalMs?: number;
+    /**
+     * Stop waiting. An aborted wait rejects with `LaunchpadSDKError` `BUNDLE_WAIT_ABORTED` and stops
+     * everything it started (its reads, their pause, its deadline timer, its socket listener; a
+     * socket the transport opened is disconnected, a borrowed `bundleSocketFactory` socket is not).
+     * Aborting stops WATCHING only: the bundle may still be processed, and `attach` resumes it. A
+     * signal that is already aborted rejects at once, before a socket is opened or a read is sent.
+     * @since 9.0.0
+     */
+    signal?: AbortSignal;
 }
 /** A submitted launchpad bundle that can be confirmed through socket or REST. */
 export declare class BundleSubmission {
@@ -56,7 +68,17 @@ export declare class BundlerTransport {
     private readonly signer;
     private readonly walletAddress;
     private readonly socketFactory;
-    /** Create a bundler transport with an injectable requestor and socket factory. */
+    private readonly bundleSocketFactory;
+    /**
+     * Create a bundler transport with an injectable requestor and socket.
+     *
+     * @param options.socketFactory - Opens a socket for one `wait()`; the transport disconnects it when
+     *   the wait ends (default: a socket.io websocket to `bundleBaseUrl`).
+     * @param options.bundleSocketFactory - The app's own bundler socket (its reconnect settings, its
+     *   lifecycle): called once per `wait()`, the transport only adds its listener for the bundle's
+     *   event and removes it when the wait ends; it never disconnects that socket. Takes precedence
+     *   over `socketFactory`.
+     */
     constructor(options: {
         bundleBaseUrl: string;
         launchpadBaseUrl: string;
@@ -64,7 +86,23 @@ export declare class BundlerTransport {
         walletAddress: string;
         httpRequestor?: HttpRequestor;
         socketFactory?: SocketFactory;
+        bundleSocketFactory?: SocketFactory | undefined;
     });
+    /**
+     * A submission for a bundle sent earlier (a page that persisted `{ bundleId, method, uniqueKey,
+     * tokenName }` and reloaded): its `wait()` confirms exactly as a fresh submission's does (the
+     * bundle's socket event raced against the REST confirmation, which also answers for a bundle that
+     * settled before this call). Nothing is signed or sent until `wait()`.
+     *
+     * @throws LaunchpadSDKError `INVALID_BUNDLE_ATTACHMENT` (`details.field`): an empty `bundleId` or
+     *   `uniqueKey`, a method the bundler does not accept, a `CreateSale` without its `tokenName`.
+     * @example
+     * ```typescript
+     * const submission = transport.attach({ bundleId, method: 'BuyWithNative', uniqueKey });
+     * const result = await submission.wait();
+     * ```
+     */
+    attach(attachment: BundleAttachment): BundleSubmission;
     /**
      * Sign and submit one allowlisted launchpad write to the bundler.
      * @example
@@ -74,7 +112,24 @@ export declare class BundlerTransport {
      * ```
      */
     submit(request: LaunchpadWriteRequest): Promise<BundleSubmission>;
+    /**
+     * One confirmation: the bundle's socket event raced against the REST read, until one of them
+     * delivers a terminal bundler result (PROCESSED / FAILED), the deadline passes, or the caller
+     * aborts. A read that fails (a network error, an HTTP error, an unreadable body) is not a
+     * verdict: the next read follows after `pollIntervalMs`, and the socket can still deliver, until
+     * the deadline. Whatever ends the wait stops the rest of it (the reads, their delay, the deadline
+     * timer, this wait's socket listener; an own socket is disconnected, a borrowed one is not).
+     */
     private waitForResult;
+    private confirmationUrl;
+    /**
+     * The REST leg of a wait. Resolves with the bundle's result, rejects with the bundle's FAILED
+     * verdict, and resolves `undefined` when it was stopped (`signal`) or the deadline passed with
+     * no verdict. A read that fails is reported through `onReadFailure` (and cleared by the next
+     * read that gets an answer) and retried; it never ends the wait.
+     */
     private pollConfirmation;
+    /** One confirmation read, as a verdict, "not yet", or a failed read. Never throws. */
+    private readConfirmation;
 }
 //# sourceMappingURL=bundle-submission.d.ts.map

package/dist/launchpad/bundle-submission.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundle-submission.d.ts","sourceRoot":"","sources":["../../src/launchpad/bundle-submission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,YAAY,CAAC;IACpE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,YAAY,CAAC;IACrE,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,YAAY,CAAC;AAE1D,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,iFAAiF;AACjF,qBAAa,gBAAgB;IAC3B,iEAAiE;IACjE,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,mEAAmE;IACnE,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,+CAA+C;IAC/C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyD;IAEvF,2EAA2E;gBACxD,OAAO,EAAE;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;KAC9D;IAOD;;;;;;;OAOG;IACI,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;CAGhE;AAED,sEAAsE;AACtE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,+EAA+E;AAC/E,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAE9C,kFAAkF;gBAC/D,OAAO,EAAE;QAC1B,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,eAAe,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,aAAa,CAAC,EAAE,aAAa,CAAC;KAC/B;IASD;;;;;;;OAOG;IACU,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAsChE,aAAa;YA4Cb,gBAAgB;CA2D/B"}
+{"version":3,"file":"bundle-submission.d.ts","sourceRoot":"","sources":["../../src/launchpad/bundle-submission.ts"],"names":[],"mappings":"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"}

package/dist/launchpad/create-sale-validation.d.ts

@@ -0,0 +1,19 @@
+import type { ReverseBondingCurveConfiguration } from '../types/launchpad.dto.js';
+/**
+ * Reverse bonding curve (sell fee) configuration a CreateSale carries when the caller names none:
+ * 10% at the start of the curve to 50% at the end, the documented defaults and the bundler's
+ * allowed range (min >= 0.1, max <= 0.5).
+ */
+export declare const DEFAULT_REVERSE_BONDING_CURVE_CONFIGURATION: Readonly<ReverseBondingCurveConfiguration>;
+/**
+ * The canonical BigNumber string of a plain decimal (`5.` -> `5`, `05` -> `5`, `1.50` -> `1.5`), the
+ * only spelling the chain parses; `undefined` for anything that is not a plain non-negative decimal.
+ */
+export declare function canonicalDecimal(value: unknown): string | undefined;
+/**
+ * Refuse a CreateSale input the bundler or the chain would refuse, before anything is signed.
+ *
+ * @throws ValidationError (`VALIDATION_ERROR`, field `data`) listing every refused field.
+ */
+export declare function validateCreateSaleInput(input: unknown): void;
+//# sourceMappingURL=create-sale-validation.d.ts.map

package/dist/launchpad/create-sale-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-sale-validation.d.ts","sourceRoot":"","sources":["../../src/launchpad/create-sale-validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AAGlF;;;;GAIG;AACH,eAAO,MAAM,2CAA2C,EAAE,QAAQ,CAAC,gCAAgC,CAGlG,CAAC;AAqCF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAInE;AAkCD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CA4C5D"}

package/dist/launchpad/transport.d.ts

@@ -1,7 +1,27 @@
 import type { HttpRequestor } from '@gala-chain/gala-core-sdk';
 import type { BundleSubmission, BundleWaitOptions } from './bundle-submission.js';
+/**
+ * The launchpad chaincode methods the bundler accepts (the allowlist), as a closed set.
+ *
+ * @since 9.0.0
+ */
+export declare const LAUNCHPAD_WRITE_METHODS: readonly ["CreateSale", "BuyWithNative", "BuyExactToken", "SellWithNative", "SellExactToken"];
 /** Allowlisted launchpad chaincode methods accepted by the bundler. */
-export type LaunchpadWriteMethod = 'CreateSale' | 'BuyWithNative' | 'BuyExactToken' | 'SellWithNative' | 'SellExactToken';
+export type LaunchpadWriteMethod = (typeof LAUNCHPAD_WRITE_METHODS)[number];
+/**
+ * A bundle submitted earlier (by this page before a reload, say) to confirm again: what
+ * `sdk.launchpad.attach` takes. `bundleId`, `method` and `uniqueKey` are the submission's
+ * (`BundleSubmission.bundleId` / `.method` / `.uniqueKey`); `tokenName` is the sale's token name
+ * and is required for `CreateSale`, which is confirmed by that token existing.
+ *
+ * @since 9.0.0
+ */
+export interface BundleAttachment {
+    bundleId: string;
+    method: LaunchpadWriteMethod;
+    uniqueKey: string;
+    tokenName?: string | undefined;
+}
 /** Transport seam for launchpad writes; signing belongs to the implementation. */
 export interface LaunchpadWriteTransport {
     /**
@@ -17,6 +37,16 @@ export interface LaunchpadWriteTransport {
         dto: Record<string, unknown>;
         stringsInstructions: string[];
     }): Promise<BundleSubmission>;
+    /**
+     * A submission for a bundle sent earlier, whose `wait()` confirms it exactly as the submission
+     * `submit` returned would. Nothing is signed or sent until `wait()`.
+     * @example
+     * ```typescript
+     * const submission = transport.attach({ bundleId, method: 'BuyWithNative', uniqueKey });
+     * await submission.wait();
+     * ```
+     */
+    attach(attachment: BundleAttachment): BundleSubmission;
 }
 /** Narrow options shared by the concrete bundler transport factory. */
 export interface LaunchpadTransportOptions {

package/dist/launchpad/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/launchpad/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAElF,uEAAuE;AACvE,MAAM,MAAM,oBAAoB,GAC5B,YAAY,GACZ,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,kFAAkF;AAClF,MAAM,WAAW,uBAAuB;IACtC;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,EAAE;QACd,MAAM,EAAE,oBAAoB,CAAC;QAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7B,mBAAmB,EAAE,MAAM,EAAE,CAAC;KAC/B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC/B;AAED,uEAAuE;AACvE,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/launchpad/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,+FAM1B,CAAC;AAEX,uEAAuE;AACvE,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED,kFAAkF;AAClF,MAAM,WAAW,uBAAuB;IACtC;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,EAAE;QACd,MAAM,EAAE,oBAAoB,CAAC;QAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7B,mBAAmB,EAAE,MAAM,EAAE,CAAC;KAC/B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE9B;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,EAAE,gBAAgB,GAAG,gBAAgB,CAAC;CACxD;AAED,uEAAuE;AACvE,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC"}

package/dist/launchpad/writes.d.ts

@@ -1,21 +1,26 @@
-import type { LaunchTokenData, ReverseBondingCurveConfiguration } from '../types/launchpad.dto.js';
+import type { LaunchTokenData } from '../types/launchpad.dto.js';
 import type { BundleSubmission } from './bundle-submission.js';
 import type { SellFeeCeilingResolver } from './sell-fee-ceiling.js';
-import type { LaunchpadWriteTransport } from './transport.js';
+import type { BundleAttachment, LaunchpadWriteTransport } from './transport.js';
 /** Common fee fields copied into every frontend trade DTO. */
 export interface LaunchpadExtraFees {
     maxAcceptableReverseBondingCurveFee: string;
 }
-/** Input for a bundler launchpad trade. */
+/**
+ * Input for a bundler launchpad trade (`buyWithNative`, `buyExactToken`, `sellWithNative`,
+ * `sellExactToken`).
+ * @since 9.0.0
+ */
 export interface LaunchpadTradeInput {
     vaultAddress: string;
     quantity: string;
     expectedAmount: string;
     /**
-     * The most reverse-bonding-curve fee (GALA) a sell may pay. Omit it on a sell and the SDK quotes
+     * The most reverse-bonding-curve fee (GALA) a trade may pay. Omit it on a sell and the SDK quotes
      * the fee and allows it plus the SDK fee slippage; pass it to take over (an explicit `'0'` means
-     * "reject any fee", which the chain does for every sell on a pool that charges one). Buys pay no
-     * such fee and ignore the value.
+     * "reject any fee", which the chain does for every sell on a pool that charges one). Omit it on a
+     * buy and `'0'` is sent (a buy pays no such fee); a value passed on a buy is sent as given, in the
+     * signed `extraFees`.
      */
     extraFees?: LaunchpadExtraFees;
     /** The launchpad token name of `vaultAddress`; saves the SDK one lookup when it quotes a sell. */
@@ -23,12 +28,13 @@ export interface LaunchpadTradeInput {
     uniqueKey?: string;
 }
 /**
- * Reverse bonding curve (sell fee) configuration a CreateSale carries when the caller names none:
- * 10% at the start of the curve to 50% at the end, the documented defaults and the bundler's
- * allowed range (min >= 0.1, max <= 0.5).
+ * Input for a CreateSale bundler write (`createSale`). The pre-flight refuses only what the deployed
+ * bundler or the chain refuses (see `create-sale-validation.ts`): a name of letters and digits, a
+ * symbol of letters and digits in any case (the chain upper-cases it), a plain decimal pre-buy and
+ * curve portions (signed in their canonical spelling), a non-empty description (at most 1000
+ * characters) and image (at most 500).
+ * @since 9.0.0
  */
-export declare const DEFAULT_REVERSE_BONDING_CURVE_CONFIGURATION: Readonly<ReverseBondingCurveConfiguration>;
-/** Input for a CreateSale bundler write. */
 export interface CreateSaleInput extends Omit<LaunchTokenData, 'tokenImage'> {
     tokenImage: string;
     uniqueKey?: string;
@@ -58,6 +64,26 @@ export declare class LaunchpadWrites {
      * ```
      */
     createSale(input: CreateSaleInput): Promise<BundleSubmission>;
+    /**
+     * Resume a bundle submitted earlier: persist `{ bundleId, method, uniqueKey }` of a submission
+     * (plus `tokenName` for a `CreateSale`), and after a reload `attach` returns a submission whose
+     * `wait()` confirms it exactly as the original one would have. Nothing is signed or sent until
+     * `wait()`.
+     *
+     * @throws LaunchpadSDKError `INVALID_BUNDLE_ATTACHMENT` (see `BundlerTransport.attach`).
+     * @since 9.0.0
+     * @example
+     * ```typescript
+     * const submission = await sdk.launchpad.buyWithNative({ vaultAddress, quantity: '1', expectedAmount: '2' });
+     * sessionStorage.setItem('pendingBundle', JSON.stringify({
+     *   bundleId: submission.bundleId, method: submission.method, uniqueKey: submission.uniqueKey,
+     * }));
+     * // after a reload
+     * const resumed = sdk.launchpad.attach(JSON.parse(sessionStorage.getItem('pendingBundle') ?? '{}'));
+     * const result = await resumed.wait();
+     * ```
+     */
+    attach(attachment: BundleAttachment): BundleSubmission;
     /**
      * Buy an exact native quantity through BuyWithNative.
      * @example

package/dist/launchpad/writes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writes.d.ts","sourceRoot":"","sources":["../../src/launchpad/writes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AAGnG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,KAAK,EAAwB,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEpF,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,mCAAmC,EAAE,MAAM,CAAC;CAC7C;AAED,2CAA2C;AAC3C,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,kGAAkG;IAClG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,2CAA2C,EAAE,QAAQ,CAAC,gCAAgC,CAGlG,CAAC;AAEF,4CAA4C;AAC5C,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wFAAwF;AACxF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqC;IAEpE;;;;;OAKG;gBACgB,OAAO,EAAE;QAC1B,SAAS,EAAE,uBAAuB,CAAC;QACnC,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,CAAC,EAAE,sBAAsB,CAAC;KACzC;IAMD;;;;;;;OAOG;IACI,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAYpE;;;;;;;OAOG;IACI,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO3E;;;;;;OAMG;IACI,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO3E;;;;;;OAMG;IACI,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO5E;;;;;;OAMG;IACI,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAO9D,WAAW;IAkBzB;;;;OAIG;YACW,gBAAgB;CAsB/B"}
+{"version":3,"file":"writes.d.ts","sourceRoot":"","sources":["../../src/launchpad/writes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAoC,MAAM,2BAA2B,CAAC;AAEnG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,KAAK,EAAE,gBAAgB,EAAwB,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEtG,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,mCAAmC,EAAE,MAAM,CAAC;CAC7C;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,kGAAkG;IAClG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wFAAwF;AACxF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqC;IAEpE;;;;;OAKG;gBACgB,OAAO,EAAE;QAC1B,SAAS,EAAE,uBAAuB,CAAC;QACnC,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,CAAC,EAAE,sBAAsB,CAAC;KACzC;IAMD;;;;;;;OAOG;IACI,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAapE;;;;;;;;;;;;;;;;;;OAkBG;IACI,MAAM,CAAC,UAAU,EAAE,gBAAgB,GAAG,gBAAgB;IAI7D;;;;;;;OAOG;IACI,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO3E;;;;;;OAMG;IACI,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO3E;;;;;;OAMG;IACI,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO5E;;;;;;OAMG;IACI,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAO9D,WAAW;IAkBzB;;;;OAIG;YACW,gBAAgB;CAsB/B"}