@domicile-desktop/sdk 0.0.0-alpha-bf4214ef2f5b → 0.0.0-alpha-eac3f852668d

package/dist/portal.d.ts

@@ -2,8 +2,10 @@ import type { DomicileHost } from "./domicile-host";
 export declare enum PortalKind {
     /** A yes/no question, such as whether an application may use the camera. */
     Access = 0,
+    /** Pick an application to open a file or URI with. */
+    AppChooser = 1,
     /** A kind this SDK cannot parse. Answer it with {@link PortalAnswer.Refused}. */
-    Unknown = 1
+    Unknown = 2
 }
 /** What every request carries. */
 export type PortalRequestBase = {
@@ -22,6 +24,18 @@ export type AccessBody = {
     grantLabel: string | undefined;
     denyLabel: string | undefined;
 };
+/** What an app chooser opens, and the applications it offers. */
+export type AppChooserBody = {
+    /** Desktop file IDs without `.desktop`. May change while the dialog is up. */
+    choices: readonly string[];
+    /** The application chosen last time for this content type. */
+    lastChoice: string | undefined;
+    /** The MIME type being opened. */
+    contentType: string | undefined;
+    uri: string | undefined;
+    /** The file's name, without its directory. */
+    filename: string | undefined;
+};
 export declare const PortalRequest: {
     Access: (base: PortalRequestBase, body: AccessBody) => {
         /** The id {@link answerPortalRequest} takes. */
@@ -33,6 +47,16 @@ export declare const PortalRequest: {
         body: AccessBody;
         kind: PortalKind.Access;
     };
+    AppChooser: (base: PortalRequestBase, body: AppChooserBody) => {
+        /** The id {@link answerPortalRequest} takes. */
+        id: number;
+        /** The asking application's desktop file id. Empty when unknown. */
+        appId: string;
+        /** The `<app>` to show the dialog over, or the focused screen when absent. */
+        parentAppId: string | undefined;
+        body: AppChooserBody;
+        kind: PortalKind.AppChooser;
+    };
     Unknown: (base: PortalRequestBase, wireKind: string) => {
         /** The id {@link answerPortalRequest} takes. */
         id: number;
@@ -48,15 +72,22 @@ export type PortalRequest = ReturnType<(typeof PortalRequest)[keyof typeof Porta
 export declare enum PortalAnswerKind {
     /** The user allowed an {@link PortalKind.Access} request. */
     Access = 0,
+    /** The application the user picked in an {@link PortalKind.AppChooser}. */
+    AppChooser = 1,
     /** The user dismissed or denied the dialog. */
-    Canceled = 1,
+    Canceled = 2,
     /** The shell has no dialog for this kind. */
-    Refused = 2
+    Refused = 3
 }
 export declare const PortalAnswer: {
     Access: () => {
         kind: PortalAnswerKind.Access;
     };
+    /** `choice` must be one of the request's `choices`. */
+    AppChooser: (choice: string) => {
+        choice: string;
+        kind: PortalAnswerKind.AppChooser;
+    };
     Canceled: () => {
         kind: PortalAnswerKind.Canceled;
     };

package/dist/portal.js

@@ -9,8 +9,10 @@ export var PortalKind;
 (function (PortalKind) {
     /** A yes/no question, such as whether an application may use the camera. */
     PortalKind[PortalKind["Access"] = 0] = "Access";
+    /** Pick an application to open a file or URI with. */
+    PortalKind[PortalKind["AppChooser"] = 1] = "AppChooser";
     /** A kind this SDK cannot parse. Answer it with {@link PortalAnswer.Refused}. */
-    PortalKind[PortalKind["Unknown"] = 1] = "Unknown";
+    PortalKind[PortalKind["Unknown"] = 2] = "Unknown";
 })(PortalKind || (PortalKind = {}));
 export const PortalRequest = {
     Access: (base, body) => ({
@@ -18,6 +20,11 @@ export const PortalRequest = {
         body,
         kind: PortalKind.Access,
     }),
+    AppChooser: (base, body) => ({
+        ...base,
+        body,
+        kind: PortalKind.AppChooser,
+    }),
     Unknown: (base, wireKind) => ({
         ...base,
         kind: PortalKind.Unknown,
@@ -28,13 +35,20 @@ export var PortalAnswerKind;
 (function (PortalAnswerKind) {
     /** The user allowed an {@link PortalKind.Access} request. */
     PortalAnswerKind[PortalAnswerKind["Access"] = 0] = "Access";
+    /** The application the user picked in an {@link PortalKind.AppChooser}. */
+    PortalAnswerKind[PortalAnswerKind["AppChooser"] = 1] = "AppChooser";
     /** The user dismissed or denied the dialog. */
-    PortalAnswerKind[PortalAnswerKind["Canceled"] = 1] = "Canceled";
+    PortalAnswerKind[PortalAnswerKind["Canceled"] = 2] = "Canceled";
     /** The shell has no dialog for this kind. */
-    PortalAnswerKind[PortalAnswerKind["Refused"] = 2] = "Refused";
+    PortalAnswerKind[PortalAnswerKind["Refused"] = 3] = "Refused";
 })(PortalAnswerKind || (PortalAnswerKind = {}));
 export const PortalAnswer = {
     Access: () => ({ kind: PortalAnswerKind.Access }),
+    /** `choice` must be one of the request's `choices`. */
+    AppChooser: (choice) => ({
+        choice,
+        kind: PortalAnswerKind.AppChooser,
+    }),
     Canceled: () => ({ kind: PortalAnswerKind.Canceled }),
     Refused: () => ({ kind: PortalAnswerKind.Refused }),
 };
@@ -56,7 +70,7 @@ export const watchPortalRequests = (host, listener) => {
 };
 /** Answer request `id`. The first answer to reach the compositor wins. */
 export const answerPortalRequest = (host, id, answer) => {
-    host.answerPortalRequest(id, JSON.stringify({ kind: wireAnswer(answer) }));
+    host.answerPortalRequest(id, JSON.stringify(wireAnswer(answer)));
 };
 const accessSchema = z
     .object({
@@ -73,12 +87,31 @@ const accessSchema = z
     subtitle: body.subtitle,
     title: body.title,
 }));
+const appChooserSchema = z
+    .object({
+    choices: z.array(z.string()),
+    content_type: z.string().optional(),
+    filename: z.string().optional(),
+    last_choice: z.string().optional(),
+    uri: z.string().optional(),
+})
+    .transform((body) => ({
+    choices: body.choices,
+    contentType: body.content_type,
+    filename: body.filename,
+    lastChoice: body.last_choice,
+    uri: body.uri,
+}));
 /** Each kind's wire name, and how to read its body into a request. */
 const KINDS = new Map([
     [
         "access",
         (base, body) => PortalRequest.Access(base, accessSchema.parse(body)),
     ],
+    [
+        "app_chooser",
+        (base, body) => PortalRequest.AppChooser(base, appChooserSchema.parse(body)),
+    ],
 ]);
 const itemSchema = z.object({
     app_id: z.string(),
@@ -102,13 +135,16 @@ const parseRequest = (item) => {
         ? PortalRequest.Unknown(base, item.kind)
         : parse(base, item.body);
 };
+/** `answer` as the compositor reads it. */
 const wireAnswer = (answer) => {
     switch (answer.kind) {
         case PortalAnswerKind.Access:
-            return "access";
+            return { kind: "access" };
+        case PortalAnswerKind.AppChooser:
+            return { choice: answer.choice, kind: "app_chooser" };
         case PortalAnswerKind.Canceled:
-            return "canceled";
+            return { kind: "canceled" };
         case PortalAnswerKind.Refused:
-            return "refused";
+            return { kind: "refused" };
     }
 };

package/package.json

@@ -95,7 +95,7 @@
     "test:unit": "bun test"
   },
   "type": "module",
-  "version": "0.0.0-alpha-bf4214ef2f5b",
+  "version": "0.0.0-alpha-eac3f852668d",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cprussin/domicile.git",