@arizeai/phoenix-client 2.3.5 → 2.4.0

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

@@ -1,13 +1,19 @@
 import { Node } from "./core.js";
 /**
- * A dataset can be identified by its datasetId
- * TODO: add support for datasetVersionId via discriminated union
+ * A dataset can be identified by its datasetId, datasetName, or datasetVersionId
  */
 export type DatasetSelector = {
     datasetId: string;
 } | {
     datasetName: string;
 };
+/**
+ * Parameters for selecting a specific version of a dataset
+ */
+export interface DatasetVersionSelector {
+    dataset: DatasetSelector;
+    versionId?: string;
+}
 /**
  * Overview information about a dataset
  */
@@ -16,6 +22,14 @@ export interface DatasetInfo extends Node {
     description?: string | null;
     metadata?: Record<string, unknown>;
 }
+/**
+ * Information about a dataset version
+ */
+export interface DatasetVersionInfo extends Node {
+    description?: string | null;
+    metadata?: Record<string, unknown>;
+    createdAt: Date;
+}
 /**
  * A dataset's examples
  */
@@ -45,4 +59,10 @@ export interface ExampleWithId extends Example, Node {
  */
 export interface Dataset extends DatasetInfo, DatasetExamples, Node {
 }
+/**
+ * A dataset with its version information
+ */
+export interface DatasetWithVersion extends Dataset {
+    versionInfo: DatasetVersionInfo;
+}
 //# sourceMappingURL=datasets.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"datasets.d.ts","sourceRoot":"","sources":["../../../src/types/datasets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,IAAI;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,OAAO,EAAE,IAAI;IAClD,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,WAAW,EAAE,eAAe,EAAE,IAAI;CAAG"}
+{"version":3,"file":"datasets.d.ts","sourceRoot":"","sources":["../../../src/types/datasets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,IAAI;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI;IAC9C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,OAAO,EAAE,IAAI;IAClD,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,WAAW,EAAE,eAAe,EAAE,IAAI;CAAG;AAEtE;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,OAAO;IACjD,WAAW,EAAE,kBAAkB,CAAC;CACjC"}

package/dist/src/datasets/getDataset.d.ts

@@ -2,9 +2,12 @@ import { ClientFn } from "../types/core";
 import { DatasetSelector, Dataset } from "../types/datasets";
 export type GetDatasetParams = ClientFn & {
     dataset: DatasetSelector;
+    versionId?: string;
 };
 /**
- * Get dataset info and the examples from the latest version of the dataset
+ * Get dataset info and examples from the dataset
+ * @param dataset - Dataset selector (ID or name)
+ * @param versionId - Optional specific version ID (if omitted, returns data from the latest version)
  */
-export declare function getDataset({ client: _client, dataset, }: GetDatasetParams): Promise<Dataset>;
+export declare function getDataset({ client: _client, dataset, versionId, }: GetDatasetParams): Promise<Dataset>;
 //# sourceMappingURL=getDataset.d.ts.map

package/dist/src/datasets/getDataset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getDataset.d.ts","sourceRoot":"","sources":["../../../src/datasets/getDataset.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAI7D,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG;IACxC,OAAO,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,wBAAsB,UAAU,CAAC,EAC/B,MAAM,EAAE,OAAO,EACf,OAAO,GACR,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAUrC"}
+{"version":3,"file":"getDataset.d.ts","sourceRoot":"","sources":["../../../src/datasets/getDataset.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAI7D,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG;IACxC,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,EAC/B,MAAM,EAAE,OAAO,EACf,OAAO,EACP,SAAS,GACV,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAUrC"}

package/dist/src/datasets/getDataset.js

@@ -5,13 +5,15 @@ const client_1 = require("../client");
 const getDatasetExamples_1 = require("./getDatasetExamples");
 const getDatasetInfo_1 = require("./getDatasetInfo");
 /**
- * Get dataset info and the examples from the latest version of the dataset
+ * Get dataset info and examples from the dataset
+ * @param dataset - Dataset selector (ID or name)
+ * @param versionId - Optional specific version ID (if omitted, returns data from the latest version)
  */
-async function getDataset({ client: _client, dataset, }) {
+async function getDataset({ client: _client, dataset, versionId, }) {
     const client = _client || (0, client_1.createClient)();
     const [datasetInfo, datasetExamples] = await Promise.all([
         (0, getDatasetInfo_1.getDatasetInfo)({ client, dataset }),
-        (0, getDatasetExamples_1.getDatasetExamples)({ client, dataset }),
+        (0, getDatasetExamples_1.getDatasetExamples)({ client, dataset, versionId }),
     ]);
     return Object.assign(Object.assign({}, datasetInfo), datasetExamples);
 }

package/dist/src/datasets/getDataset.js.map

@@ -1 +1 @@
-{"version":3,"file":"getDataset.js","sourceRoot":"","sources":["../../../src/datasets/getDataset.ts"],"names":[],"mappings":";;AAaA,gCAaC;AA1BD,sCAAyC;AAGzC,6DAA0D;AAC1D,qDAAkD;AAMlD;;GAEG;AACI,KAAK,UAAU,UAAU,CAAC,EAC/B,MAAM,EAAE,OAAO,EACf,OAAO,GACU;IACjB,MAAM,MAAM,GAAG,OAAO,IAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,MAAM,CAAC,WAAW,EAAE,eAAe,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvD,IAAA,+BAAc,EAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACnC,IAAA,uCAAkB,EAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;KACxC,CAAC,CAAC;IACH,uCACK,WAAW,GACX,eAAe,EAClB;AACJ,CAAC"}
+{"version":3,"file":"getDataset.js","sourceRoot":"","sources":["../../../src/datasets/getDataset.ts"],"names":[],"mappings":";;AAgBA,gCAcC;AA9BD,sCAAyC;AAGzC,6DAA0D;AAC1D,qDAAkD;AAOlD;;;;GAIG;AACI,KAAK,UAAU,UAAU,CAAC,EAC/B,MAAM,EAAE,OAAO,EACf,OAAO,EACP,SAAS,GACQ;IACjB,MAAM,MAAM,GAAG,OAAO,IAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,MAAM,CAAC,WAAW,EAAE,eAAe,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvD,IAAA,+BAAc,EAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACnC,IAAA,uCAAkB,EAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;KACnD,CAAC,CAAC;IACH,uCACK,WAAW,GACX,eAAe,EAClB;AACJ,CAAC"}

package/dist/src/datasets/getDatasetExamples.d.ts

@@ -2,9 +2,12 @@ import { ClientFn } from "../types/core";
 import { DatasetSelector, DatasetExamples } from "../types/datasets";
 export type GetDatasetExamplesParams = ClientFn & {
     dataset: DatasetSelector;
+    versionId?: string;
 };
 /**
- * Get the latest examples from a dataset
+ * Get examples from a dataset
+ * @param dataset - Dataset selector (ID, name, or version ID)
+ * @param versionId - Optional specific version ID (ignored if dataset selector is datasetVersionId)
  */
-export declare function getDatasetExamples({ client: _client, dataset, }: GetDatasetExamplesParams): Promise<DatasetExamples>;
+export declare function getDatasetExamples({ client: _client, dataset, versionId, }: GetDatasetExamplesParams): Promise<DatasetExamples>;
 //# sourceMappingURL=getDatasetExamples.d.ts.map

package/dist/src/datasets/getDatasetExamples.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getDatasetExamples.d.ts","sourceRoot":"","sources":["../../../src/datasets/getDatasetExamples.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGrE,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG;IAChD,OAAO,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,MAAM,EAAE,OAAO,EACf,OAAO,GACR,EAAE,wBAAwB,GAAG,OAAO,CAAC,eAAe,CAAC,CA4BrD"}
+{"version":3,"file":"getDatasetExamples.d.ts","sourceRoot":"","sources":["../../../src/datasets/getDatasetExamples.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGrE,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG;IAChD,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,MAAM,EAAE,OAAO,EACf,OAAO,EACP,SAAS,GACV,EAAE,wBAAwB,GAAG,OAAO,CAAC,eAAe,CAAC,CAqCrD"}

package/dist/src/datasets/getDatasetExamples.js

@@ -8,9 +8,11 @@ const tiny_invariant_1 = __importDefault(require("tiny-invariant"));
 const client_1 = require("../client");
 const getDatasetInfoByName_1 = require("./getDatasetInfoByName");
 /**
- * Get the latest examples from a dataset
+ * Get examples from a dataset
+ * @param dataset - Dataset selector (ID, name, or version ID)
+ * @param versionId - Optional specific version ID (ignored if dataset selector is datasetVersionId)
  */
-async function getDatasetExamples({ client: _client, dataset, }) {
+async function getDatasetExamples({ client: _client, dataset, versionId, }) {
     var _a;
     const client = _client || (0, client_1.createClient)();
     let datasetId;
@@ -29,6 +31,11 @@ async function getDatasetExamples({ client: _client, dataset, }) {
             path: {
                 id: datasetId,
             },
+            query: versionId
+                ? {
+                    version_id: versionId,
+                }
+                : undefined,
         },
     });
     (0, tiny_invariant_1.default)((_a = response.data) === null || _a === void 0 ? void 0 : _a.data, "Failed to get dataset examples");

package/dist/src/datasets/getDatasetExamples.js.map

@@ -1 +1 @@
-{"version":3,"file":"getDatasetExamples.js","sourceRoot":"","sources":["../../../src/datasets/getDatasetExamples.ts"],"names":[],"mappings":";;;;;AAaA,gDA+BC;AA5CD,oEAAuC;AACvC,sCAAyC;AAGzC,iEAA8D;AAM9D;;GAEG;AACI,KAAK,UAAU,kBAAkB,CAAC,EACvC,MAAM,EAAE,OAAO,EACf,OAAO,GACkB;;IACzB,MAAM,MAAM,GAAG,OAAO,IAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,IAAI,SAAiB,CAAC;IACtB,IAAI,aAAa,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,MAAM,IAAA,2CAAoB,EAAC;YAC7C,MAAM;YACN,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;QACH,SAAS,GAAG,WAAW,CAAC,EAAE,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAChC,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,4BAA4B,EAAE;QAC9D,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,EAAE,EAAE,SAAS;aACd;SACF;KACF,CAAC,CAAC;IACH,IAAA,wBAAS,EAAC,MAAA,QAAQ,CAAC,IAAI,0CAAE,IAAI,EAAE,gCAAgC,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;IACxC,OAAO;QACL,SAAS,EAAE,YAAY,CAAC,UAAU;QAClC,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,iCAC5C,OAAO,KACV,SAAS,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IACvC,CAAC;KACJ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"getDatasetExamples.js","sourceRoot":"","sources":["../../../src/datasets/getDatasetExamples.ts"],"names":[],"mappings":";;;;;AAgBA,gDAyCC;AAzDD,oEAAuC;AACvC,sCAAyC;AAGzC,iEAA8D;AAO9D;;;;GAIG;AACI,KAAK,UAAU,kBAAkB,CAAC,EACvC,MAAM,EAAE,OAAO,EACf,OAAO,EACP,SAAS,GACgB;;IACzB,MAAM,MAAM,GAAG,OAAO,IAAI,IAAA,qBAAY,GAAE,CAAC;IAEzC,IAAI,SAAiB,CAAC;IAEtB,IAAI,aAAa,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,MAAM,IAAA,2CAAoB,EAAC;YAC7C,MAAM;YACN,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;QACH,SAAS,GAAG,WAAW,CAAC,EAAE,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAChC,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,4BAA4B,EAAE;QAC9D,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,EAAE,EAAE,SAAS;aACd;YACD,KAAK,EAAE,SAAS;gBACd,CAAC,CAAC;oBACE,UAAU,EAAE,SAAS;iBACtB;gBACH,CAAC,CAAC,SAAS;SACd;KACF,CAAC,CAAC;IAEH,IAAA,wBAAS,EAAC,MAAA,QAAQ,CAAC,IAAI,0CAAE,IAAI,EAAE,gCAAgC,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;IACxC,OAAO;QACL,SAAS,EAAE,YAAY,CAAC,UAAU;QAClC,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,iCAC5C,OAAO,KACV,SAAS,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IACvC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/src/datasets/getDatasetInfo.d.ts

@@ -6,6 +6,7 @@ export type GetDatasetInfoParams = ClientFn & {
 /**
  * Get an overview of the information in a dataset
  * Note: this does not include the examples contained in the dataset
+ * Dataset info is not version-specific, only examples are versioned
  */
 export declare function getDatasetInfo({ client: _client, dataset, }: GetDatasetInfoParams): Promise<DatasetInfo>;
 //# sourceMappingURL=getDatasetInfo.d.ts.map

package/dist/src/datasets/getDatasetInfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getDatasetInfo.d.ts","sourceRoot":"","sources":["../../../src/datasets/getDatasetInfo.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGjE,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG;IAC5C,OAAO,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,wBAAsB,cAAc,CAAC,EACnC,MAAM,EAAE,OAAO,EACf,OAAO,GACR,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CAwB7C"}
+{"version":3,"file":"getDatasetInfo.d.ts","sourceRoot":"","sources":["../../../src/datasets/getDatasetInfo.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGjE,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG;IAC5C,OAAO,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,EACnC,MAAM,EAAE,OAAO,EACf,OAAO,GACR,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CAyB7C"}

package/dist/src/datasets/getDatasetInfo.js

@@ -10,6 +10,7 @@ const getDatasetInfoByName_1 = require("./getDatasetInfoByName");
 /**
  * Get an overview of the information in a dataset
  * Note: this does not include the examples contained in the dataset
+ * Dataset info is not version-specific, only examples are versioned
  */
 async function getDatasetInfo({ client: _client, dataset, }) {
     var _a;

package/dist/src/datasets/getDatasetInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"getDatasetInfo.js","sourceRoot":"","sources":["../../../src/datasets/getDatasetInfo.ts"],"names":[],"mappings":";;;;;AAcA,wCA2BC;AAzCD,oEAAuC;AACvC,sCAAyC;AAGzC,iEAA8D;AAM9D;;;GAGG;AACI,KAAK,UAAU,cAAc,CAAC,EACnC,MAAM,EAAE,OAAO,EACf,OAAO,GACc;;IACrB,MAAM,MAAM,GAAG,OAAO,IAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,IAAI,aAAa,IAAI,OAAO,EAAE,CAAC;QAC7B,OAAO,MAAM,IAAA,2CAAoB,EAAC;YAChC,MAAM;YACN,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,mBAAmB,EAAE;QAC5D,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,EAAE,EAAE,OAAO,CAAC,SAAS;aACtB;SACF;KACF,CAAC,CAAC;IACH,IAAA,wBAAS,EAAC,MAAA,eAAe,CAAC,IAAI,0CAAE,IAAI,EAAE,4BAA4B,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9C,OAAO;QACL,EAAE,EAAE,WAAW,CAAC,EAAE;QAClB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,SAAS;QACjD,QAAQ,EAAE,WAAW,CAAC,QAAQ;KAC/B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"getDatasetInfo.js","sourceRoot":"","sources":["../../../src/datasets/getDatasetInfo.ts"],"names":[],"mappings":";;;;;AAeA,wCA4BC;AA3CD,oEAAuC;AACvC,sCAAyC;AAGzC,iEAA8D;AAM9D;;;;GAIG;AACI,KAAK,UAAU,cAAc,CAAC,EACnC,MAAM,EAAE,OAAO,EACf,OAAO,GACc;;IACrB,MAAM,MAAM,GAAG,OAAO,IAAI,IAAA,qBAAY,GAAE,CAAC;IAEzC,IAAI,aAAa,IAAI,OAAO,EAAE,CAAC;QAC7B,OAAO,MAAM,IAAA,2CAAoB,EAAC;YAChC,MAAM;YACN,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,mBAAmB,EAAE;QAC5D,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,EAAE,EAAE,OAAO,CAAC,SAAS;aACtB;SACF;KACF,CAAC,CAAC;IACH,IAAA,wBAAS,EAAC,MAAA,eAAe,CAAC,IAAI,0CAAE,IAAI,EAAE,4BAA4B,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9C,OAAO;QACL,EAAE,EAAE,WAAW,CAAC,EAAE;QAClB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,SAAS;QACjD,QAAQ,EAAE,WAAW,CAAC,QAAQ;KAC/B,CAAC;AACJ,CAAC"}

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

@@ -2,6 +2,5 @@ export * from "./createDataset";
 export * from "./getDataset";
 export * from "./getDatasetExamples";
 export * from "./appendDatasetExamples";
-export * from "./getDatasetExamples";
 export * from "./getDatasetInfo";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/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,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}
+{"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"}

package/dist/src/datasets/index.js

@@ -18,6 +18,5 @@ __exportStar(require("./createDataset"), exports);
 __exportStar(require("./getDataset"), exports);
 __exportStar(require("./getDatasetExamples"), exports);
 __exportStar(require("./appendDatasetExamples"), exports);
-__exportStar(require("./getDatasetExamples"), exports);
 __exportStar(require("./getDatasetInfo"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/datasets/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,+CAA6B;AAC7B,uDAAqC;AACrC,0DAAwC;AACxC,uDAAqC;AACrC,mDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/datasets/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,+CAA6B;AAC7B,uDAAqC;AACrC,0DAAwC;AACxC,mDAAiC"}

package/dist/src/types/datasets.d.ts

@@ -1,13 +1,19 @@
 import { Node } from "./core";
 /**
- * A dataset can be identified by its datasetId
- * TODO: add support for datasetVersionId via discriminated union
+ * A dataset can be identified by its datasetId, datasetName, or datasetVersionId
  */
 export type DatasetSelector = {
     datasetId: string;
 } | {
     datasetName: string;
 };
+/**
+ * Parameters for selecting a specific version of a dataset
+ */
+export interface DatasetVersionSelector {
+    dataset: DatasetSelector;
+    versionId?: string;
+}
 /**
  * Overview information about a dataset
  */
@@ -16,6 +22,14 @@ export interface DatasetInfo extends Node {
     description?: string | null;
     metadata?: Record<string, unknown>;
 }
+/**
+ * Information about a dataset version
+ */
+export interface DatasetVersionInfo extends Node {
+    description?: string | null;
+    metadata?: Record<string, unknown>;
+    createdAt: Date;
+}
 /**
  * A dataset's examples
  */
@@ -45,4 +59,10 @@ export interface ExampleWithId extends Example, Node {
  */
 export interface Dataset extends DatasetInfo, DatasetExamples, Node {
 }
+/**
+ * A dataset with its version information
+ */
+export interface DatasetWithVersion extends Dataset {
+    versionInfo: DatasetVersionInfo;
+}
 //# sourceMappingURL=datasets.d.ts.map

package/dist/src/types/datasets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"datasets.d.ts","sourceRoot":"","sources":["../../../src/types/datasets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,IAAI;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,OAAO,EAAE,IAAI;IAClD,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,WAAW,EAAE,eAAe,EAAE,IAAI;CAAG"}
+{"version":3,"file":"datasets.d.ts","sourceRoot":"","sources":["../../../src/types/datasets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,IAAI;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI;IAC9C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,OAAO,EAAE,IAAI;IAClD,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,WAAW,EAAE,eAAe,EAAE,IAAI;CAAG;AAEtE;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,OAAO;IACjD,WAAW,EAAE,kBAAkB,CAAC;CACjC"}