context.dev 0.1.0 → 0.3.0

package/resources/style.d.ts

@@ -0,0 +1,386 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Style extends APIResource {
+    /**
+     * Extract font information from a brand's website including font families, usage
+     * statistics, fallbacks, and element/word counts.
+     */
+    extractFonts(query: StyleExtractFontsParams, options?: RequestOptions): APIPromise<StyleExtractFontsResponse>;
+    /**
+     * Automatically extract comprehensive design system information from a brand's
+     * website including colors, typography, spacing, shadows, and UI components.
+     * Either 'domain' or 'directUrl' must be provided as a query parameter, but not
+     * both.
+     */
+    extractStyleguide(query?: StyleExtractStyleguideParams | null | undefined, options?: RequestOptions): APIPromise<StyleExtractStyleguideResponse>;
+}
+export interface StyleExtractFontsResponse {
+    /**
+     * HTTP status code, e.g., 200
+     */
+    code: number;
+    /**
+     * The normalized domain that was processed
+     */
+    domain: string;
+    /**
+     * Array of font usage information
+     */
+    fonts: Array<StyleExtractFontsResponse.Font>;
+    /**
+     * Status of the response, e.g., 'ok'
+     */
+    status: string;
+}
+export declare namespace StyleExtractFontsResponse {
+    interface Font {
+        /**
+         * Array of fallback font families
+         */
+        fallbacks: Array<string>;
+        /**
+         * Font family name
+         */
+        font: string;
+        /**
+         * Number of elements using this font
+         */
+        num_elements: number;
+        /**
+         * Number of words using this font
+         */
+        num_words: number;
+        /**
+         * Percentage of elements using this font
+         */
+        percent_elements: number;
+        /**
+         * Percentage of words using this font
+         */
+        percent_words: number;
+        /**
+         * Array of CSS selectors or element types where this font is used
+         */
+        uses: Array<string>;
+    }
+}
+export interface StyleExtractStyleguideResponse {
+    /**
+     * HTTP status code
+     */
+    code?: number;
+    /**
+     * The normalized domain that was processed
+     */
+    domain?: string;
+    /**
+     * Status of the response, e.g., 'ok'
+     */
+    status?: string;
+    /**
+     * Comprehensive styleguide data extracted from the website
+     */
+    styleguide?: StyleExtractStyleguideResponse.Styleguide;
+}
+export declare namespace StyleExtractStyleguideResponse {
+    /**
+     * Comprehensive styleguide data extracted from the website
+     */
+    interface Styleguide {
+        /**
+         * Primary colors used on the website
+         */
+        colors?: Styleguide.Colors;
+        /**
+         * UI component styles
+         */
+        components?: Styleguide.Components;
+        /**
+         * Spacing system used on the website
+         */
+        elementSpacing?: Styleguide.ElementSpacing;
+        /**
+         * The primary color mode of the website design
+         */
+        mode?: 'light' | 'dark';
+        /**
+         * Shadow styles used on the website
+         */
+        shadows?: Styleguide.Shadows;
+        /**
+         * Typography styles used on the website
+         */
+        typography?: Styleguide.Typography;
+    }
+    namespace Styleguide {
+        /**
+         * Primary colors used on the website
+         */
+        interface Colors {
+            /**
+             * Accent color of the website (hex format)
+             */
+            accent?: string;
+            /**
+             * Background color of the website (hex format)
+             */
+            background?: string;
+            /**
+             * Text color of the website (hex format)
+             */
+            text?: string;
+        }
+        /**
+         * UI component styles
+         */
+        interface Components {
+            /**
+             * Button component styles
+             */
+            button?: Components.Button;
+            /**
+             * Card component style
+             */
+            card?: Components.Card;
+        }
+        namespace Components {
+            /**
+             * Button component styles
+             */
+            interface Button {
+                /**
+                 * Link button style
+                 */
+                link?: Button.Link;
+                /**
+                 * Primary button style
+                 */
+                primary?: Button.Primary;
+                /**
+                 * Secondary button style
+                 */
+                secondary?: Button.Secondary;
+            }
+            namespace Button {
+                /**
+                 * Link button style
+                 */
+                interface Link {
+                    backgroundColor?: string;
+                    borderColor?: string;
+                    borderRadius?: string;
+                    borderStyle?: string;
+                    borderWidth?: string;
+                    boxShadow?: string;
+                    color?: string;
+                    fontSize?: string;
+                    fontWeight?: number;
+                    padding?: string;
+                    textDecoration?: string;
+                }
+                /**
+                 * Primary button style
+                 */
+                interface Primary {
+                    backgroundColor?: string;
+                    borderColor?: string;
+                    borderRadius?: string;
+                    borderStyle?: string;
+                    borderWidth?: string;
+                    boxShadow?: string;
+                    color?: string;
+                    fontSize?: string;
+                    fontWeight?: number;
+                    padding?: string;
+                    textDecoration?: string;
+                }
+                /**
+                 * Secondary button style
+                 */
+                interface Secondary {
+                    backgroundColor?: string;
+                    borderColor?: string;
+                    borderRadius?: string;
+                    borderStyle?: string;
+                    borderWidth?: string;
+                    boxShadow?: string;
+                    color?: string;
+                    fontSize?: string;
+                    fontWeight?: number;
+                    padding?: string;
+                    textDecoration?: string;
+                }
+            }
+            /**
+             * Card component style
+             */
+            interface Card {
+                backgroundColor?: string;
+                borderColor?: string;
+                borderRadius?: string;
+                borderStyle?: string;
+                borderWidth?: string;
+                boxShadow?: string;
+                padding?: string;
+                textColor?: string;
+            }
+        }
+        /**
+         * Spacing system used on the website
+         */
+        interface ElementSpacing {
+            /**
+             * Large spacing value
+             */
+            lg?: string;
+            /**
+             * Medium spacing value
+             */
+            md?: string;
+            /**
+             * Small spacing value
+             */
+            sm?: string;
+            /**
+             * Extra large spacing value
+             */
+            xl?: string;
+            /**
+             * Extra small spacing value
+             */
+            xs?: string;
+        }
+        /**
+         * Shadow styles used on the website
+         */
+        interface Shadows {
+            /**
+             * Inner shadow value
+             */
+            inner?: string;
+            /**
+             * Large shadow value
+             */
+            lg?: string;
+            /**
+             * Medium shadow value
+             */
+            md?: string;
+            /**
+             * Small shadow value
+             */
+            sm?: string;
+            /**
+             * Extra large shadow value
+             */
+            xl?: string;
+        }
+        /**
+         * Typography styles used on the website
+         */
+        interface Typography {
+            /**
+             * Heading styles
+             */
+            headings?: Typography.Headings;
+            /**
+             * Paragraph text styles
+             */
+            p?: Typography.P;
+        }
+        namespace Typography {
+            /**
+             * Heading styles
+             */
+            interface Headings {
+                h1?: Headings.H1;
+                h2?: Headings.H2;
+                h3?: Headings.H3;
+                h4?: Headings.H4;
+            }
+            namespace Headings {
+                interface H1 {
+                    fontFamily?: string;
+                    fontSize?: string;
+                    fontWeight?: number;
+                    letterSpacing?: string;
+                    lineHeight?: string;
+                }
+                interface H2 {
+                    fontFamily?: string;
+                    fontSize?: string;
+                    fontWeight?: number;
+                    letterSpacing?: string;
+                    lineHeight?: string;
+                }
+                interface H3 {
+                    fontFamily?: string;
+                    fontSize?: string;
+                    fontWeight?: number;
+                    letterSpacing?: string;
+                    lineHeight?: string;
+                }
+                interface H4 {
+                    fontFamily?: string;
+                    fontSize?: string;
+                    fontWeight?: number;
+                    letterSpacing?: string;
+                    lineHeight?: string;
+                }
+            }
+            /**
+             * Paragraph text styles
+             */
+            interface P {
+                fontFamily?: string;
+                fontSize?: string;
+                fontWeight?: number;
+                letterSpacing?: string;
+                lineHeight?: string;
+            }
+        }
+    }
+}
+export interface StyleExtractFontsParams {
+    /**
+     * Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The
+     * domain will be automatically normalized and validated.
+     */
+    domain: string;
+    /**
+     * Optional timeout in milliseconds for the request. If the request takes longer
+     * than this value, it will be aborted with a 408 status code. Maximum allowed
+     * value is 300000ms (5 minutes).
+     */
+    timeoutMS?: number;
+}
+export interface StyleExtractStyleguideParams {
+    /**
+     * A specific URL to fetch the styleguide from directly, bypassing domain
+     * resolution (e.g., 'https://example.com/design-system').
+     */
+    directUrl?: string;
+    /**
+     * Domain name to extract styleguide from (e.g., 'example.com', 'google.com'). The
+     * domain will be automatically normalized and validated.
+     */
+    domain?: string;
+    /**
+     * Optional parameter to prioritize screenshot capture for styleguide extraction.
+     * If 'speed', optimizes for faster capture with basic quality. If 'quality',
+     * optimizes for higher quality with longer wait times. Defaults to 'quality' if
+     * not provided.
+     */
+    prioritize?: 'speed' | 'quality';
+    /**
+     * Optional timeout in milliseconds for the request. If the request takes longer
+     * than this value, it will be aborted with a 408 status code. Maximum allowed
+     * value is 300000ms (5 minutes).
+     */
+    timeoutMS?: number;
+}
+export declare namespace Style {
+    export { type StyleExtractFontsResponse as StyleExtractFontsResponse, type StyleExtractStyleguideResponse as StyleExtractStyleguideResponse, type StyleExtractFontsParams as StyleExtractFontsParams, type StyleExtractStyleguideParams as StyleExtractStyleguideParams, };
+}
+//# sourceMappingURL=style.d.ts.map

