@wix/himalaya-cli 0.977.0 → 0.978.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/define-app.d.ts

@@ -1,4 +1,5 @@
 import type { DesignTokens } from "./tokens.js";
+import type { PushRoute, PushPayloadAdapter } from "./push-routes.js";
 import type { NavigationConfig, SplashConfig } from "./schema.js";
 import { type LocaleConfig } from "./locale.js";
 import { type DistributionConfig } from "./distribution.js";
@@ -6,6 +7,7 @@ import type { CmsConfig } from "./cms.js";
 import { type DataResourcesConfig } from "@wix/himalaya/data-resources";
 import type { FunctionDefinition, FunctionScheduleRecord } from "@himalaya/functions";
 export type { CmsConfig, CmsCollectionSpec, CmsFieldSpec, WixFieldType } from "./cms.js";
+export type { PushRoute, PushPayloadAdapter };
 export type { DataResourcesConfig, KvSpec, ResourceEnvironment, ResourceScope } from "@wix/himalaya/data-resources";
 export { WIX_FIELD_TYPES } from "./cms.js";
 /** Wix site/environment binding used by the server-function surface. */
@@ -445,6 +447,16 @@ export interface PushConfig {
     richTemplates?: RichTemplate[];
     /** Prompt for the OS notification permission on first launch. */
     requestPermissionOnLaunch?: boolean;
+    /** Notification route table. Derive these from the app's own contract rather than
+     *  hand-listing them, so a route can never target a screen the provisioned app
+     *  does not have. Honoured by iOS + Android; the web host has no push transport. */
+    routes?: PushRoute[];
+    payloadAdapter?: PushPayloadAdapter;
+    /** A `tier5.<service>.<action>` dispatched on EVERY notification — receipt or tap
+     *  — so a worker can keep a badge count or refresh a feed without navigating. It
+     *  receives `templateId`, `topic`, `metaSiteId`, `notificationId`, `link`,
+     *  `resolvedLink` and `tapped` (all as strings, the dispatch bridge's contract). */
+    observerAction?: string;
 }
 export type IapProductType = "subscription" | "nonConsumable" | "consumable";
 export interface IapProduct {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/push-routes.d.ts

@@ -0,0 +1,74 @@
+/**
+ * How a payload link is stripped down to the residual path+query `routes` match
+ * against. An UNKNOWN value passes the link through unchanged rather than failing, so
+ * an older binary served a newer adapter degrades instead of dropping every
+ * notification (invariants 6/8).
+ */
+export type PushPayloadAdapter = "" | "wix-ping";
+/**
+ * One notification-routing rule. Mirrors `PushRoute` in core.proto / Schema.swift /
+ * Schema.kt, and is re-exported from `define-app` as part of the authoring surface —
+ * defined HERE, once, next to the matcher that consumes it.
+ *
+ * Routes translate a FOREIGN link space (the Wix mobile links Ping delivers) into this
+ * app's own, in front of the existing resolver — never beside it. No match leaves the
+ * link untouched, which is why an app declaring no routes behaves exactly as it did
+ * before they existed.
+ */
+export interface PushRoute {
+    /** WIX-link-space pattern over the residual path+query, in the same grammar as
+     *  `deepLinkPatterns`: `"orders/?orderId=:orderId"`. */
+    match: string;
+    /** The himi link to resolve instead, with `{name}` placeholders filled from the
+     *  captured params: `"<scheme>://screen/himi_order?id={orderId}"`. May instead name
+     *  a `tier5.*` action, which dispatches to a worker rather than navigating. */
+    link: string;
+    /** Optional EXTRA conditions on the Ping payload. Omitted ⇒ unconstrained, so one
+     *  link space can fan out by template or topic. */
+    templateId?: string;
+    topic?: string;
+}
+/** The payload facts a route may additionally condition on. */
+export interface PushPayloadContext {
+    templateId?: string;
+    topic?: string;
+}
+/** What an adapter made of a payload link. */
+export interface AdaptedLink {
+    /** Residual path+query the routes match against, with no leading slash. */
+    residual: string;
+    /** The site the payload named, when it named one. */
+    metaSiteId?: string;
+    /** False when the adapter did not recognize the link and passed it through. */
+    adapted: boolean;
+}
+/**
+ * Strip a payload link down to the residual path+query a route matches against.
+ *
+ * `adapter` is `""` (pass through) or `"wix-ping"`. An UNKNOWN adapter passes the
+ * link through unchanged rather than failing, so an older binary served a config
+ * naming an adapter it has never heard of degrades to today's behavior instead of
+ * dropping every notification (invariants 6/8).
+ */
+export declare function adaptPayloadLink(link: string, adapter?: string): AdaptedLink;
+/**
+ * The himi link the first matching route produces, or null when nothing matches.
+ *
+ * Null means "resolve the input unchanged" to the caller — never "give up" — which
+ * is what keeps an app that declares no routes behaving exactly as it did before.
+ * Rules are tried in declaration order, so a more specific rule goes first.
+ */
+export declare function matchPushRoute(residual: string, routes: readonly PushRoute[] | undefined, payload?: PushPayloadContext): string | null;
+/**
+ * Adapt + match in one step: the himi link to resolve instead of `link`, the params
+ * the route captured, and the site the payload named. `link` is null when no route
+ * matched.
+ */
+export declare function resolvePushRoute(link: string, config: {
+    routes?: readonly PushRoute[];
+    payloadAdapter?: string;
+} | undefined, payload?: PushPayloadContext): {
+    link: string | null;
+    params: Record<string, string>;
+    metaSiteId?: string;
+};

package/dist/cli.mjs

@@ -5290,7 +5290,6 @@ function resolveTranslation(value, catalog, sourceCatalog) {
 var BINDING_SIGILS, BINDING_SIGIL_RE, TRANSLATION_PREFIX, TRANSLATION_KEY_RE;
 var init_bindings = __esm({
   "../../core/ts/src/bindings.ts"() {
-    "use strict";
     BINDING_SIGILS = ["service", "flag", "item", "t"];
     BINDING_SIGIL_RE = new RegExp(
       `^\\$(?:${BINDING_SIGILS.filter((s) => s !== "t").join("|")})\\b|^\\$t:`
@@ -37481,6 +37480,7 @@ async function navIssues(dir, strict) {
     }
   }
   const nav = cfg.navigation;
+  pushRouteIssues(cfg.push, nav, warn);
   if (nav === void 0 || nav === null) return issues;
   if (!isPlainObject(nav)) {
     error("nav-not-an-object", `navigation must be an object (got ${Array.isArray(nav) ? "array" : typeof nav}).`);
@@ -37548,6 +37548,31 @@ async function navIssues(dir, strict) {
   }
   return issues;
 }
+function pushRouteIssues(push, nav, warn) {
+  if (!isPlainObject(push) || push.payloadAdapter !== "wix-ping") return;
+  const routes = Array.isArray(push.routes) ? push.routes.filter(isPlainObject) : [];
+  if (routes.length === 0) {
+    warn(
+      "push-routes-missing",
+      `push.payloadAdapter is "wix-ping" but push.routes is empty \u2014 Wix business-event links cannot map to app screens. Direct Himi screen links still work. Declare a route per business-event link the site sends, e.g. { match: "my-account/:site/stores/orders/:orderId", link: "<scheme>://screen/<order screen>?id={orderId}" }.`
+    );
+    return;
+  }
+  const linkables = isPlainObject(nav) ? nav.linkableScreens : void 0;
+  if (!Array.isArray(linkables)) return;
+  const declared = new Set(
+    linkables.filter(isPlainObject).map((s) => String(s.screenId ?? ""))
+  );
+  for (const route of routes) {
+    const screenId = /:\/\/screen\/([^?]+)/.exec(String(route.link ?? ""))?.[1];
+    if (screenId && !declared.has(screenId)) {
+      warn(
+        "push-route-unknown-screen",
+        `push.routes: "${String(route.match)}" opens "${screenId}", which navigation.linkableScreens does not declare \u2014 the device cannot resolve it, so the notification opens nothing.`
+      );
+    }
+  }
+}
 var NAVIGATION_KEYS, NAV_KINDS, ITEMS_BLOCKS, SERVED_ONLY_NAV_KEYS, MISPLACED_TOP_LEVEL_KEYS, isPlainObject, itemCount;
 var init_nav_lint = __esm({
   "src/nav-lint.ts"() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.977.0",
+  "version": "0.978.0",
   "type": "module",
   "description": "himi — the Himalaya authoring CLI. Build a Tier-5 content package on your own machine, push it to the production serve as a draft, preview it on web + Himi Player, and read worker logs back — the remote dev loop. Wraps @himalaya/serve-cli for transport.",
   "keywords": [
@@ -64,5 +64,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "ff53cabc3043d8cb9aecd23811c5b17520f9b183d514b1000a73b61c"
+  "falconPackageHash": "88b2cfb0f2d75cce7fa6a3681bfbfd1b227e95d24d266ba8ca8e722a"
 }