@dipansrimany/mlink-sdk 0.3.1 → 0.4.2

package/dist/builders-pKj4NiIj.d.mts

@@ -0,0 +1,245 @@
+import { g as ActionDefinition, d as ActionButton, o as ActionLinks, A as ActionMetadata, T as TransactionRequest, a as TransactionResponse, b as TypedActionParameter, L as LinkedAction, m as ActionParameterSelectable, l as ActionParameter, j as ActionParameterOption } from './types-DD9rJ58Y.mjs';
+
+declare function button(config: {
+    label: string;
+    value: string;
+    disabled?: boolean;
+}): ActionButton;
+declare function input(config: {
+    label: string;
+    placeholder?: string;
+    disabled?: boolean;
+}): ActionButton;
+/**
+ * Create a linked action with optional parameters
+ * Uses Solana-style href templates with {parameter} placeholders
+ *
+ * @example
+ * ```ts
+ * linkedAction({
+ *   href: '/api/swap?amount={amount}&token={token}',
+ *   label: 'Swap Tokens',
+ *   parameters: [
+ *     textParam({ name: 'amount', label: 'Amount', required: true }),
+ *     selectParam({
+ *       name: 'token',
+ *       label: 'Token',
+ *       options: [
+ *         { label: 'USDC', value: '0x...' },
+ *         { label: 'USDT', value: '0x...' }
+ *       ]
+ *     })
+ *   ]
+ * })
+ * ```
+ */
+declare function linkedAction(config: {
+    href: string;
+    label: string;
+    disabled?: boolean;
+    parameters?: TypedActionParameter[];
+}): LinkedAction;
+/**
+ * Create a simple linked action button (no parameters, just a static href)
+ *
+ * @example
+ * ```ts
+ * actionButton({
+ *   href: '/api/tip?amount=1',
+ *   label: 'Tip 1 MNT'
+ * })
+ * ```
+ */
+declare function actionButton(config: {
+    href: string;
+    label: string;
+    disabled?: boolean;
+}): LinkedAction;
+/**
+ * Create a text parameter
+ */
+declare function textParam(config: {
+    name: string;
+    label?: string;
+    required?: boolean;
+    pattern?: string;
+    patternDescription?: string;
+}): ActionParameter;
+/**
+ * Create a number parameter
+ */
+declare function numberParam(config: {
+    name: string;
+    label?: string;
+    required?: boolean;
+    min?: number | string;
+    max?: number | string;
+}): ActionParameter;
+/**
+ * Create an amount parameter (for token/ETH amounts)
+ */
+declare function amountParam(config: {
+    name: string;
+    label?: string;
+    required?: boolean;
+    min?: number | string;
+    max?: number | string;
+}): ActionParameter;
+/**
+ * Create an address parameter (for wallet addresses)
+ */
+declare function addressParam(config: {
+    name: string;
+    label?: string;
+    required?: boolean;
+}): ActionParameter;
+/**
+ * Create a select dropdown parameter
+ */
+declare function selectParam(config: {
+    name: string;
+    label?: string;
+    required?: boolean;
+    options: ActionParameterOption[];
+}): ActionParameterSelectable;
+/**
+ * Create a radio button group parameter
+ */
+declare function radioParam(config: {
+    name: string;
+    label?: string;
+    required?: boolean;
+    options: ActionParameterOption[];
+}): ActionParameterSelectable;
+/**
+ * Create a checkbox parameter (multiple selection)
+ */
+declare function checkboxParam(config: {
+    name: string;
+    label?: string;
+    required?: boolean;
+    options: ActionParameterOption[];
+}): ActionParameterSelectable;
+/**
+ * Create a date parameter
+ */
+declare function dateParam(config: {
+    name: string;
+    label?: string;
+    required?: boolean;
+    min?: string;
+    max?: string;
+}): ActionParameter;
+/**
+ * Create a textarea parameter (multi-line text)
+ */
+declare function textareaParam(config: {
+    name: string;
+    label?: string;
+    required?: boolean;
+}): ActionParameter;
+/**
+ * Create an option for select/radio/checkbox parameters
+ */
+declare function option(label: string, value: string, selected?: boolean): ActionParameterOption;
+/**
+ * Create a links object with actions array
+ *
+ * @example
+ * ```ts
+ * createLinks([
+ *   actionButton({ href: '/api/tip?amount=1', label: 'Tip 1 MNT' }),
+ *   actionButton({ href: '/api/tip?amount=5', label: 'Tip 5 MNT' }),
+ *   linkedAction({
+ *     href: '/api/tip?amount={amount}',
+ *     label: 'Custom Amount',
+ *     parameters: [amountParam({ name: 'amount', required: true })]
+ *   })
+ * ])
+ * ```
+ */
+declare function createLinks(actions: LinkedAction[]): ActionLinks;
+/**
+ * Replace placeholders in href template with parameter values
+ *
+ * @example
+ * ```ts
+ * buildHref('/api/swap?amount={amount}&token={token}', { amount: '100', token: '0x...' })
+ * // Returns: '/api/swap?amount=100&token=0x...'
+ * ```
+ */
+declare function buildHref(template: string, params: Record<string, string | string[]>): string;
+/**
+ * Extract parameter names from href template
+ *
+ * @example
+ * ```ts
+ * extractParams('/api/swap?amount={amount}&token={token}')
+ * // Returns: ['amount', 'token']
+ * ```
+ */
+declare function extractParams(template: string): string[];
+/**
+ * Check if a linked action has parameters that need to be collected
+ */
+declare function hasParameters(action: LinkedAction): boolean;
+/**
+ * Check if a parameter is selectable (select/radio/checkbox)
+ */
+declare function isSelectableParam(param: TypedActionParameter): param is ActionParameterSelectable;
+interface Action {
+    getMetadata(): ActionMetadata;
+    handleRequest(request: TransactionRequest): Promise<TransactionResponse>;
+}
+/**
+ * Extended action definition that supports both legacy actions and linked actions
+ */
+interface ExtendedActionDefinition extends Omit<ActionDefinition, 'actions'> {
+    /** Primary button label */
+    label?: string;
+    /** Legacy actions array (backwards compatible) */
+    actions?: ActionButton[];
+    /** Solana-style linked actions */
+    links?: ActionLinks;
+}
+/**
+ * Create a complete action with support for both legacy and Solana-style linked actions
+ *
+ * @example Legacy style (backwards compatible):
+ * ```ts
+ * createAction({
+ *   title: 'Tip',
+ *   icon: 'https://...',
+ *   description: 'Send a tip',
+ *   actions: [
+ *     button({ label: '1 MNT', value: '1' }),
+ *     input({ label: 'Custom' })
+ *   ],
+ *   handler: async (ctx) => ({ transaction: {...} })
+ * })
+ * ```
+ *
+ * @example Solana-style linked actions:
+ * ```ts
+ * createAction({
+ *   title: 'Swap Tokens',
+ *   icon: 'https://...',
+ *   description: 'Swap tokens on DEX',
+ *   links: createLinks([
+ *     actionButton({ href: '/api/swap?amount=10', label: 'Swap 10' }),
+ *     linkedAction({
+ *       href: '/api/swap?amount={amount}&token={token}',
+ *       label: 'Custom Swap',
+ *       parameters: [
+ *         amountParam({ name: 'amount', required: true }),
+ *         selectParam({ name: 'token', options: [...] })
+ *       ]
+ *     })
+ *   ]),
+ *   handler: async (ctx) => ({ transaction: {...} })
+ * })
+ * ```
+ */
+declare function createAction(definition: ExtendedActionDefinition): Action;
+
+export { type Action as A, type ExtendedActionDefinition as E, actionButton as a, button as b, createAction as c, createLinks as d, buildHref as e, extractParams as f, isSelectableParam as g, hasParameters as h, input as i, amountParam as j, addressParam as k, linkedAction as l, checkboxParam as m, numberParam as n, dateParam as o, textareaParam as p, option as q, radioParam as r, selectParam as s, textParam as t };