@wix/himalaya-cli 0.976.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:`
@@ -18715,6 +18714,7 @@ function shouldRevealError(args) {
 var EMAIL_RE, URL_HOST_RE, INTEGER_RE, NUMBER_RE;
 var init_validation = __esm({
   "../../core/ts/src/validation.ts"() {
+    "use strict";
     EMAIL_RE = /^[A-Za-z0-9._%+-]+@[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*\.[A-Za-z]{2,}$/;
     URL_HOST_RE = /^[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*(:[0-9]+)?$/;
     INTEGER_RE = /^[+-]?[0-9]+$/;
@@ -22139,6 +22139,7 @@ function validateWorkerSubtree(raw, slotId, policy, actionCatalog) {
 var WORKER_SUBTREE_CEILINGS, ID_PART, ACTION_ID;
 var init_worker_subtree = __esm({
   "../../core/ts/src/worker-subtree.ts"() {
+    "use strict";
     init_worker_subtree_safe_types_generated();
     WORKER_SUBTREE_CEILINGS = Object.freeze({
       maxEncodedBytes: 65536,
@@ -37479,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}).`);
@@ -37546,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"() {
@@ -43592,19 +43619,19 @@ var init_preview_assets_generated = __esm({
   "../../packages/serve/src/preview-assets.generated.ts"() {
     init_preview_assets_format();
     PREVIEW_ASSET_MANIFEST = [
-      { key: "assets/index-cNYP8bZY.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 986950, sha256: "590a8f1725d59e3d3c05d00508498e60b69174f474ba8ff1d3df4baea4c10e72" },
-      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 986958, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
-      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 1077882, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
-      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 1168866, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
-      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 1259846, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
-      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 1350718, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
-      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 1441698, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
-      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 1550334, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
-      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 1659418, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
-      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 1768466, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
-      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 1876166, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
-      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 1964274, length: 4448, sha256: "130ee208bf11075676b686b88ea3fa9e1eccff5d7047915d09594b8247f240eb" },
-      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 1968722, length: 13784, sha256: "cfb9465254fab84f0e084bb4542c282758ea29774b5f172840cc0b9e4194ef89" }
+      { key: "assets/index-QajXLF48.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 987074, sha256: "46a30017dbf3793f00e3ad24c865ca7708174a0c676a87257fb37f3f6a4179fa" },
+      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 987082, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
+      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 1078006, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
+      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 1168990, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
+      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 1259970, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
+      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 1350842, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
+      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 1441822, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
+      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 1550458, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
+      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 1659542, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
+      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 1768590, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
+      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 1876290, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
+      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 1964398, length: 4448, sha256: "e2f66c98bc1767a88a1d28cf5af1078a100e4505d14370f06066534651ea5912" },
+      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 1968846, length: 13784, sha256: "cfb9465254fab84f0e084bb4542c282758ea29774b5f172840cc0b9e4194ef89" }
     ];
   }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.976.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": "97cd179b2e2933b970764b974d240af745f9cd70a3feaa016e12fadf"
+  "falconPackageHash": "88b2cfb0f2d75cce7fa6a3681bfbfd1b227e95d24d266ba8ca8e722a"
 }