@wix/himalaya-cli 0.1060.0 → 0.1061.0

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

@@ -90,18 +90,25 @@ export interface NavigationConfig {
  *  offline dev seam to a REAL Wix backend call — routed through `wixApi`
  *  (WixApiCapability), so it is auto-covered by the dev-mode Wix gateway /
  *  admin inspector. Members absent / false keep the seam, so unregistered members
- *  and non-Wix apps are unaffected. `bi`/`experiments` carry the
- *  registration-specific params (Frog src/endpoint+variant, Petri scope).
- *  Best-effort: Frog/Petri/Ping/Jot may 4xx until a Wix App is registered — the
- *  gateway records those real errors, which is itself useful production data. */
+ *  and non-Wix apps are unaffected. `bi` carries the registration-specific
+ *  params (Frog src/endpoint+variant).
+ *  Best-effort: Frog may 4xx until a Wix App is registered — the gateway records
+ *  those real errors, which is itself useful production data. */
 export interface WixPlatformConfig {
     /** Which cross-cutting members make REAL Wix calls (vs the offline seam). */
     real?: {
         bi?: boolean;
+        /** No effect: experiments and flags come from the app's served flags
+         *  (`/v1/flags/<app>/assignments`), never Wix Petri. Kept so existing configs type-check. */
         experiments?: boolean;
+        /** No effect — see `experiments`. */
         flags?: boolean;
+        /** No effect: the translations-server lookup, Ping registration and the Jot deferred link
+         *  have no route on any Wix host a himi app reaches, so they always use the seam. */
         i18n?: boolean;
+        /** No effect — see `i18n`. */
         ping?: boolean;
+        /** No effect — see `i18n`. */
         deeplink?: boolean;
         session?: boolean;
         auth?: boolean;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/wix-platform/src/index.d.ts

@@ -41,7 +41,9 @@ export declare const flags: {
 };
 export declare const i18n: {
     /** Resolve a translation key for the current locale; `fallback` (or the key)
-     *  when unknown. */
+     *  when unknown. Always the native seam: `/_api/translations-server/v1/translation/<key>`
+     *  has no route on any Wix host a himi app reaches (the same 404 as a made-up path, with or
+     *  without a token), so `real.i18n` no longer sends it anywhere — it only ever 404ed. */
     t(key: string, fallback?: string): Promise<string>;
     /** Current resolved UI locale (2-letter). */
     locale(): Promise<string>;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-platform.mjs

@@ -125,15 +125,10 @@ var flags = {
 };
 var i18n = {
   /** Resolve a translation key for the current locale; `fallback` (or the key)
-   *  when unknown. */
+   *  when unknown. Always the native seam: `/_api/translations-server/v1/translation/<key>`
+   *  has no route on any Wix host a himi app reaches (the same 404 as a made-up path, with or
+   *  without a token), so `real.i18n` no longer sends it anywhere — it only ever 404ed. */
   async t(key, fallback) {
-    if (isMemberReal("i18n")) {
-      try {
-        const r2 = await realWix("GET", `/_api/translations-server/v1/translation/${encodeURIComponent(key)}`);
-        if (typeof r2?.translation === "string") return r2.translation;
-      } catch {
-      }
-    }
     const r = await call("i18nTranslate", { key, fallback: fallback ?? key });
     return r?.value ?? fallback ?? key;
   },

package/dist/cli.mjs

@@ -6684,6 +6684,7 @@ 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:`

package/guides/sdk-reference.json

@@ -3475,7 +3475,7 @@
         "name": "i18n",
         "kind": "const",
         "jsdoc": "",
-        "decl": "export const i18n = {\n  /** Resolve a translation key for the current locale; `fallback` (or the key)\n   *  when unknown. */\n  async t(key: string, fallback?: string): Promise<string> {\n    if (isMemberReal(\"i18n\")) {\n      try {\n        const r = await realWix<{ translation?: string }>(\"GET\", `/_api/translations-server/v1/translation/${encodeURIComponent(key)}`);\n        if (typeof r?.translation === \"string\") return r.translation;\n      } catch { /* fall through to the dev seam */ }\n    }\n    const r = await call<{ value?: string }>(\"i18nTranslate\", { key, fallback: fallback ?? key });\n    return r?.value ?? fallback ?? key;\n  },\n  /** Current resolved UI locale (2-letter). */\n  async locale(): Promise<string> {\n    const r = await call<{ locale?: string }>(\"i18nLocale\");\n    return r?.locale ?? \"en\";\n  },\n};"
+        "decl": "export const i18n = {\n  /** Resolve a translation key for the current locale; `fallback` (or the key)\n   *  when unknown. Always the native seam: `/_api/translations-server/v1/translation/<key>`\n   *  has no route on any Wix host a himi app reaches (the same 404 as a made-up path, with or\n   *  without a token), so `real.i18n` no longer sends it anywhere — it only ever 404ed. */\n  async t(key: string, fallback?: string): Promise<string> {\n    const r = await call<{ value?: string }>(\"i18nTranslate\", { key, fallback: fallback ?? key });\n    return r?.value ?? fallback ?? key;\n  },\n  /** Current resolved UI locale (2-letter). */\n  async locale(): Promise<string> {\n    const r = await call<{ locale?: string }>(\"i18nLocale\");\n    return r?.locale ?? \"en\";\n  },\n};"
       },
       {
         "name": "PingRegistration",

package/guides/wix-platform-usage.md

@@ -4,9 +4,10 @@
 **platform-agnostic** — the same JS runs on iOS, Android, macOS and web, with **one documented
 exception**: on web, `auth.signIn()` rejects rather than resolving (see
 [Real vs dev seam](#real-vs-dev-seam-and-best-effort) below). Each
-member dispatches to the native `wix_platform` capability (with an on-device dev seam),
-and REST-shaped members go to real Wix when the app enables them
-([opt-in guide](wix-platform-opt-in.md)). This is the authoritative reference for
+member dispatches to the native `wix_platform` capability (with an on-device dev seam);
+`bi`, `monitoring`, `session` and `auth` take their real backend when the app enables them
+([opt-in guide](wix-platform-opt-in.md)), while `experiments` / `flags` always read the app's
+served flags and `i18n`, `ping` and `deeplink` always answer from the seam. This is the authoritative reference for
 *calling* the members; source of truth is `core/sdk/wix-platform/src/index.ts` +
 [RFC 0042](../core/schema/RFC/0042-wix-platform-sdk.md).
 
@@ -63,12 +64,16 @@ await monitoring.captureError("thing failed", { code: "E1" });
 
 - With no `wixPlatform.real.<member>`, a member returns the **dev seam** (deterministic
   on-device value; no network). `isMemberReal(member)` reflects the flag.
-- With `real.<member> = true`, REST-shaped members route through the real `wixApi`
-  chokepoint. These are **best-effort**: a 4xx (expected until a Wix App is registered)
-  falls back to the seam value AND still emits the member's telemetry
-  (`experiment_exposed` / `ping_registered` / `deferred_deeplink_resolved` / …), so
-  feature-gating + attribution stay correct either way. Every method returns a resolved
-  value (or `null`) — never throws on a Wix error — so a worker never crashes on the SDK.
+- With `real.<member> = true`, the one REST-shaped member that still has a reachable Wix
+  route takes it: `auth.signedInstance` mints through the real `wixApi` chokepoint. That is
+  **best-effort**: a failure falls back to the seam value, so feature-gating stays correct
+  either way. Every method returns a resolved value (or `null`) — never throws on a Wix
+  error — so a worker never crashes on the SDK.
+- `real` does nothing for the rest. `experiments` / `flags` always answer from the app's
+  served flags (`GET /v1/flags/<app>/assignments`, set with `himi flags`), never Wix Petri;
+  `i18n`, `ping` and `deeplink` have no Wix route a himi app can reach (a 404 with or without
+  a token), so they always answer from the seam and `real.i18n` / `real.ping` /
+  `real.deeplink` are ignored.
 - `bi`, `monitoring`, and `auth` route through their native backends (Frog sink, Sentry
   sink, `WixNativeAuthProvider`) rather than raw `wixApi`, but the calling contract is
   identical — **except `auth.signIn()` on web**, below.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1060.0",
+  "version": "0.1061.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": [
@@ -65,5 +65,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "f9ba6be1e80fee7d23674790f7aef4a825cdf2e6dae560ef48f1c744"
+  "falconPackageHash": "b243ee9fc8a6a890b9210aa28588552b0722079d8481a0e61fb76869"
 }