react-native-advanced-share-intent 1.0.0

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "react-native-advanced-share-intent",
+  "version": "1.0.0",
+  "description": "Lightweight React Native share intent handling for Android and iOS share extensions.",
+  "main": "index.js",
+  "module": "index.mjs",
+  "types": "index.d.ts",
+  "react-native": "src/index.ts",
+  "source": "src/index.ts",
+  "files": [
+    "android/build.gradle",
+    "android/src",
+    "ios",
+    "src",
+    "index.d.ts",
+    "index.js",
+    "index.mjs",
+    "react-native.config.js",
+    "react-native-advanced-share-intent.podspec",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc --noEmit",
+    "lint": "tsc --noEmit --pretty false",
+    "test": "npm run typecheck",
+    "typecheck": "tsc --noEmit",
+    "prepare": "npm run build",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "react-native",
+    "share",
+    "share-intent",
+    "android",
+    "ios",
+    "share-extension",
+    "files",
+    "mime",
+    "typescript",
+    "share-sheet"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/engr-touqeer/react-native-advanced-share-intent.git"
+  },
+  "homepage": "https://github.com/engr-touqeer/react-native-advanced-share-intent#readme",
+  "bugs": {
+    "url": "https://github.com/engr-touqeer/react-native-advanced-share-intent/issues"
+  },
+  "author": "Touqeer Ahmed",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": ">=18.2.0",
+    "react-native": ">=0.72.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.25.2",
+    "@types/react": "^19.2.0",
+    "react": "19.2.3",
+    "react-native": "0.84.1",
+    "typescript": "^5.8.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/react-native-advanced-share-intent.podspec

@@ -0,0 +1,18 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name         = 'react-native-advanced-share-intent'
+  s.version      = package['version']
+  s.summary      = package['description']
+  s.license      = package['license']
+  s.authors      = package['author']
+  s.homepage     = package['homepage']
+  s.source       = { :git => package['repository']['url'], :tag => "#{s.version}" }
+  s.module_name  = 'AdvancedShareIntent'
+  s.platforms    = { :ios => '13.0' }
+  s.source_files = 'ios/**/*.{h,m,mm,swift}'
+  s.requires_arc = true
+  s.dependency 'React-Core'
+end

package/react-native.config.js

@@ -0,0 +1,9 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      android: {
+        sourceDir: './android',
+      }
+    },
+  },
+};

package/src/index.d.ts

@@ -0,0 +1,44 @@
+import type { EmitterSubscription } from 'react-native';
+
+export type ShareIntentType = 'text' | 'image' | 'video' | 'document' | 'unknown';
+
+export type SharedFile = {
+  uri: string;
+  fileName?: string;
+  name?: string;
+  mimeType?: string;
+  size?: number;
+  type: ShareIntentType;
+  dateTaken?: number;
+  localIdentifier?: string;
+  originalUri?: string;
+};
+
+export type ShareIntentPayload = {
+  text?: string;
+  subject?: string;
+  title?: string;
+  mimeType?: string;
+  files: SharedFile[];
+  webUrl?: string;
+  isInitial: boolean;
+  receivedAt: number;
+};
+
+export type ShareIntentListener = (payload: ShareIntentPayload) => void;
+
+declare const ShareIntent: {
+  getInitialShare(): Promise<ShareIntentPayload | null>;
+  addShareListener(listener: ShareIntentListener): EmitterSubscription;
+  clearSharedData(): Promise<void>;
+  setAppGroupIdentifier(identifier: string): Promise<void>;
+  setContainingAppScheme(scheme: string): Promise<void>;
+};
+
+export declare const getInitialShare: typeof ShareIntent.getInitialShare;
+export declare const addShareListener: typeof ShareIntent.addShareListener;
+export declare const clearSharedData: typeof ShareIntent.clearSharedData;
+export declare const setAppGroupIdentifier: typeof ShareIntent.setAppGroupIdentifier;
+export declare const setContainingAppScheme: typeof ShareIntent.setContainingAppScheme;
+
+export default ShareIntent;

package/src/index.ts

