lampamazaza-new-intents-sdk 0.47.1

package/dist/src/intents/intent-payload-builder.cjs

@@ -0,0 +1,208 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_expirable_nonce = require('./expirable-nonce.cjs');
+const require_intent_payload_factory = require('./intent-payload-factory.cjs');
+let lampamazaza_internal_utils = require("lampamazaza-internal-utils");
+
+//#region src/intents/intent-payload-builder.ts
+/**
+* Fluent builder for constructing intent payloads with environment context.
+* Provides a convenient API for generating intents that can be signed with different standards.
+*
+* @example
+* ```typescript
+* const sdk = new IntentsSDK({ env: 'production', referral: 'my-app' });
+*
+* // Build an intent payload
+* const payload = await sdk.intentBuilder()
+*   .setSigner('0x1234...') // EVM address or NEAR account
+*   .setDeadline(new Date(Date.now() + 5 * 60 * 1000)) // 5 minutes
+*   .addIntent({
+*     intent: 'ft_withdraw',
+*     token: 'usdc.omft.near',
+*     amount: '1000000',
+*     receiver_id: 'user.near'
+*   })
+*   .build();
+*
+* // Sign with your preferred method
+* const multiPayload = await signer.signIntent(payload);
+* ```
+*/
+var IntentPayloadBuilder = class IntentPayloadBuilder {
+	constructor(config) {
+		this.intents = [];
+		this.envConfig = config.envConfig;
+		this.saltManager = config.saltManager;
+		this.verifyingContract = this.envConfig.contractID;
+	}
+	/**
+	* Set the signer ID (address or account that will sign the intent).
+	* Can be an EVM address (for ERC191) or NEAR account ID (for NEP413).
+	*
+	* @param signerId - The identifier of the signer (must be a valid NEAR account ID)
+	* @returns The builder instance for chaining with updated type
+	* @throws Error if signerId is not a valid NEAR account ID
+	*/
+	setSigner(signerId) {
+		if (!lampamazaza_internal_utils.utils.validateNearAddress(signerId)) throw new Error(`Invalid signer_id: "${signerId}" is not a valid NEAR account ID`);
+		this.signerId = signerId;
+		return this;
+	}
+	/**
+	* Set the deadline for the intent expiration.
+	* If not set, defaults to 1 minute from build time.
+	*
+	* @param deadline - The expiration time for the intent
+	* @returns The builder instance for chaining
+	*/
+	setDeadline(deadline) {
+		this.deadline = deadline;
+		return this;
+	}
+	/**
+	* Add an intent to the payload.
+	* Multiple intents can be added and will execute atomically.
+	*
+	* @param intent - The intent primitive to add
+	* @returns The builder instance for chaining
+	*/
+	addIntent(intent) {
+		this.intents.push(intent);
+		return this;
+	}
+	/**
+	* Add multiple intents to the payload at once.
+	*
+	* @param intents - Array of intent primitives to add
+	* @returns The builder instance for chaining
+	*/
+	addIntents(intents) {
+		this.intents.push(...intents);
+		return this;
+	}
+	/**
+	* Override the verifying contract address.
+	* Use with caution - normally this is automatically set based on environment.
+	*
+	* @param contractAddress - The contract address to use
+	* @returns The builder instance for chaining
+	*/
+	setVerifyingContract(contractAddress) {
+		this.verifyingContract = contractAddress;
+		return this;
+	}
+	/**
+	* Set a custom nonce. If not provided, a nonce will be automatically generated.
+	* The nonce must be a valid versioned nonce format.
+	*
+	* @param nonce - Custom nonce string (base64 encoded)
+	* @returns The builder instance for chaining
+	*/
+	setNonce(nonce) {
+		this.customNonce = nonce;
+		return this;
+	}
+	/**
+	* Clear all intents from the builder.
+	*
+	* @returns The builder instance for chaining
+	*/
+	clearIntents() {
+		this.intents = [];
+		return this;
+	}
+	/**
+	* Reset the builder to its initial state.
+	* Keeps environment and salt manager but clears all user-set values.
+	*
+	* @returns The builder instance for chaining
+	*/
+	reset() {
+		this.signerId = void 0;
+		this.deadline = void 0;
+		this.intents = [];
+		this.customNonce = void 0;
+		this.verifyingContract = this.envConfig.contractID;
+		return this;
+	}
+	/**
+	* Build the intent payload using a custom salt.
+	* Use this method if you need explicit control over the salt.
+	*
+	* @param salt - The salt to use for nonce generation
+	* @returns The constructed intent payload with appropriate typing
+	*/
+	buildWithSalt(salt) {
+		const deadline = this.deadline ?? new Date(Date.now() + require_intent_payload_factory.DEFAULT_DEADLINE_MS);
+		const nonceDeadline = new Date(deadline.getTime() + require_intent_payload_factory.DEFAULT_NONCE_DEADLINE_OFFSET_MS);
+		const nonce = this.customNonce ?? require_expirable_nonce.VersionedNonceBuilder.encodeNonce(salt, nonceDeadline);
+		return {
+			verifying_contract: this.verifyingContract,
+			signer_id: this.signerId,
+			deadline: deadline.toISOString(),
+			nonce,
+			intents: [...this.intents]
+		};
+	}
+	/**
+	* Build the intent payload. Automatically fetches a fresh salt if needed.
+	* This is the recommended method for most use cases.
+	*
+	* @returns Promise resolving to the constructed intent payload with appropriate typing
+	*/
+	async build() {
+		const salt = await this.saltManager.getCachedSalt();
+		return this.buildWithSalt(salt);
+	}
+	/**
+	* Build and sign the intent payload in one step.
+	* Convenience method that combines build() and signing.
+	*
+	* @param signer - The intent signer to use
+	* @returns Promise resolving to the signed multi-payload and the raw payload
+	*/
+	async buildAndSign(signer) {
+		const payload = await this.build();
+		return {
+			signed: await signer.signIntent(payload),
+			payload
+		};
+	}
+	/**
+	* Create a new builder instance with the same configuration.
+	* Useful when you need multiple independent builders.
+	*
+	* @returns A new IntentPayloadBuilder instance
+	*/
+	clone() {
+		const builder = new IntentPayloadBuilder({
+			envConfig: this.envConfig,
+			saltManager: this.saltManager
+		});
+		builder.verifyingContract = this.verifyingContract;
+		builder.signerId = this.signerId;
+		builder.deadline = this.deadline;
+		builder.intents = [...this.intents];
+		builder.customNonce = this.customNonce;
+		return builder;
+	}
+	/**
+	* Get the current state of the builder as a plain object.
+	* Useful for debugging or inspecting the builder configuration.
+	*
+	* @returns Object containing the current builder state
+	*/
+	getState() {
+		return {
+			envConfig: this.envConfig,
+			verifyingContract: this.verifyingContract,
+			signerId: this.signerId,
+			deadline: this.deadline,
+			intents: [...this.intents],
+			customNonce: this.customNonce
+		};
+	}
+};
+
+//#endregion
+exports.IntentPayloadBuilder = IntentPayloadBuilder;