package/resources/style.d.ts.map

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

package/resources/style.js

@@ -0,0 +1,25 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Style = void 0;
+const resource_1 = require("../core/resource.js");
+class Style extends resource_1.APIResource {
+    /**
+     * Extract font information from a brand's website including font families, usage
+     * statistics, fallbacks, and element/word counts.
+     */
+    extractFonts(query, options) {
+        return this._client.get('/brand/fonts', { query, ...options });
+    }
+    /**
+     * Automatically extract comprehensive design system information from a brand's
+     * website including colors, typography, spacing, shadows, and UI components.
+     * Either 'domain' or 'directUrl' must be provided as a query parameter, but not
+     * both.
+     */
+    extractStyleguide(query = {}, options) {
+        return this._client.get('/brand/styleguide', { query, ...options });
+    }
+}
+exports.Style = Style;
+//# sourceMappingURL=style.js.map

package/resources/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../src/resources/style.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;OAGG;IACH,YAAY,CACV,KAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CACf,QAAyD,EAAE,EAC3D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;CACF;AAxBD,sBAwBC"}

package/resources/style.mjs

@@ -0,0 +1,21 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+export class Style extends APIResource {
+    /**
+     * Extract font information from a brand's website including font families, usage
+     * statistics, fallbacks, and element/word counts.
+     */
+    extractFonts(query, options) {
+        return this._client.get('/brand/fonts', { query, ...options });
+    }
+    /**
+     * Automatically extract comprehensive design system information from a brand's
+     * website including colors, typography, spacing, shadows, and UI components.
+     * Either 'domain' or 'directUrl' must be provided as a query parameter, but not
+     * both.
+     */
+    extractStyleguide(query = {}, options) {
+        return this._client.get('/brand/styleguide', { query, ...options });
+    }
+}
+//# sourceMappingURL=style.mjs.map

