@redseat/api 0.1.9 → 0.1.11

package/dist/client.d.ts

@@ -33,4 +33,12 @@ export declare class RedseatClient {
     patch<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<T, any>>;
     delete<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<T, any>>;
     request<T = unknown>(method: Method, url: string, data?: unknown, config?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<T, any>>;
+    /**
+     * Constructs a full absolute URL from a path.
+     * Uses the current baseUrl (which may be local or remote depending on detection).
+     * @param path - The path to append to the base URL
+     * @param params - Optional query parameters to include
+     * @returns The full absolute URL
+     */
+    getFullUrl(path: string, params?: Record<string, string>): string;
 }

package/dist/client.js

@@ -159,4 +159,19 @@ export class RedseatClient {
             ...config
         });
     }
+    /**
+     * Constructs a full absolute URL from a path.
+     * Uses the current baseUrl (which may be local or remote depending on detection).
+     * @param path - The path to append to the base URL
+     * @param params - Optional query parameters to include
+     * @returns The full absolute URL
+     */
+    getFullUrl(path, params) {
+        let url = `${this.baseUrl}${path}`;
+        if (params && Object.keys(params).length > 0) {
+            const searchParams = new URLSearchParams(params);
+            url = `${url}?${searchParams.toString()}`;
+        }
+        return url;
+    }
 }

package/dist/library.d.ts

@@ -72,6 +72,7 @@ export interface LibraryHttpClient {
     delete<T = unknown>(url: string, config?: any): Promise<{
         data: T;
     }>;
+    getFullUrl(path: string, params?: Record<string, string>): string;
 }
 export declare class LibraryApi {
     private client;
@@ -201,6 +202,34 @@ export declare class LibraryApi {
      * @throws Error if the URL is not available or cannot be made permanent
      */
     checkRequestPermanent(request: RsRequest): Promise<RsRequest>;
+    /**
+     * Get a share token for a request URL.
+     * The token can be used to stream/download the resource without authentication.
+     * @param url - The request URL to get a share token for
+     * @returns A temporary share token valid for 6 hours
+     */
+    getRequestShareToken(url: string): Promise<string>;
+    /**
+     * Get a share token for a media file.
+     * The token can be used to access the media without authentication.
+     * @param mediaId - The media ID to get a share token for
+     * @returns A temporary share token valid for 6 hours
+     */
+    getMediaShareToken(mediaId: string): Promise<string>;
+    /**
+     * Get a shareable URL for streaming a request.
+     * Fetches a share token and returns a complete URL that can be used without authentication.
+     * @param url - The request URL to create a share link for
+     * @returns A complete URL with sharetoken that can be used to stream the content
+     */
+    getRequestShareUrl(url: string): Promise<string>;
+    /**
+     * Get a shareable URL for a media file.
+     * Fetches a share token and returns a complete URL that can be used without authentication.
+     * @param mediaId - The media ID to create a share link for
+     * @returns A complete URL with sharetoken that can be used to access the media
+     */
+    getMediaShareUrl(mediaId: string): Promise<string>;
     getUnassignedFaces(params?: Map<string, string>): Promise<any>;
     getClusters(): Promise<any>;
     assignFaces(request: any): Promise<any>;

package/dist/library.js

@@ -459,6 +459,53 @@ export class LibraryApi {
         const res = await this.client.post(this.getUrl('/plugins/requests/permanent'), request);
         return res.data;
     }
+    /**
+     * Get a share token for a request URL.
+     * The token can be used to stream/download the resource without authentication.
+     * @param url - The request URL to get a share token for
+     * @returns A temporary share token valid for 6 hours
+     */
+    async getRequestShareToken(url) {
+        const res = await this.client.get(this.getUrl('/plugins/requests/url/sharetoken'), {
+            params: { url }
+        });
+        return res.data;
+    }
+    /**
+     * Get a share token for a media file.
+     * The token can be used to access the media without authentication.
+     * @param mediaId - The media ID to get a share token for
+     * @returns A temporary share token valid for 6 hours
+     */
+    async getMediaShareToken(mediaId) {
+        const res = await this.client.get(this.getUrl(`/medias/${mediaId}/sharetoken`));
+        return res.data;
+    }
+    /**
+     * Get a shareable URL for streaming a request.
+     * Fetches a share token and returns a complete URL that can be used without authentication.
+     * @param url - The request URL to create a share link for
+     * @returns A complete URL with sharetoken that can be used to stream the content
+     */
+    async getRequestShareUrl(url) {
+        const shareToken = await this.getRequestShareToken(url);
+        return this.client.getFullUrl(this.getUrl('/plugins/requests/url/stream'), {
+            sharetoken: shareToken,
+            url
+        });
+    }
+    /**
+     * Get a shareable URL for a media file.
+     * Fetches a share token and returns a complete URL that can be used without authentication.
+     * @param mediaId - The media ID to create a share link for
+     * @returns A complete URL with sharetoken that can be used to access the media
+     */
+    async getMediaShareUrl(mediaId) {
+        const shareToken = await this.getMediaShareToken(mediaId);
+        return this.client.getFullUrl(this.getUrl(`/medias/${mediaId}`), {
+            sharetoken: shareToken
+        });
+    }
     async getUnassignedFaces(params) {
         const queryParams = {};
         if (params) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@redseat/api",
-    "version": "0.1.9",
+    "version": "0.1.11",
     "description": "TypeScript API client library for interacting with Redseat servers",
     "type": "module",
     "main": "./dist/index.js",