@flighthq/share 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './share';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './share';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/share.d.ts

@@ -0,0 +1,16 @@
+import type { ShareBackend, ShareContent, ShareOptions, ShareResult, ShareSignals } from '@flighthq/types';
+export declare function attachShareSignals(signals: ShareSignals): void;
+export declare function canShareContent(content: Readonly<ShareContent>): boolean;
+export declare function createWebShareBackend(): ShareBackend;
+export declare function detachShareSignals(signals: ShareSignals): void;
+export declare function disposeShareSignals(signals: ShareSignals): void;
+export declare function enableShareSignals(): ShareSignals;
+export declare function getShareBackend(): ShareBackend;
+export declare function hasShareContentFields(content: Readonly<ShareContent>): boolean;
+export declare function isShareAvailable(): boolean;
+export declare function setShareBackend(backend: ShareBackend | null): void;
+export declare function shareContent(content: Readonly<ShareContent>, options?: Readonly<ShareOptions>): Promise<boolean>;
+export declare function shareContentWithResult(content: Readonly<ShareContent>, options?: Readonly<ShareOptions>): Promise<ShareResult>;
+export declare function shareText(text: string, options?: Readonly<ShareOptions>): Promise<boolean>;
+export declare function shareUrl(url: string, options?: Readonly<ShareOptions>): Promise<boolean>;
+//# sourceMappingURL=share.d.ts.map

package/dist/share.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.d.ts","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAS3G,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAG9D;AAMD,wBAAgB,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,OAAO,CAExE;AAQD,wBAAgB,qBAAqB,IAAI,YAAY,CA4CpD;AAGD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAE9D;AAID,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAE/D;AAID,wBAAgB,kBAAkB,IAAI,YAAY,CAIjD;AAGD,wBAAgB,eAAe,IAAI,YAAY,CAG9C;AAMD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,OAAO,CAM9E;AAKD,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAGD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAElE;AAOD,wBAAgB,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAGhH;AAMD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC/B,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,GAC/B,OAAO,CAAC,WAAW,CAAC,CAWtB;AAGD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1F;AAGD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAExF"}

package/dist/share.js

