Request Permission

import { MiniKit } from "@worldcoin/minikit-js";
import {
  Permission,
  type CommandResultByVia,
  type MiniAppRequestPermissionSuccessPayload,
  type MiniKitRequestPermissionOptions,
} from "@worldcoin/minikit-js/commands";

export async function requestNotifications() {
  const input = {
    permission: Permission.Notifications,
  } satisfies MiniKitRequestPermissionOptions;

  const result: CommandResultByVia<
    MiniAppRequestPermissionSuccessPayload,
    MiniAppRequestPermissionSuccessPayload,
    "minikit"
  > = await MiniKit.requestPermission(input);

  console.log(result.data.permission);
}

type MiniKitRequestPermissionOptions = {
  permission: Permission;
  fallback?: () => unknown;
};

type RequestPermissionResponse =
  | {
      executedWith: "minikit";
      data: {
        status: "success";
        version: number;
        permission: "notifications" | "contacts" | "microphone";
        timestamp: string;
      };
    }
  | {
      executedWith: "fallback";
      data: unknown;
    };

{
  "executedWith": "minikit",
  "data": {
    "status": "success",
    "version": 1,
    "permission": "notifications",
    "timestamp": "2026-03-28T18:24:00.000Z"
  }
}