@pickleball/expo-sdk 0.2.0 → 1.0.0

package/dist/{chunk-6JOMESNT.js → chunk-XL4CISVQ.js}

@@ -1,5 +1,5 @@
 // package.json
-var version = "0.2.0";
+var version = "1.0.0";
 
 // src/version.ts
 var PICKLEBALL_EXPO_SDK_VERSION = version;

package/dist/chunk-ZSKSXOCZ.js

@@ -0,0 +1,139 @@
+import {
+  ExpoSdkConfigurationError,
+  ExpoSdkTimeoutError,
+  InvalidResponseError,
+  NetworkUnavailableError,
+  PickleballExpoError,
+  errorFromCode,
+  isSdkRemoteConfig
+} from "./chunk-XGP2MN5R.js";
+
+// src/session-grant.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isFiniteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+function isBootstrap(value) {
+  return isRecord(value) && isSdkRemoteConfig(value.config) && isFiniteNumber(value.serverTime) && typeof value.rolloutEnabled === "boolean" && (value.message === void 0 || typeof value.message === "string");
+}
+function isTelemetryCredentials(value) {
+  return isRecord(value) && typeof value.endpoint === "string" && /^https:\/\//.test(value.endpoint) && typeof value.token === "string" && value.token.length > 0 && isFiniteNumber(value.expiresAt);
+}
+function isSessionGrant(value) {
+  return isRecord(value) && typeof value.sessionId === "string" && value.sessionId.length > 0 && typeof value.serverUrl === "string" && /^rtmps?:\/\//i.test(value.serverUrl) && typeof value.participantToken === "string" && value.participantToken.length > 0 && (value.playbackUrl === null || typeof value.playbackUrl === "string") && isFiniteNumber(value.tokenExpiresAt) && isTelemetryCredentials(value.telemetry) && isSdkRemoteConfig(value.config);
+}
+function optionalNullableString(value) {
+  return value === void 0 || value === null || typeof value === "string";
+}
+function isCameraGrant(value) {
+  return isSessionGrant(value) && /^rtmps?:\/\//i.test(value.serverUrl) && (value.status === "scheduled" || value.status === "live") && optionalNullableString(value.matchRef) && optionalNullableString(value.courtRef) && optionalNullableString(value.watchUrl) && optionalNullableString(value.convexUrl);
+}
+function isSessionRefresh(value) {
+  if (!isRecord(value) || !isSdkRemoteConfig(value.config)) return false;
+  if (value.participantToken !== void 0 && (typeof value.participantToken !== "string" || !value.participantToken)) {
+    return false;
+  }
+  if (value.tokenExpiresAt !== void 0 && !isFiniteNumber(value.tokenExpiresAt)) {
+    return false;
+  }
+  return value.telemetry === void 0 || isTelemetryCredentials(value.telemetry);
+}
+function isSessionStatus(value) {
+  return isRecord(value) && typeof value.sessionId === "string" && value.sessionId.length > 0 && typeof value.status === "string" && value.status.length > 0;
+}
+function sessionApiBaseFromTelemetryEndpoint(endpoint) {
+  if (!/^https:\/\//.test(endpoint) || !endpoint.endsWith("/telemetry")) {
+    throw new InvalidResponseError("The telemetry endpoint must be an HTTPS \u2026/telemetry URL");
+  }
+  return endpoint.slice(0, -"/telemetry".length);
+}
+var PRIVATE_LAN_HOST = /^(?:10\.\d{1,3}\.\d{1,3}\.\d{1,3}|172\.(?:1[6-9]|2\d|3[01])\.\d{1,3}\.\d{1,3}|192\.168\.\d{1,3}\.\d{1,3})$/;
+function normalizeBaseUrl(value) {
+  try {
+    const url = new URL(value);
+    const loopbackHosts = /* @__PURE__ */ new Set(["localhost", "127.0.0.1", "[::1]"]);
+    const secure = url.protocol === "https:";
+    const localDevelopment = url.protocol === "http:" && loopbackHosts.has(url.hostname);
+    const devPrivateLan = typeof __DEV__ !== "undefined" && __DEV__ === true && url.protocol === "http:" && PRIVATE_LAN_HOST.test(url.hostname);
+    if (!secure && !localDevelopment && !devPrivateLan || url.username || url.password) {
+      throw new Error();
+    }
+    return value.replace(/\/+$/, "");
+  } catch {
+    throw new ExpoSdkConfigurationError(
+      "baseUrl must use HTTPS (HTTP is allowed only for localhost loopback)"
+    );
+  }
+}
+function joinUrl(base, path) {
+  return `${base}/${path.replace(/^\/+/, "")}`;
+}
+function parseEnvelopeError(envelope, httpStatus) {
+  const body = isRecord(envelope) && isRecord(envelope.error) ? envelope.error : null;
+  const error = body && typeof body.code === "string" ? errorFromCode(body.code, typeof body.message === "string" ? body.message : void 0) : new InvalidResponseError();
+  return Object.assign(
+    error,
+    { httpStatus },
+    body && typeof body.reason === "string" ? { reason: body.reason } : {},
+    body && typeof body.retryAfterMs === "number" ? { retryAfterMs: body.retryAfterMs } : {}
+  );
+}
+function createJsonPoster(options = {}) {
+  const fetchImplementation = options.fetch ?? globalThis.fetch;
+  if (typeof fetchImplementation !== "function") {
+    throw new ExpoSdkConfigurationError("A Fetch API implementation is required");
+  }
+  const timeoutMs = options.timeoutMs ?? 1e4;
+  return async function post(url, body, headers = {}) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+      const response = await fetchImplementation(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...headers },
+        body: JSON.stringify(body),
+        signal: controller.signal,
+        redirect: "error"
+      });
+      const envelope = await response.json().catch(() => {
+        throw new InvalidResponseError();
+      });
+      if (!response.ok) throw parseEnvelopeError(envelope, response.status);
+      if (!isRecord(envelope) || !("data" in envelope)) {
+        throw new InvalidResponseError();
+      }
+      return envelope.data;
+    } catch (error) {
+      if (controller.signal.aborted) throw new ExpoSdkTimeoutError();
+      if (error instanceof PickleballExpoError) throw error;
+      if (error instanceof TypeError) {
+        throw new NetworkUnavailableError(void 0, { cause: error });
+      }
+      throw error;
+    } finally {
+      clearTimeout(timeout);
+    }
+  };
+}
+function httpStatusOf(error) {
+  const status = error?.httpStatus;
+  return typeof status === "number" ? status : void 0;
+}
+
+export {
+  isRecord,
+  isFiniteNumber,
+  isBootstrap,
+  isTelemetryCredentials,
+  isSessionGrant,
+  isCameraGrant,
+  isSessionRefresh,
+  isSessionStatus,
+  sessionApiBaseFromTelemetryEndpoint,
+  normalizeBaseUrl,
+  joinUrl,
+  createJsonPoster,
+  httpStatusOf
+};

