@arizeai/phoenix-client 0.0.1 → 1.0.1

package/dist/esm/utils/assertUnreachable.js

@@ -0,0 +1,10 @@
+/**
+ * Utility function that uses the type system to check if a switch statement is exhaustive.
+ * If the switch statement is not exhaustive, there will be a type error caught in typescript
+ *
+ * See https://stackoverflow.com/questions/39419170/how-do-i-check-that-a-switch-block-is-exhaustive-in-typescript for more details.
+ */
+export function assertUnreachable(_) {
+    throw new Error("Unreachable");
+}
+//# sourceMappingURL=assertUnreachable.js.map

package/dist/esm/utils/assertUnreachable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertUnreachable.js","sourceRoot":"","sources":["../../../src/utils/assertUnreachable.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAQ;IACxC,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;AACjC,CAAC"}

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

@@ -0,0 +1,26 @@
+import { Variables } from "../prompts/sdks/types.js";
+import { PromptChatMessage, PromptTemplateFormat } from "../types/prompts.js";
+/**
+ * Format a list of prompt messages
+ *
+ * @param format - The format of the prompt message variables, e.g. MUSTACHE, F_STRING, NONE
+ * @param promptMessages - The prompt messages to format
+ * @param variables - The variables to use in the formatting
+ * @returns The formatted prompt messages
+ */
+export declare function formatPromptMessages(format: PromptTemplateFormat, promptMessages: PromptChatMessage[], variables?: Variables): {
+    content: string | ({
+        type: "text";
+        text: string;
+    } | {
+        type: "tool_call";
+        tool_call_id: string;
+        tool_call: import("../__generated__/api/v1.js").components["schemas"]["ToolCallFunction"];
+    } | {
+        type: "tool_result";
+        tool_call_id: string;
+        tool_result: boolean | number | string | Record<string, unknown> | unknown[] | null;
+    })[];
+    role: "user" | "assistant" | "model" | "ai" | "tool" | "system" | "developer";
+}[];
+//# sourceMappingURL=formatPromptMessages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatPromptMessages.d.ts","sourceRoot":"","sources":["../../../src/utils/formatPromptMessages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAO3E;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,EAC5B,cAAc,EAAE,iBAAiB,EAAE,EACnC,SAAS,GAAE,SAAc;;;;;;;mBA4Dgo0B,uDAAsB;;;;;;;IAlBhr0B"}

package/dist/esm/utils/formatPromptMessages.js

@@ -0,0 +1,64 @@
+import { assertUnreachable } from "./assertUnreachable.js";
+import { asTextPart, } from "../schemas/llm/phoenixPrompt/messagePartSchemas.js";
+/**
+ * Format a list of prompt messages
+ *
+ * @param format - The format of the prompt message variables, e.g. MUSTACHE, F_STRING, NONE
+ * @param promptMessages - The prompt messages to format
+ * @param variables - The variables to use in the formatting
+ * @returns The formatted prompt messages
+ */
+export function formatPromptMessages(format, promptMessages, variables = {}) {
+    const replacements = [];
+    switch (format) {
+        case "MUSTACHE": {
+            const asMustache = Object.entries(variables).map(([key, value]) => [
+                new RegExp(`\\{\\{\\s*${key}\\s*\\}\\}(?!\\})`, "g"),
+                value.toString(),
+            ]);
+            replacements.push(...asMustache);
+            break;
+        }
+        case "F_STRING": {
+            const asF_STRING = Object.entries(variables).map(([key, value]) => [
+                new RegExp(`(?<!\\{)\\{\\s*${key}\\s*\\}(?!\\})`, "g"),
+                value.toString(),
+            ]);
+            replacements.push(...asF_STRING);
+            break;
+        }
+        case "NONE":
+            break;
+        default:
+            assertUnreachable(format);
+    }
+    return promptMessages.map((message) => ({
+        ...message,
+        content: typeof message.content == "string"
+            ? applyReplacements(message.content, replacements)
+            : message.content.map((content) => {
+                const textPart = asTextPart(content);
+                if (textPart) {
+                    return {
+                        ...textPart,
+                        text: applyReplacements(textPart.text, replacements),
+                    };
+                }
+                return content;
+            }),
+    }));
+}
+/**
+ * Apply a list of replacements to a string
+ * @param text - The text to apply the replacements to
+ * @param replacements - The replacements to apply
+ * @returns The text with the replacements applied
+ */
+function applyReplacements(text, replacements) {
+    let newText = text;
+    for (const [key, value] of replacements) {
+        newText = newText.replaceAll(key, value);
+    }
+    return newText;
+}
+//# sourceMappingURL=formatPromptMessages.js.map