package/resources/style.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.mjs","sourceRoot":"","sources":["../src/resources/style.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;OAGG;IACH,YAAY,CACV,KAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CACf,QAAyD,EAAE,EAC3D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;CACF"}

package/resources/utility.d.mts

@@ -0,0 +1,79 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare class Utility extends APIResource {
+    /**
+     * Signal that you may fetch brand data for a particular domain soon to improve
+     * latency. This endpoint does not charge credits and is available for paid
+     * customers to optimize future requests. [You must be on a paid plan to use this
+     * endpoint]
+     */
+    prefetch(body: UtilityPrefetchParams, options?: RequestOptions): APIPromise<UtilityPrefetchResponse>;
+    /**
+     * Signal that you may fetch brand data for a particular domain soon to improve
+     * latency. This endpoint accepts an email address, extracts the domain from it,
+     * validates that it's not a disposable or free email provider, and queues the
+     * domain for prefetching. This endpoint does not charge credits and is available
+     * for paid customers to optimize future requests. [You must be on a paid plan to
+     * use this endpoint]
+     */
+    prefetchByEmail(body: UtilityPrefetchByEmailParams, options?: RequestOptions): APIPromise<UtilityPrefetchByEmailResponse>;
+}
+export interface UtilityPrefetchResponse {
+    /**
+     * The domain that was queued for prefetching
+     */
+    domain?: string;
+    /**
+     * Success message
+     */
+    message?: string;
+    /**
+     * Status of the response, e.g., 'ok'
+     */
+    status?: string;
+}
+export interface UtilityPrefetchByEmailResponse {
+    /**
+     * The domain that was queued for prefetching
+     */
+    domain?: string;
+    /**
+     * Success message
+     */
+    message?: string;
+    /**
+     * Status of the response, e.g., 'ok'
+     */
+    status?: string;
+}
+export interface UtilityPrefetchParams {
+    /**
+     * Domain name to prefetch brand data for
+     */
+    domain: string;
+    /**
+     * Optional timeout in milliseconds for the request. If the request takes longer
+     * than this value, it will be aborted with a 408 status code. Maximum allowed
+     * value is 300000ms (5 minutes).
+     */
+    timeoutMS?: number;
+}
+export interface UtilityPrefetchByEmailParams {
+    /**
+     * Email address to prefetch brand data for. The domain will be extracted from the
+     * email. Free email providers (gmail.com, yahoo.com, etc.) and disposable email
+     * addresses are not allowed.
+     */
+    email: string;
+    /**
+     * Optional timeout in milliseconds for the request. If the request takes longer
+     * than this value, it will be aborted with a 408 status code. Maximum allowed
+     * value is 300000ms (5 minutes).
+     */
+    timeoutMS?: number;
+}
+export declare namespace Utility {
+    export { type UtilityPrefetchResponse as UtilityPrefetchResponse, type UtilityPrefetchByEmailResponse as UtilityPrefetchByEmailResponse, type UtilityPrefetchParams as UtilityPrefetchParams, type UtilityPrefetchByEmailParams as UtilityPrefetchByEmailParams, };
+}
+//# sourceMappingURL=utility.d.mts.map

