@unisim/sdk 0.1.0

package/README.md

@@ -0,0 +1,101 @@
+# @unisim/sdk
+
+The shared React SDK for the Universal Suite. Every product (Universal PDF, Webinar, Exports, Cyber Assess, Ergo Assess) imports this package.
+
+**No product should import `@supabase/supabase-js` directly** — go through the SDK so the underlying backend stays swappable.
+
+## Install
+
+```bash
+npm install @unisim/sdk
+```
+
+## Setup
+
+Wrap your app in `<UniversalProvider>`:
+
+```tsx
+import { UniversalProvider } from '@unisim/sdk'
+
+const config = {
+  supabaseUrl: import.meta.env.VITE_SUPABASE_URL!,
+  supabaseAnonKey: import.meta.env.VITE_SUPABASE_ANON_KEY!,
+  product: 'pdf',                                 // or 'webinar' | 'exports' | 'cyber_assess' | 'ergo_assess'
+  cookieDomain: import.meta.env.PROD ? '.unisim.co.uk' : undefined,
+}
+
+createRoot(document.getElementById('root')!).render(
+  <UniversalProvider config={config}>
+    <App />
+  </UniversalProvider>,
+)
+```
+
+In production, the `cookieDomain` of `.unisim.co.uk` makes the auth session shared across every product subdomain (no SSO/OAuth dance needed).
+
+## Hooks
+
+### Identity
+
+```ts
+import { useUser, useOrg } from '@unisim/sdk'
+
+const { user, loading } = useUser()
+const { org, orgs, setActiveOrg } = useOrg()
+```
+
+### Entitlements
+
+```ts
+import { useHasAccess, useHasFeature, useSeat } from '@unisim/sdk'
+
+if (!useHasAccess('webinar')) return <UpsellPaywall />
+if (useHasFeature('webinar.anonymous_attendees')) showAnonToggle()
+
+const { active: hasSeat } = useSeat()             // Enterprise seat check
+if (!hasSeat) return <NoSeatAssigned />
+```
+
+### Changelog
+
+```ts
+import { useChangelog } from '@unisim/sdk'
+
+const { releases, currentVersion } = useChangelog({ limit: 5 })
+```
+
+### Branding
+
+```ts
+import { useOrgBranding } from '@unisim/sdk'
+
+const { logo_url, brand_color } = useOrgBranding()
+```
+
+### Usage telemetry
+
+```ts
+import { track, useUsageTracker } from '@unisim/sdk'
+
+// Mount the tracker once near the app root:
+useUsageTracker()
+
+// Then call track() from anywhere:
+track('pdf.document.opened', { pages: 12 })
+```
+
+### Org admin
+
+```ts
+import {
+  useOrgMembers, useOrgSeats, useAuditLog,
+  assignSeat, revokeSeat, reassignSeat,
+} from '@unisim/sdk'
+
+const { pool, seats } = useOrgSeats()             // { total, assigned, available }
+const result = await assignSeat(supabase, { orgId, userId, assignedByUserId })
+```
+
+## Versioning
+
+The SDK follows the suite's CalVer (`YYYY.MM.N`). Every product upgrades together when there's a coordinated release, so keep deps pinned per product but update them in a single sweep.

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@unisim/sdk",
+  "version": "0.1.0",
+  "description": "Shared React SDK for the Universal Suite — auth, entitlements, usage telemetry, changelog, org admin.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@supabase/supabase-js": "^2.45.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "react": "^18.3.0",
+    "typescript": "^5.7.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}