@huggingface/inference 3.13.0 → 3.13.2-tshy

package/dist/esm/utils/request.js

@@ -0,0 +1,112 @@
+import { makeRequestOptions } from "../lib/makeRequestOptions.js";
+import { getLines, getMessages } from "../vendor/fetch-event-source/parse.js";
+/**
+ * Primitive to make custom calls to the inference provider
+ */
+export async function innerRequest(args, providerHelper, options) {
+    const { url, info } = await makeRequestOptions(args, providerHelper, options);
+    const response = await (options?.fetch ?? fetch)(url, info);
+    const requestContext = { url, info };
+    if (options?.retry_on_error !== false && response.status === 503) {
+        return innerRequest(args, providerHelper, options);
+    }
+    if (!response.ok) {
+        const contentType = response.headers.get("Content-Type");
+        if (["application/json", "application/problem+json"].some((ct) => contentType?.startsWith(ct))) {
+            const output = await response.json();
+            if ([400, 422, 404, 500].includes(response.status) && options?.chatCompletion) {
+                throw new Error(`Server ${args.model} does not seem to support chat completion. Error: ${JSON.stringify(output.error)}`);
+            }
+            if (output.error || output.detail) {
+                throw new Error(JSON.stringify(output.error ?? output.detail));
+            }
+            else {
+                throw new Error(output);
+            }
+        }
+        const message = contentType?.startsWith("text/plain;") ? await response.text() : undefined;
+        throw new Error(message ?? "An error occurred while fetching the blob");
+    }
+    if (response.headers.get("Content-Type")?.startsWith("application/json")) {
+        const data = (await response.json());
+        return { data, requestContext };
+    }
+    const blob = (await response.blob());
+    return { data: blob, requestContext };
+}
+/**
+ * Primitive to make custom inference calls that expect server-sent events, and returns the response through a generator
+ */
+export async function* innerStreamingRequest(args, providerHelper, options) {
+    const { url, info } = await makeRequestOptions({ ...args, stream: true }, providerHelper, options);
+    const response = await (options?.fetch ?? fetch)(url, info);
+    if (options?.retry_on_error !== false && response.status === 503) {
+        return yield* innerStreamingRequest(args, providerHelper, options);
+    }
+    if (!response.ok) {
+        if (response.headers.get("Content-Type")?.startsWith("application/json")) {
+            const output = await response.json();
+            if ([400, 422, 404, 500].includes(response.status) && options?.chatCompletion) {
+                throw new Error(`Server ${args.model} does not seem to support chat completion. Error: ${output.error}`);
+            }
+            if (typeof output.error === "string") {
+                throw new Error(output.error);
+            }
+            if (output.error && "message" in output.error && typeof output.error.message === "string") {
+                /// OpenAI errors
+                throw new Error(output.error.message);
+            }
+            // Sambanova errors
+            if (typeof output.message === "string") {
+                throw new Error(output.message);
+            }
+        }
+        throw new Error(`Server response contains error: ${response.status}`);
+    }
+    if (!response.headers.get("content-type")?.startsWith("text/event-stream")) {
+        throw new Error(`Server does not support event stream content type, it returned ` + response.headers.get("content-type"));
+    }
+    if (!response.body) {
+        return;
+    }
+    const reader = response.body.getReader();
+    let events = [];
+    const onEvent = (event) => {
+        // accumulate events in array
+        events.push(event);
+    };
+    const onChunk = getLines(getMessages(() => { }, () => { }, onEvent));
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done) {
+                return;
+            }
+            onChunk(value);
+            for (const event of events) {
+                if (event.data.length > 0) {
+                    if (event.data === "[DONE]") {
+                        return;
+                    }
+                    const data = JSON.parse(event.data);
+                    if (typeof data === "object" && data !== null && "error" in data) {
+                        const errorStr = typeof data.error === "string"
+                            ? data.error
+                            : typeof data.error === "object" &&
+                                data.error &&
+                                "message" in data.error &&
+                                typeof data.error.message === "string"
+                                ? data.error.message
+                                : JSON.stringify(data.error);
+                        throw new Error(`Error forwarded from backend: ` + errorStr);
+                    }
+                    yield data;
+                }
+            }
+            events = [];
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}