@@ -0,0 +1,194 @@
+import { createSignal, emitSignal } from '@flighthq/signals';
+// Attaches `signals` to receive share result events emitted by shareContentWithResult calls. A prior
+// subscription on this signals group is torn down first. Pair with detachShareSignals /
+// disposeShareSignals.
+//
+// Note: shareContent (the boolean convenience wrapper) does NOT emit signals — only
+// shareContentWithResult emits onShareResult. If you need signals on every share, use
+// shareContentWithResult directly.
+export function attachShareSignals(signals) {
+    detachShareSignals(signals);
+    _signalListeners.set(signals, true);
+}
+// True when the active backend can share the given content. Returns false when sharing is
+// unavailable or the content is not shareable by this platform (e.g. a MIME type not accepted by
+// the share sheet). Distinct from isShareAvailable: that probe asks whether sharing is possible at
+// all; this asks whether this specific content is shareable.
+export function canShareContent(content) {
+    return getShareBackend().canShare(content);
+}
+// Builds the default web backend over navigator.share / navigator.canShare.
+// share and shareWithResult resolve to false/dismissed=true when the Web Share API is absent (jsdom,
+// unsupported browsers) or the user cancels. canShare returns false when the API is absent or the
+// platform cannot share the given content. isAvailable returns true when navigator.share exists.
+// Files are converted from ShareFile (data URL) to DOM File at the boundary; conversion errors
+// fall back to false.
+export function createWebShareBackend() {
+    return {
+        isAvailable() {
+            return typeof navigator !== 'undefined' && 'share' in navigator;
+        },
+        canShare(content) {
+            if (typeof navigator === 'undefined' || !('share' in navigator))
+                return false;
+            try {
+                const data = shareContentToNavigatorData(content);
+                return navigator.canShare?.(data) ?? false;
+            }
+            catch {
+                return false;
+            }
+        },
+        async share(content, _options) {
+            if (typeof navigator === 'undefined' || !('share' in navigator) || typeof navigator.share !== 'function') {
+                return false;
+            }
+            try {
+                const data = shareContentToNavigatorData(content);
+                await navigator.share(data);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        async shareWithResult(content, _options) {
+            if (typeof navigator === 'undefined' || !('share' in navigator) || typeof navigator.share !== 'function') {
+                return { completed: false, activityType: null, dismissed: false };
+            }
+            try {
+                const data = shareContentToNavigatorData(content);
+                await navigator.share(data);
+                return { completed: true, activityType: null, dismissed: false };
+            }
+            catch (err) {
+                // AbortError means the user explicitly cancelled; other errors are failures.
+                const dismissed = err instanceof Error && err.name === 'AbortError';
+                return { completed: false, activityType: null, dismissed };
+            }
+        },
+    };
+}
+// Stops delivery to `signals` and forgets its subscription. Safe to call when not attached.
+export function detachShareSignals(signals) {
+    _signalListeners.delete(signals);
+}
+// Releases `signals` for garbage collection by detaching its subscription. The signals remain plain
+// GC-managed memory afterward.
+export function disposeShareSignals(signals) {
+    detachShareSignals(signals);
+}
+// Enables a signals group for share result events. Signals stay inert until attachShareSignals is
+// called. This is the opt-in; the cost is assumed when attached.
+export function enableShareSignals() {
+    return {
+        onShareResult: createSignal(),
+    };
+}
+// The active share backend, or a lazily-created web default. There is always a backend.
+export function getShareBackend() {
+    if (_backend === null)
+        _backend = createWebShareBackend();
+    return _backend;
+}
+// True when content has at least one populated field (title, text, url, or a non-empty files array).
+// The Web Share API requires at least one field to be present; calling shareContent with an empty
+// payload will throw on some engines, which shareContent swallows to false. Use this to detect
+// an obviously-empty payload before calling shareContent.
+export function hasShareContentFields(content) {
+    if (content.title !== undefined && content.title !== '')
+        return true;
+    if (content.text !== undefined && content.text !== '')
+        return true;
+    if (content.url !== undefined && content.url !== '')
+        return true;
+    if (content.files !== undefined && content.files.length > 0)
+        return true;
+    return false;
+}
+// True when the active backend's platform supports sharing at all (capability-level probe,
+// independent of any content). Distinct from canShareContent: this asks "can this platform share?"
+// while canShareContent asks "is this specific content shareable?".
+export function isShareAvailable() {
+    return getShareBackend().isAvailable();
+}
+// Installs a native host share backend; pass null to fall back to the web default.
+export function setShareBackend(backend) {
+    _backend = backend;
+}
+// Opens the native share sheet with the given content. Resolves true on success, false when the host
+// denies, the user cancels, or sharing is unavailable. An empty content payload (no title/text/url/
+// files) is caught by hasShareContentFields and returns false immediately rather than forwarding to the
+// backend (which may throw). Pass options to control presentation on native hosts (parentWindow,
+// sourceRect on iPad).
+export function shareContent(content, options) {
+    if (!hasShareContentFields(content))
+        return Promise.resolve(false);
+    return getShareBackend().share(content, options);
+}
+// Opens the native share sheet and returns a full ShareResult describing completion, cancellation,
+// and which activity/app was chosen. Emits onShareResult on all attached ShareSignals groups.
+// An empty content payload returns { completed: false, activityType: null, dismissed: false }
+// immediately. Pass options to control presentation on native hosts.
+export async function shareContentWithResult(content, options) {
+    if (!hasShareContentFields(content)) {
+        return { completed: false, activityType: null, dismissed: false };
+    }
+    const result = await getShareBackend().shareWithResult(content, options);
+    if (_signalListeners.size > 0) {
+        for (const signals of _signalListeners.keys()) {
+            emitSignal(signals.onShareResult, result);
+        }
+    }
+    return result;
+}
+// Opens the share sheet with a plain text payload. A convenience wrapper over shareContent.
+export function shareText(text, options) {
+    return shareContent({ text }, options);
+}
+// Opens the share sheet with a URL payload. A convenience wrapper over shareContent.
+export function shareUrl(url, options) {
+    return shareContent({ url }, options);
+}
+let _backend = null;
+// Maps signals groups that have been attached via attachShareSignals.
+const _signalListeners = new Map();
+// Converts a ShareContent (with portable ShareFile descriptors) to the navigator.share data shape,
+// converting ShareFile data URLs to DOM File objects at the web boundary.
+function shareContentToNavigatorData(content) {
+    const data = {};
+    if (content.title !== undefined)
+        data.title = content.title;
+    if (content.text !== undefined)
+        data.text = content.text;
+    if (content.url !== undefined)
+        data.url = content.url;
+    if (content.files !== undefined && content.files.length > 0) {
+        data.files = content.files.map((f) => shareFileToDomFile(f));
+    }
+    return data;
+}
+// Converts a portable ShareFile descriptor to a DOM File for navigator.share / navigator.canShare.
+function shareFileToDomFile(file) {
+    // Parse the data URL: 'data:<mimeType>;base64,<data>' or 'data:<mimeType>,<data>'
+    const comma = file.dataUrl.indexOf(',');
+    const header = file.dataUrl.substring(0, comma);
+    const body = file.dataUrl.substring(comma + 1);
+    const isBase64 = header.includes(';base64');
+    let bytes;
+    if (isBase64) {
+        const binary = atob(body);
+        bytes = new Uint8Array(new ArrayBuffer(binary.length));
+        for (let i = 0; i < binary.length; i++) {
+            bytes[i] = binary.charCodeAt(i);
+        }
+    }
+    else {
+        const decoded = decodeURIComponent(body);
+        const encoded = new TextEncoder().encode(decoded);
+        bytes = new Uint8Array(new ArrayBuffer(encoded.length));
+        bytes.set(encoded);
+    }
+    return new File([bytes], file.name, { type: file.mimeType });
+}
+//# sourceMappingURL=share.js.map

package/dist/share.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.js","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG7D,qGAAqG;AACrG,wFAAwF;AACxF,uBAAuB;AACvB,EAAE;AACF,oFAAoF;AACpF,sFAAsF;AACtF,mCAAmC;AACnC,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,0FAA0F;AAC1F,iGAAiG;AACjG,mGAAmG;AACnG,6DAA6D;AAC7D,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,OAAO,eAAe,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,4EAA4E;AAC5E,qGAAqG;AACrG,kGAAkG;AAClG,iGAAiG;AACjG,+FAA+F;AAC/F,sBAAsB;AACtB,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,WAAW;YACT,OAAO,OAAO,SAAS,KAAK,WAAW,IAAI,OAAO,IAAI,SAAS,CAAC;QAClE,CAAC;QAED,QAAQ,CAAC,OAAO;YACd,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,CAAC,CAAC,OAAO,IAAI,SAAS,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC9E,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;gBAClD,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;YAC7C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,QAAS;YAC5B,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,CAAC,CAAC,OAAO,IAAI,SAAS,CAAC,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACzG,OAAO,KAAK,CAAC;YACf,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;gBAClD,MAAM,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC5B,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,KAAK,CAAC,eAAe,CAAC,OAAO,EAAE,QAAS;YACtC,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,CAAC,CAAC,OAAO,IAAI,SAAS,CAAC,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACzG,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YACpE,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;gBAClD,MAAM,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC5B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YACnE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,6EAA6E;gBAC7E,MAAM,SAAS,GAAG,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC;gBACpE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAC7D,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,oGAAoG;AACpG,+BAA+B;AAC/B,MAAM,UAAU,mBAAmB,CAAC,OAAqB;IACvD,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED,kGAAkG;AAClG,iEAAiE;AACjE,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,aAAa,EAAE,YAAY,EAAE;KAC9B,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,eAAe;IAC7B,IAAI,QAAQ,KAAK,IAAI;QAAE,QAAQ,GAAG,qBAAqB,EAAE,CAAC;IAC1D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qGAAqG;AACrG,kGAAkG;AAClG,+FAA+F;AAC/F,0DAA0D;AAC1D,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACnE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACrE,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACnE,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACjE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,2FAA2F;AAC3F,mGAAmG;AACnG,oEAAoE;AACpE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,eAAe,EAAE,CAAC,WAAW,EAAE,CAAC;AACzC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC1D,QAAQ,GAAG,OAAO,CAAC;AACrB,CAAC;AAED,qGAAqG;AACrG,oGAAoG;AACpG,wGAAwG;AACxG,iGAAiG;AACjG,uBAAuB;AACvB,MAAM,UAAU,YAAY,CAAC,OAA+B,EAAE,OAAgC;IAC5F,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnE,OAAO,eAAe,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,mGAAmG;AACnG,8FAA8F;AAC9F,8FAA8F;AAC9F,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAA+B,EAC/B,OAAgC;IAEhC,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACpE,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzE,IAAI,gBAAgB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,MAAM,OAAO,IAAI,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9C,UAAU,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAgC;IACtE,OAAO,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,OAAgC;IACpE,OAAO,YAAY,CAAC,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,IAAI,QAAQ,GAAwB,IAAI,CAAC;AACzC,sEAAsE;AACtE,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAsB,CAAC;AAEvD,mGAAmG;AACnG,0EAA0E;AAC1E,SAAS,2BAA2B,CAAC,OAA+B;IAClE,MAAM,IAAI,GAAc,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5D,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IACzD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACtD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mGAAmG;AACnG,SAAS,kBAAkB,CAAC,IAAyD;IACnF,kFAAkF;IAClF,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC5C,IAAI,KAA8B,CAAC;IACnC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAClD,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACxD,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@flighthq/share",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/signals": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Native share sheet (title, text, url, files) over a swappable web/native backend",
+  "sideEffects": false
+}

package/src/share.test.ts

@@ -0,0 +1,460 @@
+import { connectSignal } from '@flighthq/signals';
+import type { ShareBackend, ShareContent, ShareFile, ShareOptions, ShareResult } from '@flighthq/types';
+
+import {
+  attachShareSignals,
+  canShareContent,
+  createWebShareBackend,
+  detachShareSignals,
+  disposeShareSignals,
+  enableShareSignals,
+  getShareBackend,
+  hasShareContentFields,
+  isShareAvailable,
+  setShareBackend,
+  shareContent,
+  shareContentWithResult,
+  shareText,
+  shareUrl,
+} from './share';
+
+function fakeBackend(
+  overrides: Partial<ShareBackend & { shared: ShareContent | null }> = {},
+): ShareBackend & { shared: ShareContent | null } {
+  return {
+    shared: null,
+    isAvailable() {
+      return true;
+    },
+    async share(content) {
+      (this as { shared: ShareContent | null }).shared = content;
+      return true;
+    },
+    async shareWithResult(content) {
+      (this as { shared: ShareContent | null }).shared = content;
+      return { completed: true, activityType: null, dismissed: false };
+    },
+    canShare() {
+      return true;
+    },
+    ...overrides,
+  };
+}
+
+afterEach(() => setShareBackend(null));
+
+describe('attachShareSignals', () => {
+  it('replaces an existing attachment idempotently', async () => {
+    const signals = enableShareSignals();
+    attachShareSignals(signals);
+    attachShareSignals(signals); // second attach should not double-fire
+    let count = 0;
+    connectSignal(signals.onShareResult, () => count++);
+    setShareBackend(fakeBackend());
+    await shareContentWithResult({ text: 'hi' });
+    expect(count).toBe(1);
+    detachShareSignals(signals);
+  });
+
+  it('emits onShareResult when shareContentWithResult is called after attach', async () => {
+    const signals = enableShareSignals();
+    attachShareSignals(signals);
+    const results: ShareResult[] = [];
+    connectSignal(signals.onShareResult, (r) => results.push(r));
+    setShareBackend(fakeBackend());
+    await shareContentWithResult({ text: 'hello' });
+    expect(results).toHaveLength(1);
+    expect(results[0]!.completed).toBe(true);
+    detachShareSignals(signals);
+  });
+
+  it('does not emit after detach', async () => {
+    const signals = enableShareSignals();
+    attachShareSignals(signals);
+    detachShareSignals(signals);
+    let count = 0;
+    connectSignal(signals.onShareResult, () => count++);
+    setShareBackend(fakeBackend());
+    await shareContentWithResult({ text: 'hi' });
+    expect(count).toBe(0);
+  });
+});
+
+describe('canShareContent', () => {
+  it('reflects the backend result', () => {
+    setShareBackend(fakeBackend());
+    expect(canShareContent({ text: 'x' })).toBe(true);
+  });
+
+  it('returns false from the web backend in jsdom without throwing', () => {
+    expect(canShareContent({ text: 'x' })).toBe(false);
+  });
+
+  it('returns false when files cannot be shared', () => {
+    setShareBackend({
+      isAvailable: () => true,
+      canShare: () => false,
+      share: async () => false,
+      shareWithResult: async () => ({ completed: false, activityType: null, dismissed: false }),
+    });
+    const file: ShareFile = { name: 'img.png', mimeType: 'image/png', dataUrl: 'data:image/png;base64,abc' };
+    expect(canShareContent({ files: [file] })).toBe(false);
+  });
+
+  it('returns true when files can be shared', () => {
+    setShareBackend(fakeBackend());
+    const file: ShareFile = { name: 'img.png', mimeType: 'image/png', dataUrl: 'data:image/png;base64,abc' };
+    expect(canShareContent({ files: [file] })).toBe(true);
+  });
+});
+
+describe('createWebShareBackend', () => {
+  it('returns false for share/canShare and isAvailable=false when the API is absent', async () => {
+    const backend = createWebShareBackend();
+    expect(backend.isAvailable()).toBe(false);
+    expect(await backend.share({ text: 'x' })).toBe(false);
+    expect(backend.canShare({ text: 'x' })).toBe(false);
+  });
+
+  it('shareWithResult returns completed=false dismissed=false when API is absent', async () => {
+    const backend = createWebShareBackend();
+    const result = await backend.shareWithResult({ text: 'x' });
+    expect(result.completed).toBe(false);
+    expect(result.dismissed).toBe(false);
+    expect(result.activityType).toBeNull();
+  });
+
+  it('shareWithResult returns dismissed=true on AbortError', async () => {
+    const backend = createWebShareBackend();
+    Object.defineProperty(globalThis, 'navigator', {
+      value: {
+        share: async () => {
+          const err = new Error('User aborted');
+          err.name = 'AbortError';
+          throw err;
+        },
+        canShare: () => true,
+      },
+      configurable: true,
+    });
+    const result = await backend.shareWithResult({ text: 'hi' });
+    expect(result.completed).toBe(false);
+    expect(result.dismissed).toBe(true);
+    Object.defineProperty(globalThis, 'navigator', { value: undefined, configurable: true });
+  });
+
+  it('shareWithResult returns dismissed=false on non-AbortError', async () => {
+    const backend = createWebShareBackend();
+    Object.defineProperty(globalThis, 'navigator', {
+      value: {
+        share: async () => {
+          const err = new Error('Data error');
+          err.name = 'DataError';
+          throw err;
+        },
+        canShare: () => true,
+      },
+      configurable: true,
+    });
+    const result = await backend.shareWithResult({ text: 'hi' });
+    expect(result.completed).toBe(false);
+    expect(result.dismissed).toBe(false);
+    Object.defineProperty(globalThis, 'navigator', { value: undefined, configurable: true });
+  });
+
+  it('isAvailable returns true when navigator.share exists', () => {
+    Object.defineProperty(globalThis, 'navigator', {
+      value: { share: async () => {} },
+      configurable: true,
+    });
+    const backend = createWebShareBackend();
+    expect(backend.isAvailable()).toBe(true);
+    Object.defineProperty(globalThis, 'navigator', { value: undefined, configurable: true });
+  });
+
+  it('canShare delegates files to navigator.canShare', () => {
+    let passedData: ShareData | undefined;
+    Object.defineProperty(globalThis, 'navigator', {
+      value: {
+        share: async () => {},
+        canShare: (data: ShareData) => {
+          passedData = data;
+          return true;
+        },
+      },
+      configurable: true,
+    });
+    const backend = createWebShareBackend();
+    const file: ShareFile = { name: 'img.png', mimeType: 'image/png', dataUrl: 'data:image/png;base64,AA==' };
+    backend.canShare({ files: [file] });
+    expect(passedData?.files).toHaveLength(1);
+    expect(passedData?.files?.[0]).toBeInstanceOf(File);
+    Object.defineProperty(globalThis, 'navigator', { value: undefined, configurable: true });
+  });
+});
+
+describe('detachShareSignals', () => {
+  it('is safe to call when not attached', () => {
+    const signals = enableShareSignals();
+    expect(() => detachShareSignals(signals)).not.toThrow();
+  });
+});
+
+describe('disposeShareSignals', () => {
+  it('releases signal group without throwing', () => {
+    const signals = enableShareSignals();
+    attachShareSignals(signals);
+    expect(() => disposeShareSignals(signals)).not.toThrow();
+  });
+});
+
+describe('enableShareSignals', () => {
+  it('returns a signals group with onShareResult signal', () => {
+    const signals = enableShareSignals();
+    expect(signals.onShareResult).toBeDefined();
+  });
+});
+
+describe('getShareBackend', () => {
+  it('falls back to a web backend', () => {
+    expect(getShareBackend()).not.toBeNull();
+  });
+
+  it('returns the registered backend', () => {
+    const backend = fakeBackend();
+    setShareBackend(backend);
+    expect(getShareBackend()).toBe(backend);
+  });
+});
+
+describe('hasShareContentFields', () => {
+  it('returns false for empty object', () => {
+    expect(hasShareContentFields({})).toBe(false);
+  });
+
+  it('returns false for empty strings', () => {
+    expect(hasShareContentFields({ title: '', text: '', url: '' })).toBe(false);
+  });
+
+  it('returns false for empty files array', () => {
+    expect(hasShareContentFields({ files: [] })).toBe(false);
+  });
+
+  it('returns true for non-empty title', () => {
+    expect(hasShareContentFields({ title: 'Hello' })).toBe(true);
+  });
+
+  it('returns true for non-empty text', () => {
+    expect(hasShareContentFields({ text: 'x' })).toBe(true);
+  });
+
+  it('returns true for non-empty url', () => {
+    expect(hasShareContentFields({ url: 'https://example.com' })).toBe(true);
+  });
+
+  it('returns true for non-empty files array', () => {
+    const file: ShareFile = { name: 'img.png', mimeType: 'image/png', dataUrl: 'data:image/png;base64,AA==' };
+    expect(hasShareContentFields({ files: [file] })).toBe(true);
+  });
+});
+
+describe('isShareAvailable', () => {
+  it('returns false from the web backend in jsdom', () => {
+    expect(isShareAvailable()).toBe(false);
+  });
+
+  it('returns true when the backend reports available', () => {
+    setShareBackend(fakeBackend());
+    expect(isShareAvailable()).toBe(true);
+  });
+
+  it('returns true when navigator.share exists', () => {
+    Object.defineProperty(globalThis, 'navigator', {
+      value: { share: async () => {} },
+      configurable: true,
+    });
+    expect(isShareAvailable()).toBe(true);
+    Object.defineProperty(globalThis, 'navigator', { value: undefined, configurable: true });
+  });
+});
+
+describe('setShareBackend', () => {
+  it('clears back to the web fallback when passed null', () => {
+    setShareBackend(fakeBackend());
+    setShareBackend(null);
+    expect(getShareBackend()).not.toBeNull();
+  });
+});
+
+describe('shareContent', () => {
+  it('shares via the active backend', async () => {
+    const backend = fakeBackend();
+    setShareBackend(backend);
+    expect(await shareContent({ title: 't', url: 'u' })).toBe(true);
+    expect(backend.shared).toEqual({ title: 't', url: 'u' });
+  });
+
+  it('returns false from the web backend in jsdom without throwing', async () => {
+    expect(await shareContent({ text: 'x' })).toBe(false);
+  });
+
+  it('returns false immediately for empty content without calling backend', async () => {
+    let called = false;
+    setShareBackend({
+      isAvailable: () => true,
+      canShare: () => false,
+      share: async () => {
+        called = true;
+        return true;
+      },
+      shareWithResult: async () => ({ completed: true, activityType: null, dismissed: false }),
+    });
+    expect(await shareContent({})).toBe(false);
+    expect(called).toBe(false);
+  });
+
+  it('passes options to backend', async () => {
+    let passedOptions: ShareOptions | undefined;
+    setShareBackend({
+      isAvailable: () => true,
+      canShare: () => true,
+      share: async (_content, options) => {
+        passedOptions = options;
+        return true;
+      },
+      shareWithResult: async () => ({ completed: true, activityType: null, dismissed: false }),
+    });
+    const opts: ShareOptions = { chooserTitle: 'Share via' };
+    await shareContent({ text: 'hi' }, opts);
+    expect(passedOptions).toEqual(opts);
+  });
+
+  it('shares files', async () => {
+    const backend = fakeBackend();
+    setShareBackend(backend);
+    const file: ShareFile = { name: 'img.png', mimeType: 'image/png', dataUrl: 'data:image/png;base64,AA==' };
+    expect(await shareContent({ files: [file] })).toBe(true);
+    expect(backend.shared).toEqual({ files: [file] });
+  });
+});
+
+describe('shareContentWithResult', () => {
+  it('returns completed result from backend', async () => {
+    setShareBackend(fakeBackend());
+    const result = await shareContentWithResult({ text: 'hello' });
+    expect(result.completed).toBe(true);
+    expect(result.dismissed).toBe(false);
+    expect(result.activityType).toBeNull();
+  });
+
+  it('returns empty result for empty content without calling backend', async () => {
+    let called = false;
+    setShareBackend({
+      isAvailable: () => true,
+      canShare: () => false,
+      share: async () => true,
+      shareWithResult: async () => {
+        called = true;
+        return { completed: true, activityType: null, dismissed: false };
+      },
+    });
+    const result = await shareContentWithResult({});
+    expect(result.completed).toBe(false);
+    expect(called).toBe(false);
+  });
+
+  it('emits onShareResult to attached signal groups', async () => {
+    setShareBackend(fakeBackend());
+    const signals = enableShareSignals();
+    attachShareSignals(signals);
+    const results: ShareResult[] = [];
+    connectSignal(signals.onShareResult, (r) => results.push(r));
+    await shareContentWithResult({ url: 'https://example.com' });
+    expect(results).toHaveLength(1);
+    expect(results[0]!.completed).toBe(true);
+    detachShareSignals(signals);
+  });
+
+  it('does not emit to detached signal groups', async () => {
+    setShareBackend(fakeBackend());
+    const signals = enableShareSignals();
+    attachShareSignals(signals);
+    detachShareSignals(signals);
+    let count = 0;
+    connectSignal(signals.onShareResult, () => count++);
+    await shareContentWithResult({ text: 'hi' });
+    expect(count).toBe(0);
+  });
+
+  it('passes options to backend', async () => {
+    let passedOptions: ShareOptions | undefined;
+    setShareBackend({
+      isAvailable: () => true,
+      canShare: () => true,
+      share: async () => true,
+      shareWithResult: async (_content, options) => {
+        passedOptions = options;
+        return { completed: true, activityType: 'com.example.App', dismissed: false };
+      },
+    });
+    const opts: ShareOptions = { excludedActivityTypes: ['com.apple.UIKit.activity.Print'] };
+    const result = await shareContentWithResult({ text: 'hi' }, opts);
+    expect(passedOptions).toEqual(opts);
+    expect(result.activityType).toBe('com.example.App');
+  });
+
+  it('returns false from web backend in jsdom without throwing', async () => {
+    const result = await shareContentWithResult({ text: 'x' });
+    expect(result.completed).toBe(false);
+  });
+});
+
+describe('shareText', () => {
+  it('shares via shareContent with text payload', async () => {
+    const backend = fakeBackend();
+    setShareBackend(backend);
+    expect(await shareText('hello world')).toBe(true);
+    expect(backend.shared).toEqual({ text: 'hello world' });
+  });
+
+  it('passes options to shareContent', async () => {
+    let passedOptions: ShareOptions | undefined;
+    setShareBackend({
+      isAvailable: () => true,
+      canShare: () => true,
+      share: async (_content, options) => {
+        passedOptions = options;
+        return true;
+      },
+      shareWithResult: async () => ({ completed: true, activityType: null, dismissed: false }),
+    });
+    const opts: ShareOptions = { chooserTitle: 'Share text' };
+    await shareText('hi', opts);
+    expect(passedOptions).toEqual(opts);
+  });
+});
+
+describe('shareUrl', () => {
+  it('shares via shareContent with url payload', async () => {
+    const backend = fakeBackend();
+    setShareBackend(backend);
+    expect(await shareUrl('https://example.com')).toBe(true);
+    expect(backend.shared).toEqual({ url: 'https://example.com' });
+  });
+
+  it('passes options to shareContent', async () => {
+    let passedOptions: ShareOptions | undefined;
+    setShareBackend({
+      isAvailable: () => true,
+      canShare: () => true,
+      share: async (_content, options) => {
+        passedOptions = options;
+        return true;
+      },
+      shareWithResult: async () => ({ completed: true, activityType: null, dismissed: false }),
+    });
+    const opts: ShareOptions = { chooserTitle: 'Share link' };
+    await shareUrl('https://example.com', opts);
+    expect(passedOptions).toEqual(opts);
+  });
+});