package/dist/src/intents/intent-payload-builder.d.cts

@@ -0,0 +1,161 @@
+import { Salt } from "./expirable-nonce.cjs";
+import { IntentPayload, IntentPrimitive, MultiPayload } from "./shared-types.cjs";
+import { IIntentSigner } from "./interfaces/intent-signer.cjs";
+import { ISaltManager } from "./interfaces/salt-manager.cjs";
+import { EnvConfig } from "lampamazaza-internal-utils";
+
+//#region src/intents/intent-payload-builder.d.ts
+interface IntentPayloadBuilderConfig {
+  envConfig: EnvConfig;
+  saltManager: ISaltManager;
+}
+/**
+ * Type helper to make signer_id required when HasSigner is true
+ */
+type IntentPayloadWithSigner<HasSigner extends boolean> = HasSigner extends true ? IntentPayload & {
+  signer_id: string;
+} : IntentPayload;
+/**
+ * Fluent builder for constructing intent payloads with environment context.
+ * Provides a convenient API for generating intents that can be signed with different standards.
+ *
+ * @example
+ * ```typescript
+ * const sdk = new IntentsSDK({ env: 'production', referral: 'my-app' });
+ *
+ * // Build an intent payload
+ * const payload = await sdk.intentBuilder()
+ *   .setSigner('0x1234...') // EVM address or NEAR account
+ *   .setDeadline(new Date(Date.now() + 5 * 60 * 1000)) // 5 minutes
+ *   .addIntent({
+ *     intent: 'ft_withdraw',
+ *     token: 'usdc.omft.near',
+ *     amount: '1000000',
+ *     receiver_id: 'user.near'
+ *   })
+ *   .build();
+ *
+ * // Sign with your preferred method
+ * const multiPayload = await signer.signIntent(payload);
+ * ```
+ */
+declare class IntentPayloadBuilder<HasSigner extends boolean = false> {
+  private envConfig;
+  private saltManager;
+  private verifyingContract;
+  private signerId?;
+  private deadline?;
+  private intents;
+  private customNonce?;
+  constructor(config: IntentPayloadBuilderConfig);
+  /**
+   * Set the signer ID (address or account that will sign the intent).
+   * Can be an EVM address (for ERC191) or NEAR account ID (for NEP413).
+   *
+   * @param signerId - The identifier of the signer (must be a valid NEAR account ID)
+   * @returns The builder instance for chaining with updated type
+   * @throws Error if signerId is not a valid NEAR account ID
+   */
+  setSigner(signerId: string): IntentPayloadBuilder<true>;
+  /**
+   * Set the deadline for the intent expiration.
+   * If not set, defaults to 1 minute from build time.
+   *
+   * @param deadline - The expiration time for the intent
+   * @returns The builder instance for chaining
+   */
+  setDeadline(deadline: Date): this;
+  /**
+   * Add an intent to the payload.
+   * Multiple intents can be added and will execute atomically.
+   *
+   * @param intent - The intent primitive to add
+   * @returns The builder instance for chaining
+   */
+  addIntent(intent: IntentPrimitive): this;
+  /**
+   * Add multiple intents to the payload at once.
+   *
+   * @param intents - Array of intent primitives to add
+   * @returns The builder instance for chaining
+   */
+  addIntents(intents: IntentPrimitive[]): this;
+  /**
+   * Override the verifying contract address.
+   * Use with caution - normally this is automatically set based on environment.
+   *
+   * @param contractAddress - The contract address to use
+   * @returns The builder instance for chaining
+   */
+  setVerifyingContract(contractAddress: string): this;
+  /**
+   * Set a custom nonce. If not provided, a nonce will be automatically generated.
+   * The nonce must be a valid versioned nonce format.
+   *
+   * @param nonce - Custom nonce string (base64 encoded)
+   * @returns The builder instance for chaining
+   */
+  setNonce(nonce: string): this;
+  /**
+   * Clear all intents from the builder.
+   *
+   * @returns The builder instance for chaining
+   */
+  clearIntents(): this;
+  /**
+   * Reset the builder to its initial state.
+   * Keeps environment and salt manager but clears all user-set values.
+   *
+   * @returns The builder instance for chaining
+   */
+  reset(): IntentPayloadBuilder<false>;
+  /**
+   * Build the intent payload using a custom salt.
+   * Use this method if you need explicit control over the salt.
+   *
+   * @param salt - The salt to use for nonce generation
+   * @returns The constructed intent payload with appropriate typing
+   */
+  buildWithSalt(salt: Salt): IntentPayloadWithSigner<HasSigner>;
+  /**
+   * Build the intent payload. Automatically fetches a fresh salt if needed.
+   * This is the recommended method for most use cases.
+   *
+   * @returns Promise resolving to the constructed intent payload with appropriate typing
+   */
+  build(): Promise<IntentPayloadWithSigner<HasSigner>>;
+  /**
+   * Build and sign the intent payload in one step.
+   * Convenience method that combines build() and signing.
+   *
+   * @param signer - The intent signer to use
+   * @returns Promise resolving to the signed multi-payload and the raw payload
+   */
+  buildAndSign(signer: IIntentSigner): Promise<{
+    signed: MultiPayload;
+    payload: IntentPayloadWithSigner<HasSigner>;
+  }>;
+  /**
+   * Create a new builder instance with the same configuration.
+   * Useful when you need multiple independent builders.
+   *
+   * @returns A new IntentPayloadBuilder instance
+   */
+  clone(): IntentPayloadBuilder<HasSigner>;
+  /**
+   * Get the current state of the builder as a plain object.
+   * Useful for debugging or inspecting the builder configuration.
+   *
+   * @returns Object containing the current builder state
+   */
+  getState(): {
+    envConfig: EnvConfig;
+    verifyingContract: string;
+    signerId?: string;
+    deadline?: Date;
+    intents: IntentPrimitive[];
+    customNonce?: string;
+  };
+}
+//#endregion
+export { IntentPayloadBuilder };

