@symbiote-native/sharing 3.0.2 → 3.0.4

package/build-ngc/angular/inject-incoming-share.js

@@ -0,0 +1,6 @@
+import { computed } from '@angular/core';
+import { createEventValueHook } from '@symbiote-native/angular';
+import { createIncomingShareHook } from '../core/incoming-share-hook';
+/** Angular twin of `expo-sharing`'s `useIncomingShare`, call it in an injection context */
+export const injectIncomingShare = createIncomingShareHook(createEventValueHook, box => box(), computed);
+//# sourceMappingURL=inject-incoming-share.js.map

package/build-ngc/angular/inject-incoming-share.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-incoming-share.js","sourceRoot":"","sources":["../../src/angular/inject-incoming-share.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAe,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAMtE,2FAA2F;AAC3F,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CAGxD,oBAAoB,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC"}

package/build-ngc/core/incoming-share-hook.d.ts

@@ -0,0 +1,4 @@
+import { INCOMING_SHARE_CHANGE } from './incoming-share-store';
+import type { IIncomingShareStore } from './incoming-share-store';
+import type { IIncomingShareSnapshot, IUseIncomingShareResult } from './types';
+export declare function createIncomingShareHook<TSnapshotBox, TResultBox>(createEventValueHook: (event: typeof INCOMING_SHARE_CHANGE, getValue: (store: IIncomingShareStore) => IIncomingShareSnapshot) => (getSource: () => IIncomingShareStore) => TSnapshotBox, readBox: (box: TSnapshotBox) => IIncomingShareSnapshot, derive: (compute: () => IUseIncomingShareResult) => TResultBox): () => TResultBox;

package/build-ngc/core/incoming-share-hook.js

@@ -0,0 +1,14 @@
+import { createIncomingShareStore, INCOMING_SHARE_CHANGE, } from './incoming-share-store';
+import { withShareActions } from './incoming-share-result';
+// Getter-shaped `useIncomingShare` for the adapters whose event-value hook takes a source getter
+// (Vue, Solid, Svelte, Angular). `readBox` unwraps that adapter's reactive box and `derive` wraps
+// the result in its own computed, React keeps its own wiring since it passes the source directly
+export function createIncomingShareHook(createEventValueHook, readBox, derive) {
+    const useShareSnapshot = createEventValueHook(INCOMING_SHARE_CHANGE, store => store.getSnapshot());
+    return function useIncomingShare() {
+        const store = createIncomingShareStore();
+        const snapshotBox = useShareSnapshot(() => store);
+        return derive(() => withShareActions(readBox(snapshotBox), store));
+    };
+}
+//# sourceMappingURL=incoming-share-hook.js.map

package/build-ngc/core/incoming-share-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incoming-share-hook.js","sourceRoot":"","sources":["../../src/core/incoming-share-hook.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAI3D,iGAAiG;AACjG,kGAAkG;AAClG,iGAAiG;AACjG,MAAM,UAAU,uBAAuB,CACrC,oBAG2D,EAC3D,OAAsD,EACtD,MAA8D;IAE9D,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAC3E,KAAK,CAAC,WAAW,EAAE,CACpB,CAAC;IACF,OAAO,SAAS,gBAAgB;QAC9B,MAAM,KAAK,GAAG,wBAAwB,EAAE,CAAC;QACzC,MAAM,WAAW,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAClD,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC;AACJ,CAAC"}

package/build-ngc/core/incoming-share-result.d.ts

@@ -0,0 +1,3 @@
+import type { IIncomingShareStore } from './incoming-share-store';
+import type { IIncomingShareSnapshot, IUseIncomingShareResult } from './types';
+export declare function withShareActions(snapshot: IIncomingShareSnapshot, store: IIncomingShareStore): IUseIncomingShareResult;

package/build-ngc/core/incoming-share-result.js

@@ -0,0 +1,12 @@
+// Every adapter's `useIncomingShare` reports its own reactive snapshot, the two actions come
+// from the store so they are written once
+export function withShareActions(snapshot, store) {
+    return {
+        ...snapshot,
+        clearSharedPayloads: store.clear,
+        refreshSharePayloads: () => {
+            void store.refresh();
+        },
+    };
+}
+//# sourceMappingURL=incoming-share-result.js.map

