@d-najd/universal-media-tracker-sdk 0.3.3 → 0.3.6

package/dist/Plugin.d.ts

@@ -1,10 +1,11 @@
-import PluginConfig from "./types/PluginConfig";
-import CreateCatalogHandler from "./types/handler/media/catalog/CreateCatalogHandler";
-import CreateResourceHandler from "./types/handler/media/CreateResourceHandler";
-import CreatePluginSourceHandler from "./types/handler/plugin/source/CreatePluginSourceHandler";
-import CreateHandler from "./types/handler/base/CreateHandler";
-import CreatePluginFactoryHandler from "./types/handler/plugin/factory/CreatePluginFactoryHandler";
-import CreateScreenHandler from "./types/handler/ui/screen/CreateScreenHandler";
+import PluginConfig from './types/PluginConfig';
+import CreateCatalogHandler from './types/handler/media/catalog/CreateCatalogHandler';
+import CreateResourceHandler from './types/handler/media/CreateResourceHandler';
+import CreatePluginSourceHandler from './types/handler/plugin/source/CreatePluginSourceHandler';
+import CreateHandler from './types/handler/base/CreateHandler';
+import CreatePluginFactoryHandler from './types/handler/plugin/factory/CreatePluginFactoryHandler';
+import CreateScreenHandler from './types/handler/ui/screen/CreateScreenHandler';
+import CreateCustomScreenHandler from './types/handler/ui/screen/CreateCustomScreenHandler';
 export default class Plugin {
     readonly config: PluginConfig;
     /**
@@ -33,7 +34,14 @@ export default class Plugin {
     defineCatalogHandler(handler: CreateCatalogHandler): string;
     definePluginSourceHandler(handler: CreatePluginSourceHandler): string;
     definePluginFactoryHandler(handler: CreatePluginFactoryHandler): string;
-    defineScreenHandler(handler: CreateScreenHandler): string;
+    /**
+     * Recommended version of defining screens since it has some tested defaults
+     */
+    defineScreenHandler<S>(handler: CreateScreenHandler<S>): string;
+    /**
+     * Advanced version of defining screens, may lead to memory leaks if used misused
+     */
+    defineCustomScreenHandler(handler: CreateCustomScreenHandler): string;
     private getSpec;
     private onLoadCallback;
     private onUnloadCallback;

package/dist/Plugin.js

@@ -75,11 +75,20 @@ export default class Plugin {
         };
         return this.defineHandler(newHandler);
     }
+    /**
+     * Recommended version of defining screens since it has some tested defaults
+     */
     defineScreenHandler(handler) {
+        return this.defineCustomScreenHandler(handler);
+    }
+    /**
+     * Advanced version of defining screens, may lead to memory leaks if used misused
+     */
+    defineCustomScreenHandler(handler) {
         const newHandler = {
             id: `${this.config.id}-ui-screen-${this.counter++}`,
             ...handler,
-            type: "ui-screen"
+            type: 'ui-screen'
         };
         return this.defineHandler(newHandler);
     }

package/dist/index.d.ts

@@ -14,9 +14,11 @@ export { default as HandlerTypes } from './types/handler/base/HandlerTypes';
 export { default as Handler } from './types/handler/base/Handler';
 export { default as CreateHandler } from './types/handler/base/CreateHandler';
 export { default as BaseHandler } from './types/handler/base/BaseHandler';
+export * from './types/handler/ui/screen/ZustandScreenStore';
 export { default as ScreenHandlerResponse } from './types/handler/ui/screen/ScreenHandlerResponse';
 export { default as ScreenHandlerArgs } from './types/handler/ui/screen/ScreenHandlerArgs';
 export { default as CreateScreenHandler } from './types/handler/ui/screen/CreateScreenHandler';
+export { default as CreateCustomScreenHandler } from './types/handler/ui/screen/CreateCustomScreenHandler';
 export { default as MetaPreview } from './types/handler/media/catalog/MetaPreview';
 export { default as CreateCatalogHandler } from './types/handler/media/catalog/CreateCatalogHandler';
 export { default as CatalogHandlerResponse } from './types/handler/media/catalog/CatalogHandlerResponse';

