missilya-sdk 0.2.0__tar.gz

missilya_sdk-0.2.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+dist/
+build/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+*.log
+.env
+.env.*

missilya_sdk-0.2.0/CHANGELOG.md

@@ -0,0 +1,66 @@
+# Changelog
+
+All notable changes to `missilya-sdk` are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/) and the project adheres to
+[Semantic Versioning](https://semver.org/). The version is kept in lock-step with
+`missilya-sdk-sandbox` so the parity contract holds.
+
+## [Unreleased]
+
+## [0.2.0] - 2026-06-14
+
+### Added
+
+- **WhatsApp module** (`missilya_sdk.whatsapp`) — a provider-abstracted,
+  two-way WhatsApp capability for embedding WhatsApp across apps:
+  - `WhatsAppClient` (default provider **Meta Cloud API**, with **Twilio** as an
+    alternative) — `send_text`, `send_template`, `send_media`, `send_interactive`,
+    `mark_read`, returning `WhatsAppMessage`.
+  - Inbound webhook helpers — `verify_subscription` (Meta GET handshake),
+    `verify_signature` (fail-closed `X-Hub-Signature-256` HMAC over the raw body),
+    and `parse_inbound` (normalises Meta or Twilio payloads into `InboundMessage`).
+- **Google Sign-In** (`missilya_sdk.auth.google`) — `verify_google_token`
+  validates a Google ID token against Google's JWKS (RS256), issuer, audience,
+  and expiry; `sign_in_with_google` then mints a first-party Missilya JWT so apps
+  get one consistent session token. Adds the optional `[auth]` extra
+  (`cryptography`) and the `GoogleIdentity` / `GoogleSession` results.
+- New vault keys: `WHATSAPP_PROVIDER`, `WHATSAPP_ACCESS_TOKEN`,
+  `WHATSAPP_PHONE_NUMBER_ID`, `WHATSAPP_API_VERSION`, `WHATSAPP_APP_SECRET`,
+  `WHATSAPP_VERIFY_TOKEN`, `GOOGLE_OAUTH_CLIENT_ID`.
+
+### Notes
+
+- The legacy `notifications.send_whatsapp` (Twilio text relay) is unchanged for
+  backward compatibility; `missilya_sdk.whatsapp` is the forward path.
+- Public API parity with `missilya-sdk-sandbox` is maintained (31 modules).
+
+## [0.1.0] - 2026-06-11
+
+### Added
+
+- **AI module** — `LlmChat` (sync/async/stream) backed by LiteLLM with a
+  provider Adapter Engine and configurable runtime failover; `generate_image`,
+  `text_to_speech`, `speech_to_text`, `translate`, `generate_video`.
+- **Payments module** — `StripeCheckout` (create/retrieve session, verify
+  webhook) with `CheckoutSessionRequest` / `CheckoutSession` / `WebhookEvent`.
+- **Notifications module** — `send_email` (Resend), `send_sms` / `send_whatsapp`
+  (Twilio).
+- **Auth module** — `create_token` / `verify_token` / `decode_token` (HS256).
+- **Vault module** — `VaultClient` for Infisical Universal Auth + secret read,
+  with shared/app project fallback, in-memory TTL cache, retry/backoff, and a
+  fail-closed production policy.
+- **Config** — `get_config` with VAULT-first resolution and a production
+  env-secret guard.
+- **Context** — `TenantContext` and the `MissilyaSDK` facade for multi-tenant
+  scoping and request traceability.
+- **Monitoring** — secret-redacting structured logging, correlation IDs, and
+  usage analytics (`track_event`, `track_latency`).
+- **Governance tooling** — `tools/check_forbidden_imports.py`.
+- **Packaging** — `src/` layout, PEP 621 `pyproject.toml`, optional extras
+  (`[ai]`, `[payments]`, `[notifications]`, `[all]`, `[dev]`), CI workflows.
+
+### Security
+
+- All credentials sourced from MISSILYA VAULT; no hardcoded keys. Secrets are
+  redacted from logs and never returned to application code except by the
+  provider-facing module that needs them.

missilya_sdk-0.2.0/LICENSE

@@ -0,0 +1,35 @@
+MISSILYA GROUP — PROPRIETARY LICENCE (SOURCE-AVAILABLE)
+
+Copyright (c) 2026 MISSILYA GROUP. All rights reserved.
+
+This software and its source code are the proprietary property of MISSILYA GROUP.
+They are published on a public package index for distribution convenience only.
+Publication does not place this software in the public domain, does not make it
+open source, and grants no rights beyond those stated below.
+
+GRANT
+  You are granted a non-exclusive, non-transferable, revocable licence to
+  download, install and execute unmodified copies of this package for the sole
+  purpose of interoperating with MISSILYA GROUP services under a valid
+  commercial agreement with MISSILYA GROUP.
+
+RESTRICTIONS
+  Without prior written authorisation from MISSILYA GROUP you may not:
+    (a) copy, reproduce or redistribute the source code, in whole or in part;
+    (b) modify, adapt, translate or create derivative works;
+    (c) reverse engineer, decompile or disassemble, except to the extent this
+        restriction is unenforceable under applicable law;
+    (d) use the source code, its structure, or its interfaces to build a
+        competing or substantially similar product;
+    (e) remove or alter any proprietary notice.
+
+NO WARRANTY
+  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.
+
+LIMITATION OF LIABILITY
+  IN NO EVENT SHALL MISSILYA GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR ITS USE.
+
+Licensing enquiries: dev@missilya.com