@honor-claw/yoyo 1.1.2 → 1.1.4-beta.1

package/src/gateway-client/device/auth.ts

@@ -1,57 +1,57 @@
-import { normalizeDeviceMetadataForAuth } from "./helpers.js";
-import type {
-  DeviceAuthPayloadParams,
-  DeviceAuthPayloadV3Params,
-} from "./types.js";
-
-export { normalizeDeviceMetadataForAuth };
-
-/**
- * Build device authentication payload (v2)
- * @param params - Authentication parameters
- * @returns Pipe-delimited payload string
- */
-export function buildDeviceAuthPayload(
-  params: DeviceAuthPayloadParams
-): string {
-  const scopes = params.scopes.join(",");
-  const token = params.token ?? "";
-  return [
-    "v2",
-    params.deviceId,
-    params.clientId,
-    params.clientMode,
-    params.role,
-    scopes,
-    String(params.signedAtMs),
-    token,
-    params.nonce,
-  ].join("|");
-}
-
-/**
- * Build device authentication payload (v3) with platform and device family
- * @param params - Authentication parameters including platform and device family
- * @returns Pipe-delimited payload string
- */
-export function buildDeviceAuthPayloadV3(
-  params: DeviceAuthPayloadV3Params
-): string {
-  const scopes = params.scopes.join(",");
-  const token = params.token ?? "";
-  const platform = normalizeDeviceMetadataForAuth(params.platform);
-  const deviceFamily = normalizeDeviceMetadataForAuth(params.deviceFamily);
-  return [
-    "v3",
-    params.deviceId,
-    params.clientId,
-    params.clientMode,
-    params.role,
-    scopes,
-    String(params.signedAtMs),
-    token,
-    params.nonce,
-    platform,
-    deviceFamily,
-  ].join("|");
-}
+import { normalizeDeviceMetadataForAuth } from "./helpers.js";
+import type {
+  DeviceAuthPayloadParams,
+  DeviceAuthPayloadV3Params,
+} from "./types.js";
+
+export { normalizeDeviceMetadataForAuth };
+
+/**
+ * Build device authentication payload (v2)
+ * @param params - Authentication parameters
+ * @returns Pipe-delimited payload string
+ */
+export function buildDeviceAuthPayload(
+  params: DeviceAuthPayloadParams
+): string {
+  const scopes = params.scopes.join(",");
+  const token = params.token ?? "";
+  return [
+    "v2",
+    params.deviceId,
+    params.clientId,
+    params.clientMode,
+    params.role,
+    scopes,
+    String(params.signedAtMs),
+    token,
+    params.nonce,
+  ].join("|");
+}
+
+/**
+ * Build device authentication payload (v3) with platform and device family
+ * @param params - Authentication parameters including platform and device family
+ * @returns Pipe-delimited payload string
+ */
+export function buildDeviceAuthPayloadV3(
+  params: DeviceAuthPayloadV3Params
+): string {
+  const scopes = params.scopes.join(",");
+  const token = params.token ?? "";
+  const platform = normalizeDeviceMetadataForAuth(params.platform);
+  const deviceFamily = normalizeDeviceMetadataForAuth(params.deviceFamily);
+  return [
+    "v3",
+    params.deviceId,
+    params.clientId,
+    params.clientMode,
+    params.role,
+    scopes,
+    String(params.signedAtMs),
+    token,
+    params.nonce,
+    platform,
+    deviceFamily,
+  ].join("|");
+}

package/src/gateway-client/device/builder.ts

