hytopia 0.10.19 → 0.10.20

package/docs/server.player.md

@@ -291,6 +291,20 @@ Joins a player to a world.
 Resets all inputs keys
 
 
+</td></tr>
+<tr><td>
+
+[scheduleNotification(type, scheduledFor)](./server.player.schedulenotification.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Schedule a notification the player at a point in time in the future. This will automatically handle prompting a player (if necessary) for notification permissions in-game.
+
+
 </td></tr>
 <tr><td>
 
@@ -305,6 +319,20 @@ Resets all inputs keys
 Set the persisted data for the player. This data can later be retrieved using [Player.getPersistedData()](./server.player.getpersisteddata.md)<!-- -->, even if a player disconnects and rejoin a game in the future, or joins a different HYTOPIA managed lobby of your game.
 
 
+</td></tr>
+<tr><td>
+
+[unscheduleNotification(notificationId)](./server.player.unschedulenotification.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Unschedules a scheduled notification for the player.
+
+
 </td></tr>
 </tbody></table>
 

package/docs/server.player.schedulenotification.md

@@ -0,0 +1,72 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [Player](./server.player.md) &gt; [scheduleNotification](./server.player.schedulenotification.md)
+
+## Player.scheduleNotification() method
+
+Schedule a notification the player at a point in time in the future. This will automatically handle prompting a player (if necessary) for notification permissions in-game.
+
+**Signature:**
+
+```typescript
+scheduleNotification(type: string, scheduledFor: number): Promise<string | void>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+type
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+The type of notification to schedule.
+
+
+</td></tr>
+<tr><td>
+
+scheduledFor
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+The point in time in the future to schedule the notification for.
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+Promise&lt;string \| void&gt;
+
+The id of the notification if it was scheduled successfully, undefined otherwise.
+

package/docs/server.player.unschedulenotification.md

@@ -0,0 +1,56 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [Player](./server.player.md) &gt; [unscheduleNotification](./server.player.unschedulenotification.md)
+
+## Player.unscheduleNotification() method
+
+Unschedules a scheduled notification for the player.
+
+**Signature:**
+
+```typescript
+unscheduleNotification(notificationId: string): Promise<boolean>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+notificationId
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+The id of the notification returned from [Player.scheduleNotification()](./server.player.schedulenotification.md)<!-- -->.
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+Promise&lt;boolean&gt;
+
+boolean - True if the notification was unscheduled, false otherwise.
+

package/docs/server.playerevent.md

@@ -85,6 +85,20 @@ RECONNECTED\_WORLD
 </td><td>
 
 
+</td></tr>
+<tr><td>
+
+REQUEST\_NOTIFICATION\_PERMISSION
+
+
+</td><td>
+
+`"PLAYER.REQUEST_NOTIFICATION_PERMISSION"`
+
+
+</td><td>
+
+
 </td></tr>
 <tr><td>
 

package/docs/server.playereventpayloads._player.request_notification_permission_.md

@@ -0,0 +1,15 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [PlayerEventPayloads](./server.playereventpayloads.md) &gt; ["PLAYER.REQUEST\_NOTIFICATION\_PERMISSION"](./server.playereventpayloads._player.request_notification_permission_.md)
+
+## PlayerEventPayloads."PLAYER.REQUEST\_NOTIFICATION\_PERMISSION" property
+
+Emitted when notification permission is requested by a game.
+
+**Signature:**
+
+```typescript
+[PlayerEvent.REQUEST_NOTIFICATION_PERMISSION]: {
+        player: Player;
+    };
+```

package/docs/server.playereventpayloads.md

@@ -110,6 +110,25 @@ Emitted when a player leaves a world.
 Emitted when a player reconnects to a world after a unintentional disconnect.
 
 
+</td></tr>
+<tr><td>
+
+["PLAYER.REQUEST\_NOTIFICATION\_PERMISSION"](./server.playereventpayloads._player.request_notification_permission_.md)
+
+
+</td><td>
+
+
+</td><td>
+
+{ player: [Player](./server.player.md)<!-- -->; }
+
+
+</td><td>
+
+Emitted when notification permission is requested by a game.
+
+
 </td></tr>
 <tr><td>
 

package/docs/server.rigidbody.md

@@ -262,27 +262,6 @@ The effective angular inertia of the rigid body.
 The effective inverse mass of the rigid body.
 
 
-</td></tr>
-<tr><td>
-
-[effectiveWorldInversePrincipalAngularInertiaSqrt](./server.rigidbody.effectiveworldinverseprincipalangularinertiasqrt.md)
-
-
-</td><td>
-
-`readonly`
-
-
-</td><td>
-
-[SpdMatrix3](./server.spdmatrix3.md) \| undefined
-
-
-</td><td>
-
-The effective world inverse principal angular inertia square root of the rigid body.
-
-
 </td></tr>
 <tr><td>
 
@@ -367,27 +346,6 @@ number \| undefined
 The inverse mass of the rigid body.
 
 
-</td></tr>
-<tr><td>
-
-[inversePrincipalAngularInertiaSqrt](./server.rigidbody.inverseprincipalangularinertiasqrt.md)
-
-
-</td><td>
-
-`readonly`
-
-
-</td><td>
-
-[Vector3Like](./server.vector3like.md) \| undefined
-
-
-</td><td>
-
-The inverse principal angular inertia square root of the rigid body.
-
-
 </td></tr>
 <tr><td>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hytopia",
-  "version": "0.10.19",
+  "version": "0.10.20",
   "description": "The HYTOPIA SDK makes it easy for developers to create massively multiplayer games using JavaScript or TypeScript.",
   "type": "module",
   "main": "./server.mjs",

package/server.api.json

@@ -35782,6 +35782,75 @@
               "isAbstract": false,
               "name": "resetInputs"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "server!Player#scheduleNotification:member(1)",
+              "docComment": "/**\n * Schedule a notification the player at a point in time in the future. This will automatically handle prompting a player (if necessary) for notification permissions in-game.\n *\n * @param type - The type of notification to schedule.\n *\n * @param scheduledFor - The point in time in the future to schedule the notification for.\n *\n * @returns The id of the notification if it was scheduled successfully, undefined otherwise.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "scheduleNotification(type: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", scheduledFor: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string | void>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 7
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "type",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "scheduledFor",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "scheduleNotification"
+            },
             {
               "kind": "Method",
               "canonicalReference": "server!Player#setPersistedData:member(1)",
@@ -35871,6 +35940,59 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "server!Player#unscheduleNotification:member(1)",
+              "docComment": "/**\n * Unschedules a scheduled notification for the player.\n *\n * @param notificationId - The id of the notification returned from {@link Player.scheduleNotification}.\n *\n * @returns boolean - True if the notification was unscheduled, false otherwise.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "unscheduleNotification(notificationId: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<boolean>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 5
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "notificationId",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "unscheduleNotification"
+            },
             {
               "kind": "Property",
               "canonicalReference": "server!Player#username:member",
@@ -38855,6 +38977,27 @@
               "releaseTag": "Public",
               "name": "RECONNECTED_WORLD"
             },
+            {
+              "kind": "EnumMember",
+              "canonicalReference": "server!PlayerEvent.REQUEST_NOTIFICATION_PERMISSION:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "REQUEST_NOTIFICATION_PERMISSION = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "\"PLAYER.REQUEST_NOTIFICATION_PERMISSION\""
+                }
+              ],
+              "initializerTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "name": "REQUEST_NOTIFICATION_PERMISSION"
+            },
             {
               "kind": "EnumMember",
               "canonicalReference": "server!PlayerEvent.REQUEST_SYNC:member",
@@ -39100,6 +39243,51 @@
                 "endIndex": 8
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "server!PlayerEventPayloads#\"PLAYER.REQUEST_NOTIFICATION_PERMISSION\":member",
+              "docComment": "/**\n * Emitted when notification permission is requested by a game.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "["
+                },
+                {
+                  "kind": "Reference",
+                  "text": "PlayerEvent.REQUEST_NOTIFICATION_PERMISSION",
+                  "canonicalReference": "server!PlayerEvent.REQUEST_NOTIFICATION_PERMISSION:member"
+                },
+                {
+                  "kind": "Content",
+                  "text": "]: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "{\n        player: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Player",
+                  "canonicalReference": "server!Player:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";\n    }"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "\"PLAYER.REQUEST_NOTIFICATION_PERMISSION\"",
+              "propertyTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 6
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "server!PlayerEventPayloads#\"PLAYER.REQUEST_SYNC\":member",
@@ -43046,41 +43234,6 @@
               "isProtected": false,
               "isAbstract": false
             },
-            {
-              "kind": "Property",
-              "canonicalReference": "server!RigidBody#effectiveWorldInversePrincipalAngularInertiaSqrt:member",
-              "docComment": "/**\n * The effective world inverse principal angular inertia square root of the rigid body.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get effectiveWorldInversePrincipalAngularInertiaSqrt(): "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "SpdMatrix3",
-                  "canonicalReference": "server!SpdMatrix3:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": " | undefined"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "effectiveWorldInversePrincipalAngularInertiaSqrt",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 3
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
             {
               "kind": "Property",
               "canonicalReference": "server!RigidBody#enabledPositions:member",
@@ -43256,41 +43409,6 @@
               "isProtected": false,
               "isAbstract": false
             },
-            {
-              "kind": "Property",
-              "canonicalReference": "server!RigidBody#inversePrincipalAngularInertiaSqrt:member",
-              "docComment": "/**\n * The inverse principal angular inertia square root of the rigid body.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get inversePrincipalAngularInertiaSqrt(): "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "Vector3Like",
-                  "canonicalReference": "server!Vector3Like:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": " | undefined"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "inversePrincipalAngularInertiaSqrt",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 3
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
             {
               "kind": "Property",
               "canonicalReference": "server!RigidBody#isCcdEnabled:member",

package/server.d.ts

@@ -4424,6 +4424,23 @@ export declare class Player extends EventRouter implements protocol.Serializable
      * @param world - The world to join the player to.
      */
     joinWorld(world: World): void;
+    /**
+     * Schedule a notification the player at a point in time in the future.
+     * This will automatically handle prompting a player (if necessary) for
+     * notification permissions in-game.
+     *
+     * @param type - The type of notification to schedule.
+     * @param scheduledFor - The point in time in the future to schedule the notification for.
+     * @returns The id of the notification if it was scheduled successfully, undefined otherwise.
+     */
+    scheduleNotification(type: string, scheduledFor: number): Promise<string | void>;
+    /**
+     * Unschedules a scheduled notification for the player.
+     *
+     * @param notificationId - The id of the notification returned from {@link Player.scheduleNotification}.
+     * @returns boolean - True if the notification was unscheduled, false otherwise.
+     */
+    unscheduleNotification(notificationId: string): Promise<boolean>;
 
 
     /**
@@ -4818,6 +4835,7 @@ export declare enum PlayerEvent {
     JOINED_WORLD = "PLAYER.JOINED_WORLD",
     LEFT_WORLD = "PLAYER.LEFT_WORLD",
     RECONNECTED_WORLD = "PLAYER.RECONNECTED_WORLD",
+    REQUEST_NOTIFICATION_PERMISSION = "PLAYER.REQUEST_NOTIFICATION_PERMISSION",
     REQUEST_SYNC = "PLAYER.REQUEST_SYNC"
 }
 
@@ -4843,6 +4861,10 @@ export declare interface PlayerEventPayloads {
         player: Player;
         world: World;
     };
+    /** Emitted when notification permission is requested by a game. */
+    [PlayerEvent.REQUEST_NOTIFICATION_PERMISSION]: {
+        player: Player;
+    };
     /** Emitted when a player's client requests a round trip time synchronization. */
     [PlayerEvent.REQUEST_SYNC]: {
         player: Player;
@@ -5310,8 +5332,6 @@ export declare class RigidBody extends EventRouter {
     get effectiveAngularInertia(): SpdMatrix3 | undefined;
     /** The effective inverse mass of the rigid body. */
     get effectiveInverseMass(): Vector3Like | undefined;
-    /** The effective world inverse principal angular inertia square root of the rigid body. */
-    get effectiveWorldInversePrincipalAngularInertiaSqrt(): SpdMatrix3 | undefined;
     /** The enabled axes of rotational movement of the rigid body. */
     get enabledRotations(): Vector3Boolean;
     /** The enabled axes of positional movement of the rigid body. */
@@ -5320,8 +5340,6 @@ export declare class RigidBody extends EventRouter {
     get gravityScale(): number;
     /** The inverse mass of the rigid body. */
     get inverseMass(): number | undefined;
-    /** The inverse principal angular inertia square root of the rigid body. */
-    get inversePrincipalAngularInertiaSqrt(): Vector3Like | undefined;
     /** Whether the rigid body has continuous collision detection enabled. */
     get isCcdEnabled(): boolean;
     /** Whether the rigid body is dynamic. */