@rocapine/rn-social-share 0.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/capture.ts","../src/createSharer.ts","../src/channels/_shareSheet.ts","../src/channels/systemSheet.ts","../src/channels/whatsapp.ts","../src/channels/copyLink.ts","../src/channels/instagramStories.ts","../src/channels/sms.ts","../src/channels/tiktok.ts","../src/channels/saveToLibrary.ts","../src/react/useShareCard.ts","../src/react/useScreenshotTrigger.ts","../src/react/screenshotDebounce.ts","../src/react/imageReadiness.ts"],"sourcesContent":["// Core (pure, no UI)\nexport * from \"./types\";\nexport { captureCardImage, type CaptureOptions } from \"./capture\";\nexport { createSharer } from \"./createSharer\";\n\n// Channels (modular registry)\nexport * from \"./channels\";\n\n// React layer (optional hooks + helpers)\nexport * from \"./react\";\n","import { cacheDirectory, copyAsync, deleteAsync } from \"expo-file-system/legacy\";\nimport type { RefObject } from \"react\";\nimport { captureRef } from \"react-native-view-shot\";\n\nexport type CaptureOptions = {\n  /**\n   * Branded file name (with extension) the captured image is copied to, so every\n   * consumer — the share sheet, an SMS attachment, TikTok, the saved photo — shows a\n   * clean name (e.g. \"unchaind-invite.png\") instead of view-shot's random UUID.\n   */\n  fileName: string;\n  /** Output width in px. Default 1080 (story resolution at 3× of a 360pt card). */\n  width?: number;\n  /** Output height in px. Default 1920. */\n  height?: number;\n  /** Image format. Default \"png\". */\n  format?: \"png\" | \"jpg\";\n  /** 0..1. Default 1. */\n  quality?: number;\n  /** Called with the underlying error if capture fails (the function still resolves undefined). */\n  onError?: (error: unknown) => void;\n};\n\n/**\n * Captures an off-screen view (via its ref) to an image file at story resolution, then\n * copies it to a branded file name. Returns the file URI, or `undefined` on failure so\n * callers can fall back to a text-only share.\n *\n * This is the single, deduplicated version of the capture logic both apps had copied\n * verbatim. Extracted as a plain async function so it is testable without rendering.\n *\n * Note (ROC-2883): view-shot must not run until every async image in the card has\n * painted, or a late-loading image is absent from the file. Coordinate readiness with\n * `areAllImagesLoaded` before calling this.\n */\nexport async function captureCardImage(\n  ref: RefObject<unknown>,\n  options: CaptureOptions,\n): Promise<string | undefined> {\n  const { fileName, width = 1080, height = 1920, format = \"png\", quality = 1, onError } = options;\n  try {\n    // view-shot's temp file is managed and can't be moved reliably — copy it instead.\n    const tmpUri = await captureRef(ref as never, { format, quality, width, height });\n    const namedUri = `${cacheDirectory}${fileName}`;\n    await deleteAsync(namedUri, { idempotent: true });\n    await copyAsync({ from: tmpUri, to: namedUri });\n    return namedUri;\n  } catch (error) {\n    onError?.(error);\n    return undefined;\n  }\n}\n","import type {\n  CreateSharerOptions,\n  ShareChannel,\n  ShareEvent,\n  SharePayload,\n  ShareOutcome,\n  Sharer,\n} from \"./types\";\n\nconst DEFAULT_FALLBACK_ID = \"system-sheet\";\n\n/**\n * Builds a sharer from a list of channels. This is the abstraction layer between the app\n * and react-native-share / the OpenSDKs: the app only ever calls `sharer.share(id, payload)`\n * and adds/removes channels by editing the `channels` array.\n *\n * Routing per share:\n *   1. Emit `share_started`.\n *   2. Unknown id, or `isAvailable()` false/throws → `share_unavailable`, route to fallback.\n *   3. `share()` throws → `share_failed`, route to fallback.\n *   4. Emit `share_completed` with the channel that actually handled it.\n *\n * The fallback (default: the channel registered as \"system-sheet\") is never used to route\n * back into itself, so a missing/failed fallback yields a non-completed outcome instead of\n * looping.\n */\nexport function createSharer(options: CreateSharerOptions): Sharer {\n  const { channels, onEvent } = options;\n\n  const registry = new Map<string, ShareChannel>();\n  for (const channel of channels) {\n    if (registry.has(channel.id)) {\n      throw new Error(`[rn-social-share] Duplicate channel id \"${channel.id}\"`);\n    }\n    registry.set(channel.id, channel);\n  }\n\n  const fallbackId = options.fallbackChannelId ?? DEFAULT_FALLBACK_ID;\n  const fallbackChannel = registry.get(fallbackId);\n\n  const emit = (event: ShareEvent): void => {\n    try {\n      onEvent?.(event);\n    } catch {\n      // Analytics/logging must never break a share.\n    }\n  };\n\n  const emitCompleted = (outcome: ShareOutcome): void => {\n    emit({\n      type: \"share_completed\",\n      channel: outcome.channel,\n      fellBack: outcome.fellBack ?? false,\n      targetApp: outcome.targetApp,\n    });\n  };\n\n  const runFallback = async (requestedId: string, payload: SharePayload): Promise<ShareOutcome> => {\n    if (!fallbackChannel || fallbackChannel.id === requestedId) {\n      return { completed: false, channel: requestedId, fellBack: false };\n    }\n    try {\n      const outcome = await fallbackChannel.share(payload);\n      return { ...outcome, channel: fallbackChannel.id, fellBack: true };\n    } catch {\n      return { completed: false, channel: fallbackChannel.id, fellBack: true };\n    }\n  };\n\n  const share = async (channelId: string, payload: SharePayload): Promise<ShareOutcome> => {\n    emit({ type: \"share_started\", channel: channelId, hasImage: Boolean(payload.imageUri) });\n\n    const channel = registry.get(channelId);\n\n    let available = channel !== undefined;\n    if (channel) {\n      try {\n        available = await channel.isAvailable(payload);\n      } catch {\n        available = false;\n      }\n    }\n\n    if (!channel || !available) {\n      emit({ type: \"share_unavailable\", channel: channelId });\n      const outcome = await runFallback(channelId, payload);\n      emitCompleted(outcome);\n      return outcome;\n    }\n\n    try {\n      const outcome = await channel.share(payload);\n      emitCompleted(outcome);\n      return outcome;\n    } catch (error) {\n      emit({ type: \"share_failed\", channel: channelId, error });\n      const outcome = await runFallback(channelId, payload);\n      emitCompleted(outcome);\n      return outcome;\n    }\n  };\n\n  return {\n    channelIds: channels.map((channel) => channel.id),\n    has: (channelId) => registry.has(channelId),\n    isAvailable: async (channelId, payload) => {\n      const channel = registry.get(channelId);\n      if (!channel) {\n        return false;\n      }\n      try {\n        return await channel.isAvailable(payload);\n      } catch {\n        return false;\n      }\n    },\n    share,\n  };\n}\n","import Share from \"react-native-share\";\nimport type { ShareOutcome, SharePayload } from \"../types\";\n\ntype ShareOpenResult = { dismissedAction?: boolean; app?: string | null };\n\n/**\n * Opens the native OS share sheet with the image + caption + branded file name. Shared by\n * the `systemSheet` and `whatsapp` channels and used as the TikTok fallback. With\n * `failOnCancel: false`, a user cancel resolves (with `dismissedAction`) instead of throwing.\n */\nexport async function openSystemShareSheet(\n  payload: SharePayload,\n  channelId: string,\n): Promise<ShareOutcome> {\n  const result = (await Share.open({\n    message: payload.message,\n    url: payload.imageUri,\n    type: payload.imageUri ? \"image/png\" : undefined,\n    filename: payload.fileName,\n    failOnCancel: false,\n  })) as ShareOpenResult;\n\n  if (result?.dismissedAction) {\n    return { completed: false, channel: channelId };\n  }\n  return { completed: true, channel: channelId, targetApp: result?.app ?? null };\n}\n","import type { ShareChannel } from \"../types\";\nimport { openSystemShareSheet } from \"./_shareSheet\";\n\n/**\n * The generic native share sheet. Always available, so it doubles as the default fallback\n * (register it with the default id \"system-sheet\" to have `createSharer` pick it up).\n */\nexport const systemSheet = (options: { id?: string } = {}): ShareChannel => {\n  const id = options.id ?? \"system-sheet\";\n  return {\n    id,\n    isAvailable: async () => true,\n    share: (payload) => openSystemShareSheet(payload, id),\n  };\n};\n","import { Linking } from \"react-native\";\nimport type { ShareChannel } from \"../types\";\nimport { openSystemShareSheet } from \"./_shareSheet\";\n\nconst WHATSAPP_PROBE_URL = \"whatsapp://send\";\n\n/**\n * WhatsApp — intentionally routed through the system share sheet. iOS has no reliable\n * direct deep link that carries the full text AND an image: both `whatsapp://send?text=`\n * and `wa.me` drop everything but the URL on real devices, and RNShare's WhatsApp-text\n * path builds an invalid URL (literal spaces). The share sheet's WhatsApp extension is the\n * only dependable path. `isAvailable` still probes for the app so the UI can hide the\n * button when WhatsApp isn't installed.\n *\n * iOS: requires `whatsapp` in LSApplicationQueriesSchemes (see `withSocialShare`).\n */\nexport const whatsapp = (options: { id?: string } = {}): ShareChannel => {\n  const id = options.id ?? \"whatsapp\";\n  return {\n    id,\n    isAvailable: () => Linking.canOpenURL(WHATSAPP_PROBE_URL).catch(() => false),\n    share: (payload) => openSystemShareSheet(payload, id),\n  };\n};\n","import type { ShareChannel } from \"../types\";\n\n/**\n * Copies `payload.link` to the clipboard. Not a \"share\" in the OS sense, but modeled as a\n * channel so it slots into the same UI row and analytics funnel as everything else.\n *\n * `expo-clipboard` is a lazy require so importing the channel barrel never forces the\n * dependency on apps that don't use this channel.\n */\nexport const copyLink = (options: { id?: string } = {}): ShareChannel => {\n  const id = options.id ?? \"link\";\n  return {\n    id,\n    isAvailable: async (payload) => typeof payload.link === \"string\" && payload.link.length > 0,\n    share: async (payload) => {\n      if (!payload.link) {\n        return { completed: false, channel: id };\n      }\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const Clipboard = require(\"expo-clipboard\");\n      await Clipboard.setStringAsync(payload.link);\n      return { completed: true, channel: id };\n    },\n  };\n};\n","import { Linking } from \"react-native\";\nimport Share, { type ShareSingleOptions } from \"react-native-share\";\nimport type { ShareChannel } from \"../types\";\n\nconst INSTAGRAM_STORIES_URL = \"instagram-stories://share\";\n\n/**\n * Instagram Stories with the captured image as the full-bleed background.\n *\n * `appId` is required and app-specific — it is the Facebook/Meta App ID tied to your app\n * (mandatory for the Stories deep link since Jan 2023). Pass your own; the two apps that\n * seeded this package use different ids.\n *\n * iOS: requires `instagram-stories` in LSApplicationQueriesSchemes (see `withSocialShare`)\n * for `isAvailable` to detect Instagram. When unavailable, `createSharer` routes to the\n * fallback channel.\n */\nexport const instagramStories = (options: { appId: string; id?: string }): ShareChannel => {\n  const id = options.id ?? \"instagram\";\n  return {\n    id,\n    isAvailable: async (payload) => {\n      if (!payload.imageUri) {\n        return false;\n      }\n      return Linking.canOpenURL(INSTAGRAM_STORIES_URL).catch(() => false);\n    },\n    share: async (payload) => {\n      if (!payload.imageUri) {\n        throw new Error(\"[rn-social-share] instagramStories requires payload.imageUri\");\n      }\n      await Share.shareSingle({\n        social: Share.Social.INSTAGRAM_STORIES,\n        backgroundImage: payload.imageUri,\n        appId: options.appId,\n      } as ShareSingleOptions);\n      return { completed: true, channel: id };\n    },\n  };\n};\n","import Share, { type ShareSingleOptions } from \"react-native-share\";\nimport type { ShareChannel } from \"../types\";\n\n/**\n * Native SMS/Messages composer with the full text body and the card image attached.\n * `isAvailable` is optimistic (true); a device without SMS makes `shareSingle` throw, and\n * `createSharer` then routes to the fallback channel.\n */\nexport const sms = (options: { id?: string } = {}): ShareChannel => {\n  const id = options.id ?? \"messages\";\n  return {\n    id,\n    isAvailable: async () => true,\n    share: async (payload) => {\n      await Share.shareSingle({\n        social: Share.Social.SMS,\n        message: payload.message,\n        url: payload.imageUri,\n      } as ShareSingleOptions);\n      return { completed: true, channel: id };\n    },\n  };\n};\n","import type { ShareChannel } from \"../types\";\nimport { openSystemShareSheet } from \"./_shareSheet\";\n\nexport type TikTokChannelOptions = {\n  id?: string;\n  /** Called if the OpenSDK is missing or rejects (before falling back to the system sheet). */\n  onError?: (error: unknown) => void;\n};\n\n/**\n * TikTok via `tiktok-opensdk-react-native`, fire-and-forget. Opening TikTok IS the action —\n * we never await the SDK's result promise because, with no AppDelegate callback wired, it\n * may never settle. We report `completed` optimistically once the share is kicked off; a\n * *real* rejection (e.g. TikTok not installed) still routes to the system sheet so the user\n * can share.\n *\n * The SDK is a lazy require and optional: if it isn't installed, this channel simply falls\n * back to the system sheet. Native setup (client key, FileProvider, package visibility)\n * lives in the app's own TikTok config plugin — see the README.\n *\n * API (tiktok-opensdk-react-native@0.10.x): default export\n *   TikTokOpenSDK.share(mediaPaths: string[], isImage?: boolean, isGreenScreen?: boolean)\n */\nexport const tiktok = (options: TikTokChannelOptions = {}): ShareChannel => {\n  const id = options.id ?? \"tiktok\";\n\n  const fallback = (payload: Parameters<ShareChannel[\"share\"]>[0]) =>\n    openSystemShareSheet(payload, id).then((outcome) => ({ ...outcome, fellBack: true }));\n\n  return {\n    id,\n    isAvailable: async (payload) => Boolean(payload.imageUri),\n    share: async (payload) => {\n      if (!payload.imageUri) {\n        return fallback(payload);\n      }\n      try {\n        // eslint-disable-next-line @typescript-eslint/no-var-requires\n        const mod = require(\"tiktok-opensdk-react-native\");\n        const TikTokOpenSDK = mod?.default ?? mod;\n        if (TikTokOpenSDK && typeof TikTokOpenSDK.share === \"function\") {\n          // Fire-and-forget. Fall back only on a real rejection; the promise-never-settles\n          // case simply never runs `.catch`, which is the intended behavior.\n          TikTokOpenSDK.share([payload.imageUri], true, false).catch((error: unknown) => {\n            options.onError?.(error);\n            void openSystemShareSheet(payload, id);\n          });\n          return { completed: true, channel: id };\n        }\n      } catch (error) {\n        options.onError?.(error);\n      }\n      return fallback(payload);\n    },\n  };\n};\n","import type { ShareChannel } from \"../types\";\n\n/**\n * Saves the image to the device photo library via `expo-media-library` (add-only / write\n * permission, which avoids needing a full photo-library read description on iOS). Returns\n * `{ completed: false, permissionDenied: true }` when the user denies access, so the host UI\n * can show an \"open settings\" prompt.\n *\n * `expo-media-library` is a lazy require and optional — only apps that register this channel\n * need it installed.\n */\nexport const saveToLibrary = (options: { id?: string } = {}): ShareChannel => {\n  const id = options.id ?? \"save\";\n  return {\n    id,\n    isAvailable: async (payload) => Boolean(payload.imageUri),\n    share: async (payload) => {\n      if (!payload.imageUri) {\n        throw new Error(\"[rn-social-share] saveToLibrary requires payload.imageUri\");\n      }\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const MediaLibrary = require(\"expo-media-library\");\n      const current = await MediaLibrary.getPermissionsAsync(true);\n      let granted = current.granted;\n      if (!granted) {\n        const requested = await MediaLibrary.requestPermissionsAsync(true);\n        granted = requested.granted;\n      }\n      if (!granted) {\n        return { completed: false, channel: id, permissionDenied: true };\n      }\n      await MediaLibrary.saveToLibraryAsync(payload.imageUri);\n      return { completed: true, channel: id };\n    },\n  };\n};\n","import { useCallback, useRef } from \"react\";\nimport type { View } from \"react-native\";\nimport { captureCardImage, type CaptureOptions } from \"../capture\";\n\n/**\n * Headless capture hook: gives you a `ref` to attach to your off-screen card view and a\n * `capture()` that renders it to a branded image file (or `undefined` on failure).\n *\n * The card visual itself stays in the app — the package only captures whatever you point\n * the ref at. Render the card off-screen (e.g. `position: \"absolute\", left: -10000`) and\n * gate `capture()` on `areAllImagesLoaded` if the card has async images.\n *\n * Need two variants (e.g. rounded for the sheet, square full-bleed for Stories)? Call this\n * hook twice, or call `captureCardImage` directly with each ref.\n */\nexport function useShareCard(options: CaptureOptions) {\n  const ref = useRef<View>(null);\n  const { fileName, width, height, format, quality, onError } = options;\n\n  const capture = useCallback(\n    () => captureCardImage(ref, { fileName, width, height, format, quality, onError }),\n    [fileName, width, height, format, quality, onError],\n  );\n\n  return { ref, capture };\n}\n","import { useEffect, useRef } from \"react\";\nimport { screenshotGate } from \"./screenshotDebounce\";\n\n/**\n * Calls `onScreenshot` when the user takes a screenshot, while `enabled` is true — the\n * \"share on screenshot\" trigger from the Expo Marathon pattern. Dedup is enforced by a\n * shared, app-wide gate so one screenshot fires at most one handler even when iOS\n * double-fires or several instances are mounted (ROC-2854).\n *\n * No-ops silently where screenshot detection is unavailable (iOS supported; Android only\n * API 34+) or when `expo-screen-capture` isn't installed — the lazy require keeps that\n * dependency optional, and an explicit share button remains the fallback.\n */\nexport function useScreenshotTrigger(enabled: boolean, onScreenshot: () => void): void {\n  const onScreenshotRef = useRef(onScreenshot);\n  onScreenshotRef.current = onScreenshot;\n\n  useEffect(\n    function subscribeToScreenshots() {\n      if (!enabled) {\n        return;\n      }\n      let subscription: { remove: () => void } | undefined;\n      try {\n        // eslint-disable-next-line @typescript-eslint/no-var-requires\n        const { addScreenshotListener } = require(\"expo-screen-capture\");\n        subscription = addScreenshotListener(() => {\n          if (screenshotGate(Date.now())) {\n            onScreenshotRef.current();\n          }\n        });\n      } catch {\n        // Screenshot detection unavailable / module not installed — silent fail.\n      }\n      return () => subscription?.remove();\n    },\n    [enabled],\n  );\n}\n","export const SCREENSHOT_DEBOUNCE_MS = 1000;\n\nexport function shouldHandleScreenshot(\n  lastHandledAt: number | null,\n  now: number,\n  windowMs: number = SCREENSHOT_DEBOUNCE_MS,\n): boolean {\n  if (lastHandledAt === null) {\n    return true;\n  }\n  return now - lastHandledAt >= windowMs;\n}\n\n/**\n * A screenshot is a single OS-wide event, but one screenshot can reach a handler more than\n * once: iOS double-fires the notification, and release builds can mount more than one\n * `useScreenshotTrigger` instance (ROC-2854). A per-instance debounce can't dedupe across\n * instances. This gate holds the last-handled timestamp so that, no matter how many callers\n * react to the same screenshot, `gate(now)` returns `true` at most once per `windowMs`.\n *\n * The hook uses a single shared gate (`screenshotGate`); the factory exists so tests (and\n * apps that want isolation) get their own instance.\n */\nexport function createScreenshotGate(windowMs: number = SCREENSHOT_DEBOUNCE_MS) {\n  let lastHandledAt: number | null = null;\n  return function tryHandleScreenshot(now: number): boolean {\n    if (shouldHandleScreenshot(lastHandledAt, now, windowMs)) {\n      lastHandledAt = now;\n      return true;\n    }\n    return false;\n  };\n}\n\n/** Single app-wide screenshot gate shared by every `useScreenshotTrigger`. */\nexport const screenshotGate = createScreenshotGate();\n","/**\n * A shareable card often contains several asynchronously-loaded images (a fruit\n * illustration, a logo…). view-shot must not capture until every one has painted, or an\n * image that loads after the capture fires is absent from the file. This was ROC-2883: the\n * capture only awaited one image, so the logo was frequently missing from the export.\n *\n * Track loaded keys in a Set as each `<Image onLoad>` fires, then gate the capture on\n * `areAllImagesLoaded(loaded, REQUIRED_KEYS)`.\n */\nexport function areAllImagesLoaded(\n  loaded: ReadonlySet<string>,\n  required: readonly string[],\n): boolean {\n  return required.every((key) => loaded.has(key));\n}\n"],"mappings":"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","names":["Share","import_react_native","import_react_native_share","Share","import_react_native_share","Share","import_react"]}

