@pickleball/server-sdk 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @pickleball/server-sdk
 
+## 0.2.0
+
+### Minor Changes
+
+- Device registry endpoints for the partner proxy: `devices.register` and
+  `devices.heartbeat` on `createPickleballLiveClient`, plus the proxy handlers
+  `handleDeviceRegister` / `handleDeviceHeartbeat` (routes `/devices/register`
+  and `/devices/heartbeat`). The heartbeat response carries a one-time control
+  session grant so an operator dashboard can remote-start a livestream on a
+  device that is open but idle.
+- New authorization operations `device_register` and `device_heartbeat`.
+  **Production authz gateways must allow these two operation names**; the
+  staging stub already allows everything.
+- Version aligned with `@pickleball/expo-sdk@0.2.0` (both packages share a
+  stable dist-tag promotion).
+
 ## 0.1.1
 
 ### Patch Changes

package/dist/{chunk-HBTNLURN.js → chunk-Y635I73O.js}

@@ -314,6 +314,29 @@ function validateRecordings(value, sessionId) {
   if (!Array.isArray(value)) invalid();
   return value.map((item) => validateRecording(item, sessionId));
 }
+function validateDeviceRegister(value) {
+  const data = record(value);
+  const heartbeatIntervalMs = finite(data.heartbeatIntervalMs);
+  if (heartbeatIntervalMs <= 0) invalid();
+  return {
+    deviceId: nonblank(data.deviceId),
+    heartbeatIntervalMs
+  };
+}
+function validateDeviceHeartbeat(value) {
+  const data = record(value);
+  if (data.controlSession === null || data.controlSession === void 0) {
+    return { controlSession: null };
+  }
+  const grant = record(data.controlSession);
+  return {
+    controlSession: {
+      id: nonblank(grant.id),
+      token: nonblank(grant.token),
+      convexUrl: nonblank(grant.convexUrl)
+    }
+  };
+}
 
 // src/contracts.ts
 var SDK_TELEMETRY_EVENT_NAMES = [
@@ -599,6 +622,22 @@ function createPickleballLiveClient(options) {
         (value) => validateRecordings(value, sessionId)
       )
     },
+    devices: {
+      register: (input) => post(
+        "/api/v2/sdk/devices/register",
+        { ...input, appId },
+        "transient",
+        validateDeviceRegister
+      ),
+      heartbeat: (input) => post(
+        "/api/v2/sdk/devices/heartbeat",
+        { ...input, appId },
+        // Heartbeat có side effect trao token 1 lần — không retry để tránh
+        // nhận token đã bị đánh dấu delivered ở lần trước
+        "never",
+        validateDeviceHeartbeat
+      )
+    },
     webhooks: { verify: verifyWebhook }
   };
 }

package/dist/index.cjs

@@ -350,6 +350,29 @@ function validateRecordings(value, sessionId) {
   if (!Array.isArray(value)) invalid();
   return value.map((item) => validateRecording(item, sessionId));
 }
+function validateDeviceRegister(value) {
+  const data = record(value);
+  const heartbeatIntervalMs = finite(data.heartbeatIntervalMs);
+  if (heartbeatIntervalMs <= 0) invalid();
+  return {
+    deviceId: nonblank(data.deviceId),
+    heartbeatIntervalMs
+  };
+}
+function validateDeviceHeartbeat(value) {
+  const data = record(value);
+  if (data.controlSession === null || data.controlSession === void 0) {
+    return { controlSession: null };
+  }
+  const grant = record(data.controlSession);
+  return {
+    controlSession: {
+      id: nonblank(grant.id),
+      token: nonblank(grant.token),
+      convexUrl: nonblank(grant.convexUrl)
+    }
+  };
+}
 
 // src/contracts.ts
 var SDK_TELEMETRY_EVENT_NAMES = [
@@ -635,6 +658,22 @@ function createPickleballLiveClient(options) {
         (value) => validateRecordings(value, sessionId)
       )
     },
