@wix/himalaya-cli 0.1440.0 → 0.1442.0

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

@@ -1,7 +1,7 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { DerivedAppMeta } from "./app-module.js";
 import { type WixCachePolicy } from "./wix-cache-policy.js";
-import type { WixMockRule } from "./wix-gateway.js";
+import type { NetMocksFile, WixMockRule } from "./wix-gateway.js";
 import { type UnmappedPushDestination } from "../../ts/src/wix-push-links.js";
 import type { PushConfig, FlagConfig, AppControl, TabBarConfig, DrawerConfig, SidebarConfig, SplashConfig, LocaleConfig, NavKind, OrientationConfig, StreamPolicy } from "@wix/himalaya/core";
 export type { PushConfig, FlagConfig, AppControl, TabBarConfig, DrawerConfig, SidebarConfig, SplashConfig, LocaleConfig, NavKind, OrientationConfig, StreamPolicy };
@@ -234,6 +234,31 @@ export interface ServedPush {
  */
 export declare function derivePushForApp(app: DerivedAppMeta, linkableScreens?: readonly LinkableScreen[]): ServedPush;
 export declare function deriveNavigationConfig(app: DerivedAppMeta, bundleCtx?: NavBundleContext): NavigationConfig;
+/**
+ * Ship a package's checked-in net-mocks fixture to DEVICES (#4607).
+ *
+ * `dev/net-mocks.json` used to seed only the dev-server's in-process gateway, which answers
+ * the web bridge (web preview, `himi render`, `himi test`). A native DEBUG build never asks
+ * that gateway: it arms its scenario from the served `devGatewayConfig.rules`
+ * (`NetFake` / `NavigationConfigStore`), which came from config.ts alone. So one worker call
+ * was mocked on web and went to live Wix on iOS/Android Player.
+ *
+ * The file fills the device scenario only when the app declares none of its own: declared
+ * `rules` (or a `scenarioRef`) are the app's scenario and are served untouched, and
+ * `devGateway: { enabled: false }` — the real-site opt-out — stays out. The app's own keys
+ * (scope, redirect, mode, unmatched) win over the file's policy. An absent mode becomes
+ * `mock`, the default `applyNetMocks` gives the same fixture on the gateway.
+ *
+ * The dev-server passes a fixture only for a CONTENT PACKAGE, and only the one its gateway was
+ * seeded from at boot (index.ts `deviceNetMocks`), so web and device share one scenario. An in-repo
+ * shell wires its device scenario through `devGateway` itself.
+ *
+ * DEV-ONLY by construction: only the dev-server passes a fixture here, and a release strips
+ * the whole block (`withoutDevOnlyAppConfig`, tools/release-build/build.ts) unless the build
+ * is a local dev preview (`himi run --content`) or a DEBUG seed. Returns `config` unchanged
+ * when there is nothing to add; never mutates it.
+ */
+export declare function withDevNetMocks(config: NavigationConfig, declared: DevGatewayConfig | undefined, fileMocks: NetMocksFile | null | undefined): NavigationConfig;
 export interface AppConfigDocument {
     config: NavigationConfig;
     body: string;
@@ -263,5 +288,7 @@ export declare function completeLinkableScreens<T extends {
 /** A merged (overridden) config with its linkable screens completed — ONE rule for every place that
  *  shows or serves the effective config, so the admin view and the device payload cannot diverge. */
 export declare function withCompleteLinkables<T extends object>(cfg: T): T;
-export declare function buildAppConfigDocument(req: IncomingMessage, meta: DerivedAppMeta, override?: Record<string, unknown>, bundleCtx?: NavBundleContext): AppConfigDocument;
-export declare function handleAppConfigRequest(req: IncomingMessage, res: ServerResponse, meta: DerivedAppMeta, override?: Record<string, unknown>, bundleCtx?: NavBundleContext): void;
+export declare function buildAppConfigDocument(req: IncomingMessage, meta: DerivedAppMeta, override?: Record<string, unknown>, bundleCtx?: NavBundleContext, 
+/** The package's checked-in net-mocks fixture, for a DEBUG device (#4607). Dev-server only. */
+devNetMocks?: NetMocksFile | null): AppConfigDocument;
+export declare function handleAppConfigRequest(req: IncomingMessage, res: ServerResponse, meta: DerivedAppMeta, override?: Record<string, unknown>, bundleCtx?: NavBundleContext, devNetMocks?: NetMocksFile | null): void;