@photon-os/sdk 1.0.0-alpha.0 → 1.0.0-alpha.2

package/dist/index.d.mts

@@ -12,6 +12,37 @@ type RunningAppInstance = {
     isInBackground: boolean;
 };
 
+/** A registered Second Life device */
+interface SLDevice {
+    id: string;
+    objectKey: string;
+    objectName: string;
+    regionName?: string;
+    isOnline: boolean;
+    lastHeartbeatAt: Date;
+    registeredAt: Date;
+    metadata?: Record<string, unknown>;
+}
+/** A message received from a Second Life device */
+interface DeviceMessage {
+    deviceId: string;
+    objectKey: string;
+    objectName: string;
+    type: string;
+    payload: Record<string, unknown>;
+    timestamp: Date;
+}
+/** Result of sending a message to a device */
+interface SendMessageResult {
+    success: boolean;
+    error?: string;
+    deviceOffline?: boolean;
+}
+/** Callback for receiving device messages */
+type DeviceMessageCallback = (message: DeviceMessage) => void;
+/** Function to unsubscribe from device messages */
+type Unsubscribe = () => void;
+
 /**
  * Value types supported for preferences.
  * Stored as JSONB in the database.
@@ -20,6 +51,18 @@ type PreferenceValue = string | number | boolean | null | PreferenceValue[] | {
     [key: string]: PreferenceValue;
 };
 
+/**
+ * Represents a linked Second Life account visible to apps via the SDK.
+ */
+type SecondLifeAccount = {
+    /** Second Life avatar UUID (key) */
+    avatarUuid: string;
+    /** Second Life avatar display name */
+    avatarName: string;
+    /** When the account was linked (ISO 8601 timestamp) */
+    linkedAt: string;
+};
+
 /**
  * Represents the authenticated user visible to apps via the SDK.
  * This is a read-only, minimal representation.
@@ -36,6 +79,10 @@ type AppLaunchResult = {
     error: Error | null;
     app: AppDefinition;
 };
+type LinkingCode = {
+    code: string;
+    expiresAt: string;
+};
 type OperatingSystemAPI = {
     system_homeButton: () => Promise<void>;
     apps_getInstalledApps: () => Promise<AppDefinition[]>;
@@ -50,8 +97,27 @@ type OperatingSystemAPI = {
     prefs_getShared: (key: string) => Promise<PreferenceValue>;
     prefs_setShared: (key: string, value: PreferenceValue) => Promise<void>;
     prefs_deleteShared: (key: string) => Promise<void>;
+    accounts_getLinkedSecondLifeAccounts: () => Promise<SecondLifeAccount[]>;
+    accounts_unlinkSecondLifeAccount: (avatarUuid: string) => Promise<void>;
+    accounts_generateLinkingCode: () => Promise<LinkingCode>;
+    devices_getRegistered: () => Promise<SLDevice[]>;
+    devices_sendMessage: (deviceId: string, type: string, payload: Record<string, unknown>) => Promise<SendMessageResult>;
+    devices_unregister: (deviceId: string) => Promise<void>;
+    devices_subscribe: (callback: (message: DeviceMessage) => void) => Promise<void>;
+    devices_unsubscribe: () => Promise<void>;
 };
 
+declare class AccountManager {
+    private os;
+    constructor(os: OS);
+    /** Get all Second Life accounts linked to the current user */
+    getLinkedSecondLifeAccounts(): Promise<SecondLifeAccount[]>;
+    /** Unlink a Second Life account from the current user */
+    unlinkSecondLifeAccount(avatarUuid: string): Promise<void>;
+    /** Generate a linking code for connecting a Second Life account */
+    generateLinkingCode(): Promise<LinkingCode>;
+}
+
 declare class AppManager {
     private os;
     constructor(os: OS);
@@ -61,6 +127,25 @@ declare class AppManager {
     requestAppUninstall(app: AppDefinition): Promise<void>;
 }
 
+declare class DeviceManager {
+    private os;
+    private messageCallbacks;
+    private subscribed;
+    constructor(os: OS);
+    /** Get all registered Second Life devices for the current user */
+    getRegisteredDevices(): Promise<SLDevice[]>;
+    /** Send a message to a registered device */
+    sendMessage(deviceId: string, type: string, payload?: Record<string, unknown>): Promise<SendMessageResult>;
+    /** Unregister a device */
+    unregisterDevice(deviceId: string): Promise<void>;
+    /** Subscribe to messages from all registered devices */
+    subscribeToMessages(callback: DeviceMessageCallback): Unsubscribe;
+    /** Internal: Start the message subscription via RPC */
+    private startSubscription;
+    /** Internal: Stop the message subscription */
+    private stopSubscription;
+}
+
 /**
  * Manages user preferences for apps.
  *
@@ -111,7 +196,9 @@ type OSConfig = {
     target: Window;
 };
 declare class OS {
+    accounts: AccountManager;
     apps: AppManager;
+    devices: DeviceManager;
     prefs: PreferencesManager;
     user: UserManager;
     private config;
@@ -122,4 +209,4 @@ declare class OS {
 
 declare const VERSION = "1.0.0";
 
-export { type AppBundleId, type AppDefinition, type AppLaunchResult, OS, type OSConfig, type OperatingSystemAPI, type PhotonUser, type PreferenceValue, type RunningAppInstance, VERSION };
+export { type AppBundleId, type AppDefinition, type AppLaunchResult, type DeviceMessage, type DeviceMessageCallback, type LinkingCode, OS, type OSConfig, type OperatingSystemAPI, type PhotonUser, type PreferenceValue, type RunningAppInstance, type SLDevice, type SecondLifeAccount, type SendMessageResult, type Unsubscribe, VERSION };

package/dist/index.d.ts

@@ -12,6 +12,37 @@ type RunningAppInstance = {
     isInBackground: boolean;
 };
 
+/** A registered Second Life device */
+interface SLDevice {
+    id: string;
+    objectKey: string;
+    objectName: string;
+    regionName?: string;
+    isOnline: boolean;
+    lastHeartbeatAt: Date;
+    registeredAt: Date;
+    metadata?: Record<string, unknown>;
+}
+/** A message received from a Second Life device */
+interface DeviceMessage {
+    deviceId: string;
+    objectKey: string;
+    objectName: string;
+    type: string;
+    payload: Record<string, unknown>;
+    timestamp: Date;
+}
+/** Result of sending a message to a device */
+interface SendMessageResult {
+    success: boolean;
+    error?: string;
+    deviceOffline?: boolean;
+}
+/** Callback for receiving device messages */
+type DeviceMessageCallback = (message: DeviceMessage) => void;
+/** Function to unsubscribe from device messages */
+type Unsubscribe = () => void;
+
 /**
  * Value types supported for preferences.
  * Stored as JSONB in the database.
@@ -20,6 +51,18 @@ type PreferenceValue = string | number | boolean | null | PreferenceValue[] | {
     [key: string]: PreferenceValue;
 };
 
+/**
+ * Represents a linked Second Life account visible to apps via the SDK.
+ */
+type SecondLifeAccount = {
+    /** Second Life avatar UUID (key) */
+    avatarUuid: string;
+    /** Second Life avatar display name */
+    avatarName: string;
+    /** When the account was linked (ISO 8601 timestamp) */
+    linkedAt: string;
+};
+
 /**
  * Represents the authenticated user visible to apps via the SDK.
  * This is a read-only, minimal representation.
@@ -36,6 +79,10 @@ type AppLaunchResult = {
     error: Error | null;
     app: AppDefinition;
 };
+type LinkingCode = {
+    code: string;
+    expiresAt: string;
+};
 type OperatingSystemAPI = {
     system_homeButton: () => Promise<void>;
     apps_getInstalledApps: () => Promise<AppDefinition[]>;
@@ -50,8 +97,27 @@ type OperatingSystemAPI = {
     prefs_getShared: (key: string) => Promise<PreferenceValue>;
     prefs_setShared: (key: string, value: PreferenceValue) => Promise<void>;
     prefs_deleteShared: (key: string) => Promise<void>;
+    accounts_getLinkedSecondLifeAccounts: () => Promise<SecondLifeAccount[]>;
+    accounts_unlinkSecondLifeAccount: (avatarUuid: string) => Promise<void>;
+    accounts_generateLinkingCode: () => Promise<LinkingCode>;
+    devices_getRegistered: () => Promise<SLDevice[]>;
+    devices_sendMessage: (deviceId: string, type: string, payload: Record<string, unknown>) => Promise<SendMessageResult>;
+    devices_unregister: (deviceId: string) => Promise<void>;
+    devices_subscribe: (callback: (message: DeviceMessage) => void) => Promise<void>;
+    devices_unsubscribe: () => Promise<void>;
 };
 
+declare class AccountManager {
+    private os;
+    constructor(os: OS);
+    /** Get all Second Life accounts linked to the current user */
+    getLinkedSecondLifeAccounts(): Promise<SecondLifeAccount[]>;
+    /** Unlink a Second Life account from the current user */
+    unlinkSecondLifeAccount(avatarUuid: string): Promise<void>;
+    /** Generate a linking code for connecting a Second Life account */
+    generateLinkingCode(): Promise<LinkingCode>;
+}
+
 declare class AppManager {
     private os;
     constructor(os: OS);
@@ -61,6 +127,25 @@ declare class AppManager {
     requestAppUninstall(app: AppDefinition): Promise<void>;
 }
 
+declare class DeviceManager {
+    private os;
+    private messageCallbacks;
+    private subscribed;
+    constructor(os: OS);
+    /** Get all registered Second Life devices for the current user */
+    getRegisteredDevices(): Promise<SLDevice[]>;
+    /** Send a message to a registered device */
+    sendMessage(deviceId: string, type: string, payload?: Record<string, unknown>): Promise<SendMessageResult>;
+    /** Unregister a device */
+    unregisterDevice(deviceId: string): Promise<void>;
+    /** Subscribe to messages from all registered devices */
+    subscribeToMessages(callback: DeviceMessageCallback): Unsubscribe;
+    /** Internal: Start the message subscription via RPC */
+    private startSubscription;
+    /** Internal: Stop the message subscription */
+    private stopSubscription;
+}
+
 /**
  * Manages user preferences for apps.
  *
@@ -111,7 +196,9 @@ type OSConfig = {
     target: Window;
 };
 declare class OS {
+    accounts: AccountManager;
     apps: AppManager;
+    devices: DeviceManager;
     prefs: PreferencesManager;
     user: UserManager;
     private config;
@@ -122,4 +209,4 @@ declare class OS {
 
 declare const VERSION = "1.0.0";
 
-export { type AppBundleId, type AppDefinition, type AppLaunchResult, OS, type OSConfig, type OperatingSystemAPI, type PhotonUser, type PreferenceValue, type RunningAppInstance, VERSION };
+export { type AppBundleId, type AppDefinition, type AppLaunchResult, type DeviceMessage, type DeviceMessageCallback, type LinkingCode, OS, type OSConfig, type OperatingSystemAPI, type PhotonUser, type PreferenceValue, type RunningAppInstance, type SLDevice, type SecondLifeAccount, type SendMessageResult, type Unsubscribe, VERSION };

package/dist/index.js

@@ -1188,6 +1188,28 @@ module.exports = __toCommonJS(index_exports);
 // src/framework/OS.ts
 var pmrpc = __toESM(require_pm_rpc_min());
 
+// src/framework/AccountManager.ts
+var AccountManager = class {
+  constructor(os) {
+    this.os = os;
+  }
+  /** Get all Second Life accounts linked to the current user */
+  async getLinkedSecondLifeAccounts() {
+    const api2 = await this.os.getRPCAPI();
+    return await api2.accounts_getLinkedSecondLifeAccounts();
+  }
+  /** Unlink a Second Life account from the current user */
+  async unlinkSecondLifeAccount(avatarUuid) {
+    const api2 = await this.os.getRPCAPI();
+    await api2.accounts_unlinkSecondLifeAccount(avatarUuid);
+  }
+  /** Generate a linking code for connecting a Second Life account */
+  async generateLinkingCode() {
+    const api2 = await this.os.getRPCAPI();
+    return await api2.accounts_generateLinkingCode();
+  }
+};
+
 // src/framework/AppManager.ts
 var AppManager = class {
   constructor(os) {
@@ -1211,6 +1233,63 @@ var AppManager = class {
   }
 };
 
+// src/framework/DeviceManager.ts
+var DeviceManager = class {
+  constructor(os) {
+    this.messageCallbacks = /* @__PURE__ */ new Set();
+    this.subscribed = false;
+    this.os = os;
+  }
+  /** Get all registered Second Life devices for the current user */
+  async getRegisteredDevices() {
+    const api2 = await this.os.getRPCAPI();
+    return await api2.devices_getRegistered();
+  }
+  /** Send a message to a registered device */
+  async sendMessage(deviceId, type, payload = {}) {
+    const api2 = await this.os.getRPCAPI();
+    return await api2.devices_sendMessage(deviceId, type, payload);
+  }
+  /** Unregister a device */
+  async unregisterDevice(deviceId) {
+    const api2 = await this.os.getRPCAPI();
+    await api2.devices_unregister(deviceId);
+  }
+  /** Subscribe to messages from all registered devices */
+  subscribeToMessages(callback) {
+    this.messageCallbacks.add(callback);
+    if (!this.subscribed) {
+      this.startSubscription();
+    }
+    return () => {
+      this.messageCallbacks.delete(callback);
+      if (this.messageCallbacks.size === 0 && this.subscribed) {
+        this.stopSubscription();
+      }
+    };
+  }
+  /** Internal: Start the message subscription via RPC */
+  async startSubscription() {
+    const api2 = await this.os.getRPCAPI();
+    await api2.devices_subscribe((message) => {
+      for (const callback of this.messageCallbacks) {
+        try {
+          callback(message);
+        } catch (error) {
+          console.error("Error in device message callback:", error);
+        }
+      }
+    });
+    this.subscribed = true;
+  }
+  /** Internal: Stop the message subscription */
+  async stopSubscription() {
+    const api2 = await this.os.getRPCAPI();
+    await api2.devices_unsubscribe();
+    this.subscribed = false;
+  }
+};
+
 // src/framework/PreferencesManager.ts
 var PreferencesManager = class {
   constructor(os) {
@@ -1280,7 +1359,9 @@ var UserManager = class {
 var OS = class {
   constructor(config = { target: window.parent }) {
     this.config = config;
+    this.accounts = new AccountManager(this);
     this.apps = new AppManager(this);
+    this.devices = new DeviceManager(this);
     this.prefs = new PreferencesManager(this);
     this.user = new UserManager(this);
   }