@appstrata/player-lib 0.1.1 → 1.0.0

package/README.md

@@ -47,9 +47,7 @@ const host = createAppHost({
   services: { storage, proxy },
   target: iframe.contentWindow!,
   targetOrigin: "*",
-  notifyComplete: () => { /* handle playback complete */ },
-  notifyNoContent: (options) => { /* handle no content */ },
-  notifyEstimatedEnd: (expectedFinishTime) => { /* handle estimation */ },
+  markComplete: () => { /* handle playback complete */ },
   log: (level, msg, data) => console.log(`[${level}]`, msg, data),
 });
 
@@ -105,9 +103,7 @@ High-level helper for hosting an AppStrata app.
 - `target: Window` - Target window (typically `iframe.contentWindow`)
 - `transport?: Transport` - Optional transport (auto-created from target/targetOrigin if not provided)
 - `targetOrigin?: string` - Target origin for the default transport (default: `"*"`)
-- `notifyComplete: () => void` - Callback when app signals playback complete
-- `notifyEstimatedEnd: (expectedFinishTime: number) => void` - Callback when app provides estimated finish time (Unix ms)
-- `notifyNoContent: (options?) => void` - Callback when app signals no content (`{ retryNotBefore?: number; reason?: string }`)
+- `markComplete: () => void` - Callback when app signals playback complete
 - `log: (level, message, data?) => void` - Logging callback
 - `debug?: boolean` - Enable debug logging (default: `false`)
 - `retryInterval?: number` - READY retry interval in ms (default: `1000`)

package/dist/app-host.d.ts

@@ -104,30 +104,11 @@ export interface CreateAppHostOptions {
      */
     maxRetries?: number;
     /**
-     * Called when the app signals it has finished playback.
+     * Implementation for markComplete.
      * Vendors MUST provide their own implementation.
+     * This method is called when an app signals it has finished playback.
      */
-    notifyComplete: () => void;
-    /**
-     * Called when the app provides an estimated finish time.
-     * Vendors MUST provide their own implementation.
-     *
-     * @param expectedFinishTime - Absolute epoch timestamp in ms (already
-     *   converted from the app-facing totalDuration/finishTime by the SDK)
-     */
-    notifyEstimatedEnd: (expectedFinishTime: number) => void;
-    /**
-     * Called when the app signals it has no content to display.
-     * Vendors MUST provide their own implementation.
-     *
-     * @param options - Optional retry and reason info
-     * @param options.retryNotBefore - Earliest time to retry (epoch timestamp in ms)
-     * @param options.reason - Human-readable reason
-     */
-    notifyNoContent: (options?: {
-        retryNotBefore?: number;
-        reason?: string;
-    }) => void;
+    markComplete: () => void;
     /**
      * Implementation for logging.
      * Vendors MUST provide their own implementation.
@@ -146,7 +127,7 @@ export interface CreateAppHostOptions {
  * const host = createAppHost({
  *   services: { storage, proxy },
  *   target: iframe.contentWindow!,
- *   notifyComplete: () => { ... },
+ *   markComplete: () => { ... },
  *   log: (level, msg) => console.log(msg),
  * });
  *

package/dist/app-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-host.d.ts","sourceRoot":"","sources":["../src/app-host.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,UAAU,EAEf,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAUrD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,OAAO;IACtB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;IAEjB;;OAEG;IACH,SAAS,IAAI,IAAI,CAAC;IAElB;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;IAEjB;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;IAEjB;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAEzC;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAEnD;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,EAAE,kBAAkB,CAAC;IAE7B;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,cAAc,EAAE,MAAM,IAAI,CAAC;IAE3B;;;;;;OAMG;IACH,kBAAkB,EAAE,CAAC,kBAAkB,EAAE,MAAM,KAAK,IAAI,CAAC;IAEzD;;;;;;;OAOG;IACH,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAElF;;;;;;;OAOG;IACH,GAAG,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACjE;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CA6NT"}
+{"version":3,"file":"app-host.d.ts","sourceRoot":"","sources":["../src/app-host.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,UAAU,EAEf,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAUrD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,OAAO;IACtB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;IAEjB;;OAEG;IACH,SAAS,IAAI,IAAI,CAAC;IAElB;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;IAEjB;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;IAEjB;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAEzC;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAEnD;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,EAAE,kBAAkB,CAAC;IAE7B;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,YAAY,EAAE,MAAM,IAAI,CAAC;IAEzB;;;;;;;OAOG;IACH,GAAG,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACjE;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAmNT"}

package/dist/app-host.js

@@ -19,7 +19,7 @@ import { MessageBridge, createPostMessageTransport, } from "@appstrata/protocol"
  * const host = createAppHost({
  *   services: { storage, proxy },
  *   target: iframe.contentWindow!,
- *   notifyComplete: () => { ... },
+ *   markComplete: () => { ... },
  *   log: (level, msg) => console.log(msg),
  * });
  *
@@ -31,7 +31,7 @@ import { MessageBridge, createPostMessageTransport, } from "@appstrata/protocol"
  * ```
  */
 export function createAppHost(options) {
-    const { services, transport, target, targetOrigin = "*", retryInterval, maxRetries, notifyComplete, notifyEstimatedEnd, notifyNoContent, log, } = options;
+    const { services, transport, target, targetOrigin = "*", retryInterval, maxRetries, markComplete, log, } = options;
     // ═══════════════════════════════════════════════════════════════════════
     // Internal state
     // ═══════════════════════════════════════════════════════════════════════
@@ -80,14 +80,8 @@ export function createAppHost(options) {
         onHide(handler) { handlers.onHide.push(handler); },
         onStop(handler) { handlers.onStop.push(handler); },
         onContextChange(handler) { handlers.onContextChange.push(handler); },
-        notifyComplete() {
-            notifyComplete();
-        },
-        notifyEstimatedEnd(options) {
-            notifyEstimatedEnd(options?.expectedFinishTime ?? options);
-        },
-        notifyNoContent(options) {
-            notifyNoContent(options);
+        markComplete() {
+            markComplete();
         },
         storage: services.storage,
         proxy: services.proxy,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appstrata/player-lib",
-  "version": "0.1.1",
+  "version": "1.0.0",
   "description": "AppStrata Player Library - Helpers for platform vendors implementing compliant players",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,8 +26,8 @@
     "access": "restricted"
   },
   "dependencies": {
-    "@appstrata/core": "0.1.1",
-    "@appstrata/protocol": "0.1.1"
+    "@appstrata/protocol": "1.0.0",
+    "@appstrata/core": "1.0.0"
   },
   "devDependencies": {
     "@jest/globals": "^29.7.0",