package/dist/esm/utils/formatPromptMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatPromptMessages.js","sourceRoot":"","sources":["../../../src/utils/formatPromptMessages.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAEL,UAAU,GACX,MAAM,iDAAiD,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAA4B,EAC5B,cAAmC,EACnC,YAAuB,EAAE;IAEzB,MAAM,YAAY,GAAuB,EAAE,CAAC;IAC5C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;gBACjE,IAAI,MAAM,CAAC,aAAa,GAAG,mBAAmB,EAAE,GAAG,CAAC;gBACpD,KAAK,CAAC,QAAQ,EAAE;aACjB,CAA8B,CAAC;YAChC,YAAY,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;YACjC,MAAM;QACR,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;gBACjE,IAAI,MAAM,CAAC,kBAAkB,GAAG,gBAAgB,EAAE,GAAG,CAAC;gBACtD,KAAK,CAAC,QAAQ,EAAE;aACjB,CAA8B,CAAC;YAChC,YAAY,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;YACjC,MAAM;QACR,CAAC;QACD,KAAK,MAAM;YACT,MAAM;QACR;YACE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACtC,GAAG,OAAO;QACV,OAAO,EACL,OAAO,OAAO,CAAC,OAAO,IAAI,QAAQ;YAChC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC;YAClD,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC9B,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;gBACrC,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO;wBACL,GAAG,QAAQ;wBACX,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;qBAClC,CAAC;gBACvB,CAAC;gBACD,OAAO,OAAO,CAAC;YACjB,CAAC,CAAC;KACT,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CACxB,IAAY,EACZ,YAAgC;IAEhC,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;QACxC,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,22 @@
+import { PhoenixClient } from "../client.js";
+import { Example } from "../types/datasets.js";
+import { Dataset } from "../types/datasets.js";
+/**
+ * Parameters for the getDatasetLike function
+ */
+export type GetDatasetLikeParams = {
+    dataset: Dataset | string | Example[];
+    client: PhoenixClient;
+};
+/**
+ * Return a dataset object from the input.
+ *
+ * If the input is a string, assume it is a dataset id and fetch the dataset from the client.
+ * If the input is an array of examples, create a new dataset from the examples then return it.
+ * If the input is a dataset, return it as is.
+ *
+ * @param dataset - The dataset to get.
+ * @returns The dataset.
+ */
+export declare function getDatasetLike({ dataset, client, }: GetDatasetLikeParams): Promise<Dataset | null>;
+//# sourceMappingURL=getDatasetLike.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getDatasetLike.d.ts","sourceRoot":"","sources":["../../../src/utils/getDatasetLike.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,EAAE,CAAC;IACtC,MAAM,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,EACnC,OAAO,EACP,MAAM,GACP,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAwBhD"}

package/dist/esm/utils/getDatasetLike.js

@@ -0,0 +1,37 @@
+import invariant from "tiny-invariant";
+/**
+ * Return a dataset object from the input.
+ *
+ * If the input is a string, assume it is a dataset id and fetch the dataset from the client.
+ * If the input is an array of examples, create a new dataset from the examples then return it.
+ * If the input is a dataset, return it as is.
+ *
+ * @param dataset - The dataset to get.
+ * @returns The dataset.
+ */
+export async function getDatasetLike({ dataset, client, }) {
+    if (typeof dataset === "string") {
+        const datasetResponse = await client
+            .GET(`/v1/datasets/{id}`, { params: { path: { id: dataset } } })
+            .then((d) => d.data?.data);
+        invariant(datasetResponse, `Dataset ${dataset} not found`);
+        const examples = await client
+            .GET(`/v1/datasets/{id}/examples`, { params: { path: { id: dataset } } })
+            .then((e) => e.data?.data);
+        invariant(examples, `Examples for dataset ${dataset} not found`);
+        const datasetWithExamples = {
+            ...datasetResponse,
+            examples: examples.examples.map((example) => ({
+                ...example,
+                updatedAt: new Date(example.updated_at),
+            })),
+            versionId: examples.version_id,
+        };
+        return datasetWithExamples;
+    }
+    if (Array.isArray(dataset)) {
+        throw new Error("TODO: implement dataset creation from examples");
+    }
+    return dataset;
+}
+//# sourceMappingURL=getDatasetLike.js.map

