@ekoindia/eps-transact-mcp 0.1.20 → 0.1.22

package/data/eps.json

@@ -23547,5 +23547,613 @@
         }
       ]
     }
+  ],
+  "sdks": [
+    {
+      "lang": "javascript",
+      "slug": "nodejs",
+      "title": "Node.js SDK",
+      "summary": "Backend-only Node.js client for every EPS API, with HMAC signing, input validation and typed errors built in.",
+      "packageName": "@ekoindia/eps-sdk",
+      "installCommand": "npm i @ekoindia/eps-sdk",
+      "registry": "npm",
+      "registryUrl": "https://www.npmjs.com/package/@ekoindia/eps-sdk",
+      "minRuntime": "Node.js 18 or newer",
+      "dependencies": "None — standard library only (`node:crypto`, global `fetch`).",
+      "sourceUrl": "https://github.com/ekoindia/eps-platform/tree/main/packages/sdk-js",
+      "docsUrl": "https://eps.eko.in/docs/sdk/nodejs",
+      "config": [
+        {
+          "name": "developerKey",
+          "type": "string",
+          "required": true,
+          "description": "Your EPS developer key, sent as the `developer_key` header."
+        },
+        {
+          "name": "accessKey",
+          "type": "string",
+          "required": true,
+          "description": "Server-side secret used to sign every request. Never ships to a browser."
+        },
+        {
+          "name": "environment",
+          "type": "\"sandbox\" | \"production\"",
+          "required": true,
+          "description": "Selects the base URL from the embedded surface."
+        },
+        {
+          "name": "initiatorId",
+          "type": "string",
+          "required": false,
+          "description": "Default `initiator_id` (registered mobile of the API user) injected into every call."
+        },
+        {
+          "name": "userCode",
+          "type": "string",
+          "required": false,
+          "description": "Default `user_code` (retailer/agent code) injected into every call."
+        },
+        {
+          "name": "timeoutMs",
+          "type": "number",
+          "required": false,
+          "units": "milliseconds, default 30_000",
+          "description": "Aborts a request that takes longer. Named for its unit — Python and PHP use seconds."
+        },
+        {
+          "name": "fetch",
+          "type": "typeof fetch",
+          "required": false,
+          "description": "Inject a custom fetch implementation (proxies, tests)."
+        }
+      ],
+      "members": [
+        {
+          "kind": "class",
+          "name": "EpsClient",
+          "signature": "new EpsClient(options: EpsClientOptions)",
+          "description": "The client. Throws immediately if constructed where `window` exists — `accessKey` must never reach a browser."
+        },
+        {
+          "kind": "method",
+          "name": "call",
+          "signature": "client.call<T = unknown>(slug: string, params?: Record<string, unknown>): Promise<T>",
+          "description": "Validates, signs and sends one endpoint call; resolves with the decoded envelope."
+        },
+        {
+          "kind": "function",
+          "name": "signSecretKey",
+          "signature": "signSecretKey(accessKey: string, timestamp: string): string",
+          "description": "The raw signing primitive, exported for debugging. `call()` applies it for you."
+        },
+        {
+          "kind": "constant",
+          "name": "MULTIPART_JSON_FIELD",
+          "signature": "MULTIPART_JSON_FIELD = \"form-data\"",
+          "description": "Name of the single form field carrying the JSON envelope on file-upload endpoints."
+        },
+        {
+          "kind": "type",
+          "name": "EpsClientOptions",
+          "signature": "interface EpsClientOptions",
+          "description": "The constructor options above."
+        },
+        {
+          "kind": "type",
+          "name": "SdkEndpoint / SdkParam",
+          "signature": "interface SdkEndpoint, interface SdkParam",
+          "description": "Shape of one endpoint in the embedded surface (slug, method, path, params)."
+        }
+      ],
+      "errorTypes": [
+        {
+          "name": "EpsHttpError",
+          "when": "Any non-2xx response.",
+          "fields": "`status`, `url`, `body` (decoded envelope or null), `raw`"
+        },
+        {
+          "name": "EpsError",
+          "when": "Unknown slug, missing required param, wrong param type, bad option, or a 2xx body that is not JSON. `EpsHttpError` extends it."
+        },
+        {
+          "name": "TimeoutError (DOMException)",
+          "when": "The request exceeded `timeoutMs`. Surfaced raw, as Node reports it."
+        }
+      ],
+      "fileValues": [
+        "A local file path (read from disk; the filename is the basename)",
+        "A `Blob` or `File` (a `File` keeps its own name)"
+      ],
+      "notes": [
+        "ESM only (`\"type\": \"module\"`). Use `import`, or `await import()` from CommonJS.",
+        "A per-call cancellation signal is not supported yet — `timeoutMs` is the only abort source."
+      ],
+      "example": "import { EpsClient } from \"@ekoindia/eps-sdk\";\n\nconst client = new EpsClient({\n  developerKey: process.env.EPS_DEVELOPER_KEY,\n  accessKey: process.env.EPS_ACCESS_KEY,\n  initiatorId: \"9962981729\",\n  environment: \"sandbox\",\n});\n\nconst result = await client.call(\"pan-lite\", {\n  \"pan_number\": \"ABCDE1234F\",\n  \"name\": \"Rajesh Kumar\",\n  \"dob\": \"1994-08-29\"\n});\nconsole.log(result);"
+    },
+    {
+      "lang": "python",
+      "slug": "python",
+      "title": "Python SDK",
+      "summary": "Backend-only Python client for every EPS API, dependency-free and typed, with HMAC signing built in.",
+      "packageName": "eps-sdk",
+      "installCommand": "pip install eps-sdk",
+      "registry": "PyPI",
+      "registryUrl": "https://pypi.org/project/eps-sdk/",
+      "minRuntime": "Python 3.9 or newer",
+      "dependencies": "None — standard library only (`urllib`, `hmac`, `hashlib`, `mimetypes`).",
+      "sourceUrl": "https://github.com/ekoindia/eps-platform/tree/main/packages/sdk-python",
+      "docsUrl": "https://eps.eko.in/docs/sdk/python",
+      "config": [
+        {
+          "name": "developer_key",
+          "type": "str",
+          "required": true,
+          "description": "Your EPS developer key, sent as the `developer_key` header."
+        },
+        {
+          "name": "access_key",
+          "type": "str",
+          "required": true,
+          "description": "Server-side secret used to sign every request. Never ships to a browser."
+        },
+        {
+          "name": "environment",
+          "type": "\"sandbox\" | \"production\"",
+          "required": true,
+          "description": "Selects the base URL from the embedded surface."
+        },
+        {
+          "name": "initiator_id",
+          "type": "str",
+          "required": false,
+          "description": "Default `initiator_id` (registered mobile of the API user) injected into every call."
+        },
+        {
+          "name": "user_code",
+          "type": "str",
+          "required": false,
+          "description": "Default `user_code` (retailer/agent code) injected into every call."
+        },
+        {
+          "name": "timeout",
+          "type": "float",
+          "required": false,
+          "units": "seconds, default 30.0",
+          "description": "Whole-request budget passed through to `urlopen`."
+        }
+      ],
+      "members": [
+        {
+          "kind": "class",
+          "name": "EpsClient",
+          "signature": "EpsClient(developer_key, access_key, environment, initiator_id=None, user_code=None, timeout=30.0)",
+          "description": "The client — a dataclass, so keyword arguments read well."
+        },
+        {
+          "kind": "method",
+          "name": "call",
+          "signature": "client.call(slug: str, params: Mapping[str, Any] | None = None) -> Any",
+          "description": "Validates, signs and sends one endpoint call; returns the decoded envelope."
+        },
+        {
+          "kind": "method",
+          "name": "resolve_target",
+          "signature": "client.resolve_target(slug, params=None) -> Target",
+          "description": "The signed method/url/body/headers for a call, without sending it. Useful for debugging."
+        },
+        {
+          "kind": "method",
+          "name": "build_headers",
+          "signature": "client.build_headers(multipart: bool = False) -> dict[str, str]",
+          "description": "The four auth headers for a single request."
+        },
+        {
+          "kind": "function",
+          "name": "sign_secret_key",
+          "signature": "sign_secret_key(access_key: str, timestamp: str) -> str",
+          "description": "The raw signing primitive, exported for debugging."
+        },
+        {
+          "kind": "constant",
+          "name": "MULTIPART_JSON_FIELD",
+          "signature": "MULTIPART_JSON_FIELD = \"form-data\"",
+          "description": "Name of the single form field carrying the JSON envelope on file-upload endpoints."
+        },
+        {
+          "kind": "type",
+          "name": "Target",
+          "signature": "@dataclass Target(method, url, body, headers, multipart)",
+          "description": "What `resolve_target` returns."
+        }
+      ],
+      "errorTypes": [
+        {
+          "name": "EpsHttpError",
+          "when": "Any non-2xx response.",
+          "fields": "`.status`, `.url`, `.body` (decoded envelope or None), `.raw` (bytes)"
+        },
+        {
+          "name": "EpsError",
+          "when": "Unknown slug, missing required param, wrong param type, bad config, or a 2xx body that is not JSON. `EpsHttpError` subclasses it."
+        },
+        {
+          "name": "urllib.error.URLError",
+          "when": "Transport failure or timeout. Surfaced raw."
+        }
+      ],
+      "fileValues": [
+        "A path `str` or `os.PathLike` (the MIME type is guessed, falling back to `application/octet-stream`)",
+        "An in-memory `(filename, bytes)` tuple"
+      ],
+      "notes": [
+        "Paths are checked for existence during validation, so a typo fails before the request is signed."
+      ],
+      "example": "import os\n\nfrom eps_sdk import EpsClient\n\nclient = EpsClient(\n    developer_key=os.environ[\"EPS_DEVELOPER_KEY\"],\n    access_key=os.environ[\"EPS_ACCESS_KEY\"],\n    initiator_id=\"9962981729\",\n    environment=\"sandbox\",\n)\n\nresult = client.call(\"pan-lite\", {\n    \"pan_number\": \"ABCDE1234F\",\n    \"name\": \"Rajesh Kumar\",\n    \"dob\": \"1994-08-29\",\n})\nprint(result)"
+    },
+    {
+      "lang": "php",
+      "slug": "php",
+      "title": "PHP SDK",
+      "summary": "Backend-only PHP client for every EPS API, with HMAC signing, input validation and typed errors built in.",
+      "packageName": "ekoindia/eps-sdk",
+      "installCommand": "composer require ekoindia/eps-sdk",
+      "registry": "Packagist",
+      "registryUrl": "https://packagist.org/packages/ekoindia/eps-sdk",
+      "minRuntime": "PHP 8.1 or newer",
+      "dependencies": "None beyond the `curl` and `json` extensions.",
+      "sourceUrl": "https://github.com/ekoindia/eps-platform/tree/main/packages/sdk-php",
+      "docsUrl": "https://eps.eko.in/docs/sdk/php",
+      "installNotes": [
+        "Published from a read-only mirror (`ekoindia/eps-sdk-php`), subtree-split from the monorepo."
+      ],
+      "config": [
+        {
+          "name": "$developerKey",
+          "type": "string",
+          "required": true,
+          "description": "Your EPS developer key, sent as the `developer_key` header."
+        },
+        {
+          "name": "$accessKey",
+          "type": "string",
+          "required": true,
+          "description": "Server-side secret used to sign every request. Never ships to a browser."
+        },
+        {
+          "name": "$environment",
+          "type": "\"sandbox\" | \"production\"",
+          "required": true,
+          "description": "Selects the base URL from the embedded surface."
+        },
+        {
+          "name": "$initiatorId",
+          "type": "string",
+          "required": false,
+          "description": "Default `initiator_id` (registered mobile of the API user) injected into every call."
+        },
+        {
+          "name": "$userCode",
+          "type": "string",
+          "required": false,
+          "description": "Default `user_code` (retailer/agent code) injected into every call."
+        },
+        {
+          "name": "$timeout",
+          "type": "float",
+          "required": false,
+          "units": "seconds, default 30.0",
+          "description": "Whole-request budget, applied as `CURLOPT_TIMEOUT_MS` so sub-second values are not truncated."
+        }
+      ],
+      "members": [
+        {
+          "kind": "class",
+          "name": "Eko\\Eps\\EpsClient",
+          "signature": "new EpsClient(string $developerKey, string $accessKey, string $environment, ?string $initiatorId = null, ?string $userCode = null, float $timeout = 30.0)",
+          "description": "The client. Use named arguments."
+        },
+        {
+          "kind": "method",
+          "name": "call",
+          "signature": "$client->call(string $slug, array $params = []): array",
+          "description": "Validates, signs and sends one endpoint call; returns the decoded envelope."
+        },
+        {
+          "kind": "method",
+          "name": "resolveTarget",
+          "signature": "$client->resolveTarget(string $slug, array $params = []): array",
+          "description": "The signed url/body/method for a call, without sending it. Exposed for testing."
+        },
+        {
+          "kind": "method",
+          "name": "curlOptions",
+          "signature": "$client->curlOptions(array $target): array",
+          "description": "The cURL option map `call()` uses, including the timeout. Exposed for testing."
+        },
+        {
+          "kind": "method",
+          "name": "decodeResponse",
+          "signature": "EpsClient::decodeResponse(int $status, string $url, string $raw): array",
+          "description": "Static. Applies the shared response contract to one raw response — the seam the conformance tests drive."
+        },
+        {
+          "kind": "method",
+          "name": "signSecretKey",
+          "signature": "EpsClient::signSecretKey(string $accessKey, string $timestamp): string",
+          "description": "Static. The raw signing primitive, exposed for debugging."
+        },
+        {
+          "kind": "constant",
+          "name": "EpsClient::MULTIPART_JSON_FIELD",
+          "signature": "const MULTIPART_JSON_FIELD = 'form-data'",
+          "description": "Name of the single form field carrying the JSON envelope on file-upload endpoints."
+        }
+      ],
+      "errorTypes": [
+        {
+          "name": "Eko\\Eps\\EpsHttpException",
+          "when": "Any non-2xx response.",
+          "fields": "`->status`, `->url`, `->body` (decoded envelope or null), `->raw`"
+        },
+        {
+          "name": "Eko\\Eps\\EpsException",
+          "when": "Transport failure, a malformed surface asset, or a 2xx body that is not JSON. Extends `\\RuntimeException`."
+        },
+        {
+          "name": "\\InvalidArgumentException",
+          "when": "Unknown environment or slug, missing required param, wrong param type. SPL already has the right class, and it is a `\\LogicException`, so it cannot share a base with the runtime failures."
+        }
+      ],
+      "fileValues": [
+        "A local file path (wrapped in a `CURLFile` for you)",
+        "A `\\CURLFile` you built yourself"
+      ],
+      "notes": [
+        "Presence is checked with `isset()`, so a param explicitly set to `null` counts as missing — matching every other SDK."
+      ],
+      "example": "<?php\nuse Eko\\Eps\\EpsClient;\n\n$client = new EpsClient(\n    developerKey: getenv('EPS_DEVELOPER_KEY'),\n    accessKey: getenv('EPS_ACCESS_KEY'),\n    initiatorId: '9962981729',\n    environment: 'sandbox'\n);\n\n$result = $client->call('pan-lite', [\n    'pan_number' => 'ABCDE1234F',\n    'name' => 'Rajesh Kumar',\n    'dob' => '1994-08-29'\n]);\nprint_r($result);"
+    },
+    {
+      "lang": "go",
+      "slug": "go",
+      "title": "Go SDK",
+      "summary": "Backend-only Go client for every EPS API — standard library only, context-aware, with HMAC signing built in.",
+      "packageName": "github.com/ekoindia/eps-sdk-go",
+      "installCommand": "go get github.com/ekoindia/eps-sdk-go",
+      "registry": "Go modules",
+      "registryUrl": "https://pkg.go.dev/github.com/ekoindia/eps-sdk-go",
+      "minRuntime": "Go 1.22 or newer",
+      "dependencies": "None — `go.mod` has no `require` block and there is no `go.sum`.",
+      "sourceUrl": "https://github.com/ekoindia/eps-platform/tree/main/packages/sdk-go",
+      "docsUrl": "https://eps.eko.in/docs/sdk/go",
+      "installNotes": [
+        "Published from a read-only mirror (`ekoindia/eps-sdk-go`) as a git tag; there is no separate registry."
+      ],
+      "config": [
+        {
+          "name": "DeveloperKey",
+          "type": "string",
+          "required": true,
+          "description": "Your EPS developer key, sent as the `developer_key` header."
+        },
+        {
+          "name": "AccessKey",
+          "type": "string",
+          "required": true,
+          "description": "Server-side secret used to sign every request. Never ships to a browser."
+        },
+        {
+          "name": "Environment",
+          "type": "\"sandbox\" | \"production\"",
+          "required": true,
+          "description": "Selects the base URL from the embedded surface."
+        },
+        {
+          "name": "InitiatorID",
+          "type": "string",
+          "required": false,
+          "description": "Default `initiator_id` (registered mobile of the API user) injected into every call."
+        },
+        {
+          "name": "UserCode",
+          "type": "string",
+          "required": false,
+          "description": "Default `user_code` (retailer/agent code) injected into every call."
+        },
+        {
+          "name": "HTTPClient",
+          "type": "*http.Client",
+          "required": false,
+          "units": "default: 30s timeout",
+          "description": "Control timeouts, proxies or retries by supplying your own client."
+        }
+      ],
+      "members": [
+        {
+          "kind": "function",
+          "name": "eps.New",
+          "signature": "eps.New(cfg eps.Config) (*eps.Client, error)",
+          "description": "Builds a client. Safe for concurrent use once constructed."
+        },
+        {
+          "kind": "method",
+          "name": "Call",
+          "signature": "client.Call(ctx context.Context, slug string, params map[string]any) (map[string]any, error)",
+          "description": "Validates, signs and sends one endpoint call. The only SDK with per-call cancellation."
+        },
+        {
+          "kind": "method",
+          "name": "ResolveTarget",
+          "signature": "client.ResolveTarget(slug string, params map[string]any) (*eps.Target, error)",
+          "description": "The signed request for a call, without sending it."
+        },
+        {
+          "kind": "method",
+          "name": "BuildHeaders",
+          "signature": "client.BuildHeaders(multipartBody bool) map[string]string",
+          "description": "The four auth headers for a single request."
+        },
+        {
+          "kind": "function",
+          "name": "eps.Sign",
+          "signature": "eps.Sign(accessKey, timestamp string) string",
+          "description": "The raw signing primitive, exported for debugging."
+        },
+        {
+          "kind": "type",
+          "name": "eps.File",
+          "signature": "eps.File{Name string; Content []byte}",
+          "description": "An in-memory upload."
+        },
+        {
+          "kind": "constant",
+          "name": "eps.MultipartJSONField",
+          "signature": "MultipartJSONField = \"form-data\"",
+          "description": "Name of the single form field carrying the JSON envelope on file-upload endpoints."
+        }
+      ],
+      "errorTypes": [
+        {
+          "name": "*eps.HTTPError",
+          "when": "Any non-2xx response. Match it with `errors.As`.",
+          "fields": "`StatusCode`, `URL`, `Body` (decoded envelope or nil), `Raw`"
+        },
+        {
+          "name": "error",
+          "when": "Unknown slug, missing required param, wrong param type, a 2xx body that is not JSON, or a transport failure. Messages are lowercase and `eps:`-prefixed, per Go convention."
+        }
+      ],
+      "fileValues": [
+        "A local file path `string`",
+        "An `eps.File{Name, Content}` (or `*eps.File`) for an in-memory upload"
+      ],
+      "notes": [
+        "Map keys are sorted before encoding, so query strings and multipart bodies are byte-deterministic.",
+        "The surface is embedded with `go:embed`, so the package needs no network call to resolve a slug."
+      ],
+      "example": "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"log\"\n\t\"os\"\n\n\teps \"github.com/ekoindia/eps-sdk-go\"\n)\n\nfunc main() {\n\tclient, err := eps.New(eps.Config{\n\t\tDeveloperKey: os.Getenv(\"EPS_DEVELOPER_KEY\"),\n\t\tAccessKey:    os.Getenv(\"EPS_ACCESS_KEY\"),\n\t\tInitiatorID:  \"9962981729\",\n\t\tEnvironment:  \"sandbox\",\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tresult, err := client.Call(context.Background(), \"pan-lite\", map[string]any{\n\t\t\"pan_number\": \"ABCDE1234F\",\n\t\t\"name\":       \"Rajesh Kumar\",\n\t\t\"dob\":        \"1994-08-29\",\n\t})\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tfmt.Println(result)\n}"
+    },
+    {
+      "lang": "java",
+      "slug": "java",
+      "title": "Java SDK",
+      "summary": "Backend-only Java client for every EPS API, published from a git tag via JitPack, with HMAC signing built in.",
+      "packageName": "com.github.ekoindia:eps-sdk-java",
+      "installCommand": "com.github.ekoindia:eps-sdk-java",
+      "registry": "JitPack",
+      "registryUrl": "https://jitpack.io/#ekoindia/eps-sdk-java",
+      "minRuntime": "Java 17 or newer",
+      "dependencies": "One: Gson, because Java has no JSON parser in the standard library. HTTP uses the JDK's own `java.net.http`.",
+      "sourceUrl": "https://github.com/ekoindia/eps-platform/tree/main/packages/sdk-java",
+      "docsUrl": "https://eps.eko.in/docs/sdk/java",
+      "installNotes": [
+        "Published through JitPack from a git tag — add the JitPack repository alongside Maven Central.",
+        "Gradle: `maven { url 'https://jitpack.io' }`, then `implementation 'com.github.ekoindia:eps-sdk-java:<tag>'`.",
+        "Maven: a `<repository>` with id `jitpack.io` and url `https://jitpack.io`, then the `com.github.ekoindia:eps-sdk-java` dependency."
+      ],
+      "config": [
+        {
+          "name": ".developerKey(…)",
+          "type": "String",
+          "required": true,
+          "description": "Your EPS developer key, sent as the `developer_key` header."
+        },
+        {
+          "name": ".accessKey(…)",
+          "type": "String",
+          "required": true,
+          "description": "Server-side secret used to sign every request. Never ships to a browser."
+        },
+        {
+          "name": ".environment(…)",
+          "type": "\"sandbox\" | \"production\"",
+          "required": true,
+          "description": "Selects the base URL from the embedded surface."
+        },
+        {
+          "name": ".initiatorId(…)",
+          "type": "String",
+          "required": false,
+          "description": "Default `initiator_id` (registered mobile of the API user) injected into every call."
+        },
+        {
+          "name": ".userCode(…)",
+          "type": "String",
+          "required": false,
+          "description": "Default `user_code` (retailer/agent code) injected into every call."
+        },
+        {
+          "name": ".httpClient(…)",
+          "type": "HttpClient",
+          "required": false,
+          "units": "default: 30s connect + 30s per request",
+          "description": "Control timeouts, proxies or redirects by supplying your own client."
+        }
+      ],
+      "members": [
+        {
+          "kind": "class",
+          "name": "in.eko.eps.EpsClient",
+          "signature": "EpsClient.builder()…build()",
+          "description": "The client, built through a fluent builder."
+        },
+        {
+          "kind": "method",
+          "name": "call",
+          "signature": "client.call(String slug, Map<String, Object> params): Map<String, Object>",
+          "description": "Validates, signs and sends one endpoint call; returns the decoded envelope."
+        },
+        {
+          "kind": "method",
+          "name": "resolveTarget",
+          "signature": "client.resolveTarget(String slug, Map<String, Object> params): Target",
+          "description": "The signed request for a call, without sending it."
+        },
+        {
+          "kind": "method",
+          "name": "buildHeaders",
+          "signature": "client.buildHeaders(boolean multipart): Map<String, String>",
+          "description": "The four auth headers for a single request."
+        },
+        {
+          "kind": "method",
+          "name": "sign",
+          "signature": "EpsClient.sign(String accessKey, String timestamp): String",
+          "description": "Static. The raw signing primitive, exposed for debugging."
+        },
+        {
+          "kind": "type",
+          "name": "EpsClient.EpsFile",
+          "signature": "record EpsFile(String name, byte[] content)",
+          "description": "An in-memory upload."
+        },
+        {
+          "kind": "constant",
+          "name": "EpsClient.MULTIPART_JSON_FIELD",
+          "signature": "MULTIPART_JSON_FIELD = \"form-data\"",
+          "description": "Name of the single form field carrying the JSON envelope on file-upload endpoints."
+        }
+      ],
+      "errorTypes": [
+        {
+          "name": "EpsClient.EpsHttpException",
+          "when": "Any non-2xx response.",
+          "fields": "`status`, `url`, `body` (decoded envelope or null), `raw`"
+        },
+        {
+          "name": "EpsClient.EpsException",
+          "when": "Unknown slug, missing required param, wrong param type, transport failure, or a 2xx body that is not JSON. Unchecked — it extends `RuntimeException`."
+        }
+      ],
+      "fileValues": [
+        "A `String` path, a `java.nio.file.Path`, or a `java.io.File`",
+        "An `EpsClient.EpsFile(name, content)` for an in-memory upload"
+      ],
+      "notes": [
+        "Upload parts are sent as `application/octet-stream`; the MIME type is not sniffed.",
+        "Gson is configured with `serializeNulls()` — required for wire conformance, since every other SDK keeps explicit nulls."
+      ],
+      "example": "import in.eko.eps.EpsClient;\nimport java.util.Map;\n\nEpsClient client = EpsClient.builder()\n    .developerKey(System.getenv(\"EPS_DEVELOPER_KEY\"))\n    .accessKey(System.getenv(\"EPS_ACCESS_KEY\"))\n    .initiatorId(\"9962981729\")\n    .environment(\"sandbox\")\n    .build();\n\nMap<String, Object> result = client.call(\"pan-lite\", Map.of(\n        \"pan_number\", \"ABCDE1234F\",\n        \"name\", \"Rajesh Kumar\",\n        \"dob\", \"1994-08-29\"\n    ));\nSystem.out.println(result);"
+    }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ekoindia/eps-transact-mcp",
-	"version": "0.1.20",
+	"version": "0.1.22",
 	"description": "Transactional MCP server for Eko Platform Services (EPS) verification APIs — remote (streamable HTTP) and local (stdio).",
 	"license": "MIT",
 	"type": "module",
@@ -29,7 +29,7 @@
 		"prepublishOnly": "npm run bake && npm run build"
 	},
 	"dependencies": {
-		"@ekoindia/eps-sdk": "^0.1.1",
+		"@ekoindia/eps-sdk": "^1.0.0",
 		"@hono/node-server": "^1.0.0",
 		"@modelcontextprotocol/sdk": "^1.29.0",
 		"hono": "^4.0.0"