@markupai/api 0.2.0 → 1.0.0

package/dist/cjs/Client.js

@@ -48,8 +48,8 @@ class MarkupAIClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@markupai/api",
-                "X-Fern-SDK-Version": "0.2.0",
-                "User-Agent": "@markupai/api/0.2.0",
+                "X-Fern-SDK-Version": "1.0.0",
+                "User-Agent": "@markupai/api/1.0.0",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/cjs/api/errors/TooManyRequestsError.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as errors from "../../errors/index.js";
+import * as MarkupAI from "../index.js";
+import * as core from "../../core/index.js";
+export declare class TooManyRequestsError extends errors.MarkupAIError {
+    constructor(body: MarkupAI.ErrorResponse, rawResponse?: core.RawResponse);
+}

package/dist/cjs/api/errors/TooManyRequestsError.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TooManyRequestsError = void 0;
+const errors = __importStar(require("../../errors/index.js"));
+class TooManyRequestsError extends errors.MarkupAIError {
+    constructor(body, rawResponse) {
+        super({
+            message: "TooManyRequestsError",
+            statusCode: 429,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, TooManyRequestsError.prototype);
+    }
+}
+exports.TooManyRequestsError = TooManyRequestsError;

package/dist/cjs/api/errors/index.d.ts

@@ -4,3 +4,4 @@ export * from "./UnprocessableEntityError.js";
 export * from "./InternalServerError.js";
 export * from "./ContentTooLargeError.js";
 export * from "./NotFoundError.js";
+export * from "./TooManyRequestsError.js";

package/dist/cjs/api/errors/index.js

@@ -20,3 +20,4 @@ __exportStar(require("./UnprocessableEntityError.js"), exports);
 __exportStar(require("./InternalServerError.js"), exports);
 __exportStar(require("./ContentTooLargeError.js"), exports);
 __exportStar(require("./NotFoundError.js"), exports);
+__exportStar(require("./TooManyRequestsError.js"), exports);

package/dist/cjs/api/resources/styleChecks/client/Client.d.ts

@@ -43,6 +43,7 @@ export declare class StyleChecks {
      * @throws {@link MarkupAI.ForbiddenError}
      * @throws {@link MarkupAI.ContentTooLargeError}
      * @throws {@link MarkupAI.UnprocessableEntityError}
+     * @throws {@link MarkupAI.TooManyRequestsError}
      * @throws {@link MarkupAI.InternalServerError}
      *
      * @example

package/dist/cjs/api/resources/styleChecks/client/Client.js

@@ -68,6 +68,7 @@ class StyleChecks {
      * @throws {@link MarkupAI.ForbiddenError}
      * @throws {@link MarkupAI.ContentTooLargeError}
      * @throws {@link MarkupAI.UnprocessableEntityError}
+     * @throws {@link MarkupAI.TooManyRequestsError}
      * @throws {@link MarkupAI.InternalServerError}
      *
      * @example
@@ -121,6 +122,8 @@ class StyleChecks {
                         throw new MarkupAI.ContentTooLargeError(_response.error.body, _response.rawResponse);
                     case 422:
                         throw new MarkupAI.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new MarkupAI.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new MarkupAI.InternalServerError(_response.error.body, _response.rawResponse);
                     default:

package/dist/cjs/api/resources/styleRewrites/client/Client.d.ts

@@ -43,6 +43,7 @@ export declare class StyleRewrites {
      * @throws {@link MarkupAI.ForbiddenError}
      * @throws {@link MarkupAI.ContentTooLargeError}
      * @throws {@link MarkupAI.UnprocessableEntityError}
+     * @throws {@link MarkupAI.TooManyRequestsError}
      * @throws {@link MarkupAI.InternalServerError}
      *
      * @example

package/dist/cjs/api/resources/styleRewrites/client/Client.js

@@ -68,6 +68,7 @@ class StyleRewrites {
      * @throws {@link MarkupAI.ForbiddenError}
      * @throws {@link MarkupAI.ContentTooLargeError}
      * @throws {@link MarkupAI.UnprocessableEntityError}
+     * @throws {@link MarkupAI.TooManyRequestsError}
      * @throws {@link MarkupAI.InternalServerError}
      *
      * @example
@@ -121,6 +122,8 @@ class StyleRewrites {
                         throw new MarkupAI.ContentTooLargeError(_response.error.body, _response.rawResponse);
                     case 422:
                         throw new MarkupAI.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new MarkupAI.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new MarkupAI.InternalServerError(_response.error.body, _response.rawResponse);
                     default:

package/dist/cjs/api/resources/styleSuggestions/client/Client.d.ts

@@ -43,6 +43,7 @@ export declare class StyleSuggestions {
      * @throws {@link MarkupAI.ForbiddenError}
      * @throws {@link MarkupAI.ContentTooLargeError}
      * @throws {@link MarkupAI.UnprocessableEntityError}
+     * @throws {@link MarkupAI.TooManyRequestsError}
      * @throws {@link MarkupAI.InternalServerError}
      *
      * @example

package/dist/cjs/api/resources/styleSuggestions/client/Client.js

@@ -68,6 +68,7 @@ class StyleSuggestions {
      * @throws {@link MarkupAI.ForbiddenError}
      * @throws {@link MarkupAI.ContentTooLargeError}
      * @throws {@link MarkupAI.UnprocessableEntityError}
+     * @throws {@link MarkupAI.TooManyRequestsError}
      * @throws {@link MarkupAI.InternalServerError}
      *
      * @example
@@ -121,6 +122,8 @@ class StyleSuggestions {
                         throw new MarkupAI.ContentTooLargeError(_response.error.body, _response.rawResponse);
                     case 422:
                         throw new MarkupAI.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new MarkupAI.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new MarkupAI.InternalServerError(_response.error.body, _response.rawResponse);
                     default:

package/dist/cjs/api/types/StyleGuideResponse.d.ts

@@ -16,6 +16,6 @@ export interface StyleGuideResponse {
     updated_at?: string;
     /** The ID of the user who last updated the style guide. If null, the style guide has never been updated. */
     updated_by?: string;
-    /** The prompt used to apply a style guide to a document. This should not be displayed to the user. */
-    prompt: string;
+    /** User-friendly summary of the style guide's contents and characteristics */
+    summary?: string;
 }

package/dist/cjs/api/types/StyleGuides.d.ts

@@ -1,11 +1,10 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export type StyleGuides = "ap" | "chicago" | "microsoft" | "demo" | "style_brand_importer";
+export type StyleGuides = "ap" | "chicago" | "microsoft" | "style_brand_importer";
 export declare const StyleGuides: {
     readonly Ap: "ap";
     readonly Chicago: "chicago";
     readonly Microsoft: "microsoft";
-    readonly Demo: "demo";
     readonly StyleBrandImporter: "style_brand_importer";
 };

package/dist/cjs/api/types/StyleGuides.js

@@ -8,6 +8,5 @@ exports.StyleGuides = {
     Ap: "ap",
     Chicago: "chicago",
     Microsoft: "microsoft",
-    Demo: "demo",
     StyleBrandImporter: "style_brand_importer",
 };

package/dist/cjs/core/auth/index.d.ts

@@ -1,4 +1,4 @@
-export { AuthProvider } from "./AuthProvider.js";
-export { type AuthRequest } from "./AuthRequest.js";
+export type { AuthProvider } from "./AuthProvider.js";
+export type { AuthRequest } from "./AuthRequest.js";
 export { BasicAuth } from "./BasicAuth.js";
 export { BearerToken } from "./BearerToken.js";

package/dist/cjs/core/fetcher/EndpointMetadata.d.ts

@@ -0,0 +1,13 @@
+export type SecuritySchemeKey = string;
+/**
+ * A collection of security schemes, where the key is the name of the security scheme and the value is the list of scopes required for that scheme.
+ * All schemes in the collection must be satisfied for authentication to be successful.
+ */
+export type SecuritySchemeCollection = Record<SecuritySchemeKey, AuthScope[]>;
+export type AuthScope = string;
+export type EndpointMetadata = {
+    /**
+     * An array of security scheme collections. Each collection represents an alternative way to authenticate.
+     */
+    security?: SecuritySchemeCollection[];
+};

package/dist/cjs/core/fetcher/EndpointMetadata.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/core/fetcher/EndpointSupplier.d.ts

@@ -0,0 +1,12 @@
+import { EndpointMetadata } from "./EndpointMetadata.js";
+import { Supplier } from "./Supplier.js";
+type EndpointSupplierFn<T> = (arg: {
+    endpointMetadata: EndpointMetadata;
+}) => T | Promise<T>;
+export type EndpointSupplier<T> = Supplier<T> | EndpointSupplierFn<T>;
+export declare const EndpointSupplier: {
+    get: <T>(supplier: EndpointSupplier<T>, arg: {
+        endpointMetadata: EndpointMetadata;
+    }) => Promise<T>;
+};
+export {};

package/dist/cjs/core/fetcher/EndpointSupplier.js

@@ -0,0 +1,22 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EndpointSupplier = void 0;
+exports.EndpointSupplier = {
+    get: (supplier, arg) => __awaiter(void 0, void 0, void 0, function* () {
+        if (typeof supplier === "function") {
+            return supplier(arg);
+        }
+        else {
+            return supplier;
+        }
+    }),
+};

package/dist/cjs/core/fetcher/Fetcher.d.ts

@@ -1,12 +1,13 @@
 import { APIResponse } from "./APIResponse.js";
-import { Supplier } from "./Supplier.js";
+import { EndpointMetadata } from "./EndpointMetadata.js";
+import { EndpointSupplier } from "./EndpointSupplier.js";
 export type FetchFunction = <R = unknown>(args: Fetcher.Args) => Promise<APIResponse<R, Fetcher.Error>>;
 export declare namespace Fetcher {
     interface Args {
         url: string;
         method: string;
         contentType?: string;
-        headers?: Record<string, string | Supplier<string | null | undefined> | null | undefined>;
+        headers?: Record<string, string | EndpointSupplier<string | null | undefined> | null | undefined>;
         queryParameters?: Record<string, unknown>;
         body?: unknown;
         timeoutMs?: number;
@@ -16,6 +17,7 @@ export declare namespace Fetcher {
         requestType?: "json" | "file" | "bytes";
         responseType?: "json" | "blob" | "sse" | "streaming" | "text" | "arrayBuffer" | "binary-response";
         duplex?: "half";
+        endpointMetadata?: EndpointMetadata;
     }
     type Error = FailedStatusCodeError | NonJsonError | TimeoutError | UnknownError;
     interface FailedStatusCodeError {

package/dist/cjs/core/fetcher/Fetcher.js

@@ -13,6 +13,7 @@ exports.fetcher = void 0;
 exports.fetcherImpl = fetcherImpl;
 const json_js_1 = require("../json.js");
 const createRequestUrl_js_1 = require("./createRequestUrl.js");
+const EndpointSupplier_js_1 = require("./EndpointSupplier.js");
 const getErrorResponseBody_js_1 = require("./getErrorResponseBody.js");
 const getFetchFn_js_1 = require("./getFetchFn.js");
 const getRequestBody_js_1 = require("./getRequestBody.js");
@@ -20,9 +21,9 @@ const getResponseBody_js_1 = require("./getResponseBody.js");
 const makeRequest_js_1 = require("./makeRequest.js");
 const RawResponse_js_1 = require("./RawResponse.js");
 const requestWithRetries_js_1 = require("./requestWithRetries.js");
-const Supplier_js_1 = require("./Supplier.js");
 function getHeaders(args) {
     return __awaiter(this, void 0, void 0, function* () {
+        var _a;
         const newHeaders = {};
         if (args.body !== undefined && args.contentType != null) {
             newHeaders["Content-Type"] = args.contentType;
@@ -31,7 +32,7 @@ function getHeaders(args) {
             return newHeaders;
         }
         for (const [key, value] of Object.entries(args.headers)) {
-            const result = yield Supplier_js_1.Supplier.get(value);
+            const result = yield EndpointSupplier_js_1.EndpointSupplier.get(value, { endpointMetadata: (_a = args.endpointMetadata) !== null && _a !== void 0 ? _a : {} });
             if (typeof result === "string") {
                 newHeaders[key] = result;
                 continue;

package/dist/cjs/core/fetcher/index.d.ts

@@ -1,5 +1,7 @@
 export type { APIResponse } from "./APIResponse.js";
 export type { BinaryResponse } from "./BinaryResponse.js";
+export type { EndpointMetadata } from "./EndpointMetadata.js";
+export { EndpointSupplier } from "./EndpointSupplier.js";
 export type { Fetcher, FetchFunction } from "./Fetcher.js";
 export { fetcher } from "./Fetcher.js";
 export { getHeader } from "./getHeader.js";

package/dist/cjs/core/fetcher/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Supplier = exports.unknownRawResponse = exports.toRawResponse = exports.abortRawResponse = exports.HttpResponsePromise = exports.getHeader = exports.fetcher = void 0;
+exports.Supplier = exports.unknownRawResponse = exports.toRawResponse = exports.abortRawResponse = exports.HttpResponsePromise = exports.getHeader = exports.fetcher = exports.EndpointSupplier = void 0;
+var EndpointSupplier_js_1 = require("./EndpointSupplier.js");
+Object.defineProperty(exports, "EndpointSupplier", { enumerable: true, get: function () { return EndpointSupplier_js_1.EndpointSupplier; } });
 var Fetcher_js_1 = require("./Fetcher.js");
 Object.defineProperty(exports, "fetcher", { enumerable: true, get: function () { return Fetcher_js_1.fetcher; } });
 var getHeader_js_1 = require("./getHeader.js");

package/dist/cjs/core/fetcher/requestWithRetries.js

@@ -14,21 +14,57 @@ const INITIAL_RETRY_DELAY = 1000; // in milliseconds
 const MAX_RETRY_DELAY = 60000; // in milliseconds
 const DEFAULT_MAX_RETRIES = 2;
 const JITTER_FACTOR = 0.2; // 20% random jitter
-function addJitter(delay) {
-    // Generate a random value between -JITTER_FACTOR and +JITTER_FACTOR
-    const jitterMultiplier = 1 + (Math.random() * 2 - 1) * JITTER_FACTOR;
+function addPositiveJitter(delay) {
+    // Generate a random value between 0 and +JITTER_FACTOR
+    const jitterMultiplier = 1 + Math.random() * JITTER_FACTOR;
     return delay * jitterMultiplier;
 }
+function addSymmetricJitter(delay) {
+    // Generate a random value in a JITTER_FACTOR-sized percentage range around delay
+    const jitterMultiplier = 1 + (Math.random() - 0.5) * JITTER_FACTOR;
+    return delay * jitterMultiplier;
+}
+function getRetryDelayFromHeaders(response, retryAttempt) {
+    // Check for Retry-After header first (RFC 7231), with no jitter
+    const retryAfter = response.headers.get("Retry-After");
+    if (retryAfter) {
+        // Parse as number of seconds...
+        const retryAfterSeconds = parseInt(retryAfter, 10);
+        if (!isNaN(retryAfterSeconds) && retryAfterSeconds > 0) {
+            return Math.min(retryAfterSeconds * 1000, MAX_RETRY_DELAY);
+        }
+        // ...or as an HTTP date; both are valid
+        const retryAfterDate = new Date(retryAfter);
+        if (!isNaN(retryAfterDate.getTime())) {
+            const delay = retryAfterDate.getTime() - Date.now();
+            if (delay > 0) {
+                return Math.min(Math.max(delay, 0), MAX_RETRY_DELAY);
+            }
+        }
+    }
+    // Then check for industry-standard X-RateLimit-Reset header, with positive jitter
+    const rateLimitReset = response.headers.get("X-RateLimit-Reset");
+    if (rateLimitReset) {
+        const resetTime = parseInt(rateLimitReset, 10);
+        if (!isNaN(resetTime)) {
+            // Assume Unix timestamp in epoch seconds
+            const delay = resetTime * 1000 - Date.now();
+            if (delay > 0) {
+                return addPositiveJitter(Math.min(delay, MAX_RETRY_DELAY));
+            }
+        }
+    }
+    // Fall back to exponential backoff, with symmetric jitter
+    return addSymmetricJitter(Math.min(INITIAL_RETRY_DELAY * Math.pow(2, retryAttempt), MAX_RETRY_DELAY));
+}
 function requestWithRetries(requestFn_1) {
     return __awaiter(this, arguments, void 0, function* (requestFn, maxRetries = DEFAULT_MAX_RETRIES) {
         let response = yield requestFn();
         for (let i = 0; i < maxRetries; ++i) {
             if ([408, 429].includes(response.status) || response.status >= 500) {
-                // Calculate base delay using exponential backoff (in milliseconds)
-                const baseDelay = Math.min(INITIAL_RETRY_DELAY * Math.pow(2, i), MAX_RETRY_DELAY);
-                // Add jitter to the delay
-                const delayWithJitter = addJitter(baseDelay);
-                yield new Promise((resolve) => setTimeout(resolve, delayWithJitter));
+                // Get delay with appropriate jitter applied
+                const delay = getRetryDelayFromHeaders(response, i);
+                yield new Promise((resolve) => setTimeout(resolve, delay));
                 response = yield requestFn();
             }
             else {

package/dist/cjs/core/file/exports.d.ts

@@ -1 +1 @@
-export { Uploadable } from "./types.js";
+export type { Uploadable } from "./types.js";

package/dist/cjs/core/headers.d.ts

@@ -1,3 +1,2 @@
-import * as core from "./index.js";
-export declare function mergeHeaders(...headersArray: (Record<string, string | core.Supplier<string | null | undefined> | null | undefined> | null | undefined)[]): Record<string, string | core.Supplier<string | null | undefined>>;
-export declare function mergeOnlyDefinedHeaders(...headersArray: (Record<string, string | core.Supplier<string | null | undefined> | null | undefined> | null | undefined)[]): Record<string, string | core.Supplier<string | null | undefined>>;
+export declare function mergeHeaders<THeaderValue>(...headersArray: (Record<string, THeaderValue> | null | undefined)[]): Record<string, string | THeaderValue>;
+export declare function mergeOnlyDefinedHeaders<THeaderValue>(...headersArray: (Record<string, THeaderValue> | null | undefined)[]): Record<string, THeaderValue>;

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.2.0";
+export declare const SDK_VERSION = "1.0.0";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.2.0";
+exports.SDK_VERSION = "1.0.0";

package/dist/esm/Client.mjs

@@ -12,8 +12,8 @@ export class MarkupAIClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: mergeHeaders({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@markupai/api",
-                "X-Fern-SDK-Version": "0.2.0",
-                "User-Agent": "@markupai/api/0.2.0",
+                "X-Fern-SDK-Version": "1.0.0",
+                "User-Agent": "@markupai/api/1.0.0",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/esm/api/errors/TooManyRequestsError.d.mts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as errors from "../../errors/index.mjs";
+import * as MarkupAI from "../index.mjs";
+import * as core from "../../core/index.mjs";
+export declare class TooManyRequestsError extends errors.MarkupAIError {
+    constructor(body: MarkupAI.ErrorResponse, rawResponse?: core.RawResponse);
+}

package/dist/esm/api/errors/TooManyRequestsError.mjs

@@ -0,0 +1,15 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as errors from "../../errors/index.mjs";
+export class TooManyRequestsError extends errors.MarkupAIError {
+    constructor(body, rawResponse) {
+        super({
+            message: "TooManyRequestsError",
+            statusCode: 429,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, TooManyRequestsError.prototype);
+    }
+}

package/dist/esm/api/errors/index.d.mts

@@ -4,3 +4,4 @@ export * from "./UnprocessableEntityError.mjs";
 export * from "./InternalServerError.mjs";
 export * from "./ContentTooLargeError.mjs";
 export * from "./NotFoundError.mjs";
+export * from "./TooManyRequestsError.mjs";

package/dist/esm/api/errors/index.mjs

@@ -4,3 +4,4 @@ export * from "./UnprocessableEntityError.mjs";
 export * from "./InternalServerError.mjs";
 export * from "./ContentTooLargeError.mjs";
 export * from "./NotFoundError.mjs";
+export * from "./TooManyRequestsError.mjs";

package/dist/esm/api/resources/styleChecks/client/Client.d.mts

@@ -43,6 +43,7 @@ export declare class StyleChecks {
      * @throws {@link MarkupAI.ForbiddenError}
      * @throws {@link MarkupAI.ContentTooLargeError}
      * @throws {@link MarkupAI.UnprocessableEntityError}
+     * @throws {@link MarkupAI.TooManyRequestsError}
      * @throws {@link MarkupAI.InternalServerError}
      *
      * @example

package/dist/esm/api/resources/styleChecks/client/Client.mjs

@@ -32,6 +32,7 @@ export class StyleChecks {
      * @throws {@link MarkupAI.ForbiddenError}
      * @throws {@link MarkupAI.ContentTooLargeError}
      * @throws {@link MarkupAI.UnprocessableEntityError}
+     * @throws {@link MarkupAI.TooManyRequestsError}
      * @throws {@link MarkupAI.InternalServerError}
      *
      * @example
@@ -85,6 +86,8 @@ export class StyleChecks {
                         throw new MarkupAI.ContentTooLargeError(_response.error.body, _response.rawResponse);
                     case 422:
                         throw new MarkupAI.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new MarkupAI.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new MarkupAI.InternalServerError(_response.error.body, _response.rawResponse);
                     default:

package/dist/esm/api/resources/styleRewrites/client/Client.d.mts

@@ -43,6 +43,7 @@ export declare class StyleRewrites {
      * @throws {@link MarkupAI.ForbiddenError}
      * @throws {@link MarkupAI.ContentTooLargeError}
      * @throws {@link MarkupAI.UnprocessableEntityError}
+     * @throws {@link MarkupAI.TooManyRequestsError}
      * @throws {@link MarkupAI.InternalServerError}
      *
      * @example

package/dist/esm/api/resources/styleRewrites/client/Client.mjs

@@ -32,6 +32,7 @@ export class StyleRewrites {
      * @throws {@link MarkupAI.ForbiddenError}
      * @throws {@link MarkupAI.ContentTooLargeError}
      * @throws {@link MarkupAI.UnprocessableEntityError}
+     * @throws {@link MarkupAI.TooManyRequestsError}
      * @throws {@link MarkupAI.InternalServerError}
      *
      * @example
@@ -85,6 +86,8 @@ export class StyleRewrites {
                         throw new MarkupAI.ContentTooLargeError(_response.error.body, _response.rawResponse);
                     case 422:
                         throw new MarkupAI.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new MarkupAI.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new MarkupAI.InternalServerError(_response.error.body, _response.rawResponse);
                     default:

package/dist/esm/api/resources/styleSuggestions/client/Client.d.mts

@@ -43,6 +43,7 @@ export declare class StyleSuggestions {
      * @throws {@link MarkupAI.ForbiddenError}
      * @throws {@link MarkupAI.ContentTooLargeError}
      * @throws {@link MarkupAI.UnprocessableEntityError}
+     * @throws {@link MarkupAI.TooManyRequestsError}
      * @throws {@link MarkupAI.InternalServerError}
      *
      * @example

package/dist/esm/api/resources/styleSuggestions/client/Client.mjs

@@ -32,6 +32,7 @@ export class StyleSuggestions {
      * @throws {@link MarkupAI.ForbiddenError}
      * @throws {@link MarkupAI.ContentTooLargeError}
      * @throws {@link MarkupAI.UnprocessableEntityError}
+     * @throws {@link MarkupAI.TooManyRequestsError}
      * @throws {@link MarkupAI.InternalServerError}
      *
      * @example
@@ -85,6 +86,8 @@ export class StyleSuggestions {
                         throw new MarkupAI.ContentTooLargeError(_response.error.body, _response.rawResponse);
                     case 422:
                         throw new MarkupAI.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new MarkupAI.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new MarkupAI.InternalServerError(_response.error.body, _response.rawResponse);
                     default:

package/dist/esm/api/types/StyleGuideResponse.d.mts

@@ -16,6 +16,6 @@ export interface StyleGuideResponse {
     updated_at?: string;
     /** The ID of the user who last updated the style guide. If null, the style guide has never been updated. */
     updated_by?: string;
-    /** The prompt used to apply a style guide to a document. This should not be displayed to the user. */
-    prompt: string;
+    /** User-friendly summary of the style guide's contents and characteristics */
+    summary?: string;
 }

package/dist/esm/api/types/StyleGuides.d.mts

@@ -1,11 +1,10 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export type StyleGuides = "ap" | "chicago" | "microsoft" | "demo" | "style_brand_importer";
+export type StyleGuides = "ap" | "chicago" | "microsoft" | "style_brand_importer";
 export declare const StyleGuides: {
     readonly Ap: "ap";
     readonly Chicago: "chicago";
     readonly Microsoft: "microsoft";
-    readonly Demo: "demo";
     readonly StyleBrandImporter: "style_brand_importer";
 };

package/dist/esm/api/types/StyleGuides.mjs

@@ -5,6 +5,5 @@ export const StyleGuides = {
     Ap: "ap",
     Chicago: "chicago",
     Microsoft: "microsoft",
-    Demo: "demo",
     StyleBrandImporter: "style_brand_importer",
 };

package/dist/esm/core/auth/index.d.mts

@@ -1,4 +1,4 @@
-export { AuthProvider } from "./AuthProvider.mjs";
-export { type AuthRequest } from "./AuthRequest.mjs";
+export type { AuthProvider } from "./AuthProvider.mjs";
+export type { AuthRequest } from "./AuthRequest.mjs";
 export { BasicAuth } from "./BasicAuth.mjs";
 export { BearerToken } from "./BearerToken.mjs";

package/dist/esm/core/fetcher/EndpointMetadata.d.mts

@@ -0,0 +1,13 @@
+export type SecuritySchemeKey = string;
+/**
+ * A collection of security schemes, where the key is the name of the security scheme and the value is the list of scopes required for that scheme.
+ * All schemes in the collection must be satisfied for authentication to be successful.
+ */
+export type SecuritySchemeCollection = Record<SecuritySchemeKey, AuthScope[]>;
+export type AuthScope = string;
+export type EndpointMetadata = {
+    /**
+     * An array of security scheme collections. Each collection represents an alternative way to authenticate.
+     */
+    security?: SecuritySchemeCollection[];
+};

package/dist/esm/core/fetcher/EndpointMetadata.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/fetcher/EndpointSupplier.d.mts

@@ -0,0 +1,12 @@
+import { EndpointMetadata } from "./EndpointMetadata.mjs";
+import { Supplier } from "./Supplier.mjs";
+type EndpointSupplierFn<T> = (arg: {
+    endpointMetadata: EndpointMetadata;
+}) => T | Promise<T>;
+export type EndpointSupplier<T> = Supplier<T> | EndpointSupplierFn<T>;
+export declare const EndpointSupplier: {
+    get: <T>(supplier: EndpointSupplier<T>, arg: {
+        endpointMetadata: EndpointMetadata;
+    }) => Promise<T>;
+};
+export {};

package/dist/esm/core/fetcher/EndpointSupplier.mjs

@@ -0,0 +1,19 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+export const EndpointSupplier = {
+    get: (supplier, arg) => __awaiter(void 0, void 0, void 0, function* () {
+        if (typeof supplier === "function") {
+            return supplier(arg);
+        }
+        else {
+            return supplier;
+        }
+    }),
+};

package/dist/esm/core/fetcher/Fetcher.d.mts

@@ -1,12 +1,13 @@
 import { APIResponse } from "./APIResponse.mjs";
-import { Supplier } from "./Supplier.mjs";
+import { EndpointMetadata } from "./EndpointMetadata.mjs";
+import { EndpointSupplier } from "./EndpointSupplier.mjs";
 export type FetchFunction = <R = unknown>(args: Fetcher.Args) => Promise<APIResponse<R, Fetcher.Error>>;
 export declare namespace Fetcher {
     interface Args {
         url: string;
         method: string;
         contentType?: string;
-        headers?: Record<string, string | Supplier<string | null | undefined> | null | undefined>;
+        headers?: Record<string, string | EndpointSupplier<string | null | undefined> | null | undefined>;
         queryParameters?: Record<string, unknown>;
         body?: unknown;
         timeoutMs?: number;
@@ -16,6 +17,7 @@ export declare namespace Fetcher {
         requestType?: "json" | "file" | "bytes";
         responseType?: "json" | "blob" | "sse" | "streaming" | "text" | "arrayBuffer" | "binary-response";
         duplex?: "half";
+        endpointMetadata?: EndpointMetadata;
     }
     type Error = FailedStatusCodeError | NonJsonError | TimeoutError | UnknownError;
     interface FailedStatusCodeError {

package/dist/esm/core/fetcher/Fetcher.mjs

@@ -9,6 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { toJson } from "../json.mjs";
 import { createRequestUrl } from "./createRequestUrl.mjs";
+import { EndpointSupplier } from "./EndpointSupplier.mjs";
 import { getErrorResponseBody } from "./getErrorResponseBody.mjs";
 import { getFetchFn } from "./getFetchFn.mjs";
 import { getRequestBody } from "./getRequestBody.mjs";
@@ -16,9 +17,9 @@ import { getResponseBody } from "./getResponseBody.mjs";
 import { makeRequest } from "./makeRequest.mjs";
 import { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
 import { requestWithRetries } from "./requestWithRetries.mjs";
-import { Supplier } from "./Supplier.mjs";
 function getHeaders(args) {
     return __awaiter(this, void 0, void 0, function* () {
+        var _a;
         const newHeaders = {};
         if (args.body !== undefined && args.contentType != null) {
             newHeaders["Content-Type"] = args.contentType;
@@ -27,7 +28,7 @@ function getHeaders(args) {
             return newHeaders;
         }
         for (const [key, value] of Object.entries(args.headers)) {
-            const result = yield Supplier.get(value);
+            const result = yield EndpointSupplier.get(value, { endpointMetadata: (_a = args.endpointMetadata) !== null && _a !== void 0 ? _a : {} });
             if (typeof result === "string") {
                 newHeaders[key] = result;
                 continue;

package/dist/esm/core/fetcher/index.d.mts

@@ -1,5 +1,7 @@
 export type { APIResponse } from "./APIResponse.mjs";
 export type { BinaryResponse } from "./BinaryResponse.mjs";
+export type { EndpointMetadata } from "./EndpointMetadata.mjs";
+export { EndpointSupplier } from "./EndpointSupplier.mjs";
 export type { Fetcher, FetchFunction } from "./Fetcher.mjs";
 export { fetcher } from "./Fetcher.mjs";
 export { getHeader } from "./getHeader.mjs";

package/dist/esm/core/fetcher/index.mjs

@@ -1,3 +1,4 @@
+export { EndpointSupplier } from "./EndpointSupplier.mjs";
 export { fetcher } from "./Fetcher.mjs";
 export { getHeader } from "./getHeader.mjs";
 export { HttpResponsePromise } from "./HttpResponsePromise.mjs";

package/dist/esm/core/fetcher/requestWithRetries.mjs

@@ -11,21 +11,57 @@ const INITIAL_RETRY_DELAY = 1000; // in milliseconds
 const MAX_RETRY_DELAY = 60000; // in milliseconds
 const DEFAULT_MAX_RETRIES = 2;
 const JITTER_FACTOR = 0.2; // 20% random jitter
-function addJitter(delay) {
-    // Generate a random value between -JITTER_FACTOR and +JITTER_FACTOR
-    const jitterMultiplier = 1 + (Math.random() * 2 - 1) * JITTER_FACTOR;
+function addPositiveJitter(delay) {
+    // Generate a random value between 0 and +JITTER_FACTOR
+    const jitterMultiplier = 1 + Math.random() * JITTER_FACTOR;
     return delay * jitterMultiplier;
 }
+function addSymmetricJitter(delay) {
+    // Generate a random value in a JITTER_FACTOR-sized percentage range around delay
+    const jitterMultiplier = 1 + (Math.random() - 0.5) * JITTER_FACTOR;
+    return delay * jitterMultiplier;
+}
+function getRetryDelayFromHeaders(response, retryAttempt) {
+    // Check for Retry-After header first (RFC 7231), with no jitter
+    const retryAfter = response.headers.get("Retry-After");
+    if (retryAfter) {
+        // Parse as number of seconds...
+        const retryAfterSeconds = parseInt(retryAfter, 10);
+        if (!isNaN(retryAfterSeconds) && retryAfterSeconds > 0) {
+            return Math.min(retryAfterSeconds * 1000, MAX_RETRY_DELAY);
+        }
+        // ...or as an HTTP date; both are valid
+        const retryAfterDate = new Date(retryAfter);
+        if (!isNaN(retryAfterDate.getTime())) {
+            const delay = retryAfterDate.getTime() - Date.now();
+            if (delay > 0) {
+                return Math.min(Math.max(delay, 0), MAX_RETRY_DELAY);
+            }
+        }
+    }
+    // Then check for industry-standard X-RateLimit-Reset header, with positive jitter
+    const rateLimitReset = response.headers.get("X-RateLimit-Reset");
+    if (rateLimitReset) {
+        const resetTime = parseInt(rateLimitReset, 10);
+        if (!isNaN(resetTime)) {
+            // Assume Unix timestamp in epoch seconds
+            const delay = resetTime * 1000 - Date.now();
+            if (delay > 0) {
+                return addPositiveJitter(Math.min(delay, MAX_RETRY_DELAY));
+            }
+        }
+    }
+    // Fall back to exponential backoff, with symmetric jitter
+    return addSymmetricJitter(Math.min(INITIAL_RETRY_DELAY * Math.pow(2, retryAttempt), MAX_RETRY_DELAY));
+}
 export function requestWithRetries(requestFn_1) {
     return __awaiter(this, arguments, void 0, function* (requestFn, maxRetries = DEFAULT_MAX_RETRIES) {
         let response = yield requestFn();
         for (let i = 0; i < maxRetries; ++i) {
             if ([408, 429].includes(response.status) || response.status >= 500) {
-                // Calculate base delay using exponential backoff (in milliseconds)
-                const baseDelay = Math.min(INITIAL_RETRY_DELAY * Math.pow(2, i), MAX_RETRY_DELAY);
-                // Add jitter to the delay
-                const delayWithJitter = addJitter(baseDelay);
-                yield new Promise((resolve) => setTimeout(resolve, delayWithJitter));
+                // Get delay with appropriate jitter applied
+                const delay = getRetryDelayFromHeaders(response, i);
+                yield new Promise((resolve) => setTimeout(resolve, delay));
                 response = yield requestFn();
             }
             else {

package/dist/esm/core/file/exports.d.mts

@@ -1 +1 @@
-export { Uploadable } from "./types.mjs";
+export type { Uploadable } from "./types.mjs";

package/dist/esm/core/headers.d.mts

@@ -1,3 +1,2 @@
-import * as core from "./index.mjs";
-export declare function mergeHeaders(...headersArray: (Record<string, string | core.Supplier<string | null | undefined> | null | undefined> | null | undefined)[]): Record<string, string | core.Supplier<string | null | undefined>>;
-export declare function mergeOnlyDefinedHeaders(...headersArray: (Record<string, string | core.Supplier<string | null | undefined> | null | undefined> | null | undefined)[]): Record<string, string | core.Supplier<string | null | undefined>>;
+export declare function mergeHeaders<THeaderValue>(...headersArray: (Record<string, THeaderValue> | null | undefined)[]): Record<string, string | THeaderValue>;
+export declare function mergeOnlyDefinedHeaders<THeaderValue>(...headersArray: (Record<string, THeaderValue> | null | undefined)[]): Record<string, THeaderValue>;

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.2.0";
+export declare const SDK_VERSION = "1.0.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.2.0";
+export const SDK_VERSION = "1.0.0";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@markupai/api",
-    "version": "0.2.0",
+    "version": "1.0.0",
     "private": false,
     "repository": "github:markupai/markup-ai-typescript-sdk",
     "license": "Apache-2.0",
@@ -31,23 +31,18 @@
     ],
     "scripts": {
         "format": "prettier . --write --ignore-unknown",
-        "build": "yarn build:cjs && yarn build:esm",
+        "build": "pnpm build:cjs && pnpm build:esm",
         "build:cjs": "tsc --project ./tsconfig.cjs.json",
         "build:esm": "tsc --project ./tsconfig.esm.json && node scripts/rename-to-esm-files.js dist/esm",
-        "test": "jest --config jest.config.mjs",
-        "test:unit": "jest --selectProjects unit",
-        "test:browser": "jest --selectProjects browser",
-        "test:wire": "jest --selectProjects wire"
+        "test": "vitest",
+        "test:unit": "vitest --project unit",
+        "test:wire": "vitest --project wire"
     },
     "devDependencies": {
         "webpack": "^5.97.1",
         "ts-loader": "^9.5.1",
-        "jest": "^29.7.0",
-        "@jest/globals": "^29.7.0",
-        "@types/jest": "^29.5.14",
-        "ts-jest": "^29.3.4",
-        "jest-environment-jsdom": "^29.7.0",
-        "msw": "^2.8.4",
+        "vitest": "^3.2.4",
+        "msw": "2.11.2",
         "@types/node": "^18.19.70",
         "prettier": "^3.4.2",
         "typescript": "~5.7.2"
@@ -58,7 +53,7 @@
         "path": false,
         "stream": false
     },
-    "packageManager": "yarn@1.22.22",
+    "packageManager": "pnpm@10.14.0",
     "engines": {
         "node": ">=18.0.0"
     },