@wix/himalaya-cli 0.1232.0 → 0.1234.0

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

@@ -189,8 +189,8 @@ export interface DevGatewayConfig {
      *  `passthrough` (default) forwards it to the real host; `fail` answers a deterministic
      *  `404 HIMI_HERMETIC_NO_FIXTURE` and sends nothing upstream (#3019). Honoured by the
      *  dev-server's `/v1/__webwix/call` bridge (web host) and `/__dev/{wix,net}/proxy`
-     *  (native redirect). On-device `NetFake` does not read it yet — an unmatched call there
-     *  still falls through to the real capability. */
+     *  (native redirect). On-device `NetFake` (iOS/Android, DEBUG) reads it too: a sealed scenario
+     *  answers a miss with the same 404 and never calls the real capability. */
     unmatched?: "passthrough" | "fail";
 }
 /** Derive the OTA authConfig block from a defineApp auth block

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

@@ -1038,8 +1038,8 @@ export interface DevGatewayConfig {
      *  `passthrough` (default) forwards it to the real host; `fail` answers a deterministic
      *  `404 HIMI_HERMETIC_NO_FIXTURE` and sends nothing upstream (#3019). Honoured by the
      *  dev-server's `/v1/__webwix/call` bridge (web host) and `/__dev/{wix,net}/proxy`
-     *  (native redirect). On-device `NetFake` does not read it yet — an unmatched call there
-     *  still falls through to the real capability. */
+     *  (native redirect). On-device `NetFake` (iOS/Android, DEBUG) reads it too: a sealed scenario
+     *  answers a miss with the same 404 and never calls the real capability. */
     unmatched?: "passthrough" | "fail";
 }
 export declare function defineApp(config: AppConfig): AppConfig;

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

@@ -1,10 +1,15 @@
 import type { PushRoute } from "./push-routes.js";
 /**
- * The Ping app family a customer app's members register under. Ping treats it exactly as
- * `WixBrandedLite`: member recipients, the site's own credentials by `filterForMetaSite`,
- * the BRANDED link format. One constant, so a revert is a one-line change.
+ * The Ping app family a customer app's members register under: member recipients, the site's own
+ * credentials by `filterForMetaSite`, the BRANDED link format. Not `WixWebShell`, the family Ping
+ * renamed `WixBrandedWebApp` to: a send with `isForBrandedApp` (Ping automations addressed to a
+ * contact, and the hosted test send) targets `Branded` and keeps only registrations whose family
+ * starts with `WixBranded` (`RegistrationsFetcher.getMobileRegistrationsForTarget`). One constant,
+ * so a change of family is a one-line change.
  */
