gear: permissions types

This implements the first draft of types as specified by the backend implementations:
- urbit/urbit#6493
- master...tinnus-napbus:landscape:tinnus/userspace-permissions

Based on out-of-band conversation with @tinnus-napbus, there is possibly some changes coming to this interface. (to be addressed in a follow up commit).

ui/src/gear/docket/types.ts

@@ -1,4 +1,5 @@
 import { Cass } from '../hood';
+import { Seal } from '../permissions';
 export type DeskStatus = 'active' | 'suspended';
 
 export type DocketHref = DocketHrefSite | DocketHrefGlob;
@@ -54,6 +55,8 @@ export interface Treaty extends Docket {
   desk: string;
   cass: Cass;
   hash: string;
+  bill: string[];
+  seal: Seal;
 }
 
 export interface Charges {

ui/src/gear/index.ts

@@ -12,7 +12,5 @@ export * as docket from './docket';
 export * from './docket';
 export * as utils from './utils';
 export * from './utils';
-
-// TODO: Userspace Permissions
-// export * from './permissions';
-// export * as permissions from './permissions';
+export * from './permissions';
+export * as permissions from './permissions';

ui/src/gear/permissions/index.ts

@@ -0,0 +1,2 @@
+export * from './lib';
+export * from './types';

ui/src/gear/permissions/lib.ts

@@ -0,0 +1 @@
+export {}

ui/src/gear/permissions/types.ts

@@ -0,0 +1,78 @@
+
+type PermType = "super" | "watch" | "write" | "reads" | "press";
+
+type Vane = 'ames' | 'behn' | 'clay' | 'dill' | 'eyre' | 'gall' | 'iris' | 'jael' | 'khan';
+
+type Tail = {
+  jump?: boolean;
+  care?: string | null;
+  desk?: string | null;
+  dude?: string | null;
+  path?: string | null;
+  ship?: string | null;
+  spur?: string | null;
+  vane?: string | null;
+} | null;
+
+
+interface Perm {
+  name: PermType;
+  vane: Vane | null;
+  tail: Tail;
+}
+
+export type Seal = Perm[];
+
+/**
+ * A passport-formatted permission
+ */
+interface PassportPerm {
+  kind: {
+    nom: string;
+    pes: {
+      desc: string;
+      // TODO: per tinnus, "have" is meant to say whether the app already has all / any of / none of the perms in question but currently it doesn't, it just always says nil.
+      have: "nil";
+      pers: Perm[];
+      warn: string | null;
+    }[]
+  }
+}
+
+interface AppPerm {
+  pes: {
+    node: {
+      desc: string;
+      have: "nil";
+      pers: Perm[];
+    }[]
+  };
+  app: string;
+}
+
+/**
+  * Per lib/perms.hoon, Passport is intended for consumption by permission
+  * management frontends.
+  */
+export interface Passport {
+  /**
+   * Categorized perms
+   */
+  rad: PassportPerm[];
+  /**
+   * Dangerous perms
+   */
+  sys: PassportPerm[];
+  /**
+   * All apps perms
+   */
+  any: PassportPerm[];
+  /**
+   * Unknown app perms
+   */
+  new: PassportPerm[];
+  /**
+   * Specific app perms
+   */
+  app: AppPerm[];
+}