package/dist/src/intents/intent-payload-builder.d.ts

@@ -0,0 +1,161 @@
+import { Salt } from "./expirable-nonce.js";
+import { IntentPayload, IntentPrimitive, MultiPayload } from "./shared-types.js";
+import { IIntentSigner } from "./interfaces/intent-signer.js";
+import { ISaltManager } from "./interfaces/salt-manager.js";
+import { EnvConfig } from "lampamazaza-internal-utils";
+
+//#region src/intents/intent-payload-builder.d.ts
+interface IntentPayloadBuilderConfig {
+  envConfig: EnvConfig;
+  saltManager: ISaltManager;
+}
+/**
+ * Type helper to make signer_id required when HasSigner is true
+ */
+type IntentPayloadWithSigner<HasSigner extends boolean> = HasSigner extends true ? IntentPayload & {
+  signer_id: string;
+} : IntentPayload;
+/**
+ * Fluent builder for constructing intent payloads with environment context.
+ * Provides a convenient API for generating intents that can be signed with different standards.
+ *
+ * @example
+ * ```typescript
+ * const sdk = new IntentsSDK({ env: 'production', referral: 'my-app' });
+ *
+ * // Build an intent payload
+ * const payload = await sdk.intentBuilder()
+ *   .setSigner('0x1234...') // EVM address or NEAR account
+ *   .setDeadline(new Date(Date.now() + 5 * 60 * 1000)) // 5 minutes
+ *   .addIntent({
+ *     intent: 'ft_withdraw',
+ *     token: 'usdc.omft.near',
+ *     amount: '1000000',
+ *     receiver_id: 'user.near'
+ *   })
+ *   .build();
+ *
+ * // Sign with your preferred method
+ * const multiPayload = await signer.signIntent(payload);
+ * ```
+ */
+declare class IntentPayloadBuilder<HasSigner extends boolean = false> {
+  private envConfig;
+  private saltManager;
+  private verifyingContract;
+  private signerId?;
+  private deadline?;
+  private intents;
+  private customNonce?;
+  constructor(config: IntentPayloadBuilderConfig);
+  /**
+   * Set the signer ID (address or account that will sign the intent).
+   * Can be an EVM address (for ERC191) or NEAR account ID (for NEP413).
+   *
+   * @param signerId - The identifier of the signer (must be a valid NEAR account ID)
+   * @returns The builder instance for chaining with updated type
+   * @throws Error if signerId is not a valid NEAR account ID
+   */
+  setSigner(signerId: string): IntentPayloadBuilder<true>;
+  /**
+   * Set the deadline for the intent expiration.
+   * If not set, defaults to 1 minute from build time.
+   *
+   * @param deadline - The expiration time for the intent
+   * @returns The builder instance for chaining
+   */
+  setDeadline(deadline: Date): this;
+  /**
+   * Add an intent to the payload.
+   * Multiple intents can be added and will execute atomically.
+   *
+   * @param intent - The intent primitive to add
+   * @returns The builder instance for chaining
+   */
+  addIntent(intent: IntentPrimitive): this;
+  /**
+   * Add multiple intents to the payload at once.
+   *
+   * @param intents - Array of intent primitives to add
+   * @returns The builder instance for chaining
+   */
+  addIntents(intents: IntentPrimitive[]): this;
+  /**
+   * Override the verifying contract address.
+   * Use with caution - normally this is automatically set based on environment.
+   *
+   * @param contractAddress - The contract address to use
+   * @returns The builder instance for chaining
+   */
+  setVerifyingContract(contractAddress: string): this;
+  /**
+   * Set a custom nonce. If not provided, a nonce will be automatically generated.
+   * The nonce must be a valid versioned nonce format.
+   *
+   * @param nonce - Custom nonce string (base64 encoded)
+   * @returns The builder instance for chaining
+   */
+  setNonce(nonce: string): this;
+  /**
+   * Clear all intents from the builder.
+   *
+   * @returns The builder instance for chaining
+   */
+  clearIntents(): this;
+  /**
+   * Reset the builder to its initial state.
+   * Keeps environment and salt manager but clears all user-set values.
+   *
+   * @returns The builder instance for chaining
+   */
+  reset(): IntentPayloadBuilder<false>;
+  /**
+   * Build the intent payload using a custom salt.
+   * Use this method if you need explicit control over the salt.
+   *
+   * @param salt - The salt to use for nonce generation
+   * @returns The constructed intent payload with appropriate typing
+   */
+  buildWithSalt(salt: Salt): IntentPayloadWithSigner<HasSigner>;
+  /**
+   * Build the intent payload. Automatically fetches a fresh salt if needed.
+   * This is the recommended method for most use cases.
+   *
+   * @returns Promise resolving to the constructed intent payload with appropriate typing
+   */
+  build(): Promise<IntentPayloadWithSigner<HasSigner>>;
+  /**
+   * Build and sign the intent payload in one step.
+   * Convenience method that combines build() and signing.
+   *
+   * @param signer - The intent signer to use
+   * @returns Promise resolving to the signed multi-payload and the raw payload
+   */
+  buildAndSign(signer: IIntentSigner): Promise<{
+    signed: MultiPayload;
+    payload: IntentPayloadWithSigner<HasSigner>;
+  }>;
+  /**
+   * Create a new builder instance with the same configuration.
+   * Useful when you need multiple independent builders.
+   *
+   * @returns A new IntentPayloadBuilder instance
+   */
+  clone(): IntentPayloadBuilder<HasSigner>;
+  /**
+   * Get the current state of the builder as a plain object.
+   * Useful for debugging or inspecting the builder configuration.
+   *
+   * @returns Object containing the current builder state
+   */
+  getState(): {
+    envConfig: EnvConfig;
+    verifyingContract: string;
+    signerId?: string;
+    deadline?: Date;
+    intents: IntentPrimitive[];
+    customNonce?: string;
+  };
+}
+//#endregion
+export { IntentPayloadBuilder };