+    devices: {
+      register: (input) => post(
+        "/api/v2/sdk/devices/register",
+        { ...input, appId },
+        "transient",
+        validateDeviceRegister
+      ),
+      heartbeat: (input) => post(
+        "/api/v2/sdk/devices/heartbeat",
+        { ...input, appId },
+        // Heartbeat có side effect trao token 1 lần — không retry để tránh
+        // nhận token đã bị đánh dấu delivered ở lần trước
+        "never",
+        validateDeviceHeartbeat
+      )
+    },
     webhooks: { verify: verifyWebhook }
   };
 }

package/dist/index.d.cts

@@ -126,6 +126,46 @@ interface ApiRecording {
 type StartSdkSessionInput = BootstrapInput & StartLivestreamInput & {
     idempotencyKey: string;
 };
+/** Thông tin thiết bị kèm khi đăng ký (từ expo-device). */
+interface DeviceInfoInput {
+    appVersion?: string;
+    deviceName?: string;
+    deviceModel?: string;
+    osVersion?: string;
+}
+interface DeviceMetricsInput {
+    ramFreeMb?: number;
+    ramTotalMb?: number;
+    storageFreeGb?: number;
+    batteryPct?: number;
+    batteryTempC?: number;
+    thermal?: number;
+    netType?: string;
+    linkMbps?: number;
+    rssi?: number;
+    connQuality?: string;
+}
+interface DeviceRegisterResult {
+    deviceId: string;
+    heartbeatIntervalMs: number;
+}
+interface DeviceHeartbeatInput {
+    /** Trạng thái engine hiện tại (idle|standby|live|...). */
+    agentState?: string;
+    /** Id phiên live đang giữ — null = không có phiên (server clear link). */
+    currentSessionId?: string | null;
+    appVersion?: string;
+    metrics?: DeviceMetricsInput;
+}
+/** Kênh điều khiển được dashboard yêu cầu — app dùng token mở Convex websocket. */
+interface DeviceControlSessionGrant {
+    id: string;
+    token: string;
+    convexUrl: string;
+}
+interface DeviceHeartbeatResult {
+    controlSession: DeviceControlSessionGrant | null;
+}
 declare const SDK_TELEMETRY_EVENT_NAMES: readonly ["state_changed", "connection_quality", "reconnect", "error", "heartbeat", "session_ended"];
 type SdkTelemetryEventName = (typeof SDK_TELEMETRY_EVENT_NAMES)[number];
 interface SdkTelemetryEvent {
@@ -197,10 +237,14 @@ interface PickleballLiveClient {
         get(sessionId: string): Promise<ApiLiveSession>;
         getRecordings(sessionId: string): Promise<ApiRecording[]>;
     };
+    devices: {
+        register(input: BootstrapInput & DeviceInfoInput): Promise<DeviceRegisterResult>;
+        heartbeat(input: BootstrapInput & DeviceHeartbeatInput): Promise<DeviceHeartbeatResult>;
+    };
     webhooks: {
         verify<T extends WebhookPayload = WebhookPayload>(rawBody: WebhookRawBody, headers: WebhookHeaders, secret: string, options?: VerifyWebhookOptions): Promise<VerifiedWebhook<T>>;
     };
 }
 declare function createPickleballLiveClient(options: PickleballLiveClientOptions): PickleballLiveClient;
 
-export { type ApiLiveSession, type ApiRecording, type BootstrapInput, type EndLivestreamInput, type LivestreamSessionProvider, type LivestreamState, PickleballApiError, PickleballConfigurationError, PickleballHttpError, PickleballInvalidResponseError, type PickleballLiveClient, type PickleballLiveClientOptions, PickleballLiveError, PickleballNetworkError, PickleballTimeoutError, PickleballWebhookVerificationError, type RecordingType, SDK_TELEMETRY_EVENT_NAMES, type SdkBootstrap, type SdkError, type SdkErrorCode, type SdkPublishState, type SdkRemoteConfig, type SdkSessionGrant, type SdkSessionRefresh, type SdkTelemetryCredentials, type SdkTelemetryEvent, type SdkTelemetryEventName, type ServerSdkErrorCode, type SessionStatus, type SessionVisibility, type StartLivestreamInput, type StartSdkSessionInput, type VerifiedWebhook, type VerifyWebhookOptions, type WebhookHeaders, type WebhookPayload, type WebhookRawBody, createPickleballLiveClient, verifyWebhook };
+export { type ApiLiveSession, type ApiRecording, type BootstrapInput, type DeviceControlSessionGrant, type DeviceHeartbeatInput, type DeviceHeartbeatResult, type DeviceInfoInput, type DeviceMetricsInput, type DeviceRegisterResult, type EndLivestreamInput, type LivestreamSessionProvider, type LivestreamState, PickleballApiError, PickleballConfigurationError, PickleballHttpError, PickleballInvalidResponseError, type PickleballLiveClient, type PickleballLiveClientOptions, PickleballLiveError, PickleballNetworkError, PickleballTimeoutError, PickleballWebhookVerificationError, type RecordingType, SDK_TELEMETRY_EVENT_NAMES, type SdkBootstrap, type SdkError, type SdkErrorCode, type SdkPublishState, type SdkRemoteConfig, type SdkSessionGrant, type SdkSessionRefresh, type SdkTelemetryCredentials, type SdkTelemetryEvent, type SdkTelemetryEventName, type ServerSdkErrorCode, type SessionStatus, type SessionVisibility, type StartLivestreamInput, type StartSdkSessionInput, type VerifiedWebhook, type VerifyWebhookOptions, type WebhookHeaders, type WebhookPayload, type WebhookRawBody, createPickleballLiveClient, verifyWebhook };

package/dist/index.d.ts

@@ -126,6 +126,46 @@ interface ApiRecording {
 type StartSdkSessionInput = BootstrapInput & StartLivestreamInput & {
     idempotencyKey: string;
 };
+/** Thông tin thiết bị kèm khi đăng ký (từ expo-device). */
+interface DeviceInfoInput {
+    appVersion?: string;
+    deviceName?: string;
+    deviceModel?: string;
+    osVersion?: string;
+}
+interface DeviceMetricsInput {
+    ramFreeMb?: number;
+    ramTotalMb?: number;
+    storageFreeGb?: number;
+    batteryPct?: number;
+    batteryTempC?: number;
+    thermal?: number;
+    netType?: string;
+    linkMbps?: number;
+    rssi?: number;
+    connQuality?: string;
+}
+interface DeviceRegisterResult {
+    deviceId: string;
+    heartbeatIntervalMs: number;
+}
+interface DeviceHeartbeatInput {
+    /** Trạng thái engine hiện tại (idle|standby|live|...). */
+    agentState?: string;
+    /** Id phiên live đang giữ — null = không có phiên (server clear link). */
+    currentSessionId?: string | null;
+    appVersion?: string;
+    metrics?: DeviceMetricsInput;
+}
+/** Kênh điều khiển được dashboard yêu cầu — app dùng token mở Convex websocket. */
+interface DeviceControlSessionGrant {
+    id: string;
+    token: string;
+    convexUrl: string;
+}
+interface DeviceHeartbeatResult {
+    controlSession: DeviceControlSessionGrant | null;
+}
 declare const SDK_TELEMETRY_EVENT_NAMES: readonly ["state_changed", "connection_quality", "reconnect", "error", "heartbeat", "session_ended"];
 type SdkTelemetryEventName = (typeof SDK_TELEMETRY_EVENT_NAMES)[number];
 interface SdkTelemetryEvent {
@@ -197,10 +237,14 @@ interface PickleballLiveClient {
         get(sessionId: string): Promise<ApiLiveSession>;
         getRecordings(sessionId: string): Promise<ApiRecording[]>;
     };
+    devices: {
+        register(input: BootstrapInput & DeviceInfoInput): Promise<DeviceRegisterResult>;
+        heartbeat(input: BootstrapInput & DeviceHeartbeatInput): Promise<DeviceHeartbeatResult>;
+    };
     webhooks: {
         verify<T extends WebhookPayload = WebhookPayload>(rawBody: WebhookRawBody, headers: WebhookHeaders, secret: string, options?: VerifyWebhookOptions): Promise<VerifiedWebhook<T>>;
     };
 }
 declare function createPickleballLiveClient(options: PickleballLiveClientOptions): PickleballLiveClient;
 
-export { type ApiLiveSession, type ApiRecording, type BootstrapInput, type EndLivestreamInput, type LivestreamSessionProvider, type LivestreamState, PickleballApiError, PickleballConfigurationError, PickleballHttpError, PickleballInvalidResponseError, type PickleballLiveClient, type PickleballLiveClientOptions, PickleballLiveError, PickleballNetworkError, PickleballTimeoutError, PickleballWebhookVerificationError, type RecordingType, SDK_TELEMETRY_EVENT_NAMES, type SdkBootstrap, type SdkError, type SdkErrorCode, type SdkPublishState, type SdkRemoteConfig, type SdkSessionGrant, type SdkSessionRefresh, type SdkTelemetryCredentials, type SdkTelemetryEvent, type SdkTelemetryEventName, type ServerSdkErrorCode, type SessionStatus, type SessionVisibility, type StartLivestreamInput, type StartSdkSessionInput, type VerifiedWebhook, type VerifyWebhookOptions, type WebhookHeaders, type WebhookPayload, type WebhookRawBody, createPickleballLiveClient, verifyWebhook };
+export { type ApiLiveSession, type ApiRecording, type BootstrapInput, type DeviceControlSessionGrant, type DeviceHeartbeatInput, type DeviceHeartbeatResult, type DeviceInfoInput, type DeviceMetricsInput, type DeviceRegisterResult, type EndLivestreamInput, type LivestreamSessionProvider, type LivestreamState, PickleballApiError, PickleballConfigurationError, PickleballHttpError, PickleballInvalidResponseError, type PickleballLiveClient, type PickleballLiveClientOptions, PickleballLiveError, PickleballNetworkError, PickleballTimeoutError, PickleballWebhookVerificationError, type RecordingType, SDK_TELEMETRY_EVENT_NAMES, type SdkBootstrap, type SdkError, type SdkErrorCode, type SdkPublishState, type SdkRemoteConfig, type SdkSessionGrant, type SdkSessionRefresh, type SdkTelemetryCredentials, type SdkTelemetryEvent, type SdkTelemetryEventName, type ServerSdkErrorCode, type SessionStatus, type SessionVisibility, type StartLivestreamInput, type StartSdkSessionInput, type VerifiedWebhook, type VerifyWebhookOptions, type WebhookHeaders, type WebhookPayload, type WebhookRawBody, createPickleballLiveClient, verifyWebhook };

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   SDK_TELEMETRY_EVENT_NAMES,
   createPickleballLiveClient,
   verifyWebhook
-} from "./chunk-HBTNLURN.js";
+} from "./chunk-Y635I73O.js";
 export {
   PickleballApiError,
   PickleballConfigurationError,

package/dist/proxy.cjs

@@ -22,6 +22,8 @@ var proxy_exports = {};
 __export(proxy_exports, {
   createStableIdempotencyKey: () => createStableIdempotencyKey,
   handleBootstrap: () => handleBootstrap,
+  handleDeviceHeartbeat: () => handleDeviceHeartbeat,
+  handleDeviceRegister: () => handleDeviceRegister,
   handleSessionAction: () => handleSessionAction,
   handleSessions: () => handleSessions
 });
@@ -343,6 +345,29 @@ function validateRecordings(value, sessionId) {
   if (!Array.isArray(value)) invalid();
   return value.map((item) => validateRecording(item, sessionId));
 }
+function validateDeviceRegister(value) {
+  const data = record(value);
+  const heartbeatIntervalMs = finite(data.heartbeatIntervalMs);
+  if (heartbeatIntervalMs <= 0) invalid();
+  return {
+    deviceId: nonblank(data.deviceId),
+    heartbeatIntervalMs
+  };
+}
+function validateDeviceHeartbeat(value) {
+  const data = record(value);
+  if (data.controlSession === null || data.controlSession === void 0) {
+    return { controlSession: null };
+  }
+  const grant = record(data.controlSession);
+  return {
+    controlSession: {
+      id: nonblank(grant.id),
+      token: nonblank(grant.token),
+      convexUrl: nonblank(grant.convexUrl)
+    }
+  };
+}
 
 // src/index.ts
 var TRANSIENT_STATUSES = /* @__PURE__ */ new Set([408, 429]);
@@ -618,6 +643,22 @@ function createPickleballLiveClient(options) {
         (value) => validateRecordings(value, sessionId)
       )
     },
