@buoy-gg/images 7.0.41 → 7.0.43

package/lib/module/capture/shared.js

@@ -1,369 +1 @@
-"use strict";
-
-/**
- * Capture core shared by the RN <Image> decorator and the expo-image patch.
- *
- * ImageInstanceTracker: one per live image component instance. It rolls a new
- * ImageRecord whenever the instance's source URI changes, and exposes wrapped
- * event handlers that feed the store while still calling through to whatever
- * handlers the app passed.
- */
-
-import { imagesState } from "../state";
-import { dropActionState, settleReloadRequest } from "./actions";
-import { createRecord, getRecord, updateRecord } from "../store/imageEventStore";
-
-/**
- * Images rendered by Buoy's own UI (e.g. thumbnails inside the Images modal)
- * carry this testID prefix and are excluded from capture, so the tool doesn't
- * pollute its own registry.
- */
-export const INTERNAL_TEST_ID_PREFIX = "buoy-internal";
-export function isInternalImage(testID) {
-  return typeof testID === "string" && testID.startsWith(INTERNAL_TEST_ID_PREFIX);
-}
-
-/**
- * React Native's own devtools UI loads images too (LogBox icons resolve to
- * Metro asset URLs under Libraries/LogBox). They're noise in an app-focused
- * registry — skip them.
- */
-export function isNoiseUri(uri) {
-  return uri.includes("Libraries%2FLogBox") || uri.includes("Libraries/LogBox") || uri.includes("LogBoxImages");
-}
-export function classifyUri(uri) {
-  if (uri.startsWith("http://") || uri.startsWith("https://")) return "network";
-  if (uri.startsWith("file://") || uri.startsWith("asset://")) return "file";
-  if (uri.startsWith("data:")) return "data";
-  return "other";
-}
-
-/**
- * Best-effort URI extraction from any source prop shape (RN or expo-image):
- * string, number (Metro asset), {uri}, arrays of those, ImageRef.
- */
-export function resolveSourceUri(source) {
-  if (source == null) return {
-    uri: "",
-    kind: "other"
-  };
-  if (Array.isArray(source)) {
-    return resolveSourceUri(source.length > 0 ? source[0] : null);
-  }
-  if (typeof source === "string") {
-    return {
-      uri: source,
-      kind: classifyUri(source)
-    };
-  }
-  if (typeof source === "number") {
-    // Metro asset id. Image is guaranteed evaluated by the time an instance
-    // renders, so requiring it lazily here can never latch the decorator late.
-    try {
-      const rn = require("react-native");
-      const resolved = rn.Image?.resolveAssetSource?.(source);
-      if (resolved?.uri) return {
-        uri: resolved.uri,
-        kind: "asset"
-      };
-    } catch {
-      // fall through
-    }
-    return {
-      uri: `asset:#${source}`,
-      kind: "asset"
-    };
-  }
-  if (typeof source === "object") {
-    const uri = source.uri;
-    if (typeof uri === "string") {
-      const kind = classifyUri(uri);
-      // require()'d assets resolve to Metro dev-server URLs in dev — still
-      // report them as assets when they carry the packager marker.
-      if (source.__packager_asset) {
-        return {
-          uri,
-          kind: "asset"
-        };
-      }
-      return {
-        uri,
-        kind
-      };
-    }
-    // expo-image ImageRef (native shared object) has width/height but no uri.
-    const width = source.width;
-    if (typeof width === "number") return {
-      uri: "(ImageRef)",
-      kind: "other"
-    };
-  }
-  return {
-    uri: "",
-    kind: "other"
-  };
-}
-
-/** The event-handler subset we intercept, normalized across both libraries. */
-
-/**
- * RN events arrive as {nativeEvent}; expo-image passes the payload directly.
- *
- * The shape is told apart by the property DESCRIPTOR, never by reading the
- * property. expo-image (SDK 56+) installs a deprecation GETTER called
- * `nativeEvent` on the payload it hands us — so the obvious
- * `event.nativeEvent` sniff logged
- * '[expo-image]: Accessing event payload through "nativeEvent" is deprecated'
- * once per load event, for every image in the app, purely because Buoy
- * looked. A real RN synthetic event carries it as a plain data property;
- * `getOwnPropertyDescriptor` distinguishes the two and invokes nothing.
- */
-export function payloadOf(event) {
-  if (!event || typeof event !== "object") return {};
-  const descriptor = Object.getOwnPropertyDescriptor(event, "nativeEvent");
-  const native = descriptor && !descriptor.get ? descriptor.value : undefined;
-  if (native && typeof native === "object") {
-    return native;
-  }
-  return event;
-}
-
-/**
- * After an RN-core load, classify the cache via Image.queryCache.
- *
- * Delayed + retried: NSURLCache commits fresh downloads asynchronously, so a
- * query at the instant of onLoad reports a miss for images that ARE being
- * cached (observed live). First probe after 600ms, one re-probe at 3s to
- * catch slow cache writes.
- */
-function queryRnCache(recordId, uri) {
-  const probe = () => {
-    try {
-      const rn = require("react-native");
-      const queryCache = rn.Image?.queryCache;
-      if (typeof queryCache !== "function" || !uri) return;
-      queryCache([uri]).then(result => {
-        const verdict = result?.[uri];
-        if (verdict) {
-          updateRecord(recordId, {
-            cacheVerdict: verdict,
-            cacheVerdictSource: "queryCache"
-          });
-        }
-      }).catch(() => {});
-    } catch {
-      // queryCache unavailable (web) — leave verdict unknown.
-    }
-  };
-  setTimeout(probe, 600);
-  setTimeout(() => {
-    const record = getRecord(recordId);
-    if (record && record.cacheVerdictSource !== "queryCache") probe();
-  }, 3000);
-}
-export class ImageInstanceTracker {
-  recordId = null;
-  uri = null;
-  handlerCache = null;
-  constructor(lib) {
-    this.lib = lib;
-  }
-  getRecordId() {
-    return this.recordId;
-  }
-
-  /** Record accessibility presence (called per render; writes only on change). */
-  noteA11y(hasAltText) {
-    if (this.recordId == null) return;
-    const record = getRecord(this.recordId);
-    if (record && record.hasAltText !== hasAltText) {
-      updateRecord(this.recordId, {
-        hasAltText
-      });
-    }
-  }
-
-  /** Call on every render with the current source prop. Rolls records on change. */
-  syncSource(source) {
-    const {
-      uri,
-      kind
-    } = resolveSourceUri(source);
-    if (uri === this.uri) return;
-    this.uri = uri;
-    this.handlerCache = null; // handlers close over recordId via getter, but roll anyway
-    if (this.recordId != null) dropActionState(this.recordId);
-    if (!uri || isNoiseUri(uri)) {
-      this.recordId = null;
-      return;
-    }
-    const record = createRecord({
-      lib: this.lib,
-      uri,
-      sourceKind: kind
-    });
-    this.recordId = record.id;
-  }
-  unmount() {
-    if (this.recordId != null) {
-      updateRecord(this.recordId, {
-        mounted: false
-      });
-      dropActionState(this.recordId);
-    }
-  }
-
-  /**
-   * Wrapped handlers for the current originals. Cached by handler identity so
-   * re-renders with unchanged props reuse the same functions.
-   */
-  handlers(orig) {
-    const key = [orig.onLoadStart, orig.onProgress, orig.onLoad, orig.onError, orig.onLoadEnd, orig.onDisplay, orig.onLayout, this.recordId];
-    const cached = this.handlerCache;
-    if (cached && cached.key.length === key.length && cached.key.every((k, i) => k === key[i])) {
-      return cached.out;
-    }
-    const recordId = this.recordId;
-    const lib = this.lib;
-    const uri = this.uri ?? "";
-    const out = {
-      onLoadStart: event => {
-        if (recordId != null) {
-          const record = getRecord(recordId);
-          const now = Date.now();
-          // Out-of-order defense (seen live on iOS remounts/cache hits AND
-          // instant file:// failures): the native onLoadStart of a burst can
-          // arrive AFTER its onLoad/onError. A "start" right after a settled
-          // outcome belongs to that same burst — don't regress the record.
-          const settledAt = Math.max(record?.loadedAt ?? 0, record?.erroredAt ?? 0);
-          const settledJustNow = settledAt > 0 && now - settledAt < 300;
-          updateRecord(recordId, {
-            ...(settledJustNow ? {} : {
-              status: "loading",
-              error: undefined,
-              errorCode: undefined,
-              errorHeaders: undefined
-            }),
-            startedAt: now,
-            loadCount: (record?.loadCount ?? 0) + 1
-          });
-        }
-        orig.onLoadStart?.(event);
-      },
-      onProgress: event => {
-        if (recordId != null) {
-          const p = payloadOf(event);
-          updateRecord(recordId, {
-            progressSeen: true,
-            bytesLoaded: typeof p.loaded === "number" ? p.loaded : undefined,
-            bytesTotal: typeof p.total === "number" ? p.total : undefined
-          });
-        }
-        orig.onProgress?.(event);
-      },
-      onLoad: event => {
-        if (recordId != null) {
-          const p = payloadOf(event);
-          const source = p.source ?? {};
-          const now = Date.now();
-          const record = getRecord(recordId);
-          // Duration only counts from a start belonging to THIS load cycle: a
-          // start newer than the previous completion. Without one (instant
-          // cache hit whose onLoadStart arrives late/never), report 0ms.
-          const start = record?.startedAt != null && record.startedAt <= now && record.startedAt > (record.loadedAt ?? record.createdAt - 1) ? record.startedAt : record?.loadedAt == null ? record?.startedAt ?? record?.createdAt ?? now : now;
-          const width = typeof source.width === "number" ? source.width : 0;
-          const height = typeof source.height === "number" ? source.height : 0;
-          updateRecord(recordId, {
-            status: "loaded",
-            loadedAt: now,
-            durationMs: Math.max(0, now - start),
-            error: undefined,
-            errorCode: undefined,
-            errorHeaders: undefined,
-            intrinsic: width > 0 && height > 0 ? {
-              width,
-              height
-            } : record?.intrinsic,
-            cacheVerdict: typeof p.cacheType === "string" ? p.cacheType : record?.cacheVerdict,
-            cacheVerdictSource: typeof p.cacheType === "string" ? "event" : record?.cacheVerdictSource,
-            mediaType: typeof source.mediaType === "string" || source.mediaType === null ? source.mediaType : record?.mediaType,
-            isAnimated: typeof source.isAnimated === "boolean" ? source.isAnimated : record?.isAnimated
-          });
-          settleReloadRequest(recordId);
-          if (lib === "rn") queryRnCache(recordId, uri);
-        }
-        orig.onLoad?.(event);
-      },
-      onError: event => {
-        if (recordId != null) {
-          const p = payloadOf(event);
-          let message = typeof p.error === "string" ? p.error : String(p.error?.message ?? "unknown error");
-          // Simulation sources produce raw file-not-found noise — translate to
-          // an honest label (state-based, so it works for both libs' error
-          // texts), in our record AND in the event the app receives.
-          const record0 = getRecord(recordId);
-          const s = imagesState();
-          const activeOverride = s.overrides.get(recordId);
-          if (activeOverride?.source?.type === "error") {
-            message = "Forced error (Buoy Images simulation)";
-            if (typeof p.error === "string") p.error = message;
-          } else if (s.globalModes.network === "offline" && record0?.sourceKind === "network") {
-            message = "Offline simulation (Buoy Images): network image blocked";
-            if (typeof p.error === "string") p.error = message;
-          }
-          updateRecord(recordId, {
-            status: "error",
-            erroredAt: Date.now(),
-            error: message,
-            errorCode: typeof p.responseCode === "number" ? p.responseCode : undefined,
-            errorHeaders: p.httpResponseHeaders && typeof p.httpResponseHeaders === "object" ? p.httpResponseHeaders : undefined
-          });
-          settleReloadRequest(recordId);
-        }
-        orig.onError?.(event);
-      },
-      onLayout: event => {
-        if (recordId != null) {
-          const layout = payloadOf(event).layout ?? {};
-          const width = typeof layout.width === "number" ? layout.width : 0;
-          const height = typeof layout.height === "number" ? layout.height : 0;
-          if (width > 0 && height > 0) {
-            const record = getRecord(recordId);
-            const prev = record?.layout;
-            // Size change AFTER the image loaded = layout-shift suspect (the
-            // image arriving resized its box — reserve explicit dimensions).
-            const shifted = prev != null && record?.loadedAt != null && (Math.abs(prev.width - width) > 1 || Math.abs(prev.height - height) > 1);
-            updateRecord(recordId, {
-              layout: {
-                width,
-                height
-              },
-              ...(shifted ? {
-                layoutShifts: (record?.layoutShifts ?? 0) + 1
-              } : {})
-            });
-          }
-        }
-        orig.onLayout?.(event);
-      }
-    };
-
-    // Only forward-wrap the optional ones so we don't attach handlers a
-    // library doesn't support (onDisplay is expo-only; onLoadEnd is RN-only).
-    out.onLoadEnd = orig.onLoadEnd ? event => orig.onLoadEnd?.(event) : undefined;
-    if (this.lib === "expo") {
-      out.onDisplay = event => {
-        if (recordId != null) updateRecord(recordId, {
-          displayedAt: Date.now()
-        });
-        orig.onDisplay?.(event);
-      };
-    }
-    this.handlerCache = {
-      key,
-      out
-    };
-    return out;
-  }
-}
-//# sourceMappingURL=shared.js.map
+"use strict";import{imagesState as I}from"../state";import{dropActionState as b,settleReloadRequest as A}from"./actions";import{createRecord as w,getRecord as h,updateRecord as u}from"../store/imageEventStore";export const INTERNAL_TEST_ID_PREFIX="buoy-internal";export function isInternalImage(t){return typeof t==="string"&&t.startsWith(INTERNAL_TEST_ID_PREFIX)}export function isNoiseUri(t){return t.includes("Libraries%2FLogBox")||t.includes("Libraries/LogBox")||t.includes("LogBoxImages")}export function classifyUri(t){if(t.startsWith("http://")||t.startsWith("https://"))return"network";if(t.startsWith("file://")||t.startsWith("asset://"))return"file";if(t.startsWith("data:"))return"data";return"other"}export function resolveSourceUri(t){if(t==null)return{uri:"",kind:"other"};if(Array.isArray(t)){return resolveSourceUri(t.length>0?t[0]:null)}if(typeof t==="string"){return{uri:t,kind:classifyUri(t)}}if(typeof t==="number"){try{const e=require("react-native");const n=e.Image?.resolveAssetSource?.(t);if(n?.uri)return{uri:n.uri,kind:"asset"}}catch{}return{uri:`asset:#${t}`,kind:"asset"}}if(typeof t==="object"){const e=t.uri;if(typeof e==="string"){const c=classifyUri(e);if(t.__packager_asset){return{uri:e,kind:"asset"}}return{uri:e,kind:c}}const n=t.width;if(typeof n==="number")return{uri:"(ImageRef)",kind:"other"}}return{uri:"",kind:"other"}}export function payloadOf(t){if(!t||typeof t!=="object")return{};const e=Object.getOwnPropertyDescriptor(t,"nativeEvent");const n=e&&!e.get?e.value:void 0;if(n&&typeof n==="object"){return n}return t}function k(t,e){const n=()=>{try{const c=require("react-native");const o=c.Image?.queryCache;if(typeof o!=="function"||!e)return;o([e]).then(m=>{const f=m?.[e];if(f){u(t,{cacheVerdict:f,cacheVerdictSource:"queryCache"})}}).catch(()=>{})}catch{}};setTimeout(n,600);setTimeout(()=>{const c=h(t);if(c&&c.cacheVerdictSource!=="queryCache")n()},3e3)}export class ImageInstanceTracker{recordId=null;uri=null;handlerCache=null;constructor(e){this.lib=e}getRecordId(){return this.recordId}noteA11y(e){if(this.recordId==null)return;const n=h(this.recordId);if(n&&n.hasAltText!==e){u(this.recordId,{hasAltText:e})}}syncSource(e){const{uri:n,kind:c}=resolveSourceUri(e);if(n===this.uri)return;this.uri=n;this.handlerCache=null;if(this.recordId!=null)b(this.recordId);if(!n||isNoiseUri(n)){this.recordId=null;return}const o=w({lib:this.lib,uri:n,sourceKind:c});this.recordId=o.id}unmount(){if(this.recordId!=null){u(this.recordId,{mounted:false});b(this.recordId)}}handlers(e){const n=[e.onLoadStart,e.onProgress,e.onLoad,e.onError,e.onLoadEnd,e.onDisplay,e.onLayout,this.recordId];const c=this.handlerCache;if(c&&c.key.length===n.length&&c.key.every((d,r)=>d===n[r])){return c.out}const o=this.recordId;const m=this.lib;const f=this.uri??"";const p={onLoadStart:d=>{if(o!=null){const r=h(o);const s=Date.now();const a=Math.max(r?.loadedAt??0,r?.erroredAt??0);const i=a>0&&s-a<300;u(o,{...i?{}:{status:"loading",error:void 0,errorCode:void 0,errorHeaders:void 0},startedAt:s,loadCount:(r?.loadCount??0)+1})}e.onLoadStart?.(d)},onProgress:d=>{if(o!=null){const r=payloadOf(d);u(o,{progressSeen:true,bytesLoaded:typeof r.loaded==="number"?r.loaded:void 0,bytesTotal:typeof r.total==="number"?r.total:void 0})}e.onProgress?.(d)},onLoad:d=>{if(o!=null){const r=payloadOf(d);const s=r.source??{};const a=Date.now();const i=h(o);const l=i?.startedAt!=null&&i.startedAt<=a&&i.startedAt>(i.loadedAt??i.createdAt-1)?i.startedAt:i?.loadedAt==null?i?.startedAt??i?.createdAt??a:a;const y=typeof s.width==="number"?s.width:0;const g=typeof s.height==="number"?s.height:0;u(o,{status:"loaded",loadedAt:a,durationMs:Math.max(0,a-l),error:void 0,errorCode:void 0,errorHeaders:void 0,intrinsic:y>0&&g>0?{width:y,height:g}:i?.intrinsic,cacheVerdict:typeof r.cacheType==="string"?r.cacheType:i?.cacheVerdict,cacheVerdictSource:typeof r.cacheType==="string"?"event":i?.cacheVerdictSource,mediaType:typeof s.mediaType==="string"||s.mediaType===null?s.mediaType:i?.mediaType,isAnimated:typeof s.isAnimated==="boolean"?s.isAnimated:i?.isAnimated});A(o);if(m==="rn")k(o,f)}e.onLoad?.(d)},onError:d=>{if(o!=null){const r=payloadOf(d);let s=typeof r.error==="string"?r.error:String(r.error?.message??"unknown error");const a=h(o);const i=I();const l=i.overrides.get(o);if(l?.source?.type==="error"){s="Forced error (Buoy Images simulation)";if(typeof r.error==="string")r.error=s}else if(i.globalModes.network==="offline"&&a?.sourceKind==="network"){s="Offline simulation (Buoy Images): network image blocked";if(typeof r.error==="string")r.error=s}u(o,{status:"error",erroredAt:Date.now(),error:s,errorCode:typeof r.responseCode==="number"?r.responseCode:void 0,errorHeaders:r.httpResponseHeaders&&typeof r.httpResponseHeaders==="object"?r.httpResponseHeaders:void 0});A(o)}e.onError?.(d)},onLayout:d=>{if(o!=null){const r=payloadOf(d).layout??{};const s=typeof r.width==="number"?r.width:0;const a=typeof r.height==="number"?r.height:0;if(s>0&&a>0){const i=h(o);const l=i?.layout;const y=l!=null&&i?.loadedAt!=null&&(Math.abs(l.width-s)>1||Math.abs(l.height-a)>1);u(o,{layout:{width:s,height:a},...y?{layoutShifts:(i?.layoutShifts??0)+1}:{}})}}e.onLayout?.(d)}};p.onLoadEnd=e.onLoadEnd?d=>e.onLoadEnd?.(d):void 0;if(this.lib==="expo"){p.onDisplay=d=>{if(o!=null)u(o,{displayedAt:Date.now()});e.onDisplay?.(d)}}this.handlerCache={key:n,out:p};return p}}