@@ -1,105 +1,105 @@
-import { GATEWAY_CLIENT_MODES, GATEWAY_CLIENT_IDS } from "../protocol/index.js";
-import { buildDeviceAuthPayloadV3 } from "./auth.js";
-import {
-  publicKeyRawBase64UrlFromPem,
-  signDevicePayload,
-} from "./identity.js";
-import {
-  type DeviceBuilderOptions,
-  type DeviceInfo,
-} from "./types.js";
-
-/**
- * Build device information for gateway connection
- * This is the main function to generate device authentication data
- *
- * @param options - Device builder options
- * @returns Device information object or undefined if no device identity provided
- *
- * @example
- * ```typescript
- * const deviceInfo = buildDeviceInfo({
- *   deviceIdentity: loadOrCreateDeviceIdentity(),
- *   clientName: "my-client",
- *   role: "node",
- *   scopes: ["node.invoke"],
- *   nonce: "challenge-nonce",
- *   platform: "ios",
- *   deviceFamily: "iPhone"
- * });
- * ```
- */
-export function buildDeviceInfo(options: DeviceBuilderOptions): DeviceInfo | undefined {
-  const {
-    deviceIdentity,
-    clientName = GATEWAY_CLIENT_IDS.GATEWAY_CLIENT,
-    clientMode = GATEWAY_CLIENT_MODES.BACKEND,
-    role = "operator",
-    scopes = ["operator.admin"],
-    platform = process.platform,
-    deviceFamily,
-    authToken = null,
-    nonce,
-    signedAtMs = Date.now(),
-  } = options;
-
-  if (!deviceIdentity) {
-    return undefined;
-  }
-
-  // Build authentication payload
-  const payload = buildDeviceAuthPayloadV3({
-    deviceId: deviceIdentity.deviceId,
-    clientId: clientName,
-    clientMode,
-    role,
-    scopes,
-    signedAtMs,
-    token: authToken,
-    nonce,
-    platform,
-    deviceFamily,
-  });
-
-  // Sign the payload
-  const signature = signDevicePayload(deviceIdentity.privateKeyPem, payload);
-
-  // Return device information
-  return {
-    id: deviceIdentity.deviceId,
-    publicKey: publicKeyRawBase64UrlFromPem(deviceIdentity.publicKeyPem),
-    signature,
-    signedAt: signedAtMs,
-    nonce,
-  };
-}
-
-/**
- * Build device information for node role
- * Convenience function for node connections
- *
- * @param options - Device builder options
- * @returns Device information object or undefined
- */
-export function buildNodeDeviceInfo(options: Omit<DeviceBuilderOptions, "role">): DeviceInfo | undefined {
-  return buildDeviceInfo({
-    ...options,
-    role: "node",
-    scopes: options.scopes ?? ["node.invoke"],
-  });
-}
-
-/**
- * Build device information for operator role
- * Convenience function for operator connections
- *
- * @param options - Device builder options
- * @returns Device information object or undefined
- */
-export function buildOperatorDeviceInfo(options: Omit<DeviceBuilderOptions, "role">): DeviceInfo | undefined {
-  return buildDeviceInfo({
-    ...options,
-    role: "operator",
-    scopes: options.scopes ?? ["operator.admin"],
-  });
-}
+import { GATEWAY_CLIENT_MODES, GATEWAY_CLIENT_IDS } from "../protocol/index.js";
+import { buildDeviceAuthPayloadV3 } from "./auth.js";
+import {
+  publicKeyRawBase64UrlFromPem,
+  signDevicePayload,
+} from "./identity.js";
+import {
+  type DeviceBuilderOptions,
+  type DeviceInfo,
+} from "./types.js";
+
+/**
+ * Build device information for gateway connection
+ * This is the main function to generate device authentication data
+ *
+ * @param options - Device builder options
+ * @returns Device information object or undefined if no device identity provided
+ *
+ * @example
+ * ```typescript
+ * const deviceInfo = buildDeviceInfo({
+ *   deviceIdentity: loadOrCreateDeviceIdentity(),
+ *   clientName: "my-client",
+ *   role: "node",
+ *   scopes: ["node.invoke"],
+ *   nonce: "challenge-nonce",
+ *   platform: "ios",
+ *   deviceFamily: "iPhone"
+ * });
+ * ```
+ */
+export function buildDeviceInfo(options: DeviceBuilderOptions): DeviceInfo | undefined {
+  const {
+    deviceIdentity,
+    clientName = GATEWAY_CLIENT_IDS.GATEWAY_CLIENT,
+    clientMode = GATEWAY_CLIENT_MODES.BACKEND,
+    role = "operator",
+    scopes = ["operator.admin"],
+    platform = process.platform,
+    deviceFamily,
+    authToken = null,
+    nonce,
+    signedAtMs = Date.now(),
+  } = options;
+
+  if (!deviceIdentity) {
+    return undefined;
+  }
+
+  // Build authentication payload
+  const payload = buildDeviceAuthPayloadV3({
+    deviceId: deviceIdentity.deviceId,
+    clientId: clientName,
+    clientMode,
+    role,
+    scopes,
+    signedAtMs,
+    token: authToken,
+    nonce,
+    platform,
+    deviceFamily,
+  });
+
+  // Sign the payload
+  const signature = signDevicePayload(deviceIdentity.privateKeyPem, payload);
+
+  // Return device information
+  return {
+    id: deviceIdentity.deviceId,
+    publicKey: publicKeyRawBase64UrlFromPem(deviceIdentity.publicKeyPem),
+    signature,
+    signedAt: signedAtMs,
+    nonce,
+  };
+}
+
+/**
+ * Build device information for node role
+ * Convenience function for node connections
+ *
+ * @param options - Device builder options
+ * @returns Device information object or undefined
+ */
+export function buildNodeDeviceInfo(options: Omit<DeviceBuilderOptions, "role">): DeviceInfo | undefined {
+  return buildDeviceInfo({
+    ...options,
+    role: "node",
+    scopes: options.scopes ?? ["node.invoke"],
+  });
+}
+
+/**
+ * Build device information for operator role
+ * Convenience function for operator connections
+ *
+ * @param options - Device builder options
+ * @returns Device information object or undefined
+ */
+export function buildOperatorDeviceInfo(options: Omit<DeviceBuilderOptions, "role">): DeviceInfo | undefined {
+  return buildDeviceInfo({
+    ...options,
+    role: "operator",
+    scopes: options.scopes ?? ["operator.admin"],
+  });
+}

