@disconnectme/lightbox-sdk 0.1.2 → 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");
     }
   };
   /**
@@ -216,6 +247,48 @@ var LightboxClient = class {
           params
         );
       }
+    },
+    /**
+     * JavaScript API symbol tracking methods
+     */
+    javascript: {
+      /**
+       * Get the catalog of all JavaScript symbols available for querying.
+       * This is a static list of browser APIs monitored during web crawls.
+       */
+      catalog: (params) => {
+        return this.request(
+          "/v1/web/javascript/symbols",
+          params
+        );
+      },
+      /**
+       * Get all scripts that access a specific JavaScript API symbol.
+       */
+      symbols: (symbol, params) => {
+        return this.request(
+          `/v1/web/javascript/symbols/${encodeURIComponent(symbol)}`,
+          params
+        );
+      },
+      /**
+       * Get JavaScript API accesses by scripts from a specific domain.
+       */
+      scripts: (domain, params) => {
+        return this.request(
+          `/v1/web/javascript/scripts/${encodeURIComponent(domain)}`,
+          params
+        );
+      },
+      /**
+       * Get JavaScript API accesses observed when visiting a specific site.
+       */
+      sites: (site, params) => {
+        return this.request(
+          `/v1/web/javascript/sites/${encodeURIComponent(site)}`,
+          params
+        );
+      }
     }
   };
 };

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;
@@ -281,6 +287,53 @@ interface MetadataSearchParams extends PaginationParams {
     search?: string;
     sort?: "popularity" | "name";
 }
+type JavaScriptSymbolCategory = "canvas" | "audio" | "webrtc" | "navigator" | "screen" | "storage" | "cookie" | "referrer";
+interface JavaScriptSymbolCatalogItem {
+    symbol: string;
+    category: JavaScriptSymbolCategory;
+    description: string;
+}
+interface JavaScriptSymbolCatalogData {
+    type: "javascript_symbol_catalog";
+    total_symbols: number;
+    categories: string[];
+    note: string;
+    symbols: JavaScriptSymbolCatalogItem[];
+}
+interface JavaScriptSymbolObservation {
+    id: string;
+    script_etld1: string;
+    site_etld1: string;
+    script_url: string;
+    symbol: string;
+    symbol_category: string;
+    operation: string | null;
+    arguments: string | null;
+    value: string | null;
+    timestamp: string;
+}
+interface JavaScriptSymbolCollectionData {
+    type: "javascript_symbol_collection";
+    summary: {
+        returned: number;
+    };
+    symbols: JavaScriptSymbolObservation[];
+}
+interface JavaScriptCatalogParams {
+    category?: JavaScriptSymbolCategory;
+}
+interface JavaScriptSymbolParams extends PaginationParams {
+}
+interface JavaScriptScriptsParams extends PaginationParams {
+    symbol?: string;
+    category?: JavaScriptSymbolCategory;
+}
+interface JavaScriptSitesParams extends PaginationParams {
+    symbol?: string;
+    category?: JavaScriptSymbolCategory;
+}
+type JavaScriptCatalogResponse = APIResponse<JavaScriptSymbolCatalogData>;
+type JavaScriptSymbolCollectionResponse = APIResponse<JavaScriptSymbolCollectionData>;
 type FileSearchResponse = APIResponse<FileSearchData>;
 type FileHashResponse = APIResponse<FileHashData>;
 type AppSearchResponse = APIResponse<AppSearchData>;
@@ -324,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)
@@ -401,7 +459,29 @@ declare class LightboxClient {
              */
             cookies: (domain: string, params?: WebDomainCookiesParams) => Promise<WebCookieCollectionResponse>;
         };
+        /**
+         * JavaScript API symbol tracking methods
+         */
+        javascript: {
+            /**
+             * Get the catalog of all JavaScript symbols available for querying.
+             * This is a static list of browser APIs monitored during web crawls.
+             */
+            catalog: (params?: JavaScriptCatalogParams) => Promise<JavaScriptCatalogResponse>;
+            /**
+             * Get all scripts that access a specific JavaScript API symbol.
+             */
+            symbols: (symbol: string, params?: JavaScriptSymbolParams) => Promise<JavaScriptSymbolCollectionResponse>;
+            /**
+             * Get JavaScript API accesses by scripts from a specific domain.
+             */
+            scripts: (domain: string, params?: JavaScriptScriptsParams) => Promise<JavaScriptSymbolCollectionResponse>;
+            /**
+             * Get JavaScript API accesses observed when visiting a specific site.
+             */
+            sites: (site: string, params?: JavaScriptSitesParams) => Promise<JavaScriptSymbolCollectionResponse>;
+        };
     };
 }
 