package/dist/index.mjs

@@ -0,0 +1,348 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/capture.ts
+import { cacheDirectory, copyAsync, deleteAsync } from "expo-file-system/legacy";
+import { captureRef } from "react-native-view-shot";
+async function captureCardImage(ref, options) {
+  const { fileName, width = 1080, height = 1920, format = "png", quality = 1, onError } = options;
+  try {
+    const tmpUri = await captureRef(ref, { format, quality, width, height });
+    const namedUri = `${cacheDirectory}${fileName}`;
+    await deleteAsync(namedUri, { idempotent: true });
+    await copyAsync({ from: tmpUri, to: namedUri });
+    return namedUri;
+  } catch (error) {
+    onError?.(error);
+    return void 0;
+  }
+}
+
+// src/createSharer.ts
+var DEFAULT_FALLBACK_ID = "system-sheet";
+function createSharer(options) {
+  const { channels, onEvent } = options;
+  const registry = /* @__PURE__ */ new Map();
+  for (const channel of channels) {
+    if (registry.has(channel.id)) {
+      throw new Error(`[rn-social-share] Duplicate channel id "${channel.id}"`);
+    }
+    registry.set(channel.id, channel);
+  }
+  const fallbackId = options.fallbackChannelId ?? DEFAULT_FALLBACK_ID;
+  const fallbackChannel = registry.get(fallbackId);
+  const emit = (event) => {
+    try {
+      onEvent?.(event);
+    } catch {
+    }
+  };
+  const emitCompleted = (outcome) => {
+    emit({
+      type: "share_completed",
+      channel: outcome.channel,
+      fellBack: outcome.fellBack ?? false,
+      targetApp: outcome.targetApp
+    });
+  };
+  const runFallback = async (requestedId, payload) => {
+    if (!fallbackChannel || fallbackChannel.id === requestedId) {
+      return { completed: false, channel: requestedId, fellBack: false };
+    }
+    try {
+      const outcome = await fallbackChannel.share(payload);
+      return { ...outcome, channel: fallbackChannel.id, fellBack: true };
+    } catch {
+      return { completed: false, channel: fallbackChannel.id, fellBack: true };
+    }
+  };
+  const share = async (channelId, payload) => {
+    emit({ type: "share_started", channel: channelId, hasImage: Boolean(payload.imageUri) });
+    const channel = registry.get(channelId);
+    let available = channel !== void 0;
+    if (channel) {
+      try {
+        available = await channel.isAvailable(payload);
+      } catch {
+        available = false;
+      }
+    }
+    if (!channel || !available) {
+      emit({ type: "share_unavailable", channel: channelId });
+      const outcome = await runFallback(channelId, payload);
+      emitCompleted(outcome);
+      return outcome;
+    }
+    try {
+      const outcome = await channel.share(payload);
+      emitCompleted(outcome);
+      return outcome;
+    } catch (error) {
+      emit({ type: "share_failed", channel: channelId, error });
+      const outcome = await runFallback(channelId, payload);
+      emitCompleted(outcome);
+      return outcome;
+    }
+  };
+  return {
+    channelIds: channels.map((channel) => channel.id),
+    has: (channelId) => registry.has(channelId),
+    isAvailable: async (channelId, payload) => {
+      const channel = registry.get(channelId);
+      if (!channel) {
+        return false;
+      }
+      try {
+        return await channel.isAvailable(payload);
+      } catch {
+        return false;
+      }
+    },
+    share
+  };
+}
+
+// src/channels/_shareSheet.ts
+import Share from "react-native-share";
+async function openSystemShareSheet(payload, channelId) {
+  const result = await Share.open({
+    message: payload.message,
+    url: payload.imageUri,
+    type: payload.imageUri ? "image/png" : void 0,
+    filename: payload.fileName,
+    failOnCancel: false
+  });
+  if (result?.dismissedAction) {
+    return { completed: false, channel: channelId };
+  }
+  return { completed: true, channel: channelId, targetApp: result?.app ?? null };
+}
+
+// src/channels/systemSheet.ts
+var systemSheet = (options = {}) => {
+  const id = options.id ?? "system-sheet";
+  return {
+    id,
+    isAvailable: async () => true,
+    share: (payload) => openSystemShareSheet(payload, id)
+  };
+};
+
+// src/channels/whatsapp.ts
+import { Linking } from "react-native";
+var WHATSAPP_PROBE_URL = "whatsapp://send";
+var whatsapp = (options = {}) => {
+  const id = options.id ?? "whatsapp";
+  return {
+    id,
+    isAvailable: () => Linking.canOpenURL(WHATSAPP_PROBE_URL).catch(() => false),
+    share: (payload) => openSystemShareSheet(payload, id)
+  };
+};
+
+// src/channels/copyLink.ts
+var copyLink = (options = {}) => {
+  const id = options.id ?? "link";
+  return {
+    id,
+    isAvailable: async (payload) => typeof payload.link === "string" && payload.link.length > 0,
+    share: async (payload) => {
+      if (!payload.link) {
+        return { completed: false, channel: id };
+      }
+      const Clipboard = __require("expo-clipboard");
+      await Clipboard.setStringAsync(payload.link);
+      return { completed: true, channel: id };
+    }
+  };
+};
+
+// src/channels/instagramStories.ts
+import { Linking as Linking2 } from "react-native";
+import Share2 from "react-native-share";
+var INSTAGRAM_STORIES_URL = "instagram-stories://share";
+var instagramStories = (options) => {
+  const id = options.id ?? "instagram";
+  return {
+    id,
+    isAvailable: async (payload) => {
+      if (!payload.imageUri) {
+        return false;
+      }
+      return Linking2.canOpenURL(INSTAGRAM_STORIES_URL).catch(() => false);
+    },
+    share: async (payload) => {
+      if (!payload.imageUri) {
+        throw new Error("[rn-social-share] instagramStories requires payload.imageUri");
+      }
+      await Share2.shareSingle({
+        social: Share2.Social.INSTAGRAM_STORIES,
+        backgroundImage: payload.imageUri,
+        appId: options.appId
+      });
+      return { completed: true, channel: id };
+    }
+  };
+};
+
+// src/channels/sms.ts
+import Share3 from "react-native-share";
+var sms = (options = {}) => {
+  const id = options.id ?? "messages";
+  return {
+    id,
+    isAvailable: async () => true,
+    share: async (payload) => {
+      await Share3.shareSingle({
+        social: Share3.Social.SMS,
+        message: payload.message,
+        url: payload.imageUri
+      });
+      return { completed: true, channel: id };
+    }
+  };
+};
+
+// src/channels/tiktok.ts
+var tiktok = (options = {}) => {
+  const id = options.id ?? "tiktok";
+  const fallback = (payload) => openSystemShareSheet(payload, id).then((outcome) => ({ ...outcome, fellBack: true }));
+  return {
+    id,
+    isAvailable: async (payload) => Boolean(payload.imageUri),
+    share: async (payload) => {
+      if (!payload.imageUri) {
+        return fallback(payload);
+      }
+      try {
+        const mod = __require("tiktok-opensdk-react-native");
+        const TikTokOpenSDK = mod?.default ?? mod;
+        if (TikTokOpenSDK && typeof TikTokOpenSDK.share === "function") {
+          TikTokOpenSDK.share([payload.imageUri], true, false).catch((error) => {
+            options.onError?.(error);
+            void openSystemShareSheet(payload, id);
+          });
+          return { completed: true, channel: id };
+        }
+      } catch (error) {
+        options.onError?.(error);
+      }
+      return fallback(payload);
+    }
+  };
+};
+
+// src/channels/saveToLibrary.ts
+var saveToLibrary = (options = {}) => {
+  const id = options.id ?? "save";
+  return {
+    id,
+    isAvailable: async (payload) => Boolean(payload.imageUri),
+    share: async (payload) => {
+      if (!payload.imageUri) {
+        throw new Error("[rn-social-share] saveToLibrary requires payload.imageUri");
+      }
+      const MediaLibrary = __require("expo-media-library");
+      const current = await MediaLibrary.getPermissionsAsync(true);
+      let granted = current.granted;
+      if (!granted) {
+        const requested = await MediaLibrary.requestPermissionsAsync(true);
+        granted = requested.granted;
+      }
+      if (!granted) {
+        return { completed: false, channel: id, permissionDenied: true };
+      }
+      await MediaLibrary.saveToLibraryAsync(payload.imageUri);
+      return { completed: true, channel: id };
+    }
+  };
+};
+
+// src/react/useShareCard.ts
+import { useCallback, useRef } from "react";
+function useShareCard(options) {
+  const ref = useRef(null);
+  const { fileName, width, height, format, quality, onError } = options;
+  const capture = useCallback(
+    () => captureCardImage(ref, { fileName, width, height, format, quality, onError }),
+    [fileName, width, height, format, quality, onError]
+  );
+  return { ref, capture };
+}
+
+// src/react/useScreenshotTrigger.ts
+import { useEffect, useRef as useRef2 } from "react";
+
+// src/react/screenshotDebounce.ts
+var SCREENSHOT_DEBOUNCE_MS = 1e3;
+function shouldHandleScreenshot(lastHandledAt, now, windowMs = SCREENSHOT_DEBOUNCE_MS) {
+  if (lastHandledAt === null) {
+    return true;
+  }
+  return now - lastHandledAt >= windowMs;
+}
+function createScreenshotGate(windowMs = SCREENSHOT_DEBOUNCE_MS) {
+  let lastHandledAt = null;
+  return function tryHandleScreenshot(now) {
+    if (shouldHandleScreenshot(lastHandledAt, now, windowMs)) {
+      lastHandledAt = now;
+      return true;
+    }
+    return false;
+  };
+}
+var screenshotGate = createScreenshotGate();
+
+// src/react/useScreenshotTrigger.ts
+function useScreenshotTrigger(enabled, onScreenshot) {
+  const onScreenshotRef = useRef2(onScreenshot);
+  onScreenshotRef.current = onScreenshot;
+  useEffect(
+    function subscribeToScreenshots() {
+      if (!enabled) {
+        return;
+      }
+      let subscription;
+      try {
+        const { addScreenshotListener } = __require("expo-screen-capture");
+        subscription = addScreenshotListener(() => {
+          if (screenshotGate(Date.now())) {
+            onScreenshotRef.current();
+          }
+        });
+      } catch {
+      }
+      return () => subscription?.remove();
+    },
+    [enabled]
+  );
+}
+
+// src/react/imageReadiness.ts
+function areAllImagesLoaded(loaded, required) {
+  return required.every((key) => loaded.has(key));
+}
+export {
+  SCREENSHOT_DEBOUNCE_MS,
+  areAllImagesLoaded,
+  captureCardImage,
+  copyLink,
+  createScreenshotGate,
+  createSharer,
+  instagramStories,
+  openSystemShareSheet,
+  saveToLibrary,
+  screenshotGate,
+  shouldHandleScreenshot,
+  sms,
+  systemSheet,
+  tiktok,
+  useScreenshotTrigger,
+  useShareCard,
+  whatsapp
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/capture.ts","../src/createSharer.ts","../src/channels/_shareSheet.ts","../src/channels/systemSheet.ts","../src/channels/whatsapp.ts","../src/channels/copyLink.ts","../src/channels/instagramStories.ts","../src/channels/sms.ts","../src/channels/tiktok.ts","../src/channels/saveToLibrary.ts","../src/react/useShareCard.ts","../src/react/useScreenshotTrigger.ts","../src/react/screenshotDebounce.ts","../src/react/imageReadiness.ts"],"sourcesContent":["import { cacheDirectory, copyAsync, deleteAsync } from \"expo-file-system/legacy\";\nimport type { RefObject } from \"react\";\nimport { captureRef } from \"react-native-view-shot\";\n\nexport type CaptureOptions = {\n  /**\n   * Branded file name (with extension) the captured image is copied to, so every\n   * consumer — the share sheet, an SMS attachment, TikTok, the saved photo — shows a\n   * clean name (e.g. \"unchaind-invite.png\") instead of view-shot's random UUID.\n   */\n  fileName: string;\n  /** Output width in px. Default 1080 (story resolution at 3× of a 360pt card). */\n  width?: number;\n  /** Output height in px. Default 1920. */\n  height?: number;\n  /** Image format. Default \"png\". */\n  format?: \"png\" | \"jpg\";\n  /** 0..1. Default 1. */\n  quality?: number;\n  /** Called with the underlying error if capture fails (the function still resolves undefined). */\n  onError?: (error: unknown) => void;\n};\n\n/**\n * Captures an off-screen view (via its ref) to an image file at story resolution, then\n * copies it to a branded file name. Returns the file URI, or `undefined` on failure so\n * callers can fall back to a text-only share.\n *\n * This is the single, deduplicated version of the capture logic both apps had copied\n * verbatim. Extracted as a plain async function so it is testable without rendering.\n *\n * Note (ROC-2883): view-shot must not run until every async image in the card has\n * painted, or a late-loading image is absent from the file. Coordinate readiness with\n * `areAllImagesLoaded` before calling this.\n */\nexport async function captureCardImage(\n  ref: RefObject<unknown>,\n  options: CaptureOptions,\n): Promise<string | undefined> {\n  const { fileName, width = 1080, height = 1920, format = \"png\", quality = 1, onError } = options;\n  try {\n    // view-shot's temp file is managed and can't be moved reliably — copy it instead.\n    const tmpUri = await captureRef(ref as never, { format, quality, width, height });\n    const namedUri = `${cacheDirectory}${fileName}`;\n    await deleteAsync(namedUri, { idempotent: true });\n    await copyAsync({ from: tmpUri, to: namedUri });\n    return namedUri;\n  } catch (error) {\n    onError?.(error);\n    return undefined;\n  }\n}\n","import type {\n  CreateSharerOptions,\n  ShareChannel,\n  ShareEvent,\n  SharePayload,\n  ShareOutcome,\n  Sharer,\n} from \"./types\";\n\nconst DEFAULT_FALLBACK_ID = \"system-sheet\";\n\n/**\n * Builds a sharer from a list of channels. This is the abstraction layer between the app\n * and react-native-share / the OpenSDKs: the app only ever calls `sharer.share(id, payload)`\n * and adds/removes channels by editing the `channels` array.\n *\n * Routing per share:\n *   1. Emit `share_started`.\n *   2. Unknown id, or `isAvailable()` false/throws → `share_unavailable`, route to fallback.\n *   3. `share()` throws → `share_failed`, route to fallback.\n *   4. Emit `share_completed` with the channel that actually handled it.\n *\n * The fallback (default: the channel registered as \"system-sheet\") is never used to route\n * back into itself, so a missing/failed fallback yields a non-completed outcome instead of\n * looping.\n */\nexport function createSharer(options: CreateSharerOptions): Sharer {\n  const { channels, onEvent } = options;\n\n  const registry = new Map<string, ShareChannel>();\n  for (const channel of channels) {\n    if (registry.has(channel.id)) {\n      throw new Error(`[rn-social-share] Duplicate channel id \"${channel.id}\"`);\n    }\n    registry.set(channel.id, channel);\n  }\n\n  const fallbackId = options.fallbackChannelId ?? DEFAULT_FALLBACK_ID;\n  const fallbackChannel = registry.get(fallbackId);\n\n  const emit = (event: ShareEvent): void => {\n    try {\n      onEvent?.(event);\n    } catch {\n      // Analytics/logging must never break a share.\n    }\n  };\n\n  const emitCompleted = (outcome: ShareOutcome): void => {\n    emit({\n      type: \"share_completed\",\n      channel: outcome.channel,\n      fellBack: outcome.fellBack ?? false,\n      targetApp: outcome.targetApp,\n    });\n  };\n\n  const runFallback = async (requestedId: string, payload: SharePayload): Promise<ShareOutcome> => {\n    if (!fallbackChannel || fallbackChannel.id === requestedId) {\n      return { completed: false, channel: requestedId, fellBack: false };\n    }\n    try {\n      const outcome = await fallbackChannel.share(payload);\n      return { ...outcome, channel: fallbackChannel.id, fellBack: true };\n    } catch {\n      return { completed: false, channel: fallbackChannel.id, fellBack: true };\n    }\n  };\n\n  const share = async (channelId: string, payload: SharePayload): Promise<ShareOutcome> => {\n    emit({ type: \"share_started\", channel: channelId, hasImage: Boolean(payload.imageUri) });\n\n    const channel = registry.get(channelId);\n\n    let available = channel !== undefined;\n    if (channel) {\n      try {\n        available = await channel.isAvailable(payload);\n      } catch {\n        available = false;\n      }\n    }\n\n    if (!channel || !available) {\n      emit({ type: \"share_unavailable\", channel: channelId });\n      const outcome = await runFallback(channelId, payload);\n      emitCompleted(outcome);\n      return outcome;\n    }\n\n    try {\n      const outcome = await channel.share(payload);\n      emitCompleted(outcome);\n      return outcome;\n    } catch (error) {\n      emit({ type: \"share_failed\", channel: channelId, error });\n      const outcome = await runFallback(channelId, payload);\n      emitCompleted(outcome);\n      return outcome;\n    }\n  };\n\n  return {\n    channelIds: channels.map((channel) => channel.id),\n    has: (channelId) => registry.has(channelId),\n    isAvailable: async (channelId, payload) => {\n      const channel = registry.get(channelId);\n      if (!channel) {\n        return false;\n      }\n      try {\n        return await channel.isAvailable(payload);\n      } catch {\n        return false;\n      }\n    },\n    share,\n  };\n}\n","import Share from \"react-native-share\";\nimport type { ShareOutcome, SharePayload } from \"../types\";\n\ntype ShareOpenResult = { dismissedAction?: boolean; app?: string | null };\n\n/**\n * Opens the native OS share sheet with the image + caption + branded file name. Shared by\n * the `systemSheet` and `whatsapp` channels and used as the TikTok fallback. With\n * `failOnCancel: false`, a user cancel resolves (with `dismissedAction`) instead of throwing.\n */\nexport async function openSystemShareSheet(\n  payload: SharePayload,\n  channelId: string,\n): Promise<ShareOutcome> {\n  const result = (await Share.open({\n    message: payload.message,\n    url: payload.imageUri,\n    type: payload.imageUri ? \"image/png\" : undefined,\n    filename: payload.fileName,\n    failOnCancel: false,\n  })) as ShareOpenResult;\n\n  if (result?.dismissedAction) {\n    return { completed: false, channel: channelId };\n  }\n  return { completed: true, channel: channelId, targetApp: result?.app ?? null };\n}\n","import type { ShareChannel } from \"../types\";\nimport { openSystemShareSheet } from \"./_shareSheet\";\n\n/**\n * The generic native share sheet. Always available, so it doubles as the default fallback\n * (register it with the default id \"system-sheet\" to have `createSharer` pick it up).\n */\nexport const systemSheet = (options: { id?: string } = {}): ShareChannel => {\n  const id = options.id ?? \"system-sheet\";\n  return {\n    id,\n    isAvailable: async () => true,\n    share: (payload) => openSystemShareSheet(payload, id),\n  };\n};\n","import { Linking } from \"react-native\";\nimport type { ShareChannel } from \"../types\";\nimport { openSystemShareSheet } from \"./_shareSheet\";\n\nconst WHATSAPP_PROBE_URL = \"whatsapp://send\";\n\n/**\n * WhatsApp — intentionally routed through the system share sheet. iOS has no reliable\n * direct deep link that carries the full text AND an image: both `whatsapp://send?text=`\n * and `wa.me` drop everything but the URL on real devices, and RNShare's WhatsApp-text\n * path builds an invalid URL (literal spaces). The share sheet's WhatsApp extension is the\n * only dependable path. `isAvailable` still probes for the app so the UI can hide the\n * button when WhatsApp isn't installed.\n *\n * iOS: requires `whatsapp` in LSApplicationQueriesSchemes (see `withSocialShare`).\n */\nexport const whatsapp = (options: { id?: string } = {}): ShareChannel => {\n  const id = options.id ?? \"whatsapp\";\n  return {\n    id,\n    isAvailable: () => Linking.canOpenURL(WHATSAPP_PROBE_URL).catch(() => false),\n    share: (payload) => openSystemShareSheet(payload, id),\n  };\n};\n","import type { ShareChannel } from \"../types\";\n\n/**\n * Copies `payload.link` to the clipboard. Not a \"share\" in the OS sense, but modeled as a\n * channel so it slots into the same UI row and analytics funnel as everything else.\n *\n * `expo-clipboard` is a lazy require so importing the channel barrel never forces the\n * dependency on apps that don't use this channel.\n */\nexport const copyLink = (options: { id?: string } = {}): ShareChannel => {\n  const id = options.id ?? \"link\";\n  return {\n    id,\n    isAvailable: async (payload) => typeof payload.link === \"string\" && payload.link.length > 0,\n    share: async (payload) => {\n      if (!payload.link) {\n        return { completed: false, channel: id };\n      }\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const Clipboard = require(\"expo-clipboard\");\n      await Clipboard.setStringAsync(payload.link);\n      return { completed: true, channel: id };\n    },\n  };\n};\n","import { Linking } from \"react-native\";\nimport Share, { type ShareSingleOptions } from \"react-native-share\";\nimport type { ShareChannel } from \"../types\";\n\nconst INSTAGRAM_STORIES_URL = \"instagram-stories://share\";\n\n/**\n * Instagram Stories with the captured image as the full-bleed background.\n *\n * `appId` is required and app-specific — it is the Facebook/Meta App ID tied to your app\n * (mandatory for the Stories deep link since Jan 2023). Pass your own; the two apps that\n * seeded this package use different ids.\n *\n * iOS: requires `instagram-stories` in LSApplicationQueriesSchemes (see `withSocialShare`)\n * for `isAvailable` to detect Instagram. When unavailable, `createSharer` routes to the\n * fallback channel.\n */\nexport const instagramStories = (options: { appId: string; id?: string }): ShareChannel => {\n  const id = options.id ?? \"instagram\";\n  return {\n    id,\n    isAvailable: async (payload) => {\n      if (!payload.imageUri) {\n        return false;\n      }\n      return Linking.canOpenURL(INSTAGRAM_STORIES_URL).catch(() => false);\n    },\n    share: async (payload) => {\n      if (!payload.imageUri) {\n        throw new Error(\"[rn-social-share] instagramStories requires payload.imageUri\");\n      }\n      await Share.shareSingle({\n        social: Share.Social.INSTAGRAM_STORIES,\n        backgroundImage: payload.imageUri,\n        appId: options.appId,\n      } as ShareSingleOptions);\n      return { completed: true, channel: id };\n    },\n  };\n};\n","import Share, { type ShareSingleOptions } from \"react-native-share\";\nimport type { ShareChannel } from \"../types\";\n\n/**\n * Native SMS/Messages composer with the full text body and the card image attached.\n * `isAvailable` is optimistic (true); a device without SMS makes `shareSingle` throw, and\n * `createSharer` then routes to the fallback channel.\n */\nexport const sms = (options: { id?: string } = {}): ShareChannel => {\n  const id = options.id ?? \"messages\";\n  return {\n    id,\n    isAvailable: async () => true,\n    share: async (payload) => {\n      await Share.shareSingle({\n        social: Share.Social.SMS,\n        message: payload.message,\n        url: payload.imageUri,\n      } as ShareSingleOptions);\n      return { completed: true, channel: id };\n    },\n  };\n};\n","import type { ShareChannel } from \"../types\";\nimport { openSystemShareSheet } from \"./_shareSheet\";\n\nexport type TikTokChannelOptions = {\n  id?: string;\n  /** Called if the OpenSDK is missing or rejects (before falling back to the system sheet). */\n  onError?: (error: unknown) => void;\n};\n\n/**\n * TikTok via `tiktok-opensdk-react-native`, fire-and-forget. Opening TikTok IS the action —\n * we never await the SDK's result promise because, with no AppDelegate callback wired, it\n * may never settle. We report `completed` optimistically once the share is kicked off; a\n * *real* rejection (e.g. TikTok not installed) still routes to the system sheet so the user\n * can share.\n *\n * The SDK is a lazy require and optional: if it isn't installed, this channel simply falls\n * back to the system sheet. Native setup (client key, FileProvider, package visibility)\n * lives in the app's own TikTok config plugin — see the README.\n *\n * API (tiktok-opensdk-react-native@0.10.x): default export\n *   TikTokOpenSDK.share(mediaPaths: string[], isImage?: boolean, isGreenScreen?: boolean)\n */\nexport const tiktok = (options: TikTokChannelOptions = {}): ShareChannel => {\n  const id = options.id ?? \"tiktok\";\n\n  const fallback = (payload: Parameters<ShareChannel[\"share\"]>[0]) =>\n    openSystemShareSheet(payload, id).then((outcome) => ({ ...outcome, fellBack: true }));\n\n  return {\n    id,\n    isAvailable: async (payload) => Boolean(payload.imageUri),\n    share: async (payload) => {\n      if (!payload.imageUri) {\n        return fallback(payload);\n      }\n      try {\n        // eslint-disable-next-line @typescript-eslint/no-var-requires\n        const mod = require(\"tiktok-opensdk-react-native\");\n        const TikTokOpenSDK = mod?.default ?? mod;\n        if (TikTokOpenSDK && typeof TikTokOpenSDK.share === \"function\") {\n          // Fire-and-forget. Fall back only on a real rejection; the promise-never-settles\n          // case simply never runs `.catch`, which is the intended behavior.\n          TikTokOpenSDK.share([payload.imageUri], true, false).catch((error: unknown) => {\n            options.onError?.(error);\n            void openSystemShareSheet(payload, id);\n          });\n          return { completed: true, channel: id };\n        }\n      } catch (error) {\n        options.onError?.(error);\n      }\n      return fallback(payload);\n    },\n  };\n};\n","import type { ShareChannel } from \"../types\";\n\n/**\n * Saves the image to the device photo library via `expo-media-library` (add-only / write\n * permission, which avoids needing a full photo-library read description on iOS). Returns\n * `{ completed: false, permissionDenied: true }` when the user denies access, so the host UI\n * can show an \"open settings\" prompt.\n *\n * `expo-media-library` is a lazy require and optional — only apps that register this channel\n * need it installed.\n */\nexport const saveToLibrary = (options: { id?: string } = {}): ShareChannel => {\n  const id = options.id ?? \"save\";\n  return {\n    id,\n    isAvailable: async (payload) => Boolean(payload.imageUri),\n    share: async (payload) => {\n      if (!payload.imageUri) {\n        throw new Error(\"[rn-social-share] saveToLibrary requires payload.imageUri\");\n      }\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const MediaLibrary = require(\"expo-media-library\");\n      const current = await MediaLibrary.getPermissionsAsync(true);\n      let granted = current.granted;\n      if (!granted) {\n        const requested = await MediaLibrary.requestPermissionsAsync(true);\n        granted = requested.granted;\n      }\n      if (!granted) {\n        return { completed: false, channel: id, permissionDenied: true };\n      }\n      await MediaLibrary.saveToLibraryAsync(payload.imageUri);\n      return { completed: true, channel: id };\n    },\n  };\n};\n","import { useCallback, useRef } from \"react\";\nimport type { View } from \"react-native\";\nimport { captureCardImage, type CaptureOptions } from \"../capture\";\n\n/**\n * Headless capture hook: gives you a `ref` to attach to your off-screen card view and a\n * `capture()` that renders it to a branded image file (or `undefined` on failure).\n *\n * The card visual itself stays in the app — the package only captures whatever you point\n * the ref at. Render the card off-screen (e.g. `position: \"absolute\", left: -10000`) and\n * gate `capture()` on `areAllImagesLoaded` if the card has async images.\n *\n * Need two variants (e.g. rounded for the sheet, square full-bleed for Stories)? Call this\n * hook twice, or call `captureCardImage` directly with each ref.\n */\nexport function useShareCard(options: CaptureOptions) {\n  const ref = useRef<View>(null);\n  const { fileName, width, height, format, quality, onError } = options;\n\n  const capture = useCallback(\n    () => captureCardImage(ref, { fileName, width, height, format, quality, onError }),\n    [fileName, width, height, format, quality, onError],\n  );\n\n  return { ref, capture };\n}\n","import { useEffect, useRef } from \"react\";\nimport { screenshotGate } from \"./screenshotDebounce\";\n\n/**\n * Calls `onScreenshot` when the user takes a screenshot, while `enabled` is true — the\n * \"share on screenshot\" trigger from the Expo Marathon pattern. Dedup is enforced by a\n * shared, app-wide gate so one screenshot fires at most one handler even when iOS\n * double-fires or several instances are mounted (ROC-2854).\n *\n * No-ops silently where screenshot detection is unavailable (iOS supported; Android only\n * API 34+) or when `expo-screen-capture` isn't installed — the lazy require keeps that\n * dependency optional, and an explicit share button remains the fallback.\n */\nexport function useScreenshotTrigger(enabled: boolean, onScreenshot: () => void): void {\n  const onScreenshotRef = useRef(onScreenshot);\n  onScreenshotRef.current = onScreenshot;\n\n  useEffect(\n    function subscribeToScreenshots() {\n      if (!enabled) {\n        return;\n      }\n      let subscription: { remove: () => void } | undefined;\n      try {\n        // eslint-disable-next-line @typescript-eslint/no-var-requires\n        const { addScreenshotListener } = require(\"expo-screen-capture\");\n        subscription = addScreenshotListener(() => {\n          if (screenshotGate(Date.now())) {\n            onScreenshotRef.current();\n          }\n        });\n      } catch {\n        // Screenshot detection unavailable / module not installed — silent fail.\n      }\n      return () => subscription?.remove();\n    },\n    [enabled],\n  );\n}\n","export const SCREENSHOT_DEBOUNCE_MS = 1000;\n\nexport function shouldHandleScreenshot(\n  lastHandledAt: number | null,\n  now: number,\n  windowMs: number = SCREENSHOT_DEBOUNCE_MS,\n): boolean {\n  if (lastHandledAt === null) {\n    return true;\n  }\n  return now - lastHandledAt >= windowMs;\n}\n\n/**\n * A screenshot is a single OS-wide event, but one screenshot can reach a handler more than\n * once: iOS double-fires the notification, and release builds can mount more than one\n * `useScreenshotTrigger` instance (ROC-2854). A per-instance debounce can't dedupe across\n * instances. This gate holds the last-handled timestamp so that, no matter how many callers\n * react to the same screenshot, `gate(now)` returns `true` at most once per `windowMs`.\n *\n * The hook uses a single shared gate (`screenshotGate`); the factory exists so tests (and\n * apps that want isolation) get their own instance.\n */\nexport function createScreenshotGate(windowMs: number = SCREENSHOT_DEBOUNCE_MS) {\n  let lastHandledAt: number | null = null;\n  return function tryHandleScreenshot(now: number): boolean {\n    if (shouldHandleScreenshot(lastHandledAt, now, windowMs)) {\n      lastHandledAt = now;\n      return true;\n    }\n    return false;\n  };\n}\n\n/** Single app-wide screenshot gate shared by every `useScreenshotTrigger`. */\nexport const screenshotGate = createScreenshotGate();\n","/**\n * A shareable card often contains several asynchronously-loaded images (a fruit\n * illustration, a logo…). view-shot must not capture until every one has painted, or an\n * image that loads after the capture fires is absent from the file. This was ROC-2883: the\n * capture only awaited one image, so the logo was frequently missing from the export.\n *\n * Track loaded keys in a Set as each `<Image onLoad>` fires, then gate the capture on\n * `areAllImagesLoaded(loaded, REQUIRED_KEYS)`.\n */\nexport function areAllImagesLoaded(\n  loaded: ReadonlySet<string>,\n  required: readonly string[],\n): boolean {\n  return required.every((key) => loaded.has(key));\n}\n"],"mappings":"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","names":["Linking","Share","Share","useRef","useRef"]}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@rocapine/rn-social-share",
+  "version": "0.1.0",
+  "description": "Headless social-sharing engine for React Native / Expo apps: capture a view as an image and share it across modular channels (Instagram Stories, TikTok, WhatsApp, SMS, system sheet, save to library, copy link).",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Rocapine/rn-social-share.git"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./app.plugin.js": "./app.plugin.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "app.plugin.js"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "type": "tsc --noEmit",
+    "test": "jest",
+    "prepack": "npm run build"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-share": ">=12",
+    "react-native-view-shot": ">=4",
+    "expo-file-system": "*",
+    "expo-clipboard": "*",
+    "expo-media-library": "*",
+    "expo-screen-capture": "*",
+    "tiktok-opensdk-react-native": "*",
+    "@expo/config-plugins": "*"
+  },
+  "peerDependenciesMeta": {
+    "expo-clipboard": {
+      "optional": true
+    },
+    "expo-media-library": {
+      "optional": true
+    },
+    "expo-screen-capture": {
+      "optional": true
+    },
+    "tiktok-opensdk-react-native": {
+      "optional": true
+    },
+    "@expo/config-plugins": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/react": "*",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "tsup": "^8.3.5",
+    "typescript": "^5.4.0"
+  }
+}

