eps-sdk 0.1.0__tar.gz

eps_sdk-0.1.0/.gitignore

@@ -0,0 +1,86 @@
+# Bun lockfiles — project standardizes on npm (package-lock.json). Block re-adds.
+bun.lock
+bun.lockb
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Baked agent/SDK artifacts — generated from src/ at build time (npm run bake:all).
+# Never committed; created fresh on every root build and on package prepublish.
+packages/*/data/
+
+# Python build/test litter (packages/sdk-python)
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+
+# Env files (never commit secrets); keep .env.example tracked
+.env
+.env.*
+!.env.example
+
+# VM-side deploy secrets (poller image pin + GHCR auth); samples are tracked
+deploy.env
+!deploy.env.sample
+.ghcr-auth.json
+
+# Internal planning/strategy docs — kept locally, never committed (not for the
+# public repo). Removed from tracking before open-sourcing.
+docs/local-roadmap/
+# Override the global (~/.config/git/ignore) exclude so this repo tracks SDD docs.
+!docs/superpowers/
+
+# Graphify (https://github.com/Graphify-Labs/graphify)
+# graphify-out/ is regenerated on every `graphify update .` — ignore it wholesale.
+# Two exceptions are LLM-derived and expensive to recreate, so the team shares them:
+#   .graphify_labels.json(+.sig) — community names + membership signatures
+#   cache/semantic/              — extraction results, content-addressed and portable
+# With both committed, a fresh clone rebuilds the full graph via `graphify .` at no API cost.
+# Each level must be re-included before its children are re-excluded: git will not
+# descend into an excluded directory.
+graphify-out/*
+!graphify-out/.graphify_labels.json
+!graphify-out/.graphify_labels.json.sig
+!graphify-out/cache/
+graphify-out/cache/*
+!graphify-out/cache/semantic/
+.rebuild.lock
+
+
+# Ignore TypeScript incremental compilation cache
+*.tsbuildinfo
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# Playwright MCP debug artifacts
+.playwright-mcp/
+.superpowers/
+.ds-sync/
+ds-bundle/
+.design-sync/.cache/
+.design-sync/node_modules
+.design-sync/styles-src.css
+
+# graphify settings backup written by `graphify claude install`
+.claude/settings.json.graphify-bak

eps_sdk-0.1.0/LICENSE

@@ -0,0 +1,31 @@
+MIT License
+
+Copyright (c) 2026 Eko Bharat Ventures Private Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Trademark notice: This license applies to the source code of this project. The
+"Eko" and "Eko Platform Services" / "EPS" names, logos, and brand assets are
+trademarks of Eko Bharat Ventures Private Limited and are NOT licensed for
+use under the terms above. The MIT permission grant confers no trademark
+rights. Marketing copy, page content, and design/brand assets bundled in this
+repository may be subject to separate terms; the MIT grant covers the software
+(code) only.

eps_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.5
+Name: eps-sdk
+Version: 0.1.0
+Summary: Backend-only Python SDK for Eko Platform Services (EPS) APIs, with request signing built in.
+Project-URL: Homepage, https://eps.eko.in/docs
+Project-URL: Source, https://github.com/ekoindia/eps-platform/tree/main/packages/sdk-python
+Author: Eko Bharat Ventures Pvt Ltd
+License-Expression: MIT
+License-File: LICENSE
+Keywords: aeps,bbps,dmt,eko,eps,fintech,india,kyc
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# EPS Python SDK
+
+Backend-only Python client for [Eko Platform Services](https://eps.eko.in/docs)
+APIs — DMT, AePS, BBPS, KYC and verification — with HMAC request signing built
+in.
+
+```bash
+pip install eps-sdk
+```
+
+```python
+from eps_sdk import EpsClient
+
+client = EpsClient(
+    developer_key="<your_developer_key>",
+    access_key="<your_access_key>",
+    environment="sandbox",      # or "production"
+    initiator_id="9962981729",  # registered mobile of the API user
+    user_code="20810200",       # retailer/agent code
+)
+
+sender = client.call("dmt-get-sender", {"customer_id": "9123456789"})
+```
+
+One generic `call(slug, params)` covers every endpoint. The slug list, each
+endpoint's params and which of them are required all come from the same
+generated API surface the docs are built from, so the client validates your
+input **before** it signs and sends anything.
+
+## Backend only
+
+`access_key` signs every request. Never run this in anything a browser can
+reach — a leaked access key lets anyone transact as you.
+
+## What it does for you
+
+- **Signs the request** — `secret-key`, `secret-key-timestamp` and
+  `developer_key` headers on every call.
+- **Validates first** — missing required params and wrong types raise `EpsError`
+  before a request goes out.
+- **Routes the params** — path tokens, query string, JSON body, or
+  `multipart/form-data` for file-upload endpoints, per the endpoint's spec.
+- **Fails loudly** — a non-2xx response raises `EpsHttpError` (with the decoded
+  envelope on `.body`); a non-JSON body raises rather than returning `{}`.
+
+Files can be a path or an in-memory pair:
+
+```python
+client.call("activate-aeps-fingpay", {
+    "pan_card": "/path/to/pan.jpg",
+    "aadhar_front": ("aadhar.jpg", image_bytes),
+    # ...
+})
+```
+
+## Zero dependencies
+
+Standard library only (`urllib`, `hmac`, `json`). Nothing to keep patched.
+
+## Development
+
+The runtime asset `data/sdk-surface.json` is generated from the API specs, not
+committed. From the repo root:
+
+```bash
+npm run build                            # bakes data/sdk-surface.json
+cd packages/sdk-python
+PYTHONPATH=src python3 -m unittest discover -s tests
+```
+
+The test suite is the cross-language conformance suite described in
+`docs/sdk-golden-vector.md` — the same cases the Node.js and PHP SDKs must pass.
+
+MIT licensed.

eps_sdk-0.1.0/README.md

@@ -0,0 +1,74 @@
+# EPS Python SDK
+
+Backend-only Python client for [Eko Platform Services](https://eps.eko.in/docs)
+APIs — DMT, AePS, BBPS, KYC and verification — with HMAC request signing built
+in.
+
+```bash
+pip install eps-sdk
+```
+
+```python
+from eps_sdk import EpsClient
+
+client = EpsClient(
+    developer_key="<your_developer_key>",
+    access_key="<your_access_key>",
+    environment="sandbox",      # or "production"
+    initiator_id="9962981729",  # registered mobile of the API user
+    user_code="20810200",       # retailer/agent code
+)
+
+sender = client.call("dmt-get-sender", {"customer_id": "9123456789"})
+```
+
+One generic `call(slug, params)` covers every endpoint. The slug list, each
+endpoint's params and which of them are required all come from the same
+generated API surface the docs are built from, so the client validates your
+input **before** it signs and sends anything.
+
+## Backend only
+
+`access_key` signs every request. Never run this in anything a browser can
+reach — a leaked access key lets anyone transact as you.
+
+## What it does for you
+
+- **Signs the request** — `secret-key`, `secret-key-timestamp` and
+  `developer_key` headers on every call.
+- **Validates first** — missing required params and wrong types raise `EpsError`
+  before a request goes out.
+- **Routes the params** — path tokens, query string, JSON body, or
+  `multipart/form-data` for file-upload endpoints, per the endpoint's spec.
+- **Fails loudly** — a non-2xx response raises `EpsHttpError` (with the decoded
+  envelope on `.body`); a non-JSON body raises rather than returning `{}`.
+
+Files can be a path or an in-memory pair:
+
+```python
+client.call("activate-aeps-fingpay", {
+    "pan_card": "/path/to/pan.jpg",
+    "aadhar_front": ("aadhar.jpg", image_bytes),
+    # ...
+})
+```
+
+## Zero dependencies
+
+Standard library only (`urllib`, `hmac`, `json`). Nothing to keep patched.
+
+## Development
+
+The runtime asset `data/sdk-surface.json` is generated from the API specs, not
+committed. From the repo root:
+
+```bash
+npm run build                            # bakes data/sdk-surface.json
+cd packages/sdk-python
+PYTHONPATH=src python3 -m unittest discover -s tests
+```
+
+The test suite is the cross-language conformance suite described in
+`docs/sdk-golden-vector.md` — the same cases the Node.js and PHP SDKs must pass.
+
+MIT licensed.