@audiowalk/sdk 1.2.2 → 1.3.1

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.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;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;IAYvB,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

@@ -79,9 +79,9 @@ export class PlayerController {
     }
     async open(file) {
         this.playerElement.src = file;
-        const position = await this.localStorage.get(`progress-${this.playerElement.src}`);
+        const position = await this.localStorage.get(`progress-${this.playerElement.src}`, (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();
     }

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,38 @@
+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>;
+    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;IAuBjB,QAAQ;YAIM,SAAS;YAaT,SAAS;CAGxB"}

package/dist/story/story-controller.js

@@ -0,0 +1,78 @@
+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}`);
+    }
+    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.2.2",
+  "version": "1.3.1",
   "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",