package/dist/esm/utils/getDatasetLike.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDatasetLike.js","sourceRoot":"","sources":["../../../src/utils/getDatasetLike.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAcvC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EACnC,OAAO,EACP,MAAM,GACe;IACrB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,eAAe,GAAG,MAAM,MAAM;aACjC,GAAG,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;aAC/D,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,SAAS,CAAC,eAAe,EAAE,WAAW,OAAO,YAAY,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,MAAM,MAAM;aAC1B,GAAG,CAAC,4BAA4B,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;aACxE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,SAAS,CAAC,QAAQ,EAAE,wBAAwB,OAAO,YAAY,CAAC,CAAC;QACjE,MAAM,mBAAmB,GAAY;YACnC,GAAG,eAAe;YAClB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC5C,GAAG,OAAO;gBACV,SAAS,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;aACxC,CAAC,CAAC;YACH,SAAS,EAAE,QAAQ,CAAC,UAAU;SAC/B,CAAC;QACF,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,29 @@
+import { PromptSelector } from "../types/prompts.js";
+import { ClientFn } from "../types/core.js";
+/**
+ * Parameters for the getPromptBySelector function
+ */
+export type GetPromptBySelectorParams = ClientFn & {
+    prompt: PromptSelector;
+};
+/**
+ * Get a prompt from the Phoenix API.
+ *
+ * if the input is a prompt id, fetch the latest prompt version from the client.
+ * if the input is a prompt version id, fetch that prompt version.
+ * if the input is a prompt tag and name, fetch the prompt version that has that tag and name.
+ * if the input is a prompt name, fetch the latest prompt version from the client.
+ */
+export declare function getPromptBySelector({ client: _client, prompt, }: GetPromptBySelectorParams): Promise<{
+    description?: string | null;
+    model_provider: import("../__generated__/api/v1.js").components["schemas"]["ModelProvider"];
+    model_name: string;
+    template: import("../__generated__/api/v1.js").components["schemas"]["PromptChatTemplate"] | import("../__generated__/api/v1.js").components["schemas"]["PromptStringTemplate"];
+    template_type: import("../__generated__/api/v1.js").components["schemas"]["PromptTemplateType"];
+    template_format: import("../__generated__/api/v1.js").components["schemas"]["PromptTemplateFormat"];
+    invocation_parameters: import("../__generated__/api/v1.js").components["schemas"]["PromptOpenAIInvocationParameters"] | import("../__generated__/api/v1.js").components["schemas"]["PromptAzureOpenAIInvocationParameters"] | import("../__generated__/api/v1.js").components["schemas"]["PromptAnthropicInvocationParameters"] | import("../__generated__/api/v1.js").components["schemas"]["PromptGoogleInvocationParameters"];
+    tools?: import("../__generated__/api/v1.js").components["schemas"]["PromptTools"] | null;
+    response_format?: import("../__generated__/api/v1.js").components["schemas"]["PromptResponseFormatJSONSchema"] | null;
+    id: string;
+} | null>;
+//# sourceMappingURL=getPromptVersionLike.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getPromptVersionLike.d.ts","sourceRoot":"","sources":["../../../src/utils/getPromptVersionLike.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG;IACjD,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,EACxC,MAAM,EAAE,OAAO,EACf,MAAM,GACP,EAAE,yBAAyB;;oBAkDmxsB,uDAAsB;;cAAkI,uDAAsB,yBAAwB,uDAAsB;mBAAoD,uDAAsB;qBAAoD,uDAAsB;2BAAqG,uDAAsB,uCAAsC,uDAAsB,4CAA2C,uDAAsB,0CAAyC,uDAAsB;YAAyD,uDAAsB;sBAAwF,uDAAsB;;UADlpuB"}

package/dist/esm/utils/getPromptVersionLike.js