package/dist/esm/utils/toArray.d.ts

@@ -0,0 +1,2 @@
+export declare function toArray<T>(obj: T): T extends unknown[] ? T : T[];
+//# sourceMappingURL=toArray.d.ts.map

package/dist/esm/utils/toArray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toArray.d.ts","sourceRoot":"","sources":["../../../src/utils/toArray.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAKhE"}

package/dist/esm/utils/toArray.js

@@ -0,0 +1,6 @@
+export function toArray(obj) {
+    if (Array.isArray(obj)) {
+        return obj;
+    }
+    return [obj];
+}

package/dist/esm/utils/typedEntries.d.ts

@@ -0,0 +1,4 @@
+export declare function typedEntries<T extends {
+    [s: string]: T[keyof T];
+} | ArrayLike<T[keyof T]>>(obj: T): [keyof T, T[keyof T]][];
+//# sourceMappingURL=typedEntries.d.ts.map

package/dist/esm/utils/typedEntries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedEntries.d.ts","sourceRoot":"","sources":["../../../src/utils/typedEntries.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;CAAE,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EACzF,GAAG,EAAE,CAAC,GACJ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAEzB"}

package/dist/esm/utils/typedEntries.js

@@ -0,0 +1,3 @@
+export function typedEntries(obj) {
+    return Object.entries(obj);
+}

package/dist/esm/utils/typedInclude.d.ts

@@ -0,0 +1,2 @@
+export declare function typedInclude<V, T extends V>(arr: readonly T[], v: V): v is T;
+//# sourceMappingURL=typedInclude.d.ts.map

package/dist/esm/utils/typedInclude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedInclude.d.ts","sourceRoot":"","sources":["../../../src/utils/typedInclude.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAE5E"}

package/dist/esm/utils/typedInclude.js

@@ -0,0 +1,3 @@
+export function typedInclude(arr, v) {
+    return arr.includes(v);
+}

package/dist/esm/vendor/fetch-event-source/parse.d.ts

@@ -0,0 +1,69 @@
+/**
+ This file is a part of fetch-event-source package (as of v2.0.1)
+ https://github.com/Azure/fetch-event-source/blob/v2.0.1/src/parse.ts
+
+ Full package can be used after it is made compatible with nodejs:
+ https://github.com/Azure/fetch-event-source/issues/20
+
+ Below is the fetch-event-source package license:
+
+ MIT License
+
+ Copyright (c) Microsoft Corporation.
+
+ Permission is hereby granted, free of charge, to any person obtaining a copy
+ of this software and associated documentation files (the "Software"), to deal
+ in the Software without restriction, including without limitation the rights
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ copies of the Software, and to permit persons to whom the Software is
+ furnished to do so, subject to the following conditions:
+
+ The above copyright notice and this permission notice shall be included in all
+ copies or substantial portions of the Software.
+
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ SOFTWARE
+
+ */
+/**
+ * Represents a message sent in an event stream
+ * https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format
+ */
+export interface EventSourceMessage {
+    /** The event ID to set the EventSource object's last event ID value. */
+    id: string;
+    /** A string identifying the type of event described. */
+    event: string;
+    /** The event data */
+    data: string;
+    /** The reconnection interval (in milliseconds) to wait before retrying the connection */
+    retry?: number;
+}
+/**
+ * Converts a ReadableStream into a callback pattern.
+ * @param stream The input ReadableStream.
+ * @param onChunk A function that will be called on each new byte chunk in the stream.
+ * @returns {Promise<void>} A promise that will be resolved when the stream closes.
+ */
+export declare function getBytes(stream: ReadableStream<Uint8Array>, onChunk: (arr: Uint8Array) => void): Promise<void>;
+/**
+ * Parses arbitary byte chunks into EventSource line buffers.
+ * Each line should be of the format "field: value" and ends with \r, \n, or \r\n.
+ * @param onLine A function that will be called on each new EventSource line.
+ * @returns A function that should be called for each incoming byte chunk.
+ */
+export declare function getLines(onLine: (line: Uint8Array, fieldLength: number) => void): (arr: Uint8Array) => void;
+/**
+ * Parses line buffers into EventSourceMessages.
+ * @param onId A function that will be called on each `id` field.
+ * @param onRetry A function that will be called on each `retry` field.
+ * @param onMessage A function that will be called on each message.
+ * @returns A function that should be called for each incoming line buffer.
+ */
+export declare function getMessages(onId: (id: string) => void, onRetry: (retry: number) => void, onMessage?: (msg: EventSourceMessage) => void): (line: Uint8Array, fieldLength: number) => void;
+//# sourceMappingURL=parse.d.ts.map

