@narrative.io/data-collaboration-sdk-ts 2.108.0 → 3.0.0

package/build/access-rules/types.d.ts

@@ -1,5 +1,5 @@
-import type { Schema } from "src/datasets";
-import type { CollaboratorsConfig } from "src/types";
+import type { Schema } from "../datasets";
+import type { CollaboratorsConfig } from "../types";
 export interface AccessRule {
     id: number;
     dataset_id?: AccessRuleDatasetId;

package/build/base-api.d.ts

@@ -1,4 +1,4 @@
-import { type MandeInstance } from "mande";
+import { HttpClient } from "./http-client";
 import type { Config, PaginationOptions } from "./types";
 /**
  * BaseApi class provides basic functionality for making API requests.
@@ -6,7 +6,7 @@ import type { Config, PaginationOptions } from "./types";
 export declare abstract class BaseApi {
     protected apiKey?: string;
     protected readonly environment: string;
-    protected readonly base_api: MandeInstance;
+    protected readonly base_api: HttpClient;
     protected readonly headers: Record<string, string>;
     protected readonly verbose: boolean;
     /**
@@ -22,11 +22,11 @@ export declare abstract class BaseApi {
      */
     getHeaders(): Record<string, string>;
     /**
-     * Retrieves the base API instance created using Mande.
+     * Retrieves the underlying HTTP client backing this API instance.
      *
-     * @returns A MandeInstance object representing the base API instance.
+     * @returns An HttpClient instance representing the base API instance.
      */
-    getBaseApi(): MandeInstance;
+    getBaseApi(): HttpClient;
     /**
      * Retrieves the API key associated with the API instance, if it exists.
      *

package/build/base-api.js

@@ -1,4 +1,4 @@
-import { mande } from "mande";
+import { HttpClient } from "./http-client";
 import { addTrailingSlash } from "./utils";
 /**
  * BaseApi class provides basic functionality for making API requests.
@@ -19,7 +19,8 @@ export class BaseApi {
         this.environment = config.environment ?? "prod";
         this.verbose = (config.verbose ?? false) || this.environment === "dev";
         this.headers = config.headers ?? {};
-        this.base_api = mande(`${this.getBaseUrl()}`, {
+        this.base_api = new HttpClient({
+            baseUrl: this.getBaseUrl(),
             headers: this.constructHeaders(),
             responseAs: config.responseAs ?? "json",
         });
@@ -41,9 +42,9 @@ export class BaseApi {
         return this.constructHeaders();
     }
     /**
-     * Retrieves the base API instance created using Mande.
+     * Retrieves the underlying HTTP client backing this API instance.
      *
-     * @returns A MandeInstance object representing the base API instance.
+     * @returns An HttpClient instance representing the base API instance.
      */
     getBaseApi() {
         return this.base_api;
@@ -82,12 +83,12 @@ export class BaseApi {
     async get(endpoint, params) {
         const queryString = this.constructQueryString(params);
         const url = `${endpoint}${queryString}`;
-        if (this.verbose) {
+        if (this.verbose)
             console.log(`Making GET request to ${url}...`);
-            const resp = await this.base_api.get(url);
+        const resp = await this.base_api.get(url);
+        if (this.verbose)
             console.log(`Response: ${JSON.stringify(resp)}`);
-        }
-        return await this.base_api.get(url);
+        return resp;
     }
     /**
      * Makes a POST request to the given endpoint with the given data.

package/build/data-planes/index.d.ts

@@ -1,5 +1,5 @@
-import type { ApiRecords } from "src/types";
 import { BaseApi } from "../base-api";
+import type { ApiRecords } from "../types";
 import type { DataPlane, HealthCheckJobResponse } from "./types";
 export declare class DataPlaneApi extends BaseApi {
     getDataPlanes(): Promise<ApiRecords<DataPlane>>;

package/build/datasets/index.d.ts

@@ -1,5 +1,5 @@
-import type { UnknownJob } from "src/jobs/types";
 import { BaseApi } from "../base-api";
+import type { UnknownJob } from "../jobs/types";
 import type { ApiRecords } from "../types";
 import type { DatasetStatisticsConfiguration, StatisticsConfigurationResponse } from "./statistics-types";
 import type { AdvancedStatistics, AdvancedStatisticsMetadata, BasicStatistics, ColumnStatistics, ColumnSummary, Columns, Configuration, CreateDatasetRefreshScheduleRequest, CreateDatasetRequest, Dataset, DatasetInterfaceError, DatasetInterfaceRef, DatasetInterfaceValidation, DatasetStatus, DatasetTableSummary, DatasetTableSummaryAPIResponse, DatasetWriteMode, FilePerSnapshotResponse, Histogram, IngestDatasetFileRequest, JsonSchemaValidationNode, RecalculationInfo, RetentionPolicy, RetentionScheduleConfig, RowClock, RowTTLPolicy, Schema, SchemaArrayItems, SchemaArrayItemsArray, SchemaArrayItemsObject, SchemaArrayItemsPrimitive, SchemaArrayProperty, SchemaFileConfig, SchemaFileConfigType, SchemaObjectProperty, SchemaPrimitiveProperty, SchemaProperties, SchemaPropertiesType, SchemaProperty, SnapshotAgeExpression, SnapshotRange, SnapshotTTLPolicy, TableClock, TableClockKind, TableTTLPolicy, TTLPolicy, TTLPolicyKind, UpdateDatasetRefreshScheduleRequest, UpdateDatasetRequest, UpsertRetentionPoliciesRequest, Value } from "./types";

package/build/datasets/types.d.ts

@@ -1,4 +1,4 @@
-import type { DataPlane } from "src/data-planes/types";
+import type { DataPlane } from "../data-planes/types";
 import type { Mapping } from "../mappings/types";
 export interface Dataset {
     id: number;

package/build/encryption-materials/index.d.ts

@@ -1,5 +1,5 @@
-import type { ApiRecords } from "src/types";
 import { BaseApi } from "../base-api";
+import type { ApiRecords } from "../types";
 import type { CreateEncryptionMaterialRequest, DataEncryptionMaterial, UpdateEncryptionMaterialRequest } from "./types";
 export declare class EncryptionMaterialApi extends BaseApi {
     /**

package/build/http-client.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Minimal `fetch`-based HTTP client used by {@link BaseApi}.
+ *
+ * Replaces the previously-used `mande` package (now abandoned). The behavior
+ * here intentionally mirrors what `mande` did for the request shapes this SDK
+ * relies on, so swapping it in is transparent to callers:
+ * - joins the base URL and endpoint, normalizing the slash between them
+ * - sends `Accept`/`Content-Type: application/json` by default (overridable)
+ * - JSON-stringifies the body of POST/PUT/PATCH requests
+ * - parses the response per {@link ResponseAs}; a 204 (or parse failure)
+ *   resolves to `null`
+ * - throws on any non-2xx status, attaching the {@link Response} and the parsed
+ *   body to the error
+ */
+/** How a response body should be returned from a request. */
+export type ResponseAs = "json" | "text" | "response";
+/** Options for constructing an {@link HttpClient}. */
+export interface HttpClientOptions {
+    /** Absolute base URL that every request is resolved against. */
+    baseUrl: string;
+    /** Headers applied to every request. */
+    headers?: Record<string, string>;
+    /** How to interpret response bodies. Defaults to `"json"`. */
+    responseAs?: ResponseAs;
+}
+/**
+ * Error thrown for any non-2xx response. Carries the originating
+ * {@link Response} and the parsed body so callers can inspect the failure.
+ */
+export declare class HttpError extends Error {
+    readonly response: Response;
+    readonly body: unknown;
+    constructor(response: Response, body: unknown);
+}
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly headers;
+    private readonly responseAs;
+    constructor(options: HttpClientOptions);
+    get<T>(url: string): Promise<T>;
+    post<T>(url: string, data?: unknown): Promise<T>;
+    put<T>(url: string, data?: unknown): Promise<T>;
+    delete<T>(url: string): Promise<T>;
+    private request;
+}

package/build/http-client.js

@@ -0,0 +1,86 @@
+/**
+ * Minimal `fetch`-based HTTP client used by {@link BaseApi}.
+ *
+ * Replaces the previously-used `mande` package (now abandoned). The behavior
+ * here intentionally mirrors what `mande` did for the request shapes this SDK
+ * relies on, so swapping it in is transparent to callers:
+ * - joins the base URL and endpoint, normalizing the slash between them
+ * - sends `Accept`/`Content-Type: application/json` by default (overridable)
+ * - JSON-stringifies the body of POST/PUT/PATCH requests
+ * - parses the response per {@link ResponseAs}; a 204 (or parse failure)
+ *   resolves to `null`
+ * - throws on any non-2xx status, attaching the {@link Response} and the parsed
+ *   body to the error
+ */
+/**
+ * Error thrown for any non-2xx response. Carries the originating
+ * {@link Response} and the parsed body so callers can inspect the failure.
+ */
+export class HttpError extends Error {
+    response;
+    body;
+    constructor(response, body) {
+        super(response.statusText || `Request failed with status ${response.status}`);
+        this.name = "HttpError";
+        this.response = response;
+        this.body = body;
+    }
+}
+const leadingSlashRE = /^\/+/;
+/** Joins a base URL and a path with exactly one slash between them. */
+function joinUrl(base, url) {
+    if (!url)
+        return base;
+    if (base.endsWith("/"))
+        return base + url.replace(leadingSlashRE, "");
+    return url.startsWith("/") ? base + url : `${base}/${url}`;
+}
+export class HttpClient {
+    baseUrl;
+    headers;
+    responseAs;
+    constructor(options) {
+        this.baseUrl = options.baseUrl;
+        this.responseAs = options.responseAs ?? "json";
+        this.headers = {
+            Accept: "application/json",
+            "Content-Type": "application/json",
+            ...options.headers,
+        };
+    }
+    async get(url) {
+        return this.request("GET", url);
+    }
+    async post(url, data) {
+        return this.request("POST", url, data);
+    }
+    async put(url, data) {
+        return this.request("PUT", url, data);
+    }
+    async delete(url) {
+        return this.request("DELETE", url);
+    }
+    async request(method, url, data) {
+        const init = { method, headers: this.headers };
+        // Only POST/PUT/PATCH carry a body.
+        if (method[0] === "P" && data !== undefined && data !== null) {
+            init.body = JSON.stringify(data);
+        }
+        const response = await fetch(joinUrl(this.baseUrl, url), init);
+        // Return the raw Response untouched when asked.
+        if (this.responseAs === "response") {
+            if (response.status >= 200 && response.status < 300) {
+                return response;
+            }
+            throw new HttpError(response, response);
+        }
+        // 204 No Content has no body to parse.
+        const body = response.status === 204
+            ? null
+            : await response[this.responseAs]().catch(() => null);
+        if (response.status >= 200 && response.status < 300) {
+            return body;
+        }
+        throw new HttpError(response, body);
+    }
+}

package/build/index.d.ts

@@ -24,6 +24,7 @@ export * from "./encryption-materials/types";
 export * from "./forecast";
 export * from "./health";
 export * from "./health/types";
+export * from "./http-client";
 export * from "./installations";
 export * from "./jobs";
 export { default as JsonBigNumber } from "./json-big-number";

package/build/index.js

@@ -24,6 +24,7 @@ export * from "./encryption-materials/types";
 export * from "./forecast";
 export * from "./health";
 export * from "./health/types";
+export * from "./http-client";
 export * from "./installations";
 export * from "./jobs";
 // Special imports that might be from default exports or need special handling

package/build/jobs/types.d.ts

@@ -1,6 +1,6 @@
-import type { ForecastResult, JobState } from "src/forecast";
-import type { DataStreamPurchaseDetails, ForecastDimensions, MarketplaceForecastDetails } from "src/forecast/types";
-import type { NqlBudget } from "src/nql/types";
+import type { ForecastResult, JobState } from "../forecast";
+import type { DataStreamPurchaseDetails, ForecastDimensions, MarketplaceForecastDetails } from "../forecast/types";
+import type { NqlBudget } from "../nql/types";
 /**
  * Every job type the backend can persist and return from the /jobs API.
  * The backend's `Job.Type` is an open string, so treat this list as the

package/build/mappings/index.d.ts

@@ -1,6 +1,6 @@
-import type { ApiRecords, Config } from "src/types";
 import { BaseApi } from "../base-api";
 import { CompanyInfoApi } from "../company-info";
+import type { ApiRecords, Config } from "../types";
 import type { CreateMapping, Mapping, MappingExpressionDependencies, MappingTestResult, MappingTestResults, ObjectMapping, PropertyMapping, RawMappingDefinition, RawObjectMapping, RawPropertyMapping, RawValueMapping, ValueMapping } from "./types";
 /**
  * Class representing the Mappings API.

package/build/model-training/types.d.ts

@@ -1,4 +1,4 @@
-import type { ModelCollaborators } from "src/models/types";
+import type { ModelCollaborators } from "../models/types";
 export interface OutputModel {
     name: string;
     collaborators: ModelCollaborators;

package/build/models/types.d.ts

@@ -1,4 +1,4 @@
-import type { CollaboratorList, GeneralCollaborator } from "src/types";
+import type { CollaboratorList, GeneralCollaborator } from "../types";
 export interface ModelCollaborators {
     view: CollaboratorList | GeneralCollaborator;
     train: CollaboratorList | GeneralCollaborator;

package/build/nql/DataRulesConverter.d.ts

@@ -1,5 +1,5 @@
-import type { ObjectAttribute } from "src/attributes/types";
 import { type Attribute } from "../attributes";
+import type { ObjectAttribute } from "../attributes/types";
 import type { DataRules } from "../data-streams/types";
 import type { DataRulesAttributesField, ForecastBody, Nql } from "./types";
 /**

package/build/nql/types.d.ts

@@ -4,8 +4,8 @@
  *
  * @see {@link https://github.com/colinhacks/zod} for more information about Zod.
  */
-import type { Dataset } from "src/datasets/types";
 import { z } from "zod";
+import type { Dataset } from "../datasets/types";
 /**
  * Defines the structure for a budget object.
  *

package/build/queries/types.d.ts

@@ -1,5 +1,5 @@
-import type { CollaboratorsConfig } from "src/types";
 import type * as Parser from "../nql/AstParser";
+import type { CollaboratorsConfig } from "../types";
 export interface CondensedNqlDatasetSource {
     type: "dataset";
     datasetName: string;

package/build/rosetta-stone/index.d.ts

@@ -1,6 +1,6 @@
-import type { Dataset } from "src/datasets";
-import type { Mapping } from "src/mappings/types";
 import { BaseApi } from "../base-api";
+import type { Dataset } from "../datasets";
+import type { Mapping } from "../mappings/types";
 import type { RosettaStoneResponse, SampleRecord, SampleRecords } from "./types";
 declare class RosettaStoneApi extends BaseApi {
     /**

package/build/subscriptions/types.d.ts

@@ -1,5 +1,5 @@
-import type { CompanyConstraint, DataRules, Offer } from "src/data-streams/types";
-import type { DatasetConstraint } from "src/forecast/types";
+import type { CompanyConstraint, DataRules, Offer } from "../data-streams/types";
+import type { DatasetConstraint } from "../forecast/types";
 export interface Subscription {
     id: string;
     budget: SubscriptionBudget;

package/build/types.d.ts

@@ -1,4 +1,4 @@
-import type { ResponseAsTypes } from "mande";
+import type { ResponseAs } from "./http-client";
 /**
  * Environment for the API.
  *
@@ -17,7 +17,7 @@ export interface Config {
     environment?: Environment;
     headers?: Record<string, string>;
     verbose?: boolean;
-    responseAs?: ResponseAsTypes;
+    responseAs?: ResponseAs;
 }
 export interface ApiRecordsV2<T> extends PaginationMetadata {
     records: T[];

package/build/views/types.d.ts

@@ -1,5 +1,5 @@
-import type { NqlQueryMetadata, NqlQueryOwner } from "src/queries";
-import type { CollaboratorsConfig } from "src/types";
+import type { NqlQueryMetadata, NqlQueryOwner } from "../queries";
+import type { CollaboratorsConfig } from "../types";
 export interface SharedView {
     id: number;
     name: string;

package/build/whoami/types.d.ts

@@ -1,4 +1,4 @@
-import type { UserRole } from "src/authentication";
+import type { UserRole } from "../authentication";
 export interface User {
     user_id: number;
     name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@narrative.io/data-collaboration-sdk-ts",
-	"version": "2.108.0",
+	"version": "3.0.0",
 	"main": "build/index.js",
 	"repository": "github:narrative-io/data-collaboration-sdk-ts",
 	"source": "src/index.ts",
@@ -36,10 +36,10 @@
 		"babel-jest": "30.4.1",
 		"jest": "30.4.2",
 		"lefthook": "2.1.9",
-		"ts-jest": "29.4.11"
+		"ts-jest": "29.4.11",
+		"typescript": "6.0.0-dev.20260416"
 	},
 	"dependencies": {
-		"mande": "2.0.9",
 		"zod": "4.4.3",
 		"bignumber.js": "11.1.2"
 	},