@@ -0,0 +1,50 @@
+import invariant from "tiny-invariant";
+import { createClient } from "../client.js";
+/**
+ * Get a prompt from the Phoenix API.
+ *
+ * if the input is a prompt id, fetch the latest prompt version from the client.
+ * if the input is a prompt version id, fetch that prompt version.
+ * if the input is a prompt tag and name, fetch the prompt version that has that tag and name.
+ * if the input is a prompt name, fetch the latest prompt version from the client.
+ */
+export async function getPromptBySelector({ client: _client, prompt, }) {
+    try {
+        const client = _client ?? createClient();
+        if ("promptId" in prompt) {
+            throw new Error("Prompt by id not implemented");
+        }
+        if ("versionId" in prompt) {
+            const response = await client.GET(`/v1/prompt_versions/{prompt_version_id}`, {
+                params: { path: { prompt_version_id: prompt.versionId } },
+            });
+            invariant(response.data?.data, `Prompt version ${prompt.versionId} not found`);
+            return response.data.data;
+        }
+        if ("tag" in prompt && "name" in prompt) {
+            const response = await client.GET(`/v1/prompts/{prompt_identifier}/tags/{tag_name}`, {
+                params: {
+                    path: { prompt_identifier: prompt.name, tag_name: prompt.tag },
+                },
+            });
+            invariant(response.data?.data, `Prompt tag ${prompt.tag} not found`);
+            return response.data.data;
+        }
+        if ("name" in prompt) {
+            const response = await client.GET(`/v1/prompts/{prompt_identifier}/latest`, {
+                params: {
+                    path: { prompt_identifier: prompt.name },
+                },
+            });
+            invariant(response.data?.data, `Prompt ${prompt.name} not found`);
+            return response.data.data;
+        }
+        throw new Error("Invalid prompt");
+    }
+    catch (error) {
+        // eslint-disable-next-line no-console
+        console.error(error);
+        return null;
+    }
+}
+//# sourceMappingURL=getPromptVersionLike.js.map

package/dist/esm/utils/getPromptVersionLike.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPromptVersionLike.js","sourceRoot":"","sources":["../../../src/utils/getPromptVersionLike.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AASzC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,EACxC,MAAM,EAAE,OAAO,EACf,MAAM,GACoB;IAC1B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;QACzC,IAAI,UAAU,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,WAAW,IAAI,MAAM,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAC/B,yCAAyC,EACzC;gBACE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,iBAAiB,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE;aAC1D,CACF,CAAC;YACF,SAAS,CACP,QAAQ,CAAC,IAAI,EAAE,IAAI,EACnB,kBAAkB,MAAM,CAAC,SAAS,YAAY,CAC/C,CAAC;YACF,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,CAAC;QACD,IAAI,KAAK,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAC/B,iDAAiD,EACjD;gBACE,MAAM,EAAE;oBACN,IAAI,EAAE,EAAE,iBAAiB,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE;iBAC/D;aACF,CACF,CAAC;YACF,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC;YACrE,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,CAAC;QACD,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAC/B,wCAAwC,EACxC;gBACE,MAAM,EAAE;oBACN,IAAI,EAAE,EAAE,iBAAiB,EAAE,MAAM,CAAC,IAAI,EAAE;iBACzC;aACF,CACF,CAAC;YACF,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,MAAM,CAAC,IAAI,YAAY,CAAC,CAAC;YAClE,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,5 @@
+/**
+ * A type guard for checking if a value is an object
+ */
+export declare function isObject(value: unknown): value is object;
+//# sourceMappingURL=isObject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"isObject.d.ts","sourceRoot":"","sources":["../../../src/utils/isObject.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD"}

package/dist/esm/utils/isObject.js