package/dist/index.js

@@ -1,2 +1,3 @@
 // Auto‑generated barrel file – do not edit manually
 export { default as Plugin } from './Plugin';
+export * from './types/handler/ui/screen/ZustandScreenStore';

package/dist/navigator/Navigator.d.ts

@@ -1,4 +1,4 @@
-import NavigatorEntry from "./NavigatorEntry";
+import NavigatorEntry from './NavigatorEntry';
 export default interface Navigator {
     screens: NavigatorEntry[];
     push(path: string): void;

package/dist/types/PluginSpec.d.ts

@@ -1,5 +1,5 @@
-import PluginConfig from "./PluginConfig";
-import Handler from "./handler/base/Handler";
+import PluginConfig from './PluginConfig';
+import Handler from './handler/base/Handler';
 export default interface PluginSpec {
     readonly config: PluginConfig;
     readonly onLoad: () => Promise<void>;

package/dist/types/handler/base/CreateHandler.d.ts

@@ -1,4 +1,4 @@
-import BaseHandler from "./BaseHandler";
+import BaseHandler from './BaseHandler';
 type CreateHandler<T = any, R = any> = BaseHandler<T, R> & {
     readonly type: string;
 };

package/dist/types/handler/base/Handler.d.ts

@@ -1,5 +1,5 @@
-import BaseHandler from "./BaseHandler";
-import HandlerTypes from "./HandlerTypes";
+import BaseHandler from './BaseHandler';
+import HandlerTypes from './HandlerTypes';
 type Handler<T = any, R = any> = BaseHandler<T, R> & {
     readonly id: string;
     readonly type: HandlerTypes | string;

package/dist/types/handler/media/BaseResourceHandler.d.ts

@@ -1,8 +1,8 @@
-import ResourceType from "./ResourceType";
-import BaseHandler from "../base/BaseHandler";
-import ResourceBrowseOption from "./browse-option/ResourceBrowseOption";
-import ResourceHandlerArgs from "./ResourceHandlerArgs";
-import ResourceHandlerResponse from "./ResourceHandlerResponse";
+import ResourceType from './ResourceType';
+import BaseHandler from '../base/BaseHandler';
+import ResourceBrowseOption from './browse-option/ResourceBrowseOption';
+import ResourceHandlerArgs from './ResourceHandlerArgs';
+import ResourceHandlerResponse from './ResourceHandlerResponse';
 type BaseResourceHandler<T extends ResourceHandlerArgs = ResourceHandlerArgs, R extends ResourceHandlerResponse = ResourceHandlerResponse> = BaseHandler<T, R> & {
     readonly name?: string;
     readonly resourceType?: ResourceType | string;

package/dist/types/handler/media/CreateResourceHandler.d.ts

@@ -1,8 +1,8 @@
-import BaseResourceHandler from "./BaseResourceHandler";
-import ResourceType from "./ResourceType";
-import HandlerTypes from "../base/HandlerTypes";
-import ResourceHandlerArgs from "./ResourceHandlerArgs";
-import ResourceHandlerResponse from "./ResourceHandlerResponse";
+import BaseResourceHandler from './BaseResourceHandler';
+import ResourceType from './ResourceType';
+import HandlerTypes from '../base/HandlerTypes';
+import ResourceHandlerArgs from './ResourceHandlerArgs';
+import ResourceHandlerResponse from './ResourceHandlerResponse';
 type CreateResourceHandler<T extends ResourceHandlerArgs = ResourceHandlerArgs, R extends ResourceHandlerResponse = ResourceHandlerResponse> = BaseResourceHandler<T, R> & {
     readonly type: HandlerTypes | string;
     readonly resourceType: ResourceType | string;

package/dist/types/handler/media/ResourceHandler.d.ts

@@ -1,9 +1,9 @@
-import ResourceType from "./ResourceType";
-import BaseResourceHandler from "./BaseResourceHandler";
-import Handler from "../base/Handler";
-import HandlerTypes from "../base/HandlerTypes";
-import ResourceHandlerArgs from "./ResourceHandlerArgs";
-import ResourceHandlerResponse from "./ResourceHandlerResponse";
+import ResourceType from './ResourceType';
+import BaseResourceHandler from './BaseResourceHandler';
+import Handler from '../base/Handler';
+import HandlerTypes from '../base/HandlerTypes';
+import ResourceHandlerArgs from './ResourceHandlerArgs';
+import ResourceHandlerResponse from './ResourceHandlerResponse';
 type ResourceHandler<T extends ResourceHandlerArgs = ResourceHandlerArgs, R extends ResourceHandlerResponse = ResourceHandlerResponse> = BaseResourceHandler<T, R> & Handler<T, R> & {
     /**
      * Displayed in the app

package/dist/types/handler/media/ResourceHandlerArgs.d.ts

@@ -1,4 +1,4 @@
-import { ResourceBrowseOptionArgs } from "../../../index";
+import { ResourceBrowseOptionArgs } from '../../../index';
 type ResourceHandlerArgs = {
     readonly options?: ResourceBrowseOptionArgs[];
 };

package/dist/types/handler/media/browse-option/ResourceBrowseOption.d.ts

@@ -1,4 +1,4 @@
-import ResourceBrowseOptionDefaults from "./ResourceBrowseOptionDefaults";
+import ResourceBrowseOptionDefaults from './ResourceBrowseOptionDefaults';
 /**
  * @see ResourceBrowseOptionDefaults
  * @see ResourceBrowseOptionArgs

package/dist/types/handler/media/browse-option/ResourceBrowseOptionArgs.d.ts

@@ -1,5 +1,5 @@
-import TriState from "../../../TriState";
-import ResourceBrowseOptionDefaults from "./ResourceBrowseOptionDefaults";
+import TriState from '../../../TriState';
+import ResourceBrowseOptionDefaults from './ResourceBrowseOptionDefaults';
 type ResourceBrowseOptionArgs = {
     readonly name: ResourceBrowseOptionDefaults | string;
     /**

package/dist/types/handler/media/browse-option/ResourceBrowseOptionDefaults.d.ts

@@ -1,4 +1,2 @@
-type ResourceBrowseOptionDefaults = 'search' | // type string
-'skip' | // type number (int), `isRequired` always false
-'genre';
+type ResourceBrowseOptionDefaults = 'search' | 'skip' | 'genre';
 export default ResourceBrowseOptionDefaults;

package/dist/types/handler/media/catalog/CatalogHandlerArgs.d.ts

@@ -1,3 +1,3 @@
-import ResourceHandlerArgs from "../ResourceHandlerArgs";
+import ResourceHandlerArgs from '../ResourceHandlerArgs';
 type CatalogHandlerArgs = ResourceHandlerArgs & {};
 export default CatalogHandlerArgs;

package/dist/types/handler/media/catalog/CatalogHandlerResponse.d.ts

@@ -1,4 +1,4 @@
-import MetaPreview from "./MetaPreview";
-import ResourceHandlerResponse from "../ResourceHandlerResponse";
-type CatalogHandlerResponse = ResourceHandlerResponse<MetaPreview> & {};
+import MetaPreview from './MetaPreview';
+import ResourceHandlerResponse from '../ResourceHandlerResponse';
+type CatalogHandlerResponse<R extends MetaPreview = MetaPreview> = ResourceHandlerResponse<R> & {};
 export default CatalogHandlerResponse;

package/dist/types/handler/media/catalog/CreateCatalogHandler.d.ts

@@ -1,8 +1,9 @@
-import BaseResourceHandler from "../BaseResourceHandler";
-import CatalogHandlerArgs from "./CatalogHandlerArgs";
-import CatalogHandlerResponse from "./CatalogHandlerResponse";
-import ResourceType from "../ResourceType";
-type CreateCatalogHandler = BaseResourceHandler<CatalogHandlerArgs, CatalogHandlerResponse> & {
+import BaseResourceHandler from '../BaseResourceHandler';
+import CatalogHandlerArgs from './CatalogHandlerArgs';
+import CatalogHandlerResponse from './CatalogHandlerResponse';
+import ResourceType from '../ResourceType';
+import { MetaPreview } from "../../../../index";
+type CreateCatalogHandler<R extends MetaPreview = MetaPreview> = BaseResourceHandler<CatalogHandlerArgs, CatalogHandlerResponse<R>> & {
     readonly resourceType: ResourceType | string;
 };
 export default CreateCatalogHandler;

package/dist/types/handler/media/catalog/MetaPreview.d.ts

@@ -1,4 +1,4 @@
-import ResourceType from "../ResourceType";
+import ResourceType from '../ResourceType';
 type MetaPreview = {
     readonly id: string;
     readonly type: ResourceType | string;

package/dist/types/handler/plugin/factory/CreatePluginFactoryHandler.d.ts

@@ -1,5 +1,5 @@
-import BaseHandler from "../../base/BaseHandler";
-import PluginFactoryHandlerArgs from "./PluginFactoryHandlerArgs";
-import PluginFactoryHandlerResponse from "./PluginFactoryHandlerResponse";
+import BaseHandler from '../../base/BaseHandler';
+import PluginFactoryHandlerArgs from './PluginFactoryHandlerArgs';
+import PluginFactoryHandlerResponse from './PluginFactoryHandlerResponse';
 type CreatePluginFactoryHandler = BaseHandler<PluginFactoryHandlerArgs, PluginFactoryHandlerResponse> & {};
 export default CreatePluginFactoryHandler;

package/dist/types/handler/plugin/source/CreatePluginSourceHandler.d.ts

@@ -1,5 +1,5 @@
-import PluginSourceHandlerResponse from "./PluginSourceHandlerResponse";
-import BaseHandler from "../../base/BaseHandler";
-import PluginSourceHandlerArgs from "./PluginSourceHandlerArgs";
+import PluginSourceHandlerResponse from './PluginSourceHandlerResponse';
+import BaseHandler from '../../base/BaseHandler';
+import PluginSourceHandlerArgs from './PluginSourceHandlerArgs';
 type CreatePluginSourceHandler = BaseHandler<PluginSourceHandlerArgs, PluginSourceHandlerResponse> & {};
 export default CreatePluginSourceHandler;

package/dist/types/handler/ui/screen/CreateCustomScreenHandler.d.ts

@@ -0,0 +1,15 @@
+import BaseHandler from '../../base/BaseHandler';
+import ScreenHandlerArgs from './ScreenHandlerArgs';
+import ScreenHandlerResponse from './ScreenHandlerResponse';
+type CreateCustomScreenHandler<S = any> = BaseHandler<ScreenHandlerArgs<S>, ScreenHandlerResponse> & {
+    /**
+     * /library/:id
+     */
+    readonly pattern: string;
+    /**
+     * If undefined screen state won't be stored
+     */
+    readonly initialState?: S;
+    readonly test?: S;
+};
+export default CreateCustomScreenHandler;

package/dist/types/handler/ui/screen/CreateCustomScreenHandler.js

@@ -0,0 +1 @@
+export {};

package/dist/types/handler/ui/screen/CreateScreenHandler.d.ts

@@ -1,15 +1,7 @@
-import BaseHandler from "../../base/BaseHandler";
-import ScreenHandlerArgs from "./ScreenHandlerArgs";
-import ScreenHandlerResponse from "./ScreenHandlerResponse";
-import { StoreApi, UseBoundStore } from "zustand";
-type CreateScreenHandler<S = any> = BaseHandler<ScreenHandlerArgs<S>, ScreenHandlerResponse> & {
-    /**
-     * /library/:id
-     */
-    readonly pattern: string;
-    /**
-     * If undefined screen state won't be stored
-     */
-    readonly initialState?: UseBoundStore<StoreApi<S>>;
-};
+import CreateCustomScreenHandler from './CreateCustomScreenHandler';
+import { ZustandScreenStore } from "./ZustandScreenStore";
+/**
+ * Uses zustand, react is also recommended
+ */
+type CreateScreenHandler<S = any> = CreateCustomScreenHandler<ZustandScreenStore<S>> & {};
 export default CreateScreenHandler;

package/dist/types/handler/ui/screen/ScreenHandlerArgs.d.ts

@@ -1,10 +1,9 @@
 import Navigator from '../../../../navigator/Navigator';
-import { UseBoundStore, StoreApi } from "zustand";
 type ScreenHandlerArgs<S = any> = {
     /**
      * If undefined in handler won't be passed here
      */
-    readonly state?: UseBoundStore<StoreApi<S>>;
+    readonly state?: S;
     readonly navigator: Navigator;
     /**
      * /library/1

package/dist/types/handler/ui/screen/ScreenHandlerResponse.d.ts

@@ -1,6 +1,5 @@
-import { ReactNode } from "react";
+import { ReactNode } from 'react';
 type ScreenHandlerResponse = {
-    readonly framework: 'react';
     readonly content: ReactNode;
 };
 export default ScreenHandlerResponse;

package/dist/types/handler/ui/screen/ScreenStore.d.ts

@@ -0,0 +1,4 @@
+type ScreenStore<T> = {
+    getState(): T;
+    setState(state: T): void;
+};

package/dist/types/handler/ui/screen/ScreenStore.js

@@ -0,0 +1 @@
+"use strict";

package/dist/types/handler/ui/screen/ZustandScreenStore.d.ts

@@ -0,0 +1,3 @@
+import { StoreApi, UseBoundStore } from "zustand";
+export type ZustandScreenStore<S> = UseBoundStore<StoreApi<S>> & ScreenStore<S>;
+export declare function createZustandScreenStore<S>(initial: S): ZustandScreenStore<S>;

package/dist/types/handler/ui/screen/ZustandScreenStore.js

@@ -0,0 +1,14 @@
+import { create } from "zustand";
+export function createZustandScreenStore(initial) {
+    const store = create(() => initial);
+    // Black magic
+    const hook = ((selector) => {
+        if (!selector)
+            return store.getState();
+        return selector(store.getState());
+    });
+    hook.getState = store.getState;
+    hook.setState = store.setState;
+    hook.subscribe = store.subscribe;
+    return hook;
+}

package/package.json

@@ -1,30 +1,33 @@
 {
-  "name": "@d-najd/universal-media-tracker-sdk",
-  "version": "0.3.3",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "scripts": {
-    "build": "rimraf dist & node scripts/generate.js && tsc"
-  },
-  "license": "MIT",
-  "type": "module",
-  "devDependencies": {
-    "@types/node": "^25.5.2",
-    "@types/react": "^19.2.14",
-    "glob": "^13.0.6",
-    "typescript": "^5.9.3"
-  },
-  "dependencies": {
-    "zustand": "^5.0.12"
-  }
+	"name": "@d-najd/universal-media-tracker-sdk",
+	"version": "0.3.6",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"files": [
+		"dist"
+	],
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"require": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"scripts": {
+		"build": "rimraf dist & node scripts/generate.js && tsc",
+		"format": "prettier --write ."
+	},
+	"license": "MIT",
+	"type": "module",
+	"devDependencies": {
+		"@types/node": "^25.5.2",
+		"@types/react": "^19.2.14",
+		"glob": "^13.0.6",
+		"prettier": "^3.8.1",
+		"typescript": "^5.9.3"
+	},
+	"dependencies": {
+		"react": "^19.2.4",
+		"zustand": "^5.0.12"
+	}
 }