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

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/protocol`. The `@fli
 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/protocol@0.5.0-next.1944.cd6b6e7](https://github.com/flighthq/flight/tree/cd6b6e71eb472b3a4249830a7743333f019fa7b7/packages/protocol)
-- [License](https://github.com/flighthq/flight/blob/cd6b6e71eb472b3a4249830a7743333f019fa7b7/LICENSE.md)
+- [Source for @flighthq/protocol@0.5.1-edge.638.d4dbd4e](https://github.com/flighthq/flight/tree/d4dbd4e347dc8be10b180c85a766ab50333dcb51/packages/protocol)
+- [License](https://github.com/flighthq/flight/blob/d4dbd4e347dc8be10b180c85a766ab50333dcb51/LICENSE.md)

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { attachProtocolHandler, createProtocolHandler, createProtocolUrl, detachProtocolHandler, disposeProtocolHandler, explainProtocolBackend, getProtocolLaunchUrl, getRegisteredProtocolSchemes, isProtocolSchemeDefault, isProtocolSchemeRegistered, isValidProtocolScheme, parseProtocolUrl, registerProtocolScheme, registerProtocolSchemes, removeProtocolSchemeAsDefault, setProtocolSchemeAsDefault, unregisterProtocolScheme, unregisterProtocolSchemes, } from './contract';
+export { attachProtocolHandler, createProtocolHandler, createProtocolUrl, detachProtocolHandler, disposeProtocolHandler, getProtocolLaunchUrl, getRegisteredProtocolSchemes, isProtocolSchemeDefault, isProtocolSchemeRegistered, isValidProtocolScheme, parseProtocolUrl, registerProtocolScheme, registerProtocolSchemes, removeProtocolSchemeAsDefault, setProtocolSchemeAsDefault, unregisterProtocolScheme, unregisterProtocolSchemes, } 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,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,6BAA6B,EAC7B,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,6BAA6B,EAC7B,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { attachProtocolHandler, createProtocolHandler, createProtocolUrl, detachProtocolHandler, disposeProtocolHandler, explainProtocolBackend, getProtocolLaunchUrl, getRegisteredProtocolSchemes, isProtocolSchemeDefault, isProtocolSchemeRegistered, isValidProtocolScheme, parseProtocolUrl, registerProtocolScheme, registerProtocolSchemes, removeProtocolSchemeAsDefault, setProtocolSchemeAsDefault, unregisterProtocolScheme, unregisterProtocolSchemes, } from './contract';
+export { attachProtocolHandler, createProtocolHandler, createProtocolUrl, detachProtocolHandler, disposeProtocolHandler, getProtocolLaunchUrl, getRegisteredProtocolSchemes, isProtocolSchemeDefault, isProtocolSchemeRegistered, isValidProtocolScheme, parseProtocolUrl, registerProtocolScheme, registerProtocolSchemes, removeProtocolSchemeAsDefault, setProtocolSchemeAsDefault, unregisterProtocolScheme, unregisterProtocolSchemes, } 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,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,6BAA6B,EAC7B,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,6BAA6B,EAC7B,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/protocol.d.ts

@@ -1,25 +1,19 @@
-import type { BackendExplanation, ParsedProtocolUrl, ProtocolBackend, ProtocolHandler } from '@flighthq/types/contract';
-export declare function attachProtocolHandler(handler: ProtocolHandler): void;
+import type { HasProtocolDefault, HasProtocolLaunch, HasProtocolOpen, HasProtocolRegistration, HasProtocolRegistrationQuery, HasProtocolUnregistration, ParsedProtocolUrl, ProtocolHandler } from '@flighthq/types/contract';
+export declare function attachProtocolHandler(host: HasProtocolOpen, handler: ProtocolHandler): void;
 export declare function createProtocolHandler(): ProtocolHandler;
 export declare function createProtocolUrl(parts: Readonly<Partial<ParsedProtocolUrl>>): string;
 export declare function detachProtocolHandler(handler: ProtocolHandler): void;
 export declare function disposeProtocolHandler(handler: ProtocolHandler): void;
-export declare function explainProtocolBackend(): BackendExplanation;
-export declare function getProtocolBackend(): ProtocolBackend;
-export declare function getProtocolLaunchUrl(): string | null;
-export declare function getRegisteredProtocolSchemes(): readonly string[];
-export declare function installProtocolHostBackend(backend: ProtocolBackend): void;
-export declare function isProtocolSchemeDefault(scheme: string): boolean;
-export declare function isProtocolSchemeRegistered(scheme: string): boolean;
+export declare function getProtocolLaunchUrl(host: HasProtocolLaunch): string | null;
+export declare function getRegisteredProtocolSchemes(host: HasProtocolRegistration): readonly string[];
+export declare function isProtocolSchemeDefault(host: HasProtocolDefault, scheme: string): boolean;
+export declare function isProtocolSchemeRegistered(host: HasProtocolRegistrationQuery, scheme: string): boolean;
 export declare function isValidProtocolScheme(scheme: string): boolean;
-export declare function observeProtocolHostResult(operation: string, succeeded: boolean): void;
 export declare function parseProtocolUrl(url: string): ParsedProtocolUrl | null;
-export declare function registerProtocolScheme(scheme: string): boolean;
-export declare function registerProtocolSchemes(schemes: readonly string[]): boolean;
-export declare function removeProtocolSchemeAsDefault(scheme: string): boolean;
-export declare function resetProtocolBackendForTest(): void;
-export declare function setProtocolBackend(backend: ProtocolBackend | null): void;
-export declare function setProtocolSchemeAsDefault(scheme: string): boolean;
-export declare function unregisterProtocolScheme(scheme: string): boolean;
-export declare function unregisterProtocolSchemes(schemes: readonly string[]): boolean;
+export declare function registerProtocolScheme(host: HasProtocolRegistration, scheme: string): boolean;
+export declare function registerProtocolSchemes(host: HasProtocolRegistration, schemes: readonly string[]): boolean;
+export declare function removeProtocolSchemeAsDefault(host: HasProtocolDefault, scheme: string): boolean;
+export declare function setProtocolSchemeAsDefault(host: HasProtocolDefault, scheme: string): boolean;
+export declare function unregisterProtocolScheme(host: HasProtocolUnregistration, scheme: string): boolean;
+export declare function unregisterProtocolSchemes(host: HasProtocolUnregistration, schemes: readonly string[]): boolean;
 //# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAOxH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAUpE;AAID,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD;AAKD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAgBrF;AAGD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAMpE;AAID,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAErE;AAED,wBAAgB,sBAAsB,IAAI,kBAAkB,CAa3D;AAGD,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAKD,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAEpD;AAID,wBAAgB,4BAA4B,IAAI,SAAS,MAAM,EAAE,CAEhE;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAMzE;AAID,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE/D;AAGD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAElE;AAMD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAK7D;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAKrF;AAMD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAuDtE;AAKD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAG9D;AAID,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAO3E;AAID,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErE;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAKlD;AAGD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAExE;AAID,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAElE;AAID,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhE;AAGD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAO7E"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,4BAA4B,EAC5B,yBAAyB,EACzB,iBAAiB,EACjB,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAElC,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAO3F;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAkBrF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAGpE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAGrE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAE3E;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,uBAAuB,GAAG,SAAS,MAAM,EAAE,CAE7F;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzF;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,4BAA4B,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtG;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAK7D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAwCtE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7F;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAQ1G;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE/F;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5F;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,yBAAyB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjG;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAQ9G"}

package/dist/protocol.js

@@ -1,28 +1,13 @@
-import { createSignal, emitSignal } from '@flighthq/signals/contract';
-// Begins delivering deep-link opens to `handler`'s signal by subscribing to the active backend. Wires
-// subscribe→onOpenUrl. Idempotent: a prior subscription is torn down first. Drains any URLs that
-// arrived before this call (buffered by the backend between process start and first attach) and
-// emits each one before activating the live subscription. Pair with
-// detachProtocolHandler/disposeProtocolHandler.
-export function attachProtocolHandler(handler) {
+import { createEntity } from '@flighthq/entity/contract';
+import { clearSignal, createSignal, emitSignal } from '@flighthq/signals/contract';
+export function attachProtocolHandler(host, handler) {
     detachProtocolHandler(handler);
-    const backend = getProtocolBackend();
-    // Drain URLs that arrived between process start and first attach (pre-attach burst).
-    const pending = backend.drainPendingUrls();
-    for (const url of pending) {
-        emitSignal(handler.onOpenUrl, url);
-    }
-    const unsubscribe = backend.subscribe((url) => emitSignal(handler.onOpenUrl, url));
-    _subscriptions.set(handler, unsubscribe);
+    const backend = host.protocol.open;
+    _subscriptions.set(handler, backend.subscribe((url) => emitSignal(handler.onOpenUrl, url)));
 }
-// Allocates a ProtocolHandler event entity with an inert signal; call attachProtocolHandler to start
-// delivery.
 export function createProtocolHandler() {
-    return { onOpenUrl: createSignal() };
+    return createEntity({ onOpenUrl: createSignal() });
 }
-// Builds a protocol URL string from its parsed components. scheme, host, path, and query are all
-// optional; the result is always a valid absolute URI string. Round-trips with parseProtocolUrl for
-// well-formed inputs.
 export function createProtocolUrl(parts) {
     const scheme = parts.scheme ?? 'unknown';
     const host = parts.host ?? '';
@@ -32,77 +17,36 @@ export function createProtocolUrl(parts) {
     const normalizedPath = path && !path.startsWith('/') ? `/${path}` : path;
     let url = `${scheme}:${authority}${normalizedPath}`;
     if (query) {
-        const entries = Object.entries(query).filter(([k]) => k.length > 0);
+        const entries = Object.entries(query).filter(([key]) => key.length > 0);
         if (entries.length > 0) {
-            const qs = entries.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join('&');
-            url += `?${qs}`;
+            const queryString = entries
+                .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`)
+                .join('&');
+            url += `?${queryString}`;
         }
     }
     return url;
 }
-// Stops delivery to `handler` and forgets its subscription. Safe to call when not attached.
 export function detachProtocolHandler(handler) {
-    const unsubscribe = _subscriptions.get(handler);
-    if (unsubscribe !== undefined) {
-        unsubscribe();
-        _subscriptions.delete(handler);
-    }
+    _subscriptions.get(handler)?.();
+    _subscriptions.delete(handler);
 }
-// Releases `handler` for garbage collection by detaching its backend subscription. The signal remains
-// plain GC-managed memory afterward.
 export function disposeProtocolHandler(handler) {
     detachProtocolHandler(handler);
+    clearSignal(handler.onOpenUrl);
 }
-export function explainProtocolBackend() {
-    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 getProtocolLaunchUrl(host) {
+    return host.protocol.launch.getLaunchUrl();
 }
-// The active protocol backend. Precedence: custom > host > sentinel.
-export function getProtocolBackend() {
-    return _custom ?? _host ?? _sentinel;
+export function getRegisteredProtocolSchemes(host) {
+    return host.protocol.registration.getRegisteredSchemes();
 }
-// Returns the URL the app was launched with via a deep link (cold start), or null when the app was
-// not launched via a link. This is a one-shot idempotent query — re-readable. Distinct from
-// onOpenUrl, which fires only for warm (subsequent) opens.
-export function getProtocolLaunchUrl() {
-    return getProtocolBackend().getLaunchUrl();
-}
-// Returns all custom URI schemes currently registered by this app. Returns [] when the host cannot
-// enumerate registered schemes.
-export function getRegisteredProtocolSchemes() {
-    return getProtocolBackend().getRegisteredSchemes();
-}
-export function installProtocolHostBackend(backend) {
-    if (_host !== null) {
-        if (_host !== backend)
-            _hostConflict = true;
-        return;
-    }
-    _host = backend;
+export function isProtocolSchemeDefault(host, scheme) {
+    return isValidProtocolScheme(scheme) && host.protocol.default.isDefault(scheme);
 }
-// True when `scheme` is the OS default handler for deep links. Returns false where the host cannot
-// report it (e.g. the web platform).
-export function isProtocolSchemeDefault(scheme) {
-    return getProtocolBackend().isDefault(scheme);
+export function isProtocolSchemeRegistered(host, scheme) {
+    return isValidProtocolScheme(scheme) && host.protocol.registrationQuery.isRegistered(scheme);
 }
-// True when `scheme` is currently registered to this app. Returns false where the host cannot report it.
-export function isProtocolSchemeRegistered(scheme) {
-    return getProtocolBackend().isRegistered(scheme);
-}
-// Returns true when `scheme` is a valid RFC 3986 URI scheme: starts with an ASCII letter followed by
-// zero or more letters, digits, '+', '-', or '.'. Reserved schemes ('http', 'https', 'ftp', 'ftps',
-// 'mailto', 'file') are rejected to prevent OS conflicts. Scheme is lowercased before validation so
-// 'MyApp' is treated identically to 'myapp'.
 export function isValidProtocolScheme(scheme) {
     if (typeof scheme !== 'string' || scheme.length === 0)
         return false;
@@ -111,177 +55,93 @@ export function isValidProtocolScheme(scheme) {
         return false;
     return _schemePattern.test(lower);
 }
-export function observeProtocolHostResult(operation, succeeded) {
-    _hostObservation = {
-        operation,
-        viability: succeeded ? 'available' : 'runtime-api-unavailable',
-    };
-}
-// Parses a deep-link URL into its components. Returns null for malformed or non-custom-scheme URLs.
-// query values are percent-decoded. Multi-value query keys: last value wins (matches URLSearchParams
-// behavior). This function does not allocate a large object on the happy path — it reads all fields
-// before writing to avoid aliasing issues if the caller reuses a buffer.
 export function parseProtocolUrl(url) {
     if (typeof url !== 'string' || url.length === 0)
         return null;
-    const colonIdx = url.indexOf(':');
-    if (colonIdx <= 0)
+    const colonIndex = url.indexOf(':');
+    if (colonIndex <= 0)
         return null;
-    const scheme = url.slice(0, colonIdx).toLowerCase();
+    const scheme = url.slice(0, colonIndex).toLowerCase();
     if (!_schemePattern.test(scheme))
         return null;
-    let rest = url.slice(colonIdx + 1);
-    // Authority (//host)
+    let rest = url.slice(colonIndex + 1);
     let host = '';
     if (rest.startsWith('//')) {
         rest = rest.slice(2);
-        const slashIdx = rest.indexOf('/');
-        const qIdx = rest.indexOf('?');
-        let hostEnd;
-        if (slashIdx >= 0 && (qIdx < 0 || slashIdx < qIdx)) {
-            hostEnd = slashIdx;
-        }
-        else if (qIdx >= 0) {
-            hostEnd = qIdx;
-        }
-        else {
-            hostEnd = rest.length;
-        }
+        const slashIndex = rest.indexOf('/');
+        const queryIndex = rest.indexOf('?');
+        const hostEnd = slashIndex >= 0 && (queryIndex < 0 || slashIndex < queryIndex)
+            ? slashIndex
+            : queryIndex >= 0
+                ? queryIndex
+                : rest.length;
         host = rest.slice(0, hostEnd);
         rest = rest.slice(hostEnd);
     }
-    // Path and query
-    const qIdx = rest.indexOf('?');
-    let path;
-    let queryString;
-    if (qIdx >= 0) {
-        path = rest.slice(0, qIdx);
-        queryString = rest.slice(qIdx + 1);
-    }
-    else {
-        path = rest;
-        queryString = '';
-    }
-    // Decode query
+    const queryIndex = rest.indexOf('?');
+    const path = queryIndex >= 0 ? rest.slice(0, queryIndex) : rest;
+    const queryString = queryIndex >= 0 ? rest.slice(queryIndex + 1) : '';
     const query = {};
     if (queryString.length > 0) {
         for (const pair of queryString.split('&')) {
-            const eqIdx = pair.indexOf('=');
-            if (eqIdx < 0) {
-                const k = _safeDecode(pair);
-                if (k.length > 0)
-                    query[k] = '';
+            const equalsIndex = pair.indexOf('=');
+            if (equalsIndex < 0) {
+                const key = safeDecodeProtocolComponent(pair);
+                if (key.length > 0)
+                    query[key] = '';
             }
             else {
-                const k = _safeDecode(pair.slice(0, eqIdx));
-                if (k.length > 0)
-                    query[k] = _safeDecode(pair.slice(eqIdx + 1));
+                const key = safeDecodeProtocolComponent(pair.slice(0, equalsIndex));
+                if (key.length > 0)
+                    query[key] = safeDecodeProtocolComponent(pair.slice(equalsIndex + 1));
             }
         }
     }
-    return { scheme, host, path, query };
+    return { host, path, query, scheme };
 }
-// Registers a custom URI scheme (for example 'myapp') to this app. Returns false when the scheme is
-// invalid (RFC 3986 grammar, no reserved schemes) or when the host denies or does not support
-// registration.
-export function registerProtocolScheme(scheme) {
-    if (!isValidProtocolScheme(scheme))
-        return false;
-    return getProtocolBackend().register(scheme);
+export function registerProtocolScheme(host, scheme) {
+    return isValidProtocolScheme(scheme) && host.protocol.registration.register(scheme);
 }
-// Registers multiple custom URI schemes in one call. Returns false if any scheme is invalid or if any
-// registration fails.
-export function registerProtocolSchemes(schemes) {
-    const backend = getProtocolBackend();
-    let allOk = true;
+export function registerProtocolSchemes(host, schemes) {
+    if (!schemes.every(isValidProtocolScheme))
+        return false;
+    const backend = host.protocol.registration;
+    let allSucceeded = true;
     for (const scheme of schemes) {
-        if (!isValidProtocolScheme(scheme) || !backend.register(scheme))
-            allOk = false;
+        if (!backend.register(scheme))
+            allSucceeded = false;
     }
-    return allOk;
-}
-// Removes this app as the OS default handler for `scheme`. Returns false when the host denies or does
-// not support it.
-export function removeProtocolSchemeAsDefault(scheme) {
-    return getProtocolBackend().removeAsDefault(scheme);
+    return allSucceeded;
 }
-export function resetProtocolBackendForTest() {
-    _custom = null;
-    _host = null;
-    _hostConflict = false;
-    _hostObservation = null;
+export function removeProtocolSchemeAsDefault(host, scheme) {
+    return isValidProtocolScheme(scheme) && host.protocol.default.removeAsDefault(scheme);
 }
-// Installs a custom protocol backend; pass null to clear the custom override.
-export function setProtocolBackend(backend) {
-    _custom = backend;
+export function setProtocolSchemeAsDefault(host, scheme) {
+    return isValidProtocolScheme(scheme) && host.protocol.default.setAsDefault(scheme);
 }
-// Makes this app the default handler for `scheme`. Returns false when the host denies or does not
-// support it.
-export function setProtocolSchemeAsDefault(scheme) {
-    return getProtocolBackend().setAsDefault(scheme);
+export function unregisterProtocolScheme(host, scheme) {
+    return isValidProtocolScheme(scheme) && host.protocol.unregistration.unregister(scheme);
 }
-// Unregisters a previously registered custom URI scheme. Returns false when the host denies or does
-// not support unregistration.
-export function unregisterProtocolScheme(scheme) {
-    return getProtocolBackend().unregister(scheme);
-}
-// Unregisters multiple custom URI schemes in one call. Returns false if any unregistration fails.
-export function unregisterProtocolSchemes(schemes) {
-    const backend = getProtocolBackend();
-    let allOk = true;
+export function unregisterProtocolSchemes(host, schemes) {
+    if (!schemes.every(isValidProtocolScheme))
+        return false;
+    const backend = host.protocol.unregistration;
+    let allSucceeded = true;
     for (const scheme of schemes) {
         if (!backend.unregister(scheme))
-            allOk = false;
+            allSucceeded = false;
     }
-    return allOk;
+    return allSucceeded;
 }
-const _sentinel = {
-    drainPendingUrls() {
-        return [];
-    },
-    getLaunchUrl() {
-        return null;
-    },
-    getRegisteredSchemes() {
-        return [];
-    },
-    isDefault() {
-        return false;
-    },
-    isRegistered() {
-        return false;
-    },
-    register() {
-        return false;
-    },
-    removeAsDefault() {
-        return false;
-    },
-    setAsDefault() {
-        return false;
-    },
-    subscribe() {
-        return () => { };
-    },
-    unregister() {
-        return false;
-    },
-};
-// RFC 3986 scheme grammar: letter followed by zero or more letter/digit/+/-/. (lowercased).
 const _schemePattern = /^[a-z][a-z0-9+\-.]*$/;
-// Schemes that should never be claimed as custom URI handlers to avoid OS conflicts.
 const _reservedSchemes = new Set(['file', 'ftp', 'ftps', 'http', 'https', 'mailto']);
-let _custom = null;
-let _host = null;
-let _hostConflict = false;
-let _hostObservation = null;
 const _subscriptions = new WeakMap();
-function _safeDecode(s) {
+function safeDecodeProtocolComponent(value) {
     try {
-        return decodeURIComponent(s.replace(/\+/g, ' '));
+        return decodeURIComponent(value.replace(/\+/g, ' '));
     }
     catch {
-        return s;
+        return value;
     }
 }
 //# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/protocol",
-  "version": "0.5.0-next.1944.cd6b6e7",
+  "version": "0.5.1-edge.638.d4dbd4e",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,8 +38,9 @@
     "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"

package/src/protocol.test.ts

@@ -1,5 +1,7 @@
+import { createEntity } from '@flighthq/entity/contract';
 import { connectSignal } from '@flighthq/signals/contract';
-import type { ProtocolBackend } from '@flighthq/types/contract';
+import { EntityRuntimeKey } from '@flighthq/types/contract';
+import { describe, expect, it, vi } from 'vitest';
 
 import {
   attachProtocolHandler,
@@ -7,554 +9,202 @@ import {
   createProtocolUrl,
   detachProtocolHandler,
   disposeProtocolHandler,
-  explainProtocolBackend,
-  getProtocolBackend,
   getProtocolLaunchUrl,
   getRegisteredProtocolSchemes,
-  installProtocolHostBackend,
   isProtocolSchemeDefault,
   isProtocolSchemeRegistered,
   isValidProtocolScheme,
-  observeProtocolHostResult,
   parseProtocolUrl,
   registerProtocolScheme,
   registerProtocolSchemes,
   removeProtocolSchemeAsDefault,
-  resetProtocolBackendForTest,
-  setProtocolBackend,
   setProtocolSchemeAsDefault,
   unregisterProtocolScheme,
   unregisterProtocolSchemes,
 } from './protocol';
 
-function fakeBackend(): ProtocolBackend & {
-  registered: boolean;
-  defaulted: boolean;
-  launchUrl: string | null;
-  pendingUrls: string[];
-  fire: (url: string) => void;
-} {
-  let listener: ((url: string) => void) | null = null;
-  const registeredSchemes: string[] = [];
-  return {
-    registered: false,
-    defaulted: false,
-    launchUrl: null,
-    pendingUrls: [],
-    register(_scheme) {
-      this.registered = true;
-      if (!registeredSchemes.includes(_scheme)) registeredSchemes.push(_scheme);
-      return true;
-    },
-    unregister(_scheme) {
-      this.registered = false;
-      const idx = registeredSchemes.indexOf(_scheme);
-      if (idx >= 0) registeredSchemes.splice(idx, 1);
-      return true;
-    },
-    isRegistered(_scheme) {
-      return this.registered;
-    },
-    getRegisteredSchemes() {
-      return registeredSchemes.slice();
-    },
-    setAsDefault(_scheme) {
-      this.defaulted = true;
-      return true;
-    },
-    isDefault(_scheme) {
-      return this.defaulted;
-    },
-    removeAsDefault(_scheme) {
-      this.defaulted = false;
-      return true;
-    },
-    getLaunchUrl() {
-      return this.launchUrl;
-    },
-    drainPendingUrls() {
-      const drained = this.pendingUrls.slice();
-      this.pendingUrls = [];
-      return drained;
-    },
-    subscribe(l) {
-      listener = l;
-      return () => {
-        listener = null;
-      };
-    },
-    fire(url) {
-      listener?.(url);
+function createFixture() {
+  const calls: string[] = [];
+  let open: ((url: string) => void) | null = null;
+  const unsubscribe = vi.fn();
+  const host = {
+    protocol: {
+      default: createEntity({
+        isDefault: (scheme: string) => scheme === 'flight',
+        removeAsDefault: (scheme: string) => (calls.push(`removeDefault:${scheme}`), true),
+        setAsDefault: (scheme: string) => (calls.push(`default:${scheme}`), true),
+      }),
+      launch: createEntity({ getLaunchUrl: () => 'flight://cold-start' }),
+      open: createEntity({
+        subscribe(listener: (url: string) => void) {
+          open = listener;
+          return unsubscribe;
+        },
+      }),
+      registration: createEntity({
+        getRegisteredSchemes: () => ['flight'],
+        register: (scheme: string) => (calls.push(`register:${scheme}`), scheme !== 'fail'),
+      }),
+      registrationQuery: createEntity({ isRegistered: (scheme: string) => scheme === 'flight' }),
+      unregistration: createEntity({
+        unregister: (scheme: string) => (calls.push(`unregister:${scheme}`), scheme !== 'fail'),
+      }),
     },
   };
+  return { calls, emitOpen: (url: string) => open?.(url), host, unsubscribe };
 }
 
-afterEach(() => resetProtocolBackendForTest());
-
 describe('attachProtocolHandler', () => {
-  it('drains pre-attach pending URLs before subscribing', () => {
-    const backend = fakeBackend();
-    backend.pendingUrls = ['myapp://early/1', 'myapp://early/2'];
-    setProtocolBackend(backend);
-    const handler = createProtocolHandler();
-    const received: string[] = [];
-    connectSignal(handler.onOpenUrl, (url) => received.push(url));
-    attachProtocolHandler(handler);
-    expect(received).toEqual(['myapp://early/1', 'myapp://early/2']);
-    // Pending queue is cleared — a second attach does not re-deliver them.
-    attachProtocolHandler(handler);
-    expect(received).toEqual(['myapp://early/1', 'myapp://early/2']);
-  });
-
-  it('emits onOpenUrl when the backend delivers a deep link', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
+  it('forwards live opens and replaces a prior subscription', () => {
+    const first = createFixture();
+    const second = createFixture();
     const handler = createProtocolHandler();
-    let opened = '';
-    connectSignal(handler.onOpenUrl, (url) => (opened = url));
-    attachProtocolHandler(handler);
-    backend.fire('myapp://open/123');
-    expect(opened).toBe('myapp://open/123');
-  });
-
-  it('is idempotent — reattaching does not double-fire', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
-    const handler = createProtocolHandler();
-    let count = 0;
-    connectSignal(handler.onOpenUrl, () => count++);
-    attachProtocolHandler(handler);
-    attachProtocolHandler(handler);
-    backend.fire('myapp://x');
-    expect(count).toBe(1);
+    const receive = vi.fn();
+    connectSignal(handler.onOpenUrl, receive);
+    attachProtocolHandler(first.host, handler);
+    attachProtocolHandler(second.host, handler);
+    second.emitOpen('flight://warm-open');
+    expect(first.unsubscribe).toHaveBeenCalledOnce();
+    expect(receive).toHaveBeenCalledExactlyOnceWith('flight://warm-open');
   });
 });
 
 describe('createProtocolHandler', () => {
-  it('creates an entity with the open-URL signal', () => {
+  it('creates an Entity carrying the open-url signal', () => {
     const handler = createProtocolHandler();
+    expect(EntityRuntimeKey in handler).toBe(true);
     expect(handler.onOpenUrl).toBeDefined();
   });
 });
 
 describe('createProtocolUrl', () => {
-  it('builds a basic URL from all parts', () => {
-    const url = createProtocolUrl({ scheme: 'myapp', host: 'open', path: '/item/1', query: { ref: 'home' } });
-    expect(url).toBe('myapp://open/item/1?ref=home');
-  });
-
-  it('omits authority when host is empty', () => {
-    const url = createProtocolUrl({ scheme: 'myapp', path: '/action' });
-    expect(url).toBe('myapp:/action');
-  });
-
-  it('omits query when no query params', () => {
-    const url = createProtocolUrl({ scheme: 'myapp', host: 'x' });
-    expect(url).toBe('myapp://x');
+  it('normalizes the path and encodes query components', () => {
+    expect(
+      createProtocolUrl({ host: 'open', path: 'file', query: { name: 'a b', '': 'ignored' }, scheme: 'flight' }),
+    ).toBe('flight://open/file?name=a%20b');
   });
 
-  it('percent-encodes query keys and values', () => {
-    const url = createProtocolUrl({ scheme: 'myapp', query: { 'a b': 'c d' } });
-    expect(url).toContain('a%20b=c%20d');
-  });
-
-  it('round-trips with parseProtocolUrl', () => {
-    const parts = { scheme: 'myapp', host: 'host', path: '/path', query: { k: 'v' } };
-    const url = createProtocolUrl(parts);
-    const parsed = parseProtocolUrl(url);
-    expect(parsed?.scheme).toBe('myapp');
-    expect(parsed?.host).toBe('host');
-    expect(parsed?.path).toBe('/path');
-    expect(parsed?.query['k']).toBe('v');
+  it('supports authority-free URLs', () => {
+    expect(createProtocolUrl({ path: '/open', scheme: 'flight' })).toBe('flight:/open');
   });
 });
 
 describe('detachProtocolHandler', () => {
-  it('stops further delivery', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
+  it('unsubscribes the current provider exactly once', () => {
+    const fixture = createFixture();
     const handler = createProtocolHandler();
-    let opened = 0;
-    connectSignal(handler.onOpenUrl, () => opened++);
-    attachProtocolHandler(handler);
+    attachProtocolHandler(fixture.host, handler);
     detachProtocolHandler(handler);
-    backend.fire('myapp://x');
-    expect(opened).toBe(0);
-  });
-
-  it('is safe when not attached', () => {
-    const handler = createProtocolHandler();
-    expect(() => detachProtocolHandler(handler)).not.toThrow();
+    detachProtocolHandler(handler);
+    expect(fixture.unsubscribe).toHaveBeenCalledOnce();
   });
 });
 
 describe('disposeProtocolHandler', () => {
-  it('detaches the subscription', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
+  it('detaches and clears signal listeners', () => {
+    const fixture = createFixture();
     const handler = createProtocolHandler();
-    attachProtocolHandler(handler);
-    expect(() => disposeProtocolHandler(handler)).not.toThrow();
-  });
-
-  it('stops delivery after dispose', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
-    const handler = createProtocolHandler();
-    let count = 0;
-    connectSignal(handler.onOpenUrl, () => count++);
-    attachProtocolHandler(handler);
+    const receive = vi.fn();
+    connectSignal(handler.onOpenUrl, receive);
+    attachProtocolHandler(fixture.host, handler);
     disposeProtocolHandler(handler);
-    backend.fire('myapp://x');
-    expect(count).toBe(0);
-  });
-});
-
-describe('explainProtocolBackend', () => {
-  it('reports host-not-enabled when no backend is installed', () => {
-    const explanation = explainProtocolBackend();
-    expect(explanation.layer).toBe('host-not-enabled');
-    expect(explanation.conflict).toBe(false);
-  });
-
-  it('reports custom layer when a custom backend is set', () => {
-    setProtocolBackend(fakeBackend());
-    const explanation = explainProtocolBackend();
-    expect(explanation.layer).toBe('custom');
-  });
-
-  it('reports host layer when a host backend is installed', () => {
-    installProtocolHostBackend(fakeBackend());
-    const explanation = explainProtocolBackend();
-    expect(explanation.layer).toBe('host');
-    expect(explanation.viability).toBe('unobserved');
-  });
-
-  it('reports observation viability after observeProtocolHostResult', () => {
-    installProtocolHostBackend(fakeBackend());
-    observeProtocolHostResult('register', true);
-    const explanation = explainProtocolBackend();
-    expect(explanation.operation).toBe('register');
-    expect(explanation.viability).toBe('available');
-  });
-
-  it('reports conflict when two different host backends are installed', () => {
-    installProtocolHostBackend(fakeBackend());
-    installProtocolHostBackend(fakeBackend());
-    const explanation = explainProtocolBackend();
-    expect(explanation.conflict).toBe(true);
-  });
-});
-
-describe('getProtocolBackend', () => {
-  it('returns the sentinel when no backend is installed', () => {
-    const backend = getProtocolBackend();
-    expect(backend).not.toBeNull();
-    expect(backend.isRegistered('myapp')).toBe(false);
-    expect(backend.drainPendingUrls()).toEqual([]);
-  });
-
-  it('returns the installed custom backend', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
-    expect(getProtocolBackend()).toBe(backend);
+    fixture.emitOpen('flight://ignored');
+    expect(fixture.unsubscribe).toHaveBeenCalledOnce();
+    expect(receive).not.toHaveBeenCalled();
   });
 });
 
 describe('getProtocolLaunchUrl', () => {
-  it('returns null when no launch URL', () => {
-    const backend = fakeBackend();
-    backend.launchUrl = null;
-    setProtocolBackend(backend);
-    expect(getProtocolLaunchUrl()).toBeNull();
-  });
-
-  it('returns the launch URL when present', () => {
-    const backend = fakeBackend();
-    backend.launchUrl = 'myapp://cold-start/item';
-    setProtocolBackend(backend);
-    expect(getProtocolLaunchUrl()).toBe('myapp://cold-start/item');
-  });
-
-  it('is idempotent — returns the same value on repeated calls', () => {
-    const backend = fakeBackend();
-    backend.launchUrl = 'myapp://x';
-    setProtocolBackend(backend);
-    expect(getProtocolLaunchUrl()).toBe('myapp://x');
-    expect(getProtocolLaunchUrl()).toBe('myapp://x');
+  it('returns the cold-start provider fact', () => {
+    expect(getProtocolLaunchUrl(createFixture().host)).toBe('flight://cold-start');
   });
 });
 
 describe('getRegisteredProtocolSchemes', () => {
-  it('returns empty when no schemes registered', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
-    expect(getRegisteredProtocolSchemes()).toEqual([]);
-  });
-
-  it('includes schemes that have been registered', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
-    registerProtocolScheme('myapp');
-    expect(getRegisteredProtocolSchemes()).toContain('myapp');
-  });
-});
-
-describe('installProtocolHostBackend', () => {
-  it('installs the host backend', () => {
-    const backend = fakeBackend();
-    installProtocolHostBackend(backend);
-    expect(getProtocolBackend()).toBe(backend);
-  });
-
-  it('first-host-wins — ignores a second different backend', () => {
-    const first = fakeBackend();
-    const second = fakeBackend();
-    installProtocolHostBackend(first);
-    installProtocolHostBackend(second);
-    expect(getProtocolBackend()).toBe(first);
+  it('returns the provider schemes', () => {
+    expect(getRegisteredProtocolSchemes(createFixture().host)).toEqual(['flight']);
   });
 });
 
 describe('isProtocolSchemeDefault', () => {
-  it('returns false by default', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
-    expect(isProtocolSchemeDefault('myapp')).toBe(false);
-  });
-
-  it('returns true after setProtocolSchemeAsDefault', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
-    setProtocolSchemeAsDefault('myapp');
-    expect(isProtocolSchemeDefault('myapp')).toBe(true);
-  });
-
-  it('returns false after removeProtocolSchemeAsDefault', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
-    setProtocolSchemeAsDefault('myapp');
-    removeProtocolSchemeAsDefault('myapp');
-    expect(isProtocolSchemeDefault('myapp')).toBe(false);
+  it('validates before querying the provider', () => {
+    const host = createFixture().host;
+    expect(isProtocolSchemeDefault(host, 'flight')).toBe(true);
+    expect(isProtocolSchemeDefault(host, 'https')).toBe(false);
   });
 });
-
 describe('isProtocolSchemeRegistered', () => {
-  it('reflects the backend registration state', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
-    expect(isProtocolSchemeRegistered('myapp')).toBe(false);
-    registerProtocolScheme('myapp');
-    expect(isProtocolSchemeRegistered('myapp')).toBe(true);
+  it('validates before querying the provider', () => {
+    const host = createFixture().host;
+    expect(isProtocolSchemeRegistered(host, 'flight')).toBe(true);
+    expect(isProtocolSchemeRegistered(host, 'https')).toBe(false);
   });
 });
-
 describe('isValidProtocolScheme', () => {
-  it('accepts valid custom schemes', () => {
-    expect(isValidProtocolScheme('myapp')).toBe(true);
-    expect(isValidProtocolScheme('my-app')).toBe(true);
-    expect(isValidProtocolScheme('my.app')).toBe(true);
-    expect(isValidProtocolScheme('my+app')).toBe(true);
-    expect(isValidProtocolScheme('app123')).toBe(true);
-  });
-
-  it('rejects schemes not starting with a letter', () => {
-    expect(isValidProtocolScheme('1app')).toBe(false);
-    expect(isValidProtocolScheme('-app')).toBe(false);
-  });
-
-  it('rejects empty and non-string inputs', () => {
-    expect(isValidProtocolScheme('')).toBe(false);
-  });
-
-  it('rejects reserved schemes', () => {
-    expect(isValidProtocolScheme('http')).toBe(false);
+  it('accepts custom grammar and rejects reserved or malformed schemes', () => {
+    expect(isValidProtocolScheme('flight+desktop')).toBe(true);
     expect(isValidProtocolScheme('https')).toBe(false);
-    expect(isValidProtocolScheme('ftp')).toBe(false);
-    expect(isValidProtocolScheme('mailto')).toBe(false);
-    expect(isValidProtocolScheme('file')).toBe(false);
-  });
-
-  it('is case-insensitive — lowercases before validation', () => {
-    expect(isValidProtocolScheme('MyApp')).toBe(true);
-    expect(isValidProtocolScheme('HTTP')).toBe(false);
+    expect(isValidProtocolScheme('1flight')).toBe(false);
   });
 });
-
-describe('observeProtocolHostResult', () => {
-  it('records observation in the explanation', () => {
-    installProtocolHostBackend(fakeBackend());
-    observeProtocolHostResult('register', false);
-    const explanation = explainProtocolBackend();
-    expect(explanation.operation).toBe('register');
-    expect(explanation.viability).toBe('runtime-api-unavailable');
-  });
-});
-
 describe('parseProtocolUrl', () => {
-  it('parses a full URL with host, path, and query', () => {
-    const result = parseProtocolUrl('myapp://host/path?foo=bar&baz=qux');
-    expect(result?.scheme).toBe('myapp');
-    expect(result?.host).toBe('host');
-    expect(result?.path).toBe('/path');
-    expect(result?.query['foo']).toBe('bar');
-    expect(result?.query['baz']).toBe('qux');
-  });
-
-  it('parses a URL with no host', () => {
-    const result = parseProtocolUrl('myapp:/action');
-    expect(result?.scheme).toBe('myapp');
-    expect(result?.host).toBe('');
-    expect(result?.path).toBe('/action');
-  });
-
-  it('parses a URL with no path', () => {
-    const result = parseProtocolUrl('myapp://host');
-    expect(result?.scheme).toBe('myapp');
-    expect(result?.host).toBe('host');
-    expect(result?.path).toBe('');
-  });
-
-  it('decodes percent-encoded query values', () => {
-    const result = parseProtocolUrl('myapp://x?key=hello%20world');
-    expect(result?.query['key']).toBe('hello world');
-  });
-
-  it('last-value-wins for duplicate query keys', () => {
-    const result = parseProtocolUrl('myapp://x?k=first&k=second');
-    expect(result?.query['k']).toBe('second');
-  });
-
-  it('returns null for malformed or empty input', () => {
-    expect(parseProtocolUrl('')).toBeNull();
-    expect(parseProtocolUrl('notaurl')).toBeNull();
-    expect(parseProtocolUrl(':noscheme')).toBeNull();
+  it('parses host, path, decoded query, and lowercase scheme', () => {
+    expect(parseProtocolUrl('FLIGHT://open/file?name=a%20b&empty')).toEqual({
+      host: 'open',
+      path: '/file',
+      query: { empty: '', name: 'a b' },
+      scheme: 'flight',
+    });
   });
 
-  it('lowercases the scheme', () => {
-    const result = parseProtocolUrl('MyApp://host');
-    expect(result?.scheme).toBe('myapp');
-  });
-
-  it('handles URL with no query string', () => {
-    const result = parseProtocolUrl('myapp://host/path');
-    expect(result?.query).toEqual({});
+  it('returns null for malformed URLs and preserves malformed escapes', () => {
+    expect(parseProtocolUrl('not-a-url')).toBeNull();
+    expect(parseProtocolUrl('flight:/open?value=%ZZ')?.query).toEqual({ value: '%ZZ' });
   });
 });
-
 describe('registerProtocolScheme', () => {
-  it('registers through the backend', () => {
-    setProtocolBackend(fakeBackend());
-    expect(registerProtocolScheme('myapp')).toBe(true);
-  });
-
-  it('returns false for an invalid scheme without calling the backend', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
-    expect(registerProtocolScheme('123invalid')).toBe(false);
-    expect(backend.registered).toBe(false);
-  });
-
-  it('returns false for a reserved scheme', () => {
-    setProtocolBackend(fakeBackend());
-    expect(registerProtocolScheme('https')).toBe(false);
+  it('delegates a valid scheme', () => {
+    const { calls, host } = createFixture();
+    expect(registerProtocolScheme(host, 'flight')).toBe(true);
+    expect(calls).toEqual(['register:flight']);
   });
 });
-
 describe('registerProtocolSchemes', () => {
-  it('registers multiple schemes and returns true when all succeed', () => {
-    setProtocolBackend(fakeBackend());
-    expect(registerProtocolSchemes(['myapp', 'myapp2'])).toBe(true);
-  });
-
-  it('returns false if any registration fails', () => {
-    const backend = fakeBackend();
-    let callCount = 0;
-    const orig = backend.register.bind(backend);
-    backend.register = (scheme) => {
-      callCount++;
-      return callCount === 1 ? orig(scheme) : false;
-    };
-    setProtocolBackend(backend);
-    expect(registerProtocolSchemes(['myapp', 'myapp2'])).toBe(false);
-  });
-
-  it('returns false and skips backend for invalid schemes in the batch', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
-    expect(registerProtocolSchemes(['myapp', 'http'])).toBe(false);
-    // 'myapp' succeeded but 'http' failed — registered reflects the partial success
-    expect(backend.registered).toBe(true);
+  it('prevalidates the full batch and aggregates provider outcomes', () => {
+    const fixture = createFixture();
+    expect(registerProtocolSchemes(fixture.host, ['flight', 'https'])).toBe(false);
+    expect(fixture.calls).toEqual([]);
+    expect(registerProtocolSchemes(fixture.host, ['flight', 'fail'])).toBe(false);
+    expect(fixture.calls).toEqual(['register:flight', 'register:fail']);
   });
 });
-
 describe('removeProtocolSchemeAsDefault', () => {
-  it('removes default status through the backend', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
-    setProtocolSchemeAsDefault('myapp');
-    expect(removeProtocolSchemeAsDefault('myapp')).toBe(true);
-    expect(isProtocolSchemeDefault('myapp')).toBe(false);
+  it('delegates a valid scheme', () => {
+    const { calls, host } = createFixture();
+    expect(removeProtocolSchemeAsDefault(host, 'flight')).toBe(true);
+    expect(calls).toEqual(['removeDefault:flight']);
   });
 });
-
-describe('resetProtocolBackendForTest', () => {
-  it('clears all backend slots', () => {
-    setProtocolBackend(fakeBackend());
-    installProtocolHostBackend(fakeBackend());
-    resetProtocolBackendForTest();
-    const explanation = explainProtocolBackend();
-    expect(explanation.layer).toBe('host-not-enabled');
-    expect(explanation.conflict).toBe(false);
-  });
-});
-
-describe('setProtocolBackend', () => {
-  it('clears back to the sentinel when passed null', () => {
-    setProtocolBackend(fakeBackend());
-    setProtocolBackend(null);
-    const backend = getProtocolBackend();
-    expect(backend).not.toBeNull();
-    expect(backend.isRegistered('myapp')).toBe(false);
-  });
-});
-
 describe('setProtocolSchemeAsDefault', () => {
-  it('marks the scheme as default through the backend', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
-    expect(setProtocolSchemeAsDefault('myapp')).toBe(true);
-    expect(backend.defaulted).toBe(true);
+  it('delegates a valid scheme', () => {
+    const { calls, host } = createFixture();
+    expect(setProtocolSchemeAsDefault(host, 'flight')).toBe(true);
+    expect(calls).toEqual(['default:flight']);
   });
 });
-
 describe('unregisterProtocolScheme', () => {
-  it('unregisters through the backend', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
-    registerProtocolScheme('myapp');
-    expect(unregisterProtocolScheme('myapp')).toBe(true);
-    expect(backend.registered).toBe(false);
+  it('delegates a valid scheme', () => {
+    const { calls, host } = createFixture();
+    expect(unregisterProtocolScheme(host, 'flight')).toBe(true);
+    expect(calls).toEqual(['unregister:flight']);
   });
 });
-
 describe('unregisterProtocolSchemes', () => {
-  it('unregisters multiple schemes and returns true when all succeed', () => {
-    const backend = fakeBackend();
-    setProtocolBackend(backend);
-    registerProtocolScheme('myapp');
-    expect(unregisterProtocolSchemes(['myapp', 'myapp2'])).toBe(true);
-  });
-
-  it('returns false if any unregistration fails', () => {
-    const backend = fakeBackend();
-    let callCount = 0;
-    const orig = backend.unregister.bind(backend);
-    backend.unregister = (scheme) => {
-      callCount++;
-      return callCount === 1 ? orig(scheme) : false;
-    };
-    setProtocolBackend(backend);
-    expect(unregisterProtocolSchemes(['myapp', 'myapp2'])).toBe(false);
+  it('prevalidates the full batch and aggregates provider outcomes', () => {
+    const fixture = createFixture();
+    expect(unregisterProtocolSchemes(fixture.host, ['flight', 'https'])).toBe(false);
+    expect(fixture.calls).toEqual([]);
+    expect(unregisterProtocolSchemes(fixture.host, ['flight', 'fail'])).toBe(false);
+    expect(fixture.calls).toEqual(['unregister:flight', 'unregister:fail']);
   });
 });

package/src/protocolHost.test.ts

@@ -0,0 +1,53 @@
+import { createEntity } from '@flighthq/entity/contract';
+import { connectSignal } from '@flighthq/signals/contract';
+import { EntityRuntimeKey } from '@flighthq/types/contract';
+import { describe, expect, it, vi } from 'vitest';
+
+import * as protocolContract from './contract';
+import { attachProtocolHandler, createProtocolHandler, getProtocolLaunchUrl, registerProtocolScheme } from './protocol';
+
+describe('protocol explicit Host ownership', () => {
+  it('uses a promoted top-level protocol group for independent command and query slots', () => {
+    const register = vi.fn(() => true);
+    const getLaunchUrl = vi.fn(() => 'flight://cold-start');
+    const host = {
+      protocol: {
+        launch: createEntity({ getLaunchUrl }),
+        registration: createEntity({ getRegisteredSchemes: () => ['flight'], register }),
+      },
+    };
+
+    expect(Reflect.apply(registerProtocolScheme, undefined, [host, 'flight'])).toBe(true);
+    expect(Reflect.apply(getProtocolLaunchUrl, undefined, [host])).toBe('flight://cold-start');
+    expect(register).toHaveBeenCalledExactlyOnceWith('flight');
+    expect(getLaunchUrl).toHaveBeenCalledOnce();
+  });
+
+  it('takes the live-open provider from Host and publishes an Entity', () => {
+    const listeners: { open?: (url: string) => void } = {};
+    const subscribe = vi.fn((listener: (url: string) => void) => {
+      listeners.open = listener;
+      return vi.fn();
+    });
+    const host = { protocol: { open: createEntity({ subscribe }) } };
+    const handler = createProtocolHandler();
+    let received = '';
+    connectSignal(handler.onOpenUrl, (url) => (received = url));
+
+    Reflect.apply(attachProtocolHandler, undefined, [host, handler]);
+    listeners.open?.('flight://warm-open');
+
+    expect(subscribe).toHaveBeenCalledOnce();
+    expect(received).toBe('flight://warm-open');
+    expect(EntityRuntimeKey in handler).toBe(true);
+  });
+
+  it('deletes the ambient resolver family instead of retaining a parallel API', () => {
+    expect(protocolContract).not.toHaveProperty('explainProtocolBackend');
+    expect(protocolContract).not.toHaveProperty('getProtocolBackend');
+    expect(protocolContract).not.toHaveProperty('installProtocolHostBackend');
+    expect(protocolContract).not.toHaveProperty('observeProtocolHostResult');
+    expect(protocolContract).not.toHaveProperty('resetProtocolBackendForTest');
+    expect(protocolContract).not.toHaveProperty('setProtocolBackend');
+  });
+});