@audiowalk/sdk 1.3.0 → 1.4.0

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./player/player-controller";
 export * from "./storage/local-storage";
+export * from "./story/story-controller";
 //# 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,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,2 +1,3 @@
 export * from "./player/player-controller";
 export * from "./storage/local-storage";
+export * from "./story/story-controller";

package/dist/player/player-controller.d.ts

@@ -17,11 +17,12 @@ export declare class PlayerController {
     readonly currentTime: BehaviorSubject<number>;
     readonly totalTime: BehaviorSubject<number>;
     readonly progress: import("rxjs").Observable<number>;
+    private trackId;
     readonly status: BehaviorSubject<PlayerStatus | null>;
     readonly playing: import("rxjs").Observable<boolean>;
     private localStorage;
     constructor(playerElement: HTMLAudioElement, options?: PlayerControllerOptions);
-    open(file: string): Promise<void>;
+    open(id: string, file: string): Promise<void>;
     setMetadata(metadata: MediaMetadataInit): void;
     close(): void;
     play(): void;

package/dist/player/player-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"player-controller.d.ts","sourceRoot":"","sources":["../../src/player/player-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAsB,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpE,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,oBAAY,YAAY;IACtB,SAAS,YAAY;IACrB,QAAQ,WAAW;IACnB,OAAO,UAAU;CAClB;AAED,qBAAa,gBAAgB;IAiBf,OAAO,CAAC,QAAQ,CAAC,aAAa;IAAoB,OAAO,CAAC,OAAO;IAhB7E,SAAgB,MAAM,gBAAuB;IAC7C,SAAgB,OAAO,gBAAuB;IAC9C,SAAgB,MAAM,gBAAuB;IAE7C,SAAgB,WAAW,0BAAkC;IAC7D,SAAgB,SAAS,0BAAkC;IAC3D,SAAgB,QAAQ,oCAEtB;IAEF,SAAgB,MAAM,uCAAkD;IAExE,SAAgB,OAAO,qCAA2D;IAElF,OAAO,CAAC,YAAY,CAAsB;gBAEb,aAAa,EAAE,gBAAgB,EAAU,OAAO,GAAE,uBAA4B;IAmErG,IAAI,CAAC,IAAI,EAAE,MAAM;IASvB,WAAW,CAAC,QAAQ,EAAE,iBAAiB;IAIvC,KAAK;IAYL,IAAI;IAOJ,KAAK;IAML,MAAM,CAAC,OAAO,EAAE,MAAM;IAOtB,IAAI,CAAC,OAAO,GAAE,MAAW;IAOzB,OAAO,CAAC,OAAO,GAAE,MAAW;YAQd,YAAY;IAK1B,OAAO,CAAC,GAAG;CAOZ"}
+{"version":3,"file":"player-controller.d.ts","sourceRoot":"","sources":["../../src/player/player-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAsB,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpE,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,oBAAY,YAAY;IACtB,SAAS,YAAY;IACrB,QAAQ,WAAW;IACnB,OAAO,UAAU;CAClB;AAED,qBAAa,gBAAgB;IAmBf,OAAO,CAAC,QAAQ,CAAC,aAAa;IAAoB,OAAO,CAAC,OAAO;IAlB7E,SAAgB,MAAM,gBAAuB;IAC7C,SAAgB,OAAO,gBAAuB;IAC9C,SAAgB,MAAM,gBAAuB;IAE7C,SAAgB,WAAW,0BAAkC;IAC7D,SAAgB,SAAS,0BAAkC;IAC3D,SAAgB,QAAQ,oCAEtB;IAEF,OAAO,CAAC,OAAO,CAAuB;IAEtC,SAAgB,MAAM,uCAAkD;IAExE,SAAgB,OAAO,qCAA2D;IAElF,OAAO,CAAC,YAAY,CAAsB;gBAEb,aAAa,EAAE,gBAAgB,EAAU,OAAO,GAAE,uBAA4B;IAoErG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAUnC,WAAW,CAAC,QAAQ,EAAE,iBAAiB;IAIvC,KAAK;IAYL,IAAI;IAOJ,KAAK;IAML,MAAM,CAAC,OAAO,EAAE,MAAM;IAOtB,IAAI,CAAC,OAAO,GAAE,MAAW;IAOzB,OAAO,CAAC,OAAO,GAAE,MAAW;YAQd,YAAY;IAK1B,OAAO,CAAC,GAAG;CAOZ"}

package/dist/player/player-controller.js

@@ -15,6 +15,7 @@ export class PlayerController {
     currentTime = new BehaviorSubject(0);
     totalTime = new BehaviorSubject(0);
     progress = combineLatest([this.currentTime, this.totalTime]).pipe(map(([currentTime, totalTime]) => currentTime / totalTime));
+    trackId = null;
     status = new BehaviorSubject(null);
     playing = this.status.pipe(map((status) => status === "playing"));
     localStorage = new LocalStorage();
@@ -74,14 +75,17 @@ export class PlayerController {
             if (this.playerElement.duration) {
                 this.totalTime.next(this.playerElement.duration);
             }
-            this.savePosition(this.playerElement.currentTime);
+            if (this.options.autoSave) {
+                this.savePosition(this.playerElement.currentTime);
+            }
         });
     }
-    async open(file) {
+    async open(id, file) {
+        this.trackId = id;
         this.playerElement.src = file;
-        const position = await this.localStorage.get(`progress-${this.playerElement.src}`);
+        const position = await this.localStorage.get(`progress-${this.trackId}`, (value) => typeof value === "number");
         if (position && this.options.autoSave)
-            this.playerElement.currentTime = parseFloat(position);
+            this.playerElement.currentTime = position;
         if (this.options.playOnInit)
             await this.playerElement.play();
     }
@@ -90,7 +94,7 @@ export class PlayerController {
     }
     close() {
         this.playerElement.pause();
-        this.playerElement.src = "";
+        // this.playerElement.src = "";
         navigator.mediaSession.setActionHandler("play", null);
         navigator.mediaSession.setActionHandler("pause", null);
         navigator.mediaSession.setActionHandler("previoustrack", null);
@@ -132,7 +136,7 @@ export class PlayerController {
     async savePosition(currentTime) {
         if (!this.playerElement.src)
             return;
-        await this.localStorage.set(`progress-${this.playerElement.src}`, String(currentTime));
+        await this.localStorage.set(`progress-${this.trackId}`, currentTime);
     }
     log(message) {
         const time = this.playerElement?.currentTime ? Math.round(this.playerElement?.currentTime) : null;

package/dist/storage/local-storage.d.ts

@@ -4,8 +4,9 @@ export interface LocalStorageOptions {
 export declare class LocalStorage {
     private options;
     constructor(options?: Partial<LocalStorageOptions>);
-    get(key: string): Promise<string | null>;
+    get<T = unknown>(key: string, validate?: (value: unknown) => value is T): Promise<T | null>;
     set(key: string, value: any): Promise<void>;
+    private parseData;
     private getPrefixedKey;
 }
 //# sourceMappingURL=local-storage.d.ts.map

package/dist/storage/local-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-storage.d.ts","sourceRoot":"","sources":["../../src/storage/local-storage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM;IAExD,GAAG,CAAC,GAAG,EAAE,MAAM;IAIf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAIjC,OAAO,CAAC,cAAc;CAQvB"}
+{"version":3,"file":"local-storage.d.ts","sourceRoot":"","sources":["../../src/storage/local-storage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM;IAExD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAiB3F,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAKjC,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,cAAc;CAQvB"}

package/dist/storage/local-storage.js

@@ -3,11 +3,34 @@ export class LocalStorage {
     constructor(options = {}) {
         this.options = options;
     }
-    async get(key) {
-        return window.localStorage.getItem(this.getPrefixedKey(key));
+    async get(key, validate) {
+        const data = window.localStorage.getItem(this.getPrefixedKey(key));
+        if (data === null)
+            return null;
+        const value = this.parseData(data);
+        if (typeof validate === "function") {
+            if (validate(value)) {
+                return this.parseData(data);
+            }
+            else {
+                return null;
+            }
+        }
+        else {
+            return value;
+        }
     }
     async set(key, value) {
-        return window.localStorage.setItem(this.getPrefixedKey(key), value);
+        const data = JSON.stringify(value);
+        return window.localStorage.setItem(this.getPrefixedKey(key), data);
+    }
+    parseData(data) {
+        try {
+            return JSON.parse(data);
+        }
+        catch (e) {
+            return data;
+        }
     }
     getPrefixedKey(key) {
         const keyParts = ["audiowalk"];

package/dist/story/story-controller.d.ts

@@ -0,0 +1,39 @@
+import { BehaviorSubject, Subject } from "rxjs";
+export interface BasicChapterDefinition<ChapterId extends string = string, StoryState extends {} = {}> {
+    id: ChapterId;
+    nextChapter: ChapterId | ((state: StoryState) => ChapterId) | ((state: StoryState) => Promise<ChapterId>) | null;
+}
+export interface BasicStoryState<ChapterId extends string = string> {
+    currentChapter: ChapterId;
+}
+export interface StoryControllerOptions<StoryState> {
+    stateStorageKey?: string;
+    validateState?: (state: any) => state is StoryState;
+}
+export interface StoryDefinition<ChapterId extends string = string, StoryState extends {
+    currentChapter?: ChapterId;
+} = BasicStoryState<ChapterId>, ChapterDefinition extends BasicChapterDefinition<ChapterId, StoryState> = BasicChapterDefinition<ChapterId, StoryState>> {
+    chapters: Record<ChapterId, ChapterDefinition>;
+    initialState: StoryState;
+}
+export declare class StoryController<ChapterId extends string = string, StoryState extends {
+    currentChapter?: ChapterId;
+} = BasicStoryState<ChapterId>, ChapterDefinition extends BasicChapterDefinition<ChapterId, StoryState> = BasicChapterDefinition<ChapterId, StoryState>> {
+    readonly story: StoryDefinition<ChapterId, StoryState, ChapterDefinition>;
+    private options;
+    readonly storyState: BehaviorSubject<StoryState>;
+    readonly currentChapter: BehaviorSubject<ChapterDefinition | null>;
+    readonly end: Subject<void>;
+    private readonly localStorage;
+    private readonly stateStorageKey;
+    constructor(story: StoryDefinition<ChapterId, StoryState, ChapterDefinition>, options?: StoryControllerOptions<StoryState>);
+    setState(state: StoryState): Promise<void>;
+    updateState(update: Partial<StoryState> | ((state: StoryState) => StoryState)): Promise<void>;
+    setChapter(string: ChapterId): Promise<void>;
+    nextChapter(): Promise<void | null>;
+    resetStory(): Promise<void>;
+    endStory(): void;
+    private loadState;
+    private saveState;
+}
+//# sourceMappingURL=story-controller.d.ts.map

package/dist/story/story-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-controller.d.ts","sourceRoot":"","sources":["../../src/story/story-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAO,OAAO,EAAE,MAAM,MAAM,CAAC;AAGrD,MAAM,WAAW,sBAAsB,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,EAAE,UAAU,SAAS,EAAE,GAAG,EAAE;IACnG,EAAE,EAAE,SAAS,CAAC;IACd,WAAW,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,UAAU,KAAK,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC;CAClH;AAED,MAAM,WAAW,eAAe,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IAChE,cAAc,EAAE,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB,CAAC,UAAU;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,KAAK,IAAI,UAAU,CAAC;CACrD;AAED,MAAM,WAAW,eAAe,CAC9B,SAAS,SAAS,MAAM,GAAG,MAAM,EACjC,UAAU,SAAS;IAAE,cAAc,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,eAAe,CAAC,SAAS,CAAC,EAC9E,iBAAiB,SAAS,sBAAsB,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,sBAAsB,CAC9F,SAAS,EACT,UAAU,CACX;IAED,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAC/C,YAAY,EAAE,UAAU,CAAC;CAC1B;AAED,qBAAa,eAAe,CAC1B,SAAS,SAAS,MAAM,GAAG,MAAM,EACjC,UAAU,SAAS;IAAE,cAAc,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,eAAe,CAAC,SAAS,CAAC,EAC9E,iBAAiB,SAAS,sBAAsB,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,sBAAsB,CAC9F,SAAS,EACT,UAAU,CACX;aAWiB,KAAK,EAAE,eAAe,CAAC,SAAS,EAAE,UAAU,EAAE,iBAAiB,CAAC;IAChF,OAAO,CAAC,OAAO;IAVjB,SAAgB,UAAU,8BAA8C;IACxE,SAAgB,cAAc,4CAAuD;IACrF,SAAgB,GAAG,gBAAuB;IAE1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAE5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAW;gBAGzB,KAAK,EAAE,eAAe,CAAC,SAAS,EAAE,UAAU,EAAE,iBAAiB,CAAC,EACxE,OAAO,GAAE,sBAAsB,CAAC,UAAU,CAAM;IAcpD,QAAQ,CAAC,KAAK,EAAE,UAAU;IAK1B,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU,CAAC;IAa7E,UAAU,CAAC,MAAM,EAAE,SAAS;IAI5B,WAAW;IAuBX,UAAU;IAIhB,QAAQ;YAIM,SAAS;YAaT,SAAS;CAGxB"}

package/dist/story/story-controller.js

@@ -0,0 +1,81 @@
+import { BehaviorSubject, map, Subject } from "rxjs";
+import { LocalStorage } from "../storage/local-storage";
+export class StoryController {
+    story;
+    options;
+    storyState = new BehaviorSubject({});
+    currentChapter = new BehaviorSubject(null);
+    end = new Subject();
+    localStorage;
+    stateStorageKey = "state";
+    constructor(story, options = {}) {
+        this.story = story;
+        this.options = options;
+        this.localStorage = new LocalStorage({ prefix: options.stateStorageKey ?? "story-state" });
+        this.storyState
+            .pipe(map((state) => (state.currentChapter ? story.chapters[state.currentChapter] : null)))
+            .subscribe(this.currentChapter);
+        this.loadState().then((state) => {
+            if (state)
+                this.storyState.next(state);
+            else
+                this.setState(story.initialState);
+        });
+    }
+    async setState(state) {
+        await this.saveState(state);
+        this.storyState.next(state);
+    }
+    async updateState(update) {
+        const oldState = (await this.loadState()) ?? this.storyState.value;
+        let newState = oldState;
+        if (typeof update === "function") {
+            newState = update(oldState);
+        }
+        else if (typeof update === "object") {
+            newState = { ...oldState, ...update };
+        }
+        this.setState(newState);
+    }
+    async setChapter(string) {
+        this.updateState((state) => ({ ...state, currentChapter: string }));
+    }
+    async nextChapter() {
+        const chapter = this.currentChapter.value;
+        if (!chapter)
+            return null;
+        if (chapter.nextChapter === null) {
+            return this.endStory();
+        }
+        if (typeof chapter.nextChapter === "string") {
+            return this.setChapter(chapter.nextChapter);
+        }
+        if (typeof chapter.nextChapter === "function") {
+            const storyState = this.storyState.value;
+            const string = await chapter.nextChapter(storyState);
+            this.setChapter(string);
+        }
+        throw new Error(`Invalid nextChapter type in chapter ${chapter.id}`);
+    }
+    async resetStory() {
+        await this.setState(this.story.initialState);
+    }
+    endStory() {
+        this.end.next();
+    }
+    async loadState() {
+        try {
+            const stateData = await this.localStorage.get(this.stateStorageKey, this.options.validateState);
+            if (!stateData)
+                return null;
+            return stateData;
+        }
+        catch (error) {
+            console.error("Story state is invalid", error);
+            return null;
+        }
+    }
+    async saveState(state) {
+        await this.localStorage.set(this.stateStorageKey, state);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@audiowalk/sdk",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/audiowalk-cz/components.git"
@@ -12,8 +12,9 @@
   ],
   "type": "module",
   "scripts": {
-    "dev": "tsc -w",
+    "dev": "npm run build:watch",
     "build": "tsc",
+    "build:watch": "tsc -w",
     "prepublishOnly": "npm run build",
     "release:patch": "git switch master && npm version patch && git switch release && git merge master --ff-only && git push --follow-tags && git switch master && git push",
     "release:minor": "git switch master && npm version minor && git switch release && git merge master --ff-only && git push --follow-tags && git switch master && git push",