@@ -0,0 +1,134 @@
+import {
+  NativeEventEmitter,
+  NativeModules,
+  Platform,
+  type EmitterSubscription,
+} from 'react-native';
+
+type NativeShareIntentModule = {
+  getInitialShare(): Promise<ShareIntentPayload | null>;
+  clearSharedData(): Promise<void>;
+  setAppGroupIdentifier?(identifier: string): Promise<void>;
+  setContainingAppScheme?(scheme: string): Promise<void>;
+};
+
+export type ShareIntentType = 'text' | 'image' | 'video' | 'document' | 'unknown';
+
+export type SharedFile = {
+  uri: string;
+  fileName?: string;
+  name?: string;
+  mimeType?: string;
+  size?: number;
+  type: ShareIntentType;
+  dateTaken?: number;
+  localIdentifier?: string;
+  originalUri?: string;
+};
+
+export type ShareIntentPayload = {
+  text?: string;
+  subject?: string;
+  title?: string;
+  mimeType?: string;
+  files: SharedFile[];
+  webUrl?: string;
+  isInitial: boolean;
+  receivedAt: number;
+};
+
+export type ShareIntentListener = (payload: ShareIntentPayload) => void;
+
+const LINKING_ERROR =
+  'react-native-advanced-share-intent is not linked. Rebuild the native app after installing the package.';
+
+const NativeAdvancedShareIntent =
+  NativeModules.AdvancedShareIntent as NativeShareIntentModule | undefined;
+
+const nativeModule = new Proxy({} as NativeShareIntentModule, {
+  get(_target, property: keyof NativeShareIntentModule) {
+    if (!NativeAdvancedShareIntent) {
+      throw new Error(LINKING_ERROR);
+    }
+
+    const value = NativeAdvancedShareIntent[property];
+    if (typeof value === 'function') {
+      return value.bind(NativeAdvancedShareIntent);
+    }
+    return value;
+  },
+});
+
+const emitter = NativeAdvancedShareIntent
+  ? new NativeEventEmitter(NativeAdvancedShareIntent as any)
+  : null;
+
+const EVENT_NAME = 'AdvancedShareIntentReceived';
+
+function normalizePayload(payload: ShareIntentPayload | null): ShareIntentPayload | null {
+  if (!payload) {
+    return null;
+  }
+
+  return {
+    ...payload,
+    files: Array.isArray(payload.files) ? payload.files : [],
+    receivedAt: payload.receivedAt ?? Date.now(),
+    isInitial: Boolean(payload.isInitial),
+  };
+}
+
+const ShareIntent = {
+  async getInitialShare(): Promise<ShareIntentPayload | null> {
+    return normalizePayload(await nativeModule.getInitialShare());
+  },
+
+  addShareListener(listener: ShareIntentListener): EmitterSubscription {
+    if (!emitter) {
+      throw new Error(LINKING_ERROR);
+    }
+
+    return emitter.addListener(EVENT_NAME, (payload: ShareIntentPayload) => {
+      const normalizedPayload = normalizePayload(payload);
+      if (normalizedPayload) {
+        listener(normalizedPayload);
+      }
+    });
+  },
+
+  async clearSharedData(): Promise<void> {
+    await nativeModule.clearSharedData();
+  },
+
+  async setAppGroupIdentifier(identifier: string): Promise<void> {
+    if (Platform.OS !== 'ios') {
+      return;
+    }
+
+    if (!nativeModule.setAppGroupIdentifier) {
+      throw new Error('setAppGroupIdentifier is not available on this platform.');
+    }
+
+    await nativeModule.setAppGroupIdentifier(identifier);
+  },
+
+  async setContainingAppScheme(scheme: string): Promise<void> {
+    if (Platform.OS !== 'ios') {
+      return;
+    }
+
+    if (!nativeModule.setContainingAppScheme) {
+      throw new Error('setContainingAppScheme is not available on this platform.');
+    }
+
+    await nativeModule.setContainingAppScheme(scheme);
+  },
+};
+
+export const getInitialShare = ShareIntent.getInitialShare;
+export const addShareListener = ShareIntent.addShareListener;
+export const clearSharedData = ShareIntent.clearSharedData;
+export const setAppGroupIdentifier = ShareIntent.setAppGroupIdentifier;
+export const setContainingAppScheme = ShareIntent.setContainingAppScheme;
+
+export default ShareIntent;