@ambasada/sdk 0.8.4 → 0.8.5

package/dist/define.d.ts

@@ -12,6 +12,18 @@ export interface MiniAppConfig {
     entry: string;
     /** A 1024×1024 opaque PNG, a path on the app (default "/icon.png"). */
     icon?: string;
+    /** Who it is for (default "4+"). The hub refuses to register a mini app without one; above 12+ it opens only for people old enough. */
+    age_rating?: "4+" | "9+" | "12+" | "17+";
+    /** How the Ambasada app shows it (default "tool"). */
+    kind?: "product" | "event" | "tool" | "assistant";
+    /** Where people get help: "mailto:you@team.ro" or an https URL (default: the app's `support`). Needed to be Listed. */
+    support?: string;
+    /** Up to 5 search words. */
+    tags?: string[];
+    /** Under the name on the card (≤ 40; default: `description`, cut to one line). */
+    subtitle?: string;
+    /** The store description (≤ 170; default: the app's `description`). */
+    description?: string;
     /** Manifest fields beyond the defaults (docs/MINI-APPS.md §2). */
     category?: "shopping" | "food" | "events" | "tools" | "learning" | "community" | "games" | "finance" | "other";
     accent?: string;
@@ -26,6 +38,8 @@ export interface AppConfig {
     name: string;
     /** One line about the app (the mini app's subtitle and description, when there is one). */
     description?: string;
+    /** Where people get help: an email ("you@team.ro" or "mailto:…") or an https URL. The mini app's `support` by default. */
+    support?: string;
     /** Where the app runs; `ambasada link` sets it when you host elsewhere. */
     product?: {
         url?: string;
@@ -35,6 +49,10 @@ export interface AppConfig {
     /** Add-ons to load besides the ones found in node_modules (package names, e.g. "@ambasada/village"). */
     addons?: string[];
 }
+export declare const MINIAPP_AGE_RATINGS: readonly ["4+", "9+", "12+", "17+"];
+export declare const MINIAPP_KINDS: readonly ["product", "event", "tool", "assistant"];
+/** "you@team.ro" → "mailto:you@team.ro"; mailto: and https URLs as they are; anything else undefined. */
+export declare function supportUrl(value: string | undefined): string | undefined;
 /** A path the mini app may open at: absolute, no query, hash, `..` or `//`. */
 export declare const MINIAPP_ENTRY: RegExp;
 export declare function defineApp<T extends AppConfig>(config: T): T;

package/dist/platform.d.ts

@@ -10,7 +10,7 @@ export type * from "./types.js";
 export { getHeader } from "./headers.js";
 export type { HeaderSource } from "./headers.js";
 export { defineApp } from "./define.js";
-export { MINIAPP_ENTRY } from "./define.js";
+export { MINIAPP_AGE_RATINGS, MINIAPP_ENTRY, MINIAPP_KINDS, supportUrl } from "./define.js";
 export type { AppConfig, MiniAppConfig } from "./define.js";
 export { AmbasadaAuth, AUTH_PATHS, JWKS_TTL_MS, SESSION_TTL_S } from "./auth.js";
 export type { AmbasadaUser, AuthConfig, LoginOptions, ShellUser, WithHeaders } from "./auth.js";

package/dist/platform.js

@@ -779,6 +779,15 @@ function getHeader(headers, name) {
 }
 
 // src/define.ts
+var MINIAPP_AGE_RATINGS = ["4+", "9+", "12+", "17+"];
+var MINIAPP_KINDS = ["product", "event", "tool", "assistant"];
+function supportUrl(value) {
+  const v = value?.trim();
+  if (!v) return void 0;
+  if (/^mailto:[^@\s]+@[^@\s]+$/.test(v) || /^https:\/\/\S+$/.test(v)) return v;
+  if (/^[^@\s:/]+@[^@\s]+\.[^@\s]+$/.test(v)) return `mailto:${v}`;
+  return void 0;
+}
 var MINIAPP_ENTRY = /^\/(?:[A-Za-z0-9._~-]+(?:\/[A-Za-z0-9._~-]+)*)?$/;
 function defineApp(config) {
   if (typeof config.id !== "string" || !/^[a-z0-9][a-z0-9-]{0,62}$/.test(config.id)) throw new Error(`app id "${String(config.id)}" must be a lowercase slug (a-z, 0-9, -)`);
@@ -790,7 +799,12 @@ function defineApp(config) {
     }
     if (m.icon !== void 0 && (typeof m.icon !== "string" || !m.icon.startsWith("/"))) throw new Error(`${config.id}: miniapp.icon must be a path like "/icon.png"`);
     if (m.accent !== void 0 && !/^#[0-9a-fA-F]{6}$/.test(m.accent)) throw new Error(`${config.id}: miniapp.accent must be a #RRGGBB colour`);
+    if (m.age_rating !== void 0 && !MINIAPP_AGE_RATINGS.includes(m.age_rating)) throw new Error(`${config.id}: miniapp.age_rating must be one of ${MINIAPP_AGE_RATINGS.join(", ")} (got ${JSON.stringify(m.age_rating)})`);
+    if (m.kind !== void 0 && !MINIAPP_KINDS.includes(m.kind)) throw new Error(`${config.id}: miniapp.kind must be one of ${MINIAPP_KINDS.join(", ")} (got ${JSON.stringify(m.kind)})`);
+    if (m.support !== void 0 && !supportUrl(m.support)) throw new Error(`${config.id}: miniapp.support must be an email or an https URL (got ${JSON.stringify(m.support)})`);
+    if (m.tags !== void 0 && (!Array.isArray(m.tags) || m.tags.length > 5 || m.tags.some((t) => typeof t !== "string"))) throw new Error(`${config.id}: miniapp.tags must be up to 5 strings`);
   }
+  if (config.support !== void 0 && !supportUrl(config.support)) throw new Error(`${config.id}: support must be an email or an https URL (got ${JSON.stringify(config.support)})`);
   return config;
 }
 
@@ -808,7 +822,9 @@ export {
   DEFAULT_API_URL,
   ERROR_STATUS,
   JWKS_TTL_MS,
+  MINIAPP_AGE_RATINGS,
   MINIAPP_ENTRY,
+  MINIAPP_KINDS,
   SESSION_TTL_S,
   WebhookInvalidError,
   ambasada,
@@ -819,5 +835,6 @@ export {
   errorFromResponse,
   getHeader,
   isAmbasadaError,
-  signAppWebhook2 as signAppWebhook
+  signAppWebhook2 as signAppWebhook,
+  supportUrl
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ambasada/sdk",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "description": "The Ambasada platform SDK: Sign in with Ambasada, mini-app notifications, the project store, files.",
   "type": "module",
   "license": "MIT",
@@ -27,7 +27,7 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@ambasada/village": "^0.8.4"
+    "@ambasada/village": "^0.8.5"
   },
   "devDependencies": {
     "@types/node": "^22.20.5",