@@ -0,0 +1,7 @@
+/**
+ * A type guard for checking if a value is an object
+ */
+export function isObject(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=isObject.js.map

package/dist/esm/utils/isObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isObject.js","sourceRoot":"","sources":["../../../src/utils/isObject.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * A logger that does nothing
+ */
+export declare const noopLogger: {
+    info: () => undefined;
+    error: () => undefined;
+    log: () => undefined;
+};
+//# sourceMappingURL=noopLogger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"noopLogger.d.ts","sourceRoot":"","sources":["../../../src/utils/noopLogger.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,UAAU;;;;CAIL,CAAC"}

package/dist/esm/utils/noopLogger.js

@@ -0,0 +1,9 @@
+/**
+ * A logger that does nothing
+ */
+export const noopLogger = {
+    info: () => undefined,
+    error: () => undefined,
+    log: () => undefined,
+};
+//# sourceMappingURL=noopLogger.js.map

package/dist/esm/utils/noopLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noopLogger.js","sourceRoot":"","sources":["../../../src/utils/noopLogger.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;IACtB,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS;CACJ,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * Safely parse a JSON string
+ *
+ * @param str - The string to parse
+ * @returns An object containing both the parsed JSON and the error if there was one
+ */
+export declare function safelyParseJSON(str: string): {
+    json: any;
+    parseError?: undefined;
+} | {
+    json: null;
+    parseError: unknown;
+};
+//# sourceMappingURL=safelyParseJSON.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safelyParseJSON.d.ts","sourceRoot":"","sources":["../../../src/utils/safelyParseJSON.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM;;;;;;EAM1C"}

package/dist/esm/utils/safelyParseJSON.js

@@ -0,0 +1,15 @@
+/**
+ * Safely parse a JSON string
+ *
+ * @param str - The string to parse
+ * @returns An object containing both the parsed JSON and the error if there was one
+ */
+export function safelyParseJSON(str) {
+    try {
+        return { json: JSON.parse(str) };
+    }
+    catch (e) {
+        return { json: null, parseError: e };
+    }
+}
+//# sourceMappingURL=safelyParseJSON.js.map

package/dist/esm/utils/safelyParseJSON.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safelyParseJSON.js","sourceRoot":"","sources":["../../../src/utils/safelyParseJSON.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACnC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IACvC,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * Safely stringify a JSON object
+ *
+ * @param args - The arguments to pass to JSON.stringify
+ * @returns An object containing both the stringified JSON and the error if there was one
+ */
+export declare function safelyStringifyJSON(...args: Parameters<typeof JSON.stringify>): {
+    json: string;
+    stringifyError?: undefined;
+} | {
+    json: null;
+    stringifyError: unknown;
+};
+//# sourceMappingURL=safelyStringifyJSON.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safelyStringifyJSON.d.ts","sourceRoot":"","sources":["../../../src/utils/safelyStringifyJSON.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC;;;;;;EAO3C"}

package/dist/esm/utils/safelyStringifyJSON.js

@@ -0,0 +1,15 @@
+/**
+ * Safely stringify a JSON object
+ *
+ * @param args - The arguments to pass to JSON.stringify
+ * @returns An object containing both the stringified JSON and the error if there was one
+ */
+export function safelyStringifyJSON(...args) {
+    try {
+        return { json: JSON.stringify(...args) };
+    }
+    catch (e) {
+        return { json: null, stringifyError: e };
+    }
+}
+//# sourceMappingURL=safelyStringifyJSON.js.map

package/dist/esm/utils/safelyStringifyJSON.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safelyStringifyJSON.js","sourceRoot":"","sources":["../../../src/utils/safelyStringifyJSON.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAG,IAAuC;IAE1C,IAAI,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;IAC3C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;IAC3C,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,17 @@
+import { z } from "zod";
+/**
+ * Simple utility to check if two types are exactly equivalent
+ */
+export type AssertEqual<T, U> = (<V>() => V extends T ? 1 : 2) extends <V>() => V extends U ? 1 : 2 ? true : false;
+/**
+ * Zod utility to check if a schema is defined correctly against a given type
+ *
+ * @see https://github.com/colinhacks/zod/issues/372#issuecomment-2445439772
+ */
+export declare const schemaMatches: <T>() => <S extends z.ZodType<T, z.ZodTypeDef, unknown>>(schema: AssertEqual<S["_output"], T> extends true ? S : S & {
+    "types do not match": {
+        expected: T;
+        received: S["_output"];
+    };
+}) => S;
+//# sourceMappingURL=schemaMatches.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemaMatches.d.ts","sourceRoot":"","sources":["../../../src/utils/schemaMatches.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,IAC1B,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,GAC/D,IAAI,GACJ,KAAK,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,aAAa,GACvB,CAAC,QACD,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,UACpC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,SAAS,IAAI,GAC7C,CAAC,GACD,CAAC,GAAG;IACF,oBAAoB,EAAE;QACpB,QAAQ,EAAE,CAAC,CAAC;QACZ,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;KACxB,CAAC;CACH,KACJ,CAEF,CAAC"}

package/dist/esm/utils/schemaMatches.js

@@ -0,0 +1,9 @@
+/**
+ * Zod utility to check if a schema is defined correctly against a given type
+ *
+ * @see https://github.com/colinhacks/zod/issues/372#issuecomment-2445439772
+ */
+export const schemaMatches = () => (schema) => {
+    return schema;
+};
+//# sourceMappingURL=schemaMatches.js.map

package/dist/esm/utils/schemaMatches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaMatches.js","sourceRoot":"","sources":["../../../src/utils/schemaMatches.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GACxB,GAAM,EAAE,CACR,CACE,MAOK,EACF,EAAE;IACL,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}