@wix/himalaya-cli 0.1117.0 → 0.1118.0

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

@@ -173,6 +173,8 @@ export interface DerivedAppMeta {
     screenIds: string[];
     templatedPatterns: string[];
     urlScheme: string;
+    /** Forwarded from AppConfig.cache: the app's declared Wix read cache rules (#3450 follow-up). */
+    cache?: import("@wix/himalaya/core").AppCacheConfig;
     /** Forwarded from AppConfig.push for the OTA app-config channel. */
     push?: import("@wix/himalaya/core").PushConfig;
     /** Forwarded from AppConfig.control for the OTA app-config channel. */

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/dev-server/src/wix-cache-defaults.generated.d.ts

@@ -0,0 +1,2 @@
+import type { WixCacheRule } from "./wix-cache-policy.js";
+export declare const PLATFORM_DEFAULT_WIX_CACHE_RULES: readonly WixCacheRule[];

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

@@ -1,3 +1,4 @@
+import type { AppCacheConfig } from "@wix/himalaya/core";
 export interface WixCacheRule {
     method: string | null;
     pathPrefix: string;
@@ -11,4 +12,23 @@ export interface WixCachePolicy {
     defaultCacheable: boolean;
 }
 export declare function clampRule(rule: WixCacheRule, denyPrefixes: string[], maxTTL: number): WixCacheRule;
-export declare function resolveWixCachePolicy(appName: string): WixCachePolicy;
+/** What an app declares in `defineApp({ cache })`. */
+export type DeclaredWixCache = AppCacheConfig;
+/**
+ * The EFFECTIVE Wix read cache policy an app is served (web, iOS and Android all read it).
+ *
+ * Rules, in precedence order — every client keeps the FIRST longest-prefix match:
+ *   1. the app's own `defineApp({ cache })` rules (from its config.ts);
+ *   2. the legacy per-app table above (apps not yet moved to config.ts);
+ *   3. the platform defaults (#3450 follow-up), generated from the Wix SDK catalog: public
+ *      catalog/content reads, stale-while-revalidate, plus write families that purge them.
+ *      Before them every app without a table entry was served `{ rules: [] }` and so cached
+ *      NO Wix read on any platform. An app opts out with `cache: { platformDefaults: false }`.
+ *      An app (or legacy) rule SHADOWS every default underneath its prefix — clients pick the
+ *      longest prefix first, so an app's broad `/stores/` opt-out would otherwise lose to a longer
+ *      default like `/stores/v3/products/query`.
+ *   4. the platform deny + personal-data prefixes as explicit non-cacheable rules — so an app's
+ *      `defaultCacheable: true` can never make a PII path cacheable by matching nothing.
+ * Everything is clamped under the platform envelope (PII denies, TTL ceiling).
+ */
+export declare function resolveWixCachePolicy(appName: string, declared?: DeclaredWixCache): WixCachePolicy;

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

@@ -410,7 +410,9 @@ export interface AppConfig {
      * App-declared Wix REST cache rules. The app controls per-endpoint opt-out
      * (`cacheable: false`) and TTL; the server renders the EFFECTIVE policy by
      * clamping these under the platform envelope (PII denies, TTL ceiling) and
-     * delivers it OTA via /v1/app-config. Omit to cache nothing (deny-by-default).
+     * delivers it OTA via /v1/app-config. Omit to get only the platform defaults — public
+     * catalog/content reads generated from the Wix SDK catalog (see
+     * core/dev-server/src/wix-cache-defaults.generated.ts); `platformDefaults: false` opts out.
      */
     cache?: AppCacheConfig;
     /**
@@ -634,7 +636,12 @@ export interface AppCacheRule {
 export interface AppCacheConfig {
     /** Behavior for a request no rule matches. Defaults to false (deny). */
     defaultCacheable?: boolean;
-    rules: AppCacheRule[];
+    /** Omit for none — e.g. `cache: { platformDefaults: false }` to opt out of the defaults alone. */
+    rules?: AppCacheRule[];
+    /** Also apply the platform default read rules (public catalog/content). Defaults to true. The
+     *  app's own rules take precedence, and each one shadows every default under its prefix — so a
+     *  broad `{ pathPrefix: "/stores/", cacheable: false }` opts the whole store out. */
+    platformDefaults?: boolean;
 }
 /** A single interface orientation. Platform-neutral names; the native-config
  *  generator maps them to `UIInterfaceOrientation*` (iOS) and the runtime maps

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

@@ -7595,7 +7595,7 @@ function validateConfigShape(config) {
     validateIcon(config.icon, config.designTokens?.colors, config.designTokensPath);
   }
   if (config.cache) {
-    for (const r of config.cache.rules) {
+    for (const r of config.cache.rules ?? []) {
       if (!r.pathPrefix || !r.pathPrefix.startsWith("/")) {
         throw new Error(`defineApp: cache rule pathPrefix must start with "/". Got "${r.pathPrefix}".`);
       }

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

@@ -9068,6 +9068,7 @@ function deriveAppMeta(name, m, platforms = {}) {
     drawer: config.navigation?.drawer,
     navKind: config.navigation?.navKind,
     orientation: config.navigation?.orientation,
+    cache: config.cache,
     sidebar: config.navigation?.sidebar,
     navLogicBundle: config.navigation?.navLogicBundle,
     appIconBadgeSources: config.navigation?.appIconBadgeSources,