package/src/gateway-client/device/helpers.ts

@@ -1,40 +1,40 @@
-/**
- * Normalize device metadata for authentication payloads
- * Keeps cross-runtime normalization deterministic (TS/Swift/Kotlin)
- * by only lowercasing ASCII metadata fields used in auth payloads.
- */
-function normalizeTrimmedMetadata(value?: string | null): string {
-  if (typeof value !== "string") {
-    return "";
-  }
-  const trimmed = value.trim();
-  return trimmed ? trimmed : "";
-}
-
-function toLowerAscii(input: string): string {
-  return input.replace(/[A-Z]/g, (char) => String.fromCharCode(char.charCodeAt(0) + 32));
-}
-
-export function normalizeDeviceMetadataForAuth(value?: string | null): string {
-  const trimmed = normalizeTrimmedMetadata(value);
-  if (!trimmed) {
-    return "";
-  }
-  // Keep cross-runtime normalization deterministic (TS/Swift/Kotlin) by only
-  // lowercasing ASCII metadata fields used in auth payloads.
-  return toLowerAscii(trimmed);
-}
-
-/**
- * Normalize device metadata for policy classification
- * Collapses Unicode confusables to stable ASCII-like tokens before matching platform/family rules.
- */
-export function normalizeDeviceMetadataForPolicy(value?: string | null): string {
-  const trimmed = normalizeTrimmedMetadata(value);
-  if (!trimmed) {
-    return "";
-  }
-  // Policy classification should collapse Unicode confusables to stable ASCII-ish
-  // tokens where possible before matching platform/family rules.
-  return trimmed.normalize("NFKD").replace(/\p{M}/gu, "").toLowerCase();
-}
+/**
+ * Normalize device metadata for authentication payloads
+ * Keeps cross-runtime normalization deterministic (TS/Swift/Kotlin)
+ * by only lowercasing ASCII metadata fields used in auth payloads.
+ */
+function normalizeTrimmedMetadata(value?: string | null): string {
+  if (typeof value !== "string") {
+    return "";
+  }
+  const trimmed = value.trim();
+  return trimmed ? trimmed : "";
+}
+
+function toLowerAscii(input: string): string {
+  return input.replace(/[A-Z]/g, (char) => String.fromCharCode(char.charCodeAt(0) + 32));
+}
+
+export function normalizeDeviceMetadataForAuth(value?: string | null): string {
+  const trimmed = normalizeTrimmedMetadata(value);
+  if (!trimmed) {
+    return "";
+  }
+  // Keep cross-runtime normalization deterministic (TS/Swift/Kotlin) by only
+  // lowercasing ASCII metadata fields used in auth payloads.
+  return toLowerAscii(trimmed);
+}
+
+/**
+ * Normalize device metadata for policy classification
+ * Collapses Unicode confusables to stable ASCII-like tokens before matching platform/family rules.
+ */
+export function normalizeDeviceMetadataForPolicy(value?: string | null): string {
+  const trimmed = normalizeTrimmedMetadata(value);
+  if (!trimmed) {
+    return "";
+  }
+  // Policy classification should collapse Unicode confusables to stable ASCII-ish
+  // tokens where possible before matching platform/family rules.
+  return trimmed.normalize("NFKD").replace(/\p{M}/gu, "").toLowerCase();
+}