@aelionsdk/capability 1.2.0-rc.1 → 1.2.0-rc.2

package/README.md

@@ -9,7 +9,7 @@ AelionSDK.
 npm install @aelionsdk/capability@next
 ```
 
-`next` currently resolves to `1.2.0-rc.1`. Product applications should normally
+`next` currently resolves to `1.2.0-rc.2`. Product applications should normally
 use the capability APIs exposed by `@aelionsdk/sdk`; this package is for custom
 preflight screens and execution hosts.
 
@@ -17,11 +17,14 @@ preflight screens and execution hosts.
 
 - browser capability probes;
 - capability reports and typed results;
+- software codec capability descriptors (not an executable codec backend);
 - fail-closed gates for required features and export profiles.
 
 A declared browser API is not proof that a codec configuration works. Run the
 relevant gate with the actual dimensions, frame rate, sample rate and channel
 count before starting a job.
+`CodecFallbackRegistry` records host-owned capabilities only; Aelion media and
+export do not route work through registered descriptors.
 
 See the [capability preflight guide](https://foyonaczy.github.io/AelionSDK/production/capability-preflight/)
 and [API reference](https://foyonaczy.github.io/AelionSDK/api/aelionsdk/capability/overview/).

package/dist/fallback.d.ts

@@ -11,14 +11,14 @@ export interface CodecIdentity {
     readonly codec: string;
 }
 /**
- * Contract for a software codec fallback backend (e.g. a WASM decoder).
+ * Capability descriptor for a host-owned software codec implementation.
  *
- * The engine negotiates through this interface but ships no backend in 1.1:
- * an application registers one after the codec strategy is chosen. The
- * interface intentionally mirrors the WebCodecs lifecycle so a future WASM
- * adapter can implement it without reshaping the negotiation path.
+ * This descriptor does not execute decode or encode work. Aelion's media and
+ * export pipelines do not invoke registered descriptors in 1.2; hosts must
+ * wire their codec implementation separately. The distinction prevents a
+ * capability declaration from being mistaken for an operational fallback.
  */
-export interface CodecFallbackProvider {
+export interface CodecFallbackDescriptor {
     /** Stable provider id, e.g. `wasm-h264`. */
     readonly id: string;
     /** True when the backend is loaded and ready to accept work. */
@@ -26,6 +26,8 @@ export interface CodecFallbackProvider {
     /** Whether this provider can execute the requested codec path. */
     supports(identity: CodecIdentity): boolean;
 }
+/** @deprecated Use CodecFallbackDescriptor; this contract describes capability, not execution. */
+export type CodecFallbackProvider = CodecFallbackDescriptor;
 /** Negotiated execution path for a single codec operation. */
 export type CodecExecutionPath = {
     readonly path: 'hardware';
@@ -48,14 +50,19 @@ export type CodecExecutionDecision = CodecExecutionPath & {
  * reports it, otherwise the first ready provider that supports the identity,
  * otherwise fail closed with a diagnostic.
  */
-export declare function selectCodecExecution(identity: CodecIdentity, hardwareSupported: boolean, providers: readonly CodecFallbackProvider[]): CodecExecutionDecision;
-/** Bounded registry of software codec fallback providers. */
+export declare function selectCodecAvailability(identity: CodecIdentity, hardwareSupported: boolean, providers: readonly CodecFallbackDescriptor[]): CodecExecutionDecision;
+/**
+ * @deprecated This selects a declared capability only; it does not route codec
+ * work. Use selectCodecAvailability and wire the chosen backend explicitly.
+ */
+export declare function selectCodecExecution(identity: CodecIdentity, hardwareSupported: boolean, providers: readonly CodecFallbackDescriptor[]): CodecExecutionDecision;
+/** Bounded registry of host-owned software codec capability descriptors. */
 export declare class CodecFallbackRegistry {
     #private;
-    register(provider: CodecFallbackProvider): void;
+    register(provider: CodecFallbackDescriptor): void;
     unregister(id: string): void;
     clear(): void;
-    providers(): readonly CodecFallbackProvider[];
+    providers(): readonly CodecFallbackDescriptor[];
 }
 /** The default process-wide registry used when no application instance is passed. */
 export declare const codecFallbackRegistry: CodecFallbackRegistry;

package/dist/fallback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../src/fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACjD,gDAAgD;AAChD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3C,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC;CAC5C;AAED,8DAA8D;AAC9D,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAErC;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,GAAG;IACxD,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C,CAAC;AAWF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,aAAa,EACvB,iBAAiB,EAAE,OAAO,EAC1B,SAAS,EAAE,SAAS,qBAAqB,EAAE,GAC1C,sBAAsB,CA4BxB;AAED,6DAA6D;AAC7D,qBAAa,qBAAqB;;IAGzB,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAO/C,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK5B,KAAK,IAAI,IAAI;IAIb,SAAS,IAAI,SAAS,qBAAqB,EAAE;CAGrD;AAED,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,uBAA8B,CAAC"}
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../src/fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACjD,gDAAgD;AAChD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3C,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC;CAC5C;AAED,kGAAkG;AAClG,MAAM,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE5D,8DAA8D;AAC9D,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAErC;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,GAAG;IACxD,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C,CAAC;AAWF;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,aAAa,EACvB,iBAAiB,EAAE,OAAO,EAC1B,SAAS,EAAE,SAAS,uBAAuB,EAAE,GAC5C,sBAAsB,CA4BxB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,aAAa,EACvB,iBAAiB,EAAE,OAAO,EAC1B,SAAS,EAAE,SAAS,uBAAuB,EAAE,GAC5C,sBAAsB,CAExB;AAED,4EAA4E;AAC5E,qBAAa,qBAAqB;;IAGzB,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IAOjD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK5B,KAAK,IAAI,IAAI;IAIb,SAAS,IAAI,SAAS,uBAAuB,EAAE;CAGvD;AAED,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,uBAA8B,CAAC"}

package/dist/fallback.js

@@ -11,7 +11,7 @@ function decisionDiagnostic(code, message, recoverable) {
  * reports it, otherwise the first ready provider that supports the identity,
  * otherwise fail closed with a diagnostic.
  */
-export function selectCodecExecution(identity, hardwareSupported, providers) {
+export function selectCodecAvailability(identity, hardwareSupported, providers) {
     if (hardwareSupported) {
         return { path: 'hardware', diagnostics: [] };
     }
@@ -21,7 +21,7 @@ export function selectCodecExecution(identity, hardwareSupported, providers) {
             path: 'fallback',
             providerId: provider.id,
             diagnostics: [
-                decisionDiagnostic('CAPABILITY_CODEC_FALLBACK_USED', `${identity.class} ${identity.operation} for ${identity.codec} runs through the ${provider.id} software fallback`, true),
+                decisionDiagnostic('CAPABILITY_CODEC_FALLBACK_USED', `${identity.class} ${identity.operation} for ${identity.codec} has a declared ${provider.id} software fallback; the host must wire its execution path`, true),
             ],
         };
     }
@@ -32,7 +32,14 @@ export function selectCodecExecution(identity, hardwareSupported, providers) {
         ],
     };
 }
-/** Bounded registry of software codec fallback providers. */
+/**
+ * @deprecated This selects a declared capability only; it does not route codec
+ * work. Use selectCodecAvailability and wire the chosen backend explicitly.
+ */
+export function selectCodecExecution(identity, hardwareSupported, providers) {
+    return selectCodecAvailability(identity, hardwareSupported, providers);
+}
+/** Bounded registry of host-owned software codec capability descriptors. */
 export class CodecFallbackRegistry {
     #providers = [];
     register(provider) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aelionsdk/capability",
-  "version": "1.2.0-rc.1",
+  "version": "1.2.0-rc.2",
   "description": "Browser media capability probing for AelionSDK",
   "license": "MIT",
   "repository": {
@@ -34,7 +34,7 @@
     "provenance": true
   },
   "dependencies": {
-    "@aelionsdk/core": "1.2.0-rc.1"
+    "@aelionsdk/core": "1.2.0-rc.2"
   },
   "scripts": {
     "build": "tsc -b",