# AeThex OS — npm package toolkit

> TypeScript-first packages for cross-platform apps, SaaS products, games, and AI tools.
> All packages: `npm install @aethex.os/<name>`
> Docs: https://aethex.dev/docs

## Packages

### @aethex.os/core
Foundational utilities. Typed event emitter, deep merge, async retry with backoff, unique ID generation.
`npm install @aethex.os/core`

### @aethex.os/supabase
Supabase client factories for Node.js servers. `createAdminClient()`, `createUserClient()`, `requireAuth()` Express middleware, `configFromEnv()`.
`npm install @aethex.os/supabase @supabase/supabase-js`

### @aethex.os/middleware
Express middleware. `requireAuth`, `optionalAuth`, `requireRole`, `requireAdmin`, `createCorsOptions`, `createCapabilityGuard`.
`npm install @aethex.os/middleware`

### @aethex.os/stripe
Stripe subscription helpers. `createCheckoutSession`, `createBillingPortalSession`, `createOrRetrieveCustomer`, `handleSubscriptionEvent`, `constructWebhookEvent`, `parseRawBody`.
`npm install @aethex.os/stripe stripe`

### @aethex.os/ai
Gemini AI chat client. `AiClient` class with `chat()`, `complete()`, tool-calling support, `createAiChatHandler()` Express middleware.
`npm install @aethex.os/ai @google/genai`

### @aethex.os/passport
OAuth federation — link multiple providers (GitHub, Discord, Google, Roblox, etc.) to one user identity. `PassportManager`, `federateOAuthUser`, `linkProvider`, `unlinkProvider`. Storage-adapter pattern: Supabase adapter included, bring your own DB.
`npm install @aethex.os/passport`

### @aethex.os/discord
Discord OAuth and Activity auth. `buildOAuthUrl`, `exchangeCode`, `getDiscordUser`, `getAvatarUrl`, `refreshTokens`, `verifyActivityToken`, `createActivityAuthHandler`.
`npm install @aethex.os/discord`

### @aethex.os/registry
Plan-based feature gating for SaaS. `Registry` class, `createRegistry`, React hooks: `useFeature`, `useFeatures`, `usePlan`, `usePlanFeatures`. React components: `Gate`, `withFeature`, `RegistryProvider`.
`npm install @aethex.os/registry`

### @aethex.os/hooks
React hooks. `useTouchGestures`, `useOfflineSync`, `useDeviceFilePicker`, `useClipboard`, `useShare`.
`npm install @aethex.os/hooks react`

### @aethex.os/mobile
Capacitor mobile hooks. `useHaptics`, `useDeviceCamera`, `useBiometricAuth`, `useGeolocation`, `useNetwork`, `useFilesystem`, `useToast`, `useDeviceContacts`, `detectPlatform`, `isMobile`, `isDesktop`.
`npm install @aethex.os/mobile react @capacitor/core`

### @aethex.os/crypto
E2E encryption. `CryptoManager` using TweetNaCl. Key generation, encrypt/decrypt, pluggable storage (localStorage or in-memory).
`npm install @aethex.os/crypto`

### @aethex.os/webrtc
WebRTC peer connections. `WebRTCManager` with socket.io signaling, `createOffer`, `handleOffer`, `addIceCandidate`, `addTrack`, `onRemoteTrack`.
`npm install @aethex.os/webrtc socket.io-client`

### @aethex.os/connect
Social graph API client. `ConnectClient` with auto token refresh. Methods: `getFriends`, `sendFriendRequest`, `acceptFriendRequest`, `declineFriendRequest`, `getPendingFriendRequests`, `getProfile`, `getRealms`.
`npm install @aethex.os/connect axios`

### @aethex.os/game
Game platform types and Zod schemas. Platforms: Minecraft, Roblox, Steam, Meta. Schemas: `GameAccountSchema`, `GameProfileSchema`, `GameServerSchema`, `MatchmakingTicketSchema`, `GameSessionSchema`, `GameItemSchema`.
`npm install @aethex.os/game`

### @aethex.os/lang
AeThex language compiler programmatic API. `AeThexCompiler`, `Lexer`, `Parser`, `JavaScriptGenerator`, `LuaGenerator`. Targets: javascript, roblox (Lua), uefn (Verse), unity (C#).
`npm install @aethex.os/lang`

### @aethex.os/cli
AeThex compiler CLI. `npx aethex compile file.aethex --target javascript`.
`npm install -g @aethex.os/cli`