@terkoizmy/intent-sdk 1.0.0

package/dist/types/templates.d.ts

@@ -0,0 +1,18 @@
+import type { IntentType, IntentParameters, IntentConstraints } from "./intent";
+/**
+ * Intent Template
+ * Defines the structure for each intent type
+ */
+export interface IntentTemplate {
+    type: IntentType;
+    requiredFields: (keyof IntentParameters)[];
+    optionalFields: (keyof IntentParameters)[];
+    defaults: Partial<IntentParameters>;
+    defaultConstraints: Partial<IntentConstraints>;
+    validate?: (params: IntentParameters) => boolean;
+}
+/**
+ * Template Registry
+ */
+export type TemplateRegistry = Map<IntentType, IntentTemplate>;
+//# sourceMappingURL=templates.d.ts.map

package/dist/types/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/types/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IAGjB,cAAc,EAAE,CAAC,MAAM,gBAAgB,CAAC,EAAE,CAAC;IAG3C,cAAc,EAAE,CAAC,MAAM,gBAAgB,CAAC,EAAE,CAAC;IAG3C,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAGpC,kBAAkB,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAG/C,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC"}

package/dist/types/templates.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=templates.js.map

package/dist/types/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/types/templates.ts"],"names":[],"mappings":""}

package/dist/types/token.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Token Resolver Types
+ *
+ * Types untuk Token Resolver service yang menggunakan Swing.xyz API
+ * untuk resolve token symbol + chain → contract address.
+ */
+/**
+ * Resolved Token
+ *
+ * Hasil resolve dari API setelah lookup symbol + chain.
+ *
+ * CONTOH:
+ *   resolve("USDC", "polygon") → {
+ *     symbol: "USDC",
+ *     address: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+ *     decimals: 6,
+ *     chain: "polygon",
+ *     name: "USD Coin",
+ *     price: 0.9999
+ *   }
+ */
+export interface ResolvedToken {
+    /** Token symbol (e.g., "USDC", "ETH") */
+    symbol: string;
+    /** Contract address on the specified chain */
+    address: string;
+    /** Token decimals (e.g., 6 for USDC, 18 for ETH) */
+    decimals: number;
+    /** Chain identifier (e.g., "ethereum", "polygon", "solana") */
+    chain: string;
+    /** Full token name (e.g., "USD Coin") — optional */
+    name?: string;
+    /** Current price in USD — optional */
+    price?: number;
+    /** Logo URL — optional */
+    logoUrl?: string;
+}
+/**
+ * Token Resolver Configuration
+ *
+ * Konfigurasi untuk TokenResolver service.
+ * Bisa di-pass via ParserConfig saat inisialisasi IntentParser.
+ *
+ * CONTOH PENGGUNAAN:
+ *   const parser = new IntentParser({
+ *     tokenResolver: {
+ *       enabled: true,
+ *       cacheTTL: 300_000,  // 5 menit
+ *       timeout: 5000,      // 5 detik
+ *     }
+ *   });
+ *
+ *   // Atau dengan custom resolver:
+ *   const parser = new IntentParser({
+ *     tokenResolver: {
+ *       enabled: true,
+ *       customResolver: async (symbol, chain) => {
+ *         // Custom logic, e.g., from local database
+ *         return { symbol, address: "0x...", decimals: 18, chain };
+ *       }
+ *     }
+ *   });
+ */
+export interface TokenResolverConfig {
+    /**
+     * Enable/disable token resolver
+     * Jika false, parser tidak akan melakukan API call → tetap sync
+     * Default: true
+     */
+    enabled: boolean;
+    /**
+     * Cache Time-To-Live dalam milliseconds
+     * Hasil resolve di-cache selama durasi ini untuk menghindari API call berulang
+     * Default: 300_000 (5 menit)
+     */
+    cacheTTL: number;
+    /**
+     * Request timeout dalam milliseconds
+     * Jika API tidak merespon dalam durasi ini, resolve return null
+     * Default: 5000 (5 detik)
+     */
+    timeout: number;
+    /**
+     * Maximum number of entries in cache
+     * When exceeded, oldest entries are evicted (FIFO)
+     * Default: 1000
+     */
+    maxCacheSize: number;
+    /**
+     * Custom resolver function — override Swing.xyz API
+     *
+     * INPUT: symbol (e.g., "USDC"), chain (e.g., "polygon")
+     * OUTPUT: Promise<ResolvedToken | null>
+     *
+     * Jika disediakan, Swing.xyz API TIDAK akan dipanggil.
+     * Useful untuk:
+     * - Testing (mock resolver)
+     * - Production (pakai API internal / database sendiri)
+     * - Offline mode (pakai static token list)
+     */
+    customResolver?: (symbol: string, chain: string) => Promise<ResolvedToken | null>;
+}
+/**
+ * Cache entry untuk internal use di TokenResolver
+ */
+export interface TokenCacheEntry {
+    /** Resolved token data */
+    token: ResolvedToken;
+    /** Timestamp saat entry di-cache (Date.now()) */
+    cachedAt: number;
+}
+/**
+ * Swing.xyz API Response shape
+ *
+ * Berdasarkan: GET https://platform.swing.xyz/api/v1/tokens?chain={chain}&symbol={symbol}
+ *
+ * Response adalah array of tokens (biasanya 1 untuk exact match).
+ */
+export interface SwingTokenResponse {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    logo: string;
+    chain: string;
+    price: number;
+    marketCap?: number;
+    totalVolume?: number;
+    totalSupply?: number;
+    coingeckoId?: string;
+}
+//# sourceMappingURL=token.d.ts.map

package/dist/types/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/types/token.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,aAAa;IAC1B,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IAEf,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAEhB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IAEjB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IAEd,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,CACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,KACZ,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,0BAA0B;IAC1B,KAAK,EAAE,aAAa,CAAC;IAErB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/types/token.js

@@ -0,0 +1,8 @@
+/**
+ * Token Resolver Types
+ *
+ * Types untuk Token Resolver service yang menggunakan Swing.xyz API
+ * untuk resolve token symbol + chain → contract address.
+ */
+export {};
+//# sourceMappingURL=token.js.map

package/dist/types/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/types/token.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@terkoizmy/intent-sdk",
+  "version": "1.0.0",
+  "description": "Lightweight intent parser & solver SDK for blockchain transactions — parse natural language into structured intents, solve cross-chain bridges, and settle on-chain",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "intent",
+    "parser",
+    "solver",
+    "blockchain",
+    "web3",
+    "cross-chain",
+    "bridge",
+    "erc-7683",
+    "nlp",
+    "defi"
+  ],
+  "author": "Terkoizmy",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/terkoizmy/intent-sdk.git"
+  },
+  "homepage": "https://github.com/terkoizmy/intent-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/terkoizmy/intent-sdk/issues"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "bun --watch src/index.ts",
+    "test": "bun test",
+    "clean": "rimraf dist",
+    "prepublishOnly": "bun run clean && bun run build"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.9",
+    "bun-types": "^1.3.9",
+    "rimraf": "^6.1.3",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "ethers": "^6.16.0",
+    "viem": "^2.46.2",
+    "zod": "^4.3.6"
+  }
+}