@brydio/manifest 0.1.0-alpha.57 → 0.1.0-alpha.59

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brydio/manifest",
-  "version": "0.1.0-alpha.57",
+  "version": "0.1.0-alpha.59",
   "description": "The shape of a Brydio app's manifest, its collections' schemas, and the checks that say what is wrong with one.",
   "type": "module",
   "license": "MIT",
@@ -10,7 +10,7 @@
     "url": "https://github.com/nakel-ola/brydio-sdk",
     "directory": "packages/manifest"
   },
-  "gitHead": "0ce11b42dc51c1d6c9cd53dda9cffc2fbe0e73a2",
+  "gitHead": "3645964c21307d88950b196e4fd389ad82e6a286",
   "exports": {
     ".": {
       "types": "./src/index.d.ts",

package/src/grants.d.ts

@@ -16,8 +16,10 @@
  * is a handler's `webhooks.send` (FO07); `timers` is a handler's
  * `timers.*`, running one of the app's own tools later (PJ01); `calendar`
  * is a handler's `calendar.*`, the caller's events on the event layer (CA02).
+ * `people` is a handler's native HR operations as the current caller; it does
+ * not broaden `directory` access or authorize private records by itself.
  */
-export declare const HOST_CAPABILITIES: readonly ["navigate", "message", "members", "projects", "files", "chats", "model", "secrets", "notify", "approvals", "chat", "directory", "webhooks", "timers", "calendar", "metrics", "sign", "finance"];
+export declare const HOST_CAPABILITIES: readonly ["navigate", "message", "members", "projects", "files", "chats", "model", "secrets", "notify", "approvals", "chat", "directory", "webhooks", "timers", "calendar", "metrics", "sign", "finance", "people"];
 /** The older name for `HOST_CAPABILITIES`, kept for what already imports it. */
 export declare const KNOWN_HOST_GRANTS: readonly string[];
 /** True for a host grant Brydio knows how to honour: a named capability, or one connection. */

package/src/grants.js

@@ -17,6 +17,8 @@ import { BUNDLE_MANIFEST } from "./bundle.js";
  * is a handler's `webhooks.send` (FO07); `timers` is a handler's
  * `timers.*`, running one of the app's own tools later (PJ01); `calendar`
  * is a handler's `calendar.*`, the caller's events on the event layer (CA02).
+ * `people` is a handler's native HR operations as the current caller; it does
+ * not broaden `directory` access or authorize private records by itself.
  */
 export const HOST_CAPABILITIES = [
     'navigate',
@@ -37,6 +39,7 @@ export const HOST_CAPABILITIES = [
     'metrics',
     'sign',
     'finance',
+    'people',
 ];
 /** The older name for `HOST_CAPABILITIES`, kept for what already imports it. */
 export const KNOWN_HOST_GRANTS = HOST_CAPABILITIES;

package/src/schema.d.ts

@@ -107,6 +107,7 @@ declare const extensionShape: {
             "workspace-sidebar": "workspace-sidebar";
             "public-page": "public-page";
             "chat-card": "chat-card";
+            "person-profile": "person-profile";
         }>;
         screen: z.ZodString;
         sizes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
@@ -256,7 +257,7 @@ export interface DataProblem {
     field?: string;
     message: string;
 }
-export type DataProblemCode = FieldTypeInvalid['code'] | OpenProblemCode | ConfirmProblemCode | AnonymousProblemCode | ReadersProblemCode | EditorsProblemCode | 'data_too_many_collections' | 'data_too_many_fields' | 'data_collection_name_format' | 'data_field_name_format' | 'data_field_reserved' | 'data_label_format' | 'data_label_taken' | 'data_project_field_twice' | 'data_search_unknown_field' | 'data_search_not_text' | 'grant_collection_missing' | 'grant_tool_missing' | 'custom_name_taken' | 'custom_collection_unknown' | 'custom_input_invalid' | 'placement_key_taken' | 'placement_screen_unknown' | 'placement_home_sizes' | 'placement_sizes_not_home' | 'placement_widget_sizes' | 'placement_tab_retired' | 'placement_public_shape' | 'placement_public_nothing' | 'placement_chat_card_shape' | 'grant_tool_cross_app_self' | 'placement_children_too_deep' | 'placement_create_tool_unknown' | 'placement_create_not_write' | 'secret_name_taken' | 'grant_secrets_missing' | 'instances_needs_sidebar';
+export type DataProblemCode = FieldTypeInvalid['code'] | OpenProblemCode | ConfirmProblemCode | AnonymousProblemCode | ReadersProblemCode | EditorsProblemCode | 'data_too_many_collections' | 'data_too_many_fields' | 'data_collection_name_format' | 'data_field_name_format' | 'data_field_reserved' | 'data_label_format' | 'data_label_taken' | 'data_project_field_twice' | 'data_search_unknown_field' | 'data_search_not_text' | 'grant_collection_missing' | 'grant_tool_missing' | 'custom_name_taken' | 'custom_collection_unknown' | 'custom_input_invalid' | 'placement_key_taken' | 'placement_screen_unknown' | 'placement_home_sizes' | 'placement_sizes_not_home' | 'placement_widget_sizes' | 'placement_tab_retired' | 'placement_public_shape' | 'placement_public_nothing' | 'placement_chat_card_shape' | 'placement_person_profile_shape' | 'grant_tool_cross_app_self' | 'placement_children_too_deep' | 'placement_create_tool_unknown' | 'placement_create_not_write' | 'secret_name_taken' | 'grant_secrets_missing' | 'instances_needs_sidebar';
 type Additions = z.infer<z.ZodObject<typeof extensionShape>>;
 /**
  * Everything wrong with an app's additions that a type cannot say.
@@ -295,6 +296,7 @@ export declare const manifestExtensionsSchema: z.ZodObject<{
             "workspace-sidebar": "workspace-sidebar";
             "public-page": "public-page";
             "chat-card": "chat-card";
+            "person-profile": "person-profile";
         }>;
         screen: z.ZodString;
         sizes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
@@ -436,6 +438,7 @@ export declare const storedExtensionsSchema: z.ZodObject<{
             "workspace-sidebar": "workspace-sidebar";
             "public-page": "public-page";
             "chat-card": "chat-card";
+            "person-profile": "person-profile";
         }>;
         screen: z.ZodString;
         sizes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
@@ -612,6 +615,7 @@ export declare const appManifestSchema: z.ZodObject<{
             "workspace-sidebar": "workspace-sidebar";
             "public-page": "public-page";
             "chat-card": "chat-card";
+            "person-profile": "person-profile";
         }>;
         screen: z.ZodString;
         sizes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
@@ -792,6 +796,7 @@ export declare const newAppManifestSchema: z.ZodObject<{
             "workspace-sidebar": "workspace-sidebar";
             "public-page": "public-page";
             "chat-card": "chat-card";
+            "person-profile": "person-profile";
         }>;
         screen: z.ZodString;
         sizes: z.ZodOptional<z.ZodArray<z.ZodEnum<{

package/src/schema.js

@@ -77,8 +77,12 @@ const placementSchema = z.object({
      * a handler's `chat.post` (FO03). Nobody places it by hand, so it has no
      * `sizes`, `children` or `settings` (`placement_chat_card_shape`); its
      * screen sees `placement.kind === 'chat-card'` and the card's `route`.
+     * `person-profile`: a panel on every person's Directory profile, for
+     * viewers who can read the instance. Nobody places it by hand, so it has no
+     * `sizes`, `children` or `settings` (`placement_person_profile_shape`); its
+     * screen sees `placement.personId`, and reads only what the viewer may.
      */
-    kind: z.enum(['project-tab', 'project-widget', 'project-sidebar', 'workspace-sidebar', 'home', 'public-page', 'chat-card']),
+    kind: z.enum(['project-tab', 'project-widget', 'project-sidebar', 'workspace-sidebar', 'home', 'public-page', 'chat-card', 'person-profile']),
     screen: z.string().min(1).max(FIELD_LIMITS.nameChars),
     /** For `home` and `project-widget` only, and required there: the sizes the screen draws well at. */
     sizes: z.array(z.enum(HOME_CARD_SIZES)).max(3).optional(),
@@ -491,6 +495,13 @@ export function dataProblems(additions, options = {}) {
                 message: `The chat card "${placement.screen}" cannot have sizes, children or settings.`,
             });
         }
+        // A profile panel is drawn on every profile the viewer opens: nothing to size, configure or list.
+        if (placement.kind === 'person-profile' && (placement.sizes?.length || placement.children || placement.settings)) {
+            problems.push({
+                code: 'placement_person_profile_shape',
+                message: `The profile panel "${placement.screen}" cannot have sizes, children or settings.`,
+            });
+        }
     }
     // A public page with nothing public could show a visitor nothing at all.
     if ((additions.placements ?? []).some(placement => placement.kind === 'public-page')) {