package/dist/esm/vendor/fetch-event-source/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../../src/vendor/fetch-event-source/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpH;AASD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAmE3G;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACvB,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,EAC1B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAChC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAC9C,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAyCjD"}

package/dist/esm/vendor/fetch-event-source/parse.js

@@ -0,0 +1,180 @@
+/**
+ This file is a part of fetch-event-source package (as of v2.0.1)
+ https://github.com/Azure/fetch-event-source/blob/v2.0.1/src/parse.ts
+
+ Full package can be used after it is made compatible with nodejs:
+ https://github.com/Azure/fetch-event-source/issues/20
+
+ Below is the fetch-event-source package license:
+
+ MIT License
+
+ Copyright (c) Microsoft Corporation.
+
+ Permission is hereby granted, free of charge, to any person obtaining a copy
+ of this software and associated documentation files (the "Software"), to deal
+ in the Software without restriction, including without limitation the rights
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ copies of the Software, and to permit persons to whom the Software is
+ furnished to do so, subject to the following conditions:
+
+ The above copyright notice and this permission notice shall be included in all
+ copies or substantial portions of the Software.
+
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ SOFTWARE
+
+ */
+/**
+ * Converts a ReadableStream into a callback pattern.
+ * @param stream The input ReadableStream.
+ * @param onChunk A function that will be called on each new byte chunk in the stream.
+ * @returns {Promise<void>} A promise that will be resolved when the stream closes.
+ */
+export async function getBytes(stream, onChunk) {
+    const reader = stream.getReader();
+    let result;
+    while (!(result = await reader.read()).done) {
+        onChunk(result.value);
+    }
+}
+/**
+ * Parses arbitary byte chunks into EventSource line buffers.
+ * Each line should be of the format "field: value" and ends with \r, \n, or \r\n.
+ * @param onLine A function that will be called on each new EventSource line.
+ * @returns A function that should be called for each incoming byte chunk.
+ */
+export function getLines(onLine) {
+    let buffer;
+    let position; // current read position
+    let fieldLength; // length of the `field` portion of the line
+    let discardTrailingNewline = false;
+    // return a function that can process each incoming byte chunk:
+    return function onChunk(arr) {
+        if (buffer === undefined) {
+            buffer = arr;
+            position = 0;
+            fieldLength = -1;
+        }
+        else {
+            // we're still parsing the old line. Append the new bytes into buffer:
+            buffer = concat(buffer, arr);
+        }
+        const bufLength = buffer.length;
+        let lineStart = 0; // index where the current line starts
+        while (position < bufLength) {
+            if (discardTrailingNewline) {
+                if (buffer[position] === 10 /* ControlChars.NewLine */) {
+                    lineStart = ++position; // skip to next char
+                }
+                discardTrailingNewline = false;
+            }
+            // start looking forward till the end of line:
+            let lineEnd = -1; // index of the \r or \n char
+            for (; position < bufLength && lineEnd === -1; ++position) {
+                switch (buffer[position]) {
+                    case 58 /* ControlChars.Colon */:
+                        if (fieldLength === -1) { // first colon in line
+                            fieldLength = position - lineStart;
+                        }
+                        break;
+                    case 13 /* ControlChars.CarriageReturn */:
+                        discardTrailingNewline = true;
+                    // eslint-disable-next-line no-fallthrough
+                    case 10 /* ControlChars.NewLine */:
+                        lineEnd = position;
+                        break;
+                }
+            }
+            if (lineEnd === -1) {
+                // We reached the end of the buffer but the line hasn't ended.
+                // Wait for the next arr and then continue parsing:
+                break;
+            }
+            // we've reached the line end, send it out:
+            onLine(buffer.subarray(lineStart, lineEnd), fieldLength);
+            lineStart = position; // we're now on the next line
+            fieldLength = -1;
+        }
+        if (lineStart === bufLength) {
+            buffer = undefined; // we've finished reading it
+        }
+        else if (lineStart !== 0) {
+            // Create a new view into buffer beginning at lineStart so we don't
+            // need to copy over the previous lines when we get the new arr:
+            buffer = buffer.subarray(lineStart);
+            position -= lineStart;
+        }
+    };
+}
+/**
+ * Parses line buffers into EventSourceMessages.
+ * @param onId A function that will be called on each `id` field.
+ * @param onRetry A function that will be called on each `retry` field.
+ * @param onMessage A function that will be called on each message.
+ * @returns A function that should be called for each incoming line buffer.
+ */
+export function getMessages(onId, onRetry, onMessage) {
+    let message = newMessage();
+    const decoder = new TextDecoder();
+    // return a function that can process each incoming line buffer:
+    return function onLine(line, fieldLength) {
+        if (line.length === 0) {
+            // empty line denotes end of message. Trigger the callback and start a new message:
+            onMessage?.(message);
+            message = newMessage();
+        }
+        else if (fieldLength > 0) { // exclude comments and lines with no values
+            // line is of format "<field>:<value>" or "<field>: <value>"
+            // https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation
+            const field = decoder.decode(line.subarray(0, fieldLength));
+            const valueOffset = fieldLength + (line[fieldLength + 1] === 32 /* ControlChars.Space */ ? 2 : 1);
+            const value = decoder.decode(line.subarray(valueOffset));
+            switch (field) {
+                case 'data':
+                    // if this message already has data, append the new value to the old.
+                    // otherwise, just set to the new value:
+                    message.data = message.data
+                        ? message.data + '\n' + value
+                        : value; // otherwise, 
+                    break;
+                case 'event':
+                    message.event = value;
+                    break;
+                case 'id':
+                    onId(message.id = value);
+                    break;
+                case 'retry': {
+                    const retry = parseInt(value, 10);
+                    if (!isNaN(retry)) { // per spec, ignore non-integers
+                        onRetry(message.retry = retry);
+                    }
+                    break;
+                }
+            }
+        }
+    };
+}
+function concat(a, b) {
+    const res = new Uint8Array(a.length + b.length);
+    res.set(a);
+    res.set(b, a.length);
+    return res;
+}
+function newMessage() {
+    // data, event, and id must be initialized to empty strings:
+    // https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation
+    // retry should be initialized to undefined so we return a consistent shape
+    // to the js engine all the time: https://mathiasbynens.be/notes/shapes-ics#takeaways
+    return {
+        data: '',
+        event: '',
+        id: '',
+        retry: undefined,
+    };
+}

package/dist/esm/vendor/fetch-event-source/parse.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parse.spec.d.ts.map

package/dist/esm/vendor/fetch-event-source/parse.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.spec.d.ts","sourceRoot":"","sources":["../../../../src/vendor/fetch-event-source/parse.spec.ts"],"names":[],"mappings":""}