package/resources/utility.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.d.mts","sourceRoot":"","sources":["../src/resources/utility.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,uBAAuB,CAAC;IAIpG;;;;;;;OAOG;IACH,eAAe,CACb,IAAI,EAAE,4BAA4B,EAClC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;CAG9C;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,4BAA4B,IAAI,4BAA4B,GAClE,CAAC;CACH"}

package/resources/utility.d.ts

@@ -0,0 +1,79 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Utility extends APIResource {
+    /**
+     * Signal that you may fetch brand data for a particular domain soon to improve
+     * latency. This endpoint does not charge credits and is available for paid
+     * customers to optimize future requests. [You must be on a paid plan to use this
+     * endpoint]
+     */
+    prefetch(body: UtilityPrefetchParams, options?: RequestOptions): APIPromise<UtilityPrefetchResponse>;
+    /**
+     * Signal that you may fetch brand data for a particular domain soon to improve
+     * latency. This endpoint accepts an email address, extracts the domain from it,
+     * validates that it's not a disposable or free email provider, and queues the
+     * domain for prefetching. This endpoint does not charge credits and is available
+     * for paid customers to optimize future requests. [You must be on a paid plan to
+     * use this endpoint]
+     */
+    prefetchByEmail(body: UtilityPrefetchByEmailParams, options?: RequestOptions): APIPromise<UtilityPrefetchByEmailResponse>;
+}
+export interface UtilityPrefetchResponse {
+    /**
+     * The domain that was queued for prefetching
+     */
+    domain?: string;
+    /**
+     * Success message
+     */
+    message?: string;
+    /**
+     * Status of the response, e.g., 'ok'
+     */
+    status?: string;
+}
+export interface UtilityPrefetchByEmailResponse {
+    /**
+     * The domain that was queued for prefetching
+     */
+    domain?: string;
+    /**
+     * Success message
+     */
+    message?: string;
+    /**
+     * Status of the response, e.g., 'ok'
+     */
+    status?: string;
+}
+export interface UtilityPrefetchParams {
+    /**
+     * Domain name to prefetch brand data for
+     */
+    domain: string;
+    /**
+     * Optional timeout in milliseconds for the request. If the request takes longer
+     * than this value, it will be aborted with a 408 status code. Maximum allowed
+     * value is 300000ms (5 minutes).
+     */
+    timeoutMS?: number;
+}
+export interface UtilityPrefetchByEmailParams {
+    /**
+     * Email address to prefetch brand data for. The domain will be extracted from the
+     * email. Free email providers (gmail.com, yahoo.com, etc.) and disposable email
+     * addresses are not allowed.
+     */
+    email: string;
+    /**
+     * Optional timeout in milliseconds for the request. If the request takes longer
+     * than this value, it will be aborted with a 408 status code. Maximum allowed
+     * value is 300000ms (5 minutes).
+     */
+    timeoutMS?: number;
+}
+export declare namespace Utility {
+    export { type UtilityPrefetchResponse as UtilityPrefetchResponse, type UtilityPrefetchByEmailResponse as UtilityPrefetchByEmailResponse, type UtilityPrefetchParams as UtilityPrefetchParams, type UtilityPrefetchByEmailParams as UtilityPrefetchByEmailParams, };
+}
+//# sourceMappingURL=utility.d.ts.map