+    devices: {
+      register: (input) => post(
+        "/api/v2/sdk/devices/register",
+        { ...input, appId },
+        "transient",
+        validateDeviceRegister
+      ),
+      heartbeat: (input) => post(
+        "/api/v2/sdk/devices/heartbeat",
+        { ...input, appId },
+        // Heartbeat có side effect trao token 1 lần — không retry để tránh
+        // nhận token đã bị đánh dấu delivered ở lần trước
+        "never",
+        validateDeviceHeartbeat
+      )
+    },
     webhooks: { verify: verifyWebhook }
   };
 }
@@ -1009,10 +1050,139 @@ async function handleSessionAction(request, params, deps) {
     return null;
   });
 }
+var DEVICE_INFO_FIELDS = ["appVersion", "deviceName", "deviceModel", "osVersion"];
+var DEVICE_METRIC_NUMBER_FIELDS = [
+  "ramFreeMb",
+  "ramTotalMb",
+  "storageFreeGb",
+  "batteryPct",
+  "batteryTempC",
+  "thermal",
+  "linkMbps",
+  "rssi"
+];
+var DEVICE_METRIC_STRING_FIELDS = ["netType", "connQuality"];
+function deviceInfoFields(value) {
+  const info = {};
+  for (const field of DEVICE_INFO_FIELDS) {
+    const entry = value[field];
+    if (entry === void 0) continue;
+    if (!nonblank2(entry, 200)) throw new InvalidRequest();
+    info[field] = entry;
+  }
+  return info;
+}
+function deviceRegisterBody(value) {
+  if (!hasOnlyKeys(value, [
+    "sdkVersion",
+    "platform",
+    "bundleId",
+    "installationId",
+    ...DEVICE_INFO_FIELDS
+  ])) {
+    throw new InvalidRequest();
+  }
+  const identity = bootstrapBody({
+    sdkVersion: value.sdkVersion,
+    platform: value.platform,
+    bundleId: value.bundleId,
+    installationId: value.installationId
+  });
+  return { ...identity, ...deviceInfoFields(value) };
+}
+function deviceMetricsFields(value) {
+  if (value === void 0) return void 0;
+  if (!isObject(value)) throw new InvalidRequest();
+  if (!hasOnlyKeys(value, [...DEVICE_METRIC_NUMBER_FIELDS, ...DEVICE_METRIC_STRING_FIELDS])) {
+    throw new InvalidRequest();
+  }
+  const metrics = {};
+  for (const field of DEVICE_METRIC_NUMBER_FIELDS) {
+    const entry = value[field];
+    if (entry === void 0) continue;
+    if (typeof entry !== "number" || !Number.isFinite(entry)) throw new InvalidRequest();
+    metrics[field] = entry;
+  }
+  for (const field of DEVICE_METRIC_STRING_FIELDS) {
+    const entry = value[field];
+    if (entry === void 0) continue;
+    if (!nonblank2(entry, 50)) throw new InvalidRequest();
+    metrics[field] = entry;
+  }
+  return metrics;
+}
+function deviceHeartbeatBody(value) {
+  if (!hasOnlyKeys(value, [
+    "sdkVersion",
+    "platform",
+    "bundleId",
+    "installationId",
+    "agentState",
+    "currentSessionId",
+    "appVersion",
+    "metrics"
+  ])) {
+    throw new InvalidRequest();
+  }
+  const identity = bootstrapBody({
+    sdkVersion: value.sdkVersion,
+    platform: value.platform,
+    bundleId: value.bundleId,
+    installationId: value.installationId
+  });
+  if (value.agentState !== void 0 && !nonblank2(value.agentState, 50)) {
+    throw new InvalidRequest();
+  }
+  if (value.currentSessionId !== void 0 && value.currentSessionId !== null && !nonblank2(value.currentSessionId, 256)) {
+    throw new InvalidRequest();
+  }
+  if (value.appVersion !== void 0 && !nonblank2(value.appVersion, 200)) {
+    throw new InvalidRequest();
+  }
+  const metrics = deviceMetricsFields(value.metrics);
+  return {
+    ...identity,
+    ...value.agentState === void 0 ? {} : { agentState: value.agentState },
+    ...value.currentSessionId === void 0 ? {} : { currentSessionId: value.currentSessionId },
+    ...value.appVersion === void 0 ? {} : { appVersion: value.appVersion },
+    ...metrics === void 0 ? {} : { metrics }
+  };
+}
+function deviceClientFor(deps) {
+  const client = clientFor(deps);
+  if (!client.devices) {
+    throw new PickleballConfigurationError("Proxy client does not support devices");
+  }
+  return client.devices;
+}
+async function handleDeviceRegister(request, deps) {
+  return execute(deps, async () => {
+    const authorization = userAuthorization(request.headers);
+    const attestation = appAttestation(request.headers);
+    const identity = identityFromHeaders(request.headers);
+    const input = deviceRegisterBody(await bodyObject(request));
+    if (!identitiesMatch(identity, input)) throw new InvalidRequest();
+    await authorize(deps, authorization, "device_register", identity, {}, attestation);
+    return deviceClientFor(deps).register(input);
+  });
+}
+async function handleDeviceHeartbeat(request, deps) {
+  return execute(deps, async () => {
+    const authorization = userAuthorization(request.headers);
+    const attestation = appAttestation(request.headers);
+    const identity = identityFromHeaders(request.headers);
+    const input = deviceHeartbeatBody(await bodyObject(request));
+    if (!identitiesMatch(identity, input)) throw new InvalidRequest();
+    await authorize(deps, authorization, "device_heartbeat", identity, {}, attestation);
+    return deviceClientFor(deps).heartbeat(input);
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createStableIdempotencyKey,
   handleBootstrap,
+  handleDeviceHeartbeat,
+  handleDeviceRegister,
   handleSessionAction,
   handleSessions
 });

package/dist/proxy.d.cts

@@ -21,6 +21,7 @@ interface ProxyDependencies {
 type ProxyClient = {
     apps: Pick<PickleballLiveClient["apps"], "bootstrap">;
     sessions: Pick<PickleballLiveClient["sessions"], "start" | "refresh" | "end" | "publish" | "unpublish">;
+    devices?: Pick<PickleballLiveClient["devices"], "register" | "heartbeat">;
 };
 interface SessionActionParams {
     id: string;
@@ -35,5 +36,7 @@ declare function createStableIdempotencyKey(input: {
 declare function handleBootstrap(request: Request, deps: ProxyDependencies): Promise<Response>;
 declare function handleSessions(request: Request, deps: ProxyDependencies): Promise<Response>;
 declare function handleSessionAction(request: Request, params: SessionActionParams, deps: ProxyDependencies): Promise<Response>;
+declare function handleDeviceRegister(request: Request, deps: ProxyDependencies): Promise<Response>;
+declare function handleDeviceHeartbeat(request: Request, deps: ProxyDependencies): Promise<Response>;
 
-export { type ProxyDependencies, type ProxyEnvironment, type SessionActionParams, createStableIdempotencyKey, handleBootstrap, handleSessionAction, handleSessions };
+export { type ProxyDependencies, type ProxyEnvironment, type SessionActionParams, createStableIdempotencyKey, handleBootstrap, handleDeviceHeartbeat, handleDeviceRegister, handleSessionAction, handleSessions };

package/dist/proxy.d.ts

@@ -21,6 +21,7 @@ interface ProxyDependencies {
 type ProxyClient = {
     apps: Pick<PickleballLiveClient["apps"], "bootstrap">;
     sessions: Pick<PickleballLiveClient["sessions"], "start" | "refresh" | "end" | "publish" | "unpublish">;
+    devices?: Pick<PickleballLiveClient["devices"], "register" | "heartbeat">;
 };
 interface SessionActionParams {
     id: string;
@@ -35,5 +36,7 @@ declare function createStableIdempotencyKey(input: {
 declare function handleBootstrap(request: Request, deps: ProxyDependencies): Promise<Response>;
 declare function handleSessions(request: Request, deps: ProxyDependencies): Promise<Response>;
 declare function handleSessionAction(request: Request, params: SessionActionParams, deps: ProxyDependencies): Promise<Response>;
+declare function handleDeviceRegister(request: Request, deps: ProxyDependencies): Promise<Response>;
+declare function handleDeviceHeartbeat(request: Request, deps: ProxyDependencies): Promise<Response>;
 
-export { type ProxyDependencies, type ProxyEnvironment, type SessionActionParams, createStableIdempotencyKey, handleBootstrap, handleSessionAction, handleSessions };
+export { type ProxyDependencies, type ProxyEnvironment, type SessionActionParams, createStableIdempotencyKey, handleBootstrap, handleDeviceHeartbeat, handleDeviceRegister, handleSessionAction, handleSessions };

package/dist/proxy.js

@@ -6,7 +6,7 @@ import {
   PickleballNetworkError,
   PickleballTimeoutError,
   createPickleballLiveClient
-} from "./chunk-HBTNLURN.js";
+} from "./chunk-Y635I73O.js";
 
 // src/proxy.ts
 var MAX_BODY_BYTES = 16 * 1024;
@@ -395,9 +395,138 @@ async function handleSessionAction(request, params, deps) {
     return null;
   });
 }
+var DEVICE_INFO_FIELDS = ["appVersion", "deviceName", "deviceModel", "osVersion"];
+var DEVICE_METRIC_NUMBER_FIELDS = [
+  "ramFreeMb",
+  "ramTotalMb",
+  "storageFreeGb",
+  "batteryPct",
+  "batteryTempC",
+  "thermal",
+  "linkMbps",
+  "rssi"
+];
+var DEVICE_METRIC_STRING_FIELDS = ["netType", "connQuality"];
+function deviceInfoFields(value) {
+  const info = {};
+  for (const field of DEVICE_INFO_FIELDS) {
+    const entry = value[field];
+    if (entry === void 0) continue;
+    if (!nonblank(entry, 200)) throw new InvalidRequest();
+    info[field] = entry;
+  }
+  return info;
+}
+function deviceRegisterBody(value) {
+  if (!hasOnlyKeys(value, [
+    "sdkVersion",
+    "platform",
+    "bundleId",
+    "installationId",
+    ...DEVICE_INFO_FIELDS
+  ])) {
+    throw new InvalidRequest();
+  }
+  const identity = bootstrapBody({
+    sdkVersion: value.sdkVersion,
+    platform: value.platform,
+    bundleId: value.bundleId,
+    installationId: value.installationId
+  });
+  return { ...identity, ...deviceInfoFields(value) };
+}
+function deviceMetricsFields(value) {
+  if (value === void 0) return void 0;
+  if (!isObject(value)) throw new InvalidRequest();
+  if (!hasOnlyKeys(value, [...DEVICE_METRIC_NUMBER_FIELDS, ...DEVICE_METRIC_STRING_FIELDS])) {
+    throw new InvalidRequest();
+  }
+  const metrics = {};
+  for (const field of DEVICE_METRIC_NUMBER_FIELDS) {
+    const entry = value[field];
+    if (entry === void 0) continue;
+    if (typeof entry !== "number" || !Number.isFinite(entry)) throw new InvalidRequest();
+    metrics[field] = entry;
+  }
+  for (const field of DEVICE_METRIC_STRING_FIELDS) {
+    const entry = value[field];
+    if (entry === void 0) continue;
+    if (!nonblank(entry, 50)) throw new InvalidRequest();
+    metrics[field] = entry;
+  }
+  return metrics;
+}
+function deviceHeartbeatBody(value) {
+  if (!hasOnlyKeys(value, [
+    "sdkVersion",
+    "platform",
+    "bundleId",
+    "installationId",
+    "agentState",
+    "currentSessionId",
+    "appVersion",
+    "metrics"
+  ])) {
+    throw new InvalidRequest();
+  }
+  const identity = bootstrapBody({
+    sdkVersion: value.sdkVersion,
+    platform: value.platform,
+    bundleId: value.bundleId,
+    installationId: value.installationId
+  });
+  if (value.agentState !== void 0 && !nonblank(value.agentState, 50)) {
+    throw new InvalidRequest();
+  }
+  if (value.currentSessionId !== void 0 && value.currentSessionId !== null && !nonblank(value.currentSessionId, 256)) {
+    throw new InvalidRequest();
+  }
+  if (value.appVersion !== void 0 && !nonblank(value.appVersion, 200)) {
+    throw new InvalidRequest();
+  }
+  const metrics = deviceMetricsFields(value.metrics);
+  return {
+    ...identity,
+    ...value.agentState === void 0 ? {} : { agentState: value.agentState },
+    ...value.currentSessionId === void 0 ? {} : { currentSessionId: value.currentSessionId },
+    ...value.appVersion === void 0 ? {} : { appVersion: value.appVersion },
+    ...metrics === void 0 ? {} : { metrics }
+  };
+}
+function deviceClientFor(deps) {
+  const client = clientFor(deps);
+  if (!client.devices) {
+    throw new PickleballConfigurationError("Proxy client does not support devices");
+  }
+  return client.devices;
+}
+async function handleDeviceRegister(request, deps) {
+  return execute(deps, async () => {
+    const authorization = userAuthorization(request.headers);
+    const attestation = appAttestation(request.headers);
+    const identity = identityFromHeaders(request.headers);
+    const input = deviceRegisterBody(await bodyObject(request));
+    if (!identitiesMatch(identity, input)) throw new InvalidRequest();
+    await authorize(deps, authorization, "device_register", identity, {}, attestation);
+    return deviceClientFor(deps).register(input);
+  });
+}
+async function handleDeviceHeartbeat(request, deps) {
+  return execute(deps, async () => {
+    const authorization = userAuthorization(request.headers);
+    const attestation = appAttestation(request.headers);
+    const identity = identityFromHeaders(request.headers);
+    const input = deviceHeartbeatBody(await bodyObject(request));
+    if (!identitiesMatch(identity, input)) throw new InvalidRequest();
+    await authorize(deps, authorization, "device_heartbeat", identity, {}, attestation);
+    return deviceClientFor(deps).heartbeat(input);
+  });
+}
 export {
   createStableIdempotencyKey,
   handleBootstrap,
+  handleDeviceHeartbeat,
+  handleDeviceRegister,
   handleSessionAction,
   handleSessions
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pickleball/server-sdk",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Framework-free server SDK for Pickleball Live",
   "license": "MIT",
   "repository": {