forjio-storlaunch 0.2.0__tar.gz

forjio_storlaunch-0.2.0/.gitignore

@@ -0,0 +1,8 @@
+.venv/
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.pytest_cache/

forjio_storlaunch-0.2.0/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 0.2.0
+- **Published on PyPI as `forjio-storlaunch`** (`pip install forjio-storlaunch`); the import is still `import storlaunch`. The old `storlaunch` 0.1.0 upload belongs to an account Forjio no longer publishes from (like `forjio-linksnap`).
+- **Auth is an API key now.** Pass `api_key`: an `sk_live_…` / `sk_test_…` key from Settings → API keys (default: env `STORLAUNCH_API_KEY`), sent as `Authorization: Bearer <key>`. The `key_id`/`secret` request signing and `for_merchant()`/`on_behalf_of` (`X-Storlaunch-On-Behalf-Of`) are removed: the API never accepted them, so every call answered 401. A key belongs to one workspace.
+- Writes send their idempotency key as `X-Idempotency-Key` (what Storlaunch's replay guard reads; subscription and portal-session creates require it) and `Idempotency-Key` (what it forwards to Plugipay).
+- A 204 returns None; a CSV export returns its text.
+- Methods now call the route the API really has: `payment.plans.archive` → `DELETE /payment/plans/{id}`; `payment.subscriptions.cancel(id, immediate=True)` → `DELETE /payment/subscriptions/{id}`; `storefront.licenses.revoke(key)` → `DELETE /storefront/licenses/{key}`; `account.api_keys.revoke` → `DELETE /account/api-keys/{id}` and `create` takes `name` + `environment`; `account.referrals.update_program` → `PUT`; `billing.checkout(plan=, interval=, currency=)` → `POST /billing/plugipay-invoice`; `modules.enable/disable` → `POST /modules {module, enabled}`; `inventory.levels({"variantId": …})` → `GET /inventory/stock`; `ledger.list/balances/adjust` → `/ledger/entries`, `/ledger/balance`, `/ledger/adjustments`; `reports.export_ledger()` → `GET /ledger/entries.csv`; `onboarding.complete_step` → `onboarding.complete(enable_payment=)`.
+- Removed, because the API has no such route: `payment.invoices.finalize/pay/void`, `payment.plugipay_settings`, `storefront.products.list_files` (files come with `products.get`), `storefront.deliveries.create`, `analytics.storefront/funnel`, `billing.current_plan` (use `billing.subscription`), `modules.status` (use `modules.list`), `manual_orders.create`, `discount_codes.validate`, `inbound_webhooks`. Also removed: `buyer`, whose shopper routes take the shopper's storefront session, never an API key.
+- `account.blog.list` is annotated as what it returns, a dict `{"posts": [...]}`.
+- A test checks every hand-written method's route against the API spec (`backend/openapi.json`).
+
+## 0.1.1
+- `client.api`: every feature route of the Storlaunch API, one method each (`client.api.<area>_<action>(...)`), generated from the API spec and signed like every other call.
+
+## 0.1.0
+- Initial tracked release.

forjio_storlaunch-0.2.0/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.

forjio_storlaunch-0.2.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,92 @@
+# 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/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "forjio-storlaunch"
+version = "0.2.0"
+description = "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."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+keywords = ["storlaunch", "forjio", "ecommerce", "storefront", "payments", "saas"]
+authors = [{ name = "Forjio", email = "hello@storlaunch.com" }]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Topic :: Internet :: WWW/HTTP",
+  "Topic :: Office/Business :: Financial",
+  "Typing :: Typed",
+]
+dependencies = [
+  "httpx>=0.27.0",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.0.0",
+  "respx>=0.21.1",
+]
+
+[project.urls]
+Homepage = "https://storlaunch.com"
+Source = "https://github.com/hachimi-cat/storlaunch-python"
+Issues = "https://github.com/hachimi-cat/storlaunch-python/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["storlaunch"]

forjio_storlaunch-0.2.0/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"