@xeonr/renderer-sdk 1.1.0 → 1.5.0

package/dist/react/useRendererClient.js

@@ -1,5 +1,60 @@
-import { useState, useRef, useEffect, useMemo } from 'react';
+import { useState, useEffect, useMemo } from 'react';
 import { RendererClient } from '../client.js';
+// One RendererClient per page. Multiple `useRendererClient()` calls
+// (different components subscribing to the same state) all share the
+// singleton — previously each call spawned its own client, which
+// caused duplicate `window.error` / `unhandledrejection` listeners
+// (so every crash got reported N times), duplicate `uplim:ready`
+// pings, and state divergence between instances.
+//
+// Page lifetime: the iframe is full-reloaded for HMR / test, so the
+// module-level singleton lives exactly as long as it should. SDK-level
+// HMR (developer working on the SDK in monorepo, hot-replacing this
+// module) is handled via `import.meta.hot.dispose` at the bottom of
+// the file.
+let sharedClient = null;
+let sharedClientOptionsKey = null;
+function optionsKey(options) {
+    if (!options)
+        return '';
+    // Stable order so { a, b } and { b, a } produce the same key. Used
+    // only for the dev-mode mismatch warning — never for behavior.
+    const entries = Object.entries(options).sort(([a], [b]) => a.localeCompare(b));
+    return JSON.stringify(entries);
+}
+function getSharedClient(options) {
+    if (sharedClient) {
+        const key = optionsKey(options);
+        // Best-effort dev nudge: if a later mount passes different
+        // options than the first one, those options are silently
+        // ignored. Only flag when keys differ AND the later caller
+        // passed non-empty options (passing nothing is the common
+        // case for downstream subscribers).
+        if (key && sharedClientOptionsKey !== null && key !== sharedClientOptionsKey) {
+            // eslint-disable-next-line no-console
+            console.warn('[uplim] useRendererClient called with different options after first call; ' +
+                'later options are ignored (the client is a per-page singleton).');
+        }
+        return sharedClient;
+    }
+    sharedClient = new RendererClient(options);
+    sharedClientOptionsKey = optionsKey(options);
+    return sharedClient;
+}
+// SDK-dev HMR cleanup: when this module is hot-replaced (e.g. someone
+// editing the SDK with the renderer harness running), detach the old
+// client's listeners before the new module evaluates. Prod / non-HMR
+// builds skip the entire block — `import.meta.hot` is undefined.
+const maybeHot = import.meta.hot;
+if (maybeHot) {
+    maybeHot.dispose(() => {
+        if (sharedClient) {
+            sharedClient.destroy();
+            sharedClient = null;
+            sharedClientOptionsKey = null;
+        }
+    });
+}
 /**
  * Apply the host's theme to the renderer document. Two distinct effects:
  *
@@ -42,22 +97,23 @@ function applyThemeToDocument(theme) {
  * ```
  */
 export function useRendererClient(options) {
-    const clientRef = useRef(null);
-    // Lazy-init the client (only once)
-    if (clientRef.current === null) {
-        clientRef.current = new RendererClient(options);
-    }
-    const client = clientRef.current;
-    const [connected, setConnected] = useState(false);
-    const [scope, setScope] = useState(null);
-    const [renderingType, setRenderingType] = useState(null);
-    const [token, setToken] = useState(null);
-    const [tokenExpiresAt, setTokenExpiresAt] = useState(null);
-    const [theme, setTheme] = useState('light');
-    const [config, setConfig] = useState(null);
-    const [entrypoint, setEntrypoint] = useState(null);
-    const [apiBaseUrl, setApiBaseUrl] = useState(null);
-    const [path, setPath] = useState('/');
+    const client = getSharedClient(options);
+    // Initial state read directly from the client — handles late
+    // subscribers (a second `useRendererClient` mount that happens
+    // after init has already fired). Without this, the late mount
+    // would sit at `connected: false` forever because onInit only
+    // fires for NEW init events, not for already-received state.
+    const [connected, setConnected] = useState(() => client.isConnected());
+    const [scope, setScope] = useState(() => client.getScope());
+    const [renderingType, setRenderingType] = useState(() => client.getRenderingType());
+    const [token, setToken] = useState(() => client.getToken());
+    const [tokenExpiresAt, setTokenExpiresAt] = useState(() => client.getTokenExpiresAt());
+    const [theme, setTheme] = useState(() => client.getTheme());
+    const [config, setConfig] = useState(() => client.getConfig());
+    const [entrypoint, setEntrypoint] = useState(() => client.getEntrypoint());
+    const [apiBaseUrl, setApiBaseUrl] = useState(() => client.getApiBaseUrl());
+    const [resource, setResource] = useState(() => client.getResource());
+    const [path, setPath] = useState(() => client.getPath());
     useEffect(() => {
         const unsubInit = client.onInit((payload) => {
             setConnected(true);
@@ -69,6 +125,7 @@ export function useRendererClient(options) {
             setConfig(payload.config);
             setEntrypoint(payload.entrypoint);
             setApiBaseUrl(payload.apiBaseUrl);
+            setResource(payload.resource ?? null);
             setPath(client.getPath());
             applyThemeToDocument(payload.theme);
         });
@@ -88,13 +145,20 @@ export function useRendererClient(options) {
             unsubTheme();
             unsubToken();
             unsubNavigate();
-            client.destroy();
+            // NB: do NOT destroy() here — the client is a per-page
+            // singleton, not a per-component instance. Component
+            // unmounts (route changes / strict-mode double-mount /
+            // React render-time tearing) shouldn't kill the shared
+            // state. The iframe full-reload tears the singleton down
+            // implicitly when the page goes away; SDK-level HMR is
+            // handled by import.meta.hot.dispose at the top of file.
         };
     }, [client]);
     const methods = useMemo(() => ({
         openUpload: (uploadId) => client.openUpload(uploadId),
         requestToken: () => client.requestToken(),
         close: () => client.close(),
+        markReady: () => client.signalReady(),
         apiAdapter: client.getApiAdapter(),
     }), [client]);
     return {
@@ -107,6 +171,7 @@ export function useRendererClient(options) {
         config,
         entrypoint,
         apiBaseUrl,
+        resource,
         path,
         client,
         ...methods,

package/dist/react/useRendererClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"useRendererClient.js","sourceRoot":"","sources":["../../src/react/useRendererClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useRendererClient.js","sourceRoot":"","sources":["../../src/react/useRendererClient.ts"],"names":[],"mappings":"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"}

package/dist/react/useReportFatalError.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Hook for surfacing async failures to `<RendererErrorBoundary>` (and from
+ * there to the host's crash overlay + telemetry).
+ *
+ * Renderers shouldn't render their own "Upload not found" / "Failed to
+ * load" inline UI — those are still crashes from a telemetry standpoint,
+ * and the host already owns a polished overlay with reload + fallback
+ * actions. This hook lets a renderer take an error caught in an async
+ * context (fetch `.catch()`, useEffect cleanup, etc.) and route it to
+ * the host instead of rendering a half-broken inline state.
+ *
+ * Pattern:
+ *
+ * ```tsx
+ * const reportFatal = useReportFatalError();
+ * useEffect(() => {
+ *   client.getUpload(...).catch(reportFatal);
+ * }, []);
+ * ```
+ *
+ * Mechanics: we keep an error in component state. When set, the *next*
+ * render throws it — React's error-handling pipeline catches the throw
+ * and bubbles to the nearest boundary. From there
+ * `RendererErrorBoundary.componentDidCatch` reports the crash to the
+ * host and renders nothing, and the host overlay (Reload / Copy /
+ * Fallback) takes over the visible iframe area.
+ *
+ * Why state-then-throw rather than a direct `throw err`? You can't
+ * throw to React from async code — React only sees throws that happen
+ * during render or in event handlers. Routing through state ensures
+ * the throw lands inside the render phase.
+ *
+ * The returned callback is stable across renders so it's safe to drop
+ * straight into a `.catch()`.
+ */
+export declare function useReportFatalError(): (err: unknown) => void;
+//# sourceMappingURL=useReportFatalError.d.ts.map

package/dist/react/useReportFatalError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReportFatalError.d.ts","sourceRoot":"","sources":["../../src/react/useReportFatalError.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,mBAAmB,IAAI,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAiC5D"}

package/dist/react/useReportFatalError.js

@@ -0,0 +1,71 @@
+import { useCallback, useState } from 'react';
+/**
+ * Hook for surfacing async failures to `<RendererErrorBoundary>` (and from
+ * there to the host's crash overlay + telemetry).
+ *
+ * Renderers shouldn't render their own "Upload not found" / "Failed to
+ * load" inline UI — those are still crashes from a telemetry standpoint,
+ * and the host already owns a polished overlay with reload + fallback
+ * actions. This hook lets a renderer take an error caught in an async
+ * context (fetch `.catch()`, useEffect cleanup, etc.) and route it to
+ * the host instead of rendering a half-broken inline state.
+ *
+ * Pattern:
+ *
+ * ```tsx
+ * const reportFatal = useReportFatalError();
+ * useEffect(() => {
+ *   client.getUpload(...).catch(reportFatal);
+ * }, []);
+ * ```
+ *
+ * Mechanics: we keep an error in component state. When set, the *next*
+ * render throws it — React's error-handling pipeline catches the throw
+ * and bubbles to the nearest boundary. From there
+ * `RendererErrorBoundary.componentDidCatch` reports the crash to the
+ * host and renders nothing, and the host overlay (Reload / Copy /
+ * Fallback) takes over the visible iframe area.
+ *
+ * Why state-then-throw rather than a direct `throw err`? You can't
+ * throw to React from async code — React only sees throws that happen
+ * during render or in event handlers. Routing through state ensures
+ * the throw lands inside the render phase.
+ *
+ * The returned callback is stable across renders so it's safe to drop
+ * straight into a `.catch()`.
+ */
+export function useReportFatalError() {
+    // Generic state slot — we never read the value, only use the
+    // updater. We narrow to `never` so TypeScript stops us from
+    // accidentally using it as data anywhere.
+    const [, setState] = useState();
+    return useCallback((err) => {
+        // Functional updater throws — React invokes it during the next
+        // render attempt, which puts the throw inside the render phase
+        // where boundaries can see it.
+        setState(() => {
+            if (err instanceof Error) {
+                throw err;
+            }
+            // Wrap non-Error throws so the boundary always sees a real
+            // Error instance with a meaningful .name / .message. Without
+            // this, `client.reportCrash` would synthesise a generic
+            // 'UnknownError' which loses the original payload's shape.
+            if (typeof err === 'string') {
+                throw new Error(err);
+            }
+            if (err && typeof err === 'object' && 'message' in err && typeof err.message === 'string') {
+                const wrapped = new Error(err.message);
+                if ('name' in err && typeof err.name === 'string') {
+                    wrapped.name = err.name;
+                }
+                if ('stack' in err && typeof err.stack === 'string') {
+                    wrapped.stack = err.stack;
+                }
+                throw wrapped;
+            }
+            throw new Error('Unknown renderer error');
+        });
+    }, []);
+}
+//# sourceMappingURL=useReportFatalError.js.map

package/dist/react/useReportFatalError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReportFatalError.js","sourceRoot":"","sources":["../../src/react/useReportFatalError.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,mBAAmB;IAClC,6DAA6D;IAC7D,4DAA4D;IAC5D,0CAA0C;IAC1C,MAAM,CAAC,EAAE,QAAQ,CAAC,GAAG,QAAQ,EAAS,CAAC;IACvC,OAAO,WAAW,CAAC,CAAC,GAAY,EAAE,EAAE;QACnC,+DAA+D;QAC/D,+DAA+D;QAC/D,+BAA+B;QAC/B,QAAQ,CAAC,GAAG,EAAE;YACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;gBAC1B,MAAM,GAAG,CAAC;YACX,CAAC;YACD,2DAA2D;YAC3D,6DAA6D;YAC7D,wDAAwD;YACxD,2DAA2D;YAC3D,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;YACD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC3F,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACvC,IAAI,MAAM,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACnD,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;gBACzB,CAAC;gBACD,IAAI,OAAO,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACrD,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;gBAC3B,CAAC;gBACD,MAAM,OAAO,CAAC;YACf,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;AACR,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,25 @@
+import { type Upload, type Folder } from '@xeonr/uploads-protocol/uplim/api/v1/uploads_pb';
+import { type Bucket } from '@xeonr/uploads-protocol/uplim/api/v1/buckets_pb';
+import type { RendererApiAdapter, RendererScope } from './types.js';
+/**
+ * Best-effort decoder for the host's pre-loaded `resource` field. The
+ * host serialises via `toJson(UploadSchema, …)`/etc and posts the JSON
+ * across the iframe boundary, so we run it back through `fromJson` to
+ * land at a real Message instance with the right prototype methods.
+ *
+ * Returns null on any failure (schema mismatch, missing fields, etc.)
+ * so callers fall through to a fresh fetch.
+ */
+export declare function decodeUploadResource(value: unknown): Upload | null;
+export declare function decodeFolderResource(value: unknown): Folder | null;
+export declare function decodeBucketResource(value: unknown): Bucket | null;
+/**
+ * Fetch the upload for the current scope via the API. Caller already
+ * narrowed the scope; we just translate to the BucketUploadsService
+ * RPC. Throws when the API returns no upload (treated as a not-found
+ * by the renderer).
+ */
+export declare function fetchUpload(scope: RendererScope, apiAdapter: RendererApiAdapter): Promise<Upload>;
+export declare function fetchFolder(scope: RendererScope, apiAdapter: RendererApiAdapter): Promise<Folder>;
+export declare function fetchBucket(scope: RendererScope, apiAdapter: RendererApiAdapter): Promise<Bucket>;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAaA,OAAO,EAKN,KAAK,MAAM,EACX,KAAK,MAAM,EACX,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAGN,KAAK,MAAM,EACX,MAAM,iDAAiD,CAAC;AAEzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAOlE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAOlE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAOlE;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAChC,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,kBAAkB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED,wBAAsB,WAAW,CAChC,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,kBAAkB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,WAAW,CAChC,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,kBAAkB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAOjB"}

package/dist/resources.js

@@ -0,0 +1,104 @@
+/**
+ * Typed resource accessors that read from the host-seeded `resource`
+ * cache first and fall back to a real API call when the cache is
+ * absent or stale.
+ *
+ * Lives in its own file so the imports against `@xeonr/uploads-protocol`
+ * and `@xeonr/uploads-sdk` are kept out of `client.ts`. Those packages
+ * are declared as optional peer dependencies — a renderer that never
+ * calls `getUpload()` / `getFolder()` / `getBucket()` doesn't need to
+ * install them. The fetch helpers throw at call time when the deps are
+ * missing.
+ */
+import { fromJson } from '@bufbuild/protobuf';
+import { BucketUploadsService, BucketFoldersService, UploadSchema, FolderSchema, } from '@xeonr/uploads-protocol/uplim/api/v1/uploads_pb';
+import { BucketsService, BucketSchema, } from '@xeonr/uploads-protocol/uplim/api/v1/buckets_pb';
+import { getUploadClientWithEnv } from '@xeonr/uploads-sdk/api/base';
+/**
+ * Best-effort decoder for the host's pre-loaded `resource` field. The
+ * host serialises via `toJson(UploadSchema, …)`/etc and posts the JSON
+ * across the iframe boundary, so we run it back through `fromJson` to
+ * land at a real Message instance with the right prototype methods.
+ *
+ * Returns null on any failure (schema mismatch, missing fields, etc.)
+ * so callers fall through to a fresh fetch.
+ */
+export function decodeUploadResource(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    try {
+        return fromJson(UploadSchema, value);
+    }
+    catch {
+        return null;
+    }
+}
+export function decodeFolderResource(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    try {
+        return fromJson(FolderSchema, value);
+    }
+    catch {
+        return null;
+    }
+}
+export function decodeBucketResource(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    try {
+        return fromJson(BucketSchema, value);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Fetch the upload for the current scope via the API. Caller already
+ * narrowed the scope; we just translate to the BucketUploadsService
+ * RPC. Throws when the API returns no upload (treated as a not-found
+ * by the renderer).
+ */
+export async function fetchUpload(scope, apiAdapter) {
+    if (scope.type !== 'upload') {
+        throw new Error('fetchUpload requires an upload-typed scope');
+    }
+    const client = getUploadClientWithEnv(BucketUploadsService, apiAdapter);
+    const res = await client.getUpload({
+        bucketRef: { type: { case: 'bucketId', value: scope.bucketId } },
+        uploadRef: { type: { case: 'uploadId', value: scope.uploadId } },
+    });
+    if (!res.upload)
+        throw new Error('Upload not found');
+    return res.upload;
+}
+export async function fetchFolder(scope, apiAdapter) {
+    // Folder scopes ('folder' or 'virtual-file' with a folderId) carry
+    // the identifier; everything else is a misuse.
+    let folderId;
+    if (scope.type === 'folder')
+        folderId = scope.folderId;
+    else if (scope.type === 'virtual-file')
+        folderId = scope.folderId;
+    if (!folderId) {
+        throw new Error('fetchFolder requires a folder-typed scope with a folderId');
+    }
+    const client = getUploadClientWithEnv(BucketFoldersService, apiAdapter);
+    const res = await client.getFolder({
+        bucketRef: { type: { case: 'bucketId', value: scope.bucketId } },
+        folderRef: { type: { case: 'folderId', value: folderId } },
+    });
+    if (!res.folder)
+        throw new Error('Folder not found');
+    return res.folder;
+}
+export async function fetchBucket(scope, apiAdapter) {
+    const client = getUploadClientWithEnv(BucketsService, apiAdapter);
+    const res = await client.getBucket({
+        bucketRef: { type: { case: 'bucketId', value: scope.bucketId } },
+    });
+    if (!res.bucket)
+        throw new Error('Bucket not found');
+    return res.bucket;
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -32,6 +32,25 @@ export interface RendererConfig {
      * republished without bumping the archive). Bounded to 64 chars.
      */
     buildHash?: string;
+    /**
+     * When true, the SDK holds `uplim:ack` until the renderer explicitly
+     * calls `markReady()` from `useRendererClient()`. The host's loading
+     * overlay stays visible until that signal arrives, so the user
+     * never sees a blank canvas between bridge ack and the renderer's
+     * first paint.
+     *
+     * Leave unset (or `false`) for fast renderers where the gap is
+     * invisible — that's the right default and lowest-friction pattern
+     * (image, code, plain markdown). Set `true` when the renderer takes
+     * perceptible time to settle (large file fetch, video decode,
+     * multi-page paginate) and the blank-canvas flash is noticeable.
+     *
+     * The SDK auto-acks after 30s (configurable via
+     * `RendererClientOptions.readyTimeoutMs`) and logs a warning if
+     * `markReady()` never fires — so a forgotten signal can't trap
+     * users behind the overlay.
+     */
+    deferReady?: boolean;
 }
 export type RendererPermission = 'createFolder' | 'openUpload';
 /**
@@ -98,5 +117,23 @@ export interface InitPayload {
     config: RendererConfig;
     /** Initial hash path to navigate to, derived from the host URL fragment. */
     initialPath?: string;
+    /**
+     * Pre-loaded resource snapshot the host already had on hand when it
+     * mounted the iframe — typically the `Upload` proto (in its JSON
+     * encoding) for upload-scoped renderers, or `Folder` for folder
+     * scopes. Renderers can consume this directly to avoid an extra
+     * GetUpload / GetFolder round trip on first paint.
+     *
+     * Shape is intentionally loose (`unknown`) because the SDK is
+     * deliberately decoupled from the @xeonr/uploads-protocol types —
+     * renderers cast to the proto JSON type (e.g. `UploadJson`) on use.
+     * Treat as advisory: if absent or stale, fall back to a fresh fetch.
+     *
+     * Stays in sync via the existing `resource_url`-style fetches that
+     * the renderer triggers when the host posts an updated init (e.g.
+     * after edit / replace flows). For now hosts only populate the
+     * field for upload-typed scopes; future hosts may extend.
+     */
+    resource?: unknown;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,uDAAuD;IACvD,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE;QACT,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,kBAAkB,GAC3B,cAAc,GACd,YAAY,CAAC;AAEhB;;;GAGG;AACH,MAAM,MAAM,aAAa,GACtB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,wBAAwB,CAAC;AAE5B,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GACtB,iBAAiB,GACjB,iBAAiB,GACjB,eAAe,CAAC;AAEnB;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3C,uBAAuB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,sBAAsB,CAAC,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;CAC5C;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC3B,wBAAwB;IACxB,OAAO,EAAE,CAAC,CAAC;IACX,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,mCAAmC;IACnC,UAAU,EAAE,WAAW,GAAG,QAAQ,CAAC;IACnC,+CAA+C;IAC/C,KAAK,EAAE,aAAa,CAAC;IACrB,4DAA4D;IAC5D,aAAa,EAAE,aAAa,CAAC;IAC7B,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,MAAM,EAAE,cAAc,CAAC;IACvB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,uDAAuD;IACvD,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE;QACT,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,kBAAkB,GAC3B,cAAc,GACd,YAAY,CAAC;AAEhB;;;GAGG;AACH,MAAM,MAAM,aAAa,GACtB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,wBAAwB,CAAC;AAE5B,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GACtB,iBAAiB,GACjB,iBAAiB,GACjB,eAAe,CAAC;AAEnB;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3C,uBAAuB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,sBAAsB,CAAC,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;CAC5C;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC3B,wBAAwB;IACxB,OAAO,EAAE,CAAC,CAAC;IACX,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,mCAAmC;IACnC,UAAU,EAAE,WAAW,GAAG,QAAQ,CAAC;IACnC,+CAA+C;IAC/C,KAAK,EAAE,aAAa,CAAC;IACrB,4DAA4D;IAC5D,aAAa,EAAE,aAAa,CAAC;IAC7B,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,MAAM,EAAE,cAAc,CAAC;IACvB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xeonr/renderer-sdk",
-  "version": "1.1.0",
+  "version": "1.5.0",
   "type": "module",
   "license": "ISC",
   "description": "SDK for building custom renderers for upl.im integrations",
@@ -30,7 +30,10 @@
   },
   "peerDependencies": {
     "react": ">=18.0.0",
-    "react-dom": ">=18.0.0"
+    "react-dom": ">=18.0.0",
+    "@bufbuild/protobuf": ">=2.0.0",
+    "@xeonr/uploads-protocol": "*",
+    "@xeonr/uploads-sdk": "*"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -38,14 +41,26 @@
     },
     "react-dom": {
       "optional": true
+    },
+    "@bufbuild/protobuf": {
+      "optional": true
+    },
+    "@xeonr/uploads-protocol": {
+      "optional": true
+    },
+    "@xeonr/uploads-sdk": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "@bufbuild/protobuf": "^2.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "typescript": "^5.8.3"
+    "typescript": "^5.8.3",
+    "@xeonr/uploads-protocol": "1.0.6",
+    "@xeonr/uploads-sdk": "1.0.6"
   },
   "scripts": {
     "build": "tsc"