@arizeai/phoenix-client 7.12.0 → 7.14.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @arizeai/phoenix-client
 
+## 7.14.0
+
+### Minor Changes
+
+- aab229f: Add `createDatasetSplit`, `updateDatasetSplit`, and `deleteDatasetSplit` helpers to the `datasets` subpath. The helpers select datasets by name or GlobalID, create splits on existing datasets, partially update split fields, add or remove example memberships idempotently, and delete splits without deleting their examples. They require Phoenix server 19.20.0 or newer.
+  
+  Also export the generated `DatasetSplit` response type and a `DatasetIdentifier` selector type from the datasets subpath.
+
+## 7.13.0
+
+### Minor Changes
+
+- c282563: Add an `upsertOrDeleteSecrets` helper to the new `secrets` subpath. It atomically creates, updates, or deletes ordered key/value-or-null batches through `PUT /v1/secrets`, returns only the affected key names, and keeps submitted values out of helper output and error messages.
+
 ## 7.12.0
 
 ### Minor Changes

package/README.md

@@ -797,6 +797,33 @@ await setProjectRetentionPolicy({
 
 This helper only changes a project's assignment to an existing policy. Creating, reading, updating, and deleting retention policies is outside the scope of the TypeScript projects helper.
 
+## Secrets
+
+Use the `secrets` entrypoint to atomically create, update, or delete encrypted
+provider credentials. A string value creates or updates a key, while `null`
+deletes it. Duplicate keys use the last occurrence in the batch. The result
+contains only changed key names and never returns secret values.
+
+```ts
+import { upsertOrDeleteSecrets } from "@arizeai/phoenix-client/secrets";
+
+const apiKey = process.env.OPENAI_API_KEY;
+if (!apiKey) throw new Error("OPENAI_API_KEY is required");
+
+const result = await upsertOrDeleteSecrets({
+  secrets: [
+    { key: "OPENAI_API_KEY", value: apiKey },
+    { key: "OLD_PROVIDER_API_KEY", value: null },
+  ],
+});
+
+console.log(result.upsertedKeys);
+console.log(result.deletedKeys);
+```
+
+Managing secrets requires an administrator when Phoenix authentication is
+enabled. Avoid logging the request batch or otherwise retaining its values.
+
 ## Examples
 
 To run examples, install dependencies using `pnpm` and run:

package/dist/esm/__generated__/api/v1.d.ts

@@ -2678,7 +2678,7 @@ export interface components {
             };
             /**
              * Example Ids
-             * @description Optional dataset example IDs (GlobalIDs) to seed the split with. Each example must belong to this dataset. Omit to create an empty split.
+             * @description Optional dataset example identifiers (GlobalIDs or user-provided IDs) to seed the split with. Each example must belong to this dataset. Omit to create an empty split.
              */
             example_ids?: string[];
         };
@@ -6715,12 +6715,12 @@ export interface components {
             } | null;
             /**
              * Add Example Ids
-             * @description Dataset example IDs (GlobalIDs) to add to the split. Each example must belong to this dataset. Adding an example already in the split is a no-op.
+             * @description Dataset example identifiers (GlobalIDs or user-provided IDs) to add to the split. Each example must belong to this dataset. Adding an example already in the split is a no-op.
              */
             add_example_ids?: string[];
             /**
              * Remove Example Ids
-             * @description Dataset example IDs (GlobalIDs) to remove from the split.
+             * @description Dataset example identifiers (GlobalIDs or user-provided IDs) to remove from the split.
              */
             remove_example_ids?: string[];
         };

package/dist/esm/constants/serverRequirements.d.ts

@@ -29,6 +29,9 @@ export declare const LIST_SESSIONS_FILTER_EXPRESSION: ParameterRequirement;
 export declare const TRANSFER_TRACES: RouteRequirement;
 export declare const GET_SPANS_BY_ATTRIBUTE: ParameterRequirement;
 export declare const DATASET_UPLOAD_EXAMPLE_IDS: ParameterRequirement;
+export declare const CREATE_DATASET_SPLIT: RouteRequirement;
+export declare const UPDATE_DATASET_SPLIT: RouteRequirement;
+export declare const DELETE_DATASET_SPLIT: RouteRequirement;
 export declare const ADD_TRACE_NOTE_IDENTIFIER: ParameterRequirement;
 export declare const ADD_SPAN_NOTE_IDENTIFIER: ParameterRequirement;
 export declare const ADD_SESSION_NOTE_IDENTIFIER: ParameterRequirement;

