@disconnectme/lightbox-sdk 0.1.3 → 0.1.4

package/dist/index.cjs

@@ -50,7 +50,7 @@ var LightboxClient = class {
   apiKey;
   constructor(config) {
     this.apiKey = config.apiKey;
-    this.baseUrl = config.baseUrl ?? "https://api.datafin.ai";
+    this.baseUrl = config.baseUrl ?? "https://api.lightbox.dev";
   }
   async request(path, params) {
     const url = new URL(path, this.baseUrl);
@@ -93,6 +93,37 @@ var LightboxClient = class {
      */
     get: (hash, params) => {
       return this.request(`/v1/files/${hash}`, params);
+    },
+    /**
+     * Resolve a signed download URL for a file path.
+     * Returns the signed URL and its expiration timestamp.
+     */
+    download: async (params) => {
+      const url = new URL("/v1/files/download", this.baseUrl);
+      url.searchParams.set("bundle", params.bundle);
+      url.searchParams.set("version", params.version);
+      url.searchParams.set("file_path", params.file_path);
+      const response = await fetch(url.toString(), {
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`
+        },
+        redirect: "manual"
+      });
+      if (response.status === 302) {
+        const location = response.headers.get("Location");
+        if (!location) {
+          throw new Error("Missing Location header on download redirect");
+        }
+        return {
+          download_url: location,
+          expires_at: response.headers.get("X-Download-Expires-At")
+        };
+      }
+      const data = await response.json();
+      if (!response.ok) {
+        throw LightboxError.fromAPIError(data);
+      }
+      throw new Error("Unexpected response from download endpoint");
     }
   };
   /**

package/dist/index.d.cts

@@ -37,7 +37,6 @@ interface FileSearchResult {
     file_path: string | null;
     file_size_bytes: number;
     download_url: string | null;
-    expires_at: string | null;
 }
 interface FileHashResult {
     bundle: string;
@@ -48,6 +47,9 @@ interface FileHashResult {
     file_path: string | null;
     file_size: number;
     download_url: string | null;
+}
+interface FileDownloadResult {
+    download_url: string;
     expires_at: string | null;
 }
 interface FileSearchData {
@@ -122,7 +124,6 @@ interface AppFile {
     file_path: string | null;
     file_size_bytes: number;
     download_url: string | null;
-    expires_at: string | null;
 }
 interface AppSearchData {
     type: "app_collection";
@@ -201,6 +202,11 @@ interface FileSearchParams extends PaginationParams {
     min_size?: number;
     max_size?: number;
 }
+interface FileDownloadParams {
+    bundle: string;
+    version: string;
+    file_path: string;
+}
 interface AppSearchParams extends PaginationParams {
     framework?: string;
     entitlement?: string;
@@ -371,6 +377,11 @@ declare class LightboxClient {
          * Returns the apps containing this file and download URLs.
          */
         get: (hash: string, params?: PaginationParams) => Promise<FileHashResponse>;
+        /**
+         * Resolve a signed download URL for a file path.
+         * Returns the signed URL and its expiration timestamp.
+         */
+        download: (params: FileDownloadParams) => Promise<FileDownloadResult>;
     };
     /**
      * App-related API methods (iOS apps)
@@ -473,4 +484,4 @@ declare class LightboxClient {
     };
 }
 
-export { type APIError, type APIMetadata, type APIResponse, type AppFile, type AppFilesData, type AppFilesParams, type AppFilesResponse, type AppGetParams, type AppProfile, type AppProfileData, type AppProfileResponse, type AppSearchData, type AppSearchParams, type AppSearchResponse, type AppSummary, type AppVersion, type AppVersionsData, type AppVersionsResponse, type EntitlementItem, type EntitlementListData, type EntitlementListResponse, type FileHashData, type FileHashResponse, type FileHashResult, type FileSearchData, type FileSearchParams, type FileSearchResponse, type FileSearchResult, type FrameworkItem, type FrameworkListData, type FrameworkListResponse, type GenreItem, type GenreListData, type GenreListResponse, type JavaScriptCatalogParams, type JavaScriptCatalogResponse, type JavaScriptScriptsParams, type JavaScriptSitesParams, type JavaScriptSymbolCatalogData, type JavaScriptSymbolCatalogItem, type JavaScriptSymbolCategory, type JavaScriptSymbolCollectionData, type JavaScriptSymbolCollectionResponse, type JavaScriptSymbolObservation, type JavaScriptSymbolParams, LightboxClient, type LightboxClientConfig, LightboxError, type MetadataSearchParams, type Pagination, type PaginationParams, type ScopeMode, type WebCookie, type WebCookieCollectionData, type WebCookieCollectionResponse, type WebDomainCookiesParams, type WebDomainRequestsParams, type WebRequest, type WebRequestCollectionData, type WebRequestCollectionResponse, type WebSiteCookiesParams, type WebSiteRequestsParams };
+export { type APIError, type APIMetadata, type APIResponse, type AppFile, type AppFilesData, type AppFilesParams, type AppFilesResponse, type AppGetParams, type AppProfile, type AppProfileData, type AppProfileResponse, type AppSearchData, type AppSearchParams, type AppSearchResponse, type AppSummary, type AppVersion, type AppVersionsData, type AppVersionsResponse, type EntitlementItem, type EntitlementListData, type EntitlementListResponse, type FileDownloadParams, type FileDownloadResult, type FileHashData, type FileHashResponse, type FileHashResult, type FileSearchData, type FileSearchParams, type FileSearchResponse, type FileSearchResult, type FrameworkItem, type FrameworkListData, type FrameworkListResponse, type GenreItem, type GenreListData, type GenreListResponse, type JavaScriptCatalogParams, type JavaScriptCatalogResponse, type JavaScriptScriptsParams, type JavaScriptSitesParams, type JavaScriptSymbolCatalogData, type JavaScriptSymbolCatalogItem, type JavaScriptSymbolCategory, type JavaScriptSymbolCollectionData, type JavaScriptSymbolCollectionResponse, type JavaScriptSymbolObservation, type JavaScriptSymbolParams, LightboxClient, type LightboxClientConfig, LightboxError, type MetadataSearchParams, type Pagination, type PaginationParams, type ScopeMode, type WebCookie, type WebCookieCollectionData, type WebCookieCollectionResponse, type WebDomainCookiesParams, type WebDomainRequestsParams, type WebRequest, type WebRequestCollectionData, type WebRequestCollectionResponse, type WebSiteCookiesParams, type WebSiteRequestsParams };

package/dist/index.d.ts

@@ -37,7 +37,6 @@ interface FileSearchResult {
     file_path: string | null;
     file_size_bytes: number;
     download_url: string | null;
-    expires_at: string | null;
 }
 interface FileHashResult {
     bundle: string;
@@ -48,6 +47,9 @@ interface FileHashResult {
     file_path: string | null;
     file_size: number;
     download_url: string | null;
+}
+interface FileDownloadResult {
+    download_url: string;
     expires_at: string | null;
 }
 interface FileSearchData {
@@ -122,7 +124,6 @@ interface AppFile {
     file_path: string | null;
     file_size_bytes: number;
     download_url: string | null;
-    expires_at: string | null;
 }
 interface AppSearchData {
     type: "app_collection";
@@ -201,6 +202,11 @@ interface FileSearchParams extends PaginationParams {
     min_size?: number;
     max_size?: number;
 }
+interface FileDownloadParams {
+    bundle: string;
+    version: string;
+    file_path: string;
+}
 interface AppSearchParams extends PaginationParams {
     framework?: string;
     entitlement?: string;
@@ -371,6 +377,11 @@ declare class LightboxClient {
          * Returns the apps containing this file and download URLs.
          */
         get: (hash: string, params?: PaginationParams) => Promise<FileHashResponse>;
+        /**
+         * Resolve a signed download URL for a file path.
+         * Returns the signed URL and its expiration timestamp.
+         */
+        download: (params: FileDownloadParams) => Promise<FileDownloadResult>;
     };
     /**
      * App-related API methods (iOS apps)
@@ -473,4 +484,4 @@ declare class LightboxClient {
     };
 }
 
-export { type APIError, type APIMetadata, type APIResponse, type AppFile, type AppFilesData, type AppFilesParams, type AppFilesResponse, type AppGetParams, type AppProfile, type AppProfileData, type AppProfileResponse, type AppSearchData, type AppSearchParams, type AppSearchResponse, type AppSummary, type AppVersion, type AppVersionsData, type AppVersionsResponse, type EntitlementItem, type EntitlementListData, type EntitlementListResponse, type FileHashData, type FileHashResponse, type FileHashResult, type FileSearchData, type FileSearchParams, type FileSearchResponse, type FileSearchResult, type FrameworkItem, type FrameworkListData, type FrameworkListResponse, type GenreItem, type GenreListData, type GenreListResponse, type JavaScriptCatalogParams, type JavaScriptCatalogResponse, type JavaScriptScriptsParams, type JavaScriptSitesParams, type JavaScriptSymbolCatalogData, type JavaScriptSymbolCatalogItem, type JavaScriptSymbolCategory, type JavaScriptSymbolCollectionData, type JavaScriptSymbolCollectionResponse, type JavaScriptSymbolObservation, type JavaScriptSymbolParams, LightboxClient, type LightboxClientConfig, LightboxError, type MetadataSearchParams, type Pagination, type PaginationParams, type ScopeMode, type WebCookie, type WebCookieCollectionData, type WebCookieCollectionResponse, type WebDomainCookiesParams, type WebDomainRequestsParams, type WebRequest, type WebRequestCollectionData, type WebRequestCollectionResponse, type WebSiteCookiesParams, type WebSiteRequestsParams };
+export { type APIError, type APIMetadata, type APIResponse, type AppFile, type AppFilesData, type AppFilesParams, type AppFilesResponse, type AppGetParams, type AppProfile, type AppProfileData, type AppProfileResponse, type AppSearchData, type AppSearchParams, type AppSearchResponse, type AppSummary, type AppVersion, type AppVersionsData, type AppVersionsResponse, type EntitlementItem, type EntitlementListData, type EntitlementListResponse, type FileDownloadParams, type FileDownloadResult, type FileHashData, type FileHashResponse, type FileHashResult, type FileSearchData, type FileSearchParams, type FileSearchResponse, type FileSearchResult, type FrameworkItem, type FrameworkListData, type FrameworkListResponse, type GenreItem, type GenreListData, type GenreListResponse, type JavaScriptCatalogParams, type JavaScriptCatalogResponse, type JavaScriptScriptsParams, type JavaScriptSitesParams, type JavaScriptSymbolCatalogData, type JavaScriptSymbolCatalogItem, type JavaScriptSymbolCategory, type JavaScriptSymbolCollectionData, type JavaScriptSymbolCollectionResponse, type JavaScriptSymbolObservation, type JavaScriptSymbolParams, LightboxClient, type LightboxClientConfig, LightboxError, type MetadataSearchParams, type Pagination, type PaginationParams, type ScopeMode, type WebCookie, type WebCookieCollectionData, type WebCookieCollectionResponse, type WebDomainCookiesParams, type WebDomainRequestsParams, type WebRequest, type WebRequestCollectionData, type WebRequestCollectionResponse, type WebSiteCookiesParams, type WebSiteRequestsParams };

package/dist/index.js

@@ -23,7 +23,7 @@ var LightboxClient = class {
   apiKey;
   constructor(config) {
     this.apiKey = config.apiKey;
-    this.baseUrl = config.baseUrl ?? "https://api.datafin.ai";
+    this.baseUrl = config.baseUrl ?? "https://api.lightbox.dev";
   }
   async request(path, params) {
     const url = new URL(path, this.baseUrl);
@@ -66,6 +66,37 @@ var LightboxClient = class {
      */
     get: (hash, params) => {
       return this.request(`/v1/files/${hash}`, params);
+    },
+    /**
+     * Resolve a signed download URL for a file path.
+     * Returns the signed URL and its expiration timestamp.
+     */
+    download: async (params) => {
+      const url = new URL("/v1/files/download", this.baseUrl);
+      url.searchParams.set("bundle", params.bundle);
+      url.searchParams.set("version", params.version);
+      url.searchParams.set("file_path", params.file_path);
+      const response = await fetch(url.toString(), {
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`
+        },
+        redirect: "manual"
+      });
+      if (response.status === 302) {
+        const location = response.headers.get("Location");
+        if (!location) {
+          throw new Error("Missing Location header on download redirect");
+        }
+        return {
+          download_url: location,
+          expires_at: response.headers.get("X-Download-Expires-At")
+        };
+      }
+      const data = await response.json();
+      if (!response.ok) {
+        throw LightboxError.fromAPIError(data);
+      }
+      throw new Error("Unexpected response from download endpoint");
     }
   };
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@disconnectme/lightbox-sdk",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "TypeScript SDK for the Lightbox Data API by Disconnect",
   "type": "module",
   "engines": {