@voyant-travel/apps 0.10.3 → 0.11.0

package/dist/compiler.js

@@ -53,7 +53,14 @@ function normalizeManifest(manifest) {
             optional: sortedUnique(manifest.scopes.optional),
         },
         admin: {
-            pages: [...manifest.admin.pages].sort(byKey),
+            // Resolve the app-level default icon into each page that omits its own,
+            // so every normalized/persisted page carries a concrete icon or none.
+            pages: [...manifest.admin.pages]
+                .map((page) => {
+                const icon = page.icon ?? manifest.icon;
+                return icon ? { ...page, icon } : page;
+            })
+                .sort(byKey),
             slotExtensions: [...manifest.admin.slotExtensions]
                 .map((extension) => ({ ...extension, slots: sortedUnique(extension.slots) }))
                 .sort(byKey),

package/dist/compiler.test.js

@@ -102,6 +102,54 @@ describe("app manifest compiler", () => {
             },
         })).toThrow(/not an external event contract/);
     });
+    it("accepts an HTTPS per-page nav icon and rejects a non-HTTPS one", () => {
+        const parsed = appManifestSchema.parse({
+            ...validManifest,
+            admin: {
+                ...validManifest.admin,
+                pages: [{ ...validManifest.admin.pages[0], icon: "https://app.example.com/icon.svg" }],
+            },
+        });
+        expect(parsed.admin.pages[0]?.icon).toBe("https://app.example.com/icon.svg");
+        expect(() => appManifestSchema.parse({
+            ...validManifest,
+            admin: {
+                ...validManifest.admin,
+                pages: [{ ...validManifest.admin.pages[0], icon: "http://app.example.com/icon.svg" }],
+            },
+        })).toThrow(/https/i);
+    });
+    it("resolves the app-level default icon into pages that omit their own", () => {
+        const normalized = compileAppManifest({
+            ...validManifest,
+            icon: "https://app.example.com/app-icon.svg",
+            admin: {
+                ...validManifest.admin,
+                pages: [
+                    {
+                        key: "inherits",
+                        titleKey: "t",
+                        path: "/inherits",
+                        entryUrl: "https://app.example.com/a",
+                    },
+                    {
+                        key: "owns",
+                        titleKey: "t",
+                        path: "/owns",
+                        entryUrl: "https://app.example.com/b",
+                        icon: "https://app.example.com/own-icon.svg",
+                    },
+                ],
+            },
+        }).normalizedRelease;
+        const byKey = new Map(normalized.adminPages.map((page) => [page.key, page.icon]));
+        expect(byKey.get("inherits")).toBe("https://app.example.com/app-icon.svg");
+        expect(byKey.get("owns")).toBe("https://app.example.com/own-icon.svg");
+    });
+    it("leaves pages without an icon when neither the page nor the app declares one", () => {
+        const normalized = compileAppManifest(validManifest).normalizedRelease;
+        expect(normalized.adminPages[0]?.icon).toBeUndefined();
+    });
     it("rejects webhook endpoints that target local infrastructure", () => {
         expect(() => compileAppManifest({
             ...validManifest,

package/dist/contracts.d.ts

@@ -44,6 +44,7 @@ export declare const appManifestSchema: z.ZodPipe<z.ZodRecord<z.ZodString, z.Zod
         min: z.ZodString;
         max: z.ZodString;
     }, z.core.$strict>;
+    icon: z.ZodOptional<z.ZodString>;
     scopes: z.ZodObject<{
         requested: z.ZodDefault<z.ZodArray<z.ZodString>>;
         optional: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -54,6 +55,7 @@ export declare const appManifestSchema: z.ZodPipe<z.ZodRecord<z.ZodString, z.Zod
             titleKey: z.ZodString;
             path: z.ZodString;
             entryUrl: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>>;
         slotExtensions: z.ZodDefault<z.ZodArray<z.ZodObject<{
             key: z.ZodString;

package/dist/contracts.js

@@ -91,6 +91,12 @@ const adminPageSchema = z
         .trim()
         .regex(/^\/[a-z0-9-_/]*$/),
     entryUrl: httpsUrlSchema,
+    /**
+     * App-declared nav icon rendered as a remote `<img>` in admin chrome.
+     * HTTPS-only; the app-level {@link appManifestSchema} `icon` is the
+     * fallback when a page omits its own. Absent/invalid → generic app icon.
+     */
+    icon: httpsUrlSchema.optional(),
 })
     .strict();
 const slotExtensionSchema = z
@@ -126,6 +132,11 @@ export const appManifestSchema = manifestDisallowedKeySchema.pipe(z
     schemaVersion: z.literal(APP_MANIFEST_SCHEMA_VERSION),
     releaseVersion: semverLikeSchema,
     apiCompatibility: z.object({ min: semverLikeSchema, max: semverLikeSchema }).strict(),
+    /**
+     * App-level default nav icon (HTTPS remote asset). Applied at normalize
+     * time to any admin page that omits its own `icon`.
+     */
+    icon: httpsUrlSchema.optional(),
     scopes: z
         .object({
         requested: z.array(scopeSchema).default([]),

package/dist/extension-resolution.d.ts

@@ -36,6 +36,12 @@ export interface ResolvedAppPage {
     title: string;
     /** Host-rendered navigation label for the page's nav entry. */
     navLabel: string;
+    /**
+     * App-declared nav icon (HTTPS remote asset). Already resolved through the
+     * app-level default at manifest-normalize time; absent when neither the page
+     * nor the app declared one (the host falls back to a generic app icon).
+     */
+    icon?: string;
     appLocale: string;
     direction: AppTextDirection;
 }

package/dist/extension-resolution.js

@@ -69,6 +69,7 @@ export function assembleInstalledExtensions(rows, localizationsByRelease, option
                 entryUrl: page.entryUrl,
                 title,
                 navLabel,
+                ...(page.icon ? { icon: page.icon } : {}),
                 appLocale: locale.appLocale,
                 direction: locale.direction,
             });
@@ -136,7 +137,8 @@ function parsePageDescriptor(value) {
     const entryUrl = stringField(value.entryUrl);
     if (!key || !titleKey || !path || !entryUrl)
         return null;
-    return { key, titleKey, path, entryUrl };
+    const icon = stringField(value.icon);
+    return icon ? { key, titleKey, path, entryUrl, icon } : { key, titleKey, path, entryUrl };
 }
 function parseSlotDescriptor(value) {
     const key = stringField(value.key);

package/dist/extension-resolution.test.js

@@ -67,6 +67,23 @@ describe("assembleInstalledExtensions", () => {
         expect(page?.title).toBe("App Settings");
         expect(page?.navLabel).toBe("Settings");
     });
+    it("threads a page's icon from the descriptor when present", () => {
+        const withIcon = pageRow({
+            descriptor: {
+                key: "settings",
+                titleKey: "settings.title",
+                path: "/settings",
+                entryUrl: "https://app.example.com/settings",
+                icon: "https://app.example.com/settings-icon.svg",
+            },
+        });
+        const result = assembleInstalledExtensions([withIcon], localizations, { activeLocale: "en" });
+        expect(result.pages[0]?.icon).toBe("https://app.example.com/settings-icon.svg");
+    });
+    it("leaves icon undefined when the descriptor omits it", () => {
+        const result = assembleInstalledExtensions([pageRow()], localizations, { activeLocale: "en" });
+        expect(result.pages[0]?.icon).toBeUndefined();
+    });
     it("filters out extensionApi-incompatible slot extensions", () => {
         const incompatible = slotRow({
             descriptor: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/apps",
-  "version": "0.10.3",
+  "version": "0.11.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -131,15 +131,15 @@
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.27",
     "zod": "^4.4.3",
-    "@voyant-travel/admin": "^0.127.0",
+    "@voyant-travel/admin": "^0.128.0",
     "@voyant-travel/admin-extension-sdk": "^0.2.0",
     "@voyant-travel/core": "^0.130.0",
-    "@voyant-travel/custom-fields": "^0.2.8",
+    "@voyant-travel/custom-fields": "^0.2.9",
     "@voyant-travel/finance-contracts": "^0.107.0",
-    "@voyant-travel/db": "^0.116.0",
-    "@voyant-travel/hono": "^0.131.1",
-    "@voyant-travel/types": "^0.109.7",
-    "@voyant-travel/webhook-delivery": "^0.4.6"
+    "@voyant-travel/hono": "^0.131.2",
+    "@voyant-travel/db": "^0.117.0",
+    "@voyant-travel/types": "^0.109.8",
+    "@voyant-travel/webhook-delivery": "^0.4.7"
   },
   "devDependencies": {
     "@types/node": "^25.5.2",