package/src/capture.ts

@@ -0,0 +1,52 @@
+import { cacheDirectory, copyAsync, deleteAsync } from "expo-file-system/legacy";
+import type { RefObject } from "react";
+import { captureRef } from "react-native-view-shot";
+
+export type CaptureOptions = {
+  /**
+   * Branded file name (with extension) the captured image is copied to, so every
+   * consumer — the share sheet, an SMS attachment, TikTok, the saved photo — shows a
+   * clean name (e.g. "unchaind-invite.png") instead of view-shot's random UUID.
+   */
+  fileName: string;
+  /** Output width in px. Default 1080 (story resolution at 3× of a 360pt card). */
+  width?: number;
+  /** Output height in px. Default 1920. */
+  height?: number;
+  /** Image format. Default "png". */
+  format?: "png" | "jpg";
+  /** 0..1. Default 1. */
+  quality?: number;
+  /** Called with the underlying error if capture fails (the function still resolves undefined). */
+  onError?: (error: unknown) => void;
+};
+
+/**
+ * Captures an off-screen view (via its ref) to an image file at story resolution, then
+ * copies it to a branded file name. Returns the file URI, or `undefined` on failure so
+ * callers can fall back to a text-only share.
+ *
+ * This is the single, deduplicated version of the capture logic both apps had copied
+ * verbatim. Extracted as a plain async function so it is testable without rendering.
+ *
+ * Note (ROC-2883): view-shot must not run until every async image in the card has
+ * painted, or a late-loading image is absent from the file. Coordinate readiness with
+ * `areAllImagesLoaded` before calling this.
+ */
+export async function captureCardImage(
+  ref: RefObject<unknown>,
+  options: CaptureOptions,
+): Promise<string | undefined> {
+  const { fileName, width = 1080, height = 1920, format = "png", quality = 1, onError } = options;
+  try {
+    // view-shot's temp file is managed and can't be moved reliably — copy it instead.
+    const tmpUri = await captureRef(ref as never, { format, quality, width, height });
+    const namedUri = `${cacheDirectory}${fileName}`;
+    await deleteAsync(namedUri, { idempotent: true });
+    await copyAsync({ from: tmpUri, to: namedUri });
+    return namedUri;
+  } catch (error) {
+    onError?.(error);
+    return undefined;
+  }
+}

