@disconnectme/lightbox-sdk 0.1.2 → 0.1.3

package/dist/index.cjs

@@ -216,6 +216,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

@@ -281,6 +281,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>;
@@ -401,7 +448,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 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

@@ -281,6 +281,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>;
@@ -401,7 +448,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 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

@@ -189,6 +189,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.3",
   "description": "TypeScript SDK for the Lightbox Data API by Disconnect",
   "type": "module",
   "engines": {