lumiverse-spindle-types 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumiverse-spindle-types",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "types": "./src/index.ts",
   "keywords": [
     "lumiverse",

package/src/dom.ts

@@ -158,6 +158,13 @@ export interface SpindleMessageTagInterceptorOptions {
   removeFromMessage?: boolean;
 }
 
+/** Options for `permissions.request()` — displayed in the system confirmation modal. */
+export interface PermissionRequestOptions {
+  /** Human-readable explanation of why the extension needs these permissions.
+   *  Shown to the user in the confirmation modal. */
+  reason?: string;
+}
+
 /** Context object provided to frontend extension modules */
 export interface SpindleFrontendContext {
   dom: SpindleDOMHelper;
@@ -183,9 +190,10 @@ export interface SpindleFrontendContext {
   permissions: {
     getGranted(): Promise<string[]>;
     /** Request that the given permissions be granted. Returns the updated granted list.
+     *  A system-level confirmation modal is shown to the user before any permissions are applied.
      *  Privileged permissions (e.g. cors_proxy) require admin/owner approval.
-     *  The extension may be restarted after permissions are applied. */
-    request(permissions: string[]): Promise<string[]>;
+     *  Rejects with an error if the user denies the request. */
+    request(permissions: string[], options?: PermissionRequestOptions): Promise<string[]>;
   };
   sendToBackend(payload: unknown): void;
   onBackendMessage(handler: (payload: unknown) => void): () => void;

package/src/index.ts

@@ -33,6 +33,7 @@ export type {
   SpindleUploadFile,
   SpindleMessageTagIntercept,
   SpindleMessageTagInterceptorOptions,
+  PermissionRequestOptions,
   SpindleFrontendContext,
   SpindleFrontendModule,
   SpindleDrawerTabOptions,