package/src/channels/_shareSheet.ts

@@ -0,0 +1,27 @@
+import Share from "react-native-share";
+import type { ShareOutcome, SharePayload } from "../types";
+
+type ShareOpenResult = { dismissedAction?: boolean; app?: string | null };
+
+/**
+ * Opens the native OS share sheet with the image + caption + branded file name. Shared by
+ * the `systemSheet` and `whatsapp` channels and used as the TikTok fallback. With
+ * `failOnCancel: false`, a user cancel resolves (with `dismissedAction`) instead of throwing.
+ */
+export async function openSystemShareSheet(
+  payload: SharePayload,
+  channelId: string,
+): Promise<ShareOutcome> {
+  const result = (await Share.open({
+    message: payload.message,
+    url: payload.imageUri,
+    type: payload.imageUri ? "image/png" : undefined,
+    filename: payload.fileName,
+    failOnCancel: false,
+  })) as ShareOpenResult;
+
+  if (result?.dismissedAction) {
+    return { completed: false, channel: channelId };
+  }
+  return { completed: true, channel: channelId, targetApp: result?.app ?? null };
+}

package/src/channels/copyLink.ts

@@ -0,0 +1,25 @@
+import type { ShareChannel } from "../types";
+
+/**
+ * Copies `payload.link` to the clipboard. Not a "share" in the OS sense, but modeled as a
+ * channel so it slots into the same UI row and analytics funnel as everything else.
+ *
+ * `expo-clipboard` is a lazy require so importing the channel barrel never forces the
+ * dependency on apps that don't use this channel.
+ */
+export const copyLink = (options: { id?: string } = {}): ShareChannel => {
+  const id = options.id ?? "link";
+  return {
+    id,
+    isAvailable: async (payload) => typeof payload.link === "string" && payload.link.length > 0,
+    share: async (payload) => {
+      if (!payload.link) {
+        return { completed: false, channel: id };
+      }
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const Clipboard = require("expo-clipboard");
+      await Clipboard.setStringAsync(payload.link);
+      return { completed: true, channel: id };
+    },
+  };
+};