package/resources/utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../src/resources/utility.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,uBAAuB,CAAC;IAIpG;;;;;;;OAOG;IACH,eAAe,CACb,IAAI,EAAE,4BAA4B,EAClC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;CAG9C;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,4BAA4B,IAAI,4BAA4B,GAClE,CAAC;CACH"}

package/resources/utility.js

@@ -0,0 +1,29 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Utility = void 0;
+const resource_1 = require("../core/resource.js");
+class Utility extends resource_1.APIResource {
+    /**
+     * Signal that you may fetch brand data for a particular domain soon to improve
+     * latency. This endpoint does not charge credits and is available for paid
+     * customers to optimize future requests. [You must be on a paid plan to use this
+     * endpoint]
+     */
+    prefetch(body, options) {
+        return this._client.post('/brand/prefetch', { body, ...options });
+    }
+    /**
+     * Signal that you may fetch brand data for a particular domain soon to improve
+     * latency. This endpoint accepts an email address, extracts the domain from it,
+     * validates that it's not a disposable or free email provider, and queues the
+     * domain for prefetching. This endpoint does not charge credits and is available
+     * for paid customers to optimize future requests. [You must be on a paid plan to
+     * use this endpoint]
+     */
+    prefetchByEmail(body, options) {
+        return this._client.post('/brand/prefetch-by-email', { body, ...options });
+    }
+}
+exports.Utility = Utility;
+//# sourceMappingURL=utility.js.map

package/resources/utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.js","sourceRoot":"","sources":["../src/resources/utility.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,IAA2B,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;OAOG;IACH,eAAe,CACb,IAAkC,EAClC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;CACF;AAzBD,0BAyBC"}

package/resources/utility.mjs

@@ -0,0 +1,25 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+export class Utility extends APIResource {
+    /**
+     * Signal that you may fetch brand data for a particular domain soon to improve
+     * latency. This endpoint does not charge credits and is available for paid
+     * customers to optimize future requests. [You must be on a paid plan to use this
+     * endpoint]
+     */
+    prefetch(body, options) {
+        return this._client.post('/brand/prefetch', { body, ...options });
+    }
+    /**
+     * Signal that you may fetch brand data for a particular domain soon to improve
+     * latency. This endpoint accepts an email address, extracts the domain from it,
+     * validates that it's not a disposable or free email provider, and queues the
+     * domain for prefetching. This endpoint does not charge credits and is available
+     * for paid customers to optimize future requests. [You must be on a paid plan to
+     * use this endpoint]
+     */
+    prefetchByEmail(body, options) {
+        return this._client.post('/brand/prefetch-by-email', { body, ...options });
+    }
+}
+//# sourceMappingURL=utility.mjs.map