@flighthq/share 0.5.0-next.1944.cd6b6e7 → 0.5.1-edge.638.d4dbd4e

package/README.md

@@ -1,6 +1,6 @@
 # @flighthq/share
 
-Native share sheet (title, text, url, files) over a swappable web/native backend
+Explicit host share-sheet commands for content and portable files
 
 ## Install
 
@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/share`. The `@flight
 This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
 
 - [Flight project](https://github.com/flighthq/flight)
-- [Source for @flighthq/share@0.5.0-next.1944.cd6b6e7](https://github.com/flighthq/flight/tree/cd6b6e71eb472b3a4249830a7743333f019fa7b7/packages/share)
-- [License](https://github.com/flighthq/flight/blob/cd6b6e71eb472b3a4249830a7743333f019fa7b7/LICENSE.md)
+- [Source for @flighthq/share@0.5.1-edge.638.d4dbd4e](https://github.com/flighthq/flight/tree/d4dbd4e347dc8be10b180c85a766ab50333dcb51/packages/share)
+- [License](https://github.com/flighthq/flight/blob/d4dbd4e347dc8be10b180c85a766ab50333dcb51/LICENSE.md)

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { explainShareBackend, attachShareSignals, canShareContent, detachShareSignals, disposeShareSignals, enableShareSignals, hasShareContentFields, isShareAvailable, shareContent, shareContentWithResult, shareFiles, shareText, shareUrl, } from './contract';
+export { attachShareSignals, canShareContent, canShareFiles, detachShareSignals, disposeShareSignals, enableShareSignals, hasShareContentFields, shareContent, shareContentWithResult, shareFiles, shareText, shareUrl, } from './contract';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { explainShareBackend, attachShareSignals, canShareContent, detachShareSignals, disposeShareSignals, enableShareSignals, hasShareContentFields, isShareAvailable, shareContent, shareContentWithResult, shareFiles, shareText, shareUrl, } from './contract';
+export { attachShareSignals, canShareContent, canShareFiles, detachShareSignals, disposeShareSignals, enableShareSignals, hasShareContentFields, shareContent, shareContentWithResult, shareFiles, shareText, shareUrl, } from './contract';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAC"}

package/dist/share.d.ts

@@ -1,22 +1,14 @@
-import type { BackendExplanation } from '@flighthq/types/contract';
-import type { ShareBackend, ShareContent, ShareFile, ShareOptions, ShareResult, ShareSignals } from '@flighthq/types/contract';
+import type { HasShareContent, HasShareFiles, ShareContent, ShareFile, ShareResult, ShareSignals } from '@flighthq/types/contract';
 export declare function attachShareSignals(signals: ShareSignals): void;
-export declare function canShareContent(content: Readonly<ShareContent>): boolean;
-export declare function createWebShareBackend(): ShareBackend;
+export declare function canShareContent(host: HasShareContent, content: Readonly<ShareContent>): boolean;
+export declare function canShareFiles(host: HasShareFiles, files: readonly ShareFile[]): boolean;
 export declare function detachShareSignals(signals: ShareSignals): void;
 export declare function disposeShareSignals(signals: ShareSignals): void;
 export declare function enableShareSignals(): ShareSignals;
-export declare function explainShareBackend(): BackendExplanation;
-export declare function getShareBackend(): ShareBackend;
 export declare function hasShareContentFields(content: Readonly<ShareContent>): boolean;
-export declare function installShareHostBackend(backend: ShareBackend): void;
-export declare function isShareAvailable(): boolean;
-export declare function observeShareHostResult(operation: string, succeeded: boolean): void;
-export declare function resetShareBackendForTest(): void;
-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 shareFiles(files: readonly ShareFile[], options?: Readonly<ShareOptions>): Promise<boolean>;
-export declare function shareText(text: string, options?: Readonly<ShareOptions>): Promise<boolean>;
-export declare function shareUrl(url: string, options?: Readonly<ShareOptions>): Promise<boolean>;
+export declare function shareContent(host: HasShareContent, content: Readonly<ShareContent>): Promise<boolean>;
+export declare function shareContentWithResult(host: HasShareContent, content: Readonly<ShareContent>): Promise<ShareResult>;
+export declare function shareFiles(host: HasShareFiles, files: readonly ShareFile[]): Promise<boolean>;
+export declare function shareText(host: HasShareContent, text: string): Promise<boolean>;
+export declare function shareUrl(host: HasShareContent, url: string): Promise<boolean>;
 //# sourceMappingURL=share.d.ts.map

package/dist/share.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"share.d.ts","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,WAAW,EACX,YAAY,EACb,MAAM,0BAA0B,CAAC;AAElC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAE9D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,OAAO,CAExE;AAED,wBAAgB,qBAAqB,IAAI,YAAY,CA2CpD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAE9D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAE/D;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CAIjD;AAED,wBAAgB,mBAAmB,IAAI,kBAAkB,CAaxD;AAED,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,OAAO,CAM9E;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAMnE;AAED,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAKlF;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAK/C;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAElE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAGhH;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC/B,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,GAC/B,OAAO,CAAC,WAAW,CAAC,CAStB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1G;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1F;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAExF"}
+{"version":3,"file":"share.d.ts","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,SAAS,EAET,WAAW,EACX,YAAY,EACb,MAAM,0BAA0B,CAAC;AAElC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAE9D;AAID,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,OAAO,CAE/F;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,CAGvF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAE9D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAG/D;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,OAAO,CAK9E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAGrG;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAC9B,OAAO,CAAC,WAAW,CAAC,CAStB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAI7F;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/E;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7E"}

package/dist/share.js

@@ -1,82 +1,26 @@
-import { createSignal, emitSignal } from '@flighthq/signals/contract';
+import { createEntity } from '@flighthq/entity/contract';
+import { clearSignal, createSignal, emitSignal } from '@flighthq/signals/contract';
 export function attachShareSignals(signals) {
     _attachedSignals.add(signals);
 }
-export function canShareContent(content) {
-    return getShareBackend().canShare(content);
+// This is payload validation within the content capability. Capability presence itself is expressed
+// by HasShareContent, so a host without the slot is a type error rather than a false probe.
+export function canShareContent(host, content) {
+    return hasShareContentFields(content) && host.share.content.canShareContent(content);
 }
-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) {
-                const dismissed = err instanceof Error && err.name === 'AbortError';
-                return { completed: false, activityType: null, dismissed };
-            }
-        },
-    };
+export function canShareFiles(host, files) {
+    const content = filesContent(files);
+    return content !== null && host.share.files.canShareContent(content);
 }
 export function detachShareSignals(signals) {
     _attachedSignals.delete(signals);
 }
 export function disposeShareSignals(signals) {
     detachShareSignals(signals);
+    clearSignal(signals.onShareResult);
 }
 export function enableShareSignals() {
-    return {
-        onShareResult: createSignal(),
-    };
-}
-export function explainShareBackend() {
-    if (_custom !== null) {
-        return { conflict: _hostConflict, layer: 'custom', operation: null, viability: 'unobserved' };
-    }
-    if (_host !== null) {
-        return {
-            conflict: _hostConflict,
-            layer: 'host',
-            operation: _hostObservation !== null ? _hostObservation.operation : null,
-            viability: _hostObservation !== null ? _hostObservation.viability : 'unobserved',
-        };
-    }
-    return { conflict: false, layer: 'host-not-enabled', operation: null, viability: 'unobserved' };
-}
-export function getShareBackend() {
-    return _custom ?? _host ?? _sentinel;
+    return createEntity({ onShareResult: createSignal() });
 }
 export function hasShareContentFields(content) {
     if (content.title !== undefined && content.title !== '')
@@ -85,113 +29,38 @@ export function hasShareContentFields(content) {
         return true;
     if (content.url !== undefined && content.url !== '')
         return true;
-    if (content.files !== undefined && content.files.length > 0)
-        return true;
     return false;
 }
-export function installShareHostBackend(backend) {
-    if (_host !== null) {
-        if (_host !== backend)
-            _hostConflict = true;
-        return;
-    }
-    _host = backend;
-}
-export function isShareAvailable() {
-    return getShareBackend().isAvailable();
-}
-export function observeShareHostResult(operation, succeeded) {
-    _hostObservation = {
-        operation,
-        viability: succeeded ? 'available' : 'runtime-api-unavailable',
-    };
-}
-export function resetShareBackendForTest() {
-    _custom = null;
-    _host = null;
-    _hostConflict = false;
-    _hostObservation = null;
-}
-export function setShareBackend(backend) {
-    _custom = backend;
-}
-export function shareContent(content, options) {
+export function shareContent(host, content) {
     if (!hasShareContentFields(content))
         return Promise.resolve(false);
-    return getShareBackend().share(content, options);
+    return host.share.content.shareContent(content);
 }
-export async function shareContentWithResult(content, options) {
+export async function shareContentWithResult(host, content) {
     if (!hasShareContentFields(content)) {
         return { completed: false, activityType: null, dismissed: false };
     }
-    const result = await getShareBackend().shareWithResult(content, options);
+    const result = await host.share.content.shareContentWithResult(content);
     for (const signals of _attachedSignals) {
         emitSignal(signals.onShareResult, result);
     }
     return result;
 }
-export function shareFiles(files, options) {
-    return shareContent({ files }, options);
+export function shareFiles(host, files) {
+    const content = filesContent(files);
+    if (content === null)
+        return Promise.resolve(false);
+    return host.share.files.shareContent(content);
 }
-export function shareText(text, options) {
-    return shareContent({ text }, options);
+export function shareText(host, text) {
+    return shareContent(host, { text });
 }
-export function shareUrl(url, options) {
-    return shareContent({ url }, options);
+export function shareUrl(host, url) {
+    return shareContent(host, { url });
 }
-let _custom = null;
-let _host = null;
-let _hostConflict = false;
-let _hostObservation = null;
-const _sentinel = {
-    canShare() {
-        return false;
-    },
-    isAvailable() {
-        return false;
-    },
-    async share() {
-        return false;
-    },
-    async shareWithResult() {
-        return { completed: false, activityType: null, dismissed: false };
-    },
-};
 const _attachedSignals = new Set();
-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;
-}
-function shareFileToDomFile(file) {
-    const comma = file.dataUrl.indexOf(',');
-    if (comma === -1)
-        throw new Error('share: dataUrl is not a data URL (no comma)');
-    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 });
+function filesContent(files) {
+    const first = files[0];
+    return first === undefined ? null : { files: [first, ...files.slice(1)] };
 }
 //# sourceMappingURL=share.js.map

package/dist/share.js.map

@@ -1 +1 @@
-{"version":3,"file":"share.js","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAWtE,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,OAAO,eAAe,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,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,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,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAqB;IACvD,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,aAAa,EAAE,YAAY,EAAE;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;IAChG,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO;YACL,QAAQ,EAAE,aAAa;YACvB,KAAK,EAAE,MAAM;YACb,SAAS,EAAE,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;YACxE,SAAS,EAAE,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY;SACjF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,IAAI,KAAK,IAAI,SAAS,CAAC;AACvC,CAAC;AAED,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,MAAM,UAAU,uBAAuB,CAAC,OAAqB;IAC3D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,IAAI,KAAK,KAAK,OAAO;YAAE,aAAa,GAAG,IAAI,CAAC;QAC5C,OAAO;IACT,CAAC;IACD,KAAK,GAAG,OAAO,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,eAAe,EAAE,CAAC,WAAW,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,SAAkB;IAC1E,gBAAgB,GAAG;QACjB,SAAS;QACT,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,yBAAyB;KAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,GAAG,IAAI,CAAC;IACf,KAAK,GAAG,IAAI,CAAC;IACb,aAAa,GAAG,KAAK,CAAC;IACtB,gBAAgB,GAAG,IAAI,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC1D,OAAO,GAAG,OAAO,CAAC;AACpB,CAAC;AAED,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,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,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;QACvC,UAAU,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAA2B,EAAE,OAAgC;IACtF,OAAO,YAAY,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAgC;IACtE,OAAO,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,OAAgC;IACpE,OAAO,YAAY,CAAC,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,IAAI,OAAO,GAAwB,IAAI,CAAC;AACxC,IAAI,KAAK,GAAwB,IAAI,CAAC;AACtC,IAAI,aAAa,GAAG,KAAK,CAAC;AAC1B,IAAI,gBAAgB,GAAqF,IAAI,CAAC;AAE9G,MAAM,SAAS,GAAiB;IAC9B,QAAQ;QACN,OAAO,KAAK,CAAC;IACf,CAAC;IACD,WAAW;QACT,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,CAAC,KAAK;QACT,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,CAAC,eAAe;QACnB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACpE,CAAC;CACF,CAAC;AAEF,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAgB,CAAC;AAEjD,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,SAAS,kBAAkB,CAAC,IAAyB;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjF,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"}
+{"version":3,"file":"share.js","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/share",
-  "version": "0.5.0-next.1944.cd6b6e7",
+  "version": "0.5.1-edge.638.d4dbd4e",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,12 +38,13 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/signals": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/types": "0.5.0-next.1944.cd6b6e7"
+    "@flighthq/entity": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/signals": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/types": "0.5.1-edge.638.d4dbd4e"
   },
   "devDependencies": {
     "typescript": "^5.3.0"
   },
-  "description": "Native share sheet (title, text, url, files) over a swappable web/native backend",
+  "description": "Explicit host share-sheet commands for content and portable files",
   "sideEffects": false
 }

package/src/share.test.ts

@@ -1,609 +1,195 @@
+import { createEntity } from '@flighthq/entity/contract';
 import { connectSignal } from '@flighthq/signals/contract';
-import type { ShareBackend, ShareContent, ShareFile, ShareOptions, ShareResult } from '@flighthq/types/contract';
-
+import { EntityRuntimeKey } from '@flighthq/types/contract';
+import type {
+  HasShareContent,
+  HasShareFiles,
+  ShareContent,
+  ShareContentBackend,
+  ShareFilesBackend,
+  ShareResult,
+} from '@flighthq/types/contract';
+
+import * as shareContract from './contract';
 import {
   attachShareSignals,
   canShareContent,
-  createWebShareBackend,
+  canShareFiles,
   detachShareSignals,
   disposeShareSignals,
   enableShareSignals,
-  getShareBackend,
   hasShareContentFields,
-  installShareHostBackend,
-  isShareAvailable,
-  resetShareBackendForTest,
-  setShareBackend,
   shareContent,
   shareContentWithResult,
   shareFiles,
   shareText,
   shareUrl,
-  explainShareBackend,
-  observeShareHostResult,
 } from './share';
 
-function fakeBackend(
-  overrides: Partial<ShareBackend & { shared: ShareContent | null }> = {},
-): ShareBackend & { shared: ShareContent | null } {
+type ContentImplementation = Omit<ShareContentBackend, typeof EntityRuntimeKey>;
+type FilesImplementation = Omit<ShareFilesBackend, typeof EntityRuntimeKey>;
+
+function contentHost(overrides: Partial<ContentImplementation> = {}): HasShareContent {
   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;
+    share: {
+      content: createEntity({
+        canShareContent: () => true,
+        shareContent: async () => true,
+        shareContentWithResult: async () => ({ activityType: null, completed: true, dismissed: false }),
+        ...overrides,
+      } satisfies ContentImplementation),
     },
-    ...overrides,
   };
 }
 
-const originalNavigatorDescriptor = Object.getOwnPropertyDescriptor(globalThis, 'navigator');
-
-function mockNavigator(value: unknown): void {
-  Object.defineProperty(globalThis, 'navigator', { value, configurable: true });
-}
-
-function restoreNavigator(): void {
-  if (originalNavigatorDescriptor !== undefined) {
-    Object.defineProperty(globalThis, 'navigator', originalNavigatorDescriptor);
-  } else {
-    delete (globalThis as { navigator?: unknown }).navigator;
-  }
+function filesHost(overrides: Partial<FilesImplementation> = {}): HasShareFiles {
+  return {
+    share: {
+      files: createEntity({
+        canShareContent: () => true,
+        shareContent: async () => true,
+        shareContentWithResult: async () => ({ activityType: null, completed: true, dismissed: false }),
+        ...overrides,
+      } satisfies FilesImplementation),
+    },
+  };
 }
 
-afterEach(() => {
-  resetShareBackendForTest();
-  restoreNavigator();
-});
+const file = { dataUrl: 'data:text/plain;base64,QQ==', mimeType: 'text/plain', name: 'a.txt' };
 
 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 () => {
+  it('enables delivery from the detailed core command', async () => {
+    const result: ShareResult = { activityType: 'mail', completed: true, dismissed: false };
+    const host = contentHost({ shareContentWithResult: async () => result });
     const signals = enableShareSignals();
+    const listener = vi.fn();
+    connectSignal(signals.onShareResult, listener);
     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);
+    expect(await shareContentWithResult(host, { title: 'flight' })).toEqual(result);
+    expect(listener).toHaveBeenCalledWith(result);
     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 sentinel when no backend is installed', () => {
-    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('validates meaningful payloads through the selected content slot', () => {
+    const can = vi.fn(() => true);
+    const host = contentHost({ canShareContent: can });
+    expect(canShareContent(host, { text: 'hello' })).toBe(true);
+    expect(can).toHaveBeenCalledWith({ text: 'hello' });
 
-  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);
+    // @ts-expect-error an empty object is not a meaningful Share content payload
+    expect(canShareContent(contentHost(), {})).toBe(false);
   });
 });
 
-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();
-    mockNavigator({
-      share: async () => {
-        const err = new Error('User aborted');
-        err.name = 'AbortError';
-        throw err;
-      },
-      canShare: () => true,
-    });
-    const result = await backend.shareWithResult({ text: 'hi' });
-    expect(result.completed).toBe(false);
-    expect(result.dismissed).toBe(true);
-  });
-
-  it('shareWithResult returns dismissed=false on non-AbortError', async () => {
-    const backend = createWebShareBackend();
-    mockNavigator({
-      share: async () => {
-        const err = new Error('Data error');
-        err.name = 'DataError';
-        throw err;
-      },
-      canShare: () => true,
-    });
-    const result = await backend.shareWithResult({ text: 'hi' });
-    expect(result.completed).toBe(false);
-    expect(result.dismissed).toBe(false);
-  });
-
-  it('isAvailable returns true when navigator.share exists', () => {
-    mockNavigator({ share: async () => {} });
-    const backend = createWebShareBackend();
-    expect(backend.isAvailable()).toBe(true);
-  });
-
-  it('canShare delegates files to navigator.canShare', () => {
-    let passedData: ShareData | undefined;
-    mockNavigator({
-      share: async () => {},
-      canShare: (data: ShareData) => {
-        passedData = data;
-        return 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);
+describe('canShareFiles', () => {
+  it('validates through the files slot only for non-empty lists', () => {
+    const host = filesHost();
+    expect(canShareFiles(host, [file])).toBe(true);
+    expect(canShareFiles(host, [])).toBe(false);
   });
 });
 
 describe('detachShareSignals', () => {
-  it('is safe to call when not attached', () => {
+  it('stops delivery without clearing the signal Entity', async () => {
     const signals = enableShareSignals();
-    expect(() => detachShareSignals(signals)).not.toThrow();
+    const listener = vi.fn();
+    connectSignal(signals.onShareResult, listener);
+    attachShareSignals(signals);
+    detachShareSignals(signals);
+    await shareContentWithResult(contentHost(), { title: 'quiet' });
+    expect(listener).not.toHaveBeenCalled();
   });
 });
 
 describe('disposeShareSignals', () => {
-  it('releases signal group without throwing', () => {
+  it('dispose detaches and clears listeners', async () => {
     const signals = enableShareSignals();
+    const listener = vi.fn();
+    connectSignal(signals.onShareResult, listener);
     attachShareSignals(signals);
-    expect(() => disposeShareSignals(signals)).not.toThrow();
+    disposeShareSignals(signals);
+    await shareContentWithResult(contentHost(), { text: 'quiet' });
+    expect(listener).not.toHaveBeenCalled();
   });
 });
 
 describe('enableShareSignals', () => {
-  it('returns a signals group with onShareResult signal', () => {
-    const signals = enableShareSignals();
-    expect(signals.onShareResult).toBeDefined();
-  });
-});
-
-describe('explainShareBackend', () => {
-  afterEach(() => resetShareBackendForTest());
-
-  it('reports host-not-enabled when no backend is installed', () => {
-    resetShareBackendForTest();
-    const explanation = explainShareBackend();
-    expect(explanation.layer).toBe('host-not-enabled');
-    expect(explanation.conflict).toBe(false);
-    expect(explanation.viability).toBe('unobserved');
-  });
-
-  it('reports custom layer when a custom backend is set', () => {
-    setShareBackend(fakeBackend());
-    expect(explainShareBackend().layer).toBe('custom');
-  });
-
-  it('reports host layer when a host backend is installed', () => {
-    installShareHostBackend(fakeBackend());
-    expect(explainShareBackend().layer).toBe('host');
-  });
-
-  it('reports conflict when two different host backends are installed', () => {
-    installShareHostBackend(fakeBackend());
-    installShareHostBackend(fakeBackend());
-    expect(explainShareBackend().conflict).toBe(true);
-  });
-});
-
-describe('getShareBackend', () => {
-  it('falls back to the sentinel when no backend is installed', () => {
-    expect(getShareBackend()).not.toBeNull();
-  });
-
-  it('returns the registered backend', () => {
-    const backend = fakeBackend();
-    setShareBackend(backend);
-    expect(getShareBackend()).toBe(backend);
+  it('returns an Entity-composed signal group', () => {
+    expect(EntityRuntimeKey in enableShareSignals()).toBe(true);
   });
 });
 
 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('installShareHostBackend', () => {
-  afterEach(() => resetShareBackendForTest());
-
-  it('installs a host backend that getShareBackend returns', () => {
-    const backend = fakeBackend();
-    installShareHostBackend(backend);
-    expect(getShareBackend()).toBe(backend);
-  });
-
-  it('is first-host-wins: a second different backend sets conflict', () => {
-    const first = fakeBackend();
-    const second = fakeBackend();
-    installShareHostBackend(first);
-    installShareHostBackend(second);
-    expect(getShareBackend()).toBe(first);
-    expect(explainShareBackend().conflict).toBe(true);
-  });
-});
-
-describe('isShareAvailable', () => {
-  it('returns false from the sentinel when no backend is installed', () => {
-    expect(isShareAvailable()).toBe(false);
-  });
-
-  it('returns true when the backend reports available', () => {
-    setShareBackend(fakeBackend());
-    expect(isShareAvailable()).toBe(true);
-  });
-
-  it('returns true when the web backend is installed and navigator.share exists', () => {
-    mockNavigator({ share: async () => {} });
-    installShareHostBackend(createWebShareBackend());
-    expect(isShareAvailable()).toBe(true);
-  });
-});
-
-describe('observeShareHostResult', () => {
-  afterEach(() => resetShareBackendForTest());
-
-  it('records a successful observation', () => {
-    installShareHostBackend(fakeBackend());
-    observeShareHostResult('canShare', true);
-    const explanation = explainShareBackend();
-    expect(explanation.operation).toBe('canShare');
-    expect(explanation.viability).toBe('available');
-  });
-
-  it('records a failed observation', () => {
-    installShareHostBackend(fakeBackend());
-    observeShareHostResult('canShare', false);
-    expect(explainShareBackend().viability).toBe('runtime-api-unavailable');
-  });
-});
-
-describe('resetShareBackendForTest', () => {
-  it('clears all backend slots', () => {
-    setShareBackend(fakeBackend());
-    installShareHostBackend(fakeBackend());
-    observeShareHostResult('canShare', true);
-    resetShareBackendForTest();
-    expect(explainShareBackend().layer).toBe('host-not-enabled');
-    expect(explainShareBackend().conflict).toBe(false);
-    expect(explainShareBackend().viability).toBe('unobserved');
-  });
-});
-
-describe('setShareBackend', () => {
-  it('clears back to the sentinel when passed null', () => {
-    setShareBackend(fakeBackend());
-    setShareBackend(null);
-    expect(getShareBackend()).not.toBeNull();
+  it.each<ShareContent>([{ title: 'T' }, { text: 'T' }, { url: 'https://flight.dev' }])(
+    'accepts a meaningful content vector',
+    (content) => expect(hasShareContentFields(content)).toBe(true),
+  );
+});
+
+describe('Share contract surface', () => {
+  it('contains only explicit-host commands, payload validation, and core signal lifecycle', () => {
+    expect(Object.keys(shareContract).sort()).toEqual([
+      'attachShareSignals',
+      'canShareContent',
+      'canShareFiles',
+      'detachShareSignals',
+      'disposeShareSignals',
+      'enableShareSignals',
+      'hasShareContentFields',
+      'shareContent',
+      'shareContentWithResult',
+      'shareFiles',
+      'shareText',
+      'shareUrl',
+    ]);
   });
 });
 
 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 sentinel when no backend is installed', 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] });
+  it('rejects declared-but-empty content before dispatch', async () => {
+    const backend = vi.fn(async () => true);
+    const host = contentHost({ shareContent: backend });
+    const empty = { text: '' } as ShareContent;
+    expect(canShareContent(host, empty)).toBe(false);
+    expect(await shareContent(host, empty)).toBe(false);
+    expect(backend).not.toHaveBeenCalled();
   });
 });
 
 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 the sentinel when no backend is installed', async () => {
-    const result = await shareContentWithResult({ text: 'x' });
-    expect(result.completed).toBe(false);
+  it('returns a detailed provider outcome', async () => {
+    const result: ShareResult = { activityType: 'mail', completed: true, dismissed: false };
+    const host = contentHost({ shareContentWithResult: async () => result });
+    expect(await shareContentWithResult(host, { title: 'flight' })).toEqual(result);
   });
 });
 
 describe('shareFiles', () => {
-  const file: ShareFile = { dataUrl: 'data:text/plain;base64,aGk=', mimeType: 'text/plain', name: 'hi.txt' };
-
-  it('shares via shareContent with a files payload', async () => {
-    const backend = fakeBackend();
-    setShareBackend(backend);
-    expect(await shareFiles([file])).toBe(true);
-    expect(backend.shared).toEqual({ files: [file] });
-  });
-
-  it('passes options through', 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 files' };
-    await shareFiles([file], opts);
-    expect(passedOptions).toEqual(opts);
-  });
-
-  it('resolves false for an empty array without reaching the backend', async () => {
-    const backend = fakeBackend();
-    setShareBackend(backend);
-    expect(await shareFiles([])).toBe(false);
-    expect(backend.shared).toBeNull();
-  });
-
-  it('carries several files in order', async () => {
-    const backend = fakeBackend();
-    setShareBackend(backend);
-    const second: ShareFile = { dataUrl: 'data:text/plain,two', mimeType: 'text/plain', name: 'two.txt' };
-    await shareFiles([file, second]);
-    expect(backend.shared?.files).toEqual([file, second]);
+  it('dispatches a non-empty portable file tuple', async () => {
+    const invoke = vi.fn(async (_content: Parameters<ShareFilesBackend['shareContent']>[0]) => true);
+    const host = filesHost({ shareContent: invoke });
+    expect(await shareFiles(host, [file])).toBe(true);
+    expect(await shareFiles(host, [])).toBe(false);
+    expect(invoke).toHaveBeenCalledTimes(1);
+    expect(invoke.mock.calls[0]?.[0].files).toEqual([file]);
   });
 });
 
 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);
+  it('delegates text through the content slot', async () => {
+    const invoke = vi.fn(async (_content: Parameters<ShareContentBackend['shareContent']>[0]) => true);
+    expect(await shareText(contentHost({ shareContent: invoke }), 'hello')).toBe(true);
+    expect(invoke).toHaveBeenCalledWith({ text: 'hello' });
   });
 });
 
 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);
-  });
-});
-
-describe('web backend file conversion', () => {
-  it('reports a malformed data URL as unshareable rather than sending the wrong bytes', () => {
-    // A dataUrl with no comma used to slip through: indexOf returned -1, so the header read as ''
-    // and the body as the whole string, and the converter produced a plausible File containing the
-    // URL text. Failing to the ordinary false sentinel is the honest answer.
-    mockNavigator({ share: () => Promise.resolve(), canShare: () => true });
-    const backend = createWebShareBackend();
-    expect(
-      backend.canShare({ files: [{ dataUrl: 'data:text/plain;base64', mimeType: 'text/plain', name: 'a.txt' }] }),
-    ).toBe(false);
-  });
-
-  it('still converts a well-formed data URL', () => {
-    mockNavigator({ share: () => Promise.resolve(), canShare: () => true });
-    const backend = createWebShareBackend();
-    expect(
-      backend.canShare({ files: [{ dataUrl: 'data:text/plain;base64,aGk=', mimeType: 'text/plain', name: 'a.txt' }] }),
-    ).toBe(true);
-  });
-
-  it('rejects a malformed data URL on the share path too, not only the probe', async () => {
-    mockNavigator({ share: () => Promise.resolve(), canShare: () => true });
-    const backend = createWebShareBackend();
-    expect(await backend.share({ files: [{ dataUrl: 'nope', mimeType: 'text/plain', name: 'a.txt' }] })).toBe(false);
+  it('delegates a URL through the content slot', async () => {
+    const invoke = vi.fn(async (_content: Parameters<ShareContentBackend['shareContent']>[0]) => true);
+    expect(await shareUrl(contentHost({ shareContent: invoke }), 'https://flight.dev')).toBe(true);
+    expect(invoke).toHaveBeenCalledWith({ url: 'https://flight.dev' });
   });
 });

package/src/shareExplicit.test.ts

@@ -0,0 +1,30 @@
+import { createEntity } from '@flighthq/entity/contract';
+import type { EntityRuntimeKey, HasShareContent, ShareContentBackend } from '@flighthq/types/contract';
+
+import { shareText } from './share';
+
+function createRecordingHost(label: string, calls: string[]): HasShareContent {
+  const content = createEntity({
+    canShareContent: () => true,
+    async shareContent(payload) {
+      calls.push(`${label}:${payload.text ?? ''}`);
+      return true;
+    },
+    async shareContentWithResult() {
+      return { activityType: null, completed: true, dismissed: false };
+    },
+  } satisfies Omit<ShareContentBackend, typeof EntityRuntimeKey>);
+  return { share: { content } };
+}
+
+describe('explicit Share host isolation', () => {
+  it('routes two live hosts to their own content providers', async () => {
+    const calls: string[] = [];
+    const first = createRecordingHost('first', calls);
+    const second = createRecordingHost('second', calls);
+
+    expect(await shareText(first, 'alpha')).toBe(true);
+    expect(await shareText(second, 'beta')).toBe(true);
+    expect(calls).toEqual(['first:alpha', 'second:beta']);
+  });
+});