package/dist/convex-command-subscription-Cabh9tND.d.ts

@@ -0,0 +1,41 @@
+import { S as SessionCommandSubscription } from './engine-BSvSdCSE.js';
+
+/**
+ * Kênh nhận lệnh device-rtmp qua WEBSOCKET (Convex subscription) thay poll HTTP
+ * 2 giây. Vì sao đổi: poll 2s là 2 function call mỗi 2 giây MỖI MÁY chạy suốt
+ * ngày đêm — ở 200 máy là ~518 triệu call/tháng, gấp 20 lần quota gói Pro.
+ * Subscription chỉ chạy lại (và tính tiền) KHI hàng lệnh của phiên đổi: lệnh về
+ * tức thì (<1s), còn lúc rảnh gần như 0.
+ *
+ * CHỈ dùng cho máy FIRST-PARTY nối thẳng Convex (có URL .convex.cloud). Máy đối
+ * tác đi qua proxy không có đường websocket trực tiếp → giữ nguyên poll HTTP.
+ *
+ * Auth: gửi telemetry token THÔ làm tham số query, backend hash server-side
+ * (sessionCommands.pendingForSession) — client không có crypto. Cùng lối với
+ * deviceControl.pendingCommands (cũng nhận token thô trong query).
+ *
+ * ConvexClient được dựng MỘT lần và tái dùng qua mọi phiên: engine chỉ
+ * subscribe/unsubscribe theo phiên, KHÔNG đóng client giữa chừng (đóng rồi mở
+ * lại là bắt tay websocket mới mỗi lần đổi độ phân giải/phiên).
+ */
+declare function createConvexCommandSubscription(convexUrl: string): SessionCommandSubscription;
+/**
+ * Mọi kênh Convex realtime của máy first-party trên MỘT websocket duy nhất:
+ * subscription lệnh (đợt 2) + heartbeat 1-call (đợt 3). Convex client tự
+ * multiplex query/mutation trên cùng socket — dựng hai client là trả giá hai
+ * lần bắt tay + hai kết nối phải nuôi.
+ */
+interface ConvexDeviceRealtime {
+    commandSubscription: SessionCommandSubscription;
+    /**
+     * Heartbeat qua websocket = 1 function call (mutation `deviceApp.beat`),
+     * thay cho đường HTTP httpAction→runMutation = 2 call. Trả envelope `data`
+     * thô cùng hợp đồng với POST /devices/heartbeat. NÉM lỗi khi thất bại —
+     * caller (withConvexBeat) tự rơi về HTTP.
+     */
+    beat(args: Record<string, unknown>): Promise<Record<string, unknown>>;
+    dispose(): void;
+}
+declare function createConvexDeviceRealtime(convexUrl: string): ConvexDeviceRealtime;
+
+export { type ConvexDeviceRealtime as C, createConvexDeviceRealtime as a, createConvexCommandSubscription as c };