-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, 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;
@@ -281,6 +287,53 @@ interface MetadataSearchParams extends PaginationParams {
     search?: string;
     sort?: "popularity" | "name";
 }
+type JavaScriptSymbolCategory = "canvas" | "audio" | "webrtc" | "navigator" | "screen" | "storage" | "cookie" | "referrer";
+interface JavaScriptSymbolCatalogItem {
+    symbol: string;
+    category: JavaScriptSymbolCategory;
+    description: string;
+}
+interface JavaScriptSymbolCatalogData {
+    type: "javascript_symbol_catalog";
+    total_symbols: number;
+    categories: string[];
+    note: string;
+    symbols: JavaScriptSymbolCatalogItem[];
+}
+interface JavaScriptSymbolObservation {
+    id: string;
+    script_etld1: string;
+    site_etld1: string;
+    script_url: string;
+    symbol: string;
+    symbol_category: string;
+    operation: string | null;
+    arguments: string | null;
+    value: string | null;
+    timestamp: string;
+}
+interface JavaScriptSymbolCollectionData {
+    type: "javascript_symbol_collection";
+    summary: {
+        returned: number;
+    };
+    symbols: JavaScriptSymbolObservation[];
+}
+interface JavaScriptCatalogParams {
+    category?: JavaScriptSymbolCategory;
+}
+interface JavaScriptSymbolParams extends PaginationParams {
+}
+interface JavaScriptScriptsParams extends PaginationParams {
+    symbol?: string;
+    category?: JavaScriptSymbolCategory;
+}
+interface JavaScriptSitesParams extends PaginationParams {
+    symbol?: string;
+    category?: JavaScriptSymbolCategory;
+}
+type JavaScriptCatalogResponse = APIResponse<JavaScriptSymbolCatalogData>;
+type JavaScriptSymbolCollectionResponse = APIResponse<JavaScriptSymbolCollectionData>;
 type FileSearchResponse = APIResponse<FileSearchData>;
 type FileHashResponse = APIResponse<FileHashData>;
 type AppSearchResponse = APIResponse<AppSearchData>;
@@ -324,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)
@@ -401,7 +459,29 @@ declare class LightboxClient {
              */
             cookies: (domain: string, params?: WebDomainCookiesParams) => Promise<WebCookieCollectionResponse>;
         };
+        /**
+         * JavaScript API symbol tracking methods
+         */
+        javascript: {
+            /**
+             * Get the catalog of all JavaScript symbols available for querying.
+             * This is a static list of browser APIs monitored during web crawls.
+             */
+            catalog: (params?: JavaScriptCatalogParams) => Promise<JavaScriptCatalogResponse>;
+            /**
+             * Get all scripts that access a specific JavaScript API symbol.
+             */
+            symbols: (symbol: string, params?: JavaScriptSymbolParams) => Promise<JavaScriptSymbolCollectionResponse>;
+            /**
+             * Get JavaScript API accesses by scripts from a specific domain.
+             */
+            scripts: (domain: string, params?: JavaScriptScriptsParams) => Promise<JavaScriptSymbolCollectionResponse>;
+            /**
+             * Get JavaScript API accesses observed when visiting a specific site.
+             */
+            sites: (site: string, params?: JavaScriptSitesParams) => Promise<JavaScriptSymbolCollectionResponse>;
+        };
     };
 }
 
-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, 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");
     }
   };
   /**
@@ -189,6 +220,48 @@ var LightboxClient = class {
           params
         );
       }
+    },
+    /**
+     * JavaScript API symbol tracking methods
+     */
+    javascript: {
+      /**
+       * Get the catalog of all JavaScript symbols available for querying.
+       * This is a static list of browser APIs monitored during web crawls.
+       */
+      catalog: (params) => {
+        return this.request(
+          "/v1/web/javascript/symbols",
+          params
+        );
+      },
+      /**
+       * Get all scripts that access a specific JavaScript API symbol.
+       */
+      symbols: (symbol, params) => {
+        return this.request(
+          `/v1/web/javascript/symbols/${encodeURIComponent(symbol)}`,
+          params
+        );
+      },
+      /**
+       * Get JavaScript API accesses by scripts from a specific domain.
+       */
+      scripts: (domain, params) => {
+        return this.request(
+          `/v1/web/javascript/scripts/${encodeURIComponent(domain)}`,
+          params
+        );
+      },
+      /**
+       * Get JavaScript API accesses observed when visiting a specific site.
+       */
+      sites: (site, params) => {
+        return this.request(
+          `/v1/web/javascript/sites/${encodeURIComponent(site)}`,
+          params
+        );
+      }
     }
   };
 };

package/package.json

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