@pickleball/expo-sdk 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# @pickleball/expo-sdk
+
+## 0.1.1
+
+### Patch Changes
+
+- 7718e9a: Prepare the first canary release of the foreground Expo livestream SDK, server
+  control-plane client, config plugin, webhook verification, and First VOD guide.
+
+## 0.1.0
+
+- Initial canary: foreground LiveKit engine, provider/hook, Vietnamese and English
+  livestream screen, partner proxy transport, and Expo CNG config plugin.
+- Requires an Expo Development Build; Expo Go and web are unsupported.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pickleball Live contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# `@pickleball/expo-sdk`
+
+Foreground livestreaming for Expo iOS and Android, with a headless state-machine API and a ready-made recording screen. Every successful session uses server-side recording.
+
+## Native requirements
+
+This package requires an Expo Development Build. Expo Go and web are intentionally unsupported because LiveKit needs native WebRTC modules. Supported Expo SDK range: `>=56 <58`.
+
+Install the peer dependencies with the versions compatible with your Expo SDK, then add the config plugin and rebuild the native app:
+
+```json
+{
+  "expo": {
+    "plugins": [
+      [
+        "@pickleball/expo-sdk",
+        {
+          "cameraPermission": "Allow this app to livestream matches.",
+          "microphonePermission": "Allow this app to capture match audio."
+        }
+      ]
+    ]
+  }
+}
+```
+
+The plugin composes the official LiveKit Expo plugin and declares the WebRTC
+permissions required by LiveKit through Expo CNG; do not edit native projects
+manually. The permission set follows the native requirements documented by the
+MIT-licensed LiveKit React Native/WebRTC projects; this package does not bundle
+the community `@config-plugins/react-native-webrtc` plugin.
+
+## Usage
+
+```tsx
+import {
+  LivestreamScreen,
+  PickleballLiveProvider,
+  createHttpSessionProvider,
+} from "@pickleball/expo-sdk";
+
+const sessionProvider = createHttpSessionProvider({
+  baseUrl: "https://partner.example.com/mobile/live",
+  headers: async () => ({ Authorization: `Bearer ${await getUserToken()}` }),
+});
+
+export function MatchLive() {
+  return (
+    <PickleballLiveProvider
+      sessionProvider={sessionProvider}
+      bootstrapInput={{
+        sdkVersion: "0.1.0",
+        platform: "ios",
+        bundleId: "com.example.app",
+        installationId: "your-existing-installation-id",
+      }}
+    >
+      <LivestreamScreen
+        input={{
+          externalSessionId: "match-123",
+          title: "Court 1",
+          consentVersion: "2026-01",
+        }}
+      />
+    </PickleballLiveProvider>
+  );
+}
+```
+
+`createHttpSessionProvider` talks only to the partner-owned proxy routes `/bootstrap`, `/sessions`, `/sessions/:id/refresh`, and `/sessions/:id/end`. It has no API-key option. Keep the Pickleball API key in the backend.
+Production proxy URLs must use HTTPS; plain HTTP is accepted only for loopback development URLs such as `http://localhost:3000`.
+
+Tokens stay in memory. The only persisted value is a bounded `{sessionId, pendingEnd}` record used to finish a session after connectivity returns. Remote policy can change data and flags, but native changes require a semver release and a rebuilt app.
+
+For custom UI, use `useLivestream()` and its `prepare`, `start`, `stop`, `retry`, `switchCamera`, and `setMicrophoneEnabled` actions. `LivestreamScreen` supports Vietnamese/English copy, theme tokens, and preview/header/controls/error render overrides.

package/app.plugin.js

@@ -0,0 +1,6 @@
+import { createRequire } from "node:module";
+
+const require = createRequire(import.meta.url);
+const plugin = require("./dist/plugin.cjs").default;
+
+export default plugin;

package/dist/chunk-VHLUJQG5.js

@@ -0,0 +1,17 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// package.json
+var version = "0.1.1";
+
+// src/version.ts
+var PICKLEBALL_EXPO_SDK_VERSION = version;
+
+export {
+  __require,
+  PICKLEBALL_EXPO_SDK_VERSION
+};