-export declare const DEFAULT_PING_APP_NAME = "WixBrandedWebApp";
+export declare const DEFAULT_PING_APP_NAME = "WixBrandedLite";
+/** The family to register under instead of `name`, or undefined when `name` is not retired. */
+export declare function replacementPingFamily(name: string): string | undefined;
 /** One place a member notification can open, and every Wix link shape that names it. */
 export interface WixPushDestination {
     /** `<vertical>.<thing>`, the key an author uses in `push.screens`. */

package/dist/cli.mjs

@@ -6827,7 +6827,6 @@ function walk(node, registry, path2, out2) {
 var SYSTEM_FONT_FAMILY, TONAL_ELEVATION_ALPHA, COLOR_TOKEN_PROPS, TYPOGRAPHY_TOKEN_PROPS;
 var init_tokens = __esm({
   "../../core/ts/src/tokens.ts"() {
-    "use strict";
     SYSTEM_FONT_FAMILY = "$system";
     TONAL_ELEVATION_ALPHA = [0, 0.05, 0.08, 0.11, 0.12, 0.14];
     COLOR_TOKEN_PROPS = {
@@ -6878,7 +6877,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((s2) => s2 !== "t").join("|")})\\b|^\\$t:`
@@ -24173,6 +24171,9 @@ var init_l10n = __esm({
 });
 
 // ../../core/ts/src/wix-push-links.ts
+function replacementPingFamily(name) {
+  return RETIRED_PING_FAMILIES.has(name) ? DEFAULT_PING_APP_NAME : void 0;
+}
 function derivesWixPushRoutes(push, installedVerticals) {
   return push?.payloadAdapter === "wix-ping" && push.routes === void 0 && installedVerticals !== void 0;
 }
@@ -24216,10 +24217,14 @@ function itemParamKey(paramKeys) {
   if (paramKeys.includes("id")) return "id";
   return paramKeys.length === 1 ? paramKeys[0] : void 0;
 }
-var DEFAULT_PING_APP_NAME, EVENTS_APP_ID, WIX_MEMBER_PUSH_DESTINATIONS;
+var DEFAULT_PING_APP_NAME, RETIRED_PING_FAMILIES, EVENTS_APP_ID, WIX_MEMBER_PUSH_DESTINATIONS;
 var init_wix_push_links = __esm({
   "../../core/ts/src/wix-push-links.ts"() {
-    DEFAULT_PING_APP_NAME = "WixBrandedWebApp";
+    DEFAULT_PING_APP_NAME = "WixBrandedLite";
+    RETIRED_PING_FAMILIES = /* @__PURE__ */ new Set([
+      // Renamed to WixWebShell by wix-private/wixos #22625, 2026-10-04.
+      "WixBrandedWebApp"
+    ]);
     EVENTS_APP_ID = "140603ad-af8d-84a5-2c80-a0f60cb47351";
     WIX_MEMBER_PUSH_DESTINATIONS = [
       {
@@ -28946,7 +28951,10 @@ function applyNetMocks(gw, mocks) {
 function resolveNetMocks(fileMocks, appDeclared) {
   if (fileMocks) return { mocks: fileMocks, source: "file" };
   const declared = Array.isArray(appDeclared?.rules) ? appDeclared.rules : [];
-  if (declared.length > 0) return { mocks: { mode: appDeclared?.mode, rules: declared, unmatched: appDeclared?.unmatched }, source: "app" };
+  if (declared.length > 0 || appDeclared?.mode !== void 0 || appDeclared?.unmatched !== void 0) {
+    const mode = appDeclared?.mode ?? (appDeclared?.unmatched === "fail" ? "mock" : void 0);
+    return { mocks: { mode, rules: declared, unmatched: appDeclared?.unmatched }, source: "app" };
+  }
   return null;
 }
 function readNetMocksFile(path2) {
@@ -126506,13 +126514,6 @@ function createDevServer(opts = {}) {
     const from = resolved2.source === "file" ? netMocksPath : `${state.appName} devGateway.rules`;
     console.error(`[himalaya-dev] net-mocks: seeded ${seeded.rules} rule(s), mode=${seeded.mode} from ${from}`);
   }
-  const appScenario = state.app?.meta.devGateway;
-  if (!netMocksDisabled && appScenario?.rules?.length && state.wix.rules.length === 0) {
-    const seeded = applyNetMocks(state.wix, { mode: appScenario.mode, rules: appScenario.rules, unmatched: appScenario.unmatched });
-    state.wixSeededOn = todayYmd();
-    state.wixSeededFromApp = true;
-    console.error(`[himalaya-dev] net-mocks: seeded ${seeded.rules} rule(s), mode=${seeded.mode} from the app's devGateway scenario`);
-  }
   if (state.hotReloadEnabled) {
     state.bundleWatcher = startBundleArtifactWatcher(state);
     state.bundleSourceWatcher = startBundleSourceWatcher(state);
@@ -133565,7 +133566,7 @@ import { lstatSync as lstatSync11, readFileSync as readFileSync53 } from "node:f
 import { basename as basename13, join as join46 } from "node:path";
 import ts2 from "typescript";
 function enablePushInConfig(source, options) {
-  const pingAppName = options.pingAppName ?? DEFAULT_PING_APP_NAME;
+  const pingAppName = DEFAULT_PING_APP_NAME;
   const fileName = options.fileName ?? "config.ts";
   const kind = fileName.endsWith(".ts") ? ts2.ScriptKind.TS : ts2.ScriptKind.JS;
   const file = ts2.createSourceFile(fileName, source, ts2.ScriptTarget.Latest, true, kind);
@@ -133606,6 +133607,7 @@ function planPush(app, pingAppName, plan) {
   }
   const block = push.kind === "written" ? push.node.initializer : void 0;
   plan.pushOn = !!block && stringValue(block, "registrar") === "wix-ping" && stringValue(block, "payloadAdapter") === "wix-ping";
+  if (block && stringValue(block, "registrar") === "wix-ping") planRetiredFamily(block, plan);
   const lacking = [
     ...block && stringValue(block, "registrar") === "wix-ping" ? [] : ['registrar: "wix-ping"'],
     ...block && stringValue(block, "pingAppName") ? [] : [`pingAppName: ${JSON.stringify(pingAppName)}`],
@@ -133617,6 +133619,15 @@ function planPush(app, pingAppName, plan) {
     );
   }
 }
+function planRetiredFamily(block, plan) {
+  const literal = unwrap(block);
+  const found = ts2.isObjectLiteralExpression(literal) ? lookup2(literal, "pingAppName") : void 0;
+  const value = found?.kind === "written" ? unwrap(found.node.initializer) : void 0;
+  const replacement = value && ts2.isStringLiteralLike(value) ? replacementPingFamily(value.text) : void 0;
+  if (!value || !replacement) return;
+  plan.splices.push({ at: value.getStart(), end: value.end, text: JSON.stringify(replacement) });
+  plan.applied.push(`pingAppName ${JSON.stringify(replacement)} in place of ${value.getText()}`);
+}
 function planCapability(app, plan) {
   const capabilities = lookup2(app, "capabilities");
   if (capabilities.kind === "absent") {
@@ -136675,6 +136686,7 @@ async function navIssues(dir, strict) {
   pushRouteIssues(cfg.push, nav, provisioning, warn3);
   pushScreenMapIssues(cfg.push, provisioning, warn3);
   pushAuthIssues(cfg.push, cfg.auth, provisioning, warn3);
+  pushFamilyIssues(cfg.push, warn3);
   if (nav === void 0 || nav === null) return issues;
   if (!isPlainObject2(nav)) {
     error("nav-not-an-object", `navigation must be an object (got ${Array.isArray(nav) ? "array" : typeof nav}).`);
@@ -136795,6 +136807,15 @@ function pushAuthIssues(push, auth, provisioning, warn3) {
     `push.registrar is "wix-ping", which registers a signed-in member's device with Wix Ping, but ${problem}. Use auth: WixConsumerAuthProvider({ siteId: "${provisioning.siteId ?? "<metaSiteId>"}", \u2026 }).`
   );
 }
+function pushFamilyIssues(push, warn3) {
+  if (!isPlainObject2(push) || push.registrar !== "wix-ping" || typeof push.pingAppName !== "string") return;
+  const replacement = replacementPingFamily(push.pingAppName);
+  if (!replacement) return;
+  warn3(
+    "push-ping-family-retired",
+    `push.pingAppName "${push.pingAppName}" is a family Ping no longer has, and it kept no alias: a device registering under it gets no notifications. Use pingAppName: "${replacement}".`
+  );
+}
 function pushRouteAdvisories(pushRoutes) {
   if (!pushRoutes) return [];
   const linked = new Set(WIX_MEMBER_PUSH_DESTINATIONS.map((d2) => d2.vertical));

package/guides/push-cli-onboarding.md

@@ -116,16 +116,18 @@ capabilities: ["push" /* , … */],
 // Routes are derived at build time from provisioning.json and your screens; see himi validate.
 push: {
   registrar: "wix-ping",
-  pingAppName: "WixBrandedWebApp",
+  pingAppName: "WixBrandedLite",
   requestPermissionOnLaunch: true,
   payloadAdapter: "wix-ping",
 },
 ```
 
-- `pingAppName` is the Ping app family the device registers under. Use `WixBrandedWebApp`:
-  Ping allows it for site members and uses the credentials `himi notify setup` stored for
-  the site. A build signed for the APNs development environment appends `.sandbox` itself;
-  do not add it.
+- `pingAppName` is the Ping app family the device registers under. Use `WixBrandedLite`:
+  Ping allows it for site members, uses the credentials `himi notify setup` stored for the
+  site, and delivers the site's member notifications to it. A build signed for the APNs
+  development environment appends `.sandbox` itself; do not add it. `WixBrandedWebApp` no
+  longer exists in Ping: `himi validate` reports it as `push-ping-family-retired`, and
+  re-running `himi notify setup` replaces it.
 - The device registers only after a member signs in; a visitor's device receives nothing.
   Keep `siteId` in `auth` on the site `himi notify setup` configured. A changed `siteId` or
   `clientId` ships with `himi push` like the rest of the config, and the app picks it up on

package/guides/testing-himi-apps.md

@@ -379,6 +379,13 @@ snapshot tests. `FakeServiceProvider` answers `value(at: "counter.value")` from
 -himalaya.fake.services '{"ownerInbox":{"count":3,"items":[{"title":"New order"}]}}'
 ```
 
+**From an XCUITest, write every `'` in the blob as `\u0027`.** `XCUIApplication.launchArguments`
+are re-quoted shell-style on the way to the app: an apostrophe opens a quoted run whose spaces and
+`"` arrive backslash-escaped, so `"today's"` turns a valid fixture into invalid JSON. The launch
+manifest then keeps the value as a plain string, `fake.services` is silently off, and the screen
+renders its live worker. `xcrun simctl launch` passes argv untouched, so the same blob works by
+hand. `BrandedLiteUITestCase.launchSafeJSON` does the escaping for the branded-lite target.
+
 The **web/headless** tier has the same seam: `POST /__dev/render { descriptor, services: {…} }`
 builds a `FakeServiceProvider` (core/web-renderer/src/FakeServiceProvider.ts) so the browser-free
 render resolves the same `$service:`/`$item.` bindings — text filled and repeaters expanded — with

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1232.0",
+  "version": "0.1234.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": [
@@ -67,5 +67,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "19c1239851ec3856adb71952d1e9dcb18ea9cdd23456e90bb311a12d"
+  "falconPackageHash": "eeef93bad6f73772bf97da835fa24f3c52b393873be055a3ae232dfe"
 }