forjio-storlaunch 0.2.0__py3-none-any.whl

forjio_storlaunch-0.2.0.dist-info/METADATA

@@ -0,0 +1,117 @@
+Metadata-Version: 2.5
+Name: forjio-storlaunch
+Version: 0.2.0
+Summary: Official Python SDK for Storlaunch — payment (checkout sessions, plans, subscriptions, invoices, receipts, customers, portal sessions, webhooks), storefront (products, licenses, deliveries), shipping, inventory, ledger, reports, payouts, discount codes, account (pixels, feeds, blog, referrals, abandoned cart, API keys, audit log, domains), analytics, billing, modules, manual orders, onboarding.
+Project-URL: Homepage, https://storlaunch.com
+Project-URL: Source, https://github.com/hachimi-cat/storlaunch-python
+Project-URL: Issues, https://github.com/hachimi-cat/storlaunch-python/issues
+Author-email: Forjio <hello@storlaunch.com>
+License: MIT
+License-File: LICENSE
+Keywords: ecommerce,forjio,payments,saas,storefront,storlaunch
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.27.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: respx>=0.21.1; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# storlaunch (Python SDK)
+
+Official Python SDK for [Storlaunch](https://storlaunch.com) — full
+parity with the Node SDK (`@forjio/storlaunch-node`).
+
+## Install
+
+```bash
+pip install forjio-storlaunch
+```
+
+## Quick start
+
+```python
+import os
+from storlaunch import StorlaunchClient
+
+client = StorlaunchClient(
+    api_key=os.environ["STORLAUNCH_API_KEY"],  # sk_live_… or sk_test_… (the default source)
+    base_url="https://storlaunch.com",  # default
+)
+
+products = client.storefront.products.list({"limit": 20})
+
+# Every feature route, one method each (generated from the API spec)
+codes = client.api.discount_codes_list(limit=5)
+```
+
+## Auth
+
+Mint a secret key in the dashboard under **Settings → API keys**:
+`sk_live_…` (production) or `sk_test_…` (sandbox). Every request carries it
+as a bearer token, and nothing else authenticates:
+
+```
+Authorization: Bearer sk_live_…
+```
+
+A key belongs to one workspace and acts as its owner. Two things it cannot
+do: create or revoke API keys (that needs a signed-in session, so
+`client.account.api_keys.create/revoke` answer 403 to a key), and call the
+shopper routes under `/api/v1/checkout`, which take the shopper's own
+storefront session.
+
+Until 0.2.0 this SDK signed requests (`key_id` + `secret`,
+`Storlaunch-HMAC-SHA256`) and scoped them with `for_merchant()` /
+`X-Storlaunch-On-Behalf-Of`. The API never accepted either, so they are gone.
+
+## Idempotency
+
+Unsafe mutations (create checkout session, create subscription, issue
+license, adjust inventory, request payout, etc.) auto-generate an
+idempotency key, sent as both `X-Idempotency-Key` (what Storlaunch's replay
+guard reads) and `Idempotency-Key` (what it forwards to Plugipay). To pin one
+yourself, drop down to `client.request(...)`.
+
+## Webhooks
+
+```python
+from storlaunch import verify_webhook
+
+raw = request.get_data()  # bytes — DO NOT re-serialise JSON
+sig = request.headers.get("X-Storlaunch-Signature", "")
+if not verify_webhook(raw, sig, secret):
+    abort(400)
+```
+
+## Resource surface
+
+| Namespace | Methods |
+|---|---|
+| `payment` | checkout_sessions, plans, subscriptions, invoices, receipts, customers, plugipay_settings, portal_sessions, webhook_endpoints, webhook_events |
+| `storefront` | products (+files), licenses, deliveries, public |
+| `account` | profile, pixels, abandoned_cart, feeds, blog, referrals, api_keys, audit_log, domains |
+| top-level | analytics, billing, modules, manual_orders, onboarding, shipping, inventory, ledger, reports, payouts, discount_codes, inbound_webhooks, buyer |
+
+For anything not yet typed, use `client.passthrough(method, path, body)`.
+
+## Errors
+
+All API failures raise `StorlaunchError(status, code, message, request_id)`.
+Transport failures (DNS, connect refused, timeout) raise the same class
+with `status=0` and `code` in `{"timeout", "network_error",
+"invalid_response"}`.
+
+## Dev
+
+```bash
+python3.12 -m venv .venv
+.venv/bin/pip install -e ".[dev]"
+.venv/bin/pytest -q
+```

forjio_storlaunch-0.2.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+storlaunch/__init__.py,sha256=LsdjkYo27OPjyDlIvk_pjsstegWzvLTDpWz6YFs6V_M,1271
+storlaunch/api_generated.py,sha256=OjF2QMxUQfnPtYWBCxiqLm6fmRoMOJonmRFB-XJg55w,163465
+storlaunch/client.py,sha256=c9VujmgErRsOflbmYg1zZilWSsNnyONpxaCzk_-azdM,29858
+storlaunch/errors.py,sha256=cejqkgY9qzDlrXbhZ4M06UxIpXnKSJ9rTrhqE45fLLQ,1143
+storlaunch/resources.py,sha256=YrqY76iPrJ_IGuYF_8gTDU5Rh6yQ5vyj2_RPrcPBYbs,4697
+storlaunch/webhooks.py,sha256=O3D09iiFGPdHZnDnqF9JapQY2df5iJazfzpq50HzBdI,3056
+forjio_storlaunch-0.2.0.dist-info/METADATA,sha256=pFASU8bRcupdH9l2Xf5v1ASyFbPuVLrQt_Qi5Qf8UzE,4285
+forjio_storlaunch-0.2.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+forjio_storlaunch-0.2.0.dist-info/licenses/LICENSE,sha256=rW8S5IWqVAXbxPGdwy_Df-YrBzv9KrJsbfsIK4oCVdk,1063
+forjio_storlaunch-0.2.0.dist-info/RECORD,,

forjio_storlaunch-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

forjio_storlaunch-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Forjio
+
+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.

storlaunch/__init__.py

@@ -0,0 +1,52 @@
+"""Official Python SDK for Storlaunch.
+
+Mirrors the Node SDK (``@forjio/storlaunch-node``) surface 1:1:
+
+- An API key (``sk_live_…`` / ``sk_test_…``) sent as ``Authorization: Bearer``.
+- Auto-generated idempotency keys for unsafe mutations.
+- Resource namespaces covering payment, storefront, account, analytics,
+  billing, modules, manual orders, onboarding, shipping, inventory, ledger,
+  reports, payouts and discount codes, plus ``client.api``: every feature
+  route, generated from the API spec.
+- Webhook signature verification (``X-Storlaunch-Signature`` HMAC).
+"""
+
+from .client import StorlaunchClient
+from .errors import StorlaunchError
+from .resources import (
+    ApiEnvelope,
+    ApiEnvelopeError,
+    ApiEnvelopeMeta,
+    CheckoutSession,
+    Customer,
+    CurrencyCode,
+    Invoice,
+    Plan,
+    Product,
+    Subscription,
+    WebhookEvent,
+)
+from .webhooks import verify_webhook
+
+__all__ = [
+    # client
+    "StorlaunchClient",
+    # errors
+    "StorlaunchError",
+    # resources
+    "ApiEnvelope",
+    "ApiEnvelopeError",
+    "ApiEnvelopeMeta",
+    "CheckoutSession",
+    "Customer",
+    "CurrencyCode",
+    "Invoice",
+    "Plan",
+    "Product",
+    "Subscription",
+    "WebhookEvent",
+    # webhooks
+    "verify_webhook",
+]
+
+__version__ = "0.2.0"