@jest-com/types 1.260923.5 → 1.260928.9

package/index.d.ts

@@ -89,6 +89,10 @@ export type SubscriptionData = {
 
 export type RedirectToTeamGameErrorCode = "game_not_found" | "different_team" | "internal_error";
 export type NotificationPriority = "low" | "medium" | "high" | "critical";
+export type CaptureEventOptions = {
+    send_instantly?: boolean;
+    transport?: "XHR" | "fetch" | "sendBeacon";
+};
 export type ReferralNotificationVariant = {
     title?: string | null;
     body: string;
@@ -553,6 +557,33 @@ export interface SocialModule {
         size?: AvatarSize;
         username: string;
     }): string;
+    /**
+     * Opens the platform's share sheet for an image — the same sheet the
+     * platform's own screenshot button shows, offering chat, the native share
+     * sheet and download. The player picks where it goes and writes the
+     * caption, so a game can never share on the player's behalf without a tap.
+     *
+     * @param options.image - Base64 PNG (raw or data URL). Omit it to have the
+     * platform capture the canvas, or your registered screenshot provider.
+     * @param options.entryPayload - Handed back to your game when a player
+     * opens the shared message, so a code or coupon travels with it.
+     * @returns `{ canceled: true }` when the sheet closed without sharing,
+     * including a player who left the page while the post was still landing,
+     * so it is not proof that nothing was posted.
+     * @example
+     * ```typescript
+     * await JestSDK.social.shareImage({
+     *   image: couponCanvas.toDataURL("image/png"),
+     *   entryPayload: { coupon: "SPRING25" },
+     * });
+     * ```
+     */
+    shareImage(options?: {
+        image?: string;
+        entryPayload?: Record<string, unknown>;
+    }): Promise<{
+        canceled: boolean;
+    }>;
     /**
      * Registers a custom screenshot source used when the platform asks the
      * game for a screenshot, replacing the SDK's automatic canvas capture.
@@ -1149,9 +1180,10 @@ export interface JestSDK {
      *   Use stable, lowercase, snake_case names.
      * @param properties - Optional structured data attached to the event
      *   (e.g. `{ level: 5, score: 1200 }`).
+     * @param options - Optional immediate sending and transport overrides.
      * @throws {Error} If the SDK is not initialized or arguments are invalid.
      */
-    captureEvent(eventName: string, properties?: Record<string, unknown>): void;
+    captureEvent(eventName: string, properties?: Record<string, unknown>, options?: CaptureEventOptions): void;
     /**
      * Redirects the player to another game owned by the same team as the
      * calling game. The platform performs the navigation after verifying

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jest-com/types",
-  "version": "1.260923.5",
+  "version": "1.260928.9",
   "description": "TypeScript types for the Jest HTML5 game SDK global (window.JestSDK).",
   "keywords": [
     "jest",