@soulcraft/sdk 1.4.5 → 1.4.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/dist/modules/ai/index.d.ts.map +1 -1
  2. package/dist/modules/ai/index.js +15 -1
  3. package/dist/modules/ai/index.js.map +1 -1
  4. package/dist/modules/billing/firestore-provider.d.ts.map +1 -1
  5. package/dist/modules/billing/firestore-provider.js +1 -5
  6. package/dist/modules/billing/firestore-provider.js.map +1 -1
  7. package/dist/modules/billing/local-provider.d.ts.map +1 -1
  8. package/dist/modules/billing/local-provider.js +2 -6
  9. package/dist/modules/billing/local-provider.js.map +1 -1
  10. package/dist/modules/billing/model-pricing.d.ts +26 -0
  11. package/dist/modules/billing/model-pricing.d.ts.map +1 -0
  12. package/dist/modules/billing/model-pricing.js +27 -0
  13. package/dist/modules/billing/model-pricing.js.map +1 -0
  14. package/dist/modules/formats/types.d.ts +6 -21
  15. package/dist/modules/formats/types.d.ts.map +1 -1
  16. package/dist/modules/formats/types.js +6 -21
  17. package/dist/modules/formats/types.js.map +1 -1
  18. package/dist/modules/hall/browser.d.ts.map +1 -1
  19. package/dist/modules/hall/browser.js +33 -17
  20. package/dist/modules/hall/browser.js.map +1 -1
  21. package/dist/modules/kits/index.d.ts.map +1 -1
  22. package/dist/modules/kits/index.js +34 -13
  23. package/dist/modules/kits/index.js.map +1 -1
  24. package/dist/modules/kits/types.d.ts +66 -2
  25. package/dist/modules/kits/types.d.ts.map +1 -1
  26. package/dist/server/from-license.d.ts.map +1 -1
  27. package/dist/server/from-license.js +2 -1
  28. package/dist/server/from-license.js.map +1 -1
  29. package/dist/types.d.ts.map +1 -1
  30. package/dist/version.d.ts +11 -0
  31. package/dist/version.d.ts.map +1 -0
  32. package/dist/version.js +11 -0
  33. package/dist/version.js.map +1 -0
  34. package/docs/ADR-001-sdk-design.md +28 -28
  35. package/docs/ADR-002-transport-protocol.md +248 -0
  36. package/docs/ADR-003-instance-strategies.md +216 -0
  37. package/docs/IMPLEMENTATION-PLAN.md +22 -40
  38. package/docs/KIT-APP-GUIDE.md +932 -0
  39. package/docs/USAGE.md +16 -6
  40. package/package.json +1 -1
package/docs/USAGE.md CHANGED
@@ -844,13 +844,13 @@ sdk.events.emit('custom:event', payload)
844
844
  | `sdk.ai.*` | ✅ Implemented | Claude complete() + stream() |
845
845
  | `sdk.events.*` | ✅ Implemented | EventEmitter, typed, local to SDK instance |
846
846
  | `sdk.skills.*` | ✅ Implemented | VFS + bundled registry fallback |
847
- | `sdk.versions.*` | ✅ Types only | Runtime proxy works; Brainy versions API |
847
+ | `sdk.versions.*` | ✅ Implemented | Runtime proxy works; Brainy versions API |
848
848
  | `sdk.hall.*` | ✅ Implemented | Server: `createHallModule()`. Browser: `joinHallRoom()` |
849
- | `sdk.license.*` | ❌ Not yet | Will throw if accessed |
850
- | `sdk.kits.*` | ❌ Not yet | Will throw if accessed |
851
- | `sdk.formats.*` | ❌ Not yet | Will throw if accessed |
852
- | `sdk.billing.*` | ❌ Not yet | Will throw if accessed |
853
- | `sdk.notifications.*` | ❌ Not yet | Will throw if accessed |
849
+ | `sdk.license.*` | ✅ Implemented | Portal validation, heartbeat, BYOK, `getAIProvider()` |
850
+ | `sdk.kits.*` | ✅ Implemented | `load()` + `list()` via optional `@soulcraft/kits` peer dep |
851
+ | `sdk.formats.*` | ✅ Implemented | Types only — WVIZ, WDOC, WSLIDE, WQUIZ (no runtime object) |
852
+ | `sdk.billing.*` | ✅ Implemented | LocalProvider + FirestoreProvider, UsageBuffer, Stripe |
853
+ | `sdk.notifications.*` | ✅ Implemented | Postmark email + Twilio SMS + DevSender (ANSI console) |
854
854
 
855
855
  **5. Environment variables required:**
856
856
 
@@ -867,3 +867,13 @@ sdk.events.emit('custom:event', payload)
867
867
  | `HALL_WORKSHOP_SECRET` | `sdk.hall` (Workshop) | If product is `workshop` |
868
868
  | `HALL_VENUE_SECRET` | `sdk.hall` (Venue) | If product is `venue` |
869
869
  | `HALL_ACADEMY_SECRET` | `sdk.hall` (Academy) | If product is `academy` |
870
+ | `SOULCRAFT_LICENSE_KEY` | `sdk.license` | Yes — `SC-XXXX-XXXX-XXXX` format |
871
+ | `STRIPE_SECRET_KEY` | `sdk.billing` | Yes for Stripe checkout/subscriptions |
872
+ | `STRIPE_WEBHOOK_SECRET` | `sdk.billing` | Yes for Stripe webhook verification |
873
+ | `PORTAL_CREDIT_SECRET` | `sdk.billing` | Yes for Portal unified credit backend |
874
+ | `FIREBASE_SERVICE_ACCOUNT_KEY` | `sdk.billing` | Yes for Firestore billing (base64 JSON) |
875
+ | `POSTMARK_SERVER_TOKEN` | `sdk.notifications` | Yes for email delivery (Postmark) |
876
+ | `POSTMARK_FROM_EMAIL` | `sdk.notifications` | Optional — defaults to `hello@soulcraft.com` |
877
+ | `TWILIO_ACCOUNT_SID` | `sdk.notifications` | Yes for SMS delivery (Twilio) |
878
+ | `TWILIO_AUTH_TOKEN` | `sdk.notifications` | Yes for SMS delivery (Twilio) |
879
+ | `TWILIO_FROM_NUMBER` | `sdk.notifications` | Optional — defaults to `+10000000000` |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@soulcraft/sdk",
3
- "version": "1.4.5",
3
+ "version": "1.4.7",
4
4
  "description": "The unified Soulcraft platform SDK — data, auth, AI, billing, and notifications",
5
5
  "type": "module",
6
6
  "publishConfig": {