package/dist/convex-command-subscription-DUgpu75l.d.cts

@@ -0,0 +1,41 @@
+import { S as SessionCommandSubscription } from './engine-BSvSdCSE.cjs';
+
+/**
+ * Kênh nhận lệnh device-rtmp qua WEBSOCKET (Convex subscription) thay poll HTTP
+ * 2 giây. Vì sao đổi: poll 2s là 2 function call mỗi 2 giây MỖI MÁY chạy suốt
+ * ngày đêm — ở 200 máy là ~518 triệu call/tháng, gấp 20 lần quota gói Pro.
+ * Subscription chỉ chạy lại (và tính tiền) KHI hàng lệnh của phiên đổi: lệnh về
+ * tức thì (<1s), còn lúc rảnh gần như 0.
+ *
+ * CHỈ dùng cho máy FIRST-PARTY nối thẳng Convex (có URL .convex.cloud). Máy đối
+ * tác đi qua proxy không có đường websocket trực tiếp → giữ nguyên poll HTTP.
+ *
+ * Auth: gửi telemetry token THÔ làm tham số query, backend hash server-side
+ * (sessionCommands.pendingForSession) — client không có crypto. Cùng lối với
+ * deviceControl.pendingCommands (cũng nhận token thô trong query).
+ *
+ * ConvexClient được dựng MỘT lần và tái dùng qua mọi phiên: engine chỉ
+ * subscribe/unsubscribe theo phiên, KHÔNG đóng client giữa chừng (đóng rồi mở
+ * lại là bắt tay websocket mới mỗi lần đổi độ phân giải/phiên).
+ */
+declare function createConvexCommandSubscription(convexUrl: string): SessionCommandSubscription;
+/**
+ * Mọi kênh Convex realtime của máy first-party trên MỘT websocket duy nhất:
+ * subscription lệnh (đợt 2) + heartbeat 1-call (đợt 3). Convex client tự
+ * multiplex query/mutation trên cùng socket — dựng hai client là trả giá hai
+ * lần bắt tay + hai kết nối phải nuôi.
+ */
+interface ConvexDeviceRealtime {
+    commandSubscription: SessionCommandSubscription;
+    /**
+     * Heartbeat qua websocket = 1 function call (mutation `deviceApp.beat`),
+     * thay cho đường HTTP httpAction→runMutation = 2 call. Trả envelope `data`
+     * thô cùng hợp đồng với POST /devices/heartbeat. NÉM lỗi khi thất bại —
+     * caller (withConvexBeat) tự rơi về HTTP.
+     */
+    beat(args: Record<string, unknown>): Promise<Record<string, unknown>>;
+    dispose(): void;
+}
+declare function createConvexDeviceRealtime(convexUrl: string): ConvexDeviceRealtime;
+
+export { type ConvexDeviceRealtime as C, createConvexDeviceRealtime as a, createConvexCommandSubscription as c };