package/build-ngc/core/incoming-share-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incoming-share-result.js","sourceRoot":"","sources":["../../src/core/incoming-share-result.ts"],"names":[],"mappings":"AAGA,6FAA6F;AAC7F,0CAA0C;AAC1C,MAAM,UAAU,gBAAgB,CAC9B,QAAgC,EAChC,KAA0B;IAE1B,OAAO;QACL,GAAG,QAAQ;QACX,mBAAmB,EAAE,KAAK,CAAC,KAAK;QAChC,oBAAoB,EAAE,GAAG,EAAE;YACzB,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/build-ngc/core/incoming-share-store.d.ts

@@ -0,0 +1,9 @@
+import type { IEventValueSource } from '@symbiote-native/engine';
+import type { IIncomingShareSnapshot } from './types';
+export declare const INCOMING_SHARE_CHANGE = "change";
+export type IIncomingShareStore = IEventValueSource<IIncomingShareSnapshot, typeof INCOMING_SHARE_CHANGE> & {
+    getSnapshot: () => IIncomingShareSnapshot;
+    refresh: () => Promise<void>;
+    clear: () => void;
+};
+export declare function createIncomingShareStore(): IIncomingShareStore;

package/build-ngc/core/incoming-share-store.js

@@ -0,0 +1,101 @@
+import { AppState } from '@symbiote-native/engine';
+import { clearSharedPayloads, getResolvedSharedPayloadsAsync, getSharedPayloads, } from './sharing';
+export const INCOMING_SHARE_CHANGE = 'change';
+// Multiset comparison, so the same payloads in another order do not trigger a re-resolve
+function sharePayloadsAreEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    const counts = new Map();
+    const keyOf = (item) => `${item.value}|${item.mimeType}|${item.shareType}`;
+    for (const item of a)
+        counts.set(keyOf(item), (counts.get(keyOf(item)) ?? 0) + 1);
+    for (const item of b) {
+        const count = counts.get(keyOf(item));
+        if (!count)
+            return false;
+        counts.set(keyOf(item), count - 1);
+    }
+    return true;
+}
+function toError(cause, fallbackMessage) {
+    return cause instanceof Error ? cause : new Error(fallbackMessage);
+}
+export function createIncomingShareStore() {
+    let snapshot = {
+        sharedPayloads: getSharedPayloads(),
+        resolvedSharedPayloads: [],
+        isResolving: false,
+        error: null,
+    };
+    // Starts empty, not at the first snapshot, so a first refresh with data always resolves it
+    let lastRefreshed = [];
+    const listeners = new Set();
+    let appStateSubscription = null;
+    function update(patch) {
+        snapshot = { ...snapshot, ...patch };
+        for (const listener of listeners)
+            listener(snapshot);
+    }
+    async function resolvePayloads() {
+        update({ isResolving: true });
+        try {
+            update({
+                resolvedSharedPayloads: await getResolvedSharedPayloadsAsync(),
+            });
+        }
+        catch (cause) {
+            update({
+                error: toError(cause, 'Unknown error during shared payload resolution'),
+            });
+        }
+        finally {
+            update({ isResolving: false });
+        }
+    }
+    async function refresh() {
+        try {
+            const next = getSharedPayloads();
+            // Skip the resolve when nothing changed, it can cost a network round trip
+            if (sharePayloadsAreEqual(next, lastRefreshed))
+                return;
+            lastRefreshed = next;
+            update({ sharedPayloads: next, resolvedSharedPayloads: [], error: null });
+            if (next.length > 0)
+                await resolvePayloads();
+        }
+        catch (cause) {
+            update({ error: toError(cause, 'Failed to resolve data') });
+        }
+    }
+    function start() {
+        void refresh();
+        appStateSubscription = AppState.addEventListener('change', status => {
+            if (status === 'active')
+                void refresh();
+        });
+    }
+    function stop() {
+        appStateSubscription?.remove();
+        appStateSubscription = null;
+    }
+    return {
+        getSnapshot: () => snapshot,
+        refresh,
+        clear: clearSharedPayloads,
+        addListener(_event, listener) {
+            const wasIdle = listeners.size === 0;
+            listeners.add(listener);
+            // After `add`, so the first refresh's synchronous update reaches this listener
+            if (wasIdle)
+                start();
+            return {
+                remove: () => {
+                    listeners.delete(listener);
+                    if (listeners.size === 0)
+                        stop();
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=incoming-share-store.js.map

package/build-ngc/core/incoming-share-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incoming-share-store.js","sourceRoot":"","sources":["../../src/core/incoming-share-store.ts"],"names":[],"mappings":"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"}

package/build-ngc/core/index.d.ts

@@ -1,2 +1,5 @@
-export { isAvailableAsync, shareAsync } from './sharing';
-export type { ISharingAnchor, ISharingOptions } from './types';
+export { clearSharedPayloads, getResolvedSharedPayloadsAsync, getSharedPayloads, isAvailableAsync, shareAsync, } from './sharing';
+export { createIncomingShareStore, INCOMING_SHARE_CHANGE, } from './incoming-share-store';
+export type { IIncomingShareStore } from './incoming-share-store';
+export { withShareActions } from './incoming-share-result';
+export type { IBaseResolvedSharePayload, IContentType, IIncomingShareSnapshot, IResolvedSharePayload, IShareType, ISharePayload, ISharingAnchor, ISharingOptions, ITextBasedResolvedSharePayload, IUriBasedResolvedSharePayload, IUseIncomingShareResult, } from './types';

package/build-ngc/core/index.js

@@ -1,2 +1,4 @@
-export { isAvailableAsync, shareAsync } from './sharing';
+export { clearSharedPayloads, getResolvedSharedPayloadsAsync, getSharedPayloads, isAvailableAsync, shareAsync, } from './sharing';
+export { createIncomingShareStore, INCOMING_SHARE_CHANGE, } from './incoming-share-store';
+export { withShareActions } from './incoming-share-result';
 //# sourceMappingURL=index.js.map

package/build-ngc/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/build-ngc/core/native-module.d.ts

@@ -1,6 +1,9 @@
-import type { ISharingOptions } from './types';
+import type { IResolvedSharePayload, ISharePayload, ISharingOptions } from './types';
 export type INativeSharingModule = {
     isAvailableAsync?(): Promise<boolean>;
     shareAsync?(url: string, options: ISharingOptions): Promise<void>;
+    getSharedPayloads?(): ISharePayload[];
+    getResolvedSharedPayloadsAsync?(): Promise<IResolvedSharePayload[]>;
+    clearSharedPayloads?(): void;
 };
 export declare const expoSharing: INativeSharingModule;

package/build-ngc/core/native-module.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../../src/core/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,wBAAwB,GAAG,aAAa,CAAC;AAkB/C,MAAM,CAAC,MAAM,WAAW,GAAG,mBAAmB,CAC5C,wBAAwB,CACzB,CAAC"}
+{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../../src/core/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAOxD,MAAM,wBAAwB,GAAG,aAAa,CAAC;AAoB/C,MAAM,CAAC,MAAM,WAAW,GAAG,mBAAmB,CAC5C,wBAAwB,CACzB,CAAC"}

package/build-ngc/core/sharing.d.ts

@@ -1,4 +1,4 @@
-import type { ISharingOptions } from './types';
+import type { IResolvedSharePayload, ISharePayload, ISharingOptions } from './types';
 /**
  * Whether the share sheet can be opened on this device. Resolves `true` on Android and iOS.
  *
@@ -16,3 +16,6 @@ export declare function isAvailableAsync(): Promise<boolean>;
  * platform reports which app received the file, so a resolved promise is not a delivery receipt.
  */
 export declare function shareAsync(url: string, options?: ISharingOptions): Promise<void>;
+export declare function getSharedPayloads(): ISharePayload[];
+export declare function getResolvedSharedPayloadsAsync(): Promise<IResolvedSharePayload[]>;
+export declare function clearSharedPayloads(): void;

package/build-ngc/core/sharing.js

@@ -29,6 +29,26 @@ export async function shareAsync(url, options = {}) {
     }
     await expoSharing.shareAsync(url, options);
 }
+// Empty until the host app carries the share target (iOS Share Extension, Android intent filters)
+export function getSharedPayloads() {
+    if (!expoSharing.getSharedPayloads) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getSharedPayloads');
+    }
+    return expoSharing.getSharedPayloads();
+}
+// Adds display details per payload, resolving a shared URL may need the network
+export async function getResolvedSharedPayloadsAsync() {
+    if (!expoSharing.getResolvedSharedPayloadsAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getResolvedSharedPayloadsAsync');
+    }
+    return expoSharing.getResolvedSharedPayloadsAsync();
+}
+export function clearSharedPayloads() {
+    if (!expoSharing.clearSharedPayloads) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'clearSharedPayloads');
+    }
+    expoSharing.clearSharedPayloads();
+}
 // Not in upstream, which hands anything straight to the native module. An empty or non-string
 // url surfaces there as an argument-conversion failure on iOS and a generic "Failed to share the
 // file" on Android — both far enough from the call site to be worth failing early with the

package/build-ngc/core/sharing.js.map

@@ -1 +1 @@
-{"version":3,"file":"sharing.js","sourceRoot":"","sources":["../../src/core/sharing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,WAAW,CAAC,gBAAgB,EAAE,CAAC;QACjC,OAAO,WAAW,CAAC,gBAAgB,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC;AAClC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAW,EACX,UAA2B,EAAE;IAE7B,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;QAC5B,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,WAAW,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,8FAA8F;AAC9F,iGAAiG;AACjG,2FAA2F;AAC3F,+BAA+B;AAC/B,SAAS,kBAAkB,CAAC,GAAW;IACrC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"sharing.js","sourceRoot":"","sources":["../../src/core/sharing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAO9C,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,WAAW,CAAC,gBAAgB,EAAE,CAAC;QACjC,OAAO,WAAW,CAAC,gBAAgB,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC;AAClC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAW,EACX,UAA2B,EAAE;IAE7B,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;QAC5B,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,WAAW,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC;QACnC,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,WAAW,CAAC,iBAAiB,EAAE,CAAC;AACzC,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,8BAA8B;IAGlD,IAAI,CAAC,WAAW,CAAC,8BAA8B,EAAE,CAAC;QAChD,MAAM,IAAI,mBAAmB,CAC3B,kBAAkB,EAClB,gCAAgC,CACjC,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC,8BAA8B,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC,WAAW,CAAC,mBAAmB,EAAE,CAAC;QACrC,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;IAC3E,CAAC;IACD,WAAW,CAAC,mBAAmB,EAAE,CAAC;AACpC,CAAC;AAED,8FAA8F;AAC9F,iGAAiG;AACjG,2FAA2F;AAC3F,+BAA+B;AAC/B,SAAS,kBAAkB,CAAC,GAAW;IACrC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/build-ngc/core/types.d.ts

@@ -36,3 +36,44 @@ export type ISharingOptions = {
      */
     anchor?: ISharingAnchor;
 };
+export type IShareType = 'text' | 'url' | 'audio' | 'image' | 'video' | 'file';
+export type IContentType = 'text' | 'audio' | 'image' | 'video' | 'file' | 'website';
+/** Raw data shared with the app (android, ios) */
+export type ISharePayload = {
+    /** Message body for `text`, the URL for `url`, otherwise typically the file URI */
+    value: string;
+    shareType: IShareType;
+    /** MIME type of `value` */
+    mimeType?: string;
+};
+export type IBaseResolvedSharePayload = ISharePayload & {
+    /** Where the content can be read from (the redirect target for a URL), null for text */
+    contentUri: string | null;
+    contentType: IContentType | null;
+    contentMimeType: string | null;
+    /** The `suggestedFilename` HTTP header if present, otherwise the last path component */
+    originalName: string | null;
+    contentSize: number | null;
+};
+export type IUriBasedResolvedSharePayload = IBaseResolvedSharePayload & {
+    contentType: 'audio' | 'file' | 'video' | 'image' | 'website';
+    contentUri: string;
+};
+export type ITextBasedResolvedSharePayload = IBaseResolvedSharePayload & {
+    contentType?: 'text';
+};
+/** A payload plus the details needed to display it, resolving a URL may need the network */
+export type IResolvedSharePayload = IUriBasedResolvedSharePayload | ITextBasedResolvedSharePayload;
+export type IIncomingShareSnapshot = {
+    /** Unresolved payloads, available synchronously from the first read */
+    sharedPayloads: ISharePayload[];
+    /** Empty while resolving or when resolving failed */
+    resolvedSharedPayloads: IResolvedSharePayload[];
+    isResolving: boolean;
+    /** The error hit while resolving, null on success */
+    error: Error | null;
+};
+export type IUseIncomingShareResult = IIncomingShareSnapshot & {
+    clearSharedPayloads: () => void;
+    refreshSharePayloads: () => void;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/sharing",
-  "version": "3.0.2",
+  "version": "3.0.4",
   "description": "expo-sharing wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Opens the platform share sheet for a local file.",
   "license": "MIT",
   "keywords": [
@@ -35,20 +35,20 @@
       "default": "./build/core/index.js"
     },
     "./vue": {
-      "types": "./build/core/index.d.ts",
-      "default": "./build/core/index.js"
+      "types": "./build/vue/index.d.ts",
+      "default": "./build/vue/index.js"
     },
     "./react": {
-      "types": "./build/core/index.d.ts",
-      "default": "./build/core/index.js"
+      "types": "./build/react/index.d.ts",
+      "default": "./build/react/index.js"
     },
     "./svelte": {
-      "types": "./build/core/index.d.ts",
-      "default": "./build/core/index.js"
+      "types": "./build/svelte/index.d.ts",
+      "default": "./build/svelte/index.js"
     },
     "./solid": {
-      "types": "./build/core/index.d.ts",
-      "default": "./build/core/index.js"
+      "types": "./build/solid/index.d.ts",
+      "default": "./build/solid/index.js"
     },
     "./angular": {
       "types": "./build-ngc/angular/index.d.ts",
@@ -70,7 +70,7 @@
   },
   "dependencies": {
     "expo-sharing": "57.0.8",
-    "expo-modules-core": "57.0.5"
+    "expo-modules-core": "57.0.20"
   },
   "peerDependencies": {
     "@angular/core": ">=20",
@@ -80,12 +80,12 @@
     "solid-js": ">=1.9.0",
     "svelte": ">=5.56.0",
     "vue": ">=3.5.0",
-    "@symbiote-native/angular": "^3.1.2",
-    "@symbiote-native/engine": "^1.3.1",
-    "@symbiote-native/react": "^3.0.4",
-    "@symbiote-native/solid": "^3.0.4",
-    "@symbiote-native/svelte": "^3.0.4",
-    "@symbiote-native/vue": "^3.0.4"
+    "@symbiote-native/angular": "^3.3.0",
+    "@symbiote-native/engine": "^1.6.0",
+    "@symbiote-native/react": "^3.3.0",
+    "@symbiote-native/solid": "^3.2.0",
+    "@symbiote-native/svelte": "^3.2.0",
+    "@symbiote-native/vue": "^3.3.0"
   },
   "peerDependenciesMeta": {
     "@symbiote-native/angular": {
@@ -133,13 +133,13 @@
     "solid-js": "^1.9.14",
     "svelte": "^5.56.0",
     "typescript": "~6.0.0",
-    "@symbiote-native/angular": "3.1.2",
-    "@symbiote-native/engine": "1.3.1",
-    "@symbiote-native/react": "3.0.4",
-    "@symbiote-native/solid": "3.0.4",
-    "@symbiote-native/svelte": "3.0.4",
-    "@symbiote-native/test-utils": "0.4.4",
-    "@symbiote-native/vue": "3.0.4"
+    "@symbiote-native/angular": "3.3.0",
+    "@symbiote-native/engine": "1.6.0",
+    "@symbiote-native/react": "3.3.0",
+    "@symbiote-native/solid": "3.2.0",
+    "@symbiote-native/svelte": "3.2.0",
+    "@symbiote-native/test-utils": "0.4.7",
+    "@symbiote-native/vue": "3.3.0"
   },
   "scripts": {
     "typecheck": "tsc --build",

package/src/angular/index.ts

@@ -1,4 +1,2 @@
-// @symbiote-native/sharing/angular: the Angular entry over the framework-agnostic core. Same
-// reasoning as the React/Vue entries — no per-instance state or event stream to wrap in a
-// service, so this is a plain re-export.
 export * from '../core';
+export { injectIncomingShare } from './inject-incoming-share';

package/src/angular/inject-incoming-share.ts

@@ -0,0 +1,13 @@
+import { computed, type Signal } from '@angular/core';
+import { createEventValueHook } from '@symbiote-native/angular';
+import { createIncomingShareHook } from '../core/incoming-share-hook';
+import type {
+  IIncomingShareSnapshot,
+  IUseIncomingShareResult,
+} from '../core/types';
+
+/** Angular twin of `expo-sharing`'s `useIncomingShare`, call it in an injection context */
+export const injectIncomingShare = createIncomingShareHook<
+  Signal<IIncomingShareSnapshot>,
+  Signal<IUseIncomingShareResult>
+>(createEventValueHook, box => box(), computed);

package/src/core/incoming-share-hook.ts

@@ -0,0 +1,28 @@
+import {
+  createIncomingShareStore,
+  INCOMING_SHARE_CHANGE,
+} from './incoming-share-store';
+import { withShareActions } from './incoming-share-result';
+import type { IIncomingShareStore } from './incoming-share-store';
+import type { IIncomingShareSnapshot, IUseIncomingShareResult } from './types';
+
+// Getter-shaped `useIncomingShare` for the adapters whose event-value hook takes a source getter
+// (Vue, Solid, Svelte, Angular). `readBox` unwraps that adapter's reactive box and `derive` wraps
+// the result in its own computed, React keeps its own wiring since it passes the source directly
+export function createIncomingShareHook<TSnapshotBox, TResultBox>(
+  createEventValueHook: (
+    event: typeof INCOMING_SHARE_CHANGE,
+    getValue: (store: IIncomingShareStore) => IIncomingShareSnapshot,
+  ) => (getSource: () => IIncomingShareStore) => TSnapshotBox,
+  readBox: (box: TSnapshotBox) => IIncomingShareSnapshot,
+  derive: (compute: () => IUseIncomingShareResult) => TResultBox,
+): () => TResultBox {
+  const useShareSnapshot = createEventValueHook(INCOMING_SHARE_CHANGE, store =>
+    store.getSnapshot(),
+  );
+  return function useIncomingShare(): TResultBox {
+    const store = createIncomingShareStore();
+    const snapshotBox = useShareSnapshot(() => store);
+    return derive(() => withShareActions(readBox(snapshotBox), store));
+  };
+}

package/src/core/incoming-share-result.ts

@@ -0,0 +1,17 @@
+import type { IIncomingShareStore } from './incoming-share-store';
+import type { IIncomingShareSnapshot, IUseIncomingShareResult } from './types';
+
+// Every adapter's `useIncomingShare` reports its own reactive snapshot, the two actions come
+// from the store so they are written once
+export function withShareActions(
+  snapshot: IIncomingShareSnapshot,
+  store: IIncomingShareStore,
+): IUseIncomingShareResult {
+  return {
+    ...snapshot,
+    clearSharedPayloads: store.clear,
+    refreshSharePayloads: () => {
+      void store.refresh();
+    },
+  };
+}

package/src/core/incoming-share-store.ts

@@ -0,0 +1,118 @@
+import { AppState } from '@symbiote-native/engine';
+import type { IEventValueSource } from '@symbiote-native/engine';
+import {
+  clearSharedPayloads,
+  getResolvedSharedPayloadsAsync,
+  getSharedPayloads,
+} from './sharing';
+import type { IIncomingShareSnapshot, ISharePayload } from './types';
+
+export const INCOMING_SHARE_CHANGE = 'change';
+
+export type IIncomingShareStore = IEventValueSource<
+  IIncomingShareSnapshot,
+  typeof INCOMING_SHARE_CHANGE
+> & {
+  getSnapshot: () => IIncomingShareSnapshot;
+  refresh: () => Promise<void>;
+  clear: () => void;
+};
+
+// Multiset comparison, so the same payloads in another order do not trigger a re-resolve
+function sharePayloadsAreEqual(
+  a: ISharePayload[],
+  b: ISharePayload[],
+): boolean {
+  if (a.length !== b.length) return false;
+  const counts = new Map<string, number>();
+  const keyOf = (item: ISharePayload): string =>
+    `${item.value}|${item.mimeType}|${item.shareType}`;
+  for (const item of a)
+    counts.set(keyOf(item), (counts.get(keyOf(item)) ?? 0) + 1);
+  for (const item of b) {
+    const count = counts.get(keyOf(item));
+    if (!count) return false;
+    counts.set(keyOf(item), count - 1);
+  }
+  return true;
+}
+
+function toError(cause: unknown, fallbackMessage: string): Error {
+  return cause instanceof Error ? cause : new Error(fallbackMessage);
+}
+
+export function createIncomingShareStore(): IIncomingShareStore {
+  let snapshot: IIncomingShareSnapshot = {
+    sharedPayloads: getSharedPayloads(),
+    resolvedSharedPayloads: [],
+    isResolving: false,
+    error: null,
+  };
+  // Starts empty, not at the first snapshot, so a first refresh with data always resolves it
+  let lastRefreshed: ISharePayload[] = [];
+  const listeners = new Set<(next: IIncomingShareSnapshot) => void>();
+  let appStateSubscription: { remove: () => void } | null = null;
+
+  function update(patch: Partial<IIncomingShareSnapshot>): void {
+    snapshot = { ...snapshot, ...patch };
+    for (const listener of listeners) listener(snapshot);
+  }
+
+  async function resolvePayloads(): Promise<void> {
+    update({ isResolving: true });
+    try {
+      update({
+        resolvedSharedPayloads: await getResolvedSharedPayloadsAsync(),
+      });
+    } catch (cause) {
+      update({
+        error: toError(cause, 'Unknown error during shared payload resolution'),
+      });
+    } finally {
+      update({ isResolving: false });
+    }
+  }
+
+  async function refresh(): Promise<void> {
+    try {
+      const next = getSharedPayloads();
+      // Skip the resolve when nothing changed, it can cost a network round trip
+      if (sharePayloadsAreEqual(next, lastRefreshed)) return;
+      lastRefreshed = next;
+      update({ sharedPayloads: next, resolvedSharedPayloads: [], error: null });
+      if (next.length > 0) await resolvePayloads();
+    } catch (cause) {
+      update({ error: toError(cause, 'Failed to resolve data') });
+    }
+  }
+
+  function start(): void {
+    void refresh();
+    appStateSubscription = AppState.addEventListener('change', status => {
+      if (status === 'active') void refresh();
+    });
+  }
+
+  function stop(): void {
+    appStateSubscription?.remove();
+    appStateSubscription = null;
+  }
+
+  return {
+    getSnapshot: () => snapshot,
+    refresh,
+    clear: clearSharedPayloads,
+    addListener(_event, listener) {
+      const wasIdle = listeners.size === 0;
+      listeners.add(listener);
+      // After `add`, so the first refresh's synchronous update reaches this listener
+      if (wasIdle) start();
+      return {
+        remove: () => {
+          listeners.delete(listener);
+          if (listeners.size === 0) stop();
+        },
+      };
+    },
+  };
+}

package/src/core/index.ts

@@ -1,2 +1,26 @@
-export { isAvailableAsync, shareAsync } from './sharing';
-export type { ISharingAnchor, ISharingOptions } from './types';
+export {
+  clearSharedPayloads,
+  getResolvedSharedPayloadsAsync,
+  getSharedPayloads,
+  isAvailableAsync,
+  shareAsync,
+} from './sharing';
+export {
+  createIncomingShareStore,
+  INCOMING_SHARE_CHANGE,
+} from './incoming-share-store';
+export type { IIncomingShareStore } from './incoming-share-store';
+export { withShareActions } from './incoming-share-result';
+export type {
+  IBaseResolvedSharePayload,
+  IContentType,
+  IIncomingShareSnapshot,
+  IResolvedSharePayload,
+  IShareType,
+  ISharePayload,
+  ISharingAnchor,
+  ISharingOptions,
+  ITextBasedResolvedSharePayload,
+  IUriBasedResolvedSharePayload,
+  IUseIncomingShareResult,
+} from './types';

package/src/core/native-module.ts

@@ -1,5 +1,9 @@
 import { requireNativeModule } from 'expo-modules-core';
-import type { ISharingOptions } from './types';
+import type {
+  IResolvedSharePayload,
+  ISharePayload,
+  ISharingOptions,
+} from './types';
 
 const EXPO_SHARING_MODULE_NAME = 'ExpoSharing';
 
@@ -11,12 +15,14 @@ const EXPO_SHARING_MODULE_NAME = 'ExpoSharing';
 // the web module (which this package does not ship) defines it. Presence of the module itself is
 // therefore what availability is read from — see isAvailableAsync in ./sharing.
 //
-// The incoming-share methods (getSharedPayloads, getResolvedSharedPayloadsAsync,
-// clearSharedPayloads) are deliberately absent from this type: reaching them needs an iOS Share
-// Extension target this package does not ship. See the README.
+// The incoming-share methods exist on the native module, but return data only once the host app
+// carries the share target (iOS Share Extension, Android intent filters), see the README
 export type INativeSharingModule = {
   isAvailableAsync?(): Promise<boolean>;
   shareAsync?(url: string, options: ISharingOptions): Promise<void>;
+  getSharedPayloads?(): ISharePayload[];
+  getResolvedSharedPayloadsAsync?(): Promise<IResolvedSharePayload[]>;
+  clearSharedPayloads?(): void;
 };
 
 export const expoSharing = requireNativeModule<INativeSharingModule>(