package/dist/esm/constants/serverRequirements.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serverRequirements.d.ts","sourceRoot":"","sources":["../../../src/constants/serverRequirements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,WAAW,EAAE,gBAKzB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,gBAK5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,gBAK7B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,gBAKnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,gBAK/B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,gBAK5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,gBAK9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,oBAMjC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,oBAMhC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,oBAM/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,gBAKjC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,oBAQhC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,oBAM1C,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,oBAM7C,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,gBAK7B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,oBAMpC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,oBAMxC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,oBAMvC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,oBAMtC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,oBAMzC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,gBAK3B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,gBAK1B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,gBAKlC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,gBAKhC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,gBAK/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,gBAKjC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,gBAKnC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,gBAKxC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,gBAKhC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,gBAKpC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,qBAAqB,EA+BnD,CAAC"}
+{"version":3,"file":"serverRequirements.d.ts","sourceRoot":"","sources":["../../../src/constants/serverRequirements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,WAAW,EAAE,gBAKzB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,gBAK5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,gBAK7B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,gBAKnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,gBAK/B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,gBAK5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,gBAK9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,oBAMjC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,oBAMhC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,oBAM/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,gBAKjC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,oBAQhC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,oBAM1C,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,oBAM7C,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,gBAK7B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,oBAMpC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,oBAMxC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,gBAKlC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,gBAKlC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,gBAKlC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,oBAMvC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,oBAMtC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,oBAMzC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,gBAK3B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,gBAK1B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,gBAKlC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,gBAKhC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,gBAK/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,gBAKjC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,gBAKnC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,gBAKxC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,gBAKhC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,gBAKpC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,qBAAqB,EAkCnD,CAAC"}

package/dist/esm/constants/serverRequirements.js

@@ -122,6 +122,24 @@ export const DATASET_UPLOAD_EXAMPLE_IDS = {
     route: "POST /v1/datasets/upload",
     minServerVersion: [15, 0, 0],
 };
+export const CREATE_DATASET_SPLIT = {
+    kind: "route",
+    method: "POST",
+    path: "/v1/datasets/{dataset_identifier}/splits",
+    minServerVersion: [19, 20, 0],
+};
+export const UPDATE_DATASET_SPLIT = {
+    kind: "route",
+    method: "PATCH",
+    path: "/v1/datasets/{dataset_identifier}/splits/{split_id}",
+    minServerVersion: [19, 20, 0],
+};
+export const DELETE_DATASET_SPLIT = {
+    kind: "route",
+    method: "DELETE",
+    path: "/v1/datasets/{dataset_identifier}/splits/{split_id}",
+    minServerVersion: [19, 20, 0],
+};
 export const ADD_TRACE_NOTE_IDENTIFIER = {
     kind: "parameter",
     parameterName: "identifier",
@@ -227,6 +245,9 @@ export const ALL_REQUIREMENTS = [
     LIST_SESSIONS_FILTER_EXPRESSION,
     TRANSFER_TRACES,
     DATASET_UPLOAD_EXAMPLE_IDS,
+    CREATE_DATASET_SPLIT,
+    UPDATE_DATASET_SPLIT,
+    DELETE_DATASET_SPLIT,
     ADD_TRACE_NOTE_IDENTIFIER,
     ADD_SPAN_NOTE_IDENTIFIER,
     ADD_SESSION_NOTE_IDENTIFIER,

package/dist/esm/constants/serverRequirements.js.map

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

package/dist/esm/datasets/createDatasetSplit.d.ts

@@ -0,0 +1,39 @@
+import type { components } from "../__generated__/api/v1.js";
+import type { ClientFn } from "../types/core.js";
+import type { DatasetIdentifier, DatasetSplit } from "../types/datasets.js";
+type CreateDatasetSplitRequestBody = components["schemas"]["CreateDatasetSplitRequestBody"];
+/** Parameters for creating a dataset split. */
+export interface CreateDatasetSplitParams extends ClientFn {
+    /** The dataset, selected by name or GlobalID. */
+    dataset: DatasetIdentifier;
+    /** A unique name for the split. */
+    name: CreateDatasetSplitRequestBody["name"];
+    /** An optional description of the split. */
+    description?: CreateDatasetSplitRequestBody["description"];
+    /** An optional hex color for the split. */
+    color?: CreateDatasetSplitRequestBody["color"];
+    /** Arbitrary JSON metadata for the split. */
+    metadata?: CreateDatasetSplitRequestBody["metadata"];
+    /** Dataset example GlobalIDs or user-provided IDs with which to seed the split. */
+    exampleIds?: CreateDatasetSplitRequestBody["example_ids"];
+}
+/**
+ * Create a split on an existing dataset.
+ *
+ * @param params - The split to create.
+ * @param params.client - Optional Phoenix client instance.
+ * @param params.dataset - The dataset, selected by name or GlobalID.
+ * @param params.name - A unique name for the split.
+ * @param params.description - An optional description of the split.
+ * @param params.color - An optional hex color for the split.
+ * @param params.metadata - Arbitrary JSON metadata for the split.
+ * @param params.exampleIds - Dataset example GlobalIDs or user-provided IDs with which to seed the split.
+ * @returns The created dataset split.
+ * @throws {HttpError} If the dataset or an example does not exist, the name is
+ * already in use, or the request is invalid.
+ *
+ * @requires Phoenix server >= 19.20.0
+ */
+export declare function createDatasetSplit({ client: _client, dataset, name, description, color, metadata, exampleIds, }: CreateDatasetSplitParams): Promise<DatasetSplit>;
+export {};
+//# sourceMappingURL=createDatasetSplit.d.ts.map

package/dist/esm/datasets/createDatasetSplit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDatasetSplit.d.ts","sourceRoot":"","sources":["../../../src/datasets/createDatasetSplit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIzE,KAAK,6BAA6B,GAChC,UAAU,CAAC,SAAS,CAAC,CAAC,+BAA+B,CAAC,CAAC;AAIzD,+CAA+C;AAC/C,MAAM,WAAW,wBAAyB,SAAQ,QAAQ;IACxD,iDAAiD;IACjD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,mCAAmC;IACnC,IAAI,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC;IAC5C,4CAA4C;IAC5C,WAAW,CAAC,EAAE,6BAA6B,CAAC,aAAa,CAAC,CAAC;IAC3D,2CAA2C;IAC3C,KAAK,CAAC,EAAE,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAC/C,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,6BAA6B,CAAC,UAAU,CAAC,CAAC;IACrD,mFAAmF;IACnF,UAAU,CAAC,EAAE,6BAA6B,CAAC,aAAa,CAAC,CAAC;CAC3D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,MAAM,EAAE,OAAO,EACf,OAAO,EACP,IAAI,EACJ,WAAW,EACX,KAAK,EACL,QAAQ,EACR,UAAU,GACX,EAAE,wBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,CAuBlD"}

package/dist/esm/datasets/createDatasetSplit.js

@@ -0,0 +1,42 @@
+import invariant from "tiny-invariant";
+import { createClient } from "../client.js";
+import { CREATE_DATASET_SPLIT } from "../constants/serverRequirements.js";
+import { ensureServerCapability } from "../utils/serverVersionUtils.js";
+import { resolveDatasetIdentifier } from "./resolveDatasetIdentifier.js";
+/**
+ * Create a split on an existing dataset.
+ *
+ * @param params - The split to create.
+ * @param params.client - Optional Phoenix client instance.
+ * @param params.dataset - The dataset, selected by name or GlobalID.
+ * @param params.name - A unique name for the split.
+ * @param params.description - An optional description of the split.
+ * @param params.color - An optional hex color for the split.
+ * @param params.metadata - Arbitrary JSON metadata for the split.
+ * @param params.exampleIds - Dataset example GlobalIDs or user-provided IDs with which to seed the split.
+ * @returns The created dataset split.
+ * @throws {HttpError} If the dataset or an example does not exist, the name is
+ * already in use, or the request is invalid.
+ *
+ * @requires Phoenix server >= 19.20.0
+ */
+export async function createDatasetSplit({ client: _client, dataset, name, description, color, metadata, exampleIds, }) {
+    const client = _client ?? createClient();
+    await ensureServerCapability({ client, requirement: CREATE_DATASET_SPLIT });
+    const datasetIdentifier = resolveDatasetIdentifier(dataset);
+    const body = {
+        name,
+        ...(description !== undefined ? { description } : {}),
+        ...(color !== undefined ? { color } : {}),
+        ...(metadata !== undefined ? { metadata } : {}),
+        ...(exampleIds !== undefined ? { example_ids: exampleIds } : {}),
+    };
+    const response = await client.POST("/v1/datasets/{dataset_identifier}/splits", {
+        params: { path: { dataset_identifier: datasetIdentifier } },
+        body,
+    });
+    const responseBody = response.data;
+    invariant(responseBody?.data, "Failed to create dataset split");
+    return responseBody.data;
+}
+//# sourceMappingURL=createDatasetSplit.js.map

package/dist/esm/datasets/createDatasetSplit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDatasetSplit.js","sourceRoot":"","sources":["../../../src/datasets/createDatasetSplit.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAuBtE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,MAAM,EAAE,OAAO,EACf,OAAO,EACP,IAAI,EACJ,WAAW,EACX,KAAK,EACL,QAAQ,EACR,UAAU,GACe;IACzB,MAAM,MAAM,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;IACzC,MAAM,sBAAsB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAC5E,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAE5D,MAAM,IAAI,GAAkC;QAC1C,IAAI;QACJ,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,0CAA0C,EAC1C;QACE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,EAAE;QAC3D,IAAI;KACL,CACF,CAAC;IACF,MAAM,YAAY,GAChB,QAAQ,CAAC,IAAI,CAAC;IAChB,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,gCAAgC,CAAC,CAAC;IAChE,OAAO,YAAY,CAAC,IAAI,CAAC;AAC3B,CAAC"}

package/dist/esm/datasets/deleteDatasetSplit.d.ts

@@ -0,0 +1,24 @@
+import type { ClientFn } from "../types/core.js";
+import type { DatasetIdentifier } from "../types/datasets.js";
+/** Parameters for deleting a dataset split. */
+export interface DeleteDatasetSplitParams extends ClientFn {
+    /** The dataset, selected by name or GlobalID. */
+    dataset: DatasetIdentifier;
+    /** The dataset split GlobalID. */
+    splitId: string;
+}
+/**
+ * Delete a dataset split and its memberships without deleting its examples.
+ *
+ * @param params - The split to delete.
+ * @param params.client - Optional Phoenix client instance.
+ * @param params.dataset - The dataset, selected by name or GlobalID.
+ * @param params.splitId - The dataset split GlobalID.
+ * @returns A promise that resolves once the split is deleted.
+ * @throws {HttpError} If the dataset or split does not exist, or the split ID
+ * is invalid.
+ *
+ * @requires Phoenix server >= 19.20.0
+ */
+export declare function deleteDatasetSplit({ client: _client, dataset, splitId, }: DeleteDatasetSplitParams): Promise<void>;
+//# sourceMappingURL=deleteDatasetSplit.d.ts.map

package/dist/esm/datasets/deleteDatasetSplit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteDatasetSplit.d.ts","sourceRoot":"","sources":["../../../src/datasets/deleteDatasetSplit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,+CAA+C;AAC/C,MAAM,WAAW,wBAAyB,SAAQ,QAAQ;IACxD,iDAAiD;IACjD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,MAAM,EAAE,OAAO,EACf,OAAO,EACP,OAAO,GACR,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAa1C"}

package/dist/esm/datasets/deleteDatasetSplit.js

@@ -0,0 +1,31 @@
+import { createClient } from "../client.js";
+import { DELETE_DATASET_SPLIT } from "../constants/serverRequirements.js";
+import { ensureServerCapability } from "../utils/serverVersionUtils.js";
+import { resolveDatasetIdentifier } from "./resolveDatasetIdentifier.js";
+/**
+ * Delete a dataset split and its memberships without deleting its examples.
+ *
+ * @param params - The split to delete.
+ * @param params.client - Optional Phoenix client instance.
+ * @param params.dataset - The dataset, selected by name or GlobalID.
+ * @param params.splitId - The dataset split GlobalID.
+ * @returns A promise that resolves once the split is deleted.
+ * @throws {HttpError} If the dataset or split does not exist, or the split ID
+ * is invalid.
+ *
+ * @requires Phoenix server >= 19.20.0
+ */
+export async function deleteDatasetSplit({ client: _client, dataset, splitId, }) {
+    const client = _client ?? createClient();
+    await ensureServerCapability({ client, requirement: DELETE_DATASET_SPLIT });
+    const datasetIdentifier = resolveDatasetIdentifier(dataset);
+    await client.DELETE("/v1/datasets/{dataset_identifier}/splits/{split_id}", {
+        params: {
+            path: {
+                dataset_identifier: datasetIdentifier,
+                split_id: splitId,
+            },
+        },
+    });
+}
+//# sourceMappingURL=deleteDatasetSplit.js.map

package/dist/esm/datasets/deleteDatasetSplit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteDatasetSplit.js","sourceRoot":"","sources":["../../../src/datasets/deleteDatasetSplit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAUtE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,MAAM,EAAE,OAAO,EACf,OAAO,EACP,OAAO,GACkB;IACzB,MAAM,MAAM,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;IACzC,MAAM,sBAAsB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAC5E,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAE5D,MAAM,MAAM,CAAC,MAAM,CAAC,qDAAqD,EAAE;QACzE,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,kBAAkB,EAAE,iBAAiB;gBACrC,QAAQ,EAAE,OAAO;aAClB;SACF;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/datasets/index.d.ts

@@ -1,6 +1,10 @@
 export * from "./createDataset.js";
+export * from "./createDatasetSplit.js";
+export * from "./deleteDatasetSplit.js";
 export * from "./getDataset.js";
 export * from "./getDatasetExamples.js";
 export * from "./appendDatasetExamples.js";
 export * from "./getDatasetInfo.js";
+export * from "./updateDatasetSplit.js";
+export type { DatasetIdentifier, DatasetSplit } from "../types/datasets.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/datasets/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/datasets/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/datasets/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/esm/datasets/index.js

@@ -1,6 +1,9 @@
 export * from "./createDataset.js";
+export * from "./createDatasetSplit.js";
+export * from "./deleteDatasetSplit.js";
 export * from "./getDataset.js";
 export * from "./getDatasetExamples.js";
 export * from "./appendDatasetExamples.js";
 export * from "./getDatasetInfo.js";
+export * from "./updateDatasetSplit.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/datasets/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/datasets/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/datasets/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/dist/esm/datasets/resolveDatasetIdentifier.d.ts

@@ -0,0 +1,4 @@
+import type { DatasetIdentifier } from "../types/datasets.js";
+/** Resolve a typed dataset selector to the REST path identifier. */
+export declare function resolveDatasetIdentifier(dataset: DatasetIdentifier): string;
+//# sourceMappingURL=resolveDatasetIdentifier.d.ts.map

package/dist/esm/datasets/resolveDatasetIdentifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveDatasetIdentifier.d.ts","sourceRoot":"","sources":["../../../src/datasets/resolveDatasetIdentifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,oEAAoE;AACpE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAE3E"}

package/dist/esm/datasets/resolveDatasetIdentifier.js

@@ -0,0 +1,5 @@
+/** Resolve a typed dataset selector to the REST path identifier. */
+export function resolveDatasetIdentifier(dataset) {
+    return "datasetName" in dataset ? dataset.datasetName : dataset.datasetId;
+}
+//# sourceMappingURL=resolveDatasetIdentifier.js.map

package/dist/esm/datasets/resolveDatasetIdentifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveDatasetIdentifier.js","sourceRoot":"","sources":["../../../src/datasets/resolveDatasetIdentifier.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,MAAM,UAAU,wBAAwB,CAAC,OAA0B;IACjE,OAAO,aAAa,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;AAC5E,CAAC"}

package/dist/esm/datasets/updateDatasetSplit.d.ts

@@ -0,0 +1,48 @@
+import type { components } from "../__generated__/api/v1.js";
+import type { ClientFn } from "../types/core.js";
+import type { DatasetIdentifier, DatasetSplit } from "../types/datasets.js";
+type UpdateDatasetSplitRequestBody = components["schemas"]["UpdateDatasetSplitRequestBody"];
+/** Parameters for partially updating a dataset split. */
+export interface UpdateDatasetSplitParams extends ClientFn {
+    /** The dataset, selected by name or GlobalID. */
+    dataset: DatasetIdentifier;
+    /** The dataset split GlobalID. */
+    splitId: string;
+    /** A new unique name for the split. */
+    name?: UpdateDatasetSplitRequestBody["name"];
+    /** A new description, or null to clear it. */
+    description?: UpdateDatasetSplitRequestBody["description"];
+    /** A new hex color for the split. */
+    color?: UpdateDatasetSplitRequestBody["color"];
+    /** JSON metadata that replaces the existing metadata. */
+    metadata?: UpdateDatasetSplitRequestBody["metadata"];
+    /** Dataset example GlobalIDs or user-provided IDs to add. Existing memberships are no-ops. */
+    addExampleIds?: UpdateDatasetSplitRequestBody["add_example_ids"];
+    /** Dataset example GlobalIDs or user-provided IDs to remove. Missing memberships are no-ops. */
+    removeExampleIds?: UpdateDatasetSplitRequestBody["remove_example_ids"];
+}
+/**
+ * Partially update a dataset split and/or its example membership.
+ *
+ * Only provided fields change. Membership additions and removals are
+ * idempotent; if an example appears in both arrays, removal wins.
+ *
+ * @param params - The split fields and memberships to update.
+ * @param params.client - Optional Phoenix client instance.
+ * @param params.dataset - The dataset, selected by name or GlobalID.
+ * @param params.splitId - The dataset split GlobalID.
+ * @param params.name - A new unique name for the split.
+ * @param params.description - A new description, or null to clear it.
+ * @param params.color - A new hex color for the split.
+ * @param params.metadata - JSON metadata that replaces the existing metadata.
+ * @param params.addExampleIds - Dataset example GlobalIDs or user-provided IDs to add.
+ * @param params.removeExampleIds - Dataset example GlobalIDs or user-provided IDs to remove.
+ * @returns The updated dataset split.
+ * @throws {HttpError} If the dataset, split, or an example does not exist, the
+ * name is already in use, or the request is invalid.
+ *
+ * @requires Phoenix server >= 19.20.0
+ */
+export declare function updateDatasetSplit({ client: _client, dataset, splitId, name, description, color, metadata, addExampleIds, removeExampleIds, }: UpdateDatasetSplitParams): Promise<DatasetSplit>;
+export {};
+//# sourceMappingURL=updateDatasetSplit.d.ts.map

package/dist/esm/datasets/updateDatasetSplit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateDatasetSplit.d.ts","sourceRoot":"","sources":["../../../src/datasets/updateDatasetSplit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIzE,KAAK,6BAA6B,GAChC,UAAU,CAAC,SAAS,CAAC,CAAC,+BAA+B,CAAC,CAAC;AAIzD,yDAAyD;AACzD,MAAM,WAAW,wBAAyB,SAAQ,QAAQ;IACxD,iDAAiD;IACjD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,CAAC,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC;IAC7C,8CAA8C;IAC9C,WAAW,CAAC,EAAE,6BAA6B,CAAC,aAAa,CAAC,CAAC;IAC3D,qCAAqC;IACrC,KAAK,CAAC,EAAE,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAC/C,yDAAyD;IACzD,QAAQ,CAAC,EAAE,6BAA6B,CAAC,UAAU,CAAC,CAAC;IACrD,8FAA8F;IAC9F,aAAa,CAAC,EAAE,6BAA6B,CAAC,iBAAiB,CAAC,CAAC;IACjE,gGAAgG;IAChG,gBAAgB,CAAC,EAAE,6BAA6B,CAAC,oBAAoB,CAAC,CAAC;CACxE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,MAAM,EAAE,OAAO,EACf,OAAO,EACP,OAAO,EACP,IAAI,EACJ,WAAW,EACX,KAAK,EACL,QAAQ,EACR,aAAa,EACb,gBAAgB,GACjB,EAAE,wBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,CA+BlD"}

package/dist/esm/datasets/updateDatasetSplit.js

@@ -0,0 +1,55 @@
+import invariant from "tiny-invariant";
+import { createClient } from "../client.js";
+import { UPDATE_DATASET_SPLIT } from "../constants/serverRequirements.js";
+import { ensureServerCapability } from "../utils/serverVersionUtils.js";
+import { resolveDatasetIdentifier } from "./resolveDatasetIdentifier.js";
+/**
+ * Partially update a dataset split and/or its example membership.
+ *
+ * Only provided fields change. Membership additions and removals are
+ * idempotent; if an example appears in both arrays, removal wins.
+ *
+ * @param params - The split fields and memberships to update.
+ * @param params.client - Optional Phoenix client instance.
+ * @param params.dataset - The dataset, selected by name or GlobalID.
+ * @param params.splitId - The dataset split GlobalID.
+ * @param params.name - A new unique name for the split.
+ * @param params.description - A new description, or null to clear it.
+ * @param params.color - A new hex color for the split.
+ * @param params.metadata - JSON metadata that replaces the existing metadata.
+ * @param params.addExampleIds - Dataset example GlobalIDs or user-provided IDs to add.
+ * @param params.removeExampleIds - Dataset example GlobalIDs or user-provided IDs to remove.
+ * @returns The updated dataset split.
+ * @throws {HttpError} If the dataset, split, or an example does not exist, the
+ * name is already in use, or the request is invalid.
+ *
+ * @requires Phoenix server >= 19.20.0
+ */
+export async function updateDatasetSplit({ client: _client, dataset, splitId, name, description, color, metadata, addExampleIds, removeExampleIds, }) {
+    const client = _client ?? createClient();
+    await ensureServerCapability({ client, requirement: UPDATE_DATASET_SPLIT });
+    const datasetIdentifier = resolveDatasetIdentifier(dataset);
+    const body = {
+        ...(name !== undefined ? { name } : {}),
+        ...(description !== undefined ? { description } : {}),
+        ...(color !== undefined ? { color } : {}),
+        ...(metadata !== undefined ? { metadata } : {}),
+        ...(addExampleIds !== undefined ? { add_example_ids: addExampleIds } : {}),
+        ...(removeExampleIds !== undefined
+            ? { remove_example_ids: removeExampleIds }
+            : {}),
+    };
+    const response = await client.PATCH("/v1/datasets/{dataset_identifier}/splits/{split_id}", {
+        params: {
+            path: {
+                dataset_identifier: datasetIdentifier,
+                split_id: splitId,
+            },
+        },
+        body,
+    });
+    const responseBody = response.data;
+    invariant(responseBody?.data, "Failed to update dataset split");
+    return responseBody.data;
+}
+//# sourceMappingURL=updateDatasetSplit.js.map

package/dist/esm/datasets/updateDatasetSplit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateDatasetSplit.js","sourceRoot":"","sources":["../../../src/datasets/updateDatasetSplit.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AA2BtE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,MAAM,EAAE,OAAO,EACf,OAAO,EACP,OAAO,EACP,IAAI,EACJ,WAAW,EACX,KAAK,EACL,QAAQ,EACR,aAAa,EACb,gBAAgB,GACS;IACzB,MAAM,MAAM,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;IACzC,MAAM,sBAAsB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAC5E,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAE5D,MAAM,IAAI,GAAkC;QAC1C,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,GAAG,CAAC,gBAAgB,KAAK,SAAS;YAChC,CAAC,CAAC,EAAE,kBAAkB,EAAE,gBAAgB,EAAE;YAC1C,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CACjC,qDAAqD,EACrD;QACE,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,kBAAkB,EAAE,iBAAiB;gBACrC,QAAQ,EAAE,OAAO;aAClB;SACF;QACD,IAAI;KACL,CACF,CAAC;IACF,MAAM,YAAY,GAChB,QAAQ,CAAC,IAAI,CAAC;IAChB,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,gCAAgC,CAAC,CAAC;IAChE,OAAO,YAAY,CAAC,IAAI,CAAC;AAC3B,CAAC"}

package/dist/esm/secrets/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./upsertOrDeleteSecrets.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/secrets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/secrets/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}

package/dist/esm/secrets/index.js

@@ -0,0 +1,2 @@
+export * from "./upsertOrDeleteSecrets.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/secrets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/secrets/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}

package/dist/esm/secrets/upsertOrDeleteSecrets.d.ts

@@ -0,0 +1,60 @@
+import type { ClientFn } from "../types/core.js";
+/**
+ * A secret to create, update, or delete.
+ */
+export interface SecretInput {
+    /** The environment-style key used to identify the secret. */
+    key: string;
+    /** A value to create or update, or `null` to delete the key. */
+    value: string | null;
+}
+/**
+ * Parameters for atomically updating secrets.
+ */
+export interface UpsertOrDeleteSecretsParams extends ClientFn {
+    /**
+     * Ordered secret updates. When a key occurs more than once, the server
+     * applies only its last occurrence.
+     */
+    secrets: SecretInput[];
+}
+/**
+ * The names of the keys changed by a secrets update.
+ *
+ * Secret values are intentionally excluded.
+ */
+export interface UpsertOrDeleteSecretsResult {
+    /** Keys that were created or updated. */
+    upsertedKeys: string[];
+    /** Keys that were deleted. */
+    deletedKeys: string[];
+}
+/**
+ * Atomically create, update, or delete a batch of Phoenix secrets.
+ *
+ * A non-null value creates or updates a secret, while `null` deletes it.
+ * Duplicate keys use the last occurrence in the batch. The result contains
+ * key names only; submitted values are never returned or logged.
+ *
+ * @param params - The secrets update.
+ * @param params.client - Optional Phoenix client instance.
+ * @param params.secrets - Ordered key/value-or-null updates.
+ * @returns The names of the keys that were upserted and deleted.
+ *
+ * @example
+ * ```ts
+ * import { upsertOrDeleteSecrets } from "@arizeai/phoenix-client/secrets";
+ *
+ * const apiKey = process.env.OPENAI_API_KEY;
+ * if (!apiKey) throw new Error("OPENAI_API_KEY is required");
+ *
+ * const result = await upsertOrDeleteSecrets({
+ *   secrets: [
+ *     { key: "OPENAI_API_KEY", value: apiKey },
+ *     { key: "OLD_PROVIDER_API_KEY", value: null },
+ *   ],
+ * });
+ * ```
+ */
+export declare function upsertOrDeleteSecrets({ client: _client, secrets, }: UpsertOrDeleteSecretsParams): Promise<UpsertOrDeleteSecretsResult>;
+//# sourceMappingURL=upsertOrDeleteSecrets.d.ts.map

package/dist/esm/secrets/upsertOrDeleteSecrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsertOrDeleteSecrets.d.ts","sourceRoot":"","sources":["../../../src/secrets/upsertOrDeleteSecrets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,QAAQ;IAC3D;;;OAGG;IACH,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yCAAyC;IACzC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,MAAM,EAAE,OAAO,EACf,OAAO,GACR,EAAE,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAoBpE"}

package/dist/esm/secrets/upsertOrDeleteSecrets.js

@@ -0,0 +1,47 @@
+import { createClient } from "../client.js";
+/**
+ * Atomically create, update, or delete a batch of Phoenix secrets.
+ *
+ * A non-null value creates or updates a secret, while `null` deletes it.
+ * Duplicate keys use the last occurrence in the batch. The result contains
+ * key names only; submitted values are never returned or logged.
+ *
+ * @param params - The secrets update.
+ * @param params.client - Optional Phoenix client instance.
+ * @param params.secrets - Ordered key/value-or-null updates.
+ * @returns The names of the keys that were upserted and deleted.
+ *
+ * @example
+ * ```ts
+ * import { upsertOrDeleteSecrets } from "@arizeai/phoenix-client/secrets";
+ *
+ * const apiKey = process.env.OPENAI_API_KEY;
+ * if (!apiKey) throw new Error("OPENAI_API_KEY is required");
+ *
+ * const result = await upsertOrDeleteSecrets({
+ *   secrets: [
+ *     { key: "OPENAI_API_KEY", value: apiKey },
+ *     { key: "OLD_PROVIDER_API_KEY", value: null },
+ *   ],
+ * });
+ * ```
+ */
+export async function upsertOrDeleteSecrets({ client: _client, secrets, }) {
+    const client = _client ?? createClient();
+    const { data, error } = await client.PUT("/v1/secrets", {
+        body: { secrets },
+    });
+    // Do not include the server error payload here: validation responses can be
+    // influenced by submitted data, which must never enter helper error text.
+    if (error) {
+        throw new Error("Failed to upsert or delete secrets");
+    }
+    if (!data?.data) {
+        throw new Error("Failed to upsert or delete secrets: no data returned");
+    }
+    return {
+        upsertedKeys: data.data.upserted_keys,
+        deletedKeys: data.data.deleted_keys,
+    };
+}
+//# sourceMappingURL=upsertOrDeleteSecrets.js.map

package/dist/esm/secrets/upsertOrDeleteSecrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsertOrDeleteSecrets.js","sourceRoot":"","sources":["../../../src/secrets/upsertOrDeleteSecrets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAoCzC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAC1C,MAAM,EAAE,OAAO,EACf,OAAO,GACqB;IAC5B,MAAM,MAAM,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;IACzC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE;QACtD,IAAI,EAAE,EAAE,OAAO,EAAE;KAClB,CAAC,CAAC;IAEH,4EAA4E;IAC5E,0EAA0E;IAC1E,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa;QACrC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY;KACpC,CAAC;AACJ,CAAC"}