@proappstore/sdk 1.6.0 → 1.7.0

package/README.md

@@ -133,6 +133,104 @@ const license = await app.license.current()
 const valid = await app.license.validate('LIC-ABC-123')
 ```
 
+### Maps (Geocoding + Embeds)
+
+Address-to-coordinates and map embeds. Powered by OpenStreetMap/Nominatim. No Google API keys needed.
+
+```ts
+// Geocode an address
+const results = await app.maps.geocode('Times Square, New York')
+// [{lat: 40.758, lng: -73.985, displayName: "Times Square...", address: {...}}]
+
+// Reverse geocode
+const place = await app.maps.reverseGeocode(40.758, -73.985)
+
+// Embed map in iframe
+<iframe src={app.maps.embedUrl(40.758, -73.985)} />
+
+// Static tile image
+<img src={app.maps.staticUrl(40.758, -73.985)} />
+```
+
+### Storage (File Upload)
+
+Upload images, videos, documents. Public files get URLs usable in `<img src>` without auth.
+
+```ts
+// Private upload (owner-only access)
+await app.storage.upload('docs/resume.pdf', file, 'application/pdf')
+
+// Public upload (anyone can view)
+await app.storage.uploadPublic('avatar.jpg', file, 'image/jpeg')
+const url = app.storage.publicUrl('avatar.jpg')  // works in <img src>
+
+// List, download, delete
+const files = await app.storage.list()
+const response = await app.storage.download('docs/resume.pdf')
+await app.storage.delete('docs/resume.pdf')
+```
+
+## React Hooks (recommended)
+
+Hooks give you full control over your UI while the platform handles auth, subscriptions, and gating. Import from `@proappstore/sdk/hooks`.
+
+### useProAuth
+
+Auth state + actions. The primary way apps interact with platform identity.
+
+```tsx
+import { initPro } from '@proappstore/sdk'
+import { useProAuth } from '@proappstore/sdk/hooks'
+
+const app = initPro({ appId: 'my-app' })
+
+function App() {
+  const { user, loading, signIn, signOut, deleteAccount } = useProAuth(app)
+  if (loading) return <p>Loading...</p>
+  if (!user) return <button onClick={signIn}>Sign in with GitHub</button>
+  return <p>Welcome, {user.login}! <button onClick={signOut}>Sign out</button></p>
+}
+```
+
+### useProSubscription
+
+Subscription state + actions. Check if user is subscribed, upgrade, manage billing.
+
+```tsx
+import { useProSubscription } from '@proappstore/sdk/hooks'
+
+function Billing() {
+  const { subscription, isPro, loading, upgrade, manageBilling } = useProSubscription(app)
+  if (loading) return <p>Loading...</p>
+  if (!isPro) return <button onClick={() => upgrade()}>Upgrade to Pro</button>
+  return <button onClick={manageBilling}>Manage billing</button>
+}
+```
+
+### useProGate
+
+Combined auth + subscription gate. Returns a single `gate` state for easy conditional rendering.
+
+```tsx
+import { initPro } from '@proappstore/sdk'
+import { useProGate } from '@proappstore/sdk/hooks'
+
+const app = initPro({ appId: 'my-app' })
+
+function App() {
+  const { gate, user, signIn, upgrade } = useProGate(app, { allowFree: true })
+
+  if (gate === 'loading') return <p>Loading...</p>
+  if (gate === 'signed-out') return <button onClick={signIn}>Sign in</button>
+  if (gate === 'no-subscription') return <button onClick={() => upgrade()}>Upgrade</button>
+  return <p>Welcome, {user?.login}!</p>
+}
+```
+
+Gate states: `'loading'` | `'signed-out'` | `'no-subscription'` | `'ready'`
+
+Pass `{ allowFree: true }` to skip the subscription check (lets free users through).
+
 ## ProShell Component
 
 A React component that handles auth gates, subscription checks, and renders a platform-level shell with topbar and user menu.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proappstore/sdk",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Browser SDK for paid apps on proappstore.online — subscriptions, license keys, premium modules.",
   "license": "MIT",
   "type": "module",