@d-najd/universal-media-tracker-sdk 0.2.2 → 0.3.1

package/dist/Plugin.d.ts

@@ -4,6 +4,7 @@ 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";
 export default class Plugin {
     readonly config: PluginConfig;
     /**
@@ -32,6 +33,7 @@ export default class Plugin {
     defineCatalogHandler(handler: CreateCatalogHandler): string;
     definePluginSourceHandler(handler: CreatePluginSourceHandler): string;
     definePluginFactoryHandler(handler: CreatePluginFactoryHandler): string;
+    defineScreenHandler(handler: CreateScreenHandler): string;
     private getSpec;
     private onLoadCallback;
     private onUnloadCallback;

package/dist/Plugin.js

@@ -75,6 +75,14 @@ export default class Plugin {
         };
         return this.defineHandler(newHandler);
     }
+    defineScreenHandler(handler) {
+        const newHandler = {
+            id: `${this.config.id}-ui-screen-${this.counter++}`,
+            ...handler,
+            type: "ui-screen"
+        };
+        return this.defineHandler(newHandler);
+    }
     // Used internally
     async getSpec() {
         if (!this.loaded) {

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { default as Plugin } from './Plugin';
 export { default as TriState } from './types/TriState';
 export { default as PluginSpec } from './types/PluginSpec';
 export { default as PluginConfig } from './types/PluginConfig';
+export { default as Navigator } from './types/handler/ui/Navigator';
 export { default as ResourceType } from './types/handler/media/ResourceType';
 export { default as ResourceHandlerResponse } from './types/handler/media/ResourceHandlerResponse';
 export { default as ResourceHandlerArgs } from './types/handler/media/ResourceHandlerArgs';
@@ -11,20 +12,20 @@ export { default as BaseResourceHandler } from './types/handler/media/BaseResour
 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 BaseHandlerResponse } from './types/handler/base/BaseHandlerResponse';
-export { default as BaseHandlerArgs } from './types/handler/base/BaseHandlerArgs';
 export { default as BaseHandler } from './types/handler/base/BaseHandler';
+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 PluginSourceHandlerResponse } from './types/handler/plugin/source/PluginSourceHandlerResponse';
+export { default as PluginSourceHandlerArgs } from './types/handler/plugin/source/PluginSourceHandlerArgs';
+export { default as CreatePluginSourceHandler } from './types/handler/plugin/source/CreatePluginSourceHandler';
+export { default as PluginFactoryHandlerResponse } from './types/handler/plugin/factory/PluginFactoryHandlerResponse';
+export { default as PluginFactoryHandlerArgs } from './types/handler/plugin/factory/PluginFactoryHandlerArgs';
+export { default as CreatePluginFactoryHandler } from './types/handler/plugin/factory/CreatePluginFactoryHandler';
 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';
 export { default as CatalogHandlerArgs } from './types/handler/media/catalog/CatalogHandlerArgs';
 export { default as ResourceBrowseOptionDefaults } from './types/handler/media/browse-option/ResourceBrowseOptionDefaults';
-export { default as ResourceBrowseOptionConverter } from './types/handler/media/browse-option/ResourceBrowseOptionConverter';
 export { default as ResourceBrowseOptionArgs } from './types/handler/media/browse-option/ResourceBrowseOptionArgs';
 export { default as ResourceBrowseOption } from './types/handler/media/browse-option/ResourceBrowseOption';
-export { default as PluginSourceHandlerResponse } from './types/handler/plugin/source/PluginSourceHandlerResponse';
-export { default as PluginSourceHandlerArgs } from './types/handler/plugin/source/PluginSourceHandlerArgs';
-export { default as CreatePluginSourceHandler } from './types/handler/plugin/source/CreatePluginSourceHandler';
-export { default as PluginFactoryHandlerResponse } from './types/handler/plugin/factory/PluginFactoryHandlerResponse';
-export { default as PluginFactoryHandlerArgs } from './types/handler/plugin/factory/PluginFactoryHandlerArgs';
-export { default as CreatePluginFactoryHandler } from './types/handler/plugin/factory/CreatePluginFactoryHandler';

package/dist/index.js

@@ -1,3 +1,2 @@
 // Auto‑generated barrel file – do not edit manually
 export { default as Plugin } from './Plugin';
-export { default as ResourceBrowseOptionConverter } from './types/handler/media/browse-option/ResourceBrowseOptionConverter';

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

@@ -1,2 +1,2 @@
-type ResourceHandlerType = 'catalog-request' | 'plugin-source' | 'plugin-factory';
+type ResourceHandlerType = 'catalog-request' | 'plugin-source' | 'plugin-factory' | 'ui-screen';
 export default ResourceHandlerType;

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

@@ -1,6 +1,5 @@
-import BaseHandlerArgs from "../base/BaseHandlerArgs";
 import { ResourceBrowseOptionArgs } from "../../../index";
-type ResourceHandlerArgs = BaseHandlerArgs & {
+type ResourceHandlerArgs = {
     readonly options?: ResourceBrowseOptionArgs[];
 };
 export default ResourceHandlerArgs;

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

@@ -1,3 +1,4 @@
-import BaseHandlerResponse from "../base/BaseHandlerResponse";
-type ResourceHandlerResponse<T = any> = BaseHandlerResponse<T> & {};
+type ResourceHandlerResponse<T = any> = {
+    readonly data: T[];
+};
 export default ResourceHandlerResponse;

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

@@ -1,6 +1,7 @@
 import TriState from "../../../TriState";
+import ResourceBrowseOptionDefaults from "./ResourceBrowseOptionDefaults";
 type ResourceBrowseOptionArgs = {
-    readonly name: string;
+    readonly name: ResourceBrowseOptionDefaults | string;
     /**
      * @see ResourceExtra
      */

package/dist/types/handler/ui/Navigator.d.ts

@@ -0,0 +1,6 @@
+export default interface Navigator {
+    screens: NavigatorEntry[];
+    push(path: string): void;
+    pop(): void;
+    replace(path: string): void;
+}

package/dist/types/handler/ui/Navigator.js

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

package/dist/types/handler/ui/NavigatorEntry.d.ts

@@ -0,0 +1,5 @@
+type NavigatorEntry = {
+    state: any;
+    path: string;
+    pattern: string;
+};

package/dist/types/handler/ui/NavigatorEntry.js

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

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

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

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

@@ -0,0 +1,15 @@
+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>>;
+};
+export default CreateScreenHandler;

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

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

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

@@ -0,0 +1,18 @@
+import Navigator from '../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 navigator: Navigator;
+    /**
+     * /library/1
+     */
+    readonly path: string;
+    /**
+     * /library/:id
+     */
+    readonly pattern: string;
+};
+export default ScreenHandlerArgs;

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

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

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

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d-najd/universal-media-tracker-sdk",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
@@ -19,8 +19,12 @@
   "license": "MIT",
   "type": "module",
   "devDependencies": {
-    "@types/node": "^25.5.0",
+    "@types/node": "^25.5.2",
+    "@types/react": "^19.2.14",
     "glob": "^13.0.6",
     "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "zustand": "^5.0.12"
   }
 }